@shipengine/elements 2.11.1 → 2.13.0

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

@@ -119,6 +119,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 errorMessages: {
                     labelIdRequired: string;
+                    request_failed_to_complete: string;
                 };
                 resultMessages: {
                     approved: string;
@@ -351,6 +352,31 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     "requires-additional-handling": string;
                     addOns: string;
                     contentDescription: string;
+                    /**
+                     * # 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 `Shipment Summary` 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 = createElement(Component, ErrorFallback, {
+                     *
+                     *   resources: { en },
+                     * });
+                     * ```
+                     *
+                     * <br />
+                     *
+                     * @see {@link VoidLabel.Element | The **Element** created to render `<VoidLabel />`}
+                     */
                     confirmation: string;
                     dimensions: {
                         length: string;
@@ -445,7 +471,11 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 shipToAddressFormFields: string;
                 sections: {
                     customsForm: string;
-                    windsorFramework: string;
+                    windsorFramework: string; /**
+                     * # Void Label Element Props
+                     *
+                     * @see {@link VoidLabel.Element | See the full type that `typeof Element` will return}
+                     */
                     shipment: string;
                     rate_one: string;
                     rate_other: string;
@@ -486,10 +516,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     };
                 };
                 success: {
-                    title: string; /**
-                     * `onSuccess` is a callback function that will be invoked when the request to void a given
-                     * shipping label is successful.
-                     */
+                    title: string;
                     subtitle: string;
                     action: string;
                 };
@@ -561,10 +588,15 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     isEnabled: string;
                     isLoading: string;
                     lowBalancePurchaseThreshold: string;
-                    maximumPurchasesPerDay: string;
-                    purchaseAmount: string; /**
-                     * `labelId` is the unique identifier for the label you wish to void.
+                    /**
+                     * # 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}
                      */
+                    maximumPurchasesPerDay: string;
+                    purchaseAmount: string;
                     readSettings: string;
                 };
                 addFunds: {
@@ -622,6 +654,13 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 units: {
                     title: 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}
+                     */
                     dimensions: {
                         title: string;
                         standard: string;
@@ -682,6 +721,8 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     status: string;
                     trackingStatus: string;
                     labelId: string;
+                    externalOrderId: string;
+                    externalShipmentId: string;
                 };
                 empty: {
                     title: string;
@@ -696,7 +737,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     voided: string;
                     error: string;
                     completed: string;
-                    processing: string;
+                    processing: string; /**
+                     * `labelId` is the unique identifier for the label you wish to void.
+                     */
                 };
                 trackingStatus: {
                     unknown: string;
@@ -731,9 +774,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                 };
                 search: string;
                 settingsModal: {
-                    closeDialog: string; /**
-                     * `labelId` is the unique identifier for the label you wish to void.
-                     */
+                    closeDialog: string;
                     header: string;
                 };
                 status: {
@@ -744,7 +785,10 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     toastBody: string;
                 };
                 deleteCarrierErrorTitle: string;
-                deleteCarrierErrorMessage: string;
+                deleteCarrierErrorMessage: string; /**
+                 * `onSuccess` is a callback function that will be invoked when the request to void a given
+                 * shipping label is successful.
+                 */
                 loadingDeletingCarrier: string;
             };
             common: {
@@ -768,13 +812,6 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     tryAgain: string;
                 };
                 address: {
-                    /**
-                     * # 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}
-                     */
                     fields: {
                         name: string;
                         company: string;
@@ -885,6 +922,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         description: string;
                         harmonizedTariffCode: string;
                         ifDeliveryFails: string;
+                        dutiesTaxes: string;
                         quantity: string;
                         sku: string;
                         value: string;
@@ -899,6 +937,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         returnToSender: string;
                         treatAsAbandoned: string;
                     };
+                    canadaDeliveredDuty: {
+                        senderPrepay: string;
+                        recipientPays: string;
+                        tooltip: {
+                            title: string;
+                            restriction: string;
+                            requirement1: string;
+                            requirement2: string;
+                            requirement3: string;
+                        };
+                    };
                     removeAllDeclarations: string;
                     total: string;
                 };
@@ -1048,6 +1097,9 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     tooManyCharacters: string;
                     requiredShipmentId: string;
                     requiredLabelId: string;
+                    heightExceeded: string;
+                    widthExceeded: string;
+                    lengthExceeded: string;
                 };
                 shippingPresets: {
                     apply: string;
@@ -1091,6 +1143,7 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                         edit: string;
                         remove: string;
                         viewDetails: string;
+                        cancelShipment: string;
                     };
                 };
                 ZnVuZGluZ19zb3VyY2VfaWQgbXVzdCBiZSBhbiBpbnRlZ2Vy: string;
