bitsnap-react 1.7.1 → 1.8.0

package/dist/returns.mjs

@@ -1,2 +1,2 @@
-import{a as L}from"./chunk-6KQBDN7M.mjs";import{A as p,C as u,D as R,E as o,F as y,G as a,H as i,I as m,J as l,L as x,M as d,N as P,O as f,P as S,Q as c,R as T,S as C,h as e,u as t,v as r,w as s,x as n}from"./chunk-4HOZFM6V.mjs";import"./chunk-3TENJTY4.mjs";import"./chunk-U6FLIRIV.mjs";export{L as BitsnapReturns,R as BitsnapReturnsProvider,e as Environment,t as RETURNS_SLOT_NAMES,r as ReturnsAppearanceProvider,d as ReturnsCodeStep,S as ReturnsConfirmation,x as ReturnsEmailStep,C as ReturnsMyReturnDetail,T as ReturnsMyReturnsList,f as ReturnsOrderDetail,P as ReturnsOrderList,u as ReturnsProvider,c as ReturnsResult,i as useCreateReturn,l as useMyReturn,m as useMyReturns,y as useReturnOrders,o as useReturnSession,a as useReturnableOrder,s as useReturnsAppearance,n as useReturnsSlot,p as useReturnsText};
+import{a as L}from"./chunk-OJT3YO2R.mjs";import{A as C,c as t,d as r,e as s,f as n,i as p,k as u,l as R,m as o,n as y,o as a,p as i,q as m,r as l,t as x,u as d,v as P,w as f,x as S,y as c,z as T}from"./chunk-45AP7UZE.mjs";import"./chunk-KOVKUJAW.mjs";import{h as e}from"./chunk-WSM4OM72.mjs";import"./chunk-OUYRKNZJ.mjs";import"./chunk-U6FLIRIV.mjs";export{L as BitsnapReturns,R as BitsnapReturnsProvider,e as Environment,t as RETURNS_SLOT_NAMES,r as ReturnsAppearanceProvider,d as ReturnsCodeStep,S as ReturnsConfirmation,x as ReturnsEmailStep,C as ReturnsMyReturnDetail,T as ReturnsMyReturnsList,f as ReturnsOrderDetail,P as ReturnsOrderList,u as ReturnsProvider,c as ReturnsResult,i as useCreateReturn,l as useMyReturn,m as useMyReturns,y as useReturnOrders,o as useReturnSession,a as useReturnableOrder,s as useReturnsAppearance,n as useReturnsSlot,p as useReturnsText};
 //# sourceMappingURL=returns.mjs.map

package/dist/texts-CIEFbJTN.d.ts

@@ -0,0 +1,196 @@
+import { CSSProperties } from 'react';
+import { S as SlotAppearance, A as AppearanceElements } from './appearance-core-Dt2grZdl.js';
+
+/**
+ * Returns appearance API.
+ *
+ * It mirrors `CheckoutAppearance` (theme, tokens, elements) so a shop can reuse
+ * one brand object for both. The resolver is pure: it turns the caller input
+ * into a theme name, the tokens in effect, the slot overrides and the inline
+ * style for the theme boundary.
+ */
+type ReturnsTheme = "light" | "dark";
+type ReturnsAppearanceTokens = {
+    /** Font family of the returns views. The library never loads fonts. */
+    fontFamily?: string;
+    /** Base font size. */
+    fontSize?: string;
+    /** Page background. */
+    background?: string;
+    /** Raised surfaces: cards, skeletons, summaries. */
+    surface?: string;
+    /** Main text color. */
+    foreground?: string;
+    /** Secondary text: descriptions, dates, hints. */
+    mutedForeground?: string;
+    /** Borders of cards, inputs and separators. */
+    border?: string;
+    /** Primary button background. */
+    buttonBackground?: string;
+    /** Primary button text. */
+    buttonForeground?: string;
+    /** Primary button background on hover. */
+    buttonHoverBackground?: string;
+    /** Hover surface of secondary buttons and selectable cards. */
+    hoverSurface?: string;
+    /** Focus ring color. Also applied to shared UI primitives through `--ring`. */
+    focusRing?: string;
+    /** Error color. */
+    error?: string;
+    /** Success color: result screen, completed and refunded statuses. */
+    success?: string;
+    /** Warning color: statuses that need attention. */
+    warning?: string;
+    /** Status badge background. */
+    badgeBackground?: string;
+    /** Status badge text. */
+    badgeForeground?: string;
+    /** Background of text inputs and the note field. */
+    inputBackground?: string;
+    /** Corner radius, applied through `--radius`. */
+    radius?: string;
+};
+/**
+ * Stable slot names. They are exposed as `data-bitsnap-returns-slot`
+ * attributes so they can also be targeted from plain CSS.
+ */
+declare const RETURNS_SLOT_NAMES: readonly ["root", "header", "title", "description", "backButton", "stepIndicator", "error", "emptyState", "skeleton", "emailForm", "emailInput", "codeForm", "codeInput", "resendButton", "logoutButton", "orderList", "orderCard", "orderReference", "orderDate", "orderTotal", "pagination", "lineList", "line", "lineName", "linePrice", "lineQuantityControl", "quantityButton", "quantityInput", "lineIneligibleReason", "noteInput", "summary", "submitButton", "secondaryButton", "successState", "returnReference", "returnInstructions", "returnList", "returnCard", "statusBadge", "history", "historyEntry"];
+type ReturnsSlotName = (typeof RETURNS_SLOT_NAMES)[number];
+type ReturnsSlotAppearance = SlotAppearance;
+type ReturnsAppearanceElements = AppearanceElements<ReturnsSlotName>;
+type ReturnsAppearance = {
+    /** `"light"` or `"dark"`. Omitted means `"light"`. */
+    theme?: ReturnsTheme;
+    /** Partial overrides applied over the theme preset. */
+    tokens?: ReturnsAppearanceTokens;
+    /** Per element `className`/`style` overrides. */
+    elements?: ReturnsAppearanceElements;
+};
+type ResolvedReturnsAppearance = {
+    theme: ReturnsTheme;
+    /** Tokens that are in effect (the theme preset plus caller overrides). */
+    tokens: ReturnsAppearanceTokens;
+    elements: ReturnsAppearanceElements;
+    /** Theme marker class for the theme boundary. */
+    boundaryClassName: string;
+    /** Inline custom properties applied to the returns root. */
+    boundaryStyle: CSSProperties;
+};
+
+/**
+ * Every string the returns views render. Pass a partial object through the
+ * `texts` prop of `BitsnapReturns`/`ReturnsProvider` to override any of them,
+ * whatever the locale. Strings with `{name}` placeholders keep them in
+ * overrides; unknown placeholders are left untouched.
+ */
+type ReturnsTexts = {
+    /** Label of the back buttons. */
+    back: string;
+    /** Step indicator, placeholders `{current}` and `{total}`. */
+    stepIndicator: string;
+    /** Skeleton accessible label. */
+    loading: string;
+    /** Button that opens the list of previous returns. */
+    myReturnsLink: string;
+    emailStepTitle: string;
+    emailStepDescription: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    emailSubmit: string;
+    codeStepTitle: string;
+    /** Placeholder `{email}`. */
+    codeStepDescription: string;
+    codeLabel: string;
+    codeSubmit: string;
+    resend: string;
+    /** Placeholder `{seconds}`. */
+    resendIn: string;
+    logout: string;
+    ordersTitle: string;
+    ordersDescription: string;
+    ordersEmpty: string;
+    /** Placeholder `{reference}`. */
+    orderTitle: string;
+    /** Placeholder `{count}`. */
+    orderReturnableLines: string;
+    orderSelect: string;
+    paginationPrevious: string;
+    paginationNext: string;
+    /** Placeholders `{page}` and `{total}` (number of orders). */
+    paginationInfo: string;
+    /** Placeholder `{reference}`. */
+    orderDetailTitle: string;
+    orderDetailDescription: string;
+    /** Placeholder `{name}`. */
+    quantityLabel: string;
+    /** Placeholder `{name}`. */
+    quantityDecrease: string;
+    /** Placeholder `{name}`. */
+    quantityIncrease: string;
+    /** Placeholder `{available}`. */
+    quantityOfAvailable: string;
+    /** Shown for an ineligible line without a reason from the backend. */
+    lineIneligibleFallback: string;
+    noteLabel: string;
+    notePlaceholder: string;
+    selectionContinue: string;
+    selectionEmpty: string;
+    previousReturnsTitle: string;
+    confirmationTitle: string;
+    confirmationDescription: string;
+    confirmationSummary: string;
+    /** Placeholder `{quantity}`. */
+    confirmationQuantity: string;
+    confirmationNote: string;
+    confirmationSubmit: string;
+    successTitle: string;
+    successDescription: string;
+    successReference: string;
+    successInstructions: string;
+    successDone: string;
+    myReturnsTitle: string;
+    myReturnsDescription: string;
+    myReturnsEmpty: string;
+    myReturnOpen: string;
+    myReturnDetailTitle: string;
+    /** Placeholder `{reference}`. */
+    myReturnTitle: string;
+    myReturnCreatedAt: string;
+    myReturnRefund: string;
+    myReturnLines: string;
+    /** Placeholders `{requested}`, `{approved}`, `{received}`. */
+    myReturnLineQuantities: string;
+    myReturnNote: string;
+    myReturnHistory: string;
+    statusSubmitted: string;
+    statusApproved: string;
+    statusRejected: string;
+    statusAwaitingReceipt: string;
+    statusReceived: string;
+    statusCompleted: string;
+    statusCancelled: string;
+    statusRefunded: string;
+    /** Any status the backend adds later. */
+    statusFallback: string;
+    refundStatusNotStarted: string;
+    refundStatusPending: string;
+    refundStatusSucceeded: string;
+    refundStatusFailed: string;
+    refundStatusFallback: string;
+    errorGeneric: string;
+    errorInvalidEmail: string;
+    errorInvalidCode: string;
+    errorSessionExpired: string;
+    errorOrderNotFound: string;
+    errorReturnNotFound: string;
+    errorQuantityUnavailable: string;
+    errorItemNotReturnable: string;
+    errorReturnsDisabled: string;
+    errorRateLimited: string;
+    errorIdempotencyConflict: string;
+    errorDeliveryFailed: string;
+    errorRetry: string;
+};
+type ReturnsTextKey = keyof ReturnsTexts;
+
+export { type ReturnsAppearance as R, type ReturnsTexts as a, RETURNS_SLOT_NAMES as b, type ReturnsAppearanceElements as c, type ReturnsAppearanceTokens as d, type ReturnsSlotAppearance as e, type ReturnsSlotName as f, type ReturnsTheme as g, type ReturnsTextKey as h, type ResolvedReturnsAppearance as i };

package/dist/texts-tQtAGJCT.d.mts

