@eifi1/ui-kit 0.41.0 → 0.42.0

package/dist/admin/admin-tool-links.d.ts

@@ -0,0 +1,48 @@
+import type { ReactElement, ReactNode } from "react";
+import type { ListItemLinkProps } from "../components/list.js";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { AdminAreaLabels } from "./admin-area-labels.js";
+/** One link of the Tools list. */
+export interface AdminToolLink {
+    /** Unique in the list. */
+    key: string;
+    label: string;
+    href: string;
+    /** A lucide element, sized by the row. */
+    icon?: ReactNode;
+    /** `false` leaves the link out — Translations for an admin who doesn't review
+     *  (§6.11, ka F7). Default: shown. */
+    visible?: boolean;
+}
+export interface AdminToolLinksProps {
+    links: readonly AdminToolLink[];
+    /**
+     * `sidebar` (default): a `<nav>` named and headed "Tools", for `SettingsLayout`'s
+     * `sidebarFooter` under the section list on a desktop. `list`: the bare rows, for
+     * `SettingsLayout`'s `phoneFooter`, which puts them in a list of their own.
+     */
+    variant?: "sidebar" | "list";
+    /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */
+    renderLink?: (props: ListItemLinkProps) => ReactElement;
+    /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
+    labels?: LabelOverride<AdminAreaLabels>;
+    className?: string;
+}
+/**
+ * The admin area's links to the admin tools that are pages of their own (0.42.0,
+ * docs/admin-harmonization.md §2.5 decision 16, §6.11): Translations, and the app's task
+ * pages (kastlan's Data import). The feedback inbox is not one of them: the top bar's
+ * feedback menu reaches it, and the overview's tiles link to it.
+ *
+ * Draw it twice from one list — at the foot of the section sidebar and in the phone
+ * footer:
+ *
+ *     <SettingsLayout
+ *       sidebarFooter={<AdminToolLinks links={TOOLS} />}
+ *       phoneFooter={<AdminToolLinks links={TOOLS} variant="list" />}
+ *       …
+ *     />
+ *
+ * With no visible link it renders nothing.
+ */
+export declare function AdminToolLinks({ links, variant, renderLink, labels: labelsProp, className }: AdminToolLinksProps): import("react").JSX.Element | null;

package/dist/admin/admin-tool-links.js

@@ -0,0 +1,31 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useId } from "react";
+import { cn } from "../lib/cn.js";
+import { List, ListItem } from "../components/list.js";
+import { useAdminAreaLabels } from "./admin-area-labels.js";
+function AdminToolLinks({ links, variant = "sidebar", renderLink, labels: labelsProp, className }) {
+  const labels = useAdminAreaLabels(labelsProp);
+  const headingId = useId();
+  const shown = links.filter((l) => l.visible !== false);
+  if (shown.length === 0) return null;
+  const rows = shown.map((l) => /* @__PURE__ */ jsx(
+    ListItem,
+    {
+      href: l.href,
+      renderLink,
+      title: l.label,
+      leading: l.icon === void 0 ? void 0 : /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "flex shrink-0 text-muted [&_svg]:size-4", children: l.icon })
+    },
+    l.key
+  ));
+  if (variant === "list") return /* @__PURE__ */ jsx(Fragment, { children: rows });
+  return /* @__PURE__ */ jsxs("nav", { "data-slot": "admin-tool-links", "aria-labelledby": headingId, className: cn("space-y-1", className), children: [
+    /* @__PURE__ */ jsx("div", { id: headingId, className: "px-3 text-caption font-semibold uppercase tracking-wide text-muted", children: labels.tools }),
+    /* @__PURE__ */ jsx(List, { density: "compact", children: rows })
+  ] });
+}
+export {
+  AdminToolLinks
+};
+//# sourceMappingURL=admin-tool-links.js.map

package/dist/admin/admin-tool-links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-tool-links.tsx"],"sourcesContent":["import { useId } from \"react\";\nimport type { ReactElement, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { List, ListItem } from \"../components/list\";\nimport type { ListItemLinkProps } from \"../components/list\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { useAdminAreaLabels } from \"./admin-area-labels\";\nimport type { AdminAreaLabels } from \"./admin-area-labels\";\n\n/** One link of the Tools list. */\nexport interface AdminToolLink {\n  /** Unique in the list. */\n  key: string;\n  label: string;\n  href: string;\n  /** A lucide element, sized by the row. */\n  icon?: ReactNode;\n  /** `false` leaves the link out — Translations for an admin who doesn't review\n   *  (§6.11, ka F7). Default: shown. */\n  visible?: boolean;\n}\n\nexport interface AdminToolLinksProps {\n  links: readonly AdminToolLink[];\n  /**\n   * `sidebar` (default): a `<nav>` named and headed \"Tools\", for `SettingsLayout`'s\n   * `sidebarFooter` under the section list on a desktop. `list`: the bare rows, for\n   * `SettingsLayout`'s `phoneFooter`, which puts them in a list of their own.\n   */\n  variant?: \"sidebar\" | \"list\";\n  /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */\n  renderLink?: (props: ListItemLinkProps) => ReactElement;\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n  className?: string;\n}\n\n/**\n * The admin area's links to the admin tools that are pages of their own (0.42.0,\n * docs/admin-harmonization.md §2.5 decision 16, §6.11): Translations, and the app's task\n * pages (kastlan's Data import). The feedback inbox is not one of them: the top bar's\n * feedback menu reaches it, and the overview's tiles link to it.\n *\n * Draw it twice from one list — at the foot of the section sidebar and in the phone\n * footer:\n *\n *     <SettingsLayout\n *       sidebarFooter={<AdminToolLinks links={TOOLS} />}\n *       phoneFooter={<AdminToolLinks links={TOOLS} variant=\"list\" />}\n *       …\n *     />\n *\n * With no visible link it renders nothing.\n */\nexport function AdminToolLinks({ links, variant = \"sidebar\", renderLink, labels: labelsProp, className }: AdminToolLinksProps) {\n  const labels = useAdminAreaLabels(labelsProp);\n  const headingId = useId();\n  const shown = links.filter((l) => l.visible !== false);\n  if (shown.length === 0) return null;\n  const rows = shown.map((l) => (\n    <ListItem\n      key={l.key}\n      href={l.href}\n      renderLink={renderLink}\n      title={l.label}\n      leading={\n        l.icon === undefined ? undefined : (\n          <span aria-hidden className=\"flex shrink-0 text-muted [&_svg]:size-4\">\n            {l.icon}\n          </span>\n        )\n      }\n    />\n  ));\n  if (variant === \"list\") return <>{rows}</>;\n  return (\n    <nav data-slot=\"admin-tool-links\" aria-labelledby={headingId} className={cn(\"space-y-1\", className)}>\n      <div id={headingId} className=\"px-3 text-caption font-semibold uppercase tracking-wide text-muted\">\n        {labels.tools}\n      </div>\n      <List density=\"compact\">{rows}</List>\n    </nav>\n  );\n}\n"],"mappings":";AAmEU,SAOuB,UAPvB,KASN,YATM;AAnEV,SAAS,aAAa;AAEtB,SAAS,UAAU;AACnB,SAAS,MAAM,gBAAgB;AAG/B,SAAS,0BAA0B;AAgD5B,SAAS,eAAe,EAAE,OAAO,UAAU,WAAW,YAAY,QAAQ,YAAY,UAAU,GAAwB;AAC7H,QAAM,SAAS,mBAAmB,UAAU;AAC5C,QAAM,YAAY,MAAM;AACxB,QAAM,QAAQ,MAAM,OAAO,CAAC,MAAM,EAAE,YAAY,KAAK;AACrD,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,OAAO,MAAM,IAAI,CAAC,MACtB;AAAA,IAAC;AAAA;AAAA,MAEC,MAAM,EAAE;AAAA,MACR;AAAA,MACA,OAAO,EAAE;AAAA,MACT,SACE,EAAE,SAAS,SAAY,SACrB,oBAAC,UAAK,eAAW,MAAC,WAAU,2CACzB,YAAE,MACL;AAAA;AAAA,IARC,EAAE;AAAA,EAWT,CACD;AACD,MAAI,YAAY,OAAQ,QAAO,gCAAG,gBAAK;AACvC,SACE,qBAAC,SAAI,aAAU,oBAAmB,mBAAiB,WAAW,WAAW,GAAG,aAAa,SAAS,GAChG;AAAA,wBAAC,SAAI,IAAI,WAAW,WAAU,sEAC3B,iBAAO,OACV;AAAA,IACA,oBAAC,QAAK,SAAQ,WAAW,gBAAK;AAAA,KAChC;AAEJ;","names":[]}

