@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/billing/checkout-processing.d.ts

@@ -1,105 +1,5 @@
-import { DateInput } from '../lib/format.js';
-import { BillingStanding } from './billing-standing.js';
-import '../delete-account-setting-DiPX4Vue.js';
-import 'react';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/write-lock.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import '../hooks/use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
-
+import type { DateInput } from "../lib/format.js";
+import type { BillingStanding } from "./billing-standing.js";
 /**
  * "Payment processing" after the way back from a checkout (docs/billing-harmonization.md
  * §12.21, §14.4; keksdose's `features/billing/checkout-return.ts`, made router-agnostic).
@@ -133,7 +33,7 @@ import '../components/focus-ring.js';
  */
 /** The overview fields a completed checkout changes (wire names, `GET /billing/overview`).
  *  Pass the overview as it came; the other fields are ignored. */
-type CheckoutOverview = Pick<BillingStanding, "status" | "in_good_standing"> & {
+export type CheckoutOverview = Pick<BillingStanding, "status" | "in_good_standing"> & {
     plan: string;
     source: string;
     current_period_end?: DateInput;
@@ -143,12 +43,12 @@ type CheckoutOverview = Pick<BillingStanding, "status" | "in_good_standing"> & {
  * without case, §12.16), the status, the source, the standing and the period's end (read
  * as an instant, so `…Z` and `…+00:00` agree).
  */
-declare function checkoutFingerprint(o: CheckoutOverview): string;
+export declare function checkoutFingerprint(o: CheckoutOverview): string;
 /**
  * Whether the overview `now` shows the checkout: it differs from the fingerprint taken
  * at departure (`before`), or — with no departure on record — it is `active`.
  */
-declare function checkoutLanded(before: string | null, now: CheckoutOverview): boolean;
+export declare function checkoutLanded(before: string | null, now: CheckoutOverview): boolean;
 /**
  * Note the departure for a checkout — just before the page leaves for the provider (or
  * for the pay page, `payPageUrl(url, locale)`):
@@ -160,10 +60,10 @@ declare function checkoutLanded(before: string | null, now: CheckoutOverview): b
  * `overview` is what the page shows now; left out, the return waits for `active`. Pass
  * the same `storageKey` as the hook's.
  */
-declare function noteCheckoutStarted(payer: string | number, overview?: CheckoutOverview, opts?: {
+export declare function noteCheckoutStarted(payer: string | number, overview?: CheckoutOverview, opts?: {
     storageKey?: string;
 }): void;
-interface CheckoutProcessingOptions {
+export interface CheckoutProcessingOptions {
     /** The signed-in payer — the user's or the company's id; null while unknown (the
      *  marker then waits in the URL). */
     payer: string | number | null;
@@ -209,9 +109,7 @@ interface CheckoutProcessingOptions {
  * one timer polls, and `onLanded` runs once. The app's `refetchOnWindowFocus` doesn't
  * matter.
  */
-declare function useCheckoutProcessing(options: CheckoutProcessingOptions): {
+export declare function useCheckoutProcessing(options: CheckoutProcessingOptions): {
     processing: boolean;
     checkAgain: () => void;
 };
-
-export { type CheckoutOverview, type CheckoutProcessingOptions, checkoutFingerprint, checkoutLanded, noteCheckoutStarted, useCheckoutProcessing };

package/dist/billing/checkout-processing.js

@@ -1,7 +1,7 @@
 "use client";
 import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyncExternalStore } from "react";
 import { toDate } from "../lib/format.js";
-import { readStored, writeStored } from "../lib/safe-storage.js";
+import { readStored, removeStored, writeStored } from "../lib/safe-storage.js";
 const PROCESSING_FOR = 10 * 6e4;
 const POLL_EVERY = 4e3;
 const STORAGE_KEY = "eifi1-billing-checkout";
@@ -31,13 +31,6 @@ function readPending(key) {
   }
   return null;
 }
-function forget(key) {
-  if (typeof window === "undefined") return;
-  try {
-    window.localStorage.removeItem(key);
-  } catch {
-  }
-}
 function storeOf(key) {
   let store = stores.get(key);
   if (!store) {
@@ -59,7 +52,7 @@ function storeOf(key) {
 function setPending(store, next) {
   store.pending = next;
   if (next) writeStored(store.key, JSON.stringify(next));
-  else forget(store.key);
+  else removeStored(store.key);
   for (const listener of store.listeners) listener();
   sync(store);
 }

package/dist/billing/checkout-processing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/checkout-processing.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyncExternalStore } from \"react\";\n\nimport { toDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport type { BillingStanding } from \"./billing-standing\";\n\n/**\n * \"Payment processing\" after the way back from a checkout (docs/billing-harmonization.md\n * §12.21, §14.4; keksdose's `features/billing/checkout-return.ts`, made router-agnostic).\n *\n * The provider tells the app about a payment by WEBHOOK, and the webhook may land after\n * the buyer is back: Cloud Run scales to zero, and a cold start can outlast the\n * provider's redirect. Without this, someone who has just paid comes back to a page that\n * still says their trial has ended. So the return is recognised (`?checkout=done`,\n * `isCheckoutReturn`), the page says \"your payment is being processed\"\n * (`BillingBanner kind=\"processing\"`), and the overview is asked again every few seconds\n * until it has moved.\n *\n * **\"Landed\" is judged against the overview at departure** ({@link checkoutFingerprint},\n * noted by {@link noteCheckoutStarted}), not by \"is it `active` yet\": a trial and a beta\n * grant can both buy, and a running free grant keeps its status whatever the provider\n * says (§12.11) — only its period end moves — so \"active\" alone would wait for ever on\n * one of them. A return with no departure on record (another tab, another device) waits\n * for `active`. kastlan's 60-second poll for `source === \"provider\"` is the case this\n * replaces: a payer who bought under a grant never matched it.\n *\n * **Bounded:** after `timeoutMs` (10 minutes) the device stops asking, and the page says\n * what the overview says, whatever that is — a checkout abandoned at the provider must\n * not leave \"processing\" up for good.\n *\n * **Remembered across the whole-page return, per payer.** The departure goes into the\n * browser's storage through the kit's safe storage (a throwing storage — Safari's\n * private mode — keeps it in memory for this page instead), under `storageKey`; a mark\n * names its payer, so it never speaks for another account on a shared device. It is a\n * browser entry on the app's origin: an app whose privacy text lists its entries names\n * it (Kurvenschmiede passes its own key).\n */\n\n/** The overview fields a completed checkout changes (wire names, `GET /billing/overview`).\n *  Pass the overview as it came; the other fields are ignored. */\nexport type CheckoutOverview = Pick<BillingStanding, \"status\" | \"in_good_standing\"> & {\n  plan: string;\n  source: string;\n  current_period_end?: DateInput;\n};\n\n/** How long a return keeps the page in \"processing\" before it trusts the overview. */\nconst PROCESSING_FOR = 10 * 60_000;\n/** How often the overview is asked meanwhile. */\nconst POLL_EVERY = 4_000;\n/** The browser entry, unless the app names its own. */\nconst STORAGE_KEY = \"eifi1-billing-checkout\";\n\n/**\n * What of the overview a completed checkout changes, as one string: the plan (read\n * without case, §12.16), the status, the source, the standing and the period's end (read\n * as an instant, so `…Z` and `…+00:00` agree).\n */\nexport function checkoutFingerprint(o: CheckoutOverview): string {\n  const end = toDate(o.current_period_end ?? null);\n  return [\n    String(o.plan ?? \"\").toLowerCase(),\n    o.status,\n    o.source,\n    String(o.in_good_standing),\n    end ? end.toISOString() : \"\",\n  ].join(\"|\");\n}\n\n/**\n * Whether the overview `now` shows the checkout: it differs from the fingerprint taken\n * at departure (`before`), or — with no departure on record — it is `active`.\n */\nexport function checkoutLanded(before: string | null, now: CheckoutOverview): boolean {\n  return before === null ? now.status === \"active\" : checkoutFingerprint(now) !== before;\n}\n\n/* ── The store: one per storage key, shared by every mounted instance ─────── */\n\ninterface PendingCheckout {\n  /** Whose checkout: a user's or a company's id, as a string. */\n  payer: string;\n  /** The overview's fingerprint at departure, or null when it was not known. */\n  before: string | null;\n  /** When the buyer came back; null while they are (or were) at the provider. */\n  returnedAt: number | null;\n}\n\n/** One mounted hook: what the shared timers call, kept current on every render. */\ninterface Instance {\n  payer: string | null;\n  refetch: () => unknown;\n  onLanded: (() => void) | undefined;\n  timeoutMs: number;\n  pollMs: number;\n}\n\ninterface CheckoutStore {\n  key: string;\n  pending: PendingCheckout | null;\n  listeners: Set<() => void>;\n  /** The mounted instances, in mount order: the last is the latest. */\n  instances: Instance[];\n  poll: ReturnType<typeof setInterval> | null;\n  pollEvery: number;\n  expiry: ReturnType<typeof setTimeout> | null;\n  expiryAt: number | null;\n  /** An instance consumed the marker in this commit; the others leave it be. */\n  consuming: boolean;\n}\n\n/** Module-level, so the banner's instance and the subscription page's share one state,\n *  one poll and one landing (keksdose mounts the hook twice, §14.4). */\nconst stores = new Map<string, CheckoutStore>();\n\nfunction readPending(key: string): PendingCheckout | null {\n  const raw = readStored(key);\n  if (raw === null) return null;\n  try {\n    const value = JSON.parse(raw) as Partial<PendingCheckout> | null;\n    if (\n      value &&\n      typeof value.payer === \"string\" &&\n      (value.before === null || typeof value.before === \"string\") &&\n      (value.returnedAt === null || typeof value.returnedAt === \"number\")\n    ) {\n      return { payer: value.payer, before: value.before, returnedAt: value.returnedAt };\n    }\n  } catch {\n    // Not ours, or damaged: as if nothing was noted.\n  }\n  return null;\n}\n\n/** Drop the browser entry. lib/safe-storage reads and writes; removing needs the same\n *  guard (a blocked storage throws on access). */\nfunction forget(key: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.removeItem(key);\n  } catch {\n    // ignore (private mode, partitioned storage)\n  }\n}\n\nfunction storeOf(key: string): CheckoutStore {\n  let store = stores.get(key);\n  if (!store) {\n    store = {\n      key,\n      pending: readPending(key),\n      listeners: new Set(),\n      instances: [],\n      poll: null,\n      pollEvery: 0,\n      expiry: null,\n      expiryAt: null,\n      consuming: false,\n    };\n    stores.set(key, store);\n  }\n  return store;\n}\n\nfunction setPending(store: CheckoutStore, next: PendingCheckout | null): void {\n  store.pending = next;\n  if (next) writeStored(store.key, JSON.stringify(next));\n  else forget(store.key);\n  for (const listener of store.listeners) listener();\n  sync(store);\n}\n\n/** The latest mounted instance's refetch, failures swallowed: a poll that fails is\n *  simply asked again at the next tick. */\nfunction refetchLatest(store: CheckoutStore): void {\n  const latest = store.instances.at(-1);\n  if (!latest) return;\n  try {\n    const result = latest.refetch() as PromiseLike<unknown> | undefined;\n    if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n  } catch {\n    // as above\n  }\n}\n\n/** Arms or stops the store's two timers — the bound and the poll — for its state. */\nfunction sync(store: CheckoutStore): void {\n  const pending = store.pending;\n  const latest = store.instances.at(-1);\n  const returnedAt = pending?.returnedAt ?? null;\n\n  if (returnedAt === null) {\n    if (store.expiry) clearTimeout(store.expiry);\n    store.expiry = null;\n    store.expiryAt = null;\n  } else {\n    const at = returnedAt + (latest?.timeoutMs ?? PROCESSING_FOR);\n    if (at <= Date.now()) {\n      setPending(store, null);\n      return;\n    }\n    if (store.expiryAt !== at) {\n      if (store.expiry) clearTimeout(store.expiry);\n      store.expiryAt = at;\n      store.expiry = setTimeout(() => {\n        store.expiry = null;\n        store.expiryAt = null;\n        if (store.pending === pending) setPending(store, null);\n      }, at - Date.now());\n    }\n  }\n\n  // One poll for every instance, while a mounted one is the mark's payer.\n  const watching = returnedAt !== null && store.instances.some((i) => i.payer === pending!.payer);\n  const every = latest?.pollMs ?? POLL_EVERY;\n  if (!watching) {\n    if (store.poll) clearInterval(store.poll);\n    store.poll = null;\n  } else if (!store.poll || store.pollEvery !== every) {\n    if (store.poll) clearInterval(store.poll);\n    store.pollEvery = every;\n    store.poll = setInterval(() => refetchLatest(store), every);\n  }\n}\n\n/** A mounted instance joins the store's timers; the latest is the one they call. */\nfunction register(store: CheckoutStore, instance: Instance): () => void {\n  store.instances.push(instance);\n  return () => {\n    store.instances = store.instances.filter((i) => i !== instance);\n    sync(store);\n  };\n}\n\n/**\n * Whether this instance is the one to consume a return marker: the first in a commit is.\n * Another instance in the same commit sees the same marker and leaves it be; the claim\n * lapses once the commit's effects have run.\n */\nfunction claimReturn(store: CheckoutStore): boolean {\n  if (store.consuming) return false;\n  store.consuming = true;\n  void Promise.resolve().then(() => {\n    store.consuming = false;\n  });\n  return true;\n}\n\n/**\n * Note the departure for a checkout — just before the page leaves for the provider (or\n * for the pay page, `payPageUrl(url, locale)`):\n *\n *     noteCheckoutStarted(user.id, overview.data);\n *     window.location.assign(payPageUrl(url, i18n.language));\n *\n * `payer` is the user's or the company's id: a mark never speaks for another payer.\n * `overview` is what the page shows now; left out, the return waits for `active`. Pass\n * the same `storageKey` as the hook's.\n */\nexport function noteCheckoutStarted(\n  payer: string | number,\n  overview?: CheckoutOverview,\n  opts: { storageKey?: string } = {},\n): void {\n  const store = storeOf(opts.storageKey ?? STORAGE_KEY);\n  setPending(store, {\n    payer: String(payer),\n    before: overview ? checkoutFingerprint(overview) : null,\n    returnedAt: null,\n  });\n}\n\nexport interface CheckoutProcessingOptions {\n  /** The signed-in payer — the user's or the company's id; null while unknown (the\n   *  marker then waits in the URL). */\n  payer: string | number | null;\n  /** The page was reached as the way back: `isCheckoutReturn(location.search)`. */\n  returned: boolean;\n  /** Drop the marker, with replace — `setSearchParams((p) => withoutCheckoutReturn(p),\n   *  { replace: true })`. Called once per return, by the first instance that sees it. */\n  onConsumed: () => void;\n  /** The overview query's data, judged here against the departure. */\n  overview: CheckoutOverview | undefined;\n  /** The overview query's refetch: the hook polls with it — one timer for every\n   *  instance, with the latest mounted one's — and \"Check again\" calls it. */\n  refetch: () => unknown;\n  /** Once per landing: refresh what a new standing changes — the plans, the items whose\n   *  `locked` may have lifted. The overview itself is already fresh. */\n  onLanded?: () => void;\n  /** How long a return keeps \"processing\". Default 600 000 (10 minutes). */\n  timeoutMs?: number;\n  /** How often the overview is asked meanwhile. Default 4 000. */\n  pollMs?: number;\n  /** The browser entry. Default `\"eifi1-billing-checkout\"`. */\n  storageKey?: string;\n}\n\n/**\n * Whether this payer is back from a checkout whose payment the overview has not shown\n * yet — and the \"Check again\" for the banner that says so:\n *\n *     const [params, setParams] = useSearchParams();\n *     const overview = useQuery(billingOverviewQuery);\n *     const { processing, checkAgain } = useCheckoutProcessing({\n *       payer: user?.id ?? null,\n *       returned: isCheckoutReturn(params),\n *       onConsumed: () => setParams((p) => withoutCheckoutReturn(p), { replace: true }),\n *       overview: overview.data,\n *       refetch: overview.refetch,\n *       onLanded: () => void qc.invalidateQueries({ queryKey: [\"budgets\"] }),\n *     });\n *     processing && <BillingBanner kind=\"processing\" onAction={checkAgain} />\n *\n * The kit has no router: the app says whether the URL returned and how to drop the\n * marker. Mount it wherever the return lands and the banner shows — every instance with\n * the same `storageKey` shares one state: the first that sees the marker consumes it,\n * one timer polls, and `onLanded` runs once. The app's `refetchOnWindowFocus` doesn't\n * matter.\n */\nexport function useCheckoutProcessing(options: CheckoutProcessingOptions): {\n  processing: boolean;\n  checkAgain: () => void;\n} {\n  const {\n    payer,\n    returned,\n    onConsumed,\n    overview,\n    refetch,\n    onLanded,\n    timeoutMs = PROCESSING_FOR,\n    pollMs = POLL_EVERY,\n    storageKey = STORAGE_KEY,\n  } = options;\n  const payerKey = payer === null || payer === undefined ? null : String(payer);\n  const store = storeOf(storageKey);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      store.listeners.add(notify);\n      return () => {\n        store.listeners.delete(notify);\n      };\n    },\n    [store],\n  );\n  const snapshot = () => store.pending;\n  const pending = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const processing = payerKey !== null && pending?.payer === payerKey && pending.returnedAt !== null;\n\n  // This instance, as the shared timers see it. Registered before paint, so a mark that\n  // ran out while the page was closed is dropped before \"processing\" can flash.\n  const instanceRef = useRef<Instance>({ payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n  useLayoutEffect(() => register(store, instanceRef.current), [store]);\n  useLayoutEffect(() => {\n    Object.assign(instanceRef.current, { payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n    sync(store);\n  });\n\n  // The return: note it, then drop the marker so a reload does not count it twice.\n  const consumed = useEffectEvent(() => onConsumed());\n  useEffect(() => {\n    if (!returned || payerKey === null || !claimReturn(store)) return;\n    const before = store.pending?.payer === payerKey ? store.pending.before : null;\n    setPending(store, { payer: payerKey, before, returnedAt: Date.now() });\n    consumed();\n  }, [returned, payerKey, store]);\n\n  // Caught up: the overview has moved since the departure. Judged against the store as\n  // it is NOW, so a second instance in the same commit finds the mark gone.\n  useEffect(() => {\n    if (!processing || !overview) return;\n    const live = store.pending;\n    if (!live || live.payer !== payerKey || live.returnedAt === null) return;\n    if (!checkoutLanded(live.before, overview)) return;\n    setPending(store, null);\n    const latest = [...store.instances].reverse().find((i) => i.onLanded);\n    latest?.onLanded?.();\n  }, [processing, overview, payerKey, store]);\n\n  const checkAgain = useCallback(() => {\n    try {\n      const result = instanceRef.current.refetch() as PromiseLike<unknown> | undefined;\n      if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n    } catch {\n      // The banner stays; the next poll asks again.\n    }\n  }, []);\n\n  return { processing, checkAgain };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/billing/checkout-processing.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useLayoutEffect, useRef, useSyncExternalStore } from \"react\";\n\nimport { toDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport { readStored, removeStored, writeStored } from \"../lib/safe-storage\";\nimport type { BillingStanding } from \"./billing-standing\";\n\n/**\n * \"Payment processing\" after the way back from a checkout (docs/billing-harmonization.md\n * §12.21, §14.4; keksdose's `features/billing/checkout-return.ts`, made router-agnostic).\n *\n * The provider tells the app about a payment by WEBHOOK, and the webhook may land after\n * the buyer is back: Cloud Run scales to zero, and a cold start can outlast the\n * provider's redirect. Without this, someone who has just paid comes back to a page that\n * still says their trial has ended. So the return is recognised (`?checkout=done`,\n * `isCheckoutReturn`), the page says \"your payment is being processed\"\n * (`BillingBanner kind=\"processing\"`), and the overview is asked again every few seconds\n * until it has moved.\n *\n * **\"Landed\" is judged against the overview at departure** ({@link checkoutFingerprint},\n * noted by {@link noteCheckoutStarted}), not by \"is it `active` yet\": a trial and a beta\n * grant can both buy, and a running free grant keeps its status whatever the provider\n * says (§12.11) — only its period end moves — so \"active\" alone would wait for ever on\n * one of them. A return with no departure on record (another tab, another device) waits\n * for `active`. kastlan's 60-second poll for `source === \"provider\"` is the case this\n * replaces: a payer who bought under a grant never matched it.\n *\n * **Bounded:** after `timeoutMs` (10 minutes) the device stops asking, and the page says\n * what the overview says, whatever that is — a checkout abandoned at the provider must\n * not leave \"processing\" up for good.\n *\n * **Remembered across the whole-page return, per payer.** The departure goes into the\n * browser's storage through the kit's safe storage (a throwing storage — Safari's\n * private mode — keeps it in memory for this page instead), under `storageKey`; a mark\n * names its payer, so it never speaks for another account on a shared device. It is a\n * browser entry on the app's origin: an app whose privacy text lists its entries names\n * it (Kurvenschmiede passes its own key).\n */\n\n/** The overview fields a completed checkout changes (wire names, `GET /billing/overview`).\n *  Pass the overview as it came; the other fields are ignored. */\nexport type CheckoutOverview = Pick<BillingStanding, \"status\" | \"in_good_standing\"> & {\n  plan: string;\n  source: string;\n  current_period_end?: DateInput;\n};\n\n/** How long a return keeps the page in \"processing\" before it trusts the overview. */\nconst PROCESSING_FOR = 10 * 60_000;\n/** How often the overview is asked meanwhile. */\nconst POLL_EVERY = 4_000;\n/** The browser entry, unless the app names its own. */\nconst STORAGE_KEY = \"eifi1-billing-checkout\";\n\n/**\n * What of the overview a completed checkout changes, as one string: the plan (read\n * without case, §12.16), the status, the source, the standing and the period's end (read\n * as an instant, so `…Z` and `…+00:00` agree).\n */\nexport function checkoutFingerprint(o: CheckoutOverview): string {\n  const end = toDate(o.current_period_end ?? null);\n  return [\n    String(o.plan ?? \"\").toLowerCase(),\n    o.status,\n    o.source,\n    String(o.in_good_standing),\n    end ? end.toISOString() : \"\",\n  ].join(\"|\");\n}\n\n/**\n * Whether the overview `now` shows the checkout: it differs from the fingerprint taken\n * at departure (`before`), or — with no departure on record — it is `active`.\n */\nexport function checkoutLanded(before: string | null, now: CheckoutOverview): boolean {\n  return before === null ? now.status === \"active\" : checkoutFingerprint(now) !== before;\n}\n\n/* ── The store: one per storage key, shared by every mounted instance ─────── */\n\ninterface PendingCheckout {\n  /** Whose checkout: a user's or a company's id, as a string. */\n  payer: string;\n  /** The overview's fingerprint at departure, or null when it was not known. */\n  before: string | null;\n  /** When the buyer came back; null while they are (or were) at the provider. */\n  returnedAt: number | null;\n}\n\n/** One mounted hook: what the shared timers call, kept current on every render. */\ninterface Instance {\n  payer: string | null;\n  refetch: () => unknown;\n  onLanded: (() => void) | undefined;\n  timeoutMs: number;\n  pollMs: number;\n}\n\ninterface CheckoutStore {\n  key: string;\n  pending: PendingCheckout | null;\n  listeners: Set<() => void>;\n  /** The mounted instances, in mount order: the last is the latest. */\n  instances: Instance[];\n  poll: ReturnType<typeof setInterval> | null;\n  pollEvery: number;\n  expiry: ReturnType<typeof setTimeout> | null;\n  expiryAt: number | null;\n  /** An instance consumed the marker in this commit; the others leave it be. */\n  consuming: boolean;\n}\n\n/** Module-level, so the banner's instance and the subscription page's share one state,\n *  one poll and one landing (keksdose mounts the hook twice, §14.4). */\nconst stores = new Map<string, CheckoutStore>();\n\nfunction readPending(key: string): PendingCheckout | null {\n  const raw = readStored(key);\n  if (raw === null) return null;\n  try {\n    const value = JSON.parse(raw) as Partial<PendingCheckout> | null;\n    if (\n      value &&\n      typeof value.payer === \"string\" &&\n      (value.before === null || typeof value.before === \"string\") &&\n      (value.returnedAt === null || typeof value.returnedAt === \"number\")\n    ) {\n      return { payer: value.payer, before: value.before, returnedAt: value.returnedAt };\n    }\n  } catch {\n    // Not ours, or damaged: as if nothing was noted.\n  }\n  return null;\n}\n\n\nfunction storeOf(key: string): CheckoutStore {\n  let store = stores.get(key);\n  if (!store) {\n    store = {\n      key,\n      pending: readPending(key),\n      listeners: new Set(),\n      instances: [],\n      poll: null,\n      pollEvery: 0,\n      expiry: null,\n      expiryAt: null,\n      consuming: false,\n    };\n    stores.set(key, store);\n  }\n  return store;\n}\n\nfunction setPending(store: CheckoutStore, next: PendingCheckout | null): void {\n  store.pending = next;\n  if (next) writeStored(store.key, JSON.stringify(next));\n  else removeStored(store.key);\n  for (const listener of store.listeners) listener();\n  sync(store);\n}\n\n/** The latest mounted instance's refetch, failures swallowed: a poll that fails is\n *  simply asked again at the next tick. */\nfunction refetchLatest(store: CheckoutStore): void {\n  const latest = store.instances.at(-1);\n  if (!latest) return;\n  try {\n    const result = latest.refetch() as PromiseLike<unknown> | undefined;\n    if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n  } catch {\n    // as above\n  }\n}\n\n/** Arms or stops the store's two timers — the bound and the poll — for its state. */\nfunction sync(store: CheckoutStore): void {\n  const pending = store.pending;\n  const latest = store.instances.at(-1);\n  const returnedAt = pending?.returnedAt ?? null;\n\n  if (returnedAt === null) {\n    if (store.expiry) clearTimeout(store.expiry);\n    store.expiry = null;\n    store.expiryAt = null;\n  } else {\n    const at = returnedAt + (latest?.timeoutMs ?? PROCESSING_FOR);\n    if (at <= Date.now()) {\n      setPending(store, null);\n      return;\n    }\n    if (store.expiryAt !== at) {\n      if (store.expiry) clearTimeout(store.expiry);\n      store.expiryAt = at;\n      store.expiry = setTimeout(() => {\n        store.expiry = null;\n        store.expiryAt = null;\n        if (store.pending === pending) setPending(store, null);\n      }, at - Date.now());\n    }\n  }\n\n  // One poll for every instance, while a mounted one is the mark's payer.\n  const watching = returnedAt !== null && store.instances.some((i) => i.payer === pending!.payer);\n  const every = latest?.pollMs ?? POLL_EVERY;\n  if (!watching) {\n    if (store.poll) clearInterval(store.poll);\n    store.poll = null;\n  } else if (!store.poll || store.pollEvery !== every) {\n    if (store.poll) clearInterval(store.poll);\n    store.pollEvery = every;\n    store.poll = setInterval(() => refetchLatest(store), every);\n  }\n}\n\n/** A mounted instance joins the store's timers; the latest is the one they call. */\nfunction register(store: CheckoutStore, instance: Instance): () => void {\n  store.instances.push(instance);\n  return () => {\n    store.instances = store.instances.filter((i) => i !== instance);\n    sync(store);\n  };\n}\n\n/**\n * Whether this instance is the one to consume a return marker: the first in a commit is.\n * Another instance in the same commit sees the same marker and leaves it be; the claim\n * lapses once the commit's effects have run.\n */\nfunction claimReturn(store: CheckoutStore): boolean {\n  if (store.consuming) return false;\n  store.consuming = true;\n  void Promise.resolve().then(() => {\n    store.consuming = false;\n  });\n  return true;\n}\n\n/**\n * Note the departure for a checkout — just before the page leaves for the provider (or\n * for the pay page, `payPageUrl(url, locale)`):\n *\n *     noteCheckoutStarted(user.id, overview.data);\n *     window.location.assign(payPageUrl(url, i18n.language));\n *\n * `payer` is the user's or the company's id: a mark never speaks for another payer.\n * `overview` is what the page shows now; left out, the return waits for `active`. Pass\n * the same `storageKey` as the hook's.\n */\nexport function noteCheckoutStarted(\n  payer: string | number,\n  overview?: CheckoutOverview,\n  opts: { storageKey?: string } = {},\n): void {\n  const store = storeOf(opts.storageKey ?? STORAGE_KEY);\n  setPending(store, {\n    payer: String(payer),\n    before: overview ? checkoutFingerprint(overview) : null,\n    returnedAt: null,\n  });\n}\n\nexport interface CheckoutProcessingOptions {\n  /** The signed-in payer — the user's or the company's id; null while unknown (the\n   *  marker then waits in the URL). */\n  payer: string | number | null;\n  /** The page was reached as the way back: `isCheckoutReturn(location.search)`. */\n  returned: boolean;\n  /** Drop the marker, with replace — `setSearchParams((p) => withoutCheckoutReturn(p),\n   *  { replace: true })`. Called once per return, by the first instance that sees it. */\n  onConsumed: () => void;\n  /** The overview query's data, judged here against the departure. */\n  overview: CheckoutOverview | undefined;\n  /** The overview query's refetch: the hook polls with it — one timer for every\n   *  instance, with the latest mounted one's — and \"Check again\" calls it. */\n  refetch: () => unknown;\n  /** Once per landing: refresh what a new standing changes — the plans, the items whose\n   *  `locked` may have lifted. The overview itself is already fresh. */\n  onLanded?: () => void;\n  /** How long a return keeps \"processing\". Default 600 000 (10 minutes). */\n  timeoutMs?: number;\n  /** How often the overview is asked meanwhile. Default 4 000. */\n  pollMs?: number;\n  /** The browser entry. Default `\"eifi1-billing-checkout\"`. */\n  storageKey?: string;\n}\n\n/**\n * Whether this payer is back from a checkout whose payment the overview has not shown\n * yet — and the \"Check again\" for the banner that says so:\n *\n *     const [params, setParams] = useSearchParams();\n *     const overview = useQuery(billingOverviewQuery);\n *     const { processing, checkAgain } = useCheckoutProcessing({\n *       payer: user?.id ?? null,\n *       returned: isCheckoutReturn(params),\n *       onConsumed: () => setParams((p) => withoutCheckoutReturn(p), { replace: true }),\n *       overview: overview.data,\n *       refetch: overview.refetch,\n *       onLanded: () => void qc.invalidateQueries({ queryKey: [\"budgets\"] }),\n *     });\n *     processing && <BillingBanner kind=\"processing\" onAction={checkAgain} />\n *\n * The kit has no router: the app says whether the URL returned and how to drop the\n * marker. Mount it wherever the return lands and the banner shows — every instance with\n * the same `storageKey` shares one state: the first that sees the marker consumes it,\n * one timer polls, and `onLanded` runs once. The app's `refetchOnWindowFocus` doesn't\n * matter.\n */\nexport function useCheckoutProcessing(options: CheckoutProcessingOptions): {\n  processing: boolean;\n  checkAgain: () => void;\n} {\n  const {\n    payer,\n    returned,\n    onConsumed,\n    overview,\n    refetch,\n    onLanded,\n    timeoutMs = PROCESSING_FOR,\n    pollMs = POLL_EVERY,\n    storageKey = STORAGE_KEY,\n  } = options;\n  const payerKey = payer === null || payer === undefined ? null : String(payer);\n  const store = storeOf(storageKey);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      store.listeners.add(notify);\n      return () => {\n        store.listeners.delete(notify);\n      };\n    },\n    [store],\n  );\n  const snapshot = () => store.pending;\n  const pending = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const processing = payerKey !== null && pending?.payer === payerKey && pending.returnedAt !== null;\n\n  // This instance, as the shared timers see it. Registered before paint, so a mark that\n  // ran out while the page was closed is dropped before \"processing\" can flash.\n  const instanceRef = useRef<Instance>({ payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n  useLayoutEffect(() => register(store, instanceRef.current), [store]);\n  useLayoutEffect(() => {\n    Object.assign(instanceRef.current, { payer: payerKey, refetch, onLanded, timeoutMs, pollMs });\n    sync(store);\n  });\n\n  // The return: note it, then drop the marker so a reload does not count it twice.\n  const consumed = useEffectEvent(() => onConsumed());\n  useEffect(() => {\n    if (!returned || payerKey === null || !claimReturn(store)) return;\n    const before = store.pending?.payer === payerKey ? store.pending.before : null;\n    setPending(store, { payer: payerKey, before, returnedAt: Date.now() });\n    consumed();\n  }, [returned, payerKey, store]);\n\n  // Caught up: the overview has moved since the departure. Judged against the store as\n  // it is NOW, so a second instance in the same commit finds the mark gone.\n  useEffect(() => {\n    if (!processing || !overview) return;\n    const live = store.pending;\n    if (!live || live.payer !== payerKey || live.returnedAt === null) return;\n    if (!checkoutLanded(live.before, overview)) return;\n    setPending(store, null);\n    const latest = [...store.instances].reverse().find((i) => i.onLanded);\n    latest?.onLanded?.();\n  }, [processing, overview, payerKey, store]);\n\n  const checkAgain = useCallback(() => {\n    try {\n      const result = instanceRef.current.refetch() as PromiseLike<unknown> | undefined;\n      if (result && typeof result.then === \"function\") result.then(undefined, () => {});\n    } catch {\n      // The banner stays; the next poll asks again.\n    }\n  }, []);\n\n  return { processing, checkAgain };\n}\n"],"mappings":"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","names":[]}

package/dist/billing/checkout-return.d.ts

@@ -16,16 +16,16 @@
  * deploy notes and its tests.
  */
 /** The query parameter of the way back. */
-declare const CHECKOUT_RETURN_PARAM = "checkout";
+export declare const CHECKOUT_RETURN_PARAM = "checkout";
 /** Its one value: the buyer came back from a completed checkout. */
-declare const CHECKOUT_RETURN_VALUE = "done";
+export declare const CHECKOUT_RETURN_VALUE = "done";
 /**
  * Whether the page was reached as the way back from a checkout: `?checkout=done`.
  *
  *     const returned = isCheckoutReturn(location.search);       // react-router's useLocation()
  *     const returned = isCheckoutReturn(searchParams);           // useSearchParams()[0]
  */
-declare function isCheckoutReturn(where: string | URLSearchParams | {
+export declare function isCheckoutReturn(where: string | URLSearchParams | {
     search: string;
 }): boolean;
 /**
@@ -34,7 +34,7 @@ declare function isCheckoutReturn(where: string | URLSearchParams | {
  *
  *     setSearchParams((p) => withoutCheckoutReturn(p), { replace: true });
  */
-declare function withoutCheckoutReturn(params: URLSearchParams): URLSearchParams;
+export declare function withoutCheckoutReturn(params: URLSearchParams): URLSearchParams;
 /**
  * The subscription page's way-back URL: `page` with `checkout=done` in its query —
  * after any query it already has, before its hash. A marker already there is replaced,
@@ -46,6 +46,4 @@ declare function withoutCheckoutReturn(params: URLSearchParams): URLSearchParams
  * What the pay page hands Paddle.js as `successUrl`, and what a hosted checkout's
  * redirect is set to in Paddle's dashboard.
  */
-declare function checkoutReturnUrl(page: string): string;
-
-export { CHECKOUT_RETURN_PARAM, CHECKOUT_RETURN_VALUE, checkoutReturnUrl, isCheckoutReturn, withoutCheckoutReturn };
+export declare function checkoutReturnUrl(page: string): string;

package/dist/billing/pay-page.d.ts

@@ -1,104 +1,4 @@
-import { fJ as UiKitLabels } from '../delete-account-setting-DiPX4Vue.js';
-import 'react';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/write-lock.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import '../hooks/use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
-
+import type { UiKitLabels } from "../i18n/kit-labels.js";
 /**
  * The kit's pay page (docs/billing-harmonization.md §14.4, decision 19 as amended): a
  * standalone static page that ui-kit ships as `dist/pay/`, and that each app serves on
@@ -117,22 +17,23 @@ import '../components/focus-ring.js';
  */
 /** Paddle's two environments: the sandbox's client-side tokens start `test_`, live
  *  ones `live_`. */
-type PaddleEnvironment = "sandbox" | "live";
+export type PaddleEnvironment = "sandbox" | "live";
 /** The pay page's language parameter: `?lang=<kit locale>`. */
-declare const PAY_PAGE_LANG_PARAM = "lang";
+export declare const PAY_PAGE_LANG_PARAM = "lang";
 /** The kit's seven languages (`KitLanguageCode`), as the page reads them. */
 declare const PAY_PAGE_LANGUAGES: readonly ["de-CH", "en", "es", "fr", "it", "hu", "zh"];
 /** One of the kit's languages, as the page speaks it. */
-type PayPageLanguage = (typeof PAY_PAGE_LANGUAGES)[number];
+export type PayPageLanguage = (typeof PAY_PAGE_LANGUAGES)[number];
 /** Paddle's transaction parameter on a pay page link. @internal */
-declare const PAY_PAGE_TRANSACTION_PARAM = "_ptxn";
+export declare const PAY_PAGE_TRANSACTION_PARAM = "_ptxn";
 /**
  * The kit's locale → Paddle's checkout locale: `de-CH` → `de`, `zh` → `zh-Hans`, `hu` →
  * `en` (Paddle has no Hungarian), the others as they are. Any tag is read as the kit
  * reads it (`de-AT` is the one German, `zh-TW` the one Chinese); one the kit doesn't
- * ship is English.
+ * ship is English, and so is `undefined` (0.33.1) — `useKitLocale()` with no provider
+ * locale.
  */
-declare function paddleLocale(kitLocale: string): string;
+export declare function paddleLocale(kitLocale: string | undefined): string;
 /**
  * The checkout's `{url}` with the buyer's language: `lang=<kit locale>` on a pay page
  * link (one that carries `_ptxn`); any other URL — a hosted checkout's, which takes its
@@ -140,21 +41,24 @@ declare function paddleLocale(kitLocale: string): string;
  *
  *     const { url } = await api.checkout({ plan, interval, currency });
  *     noteCheckoutStarted(user.id, overview);
- *     window.location.assign(payPageUrl(url, i18n.language));
+ *     window.location.assign(payPageUrl(url, locale));   // locale = useKitLocale()
  *
- * A wrong `lang` costs nothing but the language: the page falls back to the browser's.
+ * `locale` may be `undefined` (0.33.1, keksdose): `useKitLocale()` answers that with no
+ * provider locale, the runtime's language. The link then goes without `lang`, and the
+ * page speaks the browser's language, else English — what a missing or wrong `lang`
+ * already did: it costs nothing but the language.
  */
-declare function payPageUrl(checkoutUrl: string, locale: string): string;
+export declare function payPageUrl(checkoutUrl: string, locale: string | undefined): string;
 /**
  * The language the page speaks: its `lang` parameter, else the browser's languages in
  * their order, each matched to the kit's; else English. @internal
  */
-declare function payPageLanguage(lang: string | null | undefined, browserLanguages?: readonly string[]): PayPageLanguage;
+export declare function payPageLanguage(lang: string | null | undefined, browserLanguages?: readonly string[]): PayPageLanguage;
 /**
  * The page's words in one language — built into `pay.js` at the kit's build from the
  * seven catalogues, since the page has no React and no provider. @internal
  */
-interface PayPageStrings {
+export interface PayPageStrings {
     /** `billing.payOpening`, while the checkout opens. */
     opening: string;
     /** `billing.payNothing`: no `_ptxn`, or no token (billing off). */
@@ -172,16 +76,16 @@ interface PayPageStrings {
     legal: string;
 }
 /** The page's words, read from one of the kit's catalogues. @internal */
-declare function payPageStrings(labels: UiKitLabels): PayPageStrings;
+export declare function payPageStrings(labels: UiKitLabels): PayPageStrings;
 /** The configuration file beside the page, written at each app's web build. @internal */
-declare const PAY_CONFIG_FILE = "pay-config.json";
+export declare const PAY_CONFIG_FILE = "pay-config.json";
 /**
  * `pay-config.json`: what the page needs that differs per app and deployment. Read by
  * the page from its own origin — never from the query, where Paddle's own links (it
  * puts only `_ptxn` there) would lack it and a return URL would be an open redirect on
  * an approved payment domain. @internal
  */
-interface PayPageConfig {
+export interface PayPageConfig {
     /** Paddle's client-side token (`test_…` for the sandbox, `live_…` for live); null
      *  while billing is off, and the page says `payNothing`. */
     token: string | null;
@@ -203,8 +107,7 @@ interface PayPageConfig {
  * - a return, terms or privacy URL that isn't `https://` (`http://` for localhost only);
  * - no app name. @internal
  */
-declare function payPageConfigProblems(config: unknown): string[];
+export declare function payPageConfigProblems(config: unknown): string[];
 /** Paddle.js's `successUrl` for a configuration: the way back, `?checkout=done`. @internal */
-declare function paySuccessUrl(config: Pick<PayPageConfig, "returnUrl">): string;
-
-export { PAY_CONFIG_FILE, PAY_PAGE_LANG_PARAM, PAY_PAGE_TRANSACTION_PARAM, type PaddleEnvironment, type PayPageConfig, type PayPageLanguage, type PayPageStrings, paddleLocale, payPageConfigProblems, payPageLanguage, payPageStrings, payPageUrl, paySuccessUrl };
+export declare function paySuccessUrl(config: Pick<PayPageConfig, "returnUrl">): string;
+export {};

package/dist/billing/pay-page.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/pay-page.ts"],"sourcesContent":["import type { UiKitLabels } from \"../i18n/kit-labels\";\nimport { checkoutReturnUrl } from \"./checkout-return\";\n\n/**\n * The kit's pay page (docs/billing-harmonization.md §14.4, decision 19 as amended): a\n * standalone static page that ui-kit ships as `dist/pay/`, and that each app serves on\n * its own pay host, `pay.<app domain>` — a separate origin, approved in Paddle, where\n * Paddle.js shares the origin with nothing: no sign-in, no app code, no storage.\n *\n * Paddle's create-transaction answers `checkout.url`: the pay page's URL plus\n * `?_ptxn=<txn>`, and Paddle.js on that page opens the transaction by itself. The app\n * sends the buyer there with {@link payPageUrl}, which adds the buyer's language; the\n * page maps it to Paddle's checkout locale ({@link paddleLocale}). Everything else the\n * page needs — the client-side token, sandbox or live, the way back — is the app's\n * `pay-config.json`, written at its web build by the `eifi1-pay-page` script.\n *\n * Pure, and React-free: the page's own script (`pay-page/pay.ts`) and that build script\n * bundle this module. The exports below the barrel's four are theirs.\n */\n\n/** Paddle's two environments: the sandbox's client-side tokens start `test_`, live\n *  ones `live_`. */\nexport type PaddleEnvironment = \"sandbox\" | \"live\";\n\n/** The pay page's language parameter: `?lang=<kit locale>`. */\nexport const PAY_PAGE_LANG_PARAM = \"lang\";\n\n/** The kit's seven languages (`KitLanguageCode`), as the page reads them. */\nconst PAY_PAGE_LANGUAGES = [\"de-CH\", \"en\", \"es\", \"fr\", \"it\", \"hu\", \"zh\"] as const;\n\n/** One of the kit's languages, as the page speaks it. */\nexport type PayPageLanguage = (typeof PAY_PAGE_LANGUAGES)[number];\n\n/**\n * The kit's language → Paddle's checkout locale (`Paddle.Checkout.open`,\n * `settings.locale`, read 2026-10-09: ar, zh-Hans, zh-TW, da, nl, en, fr, de, it, ja, ko,\n * no, pl, pt, pt-BR, tr, ru, es, sv). Paddle has no Hungarian: a Hungarian buyer gets\n * English always, not Paddle's guess from the browser. The page's own lines stay in the\n * kit's language, Hungarian included.\n */\nconst PADDLE_LOCALES: Readonly<Record<PayPageLanguage, string>> = {\n  en: \"en\",\n  \"de-CH\": \"de\",\n  fr: \"fr\",\n  it: \"it\",\n  es: \"es\",\n  zh: \"zh-Hans\",\n  hu: \"en\",\n};\n\n/** Paddle's transaction parameter on a pay page link. @internal */\nexport const PAY_PAGE_TRANSACTION_PARAM = \"_ptxn\";\n\n/**\n * The kit language one tag names, or undefined — `resolveLanguage`'s rule\n * (src/i18n/languages.ts), restated here because that module loads the seven catalogues\n * and the page must stay a few kilobytes: exact first, ignoring case and reading `_` as\n * `-`; then by language, so every German is `de-CH`, every Chinese `zh` (Simplified),\n * and any regional form its base (`fr-CA` → `fr`).\n */\nfunction kitLanguageOf(tag: unknown): PayPageLanguage | undefined {\n  if (typeof tag !== \"string\") return undefined;\n  const clean = tag.trim().replace(/_/g, \"-\");\n  if (!clean) return undefined;\n  const lower = clean.toLowerCase();\n  const exact = PAY_PAGE_LANGUAGES.find((code) => code.toLowerCase() === lower);\n  if (exact) return exact;\n  const language = lower.split(\"-\")[0];\n  return PAY_PAGE_LANGUAGES.find((code) => code.split(\"-\")[0].toLowerCase() === language);\n}\n\n/**\n * The kit's locale → Paddle's checkout locale: `de-CH` → `de`, `zh` → `zh-Hans`, `hu` →\n * `en` (Paddle has no Hungarian), the others as they are. Any tag is read as the kit\n * reads it (`de-AT` is the one German, `zh-TW` the one Chinese); one the kit doesn't\n * ship is English.\n */\nexport function paddleLocale(kitLocale: string): string {\n  return PADDLE_LOCALES[kitLanguageOf(kitLocale) ?? \"en\"];\n}\n\n/**\n * The checkout's `{url}` with the buyer's language: `lang=<kit locale>` on a pay page\n * link (one that carries `_ptxn`); any other URL — a hosted checkout's, which takes its\n * own `locale` — unchanged, as is a locale the kit doesn't ship.\n *\n *     const { url } = await api.checkout({ plan, interval, currency });\n *     noteCheckoutStarted(user.id, overview);\n *     window.location.assign(payPageUrl(url, i18n.language));\n *\n * A wrong `lang` costs nothing but the language: the page falls back to the browser's.\n */\nexport function payPageUrl(checkoutUrl: string, locale: string): string {\n  const language = kitLanguageOf(locale);\n  if (!language) return checkoutUrl;\n  let url: URL;\n  try {\n    url = new URL(checkoutUrl);\n  } catch {\n    return checkoutUrl;\n  }\n  if (!url.searchParams.has(PAY_PAGE_TRANSACTION_PARAM)) return checkoutUrl;\n  url.searchParams.set(PAY_PAGE_LANG_PARAM, language);\n  return url.toString();\n}\n\n/**\n * The language the page speaks: its `lang` parameter, else the browser's languages in\n * their order, each matched to the kit's; else English. @internal\n */\nexport function payPageLanguage(\n  lang: string | null | undefined,\n  browserLanguages: readonly string[] = [],\n): PayPageLanguage {\n  for (const candidate of [lang, ...browserLanguages]) {\n    const found = kitLanguageOf(candidate);\n    if (found) return found;\n  }\n  return \"en\";\n}\n\n/* ── The page's words ──────────────────────────────────────────────────────── */\n\n/**\n * The page's words in one language — built into `pay.js` at the kit's build from the\n * seven catalogues, since the page has no React and no provider. @internal\n */\nexport interface PayPageStrings {\n  /** `billing.payOpening`, while the checkout opens. */\n  opening: string;\n  /** `billing.payNothing`: no `_ptxn`, or no token (billing off). */\n  nothing: string;\n  /** `billing.payFailed`: Paddle.js didn't load, or the configuration is wrong. */\n  failed: string;\n  /** `billing.payBack`: the buyer closed the checkout. */\n  closed: string;\n  /** `common.back`: the link to the app's subscription page. */\n  back: string;\n  /** `legal.links.terms` and `legal.links.privacy`: the footer's links. */\n  terms: string;\n  privacy: string;\n  /** `legal.navLabel`: the footer's `<nav>`. */\n  legal: string;\n}\n\n/** The page's words, read from one of the kit's catalogues. @internal */\nexport function payPageStrings(labels: UiKitLabels): PayPageStrings {\n  return {\n    opening: labels.billing.payOpening,\n    nothing: labels.billing.payNothing,\n    failed: labels.billing.payFailed,\n    closed: labels.billing.payBack,\n    back: labels.common.back,\n    terms: labels.legal.links.terms,\n    privacy: labels.legal.links.privacy,\n    legal: labels.legal.navLabel,\n  };\n}\n\n/* ── pay-config.json ───────────────────────────────────────────────────────── */\n\n/** The configuration file beside the page, written at each app's web build. @internal */\nexport const PAY_CONFIG_FILE = \"pay-config.json\";\n\n/**\n * `pay-config.json`: what the page needs that differs per app and deployment. Read by\n * the page from its own origin — never from the query, where Paddle's own links (it\n * puts only `_ptxn` there) would lack it and a return URL would be an open redirect on\n * an approved payment domain. @internal\n */\nexport interface PayPageConfig {\n  /** Paddle's client-side token (`test_…` for the sandbox, `live_…` for live); null\n   *  while billing is off, and the page says `payNothing`. */\n  token: string | null;\n  environment: PaddleEnvironment | null;\n  /** The app's subscription page. Paddle.js's `successUrl` is\n   *  `checkoutReturnUrl(returnUrl)`; \"Back\" goes here. */\n  returnUrl: string;\n  appName: string;\n  termsUrl: string;\n  privacyUrl: string;\n}\n\n/** Paddle's client-side token prefixes, per environment. */\nconst TOKEN_PREFIX: Readonly<Record<PaddleEnvironment, string>> = { sandbox: \"test_\", live: \"live_\" };\n\n/** `https://`, or `http://` on this machine only (`localhost`, `127.0.0.1`, `[::1]`). */\nfunction isPageUrl(value: unknown): boolean {\n  if (typeof value !== \"string\") return false;\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol === \"https:\") return true;\n  return url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname);\n}\n\n/**\n * What is wrong with a `pay-config.json`, one line each — `[]` when nothing is. The\n * build script refuses to write a file with any (so a wrong pairing fails the build,\n * not a buyer), and the page says `payFailed` for one it reads:\n *\n * - a token whose prefix disagrees with the environment (`test_` ↔ sandbox, `live_` ↔\n *   live), or a token without an environment;\n * - a return, terms or privacy URL that isn't `https://` (`http://` for localhost only);\n * - no app name. @internal\n */\nexport function payPageConfigProblems(config: unknown): string[] {\n  if (typeof config !== \"object\" || config === null) return [\"the configuration is not an object\"];\n  const c = config as Record<string, unknown>;\n  const problems: string[] = [];\n  const { token, environment } = c;\n  if (environment !== null && environment !== undefined && environment !== \"sandbox\" && environment !== \"live\") {\n    problems.push(`environment must be \"sandbox\" or \"live\", not ${JSON.stringify(environment)}`);\n  }\n  if (token !== null && token !== undefined) {\n    if (typeof token !== \"string\" || token === \"\") {\n      problems.push(\"token must be Paddle's client-side token, or null while billing is off\");\n    } else if (environment !== \"sandbox\" && environment !== \"live\") {\n      problems.push(\"a token needs its environment: sandbox or live\");\n    } else if (!token.startsWith(TOKEN_PREFIX[environment]) || token.length === TOKEN_PREFIX[environment].length) {\n      const other = environment === \"sandbox\" ? \"live\" : \"sandbox\";\n      problems.push(\n        token.startsWith(TOKEN_PREFIX[other])\n          ? `the token is a ${other} token (${TOKEN_PREFIX[other]}…), but the environment is ${environment}`\n          : `a ${environment} token starts with ${TOKEN_PREFIX[environment]}`,\n      );\n    }\n  }\n  for (const key of [\"returnUrl\", \"termsUrl\", \"privacyUrl\"] as const) {\n    if (!isPageUrl(c[key])) problems.push(`${key} must be an https:// URL (http:// for localhost only)`);\n  }\n  if (typeof c.appName !== \"string\" || c.appName.trim() === \"\") problems.push(\"appName is missing\");\n  return problems;\n}\n\n/** Paddle.js's `successUrl` for a configuration: the way back, `?checkout=done`. @internal */\nexport function paySuccessUrl(config: Pick<PayPageConfig, \"returnUrl\">): string {\n  return checkoutReturnUrl(config.returnUrl);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/billing/pay-page.ts"],"sourcesContent":["import type { UiKitLabels } from \"../i18n/kit-labels\";\nimport { checkoutReturnUrl } from \"./checkout-return\";\n\n/**\n * The kit's pay page (docs/billing-harmonization.md §14.4, decision 19 as amended): a\n * standalone static page that ui-kit ships as `dist/pay/`, and that each app serves on\n * its own pay host, `pay.<app domain>` — a separate origin, approved in Paddle, where\n * Paddle.js shares the origin with nothing: no sign-in, no app code, no storage.\n *\n * Paddle's create-transaction answers `checkout.url`: the pay page's URL plus\n * `?_ptxn=<txn>`, and Paddle.js on that page opens the transaction by itself. The app\n * sends the buyer there with {@link payPageUrl}, which adds the buyer's language; the\n * page maps it to Paddle's checkout locale ({@link paddleLocale}). Everything else the\n * page needs — the client-side token, sandbox or live, the way back — is the app's\n * `pay-config.json`, written at its web build by the `eifi1-pay-page` script.\n *\n * Pure, and React-free: the page's own script (`pay-page/pay.ts`) and that build script\n * bundle this module. The exports below the barrel's four are theirs.\n */\n\n/** Paddle's two environments: the sandbox's client-side tokens start `test_`, live\n *  ones `live_`. */\nexport type PaddleEnvironment = \"sandbox\" | \"live\";\n\n/** The pay page's language parameter: `?lang=<kit locale>`. */\nexport const PAY_PAGE_LANG_PARAM = \"lang\";\n\n/** The kit's seven languages (`KitLanguageCode`), as the page reads them. */\nconst PAY_PAGE_LANGUAGES = [\"de-CH\", \"en\", \"es\", \"fr\", \"it\", \"hu\", \"zh\"] as const;\n\n/** One of the kit's languages, as the page speaks it. */\nexport type PayPageLanguage = (typeof PAY_PAGE_LANGUAGES)[number];\n\n/**\n * The kit's language → Paddle's checkout locale (`Paddle.Checkout.open`,\n * `settings.locale`, read 2026-10-09: ar, zh-Hans, zh-TW, da, nl, en, fr, de, it, ja, ko,\n * no, pl, pt, pt-BR, tr, ru, es, sv). Paddle has no Hungarian: a Hungarian buyer gets\n * English always, not Paddle's guess from the browser. The page's own lines stay in the\n * kit's language, Hungarian included.\n */\nconst PADDLE_LOCALES: Readonly<Record<PayPageLanguage, string>> = {\n  en: \"en\",\n  \"de-CH\": \"de\",\n  fr: \"fr\",\n  it: \"it\",\n  es: \"es\",\n  zh: \"zh-Hans\",\n  hu: \"en\",\n};\n\n/** Paddle's transaction parameter on a pay page link. @internal */\nexport const PAY_PAGE_TRANSACTION_PARAM = \"_ptxn\";\n\n/**\n * The kit language one tag names, or undefined — `resolveLanguage`'s rule\n * (src/i18n/languages.ts), restated here because that module loads the seven catalogues\n * and the page must stay a few kilobytes: exact first, ignoring case and reading `_` as\n * `-`; then by language, so every German is `de-CH`, every Chinese `zh` (Simplified),\n * and any regional form its base (`fr-CA` → `fr`).\n */\nfunction kitLanguageOf(tag: unknown): PayPageLanguage | undefined {\n  if (typeof tag !== \"string\") return undefined;\n  const clean = tag.trim().replace(/_/g, \"-\");\n  if (!clean) return undefined;\n  const lower = clean.toLowerCase();\n  const exact = PAY_PAGE_LANGUAGES.find((code) => code.toLowerCase() === lower);\n  if (exact) return exact;\n  const language = lower.split(\"-\")[0];\n  return PAY_PAGE_LANGUAGES.find((code) => code.split(\"-\")[0].toLowerCase() === language);\n}\n\n/**\n * The kit's locale → Paddle's checkout locale: `de-CH` → `de`, `zh` → `zh-Hans`, `hu` →\n * `en` (Paddle has no Hungarian), the others as they are. Any tag is read as the kit\n * reads it (`de-AT` is the one German, `zh-TW` the one Chinese); one the kit doesn't\n * ship is English, and so is `undefined` (0.33.1) — `useKitLocale()` with no provider\n * locale.\n */\nexport function paddleLocale(kitLocale: string | undefined): string {\n  return PADDLE_LOCALES[kitLanguageOf(kitLocale) ?? \"en\"];\n}\n\n/**\n * The checkout's `{url}` with the buyer's language: `lang=<kit locale>` on a pay page\n * link (one that carries `_ptxn`); any other URL — a hosted checkout's, which takes its\n * own `locale` — unchanged, as is a locale the kit doesn't ship.\n *\n *     const { url } = await api.checkout({ plan, interval, currency });\n *     noteCheckoutStarted(user.id, overview);\n *     window.location.assign(payPageUrl(url, locale));   // locale = useKitLocale()\n *\n * `locale` may be `undefined` (0.33.1, keksdose): `useKitLocale()` answers that with no\n * provider locale, the runtime's language. The link then goes without `lang`, and the\n * page speaks the browser's language, else English — what a missing or wrong `lang`\n * already did: it costs nothing but the language.\n */\nexport function payPageUrl(checkoutUrl: string, locale: string | undefined): string {\n  const language = kitLanguageOf(locale);\n  if (!language) return checkoutUrl;\n  let url: URL;\n  try {\n    url = new URL(checkoutUrl);\n  } catch {\n    return checkoutUrl;\n  }\n  if (!url.searchParams.has(PAY_PAGE_TRANSACTION_PARAM)) return checkoutUrl;\n  url.searchParams.set(PAY_PAGE_LANG_PARAM, language);\n  return url.toString();\n}\n\n/**\n * The language the page speaks: its `lang` parameter, else the browser's languages in\n * their order, each matched to the kit's; else English. @internal\n */\nexport function payPageLanguage(\n  lang: string | null | undefined,\n  browserLanguages: readonly string[] = [],\n): PayPageLanguage {\n  for (const candidate of [lang, ...browserLanguages]) {\n    const found = kitLanguageOf(candidate);\n    if (found) return found;\n  }\n  return \"en\";\n}\n\n/* ── The page's words ──────────────────────────────────────────────────────── */\n\n/**\n * The page's words in one language — built into `pay.js` at the kit's build from the\n * seven catalogues, since the page has no React and no provider. @internal\n */\nexport interface PayPageStrings {\n  /** `billing.payOpening`, while the checkout opens. */\n  opening: string;\n  /** `billing.payNothing`: no `_ptxn`, or no token (billing off). */\n  nothing: string;\n  /** `billing.payFailed`: Paddle.js didn't load, or the configuration is wrong. */\n  failed: string;\n  /** `billing.payBack`: the buyer closed the checkout. */\n  closed: string;\n  /** `common.back`: the link to the app's subscription page. */\n  back: string;\n  /** `legal.links.terms` and `legal.links.privacy`: the footer's links. */\n  terms: string;\n  privacy: string;\n  /** `legal.navLabel`: the footer's `<nav>`. */\n  legal: string;\n}\n\n/** The page's words, read from one of the kit's catalogues. @internal */\nexport function payPageStrings(labels: UiKitLabels): PayPageStrings {\n  return {\n    opening: labels.billing.payOpening,\n    nothing: labels.billing.payNothing,\n    failed: labels.billing.payFailed,\n    closed: labels.billing.payBack,\n    back: labels.common.back,\n    terms: labels.legal.links.terms,\n    privacy: labels.legal.links.privacy,\n    legal: labels.legal.navLabel,\n  };\n}\n\n/* ── pay-config.json ───────────────────────────────────────────────────────── */\n\n/** The configuration file beside the page, written at each app's web build. @internal */\nexport const PAY_CONFIG_FILE = \"pay-config.json\";\n\n/**\n * `pay-config.json`: what the page needs that differs per app and deployment. Read by\n * the page from its own origin — never from the query, where Paddle's own links (it\n * puts only `_ptxn` there) would lack it and a return URL would be an open redirect on\n * an approved payment domain. @internal\n */\nexport interface PayPageConfig {\n  /** Paddle's client-side token (`test_…` for the sandbox, `live_…` for live); null\n   *  while billing is off, and the page says `payNothing`. */\n  token: string | null;\n  environment: PaddleEnvironment | null;\n  /** The app's subscription page. Paddle.js's `successUrl` is\n   *  `checkoutReturnUrl(returnUrl)`; \"Back\" goes here. */\n  returnUrl: string;\n  appName: string;\n  termsUrl: string;\n  privacyUrl: string;\n}\n\n/** Paddle's client-side token prefixes, per environment. */\nconst TOKEN_PREFIX: Readonly<Record<PaddleEnvironment, string>> = { sandbox: \"test_\", live: \"live_\" };\n\n/** `https://`, or `http://` on this machine only (`localhost`, `127.0.0.1`, `[::1]`). */\nfunction isPageUrl(value: unknown): boolean {\n  if (typeof value !== \"string\") return false;\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol === \"https:\") return true;\n  return url.protocol === \"http:\" && [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname);\n}\n\n/**\n * What is wrong with a `pay-config.json`, one line each — `[]` when nothing is. The\n * build script refuses to write a file with any (so a wrong pairing fails the build,\n * not a buyer), and the page says `payFailed` for one it reads:\n *\n * - a token whose prefix disagrees with the environment (`test_` ↔ sandbox, `live_` ↔\n *   live), or a token without an environment;\n * - a return, terms or privacy URL that isn't `https://` (`http://` for localhost only);\n * - no app name. @internal\n */\nexport function payPageConfigProblems(config: unknown): string[] {\n  if (typeof config !== \"object\" || config === null) return [\"the configuration is not an object\"];\n  const c = config as Record<string, unknown>;\n  const problems: string[] = [];\n  const { token, environment } = c;\n  if (environment !== null && environment !== undefined && environment !== \"sandbox\" && environment !== \"live\") {\n    problems.push(`environment must be \"sandbox\" or \"live\", not ${JSON.stringify(environment)}`);\n  }\n  if (token !== null && token !== undefined) {\n    if (typeof token !== \"string\" || token === \"\") {\n      problems.push(\"token must be Paddle's client-side token, or null while billing is off\");\n    } else if (environment !== \"sandbox\" && environment !== \"live\") {\n      problems.push(\"a token needs its environment: sandbox or live\");\n    } else if (!token.startsWith(TOKEN_PREFIX[environment]) || token.length === TOKEN_PREFIX[environment].length) {\n      const other = environment === \"sandbox\" ? \"live\" : \"sandbox\";\n      problems.push(\n        token.startsWith(TOKEN_PREFIX[other])\n          ? `the token is a ${other} token (${TOKEN_PREFIX[other]}…), but the environment is ${environment}`\n          : `a ${environment} token starts with ${TOKEN_PREFIX[environment]}`,\n      );\n    }\n  }\n  for (const key of [\"returnUrl\", \"termsUrl\", \"privacyUrl\"] as const) {\n    if (!isPageUrl(c[key])) problems.push(`${key} must be an https:// URL (http:// for localhost only)`);\n  }\n  if (typeof c.appName !== \"string\" || c.appName.trim() === \"\") problems.push(\"appName is missing\");\n  return problems;\n}\n\n/** Paddle.js's `successUrl` for a configuration: the way back, `?checkout=done`. @internal */\nexport function paySuccessUrl(config: Pick<PayPageConfig, \"returnUrl\">): string {\n  return checkoutReturnUrl(config.returnUrl);\n}\n"],"mappings":";AACA,SAAS,yBAAyB;AAwB3B,MAAM,sBAAsB;AAGnC,MAAM,qBAAqB,CAAC,SAAS,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI;AAYvE,MAAM,iBAA4D;AAAA,EAChE,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AACN;AAGO,MAAM,6BAA6B;AAS1C,SAAS,cAAc,KAA2C;AAChE,MAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,QAAM,QAAQ,IAAI,KAAK,EAAE,QAAQ,MAAM,GAAG;AAC1C,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,MAAM,YAAY;AAChC,QAAM,QAAQ,mBAAmB,KAAK,CAAC,SAAS,KAAK,YAAY,MAAM,KAAK;AAC5E,MAAI,MAAO,QAAO;AAClB,QAAM,WAAW,MAAM,MAAM,GAAG,EAAE,CAAC;AACnC,SAAO,mBAAmB,KAAK,CAAC,SAAS,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,YAAY,MAAM,QAAQ;AACxF;AASO,SAAS,aAAa,WAAuC;AAClE,SAAO,eAAe,cAAc,SAAS,KAAK,IAAI;AACxD;AAgBO,SAAS,WAAW,aAAqB,QAAoC;AAClF,QAAM,WAAW,cAAc,MAAM;AACrC,MAAI,CAAC,SAAU,QAAO;AACtB,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,WAAW;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAI,aAAa,IAAI,0BAA0B,EAAG,QAAO;AAC9D,MAAI,aAAa,IAAI,qBAAqB,QAAQ;AAClD,SAAO,IAAI,SAAS;AACtB;AAMO,SAAS,gBACd,MACA,mBAAsC,CAAC,GACtB;AACjB,aAAW,aAAa,CAAC,MAAM,GAAG,gBAAgB,GAAG;AACnD,UAAM,QAAQ,cAAc,SAAS;AACrC,QAAI,MAAO,QAAO;AAAA,EACpB;AACA,SAAO;AACT;AA2BO,SAAS,eAAe,QAAqC;AAClE,SAAO;AAAA,IACL,SAAS,OAAO,QAAQ;AAAA,IACxB,SAAS,OAAO,QAAQ;AAAA,IACxB,QAAQ,OAAO,QAAQ;AAAA,IACvB,QAAQ,OAAO,QAAQ;AAAA,IACvB,MAAM,OAAO,OAAO;AAAA,IACpB,OAAO,OAAO,MAAM,MAAM;AAAA,IAC1B,SAAS,OAAO,MAAM,MAAM;AAAA,IAC5B,OAAO,OAAO,MAAM;AAAA,EACtB;AACF;AAKO,MAAM,kBAAkB;AAsB/B,MAAM,eAA4D,EAAE,SAAS,SAAS,MAAM,QAAQ;AAGpG,SAAS,UAAU,OAAyB;AAC1C,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,KAAK;AAAA,EACrB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,IAAI,aAAa,SAAU,QAAO;AACtC,SAAO,IAAI,aAAa,WAAW,CAAC,aAAa,aAAa,OAAO,EAAE,SAAS,IAAI,QAAQ;AAC9F;AAYO,SAAS,sBAAsB,QAA2B;AAC/D,MAAI,OAAO,WAAW,YAAY,WAAW,KAAM,QAAO,CAAC,oCAAoC;AAC/F,QAAM,IAAI;AACV,QAAM,WAAqB,CAAC;AAC5B,QAAM,EAAE,OAAO,YAAY,IAAI;AAC/B,MAAI,gBAAgB,QAAQ,gBAAgB,UAAa,gBAAgB,aAAa,gBAAgB,QAAQ;AAC5G,aAAS,KAAK,gDAAgD,KAAK,UAAU,WAAW,CAAC,EAAE;AAAA,EAC7F;AACA,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,QAAI,OAAO,UAAU,YAAY,UAAU,IAAI;AAC7C,eAAS,KAAK,wEAAwE;AAAA,IACxF,WAAW,gBAAgB,aAAa,gBAAgB,QAAQ;AAC9D,eAAS,KAAK,gDAAgD;AAAA,IAChE,WAAW,CAAC,MAAM,WAAW,aAAa,WAAW,CAAC,KAAK,MAAM,WAAW,aAAa,WAAW,EAAE,QAAQ;AAC5G,YAAM,QAAQ,gBAAgB,YAAY,SAAS;AACnD,eAAS;AAAA,QACP,MAAM,WAAW,aAAa,KAAK,CAAC,IAChC,kBAAkB,KAAK,WAAW,aAAa,KAAK,CAAC,mCAA8B,WAAW,KAC9F,KAAK,WAAW,sBAAsB,aAAa,WAAW,CAAC;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACA,aAAW,OAAO,CAAC,aAAa,YAAY,YAAY,GAAY;AAClE,QAAI,CAAC,UAAU,EAAE,GAAG,CAAC,EAAG,UAAS,KAAK,GAAG,GAAG,uDAAuD;AAAA,EACrG;AACA,MAAI,OAAO,EAAE,YAAY,YAAY,EAAE,QAAQ,KAAK,MAAM,GAAI,UAAS,KAAK,oBAAoB;AAChG,SAAO;AACT;AAGO,SAAS,cAAc,QAAkD;AAC9E,SAAO,kBAAkB,OAAO,SAAS;AAC3C;","names":[]}