@openreceive/elements 0.3.0 → 0.3.1

package/dist/{chunk-SJEIQZYE.js → chunk-MKA6MJU5.js}

@@ -119,18 +119,20 @@ function createElementCheckoutSession(host) {
       });
     },
     onSnapshot: publishSnapshot,
-    swapPrefix: () => host.resolvePollPrefix(currentReference()),
-    fetch: () => globalThis.fetch,
-    swapSelection: host.swapSelection,
-    // A swap attempt is NOT written back as attributes: a bolt11 attribute
-    // would take the element out of create mode. It re-keys the poll
-    // controller onto the merged snapshot and nothing else.
-    onSwapStarted: (invoice) => {
-      const reference = currentReference();
-      if (reference === void 0) return;
-      const previous = host.latestCheckoutSnapshot() ?? host.currentCheckoutSnapshot();
-      host.handleControllerSnapshot(mergeAttemptIntoCheckout(invoice, previous, reference));
-      host.startCheckoutController();
+    swap: {
+      selection: host.swapSelection,
+      prefix: () => host.resolvePollPrefix(currentReference()),
+      fetch: () => globalThis.fetch,
+      // A swap attempt is NOT written back as attributes: a bolt11 attribute
+      // would take the element out of create mode. It re-keys the poll
+      // controller onto the merged snapshot and nothing else.
+      onStarted: (invoice) => {
+        const reference = currentReference();
+        if (reference === void 0) return;
+        const previous = host.latestCheckoutSnapshot() ?? host.currentCheckoutSnapshot();
+        host.handleControllerSnapshot(mergeAttemptIntoCheckout(invoice, previous, reference));
+        host.startCheckoutController();
+      }
     },
     logger: host.logger,
     onError: (error) => host.dispatchError(error),
@@ -626,7 +628,9 @@ function elementsSwapLimitMessage(option, view) {
   return swapOptionLimitMessage(option, elementsSwapLimitContext(view));
 }
 function renderElementSwapPanelHtml(invoice, view = {}) {
-  const display = createSwapDisplayModel(invoice);
+  const display = createSwapDisplayModel(invoice, {
+    ...view.resumable === void 0 ? {} : { resumable: view.resumable }
+  });
   if (display === void 0) return "";
   const backButton = `
     <button part="swap-back" class="${orClasses4.swapBack}" ${OPENRECEIVE_PAYMENT_WIZARD_ATTRIBUTES4.swapBack} type="button">${escapeHtml4(checkoutLabels4.payWithLightningInstead)}</button>
@@ -784,7 +788,7 @@ function renderElementSwapPanelHtml(invoice, view = {}) {
           </form>
         `}
         ${supportDetails}
-        ${renderElementSwapRefundReturnWarningHtml()}
+        ${renderElementSwapRefundReturnWarningHtml(display)}
       </section>
     `;
   }
@@ -799,7 +803,7 @@ function renderElementSwapPanelHtml(invoice, view = {}) {
           ${display.refundTxId === void 0 ? "" : renderElementSwapCopyDetailHtml("Refund transaction", display.refundTxId, { kind: "tx", payInAsset: display.payInAsset })}
         </dl>
         ${supportDetails}
-        ${renderElementSwapRefundReturnWarningHtml()}
+        ${renderElementSwapRefundReturnWarningHtml(display)}
       </section>
     `;
   }
@@ -812,9 +816,9 @@ function renderElementSwapPanelHtml(invoice, view = {}) {
     </section>
   `;
 }
-function renderElementSwapRefundReturnWarningHtml() {
+function renderElementSwapRefundReturnWarningHtml(display) {
   return `
-    <p part="swap-refund-return" class="${orClasses4.swapWarning}">${escapeHtml4(checkoutLabels4.refundReturnWarning)}</p>
+    <p part="swap-refund-return" class="${orClasses4.swapWarning}">${escapeHtml4(display.refundReturnLabel)}</p>
   `;
 }
 function renderElementSwapRefundFactsHtml(display) {
@@ -1080,7 +1084,7 @@ function renderElementCompactPaymentSelectorHtml(swapAssetOptions, view) {
   const display = createMethodGridDisplay({
     entries: buildMethodGridEntries(paymentMethods, swapAssetOptions),
     selectedPickerKey: view.selectedPickerKey ?? null,
-    selectedNetworks: view.selectedSwapNetworks ?? {},
+    selectedAssetByGroup: view.selectedSwapAssetByGroup ?? {},
     startingAsset: wizardStartingAsset(view) ?? null,
     ...limitContext === void 0 ? {} : { checkout: limitContext }
   });
@@ -1492,7 +1496,7 @@ function defineElements(options = {}) {
     activeTutorialCopied = false;
     swapOptions = [];
     swapOptionsLoaded = false;
-    selectedSwapNetworks = {};
+    selectedSwapAssetByGroup = {};
     selectedPickerKey = null;
     selectedSwapAsset = null;
     startedSwapInvoice;
@@ -1576,6 +1580,7 @@ function defineElements(options = {}) {
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.syncUrl,
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumePathPrefix,
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.routeReference,
+        OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumable,
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.polling,
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.pollIntervalMs,
         OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.decodeLinkUrl,
@@ -1594,7 +1599,7 @@ function defineElements(options = {}) {
     attributeChangedCallback(name, oldValue, newValue) {
       if (!this.isConnected || this.session.applyingOwnAttributes) return;
       if (oldValue === newValue) return;
-      const displayOnly = name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.theme || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.syncUrl || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumePathPrefix || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.routeReference || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.decodeLinkUrl || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.assetBaseUrl;
+      const displayOnly = name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.theme || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.syncUrl || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumePathPrefix || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.routeReference || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumable || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.decodeLinkUrl || name === OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.assetBaseUrl;
       if (displayOnly) {
         this.render();
         this.syncThemeAncestorObserver();
@@ -1686,11 +1691,29 @@ function defineElements(options = {}) {
       }
       return parsed;
     }
+    /**
+     * Whether a payer who closes this tab has a URL to come back to. Only
+     * `sync-url` puts one there — the refund screen's copy has to say the true
+     * thing either way, so this is read rather than assumed.
+     */
+    isResumable() {
+      const declared = parseBooleanAttribute(
+        this.getAttribute(OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumable)
+      );
+      if (declared !== void 0) return declared;
+      const routeReference = this.getAttribute(
+        OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.routeReference
+      );
+      if (routeReference !== null && routeReference.length > 0) return true;
+      return parseBooleanAttribute(
+        this.getAttribute(OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.syncUrl)
+      ) === true;
+    }
     /** Order data belongs to the host; this only performs optional History API sync. */
     syncResumePath(reference) {
       const syncUrl = parseBooleanAttribute(
         this.getAttribute(OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.syncUrl)
-      );
+      ) === true;
       if (syncUrl) {
         const resumePathPrefix = this.getAttribute(OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.resumePathPrefix) ?? "/checkout";
         const routeReference = this.getAttribute(OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES3.routeReference) ?? void 0;
@@ -1778,10 +1801,11 @@ function defineElements(options = {}) {
           selectedBitcoinRoute: this.selection.selectedBitcoinRoute,
           swapOptions: this.swapOptions,
           currenciesLoading: !this.swapOptionsLoaded,
-          selectedSwapNetworks: this.selectedSwapNetworks,
+          selectedSwapAssetByGroup: this.selectedSwapAssetByGroup,
           selectedPickerKey: this.selectedPickerKey,
           startingSwapAsset: this.session.startingSwapAsset,
           selectedSwapAsset: this.selectedSwapAsset,
+          resumable: this.isResumable(),
           ...this.latestCheckoutSnapshot?.amount_msats === void 0 ? {} : { amountMsats: this.latestCheckoutSnapshot.amount_msats },
           ...this.latestCheckoutSnapshot?.fiat === void 0 ? {} : { fiat: this.latestCheckoutSnapshot.fiat },
           ...this.latestCheckoutSnapshot?.reference === void 0 ? {} : { reference: this.latestCheckoutSnapshot.reference },
@@ -1975,7 +1999,7 @@ function defineElements(options = {}) {
       }
       const swapInvoice = this.currentSwapInvoice();
       if (swapInvoice !== void 0) {
-        const display = createSwapDisplayModel2(swapInvoice, {});
+        const display = createSwapDisplayModel2(swapInvoice, { resumable: this.isResumable() });
         const swapCountdown = root.querySelector('[part="swap-countdown"]');
         if (swapCountdown !== null && display !== void 0) {
           swapCountdown.textContent = display.countdownLabel;
@@ -2014,7 +2038,7 @@ function defineElements(options = {}) {
             pickerKey: key,
             previousKey: this.selectedPickerKey,
             entries: buildMethodGridEntries2(paymentMethods2, this.swapOptions),
-            selectedNetworks: this.selectedSwapNetworks
+            selectedAssetByGroup: this.selectedSwapAssetByGroup
           });
           if (selection.kind === "none") return;
           if (selection.kind === "select_method") {
@@ -2037,7 +2061,7 @@ function defineElements(options = {}) {
             return;
           }
           this.selectedPickerKey = key;
-          this.selectedSwapNetworks = selection.selectedNetworks;
+          this.selectedSwapAssetByGroup = selection.selectedAssetByGroup;
           this.render();
         });
       });
@@ -2067,7 +2091,7 @@ function defineElements(options = {}) {
           if (target === "swap-asset") {
             this.selectedSwapAsset = null;
             this.selectedPickerKey = null;
-            this.selectedSwapNetworks = {};
+            this.selectedSwapAssetByGroup = {};
             this.render();
             return;
           }
@@ -2116,8 +2140,8 @@ function defineElements(options = {}) {
           if (groupKey === null || groupKey.length === 0 || payInAsset === null) return;
           const details = button.closest("details");
           if (details instanceof HTMLDetailsElement) details.open = false;
-          this.selectedSwapNetworks = {
-            ...this.selectedSwapNetworks,
+          this.selectedSwapAssetByGroup = {
+            ...this.selectedSwapAssetByGroup,
             [groupKey]: payInAsset
           };
           this.render();
@@ -2128,7 +2152,7 @@ function defineElements(options = {}) {
         this.dismissedSwapInvoiceId = current?.invoice_id ?? null;
         this.selectedSwapAsset = null;
         this.selectedPickerKey = null;
-        this.selectedSwapNetworks = {};
+        this.selectedSwapAssetByGroup = {};
         this.clearRefundAddressDraft();
         this.controller?.clearSwapRefundStaging();
         void this.session.ensureLightning();

package/dist/{define-elements-LL8dK1E-.d.ts → define-elements-CV0JlfbJ.d.ts}

@@ -55,13 +55,20 @@ interface ElementsWizardView {
      */
     readonly currenciesLoading?: boolean;
     /** Selected pay-in asset per multi-network coin label (e.g. USDT → USDT_TRON). */
-    readonly selectedSwapNetworks?: Readonly<Record<string, string>>;
+    readonly selectedSwapAssetByGroup?: Readonly<Record<string, string>>;
     /** Compact selector highlight: `method:bitcoin` or `swap:USDT`. */
     readonly selectedPickerKey?: string | null;
     /** Pay-in asset whose swap create is in flight — method tiles spin and disable. */
     readonly startingSwapAsset?: string | null;
     /** When set, the wizard shows the focused swap deposit flow for this pay-in asset. */
     readonly selectedSwapAsset?: string | null;
+    /**
+     * Whether this checkout has a URL the payer can return to — `sync-url` is
+     * set, or the host mounted the element on its own per-order route. Decides
+     * which of the two refund-return warnings the deposit panel shows; see
+     * {@link SwapDisplayModel.refundReturnLabel}.
+     */
+    readonly resumable?: boolean;
     /** Invoice amount + fiat, used to render fiat limit messages for out-of-range assets. */
     readonly amountMsats?: number;
     readonly fiat?: {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { TransactionDetailsSource } from '@openreceive/browser/headless';
 export { OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES, OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS, OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, OPENRECEIVE_THEME_TOGGLE_ELEMENT_ATTRIBUTES, OPENRECEIVE_THEME_TOGGLE_ELEMENT_EVENTS, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, TransactionDetailsSource, createThemeToggleElement } from '@openreceive/browser/headless';
-import { C as CheckoutView } from './define-elements-LL8dK1E-.js';
-export { D as DefineElementsOptions, E as ElementsWizardView, d as defineElements } from './define-elements-LL8dK1E-.js';
+import { C as CheckoutView } from './define-elements-CV0JlfbJ.js';
+export { D as DefineElementsOptions, E as ElementsWizardView, d as defineElements } from './define-elements-CV0JlfbJ.js';
 
 declare function renderCheckoutHtml(view: CheckoutView): string;
 /**

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   renderCheckoutHtml,
   renderThemeToggleHtml,
   renderTransactionDetailsHtml
-} from "./chunk-SJEIQZYE.js";
+} from "./chunk-MKA6MJU5.js";
 export {
   OPENRECEIVE_CHECKOUT_ELEMENT_ATTRIBUTES,
   OPENRECEIVE_CHECKOUT_ELEMENT_EVENTS,

package/dist/wrapper-shared.d.ts

@@ -1,6 +1,6 @@
 import { OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, CheckoutElementAttributes, CheckoutElementListeners, CheckoutElementAttributeOptions, CheckoutElementEventHandlers, CheckoutComponentProps, CheckoutShellOptions, ThemeModel, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, ThemeToggleElementAttributes, CheckoutSnapshot, ThemeToggleElementAttributeOptions } from '@openreceive/browser/headless';
 export { CheckoutComponentProps, CheckoutController, CheckoutControllerOptions, CheckoutElementAttributeOptions, CheckoutElementAttributes, CheckoutElementEventHandlers, CheckoutElementListeners, CheckoutPropsValidation, CheckoutShellElements, CheckoutShellOptions, CheckoutSnapshot, CreateCheckoutShellOptions, OPENRECEIVE_CHECKOUT_ELEMENT_TAG_NAME, OPENRECEIVE_THEME_TOGGLE_ELEMENT_TAG_NAME, StoredThemeModelOptions, ThemeModel, ThemeModelOptions, ThemePreference, ThemeToggleElementAttributeOptions, ThemeToggleElementAttributes, createCheckoutController, createCheckoutShell, createStoredThemeModel, createThemeModel, validateCheckoutProps } from '@openreceive/browser/headless';
-export { D as DefineElementsOptions, d as defineElements } from './define-elements-LL8dK1E-.js';
+export { D as DefineElementsOptions, d as defineElements } from './define-elements-CV0JlfbJ.js';
 
 /**
  * Every event the checkout element dispatches, in one place. `docs/internal/wrapper-parity.md`

package/dist/wrapper-shared.js

@@ -1,6 +1,6 @@
 import {
   defineElements
-} from "./chunk-SJEIQZYE.js";
+} from "./chunk-MKA6MJU5.js";
 
 // src/wrapper-shared.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreceive/elements",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "The OpenReceive checkout custom element (<openreceive-checkout>) and theme toggle.",
   "keywords": [
     "bitcoin",
@@ -20,7 +20,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@openreceive/browser": "0.3.0"
+    "@openreceive/browser": "0.3.1"
   },
   "exports": {
     ".": {