package/dist/billing/billing-banner.d.ts

@@ -2,6 +2,7 @@ import type { ComponentPropsWithRef } from "react";
 import type { LabelOverride } from "../i18n/kit-labels.js";
 import type { AlertSize, AlertTone } from "../components/alert-banner.js";
 import type { BillingLabels } from "./billing-labels.js";
+import type { BillingPortalAccess } from "./billing-overview.js";
 /**
  * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):
  *
@@ -9,7 +10,8 @@ import type { BillingLabels } from "./billing-labels.js";
  * - `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;
+ *   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).
@@ -61,16 +63,37 @@ export type BillingBannerProps = BillingBannerBaseProps & ({
     /** 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" | "plan-ended" | "processing";
+    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;
 });
 /**
  * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its

package/dist/billing/billing-banner.js

@@ -24,6 +24,8 @@ function BillingBanner(props) {
     kind,
     daysLeft,
     item,
+    portal,
+    buyerName,
     tone,
     variant = "strip",
     size,
@@ -42,6 +44,7 @@ function BillingBanner(props) {
   let text;
   let icon;
   let ownAction;
+  const askBuyer = kind === "payment-failed" && portal === "buyer_only";
   switch (kind) {
     case "trial-ending":
       text = labels.trialEnding(days);
@@ -54,7 +57,7 @@ function BillingBanner(props) {
       ownAction = labels.choosePlan;
       break;
     case "payment-failed":
-      text = labels.paymentFailed;
+      text = askBuyer ? labels.paymentFailedAskBuyer(buyerName || void 0) : labels.paymentFailed;
       icon = /* @__PURE__ */ jsx(CreditCard, {});
       ownAction = labels.updatePayment;
       break;
@@ -75,7 +78,7 @@ function BillingBanner(props) {
       break;
   }
   const words = actionLabel ?? ownAction;
-  const action = words === void 0 || actionHref === void 0 && onAction === void 0 ? void 0 : actionHref !== void 0 ? /* @__PURE__ */ jsx(Button, { href: actionHref, variant: "secondary", size: "sm", children: words }) : /* @__PURE__ */ jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: onAction, pending: actionPending, children: words });
+  const action = askBuyer || words === void 0 || actionHref === void 0 && onAction === void 0 ? void 0 : actionHref !== void 0 ? /* @__PURE__ */ jsx(Button, { href: actionHref, variant: "secondary", size: "sm", children: words }) : /* @__PURE__ */ jsx(Button, { type: "button", variant: "secondary", size: "sm", onClick: onAction, pending: actionPending, children: words });
   return /* @__PURE__ */ jsx(
     AlertBanner,
     {

package/dist/billing/billing-banner.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/billing-banner.tsx"],"sourcesContent":["import type { ComponentPropsWithRef, ReactNode } from \"react\";\nimport { CreditCard, Hourglass, PencilOff } from \"lucide-react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertSize, AlertTone } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/**\n * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):\n *\n * - `trial-ending` — from 7 days before `trial_ends_at` (§3.3);\n * - `grant-ending` — from 7 days before `comped_until`: a beta user's 12 months, an\n *   operator's grant;\n * - `payment-failed` — from the first failed payment (`past_due`), while the provider\n *   retries;\n * - `plan-ended` — out of good standing: read-only, never locked (§2.3);\n * - `guest` — a guest in someone else's read-only item (§12.6);\n * - `processing` — back from checkout before the webhook landed (§12.21).\n */\nexport type BillingBannerKind =\n  | \"trial-ending\"\n  | \"grant-ending\"\n  | \"payment-failed\"\n  | \"plan-ended\"\n  | \"guest\"\n  | \"processing\";\n\n/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they\n *  go on to the {@link AlertBanner}, so the ref is the banner's `<div>` — with an × too,\n *  since the banner has no `href` or `onClick` that would make its row a link or a button. */\ninterface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onClick\"> {\n  /**\n   * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last\n   * three days and `warning` in them; `payment-failed` is `danger` (money did not\n   * arrive — kastlan's past-due strip was red); `plan-ended` is `warning`, a state with\n   * everything still there rather than an error; `guest` and `processing` are `info`.\n   */\n  tone?: AlertTone;\n  /** `strip` (default): the band under the top bar, on every page. `box`: the same\n   *  message on the subscription page itself. */\n  variant?: \"strip\" | \"box\";\n  /** Default `sm` for a strip (the demo's banner), `md` for a box. */\n  size?: AlertSize;\n  /**\n   * Where the action goes — the subscription page, say. The app's action, as an `href`\n   * or as {@link onAction}; without either there is no button. Never a write-locked\n   * commit: billing itself always works (§3.3).\n   */\n  actionHref?: string;\n  /** What the action does — the app's portal call (`POST /billing/portal`, then off to\n   *  its `url`): for `payment-failed` with `{target: \"payment_method\"}`, the portal's\n   *  page for the card (§14.5); for `processing`, `useCheckoutProcessing`'s\n   *  `checkAgain`. The kit sends no request. */\n  onAction?: () => void;\n  /**\n   * Over the kind's action words: \"Choose a plan\" (trial, grant, plan ended), \"Update\n   * payment method\" (payment failed), \"Check again\" (processing). The guest banner has\n   * none of its own: an action there needs this.\n   */\n  actionLabel?: string;\n  /** The action is under way: the button's spinner, no second press. */\n  actionPending?: boolean;\n  /** An × that calls this; the app removes the banner and remembers that it did. */\n  onDismiss?: () => void;\n  dismissLabel?: string;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type BillingBannerProps = BillingBannerBaseProps &\n  (\n    | {\n        kind: \"trial-ending\" | \"grant-ending\";\n        /** Calendar days left — `billingDaysLeft(trial_ends_at)`. 0 is today. */\n        daysLeft: number;\n        item?: never;\n      }\n    | {\n        kind: \"guest\";\n        /** The item's own name (\"Household 2026\"), or nothing. NEVER the owner's status:\n         *  the banner says \"for now\" and nothing more (§12.6). */\n        item?: string;\n        daysLeft?: never;\n      }\n    | {\n        kind: \"payment-failed\" | \"plan-ended\" | \"processing\";\n        daysLeft?: never;\n        item?: never;\n      }\n  );\n\n/** The last days, in which an ending trial or grant turns from news into a warning. */\nconst LAST_DAYS = 3;\n\nfunction defaultTone(kind: BillingBannerKind, daysLeft: number | undefined): AlertTone {\n  switch (kind) {\n    case \"trial-ending\":\n    case \"grant-ending\":\n      return (daysLeft ?? 0) > LAST_DAYS ? \"info\" : \"warning\";\n    case \"payment-failed\":\n      return \"danger\";\n    case \"plan-ended\":\n      return \"warning\";\n    default:\n      return \"info\";\n  }\n}\n\n/**\n * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its\n * glyph and tone, and the app's action. Carries `data-billing-banner` with the kind.\n *\n * The app decides WHICH banner shows, from `GET /billing/overview` (and hides all of them\n * while billing is off, §4); the kit only says it. A guest's banner takes no status at\n * all — the type does not let one in — so the owner's payment state cannot leak into it\n * by a wrong prop (§12.6).\n *\n * `processing` is a live region (`role=\"status\"`): it appears when the person comes back\n * from checkout and goes when the overview catches up (§12.21), and a screen reader\n * should hear both. The others are page furniture, role-less as the strip is.\n */\nexport function BillingBanner(props: BillingBannerProps) {\n  const {\n    kind,\n    daysLeft,\n    item,\n    tone,\n    variant = \"strip\",\n    size,\n    actionHref,\n    onAction,\n    actionLabel,\n    actionPending,\n    onDismiss,\n    dismissLabel,\n    labels: labelsProp,\n    role,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const days = Math.max(0, Math.floor(daysLeft ?? 0));\n\n  let text: string;\n  let icon: ReactNode;\n  let ownAction: string | undefined;\n  switch (kind) {\n    case \"trial-ending\":\n      text = labels.trialEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"grant-ending\":\n      text = labels.grantEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"payment-failed\":\n      text = labels.paymentFailed;\n      icon = <CreditCard />;\n      ownAction = labels.updatePayment;\n      break;\n    case \"plan-ended\":\n      text = labels.planEnded;\n      icon = <PencilOff />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"guest\":\n      text = labels.guestReadOnly(item);\n      icon = <PencilOff />;\n      ownAction = undefined;\n      break;\n    case \"processing\":\n      text = labels.processing;\n      icon = <Spinner label={null} />;\n      ownAction = labels.checkAgain;\n      break;\n  }\n\n  const words = actionLabel ?? ownAction;\n  const action =\n    words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !== undefined ? (\n      <Button href={actionHref} variant=\"secondary\" size=\"sm\">\n        {words}\n      </Button>\n    ) : (\n      <Button type=\"button\" variant=\"secondary\" size=\"sm\" onClick={onAction} pending={actionPending}>\n        {words}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      role={role ?? (kind === \"processing\" ? \"status\" : undefined)}\n      variant={variant}\n      size={size ?? (variant === \"strip\" ? \"sm\" : \"md\")}\n      tone={tone ?? defaultTone(kind, days)}\n      icon={icon}\n      action={action}\n      onDismiss={onDismiss}\n      dismissLabel={dismissLabel}\n      data-billing-banner={kind}\n    >\n      {text}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AAwJa;AAvJb,SAAS,YAAY,WAAW,iBAAiB;AAGjD,SAAS,mBAAmB;AAE5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,wBAAwB;AAwFjC,MAAM,YAAY;AAElB,SAAS,YAAY,MAAyB,UAAyC;AACrF,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,YAAY,KAAK,YAAY,SAAS;AAAA,IAChD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAeO,SAAS,cAAc,OAA2B;AACvD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,YAAY,CAAC,CAAC;AAElD,MAAI;AACJ,MAAI;AACJ,MAAI;AACJ,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,cAAW;AACnB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,cAAc,IAAI;AAChC,aAAO,oBAAC,aAAU;AAClB,kBAAY;AACZ;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,WAAQ,OAAO,MAAM;AAC7B,kBAAY,OAAO;AACnB;AAAA,EACJ;AAEA,QAAM,QAAQ,eAAe;AAC7B,QAAM,SACJ,UAAU,UAAc,eAAe,UAAa,aAAa,SAAa,SAAY,eAAe,SACvG,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAAY,MAAK,MAChD,iBACH,IAEA,oBAAC,UAAO,MAAK,UAAS,SAAQ,aAAY,MAAK,MAAK,SAAS,UAAU,SAAS,eAC7E,iBACH;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,MAAM,SAAS,SAAS,eAAe,WAAW;AAAA,MAClD;AAAA,MACA,MAAM,SAAS,YAAY,UAAU,OAAO;AAAA,MAC5C,MAAM,QAAQ,YAAY,MAAM,IAAI;AAAA,MACpC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAqB;AAAA,MAEpB;AAAA;AAAA,EACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/billing/billing-banner.tsx"],"sourcesContent":["import type { ComponentPropsWithRef, ReactNode } from \"react\";\nimport { CreditCard, Hourglass, PencilOff } from \"lucide-react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport type { AlertSize, AlertTone } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\nimport type { BillingPortalAccess } from \"./billing-overview\";\n\n/**\n * The billing banners (docs/billing-harmonization.md §3.3, §7, §12.6, §12.21):\n *\n * - `trial-ending` — from 7 days before `trial_ends_at` (§3.3);\n * - `grant-ending` — from 7 days before `comped_until`: a beta user's 12 months, an\n *   operator's grant;\n * - `payment-failed` — from the first failed payment (`past_due`), while the provider\n *   retries; since 0.42, for an admin who isn't the buyer (`portal=\"buyer_only\"`), it\n *   names who can update the payment method, with no button;\n * - `plan-ended` — out of good standing: read-only, never locked (§2.3);\n * - `guest` — a guest in someone else's read-only item (§12.6);\n * - `processing` — back from checkout before the webhook landed (§12.21).\n */\nexport type BillingBannerKind =\n  | \"trial-ending\"\n  | \"grant-ending\"\n  | \"payment-failed\"\n  | \"plan-ended\"\n  | \"guest\"\n  | \"processing\";\n\n/** A `div`'s props, `ref` included since 0.35 (round 0.35 R4, the follow-up to API-2): they\n *  go on to the {@link AlertBanner}, so the ref is the banner's `<div>` — with an × too,\n *  since the banner has no `href` or `onClick` that would make its row a link or a button. */\ninterface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onClick\"> {\n  /**\n   * Over the kind's tone: `trial-ending` and `grant-ending` are `info` until the last\n   * three days and `warning` in them; `payment-failed` is `danger` (money did not\n   * arrive — kastlan's past-due strip was red); `plan-ended` is `warning`, a state with\n   * everything still there rather than an error; `guest` and `processing` are `info`.\n   */\n  tone?: AlertTone;\n  /** `strip` (default): the band under the top bar, on every page. `box`: the same\n   *  message on the subscription page itself. */\n  variant?: \"strip\" | \"box\";\n  /** Default `sm` for a strip (the demo's banner), `md` for a box. */\n  size?: AlertSize;\n  /**\n   * Where the action goes — the subscription page, say. The app's action, as an `href`\n   * or as {@link onAction}; without either there is no button. Never a write-locked\n   * commit: billing itself always works (§3.3).\n   */\n  actionHref?: string;\n  /** What the action does — the app's portal call (`POST /billing/portal`, then off to\n   *  its `url`): for `payment-failed` with `{target: \"payment_method\"}`, the portal's\n   *  page for the card (§14.5); for `processing`, `useCheckoutProcessing`'s\n   *  `checkAgain`. The kit sends no request. */\n  onAction?: () => void;\n  /**\n   * Over the kind's action words: \"Choose a plan\" (trial, grant, plan ended), \"Update\n   * payment method\" (payment failed), \"Check again\" (processing). The guest banner has\n   * none of its own: an action there needs this.\n   */\n  actionLabel?: string;\n  /** The action is under way: the button's spinner, no second press. */\n  actionPending?: boolean;\n  /** An × that calls this; the app removes the banner and remembers that it did. */\n  onDismiss?: () => void;\n  dismissLabel?: string;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\nexport type BillingBannerProps = BillingBannerBaseProps &\n  (\n    | {\n        kind: \"trial-ending\" | \"grant-ending\";\n        /** Calendar days left — `billingDaysLeft(trial_ends_at)`. 0 is today. */\n        daysLeft: number;\n        item?: never;\n        portal?: never;\n        buyerName?: never;\n      }\n    | {\n        kind: \"guest\";\n        /** The item's own name (\"Household 2026\"), or nothing. NEVER the owner's status:\n         *  the banner says \"for now\" and nothing more (§12.6). */\n        item?: string;\n        daysLeft?: never;\n        portal?: never;\n        buyerName?: never;\n      }\n    | {\n        kind: \"payment-failed\";\n        /**\n         * 0.42 (§16.7 A, §16.8): `GET /billing/status`'s `portal` (`BillingStanding`).\n         * `\"buyer_only\"` — the viewer isn't the buyer, so the portal's page for the card\n         * would answer 403: the banner says who can update the payment method\n         * (`paymentFailedAskBuyer`) and shows NO button, whatever `actionHref` or\n         * `onAction` say. `\"open\"` (default): as before.\n         */\n        portal?: BillingPortalAccess;\n        /** 0.42: the status's `buyer_name`, under `\"buyer_only\"`. Empty: \"…the admin who\n         *  bought the subscription\". */\n        buyerName?: string | null;\n        daysLeft?: never;\n        item?: never;\n      }\n    | {\n        kind: \"plan-ended\" | \"processing\";\n        daysLeft?: never;\n        item?: never;\n        portal?: never;\n        buyerName?: never;\n      }\n  );\n\n/** The last days, in which an ending trial or grant turns from news into a warning. */\nconst LAST_DAYS = 3;\n\nfunction defaultTone(kind: BillingBannerKind, daysLeft: number | undefined): AlertTone {\n  switch (kind) {\n    case \"trial-ending\":\n    case \"grant-ending\":\n      return (daysLeft ?? 0) > LAST_DAYS ? \"info\" : \"warning\";\n    case \"payment-failed\":\n      return \"danger\";\n    case \"plan-ended\":\n      return \"warning\";\n    default:\n      return \"info\";\n  }\n}\n\n/**\n * One of the billing banners, as a kit `AlertBanner` strip (§7): the kind's sentence, its\n * glyph and tone, and the app's action. Carries `data-billing-banner` with the kind.\n *\n * The app decides WHICH banner shows, from `GET /billing/overview` (and hides all of them\n * while billing is off, §4); the kit only says it. A guest's banner takes no status at\n * all — the type does not let one in — so the owner's payment state cannot leak into it\n * by a wrong prop (§12.6).\n *\n * `processing` is a live region (`role=\"status\"`): it appears when the person comes back\n * from checkout and goes when the overview catches up (§12.21), and a screen reader\n * should hear both. The others are page furniture, role-less as the strip is.\n */\nexport function BillingBanner(props: BillingBannerProps) {\n  const {\n    kind,\n    daysLeft,\n    item,\n    portal,\n    buyerName,\n    tone,\n    variant = \"strip\",\n    size,\n    actionHref,\n    onAction,\n    actionLabel,\n    actionPending,\n    onDismiss,\n    dismissLabel,\n    labels: labelsProp,\n    role,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const days = Math.max(0, Math.floor(daysLeft ?? 0));\n\n  let text: string;\n  let icon: ReactNode;\n  let ownAction: string | undefined;\n  // 0.42 (§16.7 A): only the buyer can reach the portal's card page.\n  const askBuyer = kind === \"payment-failed\" && portal === \"buyer_only\";\n  switch (kind) {\n    case \"trial-ending\":\n      text = labels.trialEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"grant-ending\":\n      text = labels.grantEnding(days);\n      icon = <Hourglass />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"payment-failed\":\n      text = askBuyer ? labels.paymentFailedAskBuyer(buyerName || undefined) : labels.paymentFailed;\n      icon = <CreditCard />;\n      ownAction = labels.updatePayment;\n      break;\n    case \"plan-ended\":\n      text = labels.planEnded;\n      icon = <PencilOff />;\n      ownAction = labels.choosePlan;\n      break;\n    case \"guest\":\n      text = labels.guestReadOnly(item);\n      icon = <PencilOff />;\n      ownAction = undefined;\n      break;\n    case \"processing\":\n      text = labels.processing;\n      icon = <Spinner label={null} />;\n      ownAction = labels.checkAgain;\n      break;\n  }\n\n  const words = actionLabel ?? ownAction;\n  const action =\n    askBuyer || words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !== undefined ? (\n      <Button href={actionHref} variant=\"secondary\" size=\"sm\">\n        {words}\n      </Button>\n    ) : (\n      <Button type=\"button\" variant=\"secondary\" size=\"sm\" onClick={onAction} pending={actionPending}>\n        {words}\n      </Button>\n    );\n\n  return (\n    <AlertBanner\n      {...rest}\n      role={role ?? (kind === \"processing\" ? \"status\" : undefined)}\n      variant={variant}\n      size={size ?? (variant === \"strip\" ? \"sm\" : \"md\")}\n      tone={tone ?? defaultTone(kind, days)}\n      icon={icon}\n      action={action}\n      onDismiss={onDismiss}\n      dismissLabel={dismissLabel}\n      data-billing-banner={kind}\n    >\n      {text}\n    </AlertBanner>\n  );\n}\n"],"mappings":";AAoLa;AAnLb,SAAS,YAAY,WAAW,iBAAiB;AAGjD,SAAS,mBAAmB;AAE5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,wBAAwB;AAgHjC,MAAM,YAAY;AAElB,SAAS,YAAY,MAAyB,UAAyC;AACrF,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,YAAY,KAAK,YAAY,SAAS;AAAA,IAChD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAeO,SAAS,cAAc,OAA2B;AACvD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA,GAAG;AAAA,EACL,IAAI;AACJ,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,YAAY,CAAC,CAAC;AAElD,MAAI;AACJ,MAAI;AACJ,MAAI;AAEJ,QAAM,WAAW,SAAS,oBAAoB,WAAW;AACzD,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,YAAY,IAAI;AAC9B,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,WAAW,OAAO,sBAAsB,aAAa,MAAS,IAAI,OAAO;AAChF,aAAO,oBAAC,cAAW;AACnB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,aAAU;AAClB,kBAAY,OAAO;AACnB;AAAA,IACF,KAAK;AACH,aAAO,OAAO,cAAc,IAAI;AAChC,aAAO,oBAAC,aAAU;AAClB,kBAAY;AACZ;AAAA,IACF,KAAK;AACH,aAAO,OAAO;AACd,aAAO,oBAAC,WAAQ,OAAO,MAAM;AAC7B,kBAAY,OAAO;AACnB;AAAA,EACJ;AAEA,QAAM,QAAQ,eAAe;AAC7B,QAAM,SACJ,YAAY,UAAU,UAAc,eAAe,UAAa,aAAa,SAAa,SAAY,eAAe,SACnH,oBAAC,UAAO,MAAM,YAAY,SAAQ,aAAY,MAAK,MAChD,iBACH,IAEA,oBAAC,UAAO,MAAK,UAAS,SAAQ,aAAY,MAAK,MAAK,SAAS,UAAU,SAAS,eAC7E,iBACH;AAGJ,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,MAAM,SAAS,SAAS,eAAe,WAAW;AAAA,MAClD;AAAA,MACA,MAAM,SAAS,YAAY,UAAU,OAAO;AAAA,MAC5C,MAAM,QAAQ,YAAY,MAAM,IAAI;AAAA,MACpC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAqB;AAAA,MAEpB;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/billing/billing-labels.d.ts

@@ -91,6 +91,13 @@ export interface BillingLabels {
     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 `WriteLockProvider` reason for the payer (§3.3, verbatim). A guest's reason is
@@ -129,6 +136,24 @@ export interface BillingLabels {
      * the words for `409 billing_not_at_provider`, a stale page that asked anyway.
      */
     notAtProvider: string;
+    /**
+     * 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;
     /** While the checkout opens. */
     payOpening: string;
     /** A link without a transaction, or billing switched off: nothing to pay. */
@@ -154,6 +179,13 @@ export interface BillingLabels {
     switchNextCharge: (date: string) => string;
     /** The confirm button: "Change plan". */
     switchConfirm: string;
+    /** 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;
     /** 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;

package/dist/billing/billing-labels.js

@@ -50,6 +50,7 @@ const DEFAULT_BILLING_LABELS = {
   processing: "Your payment is being processed. Your plan starts as soon as it\u2019s 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",
@@ -62,6 +63,11 @@ const DEFAULT_BILLING_LABELS = {
   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",
   payOpening: "Opening the secure checkout\u2026",
   payNothing: "There\u2019s no payment to make here. To choose a plan, go back to the app.",
   payFailed: "The checkout couldn\u2019t be opened. Please go back and try again in a moment.",
@@ -73,6 +79,9 @@ const DEFAULT_BILLING_LABELS = {
   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\u2019t change your plan while the free access runs: you would pay for a plan that doesn\u2019t 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.",

package/dist/billing/billing-labels.js.map

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

package/dist/billing/billing-overview.d.ts

@@ -51,7 +51,40 @@ export interface BillingOverview {
      * server-kit before 0.13 still type-checks; absent, read it as false.
      */
     switching?: boolean;
+    /**
+     * 0.42 (server-kit 0.14, §16.3): who may open the provider's portal. `"buyer_only"`:
+     * the row has a buyer (`provider_payer_user_id`) and the viewer isn't them — every
+     * portal target would answer `403 billing_portal_buyer_only`, so "Payment and
+     * invoices" is a caption naming the buyer and "Cancel subscription" is the in-app
+     * cancel (`POST /billing/cancel`). `"open"`, or absent (server-kit before 0.14): as
+     * before. Pass it to `SubscriptionActions`' `portal`.
+     */
+    portal?: BillingPortalAccess;
+    /**
+     * 0.42 (§16.3, §16.7 G): the buyer's display name, for the caption under
+     * `"buyer_only"`; `null` when the buyer is gone or no longer a member of the company,
+     * and the words then say "the admin who bought the subscription".
+     */
+    buyer_name?: string | null;
 }
+/** 0.42 (§16.3): `BillingOverview.portal` and `BillingStanding.portal` — server-kit's
+ *  `Literal["open", "buyer_only"]`. */
+export type BillingPortalAccess = "open" | "buyer_only";
+/**
+ * 0.42 (§16.2 decision 5, §16.7 E): whether the payer's free grant runs WITHOUT AN END —
+ * an operator's grant (`source: "manual"`) with `comped_until` empty. A purchase under
+ * it leaves the row `comped` on the grant's plan (§12.11): only the paid price moves,
+ * so the payer would pay for a plan that never applies. Pass it to `PlanPicker`'s and
+ * `PlanSwitchConfirm`'s `permanentGrant`, which warn before the checkout or the switch.
+ *
+ * `source` is checked explicitly, not implied by the missing date: Kurvenschmiede's
+ * pre-launch beta rows are `comped` with `comped_until` null too (their launch-plus-12-
+ * months end isn't written yet, §3.2), and they are not permanent. A grant with an end
+ * gets no warning either: the bought plan applies from that end on.
+ */
+export declare function isPermanentGrant(overview: Pick<BillingOverview, "status" | "source"> & {
+    comped_until?: BillingOverview["comped_until"];
+}): boolean;
 /** 0.39: what the payer pays at the provider (server-kit's `PaidPrice`, §15.2.10),
  *  read from the row's `provider_price_id`. */
 export interface PaidPrice {

package/dist/billing/billing-overview.js

@@ -1,2 +1,8 @@
 "use client";
+function isPermanentGrant(overview) {
+  return overview.status === "comped" && overview.source === "manual" && overview.comped_until == null;
+}
+export {
+  isPermanentGrant
+};
 //# sourceMappingURL=billing-overview.js.map

package/dist/billing/billing-overview.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/billing/billing-overview.ts"],"sourcesContent":["import type { DateInput } from \"../lib/format\";\nimport type { SubscriptionStatus } from \"./billing-labels\";\nimport type { BillingCurrency, BillingInterval } from \"./plan-price\";\n\n/**\n * The billing API's shapes the kit's parts read (docs/billing-harmonization.md §4,\n * §14.5) — server-kit 0.7's schemas, field for field under their wire names, for an app\n * whose client is hand-written (kastlan's `features/billing/types.ts`, Kurvenschmiede's\n * `shared/types/billing.ts`, which no mirror test covers).\n */\n\n/** Where a row's current state came from (server-kit's `SubscriptionSource`, §3.2). */\nexport type SubscriptionSource = \"trial\" | \"provider\" | \"manual\" | \"beta\";\n\n/** `GET /billing/overview` (§4): where the payer's subscription stands, what the plan\n *  allows and what is used. Only ever the payer's own (§12.6). */\nexport interface BillingOverview {\n  /** The plan's code, lowercase (§3.1). */\n  plan: string;\n  status: SubscriptionStatus;\n  source: SubscriptionSource;\n  /** False: read-only (§3.3). */\n  in_good_standing: boolean;\n  trial_ends_at: DateInput;\n  /** When the free grant ends; null: no end. */\n  comped_until: DateInput;\n  current_period_end: DateInput;\n  cancel_at_period_end: boolean;\n  /** Dimension → limit; null for unlimited. */\n  limits: Record<string, number | null>;\n  /** What the payer has, per dimension (§12.15). */\n  usage: Record<string, number>;\n  currency: BillingCurrency;\n  /**\n   * 0.7 (§14.5): the provider has a customer for this payer, whatever the status or the\n   * source — `SubscriptionActions`' `atProvider`. False: \"nothing to manage yet\", and a\n   * portal request would answer `409 billing_not_at_provider`.\n   */\n  at_provider: boolean;\n  /**\n   * 0.39 (server-kit 0.12, §15.2.10): the price the payer pays at the provider — its\n   * plan, period and currency — or null with none (a trial, a grant without a purchase).\n   * Under a grant the row keeps the grant's plan, status and source (§12.11), so this\n   * is what shows that a switch landed; `checkoutFingerprint` reads it.\n   */\n  paid: PaidPrice | null;\n  /**\n   * 0.40 (server-kit 0.13, §15.2.10): a provider subscription runs — the server's own\n   * rule, the one its checkout (409 `billing_already_subscribed`) and switch (409\n   * `billing_not_subscribed`) routes apply, so exactly one of the two answers. While it\n   * is true a `PlanPicker` pick opens `PlanSwitchConfirm` (`POST /billing/plan/preview`,\n   * then `POST /billing/plan`); while false, the checkout (`POST /billing/checkout`).\n   * Read it instead of mirroring the rule on the client. Optional so an overview from\n   * server-kit before 0.13 still type-checks; absent, read it as false.\n   */\n  switching?: boolean;\n  /**\n   * 0.42 (server-kit 0.14, §16.3): who may open the provider's portal. `\"buyer_only\"`:\n   * the row has a buyer (`provider_payer_user_id`) and the viewer isn't them — every\n   * portal target would answer `403 billing_portal_buyer_only`, so \"Payment and\n   * invoices\" is a caption naming the buyer and \"Cancel subscription\" is the in-app\n   * cancel (`POST /billing/cancel`). `\"open\"`, or absent (server-kit before 0.14): as\n   * before. Pass it to `SubscriptionActions`' `portal`.\n   */\n  portal?: BillingPortalAccess;\n  /**\n   * 0.42 (§16.3, §16.7 G): the buyer's display name, for the caption under\n   * `\"buyer_only\"`; `null` when the buyer is gone or no longer a member of the company,\n   * and the words then say \"the admin who bought the subscription\".\n   */\n  buyer_name?: string | null;\n}\n\n/** 0.42 (§16.3): `BillingOverview.portal` and `BillingStanding.portal` — server-kit's\n *  `Literal[\"open\", \"buyer_only\"]`. */\nexport type BillingPortalAccess = \"open\" | \"buyer_only\";\n\n/**\n * 0.42 (§16.2 decision 5, §16.7 E): whether the payer's free grant runs WITHOUT AN END —\n * an operator's grant (`source: \"manual\"`) with `comped_until` empty. A purchase under\n * it leaves the row `comped` on the grant's plan (§12.11): only the paid price moves,\n * so the payer would pay for a plan that never applies. Pass it to `PlanPicker`'s and\n * `PlanSwitchConfirm`'s `permanentGrant`, which warn before the checkout or the switch.\n *\n * `source` is checked explicitly, not implied by the missing date: Kurvenschmiede's\n * pre-launch beta rows are `comped` with `comped_until` null too (their launch-plus-12-\n * months end isn't written yet, §3.2), and they are not permanent. A grant with an end\n * gets no warning either: the bought plan applies from that end on.\n */\nexport function isPermanentGrant(\n  overview: Pick<BillingOverview, \"status\" | \"source\"> & { comped_until?: BillingOverview[\"comped_until\"] },\n): boolean {\n  return overview.status === \"comped\" && overview.source === \"manual\" && overview.comped_until == null;\n}\n\n/** 0.39: what the payer pays at the provider (server-kit's `PaidPrice`, §15.2.10),\n *  read from the row's `provider_price_id`. */\nexport interface PaidPrice {\n  /** The plan's code, lowercase. */\n  plan: string;\n  interval: BillingInterval;\n  currency: BillingCurrency;\n}\n\n/** 0.39: `POST /billing/plan/preview` and `POST /billing/plan`'s body (server-kit's\n *  `PlanSwitchRequest`, §15.2.10) — the plan and period to switch to. The currency stays\n *  the subscription's. */\nexport interface PlanSwitchRequest {\n  plan: string;\n  interval: BillingInterval;\n}\n\n/**\n * 0.39: what a plan switch costs — or did (server-kit's `PlanSwitchPreview`, §15.2.10):\n * Paddle's preview, prorated at once, both routes' answer. `PlanSwitchConfirm` shows it\n * before the payer agrees.\n */\nexport interface PlanSwitchPreview {\n  /** The subscription's currency. */\n  currency: BillingCurrency;\n  /** Charged at once, in minor units: an upgrade's prorated difference — or, negative, a\n   *  downgrade's credit to the customer's balance, which Paddle takes off the next\n   *  charges. */\n  now_minor: number;\n  /** The next regular charge, in minor units. */\n  next_minor?: number | null;\n  /** When it is charged; null when Paddle names no date. */\n  next_billed_at?: string | null;\n  /** The plan and period switched to. */\n  plan: string;\n  interval: BillingInterval;\n  /** The dimensions whose usage is over the new plan's limit (§3.4: a limit gates\n   *  creation only — the switch is allowed). */\n  over_limit: string[];\n  /** The new plan's limits; null for unlimited. */\n  limits: Record<string, number | null>;\n  /** What the payer has, per dimension. */\n  usage: Record<string, number>;\n}\n\n/**\n * Where in the provider's portal a request lands (server-kit's `PortalTarget`, §14.5):\n *\n * - `overview` — \"Payment and invoices\";\n * - `cancel` — \"Cancel subscription\": the subscription's cancel link (§12.26);\n * - `payment_method` — the payment-failed banner's \"Update payment method\".\n *\n * The server answers the overview where Paddle gives no such link (a paused or cancelled\n * subscription).\n */\nexport type PortalTarget = \"overview\" | \"cancel\" | \"payment_method\";\n\n/** `POST /billing/portal`'s optional body (server-kit's `PortalRequest`, §14.5); left\n *  out, the overview. The answer is `{url}`, a fresh link that is never stored. */\nexport interface PortalRequest {\n  target?: PortalTarget;\n}\n"],"mappings":";AAyFO,SAAS,iBACd,UACS;AACT,SAAO,SAAS,WAAW,YAAY,SAAS,WAAW,YAAY,SAAS,gBAAgB;AAClG;","names":[]}

package/dist/billing/billing-standing.d.ts

@@ -1,5 +1,6 @@
 import type { DateInput } from "../lib/format.js";
 import type { SubscriptionStatus } from "./billing-labels.js";
+import type { BillingPortalAccess } from "./billing-overview.js";
 /**
  * What a device knows of the payer's standing — the fields of `GET /billing/overview`
  * (docs/billing-harmonization.md §4) that decide the read-only lock, under their wire
@@ -14,6 +15,13 @@ export interface BillingStanding {
     /** When a free grant ends: a beta user's 12 months, an operator's grant. Empty for a
      *  grant without an end (§12.8). */
     comped_until?: DateInput;
+    /** 0.42 (server-kit 0.14, §16.7 A): who may open the provider's portal, as the
+     *  overview's `portal` — `GET /billing/status` says it too, for the payment-failed
+     *  banner (`BillingBanner`'s `portal`). Absent: `"open"`. */
+    portal?: BillingPortalAccess;
+    /** 0.42 (§16.7 A): the buyer's display name, as the overview's `buyer_name`; `null`
+     *  when the buyer is gone or has left the company. */
+    buyer_name?: string | null;
 }
 /**
  * The moment this payer's data becomes read-only by itself, known IN ADVANCE — or `null`

package/dist/billing/billing-standing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/billing/billing-standing.ts"],"sourcesContent":["import { toDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport type { SubscriptionStatus } from \"./billing-labels\";\n\n/**\n * What a device knows of the payer's standing — the fields of `GET /billing/overview`\n * (docs/billing-harmonization.md §4) that decide the read-only lock, under their wire\n * names. Pass the overview as it came; the other fields are ignored.\n */\nexport interface BillingStanding {\n  status: SubscriptionStatus;\n  /** The server's answer at the time of the read (§3.3). */\n  in_good_standing: boolean;\n  /** When a trial ends (§3.2). Empty for a pure guest whose trial has not started (§12.9). */\n  trial_ends_at?: DateInput;\n  /** When a free grant ends: a beta user's 12 months, an operator's grant. Empty for a\n   *  grant without an end (§12.8). */\n  comped_until?: DateInput;\n}\n\n/**\n * The moment this payer's data becomes read-only by itself, known IN ADVANCE — or `null`\n * when no date says so (docs/billing-harmonization.md §12.5).\n *\n * A device writes locally first and sends later (keksdose's outbox, an encrypted budget\n * always), so a lock that only arrives with the server's 402 comes after the UI already\n * said \"saved\" — keksdose's phantom save (dev#496). The two dates that end good standing\n * on a schedule are in the overview, so the device locks itself on time, offline too:\n * a trial at `trial_ends_at`, a grant at `comped_until`. Only `past_due` → `expired`\n * depends on the provider's retries and waits for the next sync.\n */\nexport function billingLockAt(standing: BillingStanding): Date | null {\n  if (standing.status === \"trialing\") return toDate(standing.trial_ends_at ?? null);\n  if (standing.status === \"comped\") return toDate(standing.comped_until ?? null);\n  return null;\n}\n\n/**\n * Whether the payer's data is read-only at `now` (default: the present moment): the\n * server already said so (`in_good_standing: false`), or a date from\n * {@link billingLockAt} has passed since the overview was read. Mirror it into the app's\n * offline write gate and its `WriteLockProvider` (§3.3, §12.5).\n *\n * A GUEST's device cannot do this for the owner: the owner's dates are the owner's\n * personal data (§12.6). An item shared with a guest carries `locked: \"billing\" | null`,\n * which the guest's device mirrors as it comes.\n */\nexport function isBillingReadOnly(standing: BillingStanding, now: number | Date = Date.now()): boolean {\n  if (!standing.in_good_standing) return true;\n  const at = billingLockAt(standing);\n  const instant = typeof now === \"number\" ? now : now.getTime();\n  return at !== null && at.getTime() <= instant;\n}\n\nconst DAY = 86_400_000;\n\n/**\n * Whole calendar days from `now` to `endsAt`, in the device's time zone — 0 on the day\n * itself (and after it), 1 the day before — or `null` for no readable date. The count a\n * trial or grant banner says (\"ends tomorrow\", \"ends in 5 days\"), from the day a reader\n * lives in rather than from 24-hour blocks: a trial ending at 01:00 tomorrow ends\n * \"tomorrow\", not \"today\".\n */\nexport function billingDaysLeft(endsAt: DateInput, now: number | Date = Date.now()): number | null {\n  const end = toDate(endsAt);\n  if (!end) return null;\n  const from = typeof now === \"number\" ? new Date(now) : now;\n  const endDay = new Date(end.getFullYear(), end.getMonth(), end.getDate()).getTime();\n  const fromDay = new Date(from.getFullYear(), from.getMonth(), from.getDate()).getTime();\n  // `round`, not `floor`: a day across a DST change is 23 or 25 hours long.\n  return Math.max(0, Math.round((endDay - fromDay) / DAY));\n}\n"],"mappings":";AAAA,SAAS,cAAc;AA+BhB,SAAS,cAAc,UAAwC;AACpE,MAAI,SAAS,WAAW,WAAY,QAAO,OAAO,SAAS,iBAAiB,IAAI;AAChF,MAAI,SAAS,WAAW,SAAU,QAAO,OAAO,SAAS,gBAAgB,IAAI;AAC7E,SAAO;AACT;AAYO,SAAS,kBAAkB,UAA2B,MAAqB,KAAK,IAAI,GAAY;AACrG,MAAI,CAAC,SAAS,iBAAkB,QAAO;AACvC,QAAM,KAAK,cAAc,QAAQ;AACjC,QAAM,UAAU,OAAO,QAAQ,WAAW,MAAM,IAAI,QAAQ;AAC5D,SAAO,OAAO,QAAQ,GAAG,QAAQ,KAAK;AACxC;AAEA,MAAM,MAAM;AASL,SAAS,gBAAgB,QAAmB,MAAqB,KAAK,IAAI,GAAkB;AACjG,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,OAAO,QAAQ,WAAW,IAAI,KAAK,GAAG,IAAI;AACvD,QAAM,SAAS,IAAI,KAAK,IAAI,YAAY,GAAG,IAAI,SAAS,GAAG,IAAI,QAAQ,CAAC,EAAE,QAAQ;AAClF,QAAM,UAAU,IAAI,KAAK,KAAK,YAAY,GAAG,KAAK,SAAS,GAAG,KAAK,QAAQ,CAAC,EAAE,QAAQ;AAEtF,SAAO,KAAK,IAAI,GAAG,KAAK,OAAO,SAAS,WAAW,GAAG,CAAC;AACzD;","names":[]}
+{"version":3,"sources":["../../src/billing/billing-standing.ts"],"sourcesContent":["import { toDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport type { SubscriptionStatus } from \"./billing-labels\";\nimport type { BillingPortalAccess } from \"./billing-overview\";\n\n/**\n * What a device knows of the payer's standing — the fields of `GET /billing/overview`\n * (docs/billing-harmonization.md §4) that decide the read-only lock, under their wire\n * names. Pass the overview as it came; the other fields are ignored.\n */\nexport interface BillingStanding {\n  status: SubscriptionStatus;\n  /** The server's answer at the time of the read (§3.3). */\n  in_good_standing: boolean;\n  /** When a trial ends (§3.2). Empty for a pure guest whose trial has not started (§12.9). */\n  trial_ends_at?: DateInput;\n  /** When a free grant ends: a beta user's 12 months, an operator's grant. Empty for a\n   *  grant without an end (§12.8). */\n  comped_until?: DateInput;\n  /** 0.42 (server-kit 0.14, §16.7 A): who may open the provider's portal, as the\n   *  overview's `portal` — `GET /billing/status` says it too, for the payment-failed\n   *  banner (`BillingBanner`'s `portal`). Absent: `\"open\"`. */\n  portal?: BillingPortalAccess;\n  /** 0.42 (§16.7 A): the buyer's display name, as the overview's `buyer_name`; `null`\n   *  when the buyer is gone or has left the company. */\n  buyer_name?: string | null;\n}\n\n/**\n * The moment this payer's data becomes read-only by itself, known IN ADVANCE — or `null`\n * when no date says so (docs/billing-harmonization.md §12.5).\n *\n * A device writes locally first and sends later (keksdose's outbox, an encrypted budget\n * always), so a lock that only arrives with the server's 402 comes after the UI already\n * said \"saved\" — keksdose's phantom save (dev#496). The two dates that end good standing\n * on a schedule are in the overview, so the device locks itself on time, offline too:\n * a trial at `trial_ends_at`, a grant at `comped_until`. Only `past_due` → `expired`\n * depends on the provider's retries and waits for the next sync.\n */\nexport function billingLockAt(standing: BillingStanding): Date | null {\n  if (standing.status === \"trialing\") return toDate(standing.trial_ends_at ?? null);\n  if (standing.status === \"comped\") return toDate(standing.comped_until ?? null);\n  return null;\n}\n\n/**\n * Whether the payer's data is read-only at `now` (default: the present moment): the\n * server already said so (`in_good_standing: false`), or a date from\n * {@link billingLockAt} has passed since the overview was read. Mirror it into the app's\n * offline write gate and its `WriteLockProvider` (§3.3, §12.5).\n *\n * A GUEST's device cannot do this for the owner: the owner's dates are the owner's\n * personal data (§12.6). An item shared with a guest carries `locked: \"billing\" | null`,\n * which the guest's device mirrors as it comes.\n */\nexport function isBillingReadOnly(standing: BillingStanding, now: number | Date = Date.now()): boolean {\n  if (!standing.in_good_standing) return true;\n  const at = billingLockAt(standing);\n  const instant = typeof now === \"number\" ? now : now.getTime();\n  return at !== null && at.getTime() <= instant;\n}\n\nconst DAY = 86_400_000;\n\n/**\n * Whole calendar days from `now` to `endsAt`, in the device's time zone — 0 on the day\n * itself (and after it), 1 the day before — or `null` for no readable date. The count a\n * trial or grant banner says (\"ends tomorrow\", \"ends in 5 days\"), from the day a reader\n * lives in rather than from 24-hour blocks: a trial ending at 01:00 tomorrow ends\n * \"tomorrow\", not \"today\".\n */\nexport function billingDaysLeft(endsAt: DateInput, now: number | Date = Date.now()): number | null {\n  const end = toDate(endsAt);\n  if (!end) return null;\n  const from = typeof now === \"number\" ? new Date(now) : now;\n  const endDay = new Date(end.getFullYear(), end.getMonth(), end.getDate()).getTime();\n  const fromDay = new Date(from.getFullYear(), from.getMonth(), from.getDate()).getTime();\n  // `round`, not `floor`: a day across a DST change is 23 or 25 hours long.\n  return Math.max(0, Math.round((endDay - fromDay) / DAY));\n}\n"],"mappings":";AAAA,SAAS,cAAc;AAuChB,SAAS,cAAc,UAAwC;AACpE,MAAI,SAAS,WAAW,WAAY,QAAO,OAAO,SAAS,iBAAiB,IAAI;AAChF,MAAI,SAAS,WAAW,SAAU,QAAO,OAAO,SAAS,gBAAgB,IAAI;AAC7E,SAAO;AACT;AAYO,SAAS,kBAAkB,UAA2B,MAAqB,KAAK,IAAI,GAAY;AACrG,MAAI,CAAC,SAAS,iBAAkB,QAAO;AACvC,QAAM,KAAK,cAAc,QAAQ;AACjC,QAAM,UAAU,OAAO,QAAQ,WAAW,MAAM,IAAI,QAAQ;AAC5D,SAAO,OAAO,QAAQ,GAAG,QAAQ,KAAK;AACxC;AAEA,MAAM,MAAM;AASL,SAAS,gBAAgB,QAAmB,MAAqB,KAAK,IAAI,GAAkB;AACjG,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,CAAC,IAAK,QAAO;AACjB,QAAM,OAAO,OAAO,QAAQ,WAAW,IAAI,KAAK,GAAG,IAAI;AACvD,QAAM,SAAS,IAAI,KAAK,IAAI,YAAY,GAAG,IAAI,SAAS,GAAG,IAAI,QAAQ,CAAC,EAAE,QAAQ;AAClF,QAAM,UAAU,IAAI,KAAK,KAAK,YAAY,GAAG,KAAK,SAAS,GAAG,KAAK,QAAQ,CAAC,EAAE,QAAQ;AAEtF,SAAO,KAAK,IAAI,GAAG,KAAK,OAAO,SAAS,WAAW,GAAG,CAAC;AACzD;","names":[]}

package/dist/billing/cancel-subscription.d.ts

@@ -0,0 +1,46 @@
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { DateInput } from "../lib/format.js";
+import type { BillingLabels } from "./billing-labels.js";
+export interface CancelSubscriptionConfirmProps {
+    open: boolean;
+    /** `false` when the admin dismisses it — Back, Escape, the backdrop. Confirm leaves it
+     *  open: close it once `POST /billing/cancel` answers. */
+    onOpenChange: (open: boolean) => void;
+    /** The overview's `current_period_end`: the day the subscription ends. Formatted with
+     *  the kit's date formatter (`formatDate`, `"medium"`). */
+    periodEnd: DateInput;
+    /** Confirm: the app's `POST /billing/cancel` (server-kit 0.14, §16.3). */
+    onConfirm: () => void;
+    /** The cancel is under way: Confirm's spinner, no second press, and Escape and Back
+     *  don't close. */
+    pending?: boolean;
+    /** The date's locale. Default: the provider's. */
+    locale?: string;
+    /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */
+    labels?: LabelOverride<BillingLabels>;
+}
+/**
+ * The in-app cancel's confirm (docs/billing-harmonization.md §16.2 decision 2, §16.4,
+ * ui-kit 0.42): "Cancel subscription" for an admin the provider's portal doesn't open for
+ * (`SubscriptionActions`' `portal="buyer_only"` → `onCancelInApp`). It names the day the
+ * subscription ends — "Your subscription ends on 9 Nov 2026. Until then everything works
+ * as before." — and its button reads "Cancel subscription now" (German "Jetzt kündigen",
+ * the confirmation button of §312k BGB).
+ *
+ *     <CancelSubscriptionConfirm
+ *       open={asking}
+ *       onOpenChange={setAsking}
+ *       periodEnd={overview.current_period_end}
+ *       pending={cancel.isPending}
+ *       onConfirm={() => cancel.mutate()}
+ *     />
+ *
+ * The cancel is at the period's end (Paddle's `cancel`, not immediately); the row follows
+ * by webhook (`cancel_at_period_end`), as after a cancel in the portal, and
+ * `SubscriptionActions` then offers "Keep subscription" (`onResume`).
+ *
+ * It takes no billing lock (`COMMIT_EXCEPT_BILLING` built in, §3.3): a read-only payer
+ * may always cancel. A demo lock still holds it, as the server's demo guard does. The kit
+ * sends no request.
+ */
+export declare function CancelSubscriptionConfirm({ open, onOpenChange, periodEnd, onConfirm, pending, locale: localeProp, labels: labelsProp, }: CancelSubscriptionConfirmProps): import("react").JSX.Element;