@@ -0,0 +1,196 @@
+import { CSSProperties } from 'react';
+import { S as SlotAppearance, A as AppearanceElements } from './appearance-core-Dt2grZdl.mjs';
+
+/**
+ * Returns appearance API.
+ *
+ * It mirrors `CheckoutAppearance` (theme, tokens, elements) so a shop can reuse
+ * one brand object for both. The resolver is pure: it turns the caller input
+ * into a theme name, the tokens in effect, the slot overrides and the inline
+ * style for the theme boundary.
+ */
+type ReturnsTheme = "light" | "dark";
+type ReturnsAppearanceTokens = {
+    /** Font family of the returns views. The library never loads fonts. */
+    fontFamily?: string;
+    /** Base font size. */
+    fontSize?: string;
+    /** Page background. */
+    background?: string;
+    /** Raised surfaces: cards, skeletons, summaries. */
+    surface?: string;
+    /** Main text color. */
+    foreground?: string;
+    /** Secondary text: descriptions, dates, hints. */
+    mutedForeground?: string;
+    /** Borders of cards, inputs and separators. */
+    border?: string;
+    /** Primary button background. */
+    buttonBackground?: string;
+    /** Primary button text. */
+    buttonForeground?: string;
+    /** Primary button background on hover. */
+    buttonHoverBackground?: string;
+    /** Hover surface of secondary buttons and selectable cards. */
+    hoverSurface?: string;
+    /** Focus ring color. Also applied to shared UI primitives through `--ring`. */
+    focusRing?: string;
+    /** Error color. */
+    error?: string;
+    /** Success color: result screen, completed and refunded statuses. */
+    success?: string;
+    /** Warning color: statuses that need attention. */
+    warning?: string;
+    /** Status badge background. */
+    badgeBackground?: string;
+    /** Status badge text. */
+    badgeForeground?: string;
+    /** Background of text inputs and the note field. */
+    inputBackground?: string;
+    /** Corner radius, applied through `--radius`. */
+    radius?: string;
+};
+/**
+ * Stable slot names. They are exposed as `data-bitsnap-returns-slot`
+ * attributes so they can also be targeted from plain CSS.
+ */
+declare const RETURNS_SLOT_NAMES: readonly ["root", "header", "title", "description", "backButton", "stepIndicator", "error", "emptyState", "skeleton", "emailForm", "emailInput", "codeForm", "codeInput", "resendButton", "logoutButton", "orderList", "orderCard", "orderReference", "orderDate", "orderTotal", "pagination", "lineList", "line", "lineName", "linePrice", "lineQuantityControl", "quantityButton", "quantityInput", "lineIneligibleReason", "noteInput", "summary", "submitButton", "secondaryButton", "successState", "returnReference", "returnInstructions", "returnList", "returnCard", "statusBadge", "history", "historyEntry"];
+type ReturnsSlotName = (typeof RETURNS_SLOT_NAMES)[number];
+type ReturnsSlotAppearance = SlotAppearance;
+type ReturnsAppearanceElements = AppearanceElements<ReturnsSlotName>;
+type ReturnsAppearance = {
+    /** `"light"` or `"dark"`. Omitted means `"light"`. */
+    theme?: ReturnsTheme;
+    /** Partial overrides applied over the theme preset. */
+    tokens?: ReturnsAppearanceTokens;
+    /** Per element `className`/`style` overrides. */
+    elements?: ReturnsAppearanceElements;
+};
+type ResolvedReturnsAppearance = {
+    theme: ReturnsTheme;
+    /** Tokens that are in effect (the theme preset plus caller overrides). */
+    tokens: ReturnsAppearanceTokens;
+    elements: ReturnsAppearanceElements;
+    /** Theme marker class for the theme boundary. */
+    boundaryClassName: string;
+    /** Inline custom properties applied to the returns root. */
+    boundaryStyle: CSSProperties;
+};
+
+/**
+ * Every string the returns views render. Pass a partial object through the
+ * `texts` prop of `BitsnapReturns`/`ReturnsProvider` to override any of them,
+ * whatever the locale. Strings with `{name}` placeholders keep them in
+ * overrides; unknown placeholders are left untouched.
+ */
+type ReturnsTexts = {
+    /** Label of the back buttons. */
+    back: string;
+    /** Step indicator, placeholders `{current}` and `{total}`. */
+    stepIndicator: string;
+    /** Skeleton accessible label. */
+    loading: string;
+    /** Button that opens the list of previous returns. */
+    myReturnsLink: string;
+    emailStepTitle: string;
+    emailStepDescription: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    emailSubmit: string;
+    codeStepTitle: string;
+    /** Placeholder `{email}`. */
+    codeStepDescription: string;
+    codeLabel: string;
+    codeSubmit: string;
+    resend: string;
+    /** Placeholder `{seconds}`. */
+    resendIn: string;
+    logout: string;
+    ordersTitle: string;
+    ordersDescription: string;
+    ordersEmpty: string;
+    /** Placeholder `{reference}`. */
+    orderTitle: string;
+    /** Placeholder `{count}`. */
+    orderReturnableLines: string;
+    orderSelect: string;
+    paginationPrevious: string;
+    paginationNext: string;
+    /** Placeholders `{page}` and `{total}` (number of orders). */
+    paginationInfo: string;
+    /** Placeholder `{reference}`. */
+    orderDetailTitle: string;
+    orderDetailDescription: string;
+    /** Placeholder `{name}`. */
+    quantityLabel: string;
+    /** Placeholder `{name}`. */
+    quantityDecrease: string;
+    /** Placeholder `{name}`. */
+    quantityIncrease: string;
+    /** Placeholder `{available}`. */
+    quantityOfAvailable: string;
+    /** Shown for an ineligible line without a reason from the backend. */
+    lineIneligibleFallback: string;
+    noteLabel: string;
+    notePlaceholder: string;
+    selectionContinue: string;
+    selectionEmpty: string;
+    previousReturnsTitle: string;
+    confirmationTitle: string;
+    confirmationDescription: string;
+    confirmationSummary: string;
+    /** Placeholder `{quantity}`. */
+    confirmationQuantity: string;
+    confirmationNote: string;
+    confirmationSubmit: string;
+    successTitle: string;
+    successDescription: string;
+    successReference: string;
+    successInstructions: string;
+    successDone: string;
+    myReturnsTitle: string;
+    myReturnsDescription: string;
+    myReturnsEmpty: string;
+    myReturnOpen: string;
+    myReturnDetailTitle: string;
+    /** Placeholder `{reference}`. */
+    myReturnTitle: string;
+    myReturnCreatedAt: string;
+    myReturnRefund: string;
+    myReturnLines: string;
+    /** Placeholders `{requested}`, `{approved}`, `{received}`. */
+    myReturnLineQuantities: string;
+    myReturnNote: string;
+    myReturnHistory: string;
+    statusSubmitted: string;
+    statusApproved: string;
+    statusRejected: string;
+    statusAwaitingReceipt: string;
+    statusReceived: string;
+    statusCompleted: string;
+    statusCancelled: string;
+    statusRefunded: string;
+    /** Any status the backend adds later. */
+    statusFallback: string;
+    refundStatusNotStarted: string;
+    refundStatusPending: string;
+    refundStatusSucceeded: string;
+    refundStatusFailed: string;
+    refundStatusFallback: string;
+    errorGeneric: string;
+    errorInvalidEmail: string;
+    errorInvalidCode: string;
+    errorSessionExpired: string;
+    errorOrderNotFound: string;
+    errorReturnNotFound: string;
+    errorQuantityUnavailable: string;
+    errorItemNotReturnable: string;
+    errorReturnsDisabled: string;
+    errorRateLimited: string;
+    errorIdempotencyConflict: string;
+    errorDeliveryFailed: string;
+    errorRetry: string;
+};
+type ReturnsTextKey = keyof ReturnsTexts;
+
+export { type ReturnsAppearance as R, type ReturnsTexts as a, RETURNS_SLOT_NAMES as b, type ReturnsAppearanceElements as c, type ReturnsAppearanceTokens as d, type ReturnsSlotAppearance as e, type ReturnsSlotName as f, type ReturnsTheme as g, type ReturnsTextKey as h, type ResolvedReturnsAppearance as i };

