@eifi1/ui-kit 0.32.2 → 0.33.0

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

@@ -0,0 +1,210 @@
+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';
+
+/**
+ * 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
+ * its own pay host, `pay.<app domain>` — a separate origin, approved in Paddle, where
+ * Paddle.js shares the origin with nothing: no sign-in, no app code, no storage.
+ *
+ * Paddle's create-transaction answers `checkout.url`: the pay page's URL plus
+ * `?_ptxn=<txn>`, and Paddle.js on that page opens the transaction by itself. The app
+ * sends the buyer there with {@link payPageUrl}, which adds the buyer's language; the
+ * page maps it to Paddle's checkout locale ({@link paddleLocale}). Everything else the
+ * page needs — the client-side token, sandbox or live, the way back — is the app's
+ * `pay-config.json`, written at its web build by the `eifi1-pay-page` script.
+ *
+ * Pure, and React-free: the page's own script (`pay-page/pay.ts`) and that build script
+ * bundle this module. The exports below the barrel's four are theirs.
+ */
+/** Paddle's two environments: the sandbox's client-side tokens start `test_`, live
+ *  ones `live_`. */
+type PaddleEnvironment = "sandbox" | "live";
+/** The pay page's language parameter: `?lang=<kit locale>`. */
+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];
+/** Paddle's transaction parameter on a pay page link. @internal */
+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.
+ */
+declare function paddleLocale(kitLocale: string): 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
+ * own `locale` — unchanged, as is a locale the kit doesn't ship.
+ *
+ *     const { url } = await api.checkout({ plan, interval, currency });
+ *     noteCheckoutStarted(user.id, overview);
+ *     window.location.assign(payPageUrl(url, i18n.language));
+ *
+ * A wrong `lang` costs nothing but the language: the page falls back to the browser's.
+ */
+declare function payPageUrl(checkoutUrl: string, locale: string): 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;
+/**
+ * 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 {
+    /** `billing.payOpening`, while the checkout opens. */
+    opening: string;
+    /** `billing.payNothing`: no `_ptxn`, or no token (billing off). */
+    nothing: string;
+    /** `billing.payFailed`: Paddle.js didn't load, or the configuration is wrong. */
+    failed: string;
+    /** `billing.payBack`: the buyer closed the checkout. */
+    closed: string;
+    /** `common.back`: the link to the app's subscription page. */
+    back: string;
+    /** `legal.links.terms` and `legal.links.privacy`: the footer's links. */
+    terms: string;
+    privacy: string;
+    /** `legal.navLabel`: the footer's `<nav>`. */
+    legal: string;
+}
+/** The page's words, read from one of the kit's catalogues. @internal */
+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";
+/**
+ * `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 {
+    /** 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;
+    environment: PaddleEnvironment | null;
+    /** The app's subscription page. Paddle.js's `successUrl` is
+     *  `checkoutReturnUrl(returnUrl)`; "Back" goes here. */
+    returnUrl: string;
+    appName: string;
+    termsUrl: string;
+    privacyUrl: string;
+}
+/**
+ * What is wrong with a `pay-config.json`, one line each — `[]` when nothing is. The
+ * build script refuses to write a file with any (so a wrong pairing fails the build,
+ * not a buyer), and the page says `payFailed` for one it reads:
+ *
+ * - a token whose prefix disagrees with the environment (`test_` ↔ sandbox, `live_` ↔
+ *   live), or a token without an environment;
+ * - a return, terms or privacy URL that isn't `https://` (`http://` for localhost only);
+ * - no app name. @internal
+ */
+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 };

package/dist/billing/pay-page.js

@@ -0,0 +1,113 @@
+"use client";
+import { checkoutReturnUrl } from "./checkout-return.js";
+const PAY_PAGE_LANG_PARAM = "lang";
+const PAY_PAGE_LANGUAGES = ["de-CH", "en", "es", "fr", "it", "hu", "zh"];
+const PADDLE_LOCALES = {
+  en: "en",
+  "de-CH": "de",
+  fr: "fr",
+  it: "it",
+  es: "es",
+  zh: "zh-Hans",
+  hu: "en"
+};
+const PAY_PAGE_TRANSACTION_PARAM = "_ptxn";
+function kitLanguageOf(tag) {
+  if (typeof tag !== "string") return void 0;
+  const clean = tag.trim().replace(/_/g, "-");
+  if (!clean) return void 0;
+  const lower = clean.toLowerCase();
+  const exact = PAY_PAGE_LANGUAGES.find((code) => code.toLowerCase() === lower);
+  if (exact) return exact;
+  const language = lower.split("-")[0];
+  return PAY_PAGE_LANGUAGES.find((code) => code.split("-")[0].toLowerCase() === language);
+}
+function paddleLocale(kitLocale) {
+  return PADDLE_LOCALES[kitLanguageOf(kitLocale) ?? "en"];
+}
+function payPageUrl(checkoutUrl, locale) {
+  const language = kitLanguageOf(locale);
+  if (!language) return checkoutUrl;
+  let url;
+  try {
+    url = new URL(checkoutUrl);
+  } catch {
+    return checkoutUrl;
+  }
+  if (!url.searchParams.has(PAY_PAGE_TRANSACTION_PARAM)) return checkoutUrl;
+  url.searchParams.set(PAY_PAGE_LANG_PARAM, language);
+  return url.toString();
+}
+function payPageLanguage(lang, browserLanguages = []) {
+  for (const candidate of [lang, ...browserLanguages]) {
+    const found = kitLanguageOf(candidate);
+    if (found) return found;
+  }
+  return "en";
+}
+function payPageStrings(labels) {
+  return {
+    opening: labels.billing.payOpening,
+    nothing: labels.billing.payNothing,
+    failed: labels.billing.payFailed,
+    closed: labels.billing.payBack,
+    back: labels.common.back,
+    terms: labels.legal.links.terms,
+    privacy: labels.legal.links.privacy,
+    legal: labels.legal.navLabel
+  };
+}
+const PAY_CONFIG_FILE = "pay-config.json";
+const TOKEN_PREFIX = { sandbox: "test_", live: "live_" };
+function isPageUrl(value) {
+  if (typeof value !== "string") return false;
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    return false;
+  }
+  if (url.protocol === "https:") return true;
+  return url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname);
+}
+function payPageConfigProblems(config) {
+  if (typeof config !== "object" || config === null) return ["the configuration is not an object"];
+  const c = config;
+  const problems = [];
+  const { token, environment } = c;
+  if (environment !== null && environment !== void 0 && environment !== "sandbox" && environment !== "live") {
+    problems.push(`environment must be "sandbox" or "live", not ${JSON.stringify(environment)}`);
+  }
+  if (token !== null && token !== void 0) {
+    if (typeof token !== "string" || token === "") {
+      problems.push("token must be Paddle's client-side token, or null while billing is off");
+    } else if (environment !== "sandbox" && environment !== "live") {
+      problems.push("a token needs its environment: sandbox or live");
+    } else if (!token.startsWith(TOKEN_PREFIX[environment]) || token.length === TOKEN_PREFIX[environment].length) {
+      const other = environment === "sandbox" ? "live" : "sandbox";
+      problems.push(
+        token.startsWith(TOKEN_PREFIX[other]) ? `the token is a ${other} token (${TOKEN_PREFIX[other]}\u2026), but the environment is ${environment}` : `a ${environment} token starts with ${TOKEN_PREFIX[environment]}`
+      );
+    }
+  }
+  for (const key of ["returnUrl", "termsUrl", "privacyUrl"]) {
+    if (!isPageUrl(c[key])) problems.push(`${key} must be an https:// URL (http:// for localhost only)`);
+  }
+  if (typeof c.appName !== "string" || c.appName.trim() === "") problems.push("appName is missing");
+  return problems;
+}
+function paySuccessUrl(config) {
+  return checkoutReturnUrl(config.returnUrl);
+}
+export {
+  PAY_CONFIG_FILE,
+  PAY_PAGE_LANG_PARAM,
+  PAY_PAGE_TRANSACTION_PARAM,
+  paddleLocale,
+  payPageConfigProblems,
+  payPageLanguage,
+  payPageStrings,
+  payPageUrl,
+  paySuccessUrl
+};
+//# sourceMappingURL=pay-page.js.map

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

@@ -0,0 +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":[]}

package/dist/billing/plan-card.d.ts

@@ -1,21 +1,26 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { e4 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-Dy4kJgUm.js';
+import { e5 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-DiPX4Vue.js';
 import { ChoiceCardProps } from '../components/choice-card.js';
 import { PlanPrices, BillingCurrency, BillingInterval } from './plan-price.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';
-import '../data-table-labels-kpAAVi6g.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/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
 import '../components/field-sync.js';
 import '../wizard/types.js';
 import '../tour/tour.js';
@@ -27,7 +32,6 @@ import '../components/page-contents.js';
 import '../components/series-chart-labels.js';
 import '../components/pie-chart-labels.js';
 import '../components/sparkline.js';
-import '../components/stat-tile.js';
 import '../components/signature-pad.js';
 import '../components/password-strength.js';
 import '../components/swatch-picker.js';
@@ -39,9 +43,6 @@ import '../hooks/use-search-param-state.js';
 import '../components/measured-grid.js';
 import '../components/user-avatar.js';
 import '../lib/person-name.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
 import '../shell/topbar-action-menu.js';
 import '../components/menu-item.js';
 import '../components/floating-panel.js';
@@ -57,7 +58,6 @@ import '../components/error-boundary.js';
 import '../components/authed-image.js';
 import '../components/image-grid.js';
 import '../components/lightbox.js';
-import '../components/write-lock.js';
 import '../auth/sign-in-form.js';
 import '../landing/access.js';
 import '../landing/landing-labels.js';

package/dist/billing/plan-limit-notice.d.ts

@@ -1,20 +1,25 @@
 import * as react from 'react';
 import { ComponentPropsWithoutRef } from 'react';
-import { e4 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-Dy4kJgUm.js';
+import { e5 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-DiPX4Vue.js';
 import { AlertTone } from '../components/alert-banner.js';
 import '../components/tooltip.js';
 import '../hooks/use-anchored-rect.js';
 import '../lib/clipping.js';
-import '../data-table-labels-kpAAVi6g.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/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
 import '../components/field-sync.js';
 import '../wizard/types.js';
 import '../tour/tour.js';
@@ -26,7 +31,6 @@ import '../components/page-contents.js';
 import '../components/series-chart-labels.js';
 import '../components/pie-chart-labels.js';
 import '../components/sparkline.js';
-import '../components/stat-tile.js';
 import '../components/signature-pad.js';
 import '../components/password-strength.js';
 import '../components/swatch-picker.js';
@@ -38,9 +42,6 @@ import '../hooks/use-search-param-state.js';
 import '../components/measured-grid.js';
 import '../components/user-avatar.js';
 import '../lib/person-name.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
 import '../shell/topbar-action-menu.js';
 import '../components/menu-item.js';
 import '../components/floating-panel.js';
@@ -56,7 +57,6 @@ import '../components/error-boundary.js';
 import '../components/authed-image.js';
 import '../components/image-grid.js';
 import '../components/lightbox.js';
-import '../components/write-lock.js';
 import '../auth/sign-in-form.js';
 import '../landing/access.js';
 import '../landing/landing-labels.js';

package/dist/billing/plan-limit-toast.d.ts

@@ -0,0 +1,143 @@
+import { e5 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-DiPX4Vue.js';
+import { ToastId } from '../components/toast.js';
+import { PlanLimitRefusal } from './plan-limit.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/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';
+
+interface PlanLimitToastOptions {
+    /** `upgrade`: plans are bought — "Choose a plan". `contact`: the operator grants them
+     *  by hand — "Ask for more", a mail to support. */
+    mode: "upgrade" | "contact";
+    /** `upgrade`: the app's navigation to its subscription page (the kit has no router).
+     *  Left out, the toast has no action. */
+    onChoosePlan?: () => void;
+    /** `contact`: support@ the app's domain, opened as `planLimitMailto(email,
+     *  contactSubject(name))`. Left out, the toast has no action. */
+    email?: string;
+    /** The app's word per dimension: `{ budgets: "Budgets", scans: "Scans this month" }`.
+     *  A dimension without one is named by its key. */
+    dimensionLabels?: Readonly<Record<string, string>>;
+    /** How a figure is written — kastlan's storage limit is bytes. Default: a number in
+     *  the kit's locale. */
+    formatValue?: (dimension: string, value: number) => string;
+    /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */
+    labels?: LabelOverride<BillingLabels>;
+}
+/**
+ * `PlanLimitNotice`'s words as a toast (docs/billing-harmonization.md §14.11), for a
+ * refused create with no room for the notice — a row's button, a share target: "Plan
+ * limit reached", what to do, the figure when the refusal has one ("Budgets: 3 of 3"),
+ * and the mode's action.
+ *
+ *     const showLimit = usePlanLimitToast({
+ *       mode: "upgrade",
+ *       onChoosePlan: () => navigate("/settings/subscription"),
+ *       dimensionLabels: { budgets: t("billing.dim_budgets") },
+ *     });
+ *     catch (err) { const hit = isPlanLimit(err); if (hit) showLimit(hit); }
+ *
+ * One toast per dimension: its id is `plan-limit:<dimension>`, so a repeat replaces it
+ * in place instead of stacking a second (keksdose's own hook stacked). Called with no
+ * hit, it says the words without a figure, under `plan-limit`. No `limit` in the
+ * refusal, no figure line; keksdose's legacy `plan_budget_limit` reads as `budgets`
+ * (`isPlanLimit`, §12.16). Returns the toast's id.
+ */
+declare function usePlanLimitToast(options: PlanLimitToastOptions): (hit?: PlanLimitRefusal) => ToastId;
+
+export { type PlanLimitToastOptions, usePlanLimitToast };

package/dist/billing/plan-limit-toast.js

@@ -0,0 +1,40 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback } from "react";
+import { useKitLocale } from "../i18n/kit-labels.js";
+import { documentNavigation } from "../lib/document-navigation.js";
+import { formatNumber } from "../lib/format.js";
+import { toast } from "../components/toast.js";
+import { useBillingLabels } from "./billing-labels.js";
+import { planLimitMailto } from "./plan-limit-notice.js";
+function usePlanLimitToast(options) {
+  const { mode, onChoosePlan, email, dimensionLabels, formatValue, labels: labelsProp } = options;
+  const labels = useBillingLabels(labelsProp);
+  const locale = useKitLocale();
+  return useCallback(
+    (hit) => {
+      const dimension = hit?.dimension ?? "";
+      const name = dimensionLabels?.[dimension] ?? dimension;
+      const figure = (value) => formatValue ? formatValue(dimension, value) : formatNumber(value, { locale });
+      const usage = hit?.limit !== void 0 ? labels.limitUsageLine(name, figure(hit.used ?? hit.limit), figure(hit.limit)) : void 0;
+      const action = mode === "upgrade" ? onChoosePlan && { label: labels.choosePlan, onClick: () => onChoosePlan() } : email ? {
+        label: labels.askForMore,
+        // A mailto: hands the address to the reader's mail client; the page stays.
+        onClick: () => documentNavigation.replace(planLimitMailto(email, labels.contactSubject(name)))
+      } : void 0;
+      return toast.warning(labels.limitReached, {
+        id: dimension ? `plan-limit:${dimension}` : "plan-limit",
+        description: /* @__PURE__ */ jsxs("span", { "data-plan-limit-mode": mode, "data-dimension": dimension || void 0, children: [
+          /* @__PURE__ */ jsx("span", { className: "block", children: mode === "upgrade" ? labels.limitUpgrade : labels.limitContact }),
+          usage !== void 0 && /* @__PURE__ */ jsx("span", { className: "block tabular-nums", children: usage })
+        ] }),
+        action
+      });
+    },
+    [mode, onChoosePlan, email, dimensionLabels, formatValue, labels, locale]
+  );
+}
+export {
+  usePlanLimitToast
+};
+//# sourceMappingURL=plan-limit-toast.js.map