bitsnap-react 1.5.0 → 1.6.0

package/dist/index.d.mts

@@ -1,6 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
+import { CSSProperties, ReactNode } from 'react';
 import z__default from 'zod';
+export { BitsnapReturns, BitsnapReturnsProps, BitsnapReturnsProvider, BitsnapReturnsProviderProps, Environment, useCreateReturn, useMyReturns, useReturnOrders, useReturnSession, useReturnableOrder } from './returns.mjs';
+import '@tanstack/react-query';
+import '@bufbuild/protobuf/wkt';
+import '@bufbuild/protobuf';
 
 type AppleButtonType = "plain" | "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
 type ColorType = "black" | "white" | "white-outline";
@@ -28,6 +32,78 @@ type Props$3 = {
 };
 declare function Wrapper$2(props: Props$3): react_jsx_runtime.JSX.Element;
 
+/**
+ * Checkout appearance API.
+ *
+ * `CheckoutAppearance` is resolved once per render into plain data: a theme
+ * name, the tokens that are actually in effect, the per-slot overrides and the
+ * inline style that both theme boundaries (the drawer root and the portalled
+ * country dropdown) have to receive. Everything here is pure so it can be
+ * tested without a DOM.
+ *
+ * Backward compatibility: the resolver never invents values. A token is only
+ * present in the resolved output when the caller provided it or when the
+ * caller explicitly selected a theme preset, so every unset token keeps falling
+ * back to the value the checkout renders today (see `checkout.css`).
+ */
+type CheckoutTheme = "dark" | "light";
+type CheckoutAppearanceTokens = {
+    /** Checkout wide font family. The library never loads fonts. */
+    fontFamily?: string;
+    /** Base font size of the checkout. */
+    fontSize?: string;
+    /** Panel background. */
+    background?: string;
+    /** Raised surfaces: country dropdown, search bar, loading skeletons. */
+    surface?: string;
+    /** Main text color. */
+    foreground?: string;
+    /** Secondary text: empty cart, delivery info, country label, search input. */
+    mutedForeground?: string;
+    /** Borders: country trigger, dropdown, product separators. */
+    border?: string;
+    /** Checkout button background. */
+    buttonBackground?: string;
+    /** Checkout button text. */
+    buttonForeground?: string;
+    /** Checkout button background on hover. */
+    buttonHoverBackground?: string;
+    /** Hover and selected surfaces: close button, country options. */
+    hoverSurface?: string;
+    /** Focus ring color. Also applied to shared UI primitives through `--ring`. */
+    focusRing?: string;
+    /** Error and unavailable state color. */
+    error?: string;
+    /** Drawer backdrop color. */
+    overlay?: string;
+    /** Corner radius, applied through `--radius`. */
+    radius?: string;
+};
+/**
+ * Stable slot names. They are exposed as `data-bitsnap-checkout-slot`
+ * attributes so they can also be targeted from plain CSS.
+ */
+declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
+type CheckoutSlotName = (typeof CHECKOUT_SLOT_NAMES)[number];
+type CheckoutSlotAppearance = {
+    /** Merged after the built-in classes with `cn`, so Tailwind conflicts resolve. */
+    className?: string;
+    /** Merged after the built-in inline styles. */
+    style?: CSSProperties;
+};
+type CheckoutAppearanceElements = Partial<Record<CheckoutSlotName, CheckoutSlotAppearance>>;
+type CheckoutAppearance = {
+    /**
+     * `"dark"` keeps the current presentation, `"light"` applies the light preset.
+     * Omitted means `"dark"`.
+     */
+    theme?: CheckoutTheme;
+    /** Partial overrides. Anything omitted keeps today's value. */
+    tokens?: CheckoutAppearanceTokens;
+    /** Per element `className`/`style` overrides. */
+    elements?: CheckoutAppearanceElements;
+};
+
 type BitsnapCartProps = {
     projectID: string;
     locale?: string;
@@ -38,8 +114,13 @@ type BitsnapCartProps = {
         style?: React.CSSProperties;
         isVisible?: boolean;
     };
+    /**
+     * Optional checkout appearance. Omitting it (or passing `{}`) keeps the
+     * current presentation; every token and element slot is partial.
+     */
+    appearance?: CheckoutAppearance;
 };