package/dist/types-BTm_ZolC.d.ts

@@ -0,0 +1,40 @@
+import { R as ReturnsAppearance, a as ReturnsTexts } from './texts-CIEFbJTN.js';
+
+interface GetThemeOutput {
+    logoURL?: string;
+    logoDarkURL?: string;
+    colors?: {
+        brand?: string;
+        brandDark?: string;
+    };
+}
+type PanelScreen = "products" | "notifications" | "profile" | "plans" | "orders" | "order-details" | "returns" | "return-details" | "course";
+type PanelSearchParamsType = {
+    product?: string;
+    state: PanelScreen;
+    orderId?: string;
+    returnId?: string;
+    /** `state: "course"`: `UserProduct.accessId` of the open course. */
+    course?: string;
+    /** `state: "course"`: id of the open lesson or test. */
+    item?: string;
+};
+interface PanelProps {
+    projectID: string;
+    theme?: GetThemeOutput;
+    loginURL: string;
+    /**
+     * Appearance of the Returns screen. When omitted, `buttonBackground`,
+     * `focusRing` and a readable `buttonForeground` are derived from
+     * `theme.colors.brand`.
+     */
+    returnsAppearance?: ReturnsAppearance;
+    /** Text overrides of the Returns screen. */
+    returnsTexts?: Partial<ReturnsTexts>;
+}
+interface PanelLoginProps {
+    projectID: string;
+    theme?: GetThemeOutput;
+}
+
+export type { GetThemeOutput as G, PanelProps as P, PanelLoginProps as a, PanelScreen as b, PanelSearchParamsType as c };

package/dist/types-PSBBDdQm.d.mts

@@ -0,0 +1,40 @@
+import { R as ReturnsAppearance, a as ReturnsTexts } from './texts-tQtAGJCT.mjs';
+
+interface GetThemeOutput {
+    logoURL?: string;
+    logoDarkURL?: string;
+    colors?: {
+        brand?: string;
+        brandDark?: string;
+    };
+}
+type PanelScreen = "products" | "notifications" | "profile" | "plans" | "orders" | "order-details" | "returns" | "return-details" | "course";
+type PanelSearchParamsType = {
+    product?: string;
+    state: PanelScreen;
+    orderId?: string;
+    returnId?: string;
+    /** `state: "course"`: `UserProduct.accessId` of the open course. */
+    course?: string;
+    /** `state: "course"`: id of the open lesson or test. */
+    item?: string;
+};
+interface PanelProps {
+    projectID: string;
+    theme?: GetThemeOutput;
+    loginURL: string;
+    /**
+     * Appearance of the Returns screen. When omitted, `buttonBackground`,
+     * `focusRing` and a readable `buttonForeground` are derived from
+     * `theme.colors.brand`.
+     */
+    returnsAppearance?: ReturnsAppearance;
+    /** Text overrides of the Returns screen. */
+    returnsTexts?: Partial<ReturnsTexts>;
+}
+interface PanelLoginProps {
+    projectID: string;
+    theme?: GetThemeOutput;
+}
+
+export type { GetThemeOutput as G, PanelProps as P, PanelLoginProps as a, PanelScreen as b, PanelSearchParamsType as c };

package/package.json

@@ -1,34 +1,31 @@
 {
   "name": "bitsnap-react",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "description": "This is Bitsnap React library for easy integration with any website which is using React framework",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "type": "commonjs",
-  "scripts": {
-    "build": "tsup",
-    "test:returns-ssr": "pnpm build && node --test test/returns-widget.ssr.test.cjs",
-    "test:catalog-ssr": "pnpm build && node --test test/catalog.ssr.test.cjs",
-    "build:publish": "pnpm build --env.publish",
-    "clean": "rimraf ./dist",
-    "dev": "tsup --watch",
-    "dev:publish": "pnpm dev --env.publish",
-    "test": "tsup src/components/checkout/appearance.test.ts src/components/checkout/texts.test.ts src/lib/appearance-core.test.ts src/lib/texts.test.ts src/components/returns/appearance.test.ts src/components/returns/texts.test.ts src/components/returns/errors.test.ts src/components/returns/money.test.ts src/components/returns/session-storage.test.ts src/components/returns/state-machine.test.ts src/components/returns/selection.test.ts src/components/returns/legacy.test.ts src/panel/returns-appearance.test.ts src/components/products/appearance.test.ts src/components/products/texts.test.ts src/components/products/format.test.ts src/components/products/fetch.test.ts src/components/products/useProducts.test.ts src/components/products/cart-target.test.ts src/components/checkout/cart-items.test.ts --format esm --out-dir .test-dist --no-config --silent && node --test \".test-dist/**/*.test.mjs\"",
-    "test:types": "tsc -p test/consumer/tsconfig.json",
-    "test:package": "node test/consumer/verify-package.mjs"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/emmems/bitsnap-react.git"
   },
-  "keywords": ["bitsnap", "checkout", "shop", "ecommerce"],
+  "keywords": [
+    "bitsnap",
+    "checkout",
+    "shop",
+    "ecommerce"
+  ],
   "author": "Piotr Michalik",
   "license": "SEE LICENSE IN LICENSE file",
   "bugs": {
     "url": "https://github.com/emmems/bitsnap-react/issues"
   },
-  "sideEffects": ["*.css"],
-  "files": ["dist"],
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "dist"
+  ],
   "types": "./dist/index.d.ts",
   "homepage": "https://github.com/emmems/bitsnap-react#readme",
   "devDependencies": {
@@ -36,6 +33,7 @@
     "@types/react": "^19.2.0",
     "@types/react-dom": "^19.2.0",
     "autoprefixer": "^10.4.20",
+    "jsdom": "^30.1.3",
     "postcss": "^8.5.3",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
@@ -65,6 +63,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "dlx": "^0.2.1",
+    "dompurify": "^3.4.17",
     "hls.js": "^1.6.15",
     "input-otp": "^1.4.2",
     "label": "^0.2.2",
@@ -155,15 +154,51 @@
         "default": "./dist/catalog.js"
       }
     },
+    "./course": {
+      "import": {
+        "types": "./dist/course.d.mts",
+        "default": "./dist/course.mjs"
+      },
+      "require": {
+        "types": "./dist/course.d.ts",
+        "default": "./dist/course.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {
     "*": {
-      "models": ["./dist/models.d.ts"],
-      "internal": ["./dist/internal.d.ts"],
-      "errors": ["./dist/errors.d.ts"],
-      "returns": ["./dist/returns.d.ts"],
-      "catalog": ["./dist/catalog.d.ts"]
+      "models": [
+        "./dist/models.d.ts"
+      ],
+      "internal": [
+        "./dist/internal.d.ts"
+      ],
+      "errors": [
+        "./dist/errors.d.ts"
+      ],
+      "returns": [
+        "./dist/returns.d.ts"
+      ],
+      "catalog": [
+        "./dist/catalog.d.ts"
+      ],
+      "course": [
+        "./dist/course.d.ts"
+      ]
     }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test:returns-ssr": "pnpm build && node --test test/returns-widget.ssr.test.cjs",
+    "test:catalog-ssr": "pnpm build && node --test test/catalog.ssr.test.cjs",
+    "test:course-ssr": "pnpm build && node --test test/course.ssr.test.cjs",
+    "build:publish": "pnpm build --env.publish",
+    "clean": "rimraf ./dist",
+    "dev": "tsup --watch",
+    "dev:publish": "pnpm dev --env.publish",
+    "test": "tsup src/components/checkout/appearance.test.ts src/components/checkout/texts.test.ts src/lib/appearance-core.test.ts src/lib/texts.test.ts src/components/returns/appearance.test.ts src/components/returns/texts.test.ts src/components/returns/errors.test.ts src/components/returns/money.test.ts src/components/returns/session-storage.test.ts src/components/returns/state-machine.test.ts src/components/returns/selection.test.ts src/components/returns/legacy.test.ts src/panel/returns-appearance.test.ts src/components/products/appearance.test.ts src/components/products/texts.test.ts src/components/products/format.test.ts src/components/products/fetch.test.ts src/components/products/useProducts.test.ts src/components/products/cart-target.test.ts src/components/checkout/cart-items.test.ts src/course/logic.test.ts src/course/accent.test.ts src/course/texts.test.ts src/course/datasource.test.ts src/course/sanitize.test.ts src/course/VideoPlayer.test.tsx src/course/PanelCourse.test.tsx --format esm --out-dir .test-dist --no-config --external jsdom --silent && node --test \".test-dist/**/*.test.mjs\"",
+    "test:types": "tsc -p test/consumer/tsconfig.json",
+    "test:package": "node test/consumer/verify-package.mjs"
   }
-}
+}

package/dist/CartProvider-F2VH7WFO.mjs

@@ -1,2 +0,0 @@
-import{L as c,M as d,N as e,O as f,P as g,Q as h,R as i}from"./chunk-RATFYRKZ.mjs";import"./chunk-4HOZFM6V.mjs";import{k as a,l as b}from"./chunk-3TENJTY4.mjs";import"./chunk-U6FLIRIV.mjs";export{c as MARKETING_AGREEMENT_ID,d as bitsnapProjectID,h as default,i as getCheckoutMethods,b as getLocale,f as getProjectID,a as setLocale,e as setProjectID,g as useCartProvider};
-//# sourceMappingURL=CartProvider-F2VH7WFO.mjs.map

package/dist/chunk-3TENJTY4.mjs

@@ -1,2 +0,0 @@
-var u="https://bitsnap.pl",d=u;function h(t){console.log("setCustomHost",t),d=t}function x(t,e){return e.toLowerCase().startsWith("en")?t.en:t.pl}function g(t,e){let n={...t};if(e!=null)for(let[r,o]of Object.entries(e))o!=null&&(n[r]=o);return n}function c(t,e,n){return g(x(t,e),n)}function T(t,e){return t[e]??e}var y={en:{cart:"Cart",emptyCart:"Your cart is empty.",total:"Total:",delivery:"+ delivery",chooseCountry:"Choose a country",nextStep:"Next step",unavailableProducts:"Not all products are available."},pl:{cart:"Koszyk",emptyCart:"Brak produkt\xF3w w koszyku.",total:"Suma:",delivery:"+ dostawa",chooseCountry:"Wybierz kraj",nextStep:"Nast\u0119pny krok",unavailableProducts:"Nie wszystkie produkty s\u0105 dost\u0119pne w magazynie."}};function k(t,e){return c(y,t,e)}function R(t,e,n){return T(k(e,n),t)}var i="pl-PL",p="bitsnap-locale",a;function L(t){let e=t?.trim();a=e?e.toLowerCase()==="en"?"en-US":e.toLowerCase()==="pl"?i:e:void 0,typeof localStorage<"u"&&(a==null?localStorage.removeItem(p):localStorage.setItem(p,a))}function E(){return a??(typeof localStorage<"u"?localStorage.getItem(p)??i:i)}import{clsx as m}from"clsx";import{twMerge as f}from"tailwind-merge";function z(...t){return f(m(t))}function S(t){let e={};for(let[n,r]of Object.entries(t))r!=null&&(e[n]=r);return e}function b(t){return Object.values(t).some(e=>e!=null&&(e.className!=null||e.style!=null))}function C(t,e,n){let r={};for(let[o,l]of Object.entries(e)){let s=t[o];s!=null&&(r[l]=s)}for(let{token:o,variable:l}of n){let s=t[o];s!=null&&(r[l]=s)}return r}function H(t,e){let n=t?.theme??e.defaultTheme,r=S({...e.presets[n],...t?.tokens}),o=t?.elements??{};return{theme:n,isCustomized:t?.theme!=null||Object.keys(r).length>0||b(o),tokens:r,elements:o,boundaryStyle:C(r,e.variables,e.shadcnVariables)}}function N(t,e){return t[e]}export{z as a,u as b,d as c,h as d,H as e,N as f,x as g,c as h,R as i,i as j,L as k,E as l};
-//# sourceMappingURL=chunk-3TENJTY4.mjs.map

