@owlmeans/web-payment 0.1.18-rc.20 → 0.1.18-rc.21

package/build/i18n.js.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErD,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA;AACnC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,CAAC,CAAA"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACrD,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAA;AAEjD,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA;AAC1C,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,EAAE,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,9 +1,11 @@
 import './i18n.js';
+export { WEB_PAYMENT_RESOURCE } from './i18n.js';
 export type * from './types.js';
 export * from './service.js';
 export * from './hooks.js';
 export * from './amount.js';
 export * from './dialog.js';
+export * from './checkout-limit.js';
 export * from './estimate.js';
 export * from './estimate-summary.js';
 export * from './selectors.js';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAA;AAClB,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAChD,mBAAmB,YAAY,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}

package/build/index.js

@@ -1,8 +1,10 @@
 import './i18n.js';
+export { WEB_PAYMENT_RESOURCE } from './i18n.js';
 export * from './service.js';
 export * from './hooks.js';
 export * from './amount.js';
 export * from './dialog.js';
+export * from './checkout-limit.js';
 export * from './estimate.js';
 export * from './estimate-summary.js';
 export * from './selectors.js';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAA;AAElB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAEhD,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}

package/build/types.d.ts

@@ -1,16 +1,25 @@
 import type { ReactNode } from 'react';
 import type { CallOptions, RequestShape } from '@owlmeans/entrypoint';
-import type { AmountCheckoutPolicy, CapabilityView, CreateCheckoutResponse, EntitlementPlanView, LimitView, PortalLinkBody, PriceEstimate, PriceEstimateBody } from '@owlmeans/payment';
+import type { AmountCheckoutPolicy, CapabilityView, CheckoutLimitView, CreateCheckoutResponse, EntitlementPlanView, LimitView, PortalLinkBody, PriceEstimate, PriceEstimateBody } from '@owlmeans/payment';
 export type CheckoutResult = CreateCheckoutResponse;
 export interface AmountCheckoutDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
+    /** The plan's policy — or one already narrowed for the entity (`AmountPolicyView.policy`). */
     policy: AmountCheckoutPolicy;
     pending?: boolean;
     /** Chosen amount and, where tax estimation collected it, the billing country. */
     onConfirm: (amountMinor: number, country?: string) => Promise<void> | void;
     /** A live tax/currency estimate for the credit line — absent: the plain "tax at checkout" note. */
     estimate?: PriceEstimateControl;