-declare function BitsnapCart({ projectID, locale, children, onVisibleChange, className, numberOfProductsInCartOptions, }: BitsnapCartProps): react_jsx_runtime.JSX.Element;
+declare function BitsnapCart({ projectID, locale, children, onVisibleChange, className, numberOfProductsInCartOptions, appearance, }: BitsnapCartProps): react_jsx_runtime.JSX.Element;
 
 type Props$2 = {
     test?: boolean;
@@ -261,6 +342,7 @@ declare const linkRequestSchema: z__default.ZodObject<{
     items: z__default.ZodArray<z__default.ZodObject<{
         id: z__default.ZodString;
         quantity: z__default.ZodNumber;
+        priceVersion: z__default.ZodOptional<z__default.ZodString>;
         name: z__default.ZodOptional<z__default.ZodString>;
         description: z__default.ZodOptional<z__default.ZodString>;
         imageURL: z__default.ZodOptional<z__default.ZodString>;
@@ -379,4 +461,4 @@ declare function persistReturnURL(returnURL: string | null): void;
 declare function readPersistedReturnURL(): string | null;
 declare function buildAccessTokenRedirect(returnURL: string, accessToken: string): string;
 
-export { Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type ComponentClassNames, type CustomizationTexts, type GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, type PanelLoginProps, type PanelProps, PanelProvider, type PanelScreen, type PanelSearchParamsType, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };
+export { Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTheme, type ComponentClassNames, type CustomizationTexts, type GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, type PanelLoginProps, type PanelProps, PanelProvider, type PanelScreen, type PanelSearchParamsType, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
+import { CSSProperties, ReactNode } from 'react';
 import z__default from 'zod';
+export { BitsnapReturns, BitsnapReturnsProps, BitsnapReturnsProvider, BitsnapReturnsProviderProps, Environment, useCreateReturn, useMyReturns, useReturnOrders, useReturnSession, useReturnableOrder } from './returns.js';
+import '@tanstack/react-query';
+import '@bufbuild/protobuf/wkt';
+import '@bufbuild/protobuf';
 
 type AppleButtonType = "plain" | "add-money" | "book" | "buy" | "check-out" | "continue" | "contribute" | "donate" | "order" | "pay" | "reload" | "rent" | "set-up" | "subscribe" | "support" | "tip" | "top-up";
 type ColorType = "black" | "white" | "white-outline";
@@ -28,6 +32,78 @@ type Props$3 = {
 };
 declare function Wrapper$2(props: Props$3): react_jsx_runtime.JSX.Element;
 
+/**
+ * Checkout appearance API.
+ *
+ * `CheckoutAppearance` is resolved once per render into plain data: a theme
+ * name, the tokens that are actually in effect, the per-slot overrides and the
+ * inline style that both theme boundaries (the drawer root and the portalled
+ * country dropdown) have to receive. Everything here is pure so it can be
+ * tested without a DOM.
+ *
+ * Backward compatibility: the resolver never invents values. A token is only
+ * present in the resolved output when the caller provided it or when the
+ * caller explicitly selected a theme preset, so every unset token keeps falling
+ * back to the value the checkout renders today (see `checkout.css`).
+ */
+type CheckoutTheme = "dark" | "light";
+type CheckoutAppearanceTokens = {
+    /** Checkout wide font family. The library never loads fonts. */
+    fontFamily?: string;
+    /** Base font size of the checkout. */
+    fontSize?: string;
+    /** Panel background. */
+    background?: string;
+    /** Raised surfaces: country dropdown, search bar, loading skeletons. */
+    surface?: string;
+    /** Main text color. */
+    foreground?: string;
+    /** Secondary text: empty cart, delivery info, country label, search input. */
+    mutedForeground?: string;
+    /** Borders: country trigger, dropdown, product separators. */
+    border?: string;
+    /** Checkout button background. */
+    buttonBackground?: string;
+    /** Checkout button text. */
+    buttonForeground?: string;
+    /** Checkout button background on hover. */
+    buttonHoverBackground?: string;
+    /** Hover and selected surfaces: close button, country options. */
+    hoverSurface?: string;
+    /** Focus ring color. Also applied to shared UI primitives through `--ring`. */
+    focusRing?: string;
+    /** Error and unavailable state color. */
+    error?: string;
+    /** Drawer backdrop color. */
+    overlay?: string;
+    /** Corner radius, applied through `--radius`. */
+    radius?: string;
+};
+/**
+ * Stable slot names. They are exposed as `data-bitsnap-checkout-slot`
+ * attributes so they can also be targeted from plain CSS.
+ */
+declare const CHECKOUT_SLOT_NAMES: readonly ["root", "overlay", "panel", "header", "title", "closeButton", "productList", "product", "productImage", "productName", "productPrice", "quantityControl", "quantityInput", "quantityButton", "removeButton", "summary", "totalLabel", "totalValue", "deliveryText", "countryLabel", "countryTrigger", "countryDropdown", "countrySearch", "countryOption", "paymentButtons", "checkoutButton", "emptyState", "error", "skeleton"];
+type CheckoutSlotName = (typeof CHECKOUT_SLOT_NAMES)[number];
+type CheckoutSlotAppearance = {
+    /** Merged after the built-in classes with `cn`, so Tailwind conflicts resolve. */
+    className?: string;
+    /** Merged after the built-in inline styles. */
+    style?: CSSProperties;
+};
+type CheckoutAppearanceElements = Partial<Record<CheckoutSlotName, CheckoutSlotAppearance>>;
+type CheckoutAppearance = {
+    /**
+     * `"dark"` keeps the current presentation, `"light"` applies the light preset.
+     * Omitted means `"dark"`.
+     */
+    theme?: CheckoutTheme;
+    /** Partial overrides. Anything omitted keeps today's value. */
+    tokens?: CheckoutAppearanceTokens;
+    /** Per element `className`/`style` overrides. */
+    elements?: CheckoutAppearanceElements;
+};
+
 type BitsnapCartProps = {
     projectID: string;
     locale?: string;
@@ -38,8 +114,13 @@ type BitsnapCartProps = {
         style?: React.CSSProperties;
         isVisible?: boolean;
     };
+    /**
+     * Optional checkout appearance. Omitting it (or passing `{}`) keeps the
+     * current presentation; every token and element slot is partial.
+     */
+    appearance?: CheckoutAppearance;
 };
-declare function BitsnapCart({ projectID, locale, children, onVisibleChange, className, numberOfProductsInCartOptions, }: BitsnapCartProps): react_jsx_runtime.JSX.Element;
+declare function BitsnapCart({ projectID, locale, children, onVisibleChange, className, numberOfProductsInCartOptions, appearance, }: BitsnapCartProps): react_jsx_runtime.JSX.Element;
 
 type Props$2 = {
     test?: boolean;
@@ -261,6 +342,7 @@ declare const linkRequestSchema: z__default.ZodObject<{
     items: z__default.ZodArray<z__default.ZodObject<{
         id: z__default.ZodString;
         quantity: z__default.ZodNumber;
+        priceVersion: z__default.ZodOptional<z__default.ZodString>;
         name: z__default.ZodOptional<z__default.ZodString>;
         description: z__default.ZodOptional<z__default.ZodString>;
         imageURL: z__default.ZodOptional<z__default.ZodString>;
@@ -379,4 +461,4 @@ declare function persistReturnURL(returnURL: string | null): void;
 declare function readPersistedReturnURL(): string | null;
 declare function buildAccessTokenRedirect(returnURL: string, accessToken: string): string;
 
-export { Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type ComponentClassNames, type CustomizationTexts, type GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, type PanelLoginProps, type PanelProps, PanelProvider, type PanelScreen, type PanelSearchParamsType, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };
+export { Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTheme, type ComponentClassNames, type CustomizationTexts, type GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, type PanelLoginProps, type PanelProps, PanelProvider, type PanelScreen, type PanelSearchParamsType, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };