@eifi1/ui-kit 0.54.0 → 0.55.0

package/src/billing/billing-banner.tsx

@@ -1,258 +0,0 @@
-import type { ComponentPropsWithRef, ReactNode } from "react";
-import { CreditCard, Hourglass, PencilOff } from "lucide-react";
-
-import { DEFAULT_COMMON_LABELS, useKitLabels } from "../i18n/kit-labels";
-import type { LabelOverride } from "../i18n/kit-labels";
-import { AlertBanner } from "../components/alert-banner";
-import type { AlertSize, AlertTone } from "../components/alert-banner";
-import { Button } from "../components/button";
-import { Spinner } from "../components/spinner";
-import { useBillingLabels } from "./billing-labels";
-import type { BillingLabels } from "./billing-labels";
-import type { BillingPortalAccess } from "./billing-overview";
-import { ExternalMark } from "./subscription-actions";
-
-/**
- * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):
- *
- * - `trial-ending` — from 7 days before `trial_ends_at` (§3.3);
- * - `grant-ending` — from 7 days before `comped_until`: a beta user's 12 months, an
- *   operator's grant;
- * - `payment-failed` — from the first failed payment (`past_due`), while the provider
- *   retries; since 0.42, for an admin who isn't the buyer (`portal="buyer_only"`), it
- *   names who can update the payment method, with no button;
- * - `plan-ended` — out of good standing: read-only, never locked (§2.3);
- * - `guest` — a guest in someone else's read-only item (§12.6);
- * - `processing` — back from checkout before the webhook landed (§12.21).
- */
-export type BillingBannerKind =
-  "trial-ending" | "grant-ending" | "payment-failed" | "plan-ended" | "guest" | "processing";
-
-/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they
- *  go on to the {@link AlertBanner}, so the ref is the banner's `<div>` — with an × too,
- *  since the banner has no `href` or `onClick` that would make its row a link or a button. */
-interface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<"div">, "children" | "onClick"> {
-  /**
-   * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last
-   * three days and `warning` in them; `payment-failed` is `danger` (money did not
-   * arrive — kastlan's past-due strip was red); `plan-ended` is `warning`, a state with
-   * everything still there rather than an error; `guest` and `processing` are `info`.
-   */
-  tone?: AlertTone;
-  /** `strip` (default): the band under the top bar, on every page. `box`: the same
-   *  message on the subscription page itself. */
-  variant?: "strip" | "box";
-  /** Default `sm` for a strip (the demo's banner), `md` for a box. */
-  size?: AlertSize;
-  /**
-   * Where the action goes — the subscription page, say. The app's action, as an `href`
-   * or as {@link onAction}; without either there is no button. Never a write-locked
-   * commit: billing itself always works (§3.3).
-   */
-  actionHref?: string;
-  /** What the action does — the app's portal call (`POST /billing/portal`, then off to
-   *  its `url`): for `payment-failed` with `{target: "payment_method"}`, the portal's
-   *  page for the card (§14.5); for `processing`, `useCheckoutProcessing`'s
-   *  `checkAgain`. The kit sends no request. */
-  onAction?: () => void;
-  /**
-   * Over the kind's action words: "Choose a plan" (trial, grant, plan ended), "Update
-   * payment method" (payment failed), "Check again" (processing). The guest banner has
-   * none of its own: an action there needs this.
-   */
-  actionLabel?: string;
-  /** The action is under way: the button's spinner, no second press. */
-  actionPending?: boolean;
-  /**
-   * 0.43 (§17): the action opens the provider's portal in a NEW TAB (`openProviderPage`
-   * in {@link onAction}): the external-link mark, "(opens in a new tab)" for a reader,
-   * and `target="_blank"` on an {@link actionHref}. Default: true for `payment-failed`
-   * with `onAction` (the portal's card page), false otherwise — an `actionHref` is
-   * usually the app's own subscription page.
-   */
-  actionNewTab?: boolean;
-  /** An × that calls this; the app removes the banner and remembers that it did. */
-  onDismiss?: () => void;
-  dismissLabel?: string;
-  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */
-  labels?: LabelOverride<BillingLabels>;
-}
-
-export type BillingBannerProps = BillingBannerBaseProps &
-  (
-    | {
-        kind: "trial-ending" | "grant-ending";
-        /** Calendar days left — `billingDaysLeft(trial_ends_at)`. 0 is today. */
-        daysLeft: number;
-        item?: never;
-        portal?: never;
-        buyerName?: never;
-      }
-    | {
-        kind: "guest";
-        /** The item's own name ("Household 2026"), or nothing. NEVER the owner's status:
-         *  the banner says "for now" and nothing more (§12.6). */
-        item?: string;
-        daysLeft?: never;
-        portal?: never;
-        buyerName?: never;
-      }
-    | {
-        kind: "payment-failed";
-        /**
-         * 0.42 (§16.7 A, §16.8): `GET /billing/status`'s `portal` (`BillingStanding`).
-         * `"buyer_only"` — the viewer isn't the buyer, so the portal's page for the card
-         * would answer 403: the banner says who can update the payment method
-         * (`paymentFailedAskBuyer`) and shows NO button, whatever `actionHref` or
-         * `onAction` say. `"open"` (default): as before.
-         */
-        portal?: BillingPortalAccess;
-        /** 0.42: the status's `buyer_name`, under `"buyer_only"`. Empty: "…the admin who
-         *  bought the subscription". */
-        buyerName?: string | null;
-        daysLeft?: never;
-        item?: never;
-      }
-    | {
-        kind: "plan-ended" | "processing";
-        daysLeft?: never;
-        item?: never;
-        portal?: never;
-        buyerName?: never;
-      }
-  );
-
-/** The last days, in which an ending trial or grant turns from news into a warning. */
-const LAST_DAYS = 3;
-
-function defaultTone(kind: BillingBannerKind, daysLeft: number | undefined): AlertTone {
-  switch (kind) {
-    case "trial-ending":
-    case "grant-ending":
-      return (daysLeft ?? 0) > LAST_DAYS ? "info" : "warning";
-    case "payment-failed":
-      return "danger";
-    case "plan-ended":
-      return "warning";
-    default:
-      return "info";
-  }
-}
-
-/**
- * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its
- * glyph and tone, and the app's action. Carries `data-billing-banner` with the kind.
- *
- * The app decides WHICH banner shows, from `GET /billing/overview` (and hides all of them
- * while billing is off, §4); the kit only says it. A guest's banner takes no status at
- * all — the type does not let one in — so the owner's payment state cannot leak into it
- * by a wrong prop (§12.6).
- *
- * `processing` is a live region (`role="status"`): it appears when the person comes back
- * from checkout and goes when the overview catches up (§12.21), and a screen reader
- * should hear both. The others are page furniture, role-less as the strip is.
- */
-export function BillingBanner(props: BillingBannerProps) {
-  const {
-    kind,
-    daysLeft,
-    item,
-    portal,
-    buyerName,
-    tone,
-    variant = "strip",
-    size,
-    actionHref,
-    onAction,
-    actionLabel,
-    actionPending,
-    actionNewTab,
-    onDismiss,
-    dismissLabel,
-    labels: labelsProp,
-    role,
-    ...rest
-  } = props;
-  const labels = useBillingLabels(labelsProp);
-  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
-  const days = Math.max(0, Math.floor(daysLeft ?? 0));
-
-  let text: string;
-  let icon: ReactNode;
-  let ownAction: string | undefined;
-  // 0.42 (§16.7 A): only the buyer can reach the portal's card page.
-  const askBuyer = kind === "payment-failed" && portal === "buyer_only";
-  switch (kind) {
-    case "trial-ending":
-      text = labels.trialEnding(days);
-      icon = <Hourglass />;
-      ownAction = labels.choosePlan;
-      break;
-    case "grant-ending":
-      text = labels.grantEnding(days);
-      icon = <Hourglass />;
-      ownAction = labels.choosePlan;
-      break;
-    case "payment-failed":
-      text = askBuyer ? labels.paymentFailedAskBuyer(buyerName || undefined) : labels.paymentFailed;
-      icon = <CreditCard />;
-      ownAction = labels.updatePayment;
-      break;
-    case "plan-ended":
-      text = labels.planEnded;
-      icon = <PencilOff />;
-      ownAction = labels.choosePlan;
-      break;
-    case "guest":
-      text = labels.guestReadOnly(item);
-      icon = <PencilOff />;
-      ownAction = undefined;
-      break;
-    case "processing":
-      text = labels.processing;
-      icon = <Spinner label={null} />;
-      ownAction = labels.checkAgain;
-      break;
-  }
-
-  const words = actionLabel ?? ownAction;
-  const newTab = actionNewTab ?? (kind === "payment-failed" && actionHref === undefined && onAction !== undefined);
-  const action =
-    askBuyer || words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !==
-      undefined ? (
-      <Button href={actionHref} variant="secondary" size="sm" external={newTab || undefined}>
-        {words}
-        {newTab && <ExternalMark />}
-      </Button>
-    ) : (
-      <Button
-        type="button"
-        variant="secondary"
-        size="sm"
-        onClick={onAction}
-        pending={actionPending}
-        className={newTab ? "relative" : undefined}
-        data-portal-action={newTab ? "payment_method" : undefined}
-      >
-        {words}
-        {newTab && <ExternalMark reader={common.opensInNewTab} />}
-      </Button>
-    );
-
-  return (
-    <AlertBanner
-      {...rest}
-      role={role ?? (kind === "processing" ? "status" : undefined)}
-      variant={variant}
-      size={size ?? (variant === "strip" ? "sm" : "md")}
-      tone={tone ?? defaultTone(kind, days)}
-      icon={icon}
-      action={action}
-      onDismiss={onDismiss}
-      dismissLabel={dismissLabel}
-      data-billing-banner={kind}
-    >
-      {text}
-    </AlertBanner>
-  );
-}

package/src/billing/billing-labels.ts

@@ -1,381 +0,0 @@
-import { useKitLabels } from "../i18n/kit-labels";
-import type { LabelOverride } from "../i18n/kit-labels";
-
-/**
- * The subscription's status vocabulary (docs/billing-harmonization.md §3.2) — server-kit's
- * `SubscriptionStatus`, value for value:
- *
- * - `trialing` — the 30-day trial without a card (§2.7), or a pure guest's row whose trial
- *   has not started (§12.9, `trial_ends_at` empty);
- * - `active` — paid;
- * - `past_due` — a payment failed; in good standing during the provider's retries (§3.3);
- * - `canceled` — the payer cancelled; the American spelling is the wire's, the word shown
- *   is "Cancelled";
- * - `expired` — a trial, a grant or a failed subscription ran out: read-only (§2.3);
- * - `comped` — free by the operator's grant or as a beta user (§3.2, `comped_until`).
- */
-export type SubscriptionStatus = "trialing" | "active" | "past_due" | "canceled" | "expired" | "comped";
-
-/** Every status, in the order a lifecycle reads: trial, paid, trouble, ended, granted. */
-export const SUBSCRIPTION_STATUSES: readonly SubscriptionStatus[] = Object.freeze([
-  "trialing",
-  "active",
-  "past_due",
-  "canceled",
-  "expired",
-  "comped",
-]);
-
-/**
- * The words of the subscription parts — the `billing` namespace of `<UiKitProvider labels>`
- * (docs/billing-harmonization.md §7, §10; ui-kit 0.32.0).
- *
- * WORDING (§12.24): the English group is "Subscription", never "Plan" — keksdose's "plan"
- * is the month's budget plan ("One plan per month"), and two meanings of one word on one
- * settings page is the clash the review found. "Plan" stays the word for WHAT is bought
- * (Free, Pro), "subscription" for the standing arrangement. German says "Tarif" for the
- * plan and "Abonnement" for the subscription (§10).
- *
- * Prices are GROSS (§12.17): Swiss consumer law (PBV) wants a consumer price with the
- * MWST in it, so the cards say so (`vatIncluded`).
- */
-export interface BillingLabels {
-  /** The settings group or admin section the parts live on (§7, §12.24): "Subscription". */
-  group: string;
-
-  /* ── PlanPicker / PlanCard (§7) ── */
-  /** The picker's name when it has no visible `legend`: "Plans". */
-  plans: string;
-  /** The name of the billing-period switch: "Billing period". */
-  interval: string;
-  /** The switch's two options — yearly first (§12.17). */
-  yearly: string;
-  monthly: string;
-  /** The name of the currency switch: "Currency". */
-  currency: string;
-  /** After a price: "per year", "per month". */
-  perYear: string;
-  perMonth: string;
-  /** Under a price (§12.17): "VAT included". German: "inkl. MWST". */
-  vatIncluded: string;
-  /** A plan with no price, or a price of 0: "Free". */
-  free: string;
-  /** A plan with prices, but none for this currency and period. */
-  notOffered: string;
-  /** A limit of `null` (§3.1): "Unlimited". */
-  unlimited: string;
-  /** The accessible names of a card's two lists. */
-  limits: string;
-  features: string;
-  /** The chip on the payer's current plan. */
-  current: string;
-  /** The picker's button for `plan` (the plan's display name) with no current plan —
-   *  during a trial, or after a plan ended: "Choose Pro". */
-  choose: (plan: string) => string;
-  /** …for a plan after the current one in the catalogue's order: "Upgrade to Pro". */
-  upgrade: (plan: string) => string;
-  /** …for a plan before it: "Switch to Free". */
-  downgrade: (plan: string) => string;
-  /** Why the button is off while the current plan is the one picked. */
-  isCurrent: string;
-  /** Why it is off while nothing is picked. */
-  pickFirst: string;
-
-  /* ── SubscriptionStatusChip (§6) ── */
-  /** One word per status. */
-  status: Record<SubscriptionStatus, string>;
-
-  /* ── BillingBanner (§3.3, §12.6, §12.21) ── */
-  /** A trial ends in `days` calendar days — 0 is today, 1 tomorrow. */
-  trialEnding: (days: number) => string;
-  /** A free grant (`comped_until`: a beta user's 12 months, an operator's grant) ends in
-   *  `days` calendar days. */
-  grantEnding: (days: number) => string;
-  /** The first failed payment (`past_due`), while the provider retries. */
-  paymentFailed: string;
-  /** Out of good standing: read-only, never locked (§2.3). */
-  planEnded: string;
-  /**
-   * A guest in someone else's item that is read-only for billing (§12.6). It never says
-   * WHY beyond "for now": the owner's payment status is the owner's personal data.
-   * `item` is the item's own name ("Household 2026"), shown in quotes — or `undefined`.
-   */
-  guestReadOnly: (item?: string) => string;
-  /** Back from checkout before the provider's webhook landed (§12.21). */
-  processing: string;
-  /** The action of the trial, grant and plan-ended banners, and of `PlanLimitNotice`'s
-   *  `upgrade` mode: "Choose a plan". */
-  choosePlan: string;
-  /** The payment-failed banner's action, to the provider's portal: "Update payment method". */
-  updatePayment: string;
-  /**
-   * 0.42 (§16.7 A, §16.8): the payment-failed banner for an admin who isn't the buyer
-   * (`portal: "buyer_only"`), with no button — only the buyer can change the card.
-   * `buyer` is their display name, or `undefined` when they are gone ("the admin who
-   * bought the subscription").
-   */
-  paymentFailedAskBuyer: (buyer?: string) => string;
-  /** The processing banner's action, when the app gives one: "Check again". */
-  checkAgain: string;
-
-  /* ── The read-only lock (§3.3, §12.6) ── */
-  /** The `WriteLockProvider` reason for the payer (§3.3, verbatim). A guest's reason is
-   *  {@link guestReadOnly}. */
-  lockReason: string;
-
-  /* ── PlanLimitNotice (§3.4) ── */
-  /** The notice's first line: "Plan limit reached". */
-  limitReached: string;
-  /** Mode `upgrade`: what the action does. */
-  limitUpgrade: string;
-  /** Mode `contact` (the operator grants plans by hand, keksdose's today). */
-  limitContact: string;
-  /** Mode `contact`'s action, a mail to support: "Ask for more". */
-  askForMore: string;
-  /** The meter's value: "3 of 3". Both figures are formatted already. */
-  usage: (used: string, limit: string) => string;
-  /** The subject of the `contact` mail; `dimension` is the app's name for it ("Budgets"). */
-  contactSubject: (dimension: string) => string;
-  /**
-   * The figure line of the limit's toast (`usePlanLimitToast`, §14.11) and of an
-   * operator's plan change over the new limit (§14.12): "Budgets: 3 of 3". A key of its
-   * own rather than `${dimension}: ${usage}`, because French puts a space before the
-   * colon. Both figures are formatted already.
-   */
-  limitUsageLine: (dimension: string, used: string, limit: string) => string;
-
-  /* ── The provider's portal (§7, §12.26) ── */
-  /** The portal: payment method and invoices (§2.8, the provider hosts both). */
-  manage: string;
-  /**
-   * The visible cancel link on the app's subscription page (§12.26). German: §312k BGB
-   * wants the button that leads to the cancellation labelled "Verträge hier kündigen" or
-   * as unambiguously — a translator should use exactly that.
-   */
-  cancel: string;
-  /**
-   * In place of both while the payer hasn't reached the provider (the overview's
-   * `at_provider` is false, §14.5): there is no customer to open a portal for yet. Also
-   * the words for `409 billing_not_at_provider`, a stale page that asked anyway.
-   */
-  notAtProvider: string;
-
-  /* ── The portal for the buyer only, the in-app cancel (0.42, §16) ── */
-  /**
-   * In place of "Payment and invoices" for an admin who isn't the buyer (`portal:
-   * "buyer_only"`, §16.2 decision 3): the provider's portal opens only for the buyer.
-   * `buyer` is their display name — or `undefined` when they are gone or have left the
-   * company, and the words then say "the admin who bought the subscription".
-   */
-  buyerHolds: (buyer?: string) => string;
-  /** `CancelSubscriptionConfirm`'s title: "Cancel subscription". */
-  cancelConfirmTitle: string;
-  /** Its body; `date` is the period's end, formatted: "Your subscription ends on
-   *  9 Nov 2026. Until then everything works as before." */
-  cancelConfirmBody: (date: string) => string;
-  /** Its confirm button (§16.4): "Cancel subscription now". German: "Jetzt kündigen",
-   *  the confirmation button's words in §312k BGB. */
-  cancelConfirmAction: string;
-  /** In place of "Cancel subscription" while a cancel is scheduled (§16.7 C, `POST
-   *  /billing/resume`): "Keep subscription". */
-  keepSubscription: string;
-  /** 0.43 (§17.3): the muted note under the actions while the portal opens in a new tab —
-   *  `provider` the provider's name ("Paddle"), `app` the app's; without the app, "this
-   *  page". "Payment and invoices open at Paddle in a new tab; Kastlan stays open here." */
-  portalOpensNewTab: (provider: string, app?: string) => string;
-
-  /* ── The pay page (§14.4) ── */
-  /* Built into the static page `dist/pay/` at the kit's build: it has no React and no
-     provider, so an app's override never reaches it. */
-  /** While the checkout opens. */
-  payOpening: string;
-  /** A link without a transaction, or billing switched off: nothing to pay. */
-  payNothing: string;
-  /** Paddle's script didn't load, or the page's configuration is wrong. */
-  payFailed: string;
-  /** The buyer closed the checkout without paying. */
-  payBack: string;
-  /** 0.39 (§15.2.5): paid, for a transaction that names no app the page knows (a
-   *  payment-method update from Paddle's e-mail) — no way back to offer. */
-  payDone: string;
-
-  /* ── PlanSwitchConfirm (0.39, §15.2.10) ── */
-  /** The dialog's title: "Change plan". */
-  switchTitle: string;
-  /** The line naming both plans, each with its billing period: "From Pro (Monthly) to
-   *  Business (Yearly)". */
-  switchFromTo: (from: string, to: string) => string;
-  /** What an upgrade charges at once (Paddle's preview, prorated): "Charged now". */
-  switchChargedNow: string;
-  /** What a downgrade credits — the customer's balance, which Paddle takes off the next
-   *  charges: "Credited towards your next charges". */
-  switchCredited: string;
-  /** The next regular charge; `date` is formatted: "Next charge on 9 Nov 2026". */
-  switchNextCharge: (date: string) => string;
-  /** The confirm button: "Change plan". */
-  switchConfirm: string;
-
-  /* ── The permanent-grant warning (0.42, §16.2 decision 5, §16.8 B) ── */
-  /** The warning's title, before a checkout (`PlanPicker`) or a switch
-   *  (`PlanSwitchConfirm`) under a grant without an end: "Your free access continues". */
-  grantWarningTitle: string;
-  /** What the purchase does under it: nothing to the plan while the grant runs. */
-  grantWarningBody: string;
-  /** `PlanPicker`'s button that goes on to the checkout: "Buy anyway". */
-  grantWarningAction: string;
-
-  /* ── Offline (§12.5) ── */
-  /** Changes refused as `billing_read_only` inside a sync reply, kept queued and sent
-   *  after payment: "3 changes waiting for a plan". */
-  waitingChanges: (count: number) => string;
-  /** The sign-out guard's way out for someone who will not pay. */
-  discardWaiting: string;
-
-  /* ── Refusals with no part of their own (0.32.1, kastlan's 0.32 report) ── */
-  /**
-   * `billing_not_configured`: billing is on but the provider's settings are missing — the
-   * operator's mistake, so the words ask the payer to wait, not to act. For the toast or
-   * alert after "Choose a plan" or "Payment and invoices" (`isBillingError(err,
-   * "billing_not_configured")`). `billing_read_only` and `plan_limit` need none: the
-   * write lock, the banner and `PlanLimitNotice` say them.
-   */
-  notConfigured: string;
-  /** `billing_disabled`: billing is switched off on this server (§2.9), for a page or a
-   *  link that reached it anyway. */
-  disabled: string;
-  /* 0.33.0 — server-kit 0.7's refusals (§14.2). `billing_not_at_provider` is
-     {@link notAtProvider}'s: a stale page that asked for the portal anyway. */
-  /** `billing_provider_unavailable` (502): the provider didn't answer. Try again. */
-  providerUnavailable: string;
-  /** `billing_already_subscribed` (409): a second checkout while a subscription runs
-   *  (§14.6). Since 0.39 plan changes go through the app's own switch (§15.2.10), not the
-   *  portal, and the words say so. */
-  alreadySubscribed: string;
-  /** `billing_plan_not_sold` (422): the catalogue doesn't sell this plan with that
-   *  period or currency — at a checkout, or (0.39) a switch to a plan no longer sold. */
-  planNotSold: string;
-  /** 0.39 (§15.2.10): `billing_not_subscribed` (409), a plan switch with no running
-   *  provider subscription — the page offers the checkout instead. */
-  notSubscribed: string;
-  /** 0.39: `billing_plan_unchanged` (409), a switch to the price the payer pays now. */
-  planUnchanged: string;
-}
-
-/** "today", "tomorrow", "in 5 days". */
-function inDays(days: number): string {
-  if (days <= 0) return "today";
-  if (days === 1) return "tomorrow";
-  return `in ${days} days`;
-}
-
-export const DEFAULT_BILLING_LABELS: BillingLabels = {
-  group: "Subscription",
-
-  plans: "Plans",
-  interval: "Billing period",
-  yearly: "Yearly",
-  monthly: "Monthly",
-  currency: "Currency",
-  perYear: "per year",
-  perMonth: "per month",
-  vatIncluded: "VAT included",
-  free: "Free",
-  notOffered: "Not offered for this billing period",
-  unlimited: "Unlimited",
-  limits: "Limits",
-  features: "Included",
-  current: "Current plan",
-  choose: (plan) => `Choose ${plan}`,
-  upgrade: (plan) => `Upgrade to ${plan}`,
-  downgrade: (plan) => `Switch to ${plan}`,
-  isCurrent: "This is your current plan.",
-  pickFirst: "Pick a plan first.",
-
-  status: {
-    trialing: "Trial",
-    active: "Active",
-    past_due: "Payment overdue",
-    canceled: "Cancelled",
-    expired: "Expired",
-    comped: "Complimentary",
-  },
-
-  trialEnding: (days) =>
-    `Your trial ends ${inDays(days)}. After that you can still view everything, but changes need a plan.`,
-  grantEnding: (days) =>
-    `Your free access ends ${inDays(days)}. After that you can still view everything, but changes need a plan.`,
-  paymentFailed: "Your last payment didn’t go through. Update your payment method to keep your plan.",
-  planEnded: "Your plan has ended. You can still view and export everything; choose a plan to make changes again.",
-  guestReadOnly: (item) =>
-    item
-      ? `“${item}” is read-only for now; its owner can lift that.`
-      : "This is read-only for now; its owner can lift that.",
-  processing:
-    "Your payment is being processed. Your plan starts as soon as it’s confirmed; this page updates by itself.",
-  choosePlan: "Choose a plan",
-  updatePayment: "Update payment method",
-  paymentFailedAskBuyer: (buyer) =>
-    buyer
-      ? `The payment failed. ${buyer} can update the payment method.`
-      : "The payment failed. The admin who bought the subscription can update the payment method.",
-  checkAgain: "Check again",
-
-  lockReason: "Your plan has ended. Choose a plan to make changes again.",
-
-  limitReached: "Plan limit reached",
-  limitUpgrade: "To add more, choose a plan with a higher limit.",
-  limitContact: "To add more, ask us for a higher limit.",
-  askForMore: "Ask for more",
-  usage: (used, limit) => `${used} of ${limit}`,
-  contactSubject: (dimension) => `Plan limit: ${dimension}`,
-  limitUsageLine: (dimension, used, limit) => `${dimension}: ${used} of ${limit}`,
-
-  manage: "Payment and invoices",
-  cancel: "Cancel subscription",
-  notAtProvider: "Nothing to manage yet. Payments and invoices appear here once you have a paid plan.",
-  buyerHolds: (buyer) =>
-    buyer
-      ? `The payment method and the invoices are with ${buyer}, who bought the subscription.`
-      : "The payment method and the invoices are with the admin who bought the subscription.",
-  cancelConfirmTitle: "Cancel subscription",
-  cancelConfirmBody: (date) => `Your subscription ends on ${date}. Until then everything works as before.`,
-  cancelConfirmAction: "Cancel subscription now",
-  keepSubscription: "Keep subscription",
-  portalOpensNewTab: (provider, app) =>
-    `Payment and invoices open at ${provider} in a new tab; ${app ? `${app} stays open here` : "this page stays open"}.`,
-
-  payOpening: "Opening the secure checkout…",
-  payNothing: "There’s no payment to make here. To choose a plan, go back to the app.",
-  payFailed: "The checkout couldn’t be opened. Please go back and try again in a moment.",
-  payBack: "The checkout was closed. You can go back, or reload this page to open it again.",
-  payDone: "Payment complete. You can close this page.",
-
-  switchTitle: "Change plan",
-  switchFromTo: (from, to) => `From ${from} to ${to}`,
-  switchChargedNow: "Charged now",
-  switchCredited: "Credited towards your next charges",
-  switchNextCharge: (date) => `Next charge on ${date}`,
-  switchConfirm: "Change plan",
-
-  grantWarningTitle: "Your free access continues",
-  grantWarningBody:
-    "You have free access with no end date. A purchase won’t change your plan while the free access runs: you would pay for a plan that doesn’t apply.",
-  grantWarningAction: "Buy anyway",
-
-  waitingChanges: (count) => (count === 1 ? "1 change waiting for a plan" : `${count} changes waiting for a plan`),
-  discardWaiting: "Discard waiting changes",
-
-  notConfigured: "Payments aren't set up yet. Please try again later.",
-  disabled: "Subscriptions aren't available here.",
-  providerUnavailable: "The payment provider can’t be reached right now. Please try again in a moment.",
-  alreadySubscribed: "You already have a subscription. Change your plan above.",
-  planNotSold: "This plan isn’t offered for that billing period or currency. Please choose another.",
-  notSubscribed: "There’s no running subscription to change. Choose a plan to subscribe.",
-  planUnchanged: "That’s already your plan. Pick another plan or billing period.",
-};
-
-/** The `billing` namespace, resolved: English, then the provider, then `labels` — which
- *  may be partial at every depth (`{ status: { comped: "Beta" } }`). */
-export function useBillingLabels(labels?: LabelOverride<BillingLabels>): BillingLabels {
-  return useKitLabels("billing", DEFAULT_BILLING_LABELS, labels);
-}