@@ -1121,15 +1174,17 @@ export declare const Element: ({ resources, ...props }: ComponentProps & {
                     transactionHistory: string;
                     adjustmentHistory: string;
                     warehouses: string;
-                    carriers: string;
+                    carriers: {
+                        title: string;
+                        customStatusMessages: {
+                            success: string;
+                        };
+                    };
                     externalCarriers: string;
                     labelLayout: string;
                     unitSettings: string;
                     vatSettings: string;
-                }; /**
-                 * `onComplete` is a callback function that will be invoked when the request to void a given
-                 * shipping label is completed.
-                 */
+                };
             };
         };
     } | undefined;

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

@@ -1,4 +1,5 @@
 /// <reference types="react" />
+import { THEME_ID } from "@shipengine/giger";
 import { Theme } from "@shipengine/giger-theme";
 import { ShipEngineAPIConfig, ShipEngineProps } from "@shipengine/react-api";
 import { ElementsFeatureFlags, GlobalFeatures } from "../utilities";
@@ -7,13 +8,16 @@ export interface ElementsContextValue {
     baseURL: string;
     cdnURL: string;
     container?: HTMLElement;
+    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
     getFeatures: (key: keyof ElementsFeatureFlags) => ElementsFeatureFlags[keyof ElementsFeatureFlags];
     getToken: ShipEngineProps["getToken"];
     globalFeatures: GlobalFeatures;
     locale?: string;
     onError: ElementsErrorHandler;
     scope: string | null;
-    theme: Theme;
+    theme: Theme | {
+        [THEME_ID]: Theme;
+    };
 }
 /**
  * @category Contexts
@@ -23,17 +27,20 @@ export type ElementsContextProviderProps = {
     cdnURL?: string;
     children: React.ReactNode;
     container?: HTMLElement;
+    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
     features?: ElementsFeatureFlags;
     locale?: string;
     onError?: ElementsErrorHandler;
     /** Scope of the Elements Provider. Can be null to not specify a specific element */
     scope?: string | null;
-    theme: Theme;
+    theme: Theme | {
+        [THEME_ID]: Theme;
+    };
 } & Pick<ShipEngineAPIConfig, "getToken" | "baseURL">;
 /**
  * @category Providers
  */