+    /**
+     * What the entity may buy now (`AmountPolicyView.limit`). The dialog narrows `policy` with it
+     * through `narrowAmountPolicy` — presets above the maximum disappear, the default is clamped —
+     * shows a `CheckoutLimitNote`, and on `blocked` disables the input and the confirm button.
+     */
+    limit?: CheckoutLimitView | null;
+    /** Legal text the application places right above the buttons (a withdrawal note, terms links). */
+    legalNote?: ReactNode;
 }
 /** What `usePriceEstimate` returns: the latest answer, the chosen country, and its lifecycle. */
 export interface PriceEstimateControl {
@@ -21,8 +30,20 @@ export interface PriceEstimateControl {
     loading: boolean;
     /** The last request failed; `estimate` is the previous good answer, if any. */
     failed: boolean;
+    /**
+     * The country is the entity's locked billing country (an answer with `locked` or `source:
+     * 'profile'`): a picker shows it disabled, and `onCountryChange` does nothing.
+     */
+    locked?: boolean;
     onCountryChange: (country: string) => void;
 }
+export interface CheckoutLimitNoteProps {
+    /** `null`, or a limit that narrowed nothing, renders nothing. */
+    limit: CheckoutLimitView | null | undefined;
+    /** Replaces the package's sentence for the limit's `reason` (`per-purchase`, `window`, `hold`). */
+    reasonLabel?: string | ((reason: string) => string | null | undefined);
+    className?: string;
+}
 /** The request of a price-estimate protocol: its body is a `PriceEstimateBody`. */
 export type PriceEstimateRequest = RequestShape & {
     body: PriceEstimateBody;

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EACV,oBAAoB,EAAE,cAAc,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,SAAS,EAC/G,cAAc,EAAE,aAAa,EAAE,iBAAiB,EACjD,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAA;AACnD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,8FAA8F;IAC9F,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iFAAiF;IACjF,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC1E,mGAAmG;IACnG,QAAQ,CAAC,EAAE,oBAAoB,CAAA;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAChC,kGAAkG;IAClG,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,iGAAiG;AACjG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAA;IAC3C,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAE7E,KAAK,iBAAiB,CAAC,OAAO,SAAS,oBAAoB,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IACrF,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAA;CACxC,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,sBAAsB,CAAC,OAAO,SAAS,oBAAoB,IAAI,EAAE,SAAS,iBAAiB,CAAC,OAAO,CAAC,GAC5G,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,GACpD,CAAC,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAA;AAEvD,kDAAkD;AAClD,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,uFAAuF;IACvF,SAAS,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GACxD,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,kBAAkB,GAClE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhC,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;AAEvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAA;IACxB,IAAI,EAAE,cAAc,CAAA;IACpB,iFAAiF;IACjF,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAAA;AAEvE,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAA;AAEnE,KAAK,UAAU,CAAC,OAAO,SAAS,aAAa,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG;IACvE,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;CACrC,CAAA;AAED,+EAA+E;AAC/E,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,aAAa,IAAI,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,GACvF,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,GAC7C,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAA;AAEhD,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,IAAI,EAAE,mBAAmB,CAAA;IACzB,iGAAiG;IACjG,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,cAAc,EAAE,CAAA;IAC9B,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-payment",
-  "version": "0.1.18-rc.20",
+  "version": "0.1.18-rc.21",
   "license": "MIT",
   "description": "Protocol-bound payment hooks and themed amount checkout UI for OwlMeans web applications.",
   "type": "module",
@@ -20,16 +20,26 @@
       "default": "./build/index.js",
       "module": "./build/index.js",
       "types": "./build/index.d.ts"
+    },
+    "./consumer": {
+      "import": "./build/consumer/index.js",
+      "require": "./build/consumer/index.js",
+      "default": "./build/consumer/index.js",
+      "module": "./build/consumer/index.js",
+      "types": "./build/consumer/index.d.ts"
     }
   },
   "dependencies": {
-    "@owlmeans/client-i18n": "^0.1.18-rc.38",
-    "@owlmeans/client-payment": "^0.1.18-rc.45",
-    "@owlmeans/entrypoint": "^0.1.18-rc.35",
-    "@owlmeans/i18n": "^0.1.18-rc.35",
-    "@owlmeans/payment": "^0.1.18-rc.37"
+    "@owlmeans/api": "^0.1.18-rc.37",
+    "@owlmeans/client-i18n": "^0.1.18-rc.39",
+    "@owlmeans/client-payment": "^0.1.18-rc.46",
+    "@owlmeans/entrypoint": "^0.1.18-rc.36",
+    "@owlmeans/error": "^0.1.18-rc.35",
+    "@owlmeans/i18n": "^0.1.18-rc.36",
+    "@owlmeans/payment": "^0.1.18-rc.38"
   },
   "peerDependencies": {
+    "@radix-ui/react-checkbox": "*",
     "@radix-ui/react-dialog": "*",
     "@radix-ui/react-label": "*",
     "@radix-ui/react-progress": "*",
@@ -44,7 +54,8 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.37",
+    "@owlmeans/test-ui": "^0.1.18-rc.38",
+    "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-label": "^2.1.0",
     "@radix-ui/react-progress": "^1.1.0",

package/src/@/components/ui/checkbox.tsx

@@ -0,0 +1,23 @@
+import * as React from 'react'
+import * as CheckboxPrimitive from '@radix-ui/react-checkbox'
+import { cn } from '@/lib/utils'
+
+/** The shadcn checkbox, with an inline check mark instead of an icon library. */
+export const Checkbox = ({ className, ...props }: React.ComponentProps<typeof CheckboxPrimitive.Root>) =>
+  <CheckboxPrimitive.Root
+    data-slot="checkbox"
+    className={cn(
+      'peer border-input size-4 shrink-0 cursor-pointer rounded-[4px] border shadow-xs outline-none transition-shadow',
+      'data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary',
+      'focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50',
+      className,
+    )}
+    {...props}
+  >
+    <CheckboxPrimitive.Indicator data-slot="checkbox-indicator" className="flex items-center justify-center text-current">
+      <svg viewBox="0 0 24 24" aria-hidden="true" className="size-3.5" fill="none" stroke="currentColor"
+        strokeWidth={3} strokeLinecap="round" strokeLinejoin="round">
+        <path d="M20 6 9 17l-5-5" />
+      </svg>
+    </CheckboxPrimitive.Indicator>
+  </CheckboxPrimitive.Root>

package/src/checkout-limit.tsx

@@ -0,0 +1,48 @@
+import { useI18nLib, useLanguage } from '@owlmeans/client-i18n'
+import { cn } from '@/lib/utils'
+import { money, shortMomentUtc } from './format.js'
+import type { CheckoutLimitNoteProps } from './types.js'
+
+/** The reasons the package phrases itself; any other reads the generic sentence. */
+const KNOWN_REASONS = ['per-purchase', 'window', 'hold']
+
+/**
+ * What an amount checkout is narrowed to for this entity now: the largest amount (or that nothing
+ * may be bought), why, and when it rises again — the same `CheckoutLimitView` the server refuses
+ * with, so the note and a refusal never disagree.
+ *
+ * `[data-checkout-limit]` carries `data-max-minor`, `data-blocked`, `data-reason` and, when known,
+ * `data-resets-at` (ISO).
+ */
+export const CheckoutLimitNote = ({ limit, reasonLabel, className }: CheckoutLimitNoteProps) => {
+  const t = useI18nLib('web-payment', 'checkout-limit')
+  const [locale] = useLanguage()
+  if (limit == null || (!limit.narrowed && !limit.blocked)) {
+    return null
+  }
+
+  const reason = limit.reason ?? ''
+  const custom = typeof reasonLabel === 'function' ? reasonLabel(reason) : reasonLabel
+  const explained = custom != null && custom !== ''
+    ? custom
+    : t(`reason.${KNOWN_REASONS.includes(reason) ? reason : 'other'}`)
+  const resetsAt = limit.resetsAt != null ? new Date(limit.resetsAt) : null
+  const resets = resetsAt != null && !Number.isNaN(resetsAt.getTime())
+    ? t('resets', { date: shortMomentUtc(resetsAt, locale), interpolation: { escapeValue: false } })
+    : null
+
+  return <div
+    data-checkout-limit="" data-max-minor={limit.maximumMinor} data-blocked={limit.blocked ? 'true' : 'false'}
+    data-reason={reason} data-resets-at={resetsAt?.toISOString()}
+    role={limit.blocked ? 'alert' : 'note'}
+    className={cn('grid gap-1 rounded-lg border p-3 text-sm', limit.blocked ? 'border-destructive/50' : 'bg-muted/30', className)}
+  >
+    <p className={limit.blocked ? 'text-destructive font-medium' : 'font-medium'} data-checkout-limit-headline="">
+      {limit.blocked
+        ? t('blocked')
+        : t('note', { amount: money(limit.maximumMinor, limit.currency, locale), interpolation: { escapeValue: false } })}
+    </p>
+    <p className="text-muted-foreground text-xs" data-checkout-limit-reason="">{explained}</p>
+    {resets != null && <p className="text-muted-foreground text-xs" data-checkout-limit-resets="">{resets}</p>}
+  </div>
+}

package/src/consumer/cancellation.tsx

@@ -0,0 +1,214 @@
+import { useEffect, useState, type ReactNode } from 'react'
+import { CancellationKind } from '@owlmeans/payment'
+import type { CancellationBody, CancellationReceipt } from '@owlmeans/payment'
+import { cn } from '@/lib/utils'
+import { Button } from '@/components/ui/button'
+import { dayUtc, momentUtc } from '../format.js'
+import { useLegalText, usePaymentText } from './copy.js'
+import { Choice, Field, Honeypot, isEmail } from './fields.js'
+import { ErrorLine, LanguageToggle, useShownLanguage } from './legal.js'
+import type { CancellationFormProps, DeclarationStep } from './types.js'
+
+const isCancellationReceipt = (receipt: object): receipt is CancellationReceipt => 'status' in receipt
+
+/** Today as a UTC calendar day, `YYYY-MM-DD` — the earliest date a termination may name. */
+const todayUtc = (): string => new Date().toISOString().slice(0, 10)
+
+/**
+ * The cancellation function (§ 312k BGB "Verträge hier kündigen" → "Jetzt kündigen"; L215-1-1 /
+ * D215-1 "Résilier votre contrat" → a summary → "Notification de la résiliation"), for a public
+ * page reachable without a login and for the same function in-app.
+ *
+ * Step 1 asks for the kind (ordinary, or extraordinary with its reason), the name, the contract or
+ * customer reference, the date (the earliest possible, or a specific one) and the e-mail address
+ * the acknowledgement goes to; a honeypot field no person reaches rides along. Step 2 is the
+ * summary with the statutory confirm button; step 3 the receipt — date and time of receipt in UTC,
+ * the effective date when known — with a print button, so it can be kept.
+ *
+ * Selectors: `[data-cancellation-form]` / `[data-cancellation-step="form|review|receipt"]` (also
+ * `data-step`, `data-language`, `data-mode`), `[data-cancellation-field="kind|reason|name|contract|
+ * effective|date|email"]`, `[data-cancellation-continue]`, `[data-cancellation-confirm]`,
+ * `[data-cancellation-receipt]` (`data-status`, `data-declaration-id`, `data-received-at`,
+ * `data-effective-at`), `[data-cancellation-print]`.
+ */
+export const CancellationForm = ({
+  mode, language: contractLanguage, uiLanguage, defaults, pending = false, error, receipt, onSubmit, onPrint, onClose,
+  className,
+}: CancellationFormProps) => {
+  const language = useShownLanguage(contractLanguage, uiLanguage)
+  const legal = useLegalText(language.shown)
+  const text = usePaymentText(language.shown)
+
+  const [step, setStep] = useState<'form' | 'review'>('form')
+  const [kind, setKind] = useState<CancellationKind>(CancellationKind.Ordinary)
+  const [reason, setReason] = useState('')
+  const [name, setName] = useState(defaults?.name ?? '')
+  const [contractRef, setContractRef] = useState(defaults?.contractRef ?? '')
+  const [effective, setEffective] = useState<'earliest' | 'date'>('earliest')
+  const [date, setDate] = useState('')
+  const [email, setEmail] = useState(defaults?.email ?? '')
+  const [honeypot, setHoneypot] = useState('')
+  const [checked, setChecked] = useState(false)
+  const [submitted, setSubmitted] = useState<CancellationBody | null>(null)
+  useEffect(() => {
+    if (receipt == null && submitted != null) setStep('form')
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [receipt])
+
+  const current: DeclarationStep = receipt != null ? 'receipt' : step
+  const extraordinary = kind === CancellationKind.Extraordinary
+  const earliestDate = todayUtc()
+  const errors = {
+    reason: extraordinary && reason.trim() === '' ? text('consumer.required') : null,
+    name: name.trim() === '' ? text('consumer.required') : null,
+    date: effective === 'date' && (!/^\d{4}-\d{2}-\d{2}$/.test(date) || date < earliestDate) ? text('consumer.date-invalid') : null,
+    email: email.trim() === '' ? text('consumer.required') : !isEmail(email.trim()) ? text('consumer.email-invalid') : null,
+  }
+  const shown = (key: keyof typeof errors) => checked ? errors[key] : null
+  const valid = Object.values(errors).every(value => value == null)
+  const body = (): CancellationBody => ({
+    kind,
+    ...(extraordinary ? { reason: reason.trim() } : {}),
+    name: name.trim(),
+    ...(contractRef.trim() !== '' ? { contractRef: contractRef.trim() } : {}),
+    ...(defaults?.subscriptionId != null ? { subscriptionId: defaults.subscriptionId } : {}),
+    effective,
+    ...(effective === 'date' ? { date } : {}),
+    email: email.trim(),
+    language: language.shown,
+    ...(honeypot !== '' ? { honeypot } : {}),
+  })
+  const toReview = () => {
+    setChecked(true)
+    if (valid) setStep('review')
+  }
+  const confirm = async () => {
+    if (!valid || pending) return
+    const declared = body()
+    setSubmitted(declared)
+    await onSubmit(declared)
+  }
+  const print = () => {
+    if (onPrint != null) onPrint()
+    else if (typeof window !== 'undefined') window.print()
+  }
+
+  const kindLabel = (value: CancellationKind) => legal(value === CancellationKind.Extraordinary
+    ? 'cancellation.kind-extraordinary' : 'cancellation.kind-ordinary')
+  const effectiveLabel = (declared: CancellationBody) => declared.effective === 'date' && declared.date != null
+    ? dayUtc(`${declared.date}T00:00:00Z`, language.shown) : legal('cancellation.effective-earliest')
+  const summary = (declared: CancellationBody, hook?: string) =>
+    <dl className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1.5 rounded-lg border bg-muted/30 p-4 text-sm"
+      {...(hook != null ? { [hook]: '' } : {})}>
+      <dt className="text-muted-foreground">{legal('cancellation.kind')}</dt><dd data-summary="kind">{kindLabel(declared.kind)}</dd>
+      {declared.reason != null && <>
+        <dt className="text-muted-foreground">{legal('cancellation.reason')}</dt>
+        <dd data-summary="reason" className="whitespace-pre-wrap">{declared.reason}</dd>
+      </>}
+      <dt className="text-muted-foreground">{legal('cancellation.name')}</dt><dd data-summary="name">{declared.name}</dd>
+      <dt className="text-muted-foreground">{legal('cancellation.contract')}</dt><dd data-summary="contract">{declared.contractRef ?? '—'}</dd>
+      <dt className="text-muted-foreground">{legal('cancellation.effective')}</dt><dd data-summary="effective">{effectiveLabel(declared)}</dd>
+      <dt className="text-muted-foreground">{legal('cancellation.email')}</dt><dd data-summary="email">{declared.email}</dd>
+    </dl>
+
+  let content: ReactNode
+  if (current === 'receipt' && receipt != null) {
+    const receivedAt = new Date(receipt.receivedAt)
+    const declared = submitted ?? body()
+    const status = isCancellationReceipt(receipt) ? receipt.status : undefined
+    const effectiveAt = isCancellationReceipt(receipt) && receipt.effectiveAt != null ? new Date(receipt.effectiveAt) : null
+    const effectiveKnown = effectiveAt != null && !Number.isNaN(effectiveAt.getTime())
+    content = <div className="grid gap-4" data-cancellation-receipt="" data-status={status ?? 'received'}
+      data-declaration-id={receipt.declarationId}
+      data-received-at={Number.isNaN(receivedAt.getTime()) ? undefined : receivedAt.toISOString()}
+      data-effective-at={effectiveKnown ? effectiveAt.toISOString() : undefined}>
+      <h3 className="text-sm font-medium">{text('consumer.receipt')}</h3>
+      <p className="text-sm">{receipt.mailed
+        ? legal('cancellation.received', { date: momentUtc(receivedAt, language.shown), email: declared.email })
+        : `${text('consumer.received-at')}: ${momentUtc(receivedAt, language.shown)} (UTC). ${text('consumer.not-mailed')}`}</p>
+      {effectiveKnown && <p className="text-sm font-medium" data-cancellation-effective="">
+        {text('cancellation.effective-at', { date: dayUtc(effectiveAt, language.shown) })}
+      </p>}
+      <dl className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1.5 rounded-lg border p-4 text-sm">
+        <dt className="text-muted-foreground">{text('consumer.reference')}</dt>
+        <dd data-cancellation-reference="">{receipt.declarationId}</dd>
+        <dt className="text-muted-foreground">{text('consumer.received-at')}</dt>
+        <dd data-cancellation-received-at="">{momentUtc(receivedAt, language.shown)} (UTC)</dd>
+        {status != null && <>
+          <dt className="text-muted-foreground">{text('consumer.status')}</dt>
+          <dd data-cancellation-status="">{text(`cancellation.status.${status}`)}</dd>
+        </>}
+      </dl>
+      {summary(declared)}
+      <div className="flex flex-col-reverse gap-2 sm:flex-row sm:justify-end print:hidden">
+        {onClose != null && <Button type="button" variant="outline" onClick={onClose}>{text('consumer.close')}</Button>}
+        <Button type="button" variant="outline" onClick={print} data-cancellation-print="">{text('consumer.print')}</Button>
+      </div>
+    </div>
+  } else if (current === 'review') {
+    content = <div className="grid gap-4">
+      <h3 className="text-sm font-medium">{text('consumer.review')}</h3>
+      <p className="text-sm">{legal('cancellation.summary')}</p>
+      {summary(body(), 'data-cancellation-summary')}
+      <ErrorLine error={error} text={text} />
+      <div className="flex flex-col-reverse gap-2 sm:flex-row sm:justify-end">
+        <Button type="button" variant="outline" disabled={pending} onClick={() => setStep('form')}
+          data-cancellation-back="">{text('consumer.back')}</Button>
+        <Button type="button" disabled={pending || !valid} onClick={() => void confirm()} data-cancellation-confirm="">
+          {pending ? text('consumer.pending') : legal('cancellation.confirm')}
+        </Button>
+      </div>
+    </div>
+  } else {
+    content = <form className="relative grid gap-4" noValidate onSubmit={event => { event.preventDefault(); toReview() }}>
+      <fieldset className="grid gap-2">
+        <legend className="mb-1 text-sm font-medium">{legal('cancellation.kind')}</legend>
+        {[CancellationKind.Ordinary, CancellationKind.Extraordinary].map(value => <Choice
+          key={value} id={`cancellation-kind-${value}`} name="cancellation-kind" checked={kind === value}
+          onSelect={() => setKind(value)} disabled={pending} hook={{ 'data-cancellation-field': 'kind', 'data-kind': value }}
+        >{kindLabel(value)}</Choice>)}
+      </fieldset>
+      {extraordinary && <Field id="cancellation-reason" label={legal('cancellation.reason')} value={reason} onChange={setReason}
+        error={shown('reason')} disabled={pending} multiline hook={{ 'data-cancellation-field': 'reason' }} />}
+      <Field id="cancellation-name" label={legal('cancellation.name')} value={name} onChange={setName} error={shown('name')}
+        autoComplete="name" disabled={pending} hook={{ 'data-cancellation-field': 'name' }} />
+      <Field id="cancellation-contract" label={legal('cancellation.contract')} value={contractRef} onChange={setContractRef}
+        disabled={pending} hook={{ 'data-cancellation-field': 'contract' }} />
+      <fieldset className="grid gap-2">
+        <legend className="mb-1 text-sm font-medium">{legal('cancellation.effective')}</legend>
+        <Choice id="cancellation-effective-earliest" name="cancellation-effective" checked={effective === 'earliest'}
+          onSelect={() => setEffective('earliest')} disabled={pending}
+          hook={{ 'data-cancellation-field': 'effective', 'data-effective': 'earliest' }}>
+          {legal('cancellation.effective-earliest')}
+        </Choice>
+        <Choice id="cancellation-effective-date" name="cancellation-effective" checked={effective === 'date'}
+          onSelect={() => setEffective('date')} disabled={pending}
+          hook={{ 'data-cancellation-field': 'effective', 'data-effective': 'date' }}>
+          {legal('cancellation.effective-date')}
+        </Choice>
+        {effective === 'date' && <Field id="cancellation-date" type="date" label={legal('cancellation.effective-date')}
+          value={date} onChange={setDate} min={earliestDate} error={shown('date')} disabled={pending}
+          hook={{ 'data-cancellation-field': 'date' }} />}
+      </fieldset>
+      <Field id="cancellation-email" type="email" label={legal('cancellation.email')} value={email} onChange={setEmail}
+        error={shown('email')} autoComplete="email" disabled={pending} hook={{ 'data-cancellation-field': 'email' }} />
+      <Honeypot id="cancellation-website" label={text('consumer.website')} value={honeypot} onChange={setHoneypot} />
+      <ErrorLine error={error} text={text} />
+      <div className="flex justify-end">
+        <Button type="submit" disabled={pending} data-cancellation-continue="">{text('consumer.continue')}</Button>
+      </div>
+    </form>
+  }
+
+  return <section className={cn('grid gap-4', className)} data-cancellation-section="" data-language={language.shown}>
+    <header className="grid gap-1.5" lang={language.shown}>
+      <h2 className="text-lg font-semibold leading-none">{legal('cancellation.title')}</h2>
+      {current === 'form' && <p className="text-muted-foreground text-sm">{legal('cancellation.intro')}</p>}
+    </header>
+    <LanguageToggle language={language} hook="data-cancellation-language-toggle" />
+    <div data-cancellation-form="" data-cancellation-step={current} data-step={current} data-mode={mode}
+      data-language={language.shown} lang={language.shown} className="grid gap-4">
+      {content}
+    </div>
+  </section>
+}

package/src/consumer/copy.ts

@@ -0,0 +1,93 @@
+import { useMemo } from 'react'
+import { LIB_NAMESPACE, resolveI18nResource } from '@owlmeans/i18n'
+import { baseLanguageOf, consumerText } from '@owlmeans/payment'
+import type { CopyValues } from '@owlmeans/payment'
+import { WEB_PAYMENT_RESOURCE } from '../i18n.js'
+
+interface Tree {
+  [key: string]: string | Tree
+}
+
+const isTree = (value: unknown): value is Tree =>
+  value != null && typeof value === 'object' && !Array.isArray(value)
+
+const merge = (base: Tree, over: Record<string, unknown> | null): Tree => {
+  const result: Tree = { ...base }
+  for (const [key, value] of Object.entries(over ?? {})) {
+    if (isTree(value)) {
+      const current = result[key]
+      result[key] = merge(isTree(current) ? current : {}, value)
+    } else if (typeof value === 'string') {
+      result[key] = value
+    }
+  }
+
+  return result
+}
+
+const bundleOf = (lng: string): Tree => {
+  const base = baseLanguageOf(lng)
+  let tree = merge({}, resolveI18nResource('en', WEB_PAYMENT_RESOURCE, LIB_NAMESPACE))
+  if (base !== '' && base !== 'en') {
+    tree = merge(tree, resolveI18nResource(base, WEB_PAYMENT_RESOURCE, LIB_NAMESPACE))
+  }
+  if (lng !== base && lng.trim() !== '') {
+    tree = merge(tree, resolveI18nResource(lng, WEB_PAYMENT_RESOURCE, LIB_NAMESPACE))
+  }
+
+  return tree
+}
+
+const fill = (text: string, values: CopyValues = {}): string =>
+  text.replace(/\{\{\s*([\w-]+)\s*\}\}/g, (_, name: string) => values[name] != null ? String(values[name]) : '')
+
+/** A translator bound to ONE language, whatever the active i18n language is. */
+export type FixedText = (key: string, values?: CopyValues) => string
+
+/**
+ * The package's own interface strings (`web-payment`, library tier, any application override
+ * included) in a FIXED language, merged key by key over English — no i18next instance and no
+ * draining (`resolveI18nResource`). What lets a consumer-rights dialog render wholly in the
+ * contract language while the rest of the page stays in the interface language.
+ */
+export const paymentTextOf = (lng: string): FixedText => {
+  const tree = bundleOf(lng)
+
+  return (key, values) => {
+    const value = key.split('.').reduce<unknown>((node, part) => isTree(node) ? node[part] : undefined, tree)
+
+    return typeof value === 'string' ? fill(value, values) : key
+  }
+}
+
+/**
+ * The legal copy of `@owlmeans/payment` (`payment-consumer-rights`) in a fixed language. A text
+ * that cannot be rendered in the language (a broken application override) falls back to English
+ * rather than blanking the page; one that cannot be rendered at all is `''`.
+ */
+export const legalTextOf = (lng: string): FixedText => (path, values) => {
+  try {
+    return consumerText(lng, path, values)
+  } catch {
+    try {
+      return consumerText('en', path, values)
+    } catch {
+      return ''
+    }
+  }
+}
+
+/** `paymentTextOf(lng)`, memoised for the language. */
+export const usePaymentText = (lng: string): FixedText => useMemo(() => paymentTextOf(lng), [lng])
+
+/** `legalTextOf(lng)`, memoised for the language. */
+export const useLegalText = (lng: string): FixedText => useMemo(() => legalTextOf(lng), [lng])
+
+/** A language's own name in another language (`de` in `en` → "German"); the code when unknown. */
+export const languageNameOf = (lng: string, inLanguage: string): string => {
+  try {
+    return new Intl.DisplayNames([inLanguage], { type: 'language' }).of(lng) ?? lng
+  } catch {
+    return lng
+  }
+}