formica-ui-lib 1.0.347 → 1.0.349

package/dist/componentProps/atoms/dropdown/DropdownProps.d.ts

@@ -7,6 +7,7 @@ export interface DropdownOption {
 export interface DropdownProps {
     id: string;
     name?: string;
+    autoComplete?: string;
     ariaLabel?: string;
     ariaDescribedBy?: string;
     options?: DropdownOption[];

package/dist/componentProps/atoms/input/inputProps.d.ts

@@ -5,6 +5,11 @@ export interface InputProps {
     type?: "text" | "email" | "password" | "tel" | "number" | "search" | "date";
     value?: string;
     placeholder?: string;
+    role?: React.AriaRole;
+    ariaExpanded?: boolean;
+    ariaControls?: string;
+    ariaActiveDescendant?: string;
+    ariaAutoComplete?: React.AriaAttributes["aria-autocomplete"];
     ariaLabel?: string;
     ariaDescribedBy?: string;
     disabled?: boolean;

package/dist/componentProps/molecules/cart/cartactions/CartActionsProps.d.ts

@@ -1,5 +1,13 @@
+/** Availability of the current SKU and purchase tab, supplied by the app. */
+export type ProductPurchaseAvailability = {
+    status: "available";
+} | {
+    status: "outOfStock";
+    label?: string;
+};
 export type CartActionsProps = {
-    /** App-provided validation error for the purchase quantity or selected item. */
+    availability?: ProductPurchaseAvailability;
+    /** App-provided validation or availability message displayed above the purchase controls. */
     errorMessage?: string;
     initialQuantity?: number;
     minQuantity?: number;

package/dist/componentProps/molecules/searchcombobox/SearchComboboxProps.d.ts

@@ -19,6 +19,13 @@ export interface SearchComboboxClearPayload {
 }
 export type SearchComboboxValueStatus = "default" | "inactive";
 export interface SearchComboboxProps {
+    variant?: "search" | "address";
+    autoComplete?: string;
+    ariaDescribedBy?: string;
+    errorMessage?: string;
+    suggestionsFooter?: React.ReactNode;
+    onInputChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
+    onBlur?: (event: React.FocusEvent<HTMLInputElement>) => void;
     id?: string;
     name?: string;
     ariaLabel?: string;
@@ -26,6 +33,9 @@ export interface SearchComboboxProps {
     value?: string;
     options: SearchComboboxOption[];
     emptyMessage?: string;
+    /** App-owned request state. Clear options when the query changes and discard stale responses. */
+    isLoading?: boolean;
+    loadingMessage?: string;
     minQueryLength?: number;
     disabled?: boolean;
     readOnly?: boolean;
@@ -38,4 +48,5 @@ export interface SearchComboboxProps {
     onSearchSubmit?: (payload: SearchComboboxSubmitPayload) => void;
     onClear?: (payload: SearchComboboxClearPayload) => void;
 }
+import type React from "react";
 import type { SearchBarControlSize } from "../searchbar/SearchBarProps";

package/dist/componentProps/organisms/cart/purchasepanel/PurchasePanelLeftPanelProps.d.ts

@@ -1,3 +1,4 @@
+import type { ProductPurchaseAvailability } from "../../../molecules/cart/cartactions/CartActionsProps";
 import type { ButtonGridItem } from "../../../molecules/buttons/buttongrid/ButtonGridProps";
 import type { ReactNode } from "react";
 import type { ColourMatchingChartData } from "../../../molecules/productinformation/colourmatchingchart/ColourMatchingChartProps";
@@ -56,6 +57,8 @@ export type PurchasePanelLeftPanelProps = {
     showCartActions?: boolean;
     showFavorites?: boolean;
     actionMode?: PurchasePanelActionMode;
+    /** Availability of the current selection and tab; omitted means available. */
+    availability?: ProductPurchaseAvailability;
     contactActions?: [ProductContactAction, ProductContactAction];
     onQuantityChange?: (quantity: number) => void;
     onAddToWishlist?: () => void;

package/dist/componentProps/organisms/cart/purchasepanel/PurchasePanelProps.d.ts

@@ -1,3 +1,4 @@
+import type { ProductPurchaseAvailability } from "../../../molecules/cart/cartactions/CartActionsProps";
 import type { SwatchPurchasePanelCarousel } from "./PurchasePanelRightPanelProps";
 import type { ColourMatchingChartData } from "../../../molecules/productinformation/colourmatchingchart/ColourMatchingChartProps";
 import type { ProductContactAction, ProductContactActionClickPayload } from "../../../molecules/cart/productcontactactions/ProductContactActionsProps";
@@ -108,13 +109,15 @@ export type PurchasePanelProps = {
     priceLabel?: string;
     priceValue?: number;
     currency?: string;
-    /** App-provided validation error for the purchase quantity or selected item. */
+    /** App-provided validation or availability message displayed above the purchase controls. */
     errorMessage?: string;
     initialQuantity?: number;
     minQuantity?: number;
     maxQuantity?: number;
     showFavorites?: boolean;
     actionMode?: PurchasePanelActionMode;
+    /** Availability of the current selection and tab; omitted means available. */
+    availability?: ProductPurchaseAvailability;
     contactActions?: [ProductContactAction, ProductContactAction];
     onAddToWishlist?: (payload: AddToFavoritesPayloadProps) => void;
     onAddToCart?: (order: CartOrderProps) => void;

package/dist/componentProps/organisms/cart/shippingaddressform/ShippingAddressFormProps.d.ts

@@ -1,6 +1,18 @@
 import React from "react";
+import type { SearchComboboxOption, SearchComboboxSelectPayload } from "../../../molecules/searchcombobox/SearchComboboxProps";
 import { DropdownOption } from "../../../atoms/dropdown/DropdownProps";
 import type { UserTypeOption, UserTypeValue } from "../../../shared/UserTypeOptions";
+export interface ShippingAddressAutocompleteProps {
+    options: SearchComboboxOption[];
+    /** The app must clear stale options and ignore responses for older queries. */
+    isLoading?: boolean;
+    loadingMessage?: string;
+    minQueryLength?: number;
+    emptyMessage?: string;
+    suggestionsFooter?: React.ReactNode;
+    onOptionSelect?: (payload: SearchComboboxSelectPayload) => void;
+}
+export type AddressPurpose = "shipping" | "billing";
 export type ShippingAddressRegionVariant = "default" | "ca" | "mx" | "uk";
 export type ShippingCountryDisplayMode = "select" | "readonly";
 export interface ShippingAddressFormErrors {
@@ -18,6 +30,9 @@ export interface ShippingAddressFormErrors {
     stateProvince?: string;
 }
 export interface ShippingAddressFormProps {
+    /** Separates browser autofill for shipping and billing details. */
+    addressPurpose?: AddressPurpose;
+    addressAutocomplete?: ShippingAddressAutocompleteProps;
     title?: string;
     idPrefix?: string;
     firstName?: string;

package/dist/componentProps/organisms/navigation/PromoBannerProps.d.ts

@@ -0,0 +1,8 @@
+export type PromoBannerProps = {
+    open: boolean;
+    message: string;
+    onClose: () => void;
+    onButtonClick?: () => void;
+    buttonLabel?: string;
+    closeLabel?: string;
+};

package/dist/componentProps/templates/productdetailpagetemplate/ProductDetailPageTemplateProps.d.ts

@@ -1,3 +1,4 @@
+import type { ProductPurchaseAvailability } from "../../molecules/cart/cartactions/CartActionsProps";
 import { BreadcrumbsProps } from "../../molecules/selectors/breadcrumb/BreadcrumbsProps";
 import { ProductInformationTabLabels, ProductInformationTabKey, SizeAndGradeDefinition } from "../../organisms/sections/productinformationsection/ProductInformationSectionProps";
 import { CartFlyoutProps } from "../../organisms/cart/cartflyout/CartFlyoutProps";
@@ -248,11 +249,13 @@ export type ProductDetailCartFlyoutProps = CartFlyoutProps;
 export type ProductDetailPageTemplateProps = {
     breadcrumbsProps?: BreadcrumbsProps;
     productData: ProductDetailData;
-    /** App-provided validation error displayed above the purchase quantity controls. */
+    /** App-provided validation or availability message displayed above the purchase controls. */
     errorMessage?: string;
     /** Reports initial selection and subsequent quantity, tab, or option changes. */
     onSelectionChange?: (selection: ProductDetailOrder) => void;
     showFavorites?: boolean;
+    /** Availability of the current selection and tab; omitted means available. */
+    availability?: ProductPurchaseAvailability;
     onDownloadSwatch?: (productData: ProductDetailData) => void;
     onDownloadFullSheet?: (productData: ProductDetailData) => void;
     onAddToWishlist?: (payload: ProductDetailWishlistPayload, productData: ProductDetailData) => void;