-export declare const ElementsContextProvider: ({ baseURL, cdnURL, children, container, features, getToken, locale: localeProp, onError, scope, theme, }: ElementsContextProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ElementsContextProvider: ({ baseURL, cdnURL, children, container, features, getToken, locale: localeProp, onError, scope, theme, emotionCacheShadowRootContainer, }: ElementsContextProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 /**
  * Must be used within {@link ElementsProvider}
  *

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

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

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

@@ -1 +1,2 @@
 export * from "./manage-carriers";
+export * from "./use-manage-carriers";

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

@@ -1,5 +1,16 @@
+import { CodedError, Currency } from "@shipengine/react-api";
 export type ShipEngineCarriersProps = {
+    addedFundsError?: CodedError[] | null;
+    addFunds?: (payload: {
+        carrierId: string;
+        funds: {
+            amount: number;
+            currency: Currency;
+        };
+    }) => Promise<void>;
+    isUpdateFundsError?: boolean;
+    isUpdatingFunds?: boolean;
     onRedirectToOnboarding?: () => void;
     showFunds?: boolean;
 };
-export declare const ShipEngineCarriers: ({ showFunds, onRedirectToOnboarding, }: ShipEngineCarriersProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const ShipEngineCarriers: ({ showFunds, onRedirectToOnboarding, addFunds, addedFundsError, }: ShipEngineCarriersProps) => import("@emotion/react/jsx-runtime").JSX.Element;

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

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

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

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

package/src/features/vat-settings/use-vat-settings.d.ts

@@ -2,7 +2,7 @@ export declare const useVatSettings: () => {
     getVatSettingsErrors: import("@shipengine/react-api").CodedError[] | null;
     isLoading: boolean;
     refreshVatSettings: <TPageData>(options?: (import("@tanstack/query-core").RefetchOptions & import("@tanstack/query-core").RefetchQueryFilters<TPageData>) | undefined) => Promise<import("@tanstack/query-core").QueryObserverResult<import("@shipengine/react-api").ShipEngineAccountSettings, import("@shipengine/react-api").CodedError[]>>;
-    updateVatSettings: import("@tanstack/react-query").UseMutateAsyncFunction<import("@shipengine/react-api").ShipEngineAccountSettings, import("@shipengine/react-api").CodedError[], SE.AccountSettings, unknown>;
+    updateVatSettings: import("@tanstack/react-query").UseMutateAsyncFunction<import("@shipengine/react-api").ShipEngineAccountSettings, import("@shipengine/react-api").CodedError[], Partial<import("@shipengine/react-api").ShipEngineAccountSettings>, unknown>;
     updateVatSettingsErrors: import("@shipengine/react-api").CodedError[] | null;
     vatSettings: import("@shipengine/react-api").ShipEngineAccountSettings | undefined;
 };

package/src/hooks/options/index.d.ts

@@ -12,6 +12,6 @@ export * from "./use-service-code-options";
 export * from "./use-shipment-metadata";
 export * from "./use-shipping-presets-options";
 export * from "./use-state-code-options";
-export * from "./use-warehouse-options";
+export * from "./use-ship-from-address-options";
 export * from "./use-service-points";
 export * from "./use-windsor-framework";

package/src/hooks/options/use-insurance-provider-options.d.ts

@@ -15,7 +15,7 @@ export declare const useInsuranceProviderOptions: (insuranceAccount?: SE.Insuran
     fundingSourceInsuranceProvider: SE.FundingSourceInsuranceProvider | undefined;
     insuranceProviderOptions: {
         label: string;
-        value: SE.InsuranceProviderType;
+        value: string;
     }[];
     refetchInsuranceAcceptedTerms: <TPageData>(options?: (import("@tanstack/query-core").RefetchOptions & import("@tanstack/query-core").RefetchQueryFilters<TPageData>) | undefined) => Promise<import("@tanstack/query-core").QueryObserverResult<SE.InsuranceFundingSourceAcceptedTermsResponse, SE.CodedError[]>>;
 };

package/src/hooks/options/use-ship-from-address-options.d.ts

@@ -0,0 +1,19 @@
+import { SE } from "@shipengine/react-api";
+import { ShipFromAddress } from "../../types";
+/**
+ * @internal
+ *
+ * # Warehouse Options Hook
+ *
+ * @category Hooks
+ */
+export declare const useShipFromAddressOptions: (warehouses?: SE.Warehouse[], shipFromAddresses?: (ShipFromAddress & {
+    addressId: string;
+})[], shipment?: SE.SalesOrderShipment) => {
+    label: string;
+    options: {
+        label: string;
+        subLabel: string;
+        value: string;
+    }[];
+}[] | undefined;

package/src/hooks/options/use-shipment-metadata.d.ts

@@ -8,6 +8,7 @@ import { SE } from "@shipengine/react-api";
  */
 export declare const useShipmentMetadata: (shipment?: SE.SalesOrderShipment) => {
     hasAllZeroMeasurements: boolean;
+    isCanadaDeliveredDutyEligible: boolean;
     isContentDescriptionRequired: boolean;
     isCustomsRequired: boolean;
     isInternational: boolean;

package/src/hooks/use-root-portal.d.ts

@@ -1,6 +1,7 @@
 import React from "react";
 type RootPortalProviderProps = {
     children: React.ReactNode;
+    emotionCacheShadowRootContainer?: ShadowRoot & HTMLElement;
 };
 /**
  * @internal
@@ -13,7 +14,7 @@ type RootPortalProviderProps = {
  *
  * @see {@link useRootPortal | The associated `hook` for this provider}
  */
-export declare const RootPortalProvider: ({ children }: RootPortalProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
+export declare const RootPortalProvider: ({ children, emotionCacheShadowRootContainer, }: RootPortalProviderProps) => import("@emotion/react/jsx-runtime").JSX.Element;
 /**
  * @internal
  *
@@ -28,5 +29,5 @@ export declare const RootPortalProvider: ({ children }: RootPortalProviderProps)
  *
  * @see {@link RootPortalProvider | The associated `provider` for this hook}
  */
-export declare const useRootPortal: () => HTMLDivElement;
+export declare const useRootPortal: () => HTMLElement;
 export {};

package/src/locales/en/index.d.ts

@@ -28,6 +28,7 @@ declare const _default: {
         };
         errorMessages: {
             labelIdRequired: string;
+            request_failed_to_complete: string;
         };
         resultMessages: {
             approved: string;
@@ -586,6 +587,8 @@ declare const _default: {
             status: string;
             trackingStatus: string;
             labelId: string;
+            externalOrderId: string;
+            externalShipmentId: string;
         };
         empty: {
             title: string;
@@ -780,6 +783,7 @@ declare const _default: {
                 description: string;
                 harmonizedTariffCode: string;
                 ifDeliveryFails: string;
+                dutiesTaxes: string;
                 quantity: string;
                 sku: string;
                 value: string;
@@ -794,6 +798,17 @@ declare const _default: {
                 returnToSender: string;
                 treatAsAbandoned: string;
             };
+            canadaDeliveredDuty: {
+                senderPrepay: string;
+                recipientPays: string;
+                tooltip: {
+                    title: string;
+                    restriction: string;
+                    requirement1: string;
+                    requirement2: string;
+                    requirement3: string;
+                };
+            };
             removeAllDeclarations: string;
             total: string;
         };
@@ -943,6 +958,9 @@ declare const _default: {
             tooManyCharacters: string;
             requiredShipmentId: string;
             requiredLabelId: string;
+            heightExceeded: string;
+            widthExceeded: string;
+            lengthExceeded: string;
         };
         shippingPresets: {
             apply: string;
@@ -986,6 +1004,7 @@ declare const _default: {
                 edit: string;
                 remove: string;
                 viewDetails: string;
+                cancelShipment: string;
             };
         };
         ZnVuZGluZ19zb3VyY2VfaWQgbXVzdCBiZSBhbiBpbnRlZ2Vy: string;
@@ -1016,7 +1035,12 @@ declare const _default: {
             transactionHistory: string;
             adjustmentHistory: string;
             warehouses: string;
-            carriers: string;
+            carriers: {
+                title: string;
+                customStatusMessages: {
+                    success: string;
+                };
+            };
             externalCarriers: string;
             labelLayout: string;
             unitSettings: string;

package/src/types/canada-ddp.d.ts

@@ -0,0 +1,4 @@
+export declare enum CanadaDeliveredDutyOptions {
+    RECIPIENT_PAYS = "recipient_pays",
+    SENDER_PREPAY = "sender_prepay"
+}

package/src/types/index.d.ts

@@ -2,3 +2,5 @@ export * from "./carrier-metadata";
 export * from "./shipping-preset";
 export * from "./preferred-rates";
 export * from "./insurance-metadata";
+export * from "./ship-from-address";
+export * from "./canada-ddp";

package/src/types/ship-from-address.d.ts

@@ -0,0 +1,4 @@
+import { Warehouse } from "@shipengine/js-api";
+export type ShipFromAddress = Pick<Warehouse, "originAddress" | "returnAddress" | "isDefault"> & {
+    name?: string;
+};

package/src/utilities/feature-flags/types.d.ts

@@ -63,6 +63,10 @@ export type ShipmentFormFeatures = {
      * shipment form of the PurchaseLabel element.
      */
     shippingPresets?: boolean;
+    /**
+     * When disabled the Purchase Label element will not use the Seller's saved warehouses during Shipment creation or expose the warehouses in the ship from drop down.
+     */
+    useWarehouses?: boolean;
 };
 export type ShipmentSummaryFeatures = {
     schedulePickup?: boolean;
@@ -123,12 +127,13 @@ export type AccountSettingsFeatures = {
      */
     showVatSettings?: boolean;
 };
-export type LabelColumnName = "shipmentId" | "labelId" | "packages" | "recipient" | "shippingService" | "createdDate" | "shipDate" | "status" | "trackingStatus";
+export type LabelColumnName = "shipmentId" | "labelId" | "externalOrderId" | "externalShipmentId" | "packages" | "recipient" | "shippingService" | "createdDate" | "shipDate" | "status" | "trackingStatus";
 export type BaseLabelColumnConfig = {
     /**
      * The name identifying the column
      */
     name: Exclude<LabelColumnName, "shipmentId" | "labelId">;
+    nickname?: string;
 };
 export type FilterableLabelColumnConfig = {
     /**
@@ -139,6 +144,7 @@ export type FilterableLabelColumnConfig = {
      * The name identifying the column
      */
     name: Extract<LabelColumnName, "shipmentId" | "labelId">;
+    nickname?: string;
 };
 export type LabelColumnConfig = BaseLabelColumnConfig | FilterableLabelColumnConfig;
 export type LabelsGridFeatures = {

package/src/utilities/shipengine/address.d.ts

@@ -1,4 +1,5 @@
 import { SE } from "@shipengine/react-api";
+import { ShipFromAddress } from "../../types";
 /**
  * @internal
  *
@@ -64,3 +65,34 @@ export declare const isEmptyAddress: (address?: SE.Address) => boolean;
  * @category Utilities
  */
 export declare const addEmailToValidation: (addressValidation: SE.AddressValidation, email?: string) => SE.AddressValidation;
+/**
+ * @internal
+ *
+ * # Address Utilities - getDefaultShipFromAddress
+ *  Gets the default ship from address from an array of ship from addresses
+ *
+ * @category Utilities
+ */
+export declare const getDefaultShipFromAddress: (addresses?: ShipFromAddress[]) => ShipFromAddress | undefined;
+/**
+ * @internal
+ *
+ * # Address Utilities - getSavedShipFromAddressId
+ *  Gets the address ID of from the shipment if it is a saved address and not a warehouse
+ *
+ * @category Utilities
+ */
+export declare const getSavedShipFromAddressId: (shipment?: SE.SalesOrderShipment, shipFromAddresses?: (ShipFromAddress & {
+    addressId: string;
+})[]) => string | undefined;
+/**
+ * @internal
+ *
+ * # Address Utilities - getIsShipmentUsingSavedShipFromAddress
+ *  Returns true if the shipment is using a saved ship from address
+ *
+ * @category Utilities
+ */
+export declare const getIsShipmentUsingSavedShipFromAddress: (shipment?: SE.SalesOrderShipment, shipFromAddresses?: (ShipFromAddress & {
+    addressId: string;
+})[]) => boolean | undefined;

package/src/utilities/shipengine/sales-order.d.ts

@@ -6,7 +6,7 @@ import { SE } from "@shipengine/react-api";
  *
  * @category Utilities
  */
-export declare const getCustomsFromSalesOrder: (salesOrder: SE.SalesOrder, warehouse: SE.Warehouse) => {
+export declare const getCustomsFromSalesOrder: (salesOrder: SE.SalesOrder, originAddress: SE.Address) => {
     customs: SE.Customs;
     products: SE.Product[];
 };
@@ -17,7 +17,7 @@ export declare const getCustomsFromSalesOrder: (salesOrder: SE.SalesOrder, wareh
  *
  * @category Utilities
  */
-export declare const getIsCustomsRequiredForSalesOrder: ({ shipTo }: SE.SalesOrder, { originAddress }: SE.Warehouse) => boolean;
+export declare const getIsCustomsRequiredForSalesOrder: ({ shipTo }: SE.SalesOrder, originAddress?: SE.Address) => boolean;
 /**
  * @internal
  *

package/src/utilities/shipengine/warehouses.d.ts

@@ -1,2 +1,3 @@
 import { SE } from "@shipengine/react-api";
-export declare const getDefaultWarehouse: (warehouses: SE.Warehouse[]) => SE.Warehouse;
+export declare const getDefaultWarehouse: (warehouses?: SE.Warehouse[]) => SE.Warehouse | undefined;
+export declare const getWarehouseById: (warehouseId?: string, warehouses?: SE.Warehouse[]) => SE.Warehouse | undefined;

package/src/utilities/styles.d.ts

@@ -1,4 +1,5 @@
 import { Interpolation } from "@emotion/serialize";
+import { THEME_ID } from "@shipengine/giger";
 import { Theme } from "@shipengine/giger-theme";
 /**
  * The verbose typing is necessary to get around TypeScript's limitations on contextual inference
@@ -29,10 +30,10 @@ type StylesConstraint = Record<GetterKey, GetterFunction> & Record<`${NotGetterK
  * ```
  * const styles = createStyles({
  *   basicObject: { color: "red" },
- *   withTheme: (theme) => ({ backgroundColor: theme.palette.primary.main }),
+ *   withTheme: (theme) => ({ backgroundColor: scopeTheme(theme).palette.primary.main }),
  *
  *   getWithArbitraryPropsAndTheme: (disabled?: boolean) => (theme) => ({
- *     color: theme.palette[disabled ? 'primary' : 'gray'].main,
+ *     color: scopeTheme(theme).palette[disabled ? 'primary' : 'gray'].main,
  *   }),
  * });
  * ```
@@ -40,4 +41,7 @@ type StylesConstraint = Record<GetterKey, GetterFunction> & Record<`${NotGetterK
  * @category Utilities
  */
 export declare const createStyles: <T extends StylesConstraint>(styles: T) => T;
+export declare const scopeTheme: (theme: Theme | {
+    [THEME_ID]: Theme;
+}) => Theme;
 export {};