package/dist/chunk-3TENJTY4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/checkout/constants.ts","../src/lib/texts.ts","../src/components/checkout/texts.ts","../src/components/checkout/locale.ts","../src/lib/utils.ts","../src/lib/appearance-core.ts"],"sourcesContent":["export const DEFAULT_HOST = \"https://bitsnap.pl\";\nexport let HOST = DEFAULT_HOST;\n\nexport function setCustomHost(host: string) {\n  console.log(\"setCustomHost\", host);\n  HOST = host;\n}\n","/**\n * Shared text machinery: typed string tables per locale, the locale fallback\n * and a merge with caller overrides. Each module (checkout, later returns)\n * supplies its own key type and default tables.\n */\n\n/** Strings of one locale, keyed by text key. */\nexport type TextTable<Key extends string> = Record<Key, string>;\n\n/** Default tables for the supported locales. */\nexport type LocaleTables<Key extends string> = {\n  en: TextTable<Key>;\n  pl: TextTable<Key>;\n};\n\n/**\n * Picks the table for a locale. Any locale starting with `en` (case\n * insensitive, so `en`, `en-US`, `EN-gb`) gets English; everything else,\n * including unknown locales, gets the Polish default.\n */\nexport function pickLocaleTable<Key extends string>(\n  tables: LocaleTables<Key>,\n  locale: string,\n): TextTable<Key> {\n  return locale.toLowerCase().startsWith(\"en\") ? tables.en : tables.pl;\n}\n\n/**\n * Merges caller overrides over a table. Overrides apply regardless of the\n * locale; `undefined`/`null` entries are ignored so the default stays.\n */\nexport function mergeTexts<Key extends string>(\n  table: TextTable<Key>,\n  overrides?: Partial<TextTable<Key>>,\n): TextTable<Key> {\n  const result: Record<string, string> = { ...table };\n\n  if (overrides != null) {\n    for (const [key, value] of Object.entries<string | undefined>(overrides)) {\n      if (value != null) {\n        result[key] = value;\n      }\n    }\n  }\n\n  return result as TextTable<Key>;\n}\n\n/** Locale table merged with the caller overrides. */\nexport function resolveTexts<Key extends string>(\n  tables: LocaleTables<Key>,\n  locale: string,\n  overrides?: Partial<TextTable<Key>>,\n): TextTable<Key> {\n  return mergeTexts(pickLocaleTable(tables, locale), overrides);\n}\n\n/** Looks up a single text. Unknown keys return the key itself. */\nexport function lookupText<Key extends string>(\n  texts: TextTable<Key>,\n  key: Key,\n): string {\n  return (texts as Record<string, string | undefined>)[key] ?? key;\n}\n","import {\n  lookupText,\n  resolveTexts,\n  type LocaleTables,\n} from \"@/src/lib/texts\";\n\n/**\n * Every string the checkout renders. Pass a partial object through the\n * `texts` prop of `BitsnapCheckout` to override any of them, whatever the\n * locale.\n */\nexport type CheckoutTexts = {\n  /** Drawer title. */\n  cart: string;\n  /** Shown when the cart has no products. */\n  emptyCart: string;\n  /** Label next to the total price. */\n  total: string;\n  /** Delivery note next to the total price. */\n  delivery: string;\n  /** Country selector placeholder. */\n  chooseCountry: string;\n  /** Checkout button label. */\n  nextStep: string;\n  /** Error shown when some products are out of stock. */\n  unavailableProducts: string;\n};\n\nexport type CheckoutTextKey = keyof CheckoutTexts;\n\nexport const CHECKOUT_TEXT_TABLES: LocaleTables<CheckoutTextKey> = {\n  en: {\n    cart: \"Cart\",\n    emptyCart: \"Your cart is empty.\",\n    total: \"Total:\",\n    delivery: \"+ delivery\",\n    chooseCountry: \"Choose a country\",\n    nextStep: \"Next step\",\n    unavailableProducts: \"Not all products are available.\",\n  },\n  pl: {\n    cart: \"Koszyk\",\n    emptyCart: \"Brak produktów w koszyku.\",\n    total: \"Suma:\",\n    delivery: \"+ dostawa\",\n    chooseCountry: \"Wybierz kraj\",\n    nextStep: \"Następny krok\",\n    unavailableProducts: \"Nie wszystkie produkty są dostępne w magazynie.\",\n  },\n};\n\n/** Default texts for a locale merged with the caller overrides. */\nexport function resolveCheckoutTexts(\n  locale: string,\n  overrides?: Partial<CheckoutTexts>,\n): CheckoutTexts {\n  return resolveTexts(CHECKOUT_TEXT_TABLES, locale, overrides);\n}\n\nexport function getCheckoutText(\n  key: CheckoutTextKey,\n  locale: string,\n  overrides?: Partial<CheckoutTexts>,\n): string {\n  return lookupText(resolveCheckoutTexts(locale, overrides), key);\n}\n","import { pickLocaleTable } from \"@/src/lib/texts\";\nimport { CHECKOUT_TEXT_TABLES } from \"./texts\";\n\nexport const DEFAULT_LOCALE = \"pl-PL\" as const;\nconst localeStorageKey = \"bitsnap-locale\";\n\nlet activeLocale: string | undefined;\n\nexport function setLocale(locale?: string): void {\n  const value = locale?.trim();\n  activeLocale = value\n    ? value.toLowerCase() === \"en\"\n      ? \"en-US\"\n      : value.toLowerCase() === \"pl\"\n        ? DEFAULT_LOCALE\n        : value\n    : undefined;\n  if (typeof localStorage !== \"undefined\") {\n    if (activeLocale == null) {\n      localStorage.removeItem(localeStorageKey);\n    } else {\n      localStorage.setItem(localeStorageKey, activeLocale);\n    }\n  }\n}\n\nexport function getLocale(): string {\n  if (activeLocale != null) {\n    return activeLocale;\n  }\n  if (typeof localStorage !== \"undefined\") {\n    return localStorage.getItem(localeStorageKey) ?? DEFAULT_LOCALE;\n  }\n  return DEFAULT_LOCALE;\n}\n\nexport function translate(key: string, locale: string = getLocale()): string {\n  return (\n    (pickLocaleTable(CHECKOUT_TEXT_TABLES, locale) as Record<string, string>)[\n      key\n    ] ?? key\n  );\n}\n","import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\nexport type Modify<T, R> = Omit<T, keyof R> & R;\n\nexport type Partial<T> = {\n  [P in keyof T]?: T[P];\n};\n","import type { CSSProperties } from \"react\";\n\n/**\n * Generic building blocks shared by the appearance modules (checkout, and\n * later returns). Each module supplies its own token to CSS variable map, theme\n * presets and shadcn mapping, and keeps its own public types. Everything here\n * is pure so it can be tested without a DOM.\n */\n\n/** Caller overrides for a single slot. */\nexport type SlotAppearance = {\n  /** Merged after the built-in classes with `cn`, so Tailwind conflicts resolve. */\n  className?: string;\n  /** Merged after the built-in inline styles. */\n  style?: CSSProperties;\n};\n\n/** Typed partial map of slot name to its overrides. */\nexport type AppearanceElements<Slot extends string> = Partial<\n  Record<Slot, SlotAppearance>\n>;\n\n/** CSS custom property used for each token. */\nexport type TokenVariables<Token extends string> = Readonly<\n  Record<Token, string>\n>;\n\n/**\n * Remaps a token onto a shadcn theme variable (`--background`, `--ring`, ...)\n * so shared UI primitives follow the module's tokens. Only written when the\n * token is in effect.\n */\nexport type ShadcnVariableMapping<Token extends string> = readonly {\n  token: Token;\n  variable: string;\n}[];\n\nexport type AppearanceCoreConfig<Token extends string, Theme extends string> = {\n  /** Theme used when the caller does not select one. */\n  defaultTheme: Theme;\n  /** Partial token sets applied underneath the caller tokens. */\n  presets: Record<Theme, Partial<Record<Token, string>>>;\n  variables: TokenVariables<Token>;\n  shadcnVariables: ShadcnVariableMapping<Token>;\n};\n\nexport type ResolvedAppearanceCore<\n  Token extends string,\n  Theme extends string,\n  Slot extends string,\n> = {\n  theme: Theme;\n  /** `true` as soon as the caller passed a theme, a token or a slot override. */\n  isCustomized: boolean;\n  /** Tokens that are in effect. Empty entries were dropped. */\n  tokens: Partial<Record<Token, string>>;\n  elements: AppearanceElements<Slot>;\n  /** Inline custom properties for the theme boundary. */\n  boundaryStyle: CSSProperties;\n};\n\n/** Drops `undefined`/`null` tokens so unset values keep the stylesheet default. */\nexport function omitUndefined<Token extends string>(\n  tokens: Partial<Record<Token, string>>,\n): Partial<Record<Token, string>> {\n  const result: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(tokens)) {\n    if (value != null) {\n      result[key] = value;\n    }\n  }\n\n  return result as Partial<Record<Token, string>>;\n}\n\nexport function hasAnyElement<Slot extends string>(\n  elements: AppearanceElements<Slot>,\n): boolean {\n  return Object.values<SlotAppearance | undefined>(elements).some(\n    (element) =>\n      element != null && (element.className != null || element.style != null),\n  );\n}\n\n/**\n * Token to CSS variable resolution, followed by the shadcn remapping. Only\n * tokens that are in effect produce a variable.\n */\nexport function resolveBoundaryStyle<Token extends string>(\n  tokens: Partial<Record<Token, string>>,\n  variables: TokenVariables<Token>,\n  shadcnVariables: ShadcnVariableMapping<Token>,\n): CSSProperties {\n  const style: Record<string, string> = {};\n\n  for (const [token, variable] of Object.entries<string>(variables)) {\n    const value = tokens[token as Token];\n    if (value != null) {\n      style[variable] = value;\n    }\n  }\n\n  for (const { token, variable } of shadcnVariables) {\n    const value = tokens[token];\n    if (value != null) {\n      style[variable] = value;\n    }\n  }\n\n  return style as CSSProperties;\n}\n\n/**\n * Resolves theme, tokens, slot overrides and the boundary style. The resolver\n * never invents values: a token is only present when the caller provided it or\n * selected a theme preset that carries it.\n */\nexport function resolveAppearanceCore<\n  Token extends string,\n  Theme extends string,\n  Slot extends string,\n>(\n  appearance:\n    | {\n        theme?: Theme;\n        tokens?: Partial<Record<Token, string>>;\n        elements?: AppearanceElements<Slot>;\n      }\n    | undefined,\n  config: AppearanceCoreConfig<Token, Theme>,\n): ResolvedAppearanceCore<Token, Theme, Slot> {\n  const theme: Theme = appearance?.theme ?? config.defaultTheme;\n\n  const tokens = omitUndefined<Token>({\n    ...config.presets[theme],\n    ...appearance?.tokens,\n  });\n\n  const elements = appearance?.elements ?? {};\n\n  return {\n    theme,\n    isCustomized:\n      appearance?.theme != null ||\n      Object.keys(tokens).length > 0 ||\n      hasAnyElement(elements),\n    tokens,\n    elements,\n    boundaryStyle: resolveBoundaryStyle(\n      tokens,\n      config.variables,\n      config.shadcnVariables,\n    ),\n  };\n}\n\n/** Caller overrides for a slot, if any were provided. */\nexport function getSlotAppearance<Slot extends string>(\n  elements: AppearanceElements<Slot>,\n  slot: Slot,\n): SlotAppearance | undefined {\n  return elements[slot];\n}\n"],"mappings":"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","names":["DEFAULT_HOST","HOST","setCustomHost","host","pickLocaleTable","tables","locale","mergeTexts","table","overrides","result","key","value","resolveTexts","lookupText","texts","CHECKOUT_TEXT_TABLES","resolveCheckoutTexts","locale","overrides","resolveTexts","getCheckoutText","key","lookupText","DEFAULT_LOCALE","localeStorageKey","activeLocale","setLocale","locale","value","getLocale","clsx","twMerge","cn","inputs","omitUndefined","tokens","result","key","value","hasAnyElement","elements","element","resolveBoundaryStyle","variables","shadcnVariables","style","token","variable","resolveAppearanceCore","appearance","config","theme","getSlotAppearance","slot"]}