@eifi1/ui-kit 0.41.0 → 0.43.0

package/dist/admin/admin-sections.js

@@ -0,0 +1,81 @@
+"use client";
+import { createElement } from "react";
+import { History, LayoutDashboard, Mail, Receipt, Users } from "lucide-react";
+import { DEFAULT_ADMIN_AREA_LABELS } from "./admin-area-labels.js";
+const ADMIN_SECTIONS = Object.freeze([
+  { id: "overview", icon: LayoutDashboard },
+  { id: "users", icon: Users },
+  { id: "invitations", icon: Mail },
+  { id: "billing", icon: Receipt },
+  { id: "activity", icon: History }
+]);
+const OWN_DEFAULT_AFTER = "invitations";
+function orderSections(own, leaveOutIds) {
+  const leaveOut = new Set(leaveOutIds ?? []);
+  const shared = new Set(ADMIN_SECTIONS.map((s) => s.id));
+  const ownIds = /* @__PURE__ */ new Set();
+  for (const section of own) {
+    if (shared.has(section.id)) throw new Error(`adminSections: "${section.id}" is a shared section's id`);
+    if (ownIds.has(section.id)) throw new Error(`adminSections: "${section.id}" is given twice`);
+    ownIds.add(section.id);
+  }
+  for (const section of own) {
+    const after = section.after;
+    if (after !== void 0 && !shared.has(after) && !ownIds.has(after)) {
+      throw new Error(`adminSections: "${section.id}" goes after "${after}", which is no section`);
+    }
+  }
+  const followers = /* @__PURE__ */ new Map();
+  for (const section of own) {
+    const after = section.after ?? OWN_DEFAULT_AFTER;
+    followers.set(after, [...followers.get(after) ?? [], section]);
+  }
+  const out = [];
+  const placed = /* @__PURE__ */ new Set();
+  const placeAfter = (id) => {
+    for (const section of followers.get(id) ?? []) {
+      out.push({ own: section });
+      placed.add(section.id);
+      placeAfter(section.id);
+    }
+  };
+  for (const definition of ADMIN_SECTIONS) {
+    if (!leaveOut.has(definition.id)) out.push({ shared: definition });
+    placeAfter(definition.id);
+  }
+  const stuck = own.filter((s) => !placed.has(s.id)).map((s) => s.id);
+  if (stuck.length) throw new Error(`adminSections: ${stuck.join(", ")} follow each other in a circle`);
+  return out;
+}
+function adminSectionOrder(own = [], options = {}) {
+  return orderSections(own, options.leaveOut).map(
+    (s) => "shared" in s ? s.shared.id : s.own.id
+  );
+}
+function adminSections(labels, own = [], options = {}) {
+  const words = labels ?? DEFAULT_ADMIN_AREA_LABELS;
+  return orderSections(own, options.leaveOut).map((s) => {
+    if ("own" in s) {
+      const { after: _after, ...group } = s.own;
+      return group;
+    }
+    const { id, icon } = s.shared;
+    const visible = options.visible?.[id];
+    return {
+      id,
+      icon: createElement(icon, { "aria-hidden": true }),
+      title: words.sections[id].title,
+      help: words.sections[id].help,
+      // 0.43 (kastlan): the overview is a page of tiles, not of setting cards — it shows
+      // with no entry of its own.
+      ...id === "overview" ? { standalone: true } : null,
+      ...visible === void 0 ? null : { visible }
+    };
+  });
+}
+export {
+  ADMIN_SECTIONS,
+  adminSectionOrder,
+  adminSections
+};
+//# sourceMappingURL=admin-sections.js.map

package/dist/admin/admin-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/admin/admin-sections.tsx"],"sourcesContent":["import { createElement } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { History, LayoutDashboard, Mail, Receipt, Users } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport type { SettingsGroup } from \"../settings/settings-catalogue\";\nimport { DEFAULT_ADMIN_AREA_LABELS } from \"./admin-area-labels\";\nimport type { AdminAreaLabels, AdminSharedSection } from \"./admin-area-labels\";\n\n/**\n * The admin area's sections (0.42.0, docs/admin-harmonization.md §2.3, §6.8): the five\n * every app shares, in the template's order, and the helper that builds an app's\n * `SettingsLayout` catalogue groups from them and the app's own.\n */\n\n/** One shared section: its path segment and its icon. The words are `adminArea.sections`. */\nexport interface AdminSectionDefinition {\n  id: AdminSharedSection;\n  icon: LucideIcon;\n}\n\n/**\n * The shared sections in the template's order (§2.3 decision 10, §6.13): Overview, Users,\n * Invitations, Billing, Activity. An app's own sections go between them\n * ({@link adminSections}).\n */\nexport const ADMIN_SECTIONS: readonly AdminSectionDefinition[] = Object.freeze([\n  { id: \"overview\", icon: LayoutDashboard },\n  { id: \"users\", icon: Users },\n  { id: \"invitations\", icon: Mail },\n  { id: \"billing\", icon: Receipt },\n  { id: \"activity\", icon: History },\n]);\n\n/**\n * One of the app's own sections: a catalogue group with its words, plus where it goes.\n * `after` names the section it follows — a shared one or another of the app's own. Left\n * out, it goes where the template puts an app's sections, after Invitations and before\n * Billing, in the order given.\n */\nexport interface AdminOwnSection<G extends string = string> extends SettingsGroup<G> {\n  after?: AdminSharedSection | G;\n}\n\n/** Where one section goes, without its words — what {@link adminSectionOrder} takes. An\n *  {@link AdminOwnSection} is one. */\nexport interface AdminSectionPlace<G extends string = string> {\n  id: G;\n  after?: AdminSharedSection | G;\n}\n\n/** The order's options: the shared sections an app does not have. */\nexport interface AdminSectionOrderOptions<L extends AdminSharedSection = AdminSharedSection> {\n  /**\n   * Shared sections this app does not have — keksdose and Kurvenschmiede have no billing\n   * view (`[\"billing\"]`). Left out, every shared section is in the catalogue. Since 0.43\n   * the result's type leaves them out too, so no cast is needed to drop `\"billing\"` —\n   * when TypeScript infers the type arguments. With them written out, name the left-out\n   * ones as the second (`adminSections<Own, \"billing\">(…)`); `adminSections<Own>(…)`\n   * keeps every shared id in the type, as before.\n   */\n  leaveOut?: readonly L[];\n}\n\nexport interface AdminSectionsOptions<L extends AdminSharedSection = AdminSharedSection> extends AdminSectionOrderOptions<L> {\n  /**\n   * A shared section that is in the catalogue but hidden for now, as\n   * {@link SettingsGroup.visible}: kastlan's `{ billing: billingEnabled }` (settings §5),\n   * whose path then acts as an unknown one.\n   */\n  visible?: Partial<Record<AdminSharedSection, boolean>>;\n}\n\n/** The shared sections an app keeps when it leaves out `L`. A `leaveOut` typed as the\n *  whole union (a variable of `AdminSharedSection[]`) says nothing about which, so it\n *  narrows nothing. */\nexport type AdminKeptSection<L extends AdminSharedSection = AdminSharedSection> = [AdminSharedSection] extends [L]\n  ? AdminSharedSection\n  : Exclude<AdminSharedSection, L>;\n\n/** The shared section after which the app's sections go when they name no place. */\nconst OWN_DEFAULT_AFTER: AdminSharedSection = \"invitations\";\n\n/** The shared and own sections in their order — a shared one as its definition, an own\n *  one as given. Throws as {@link adminSections} documents. */\nfunction orderSections<S extends AdminSectionPlace<string>>(\n  own: readonly S[],\n  leaveOutIds: readonly AdminSharedSection[] | undefined,\n): ({ shared: AdminSectionDefinition } | { own: S })[] {\n  const leaveOut = new Set<string>(leaveOutIds ?? []);\n  const shared = new Set<string>(ADMIN_SECTIONS.map((s) => s.id));\n  const ownIds = new Set<string>();\n  for (const section of own) {\n    if (shared.has(section.id)) throw new Error(`adminSections: \"${section.id}\" is a shared section's id`);\n    if (ownIds.has(section.id)) throw new Error(`adminSections: \"${section.id}\" is given twice`);\n    ownIds.add(section.id);\n  }\n  for (const section of own) {\n    const after = section.after;\n    if (after !== undefined && !shared.has(after) && !ownIds.has(after)) {\n      throw new Error(`adminSections: \"${section.id}\" goes after \"${after}\", which is no section`);\n    }\n  }\n\n  // Each section's followers, in the order given: the shared ones, then the own ones\n  // under their `after`, recursively, so an own section may follow another own one.\n  const followers = new Map<string, S[]>();\n  for (const section of own) {\n    const after = section.after ?? OWN_DEFAULT_AFTER;\n    followers.set(after, [...(followers.get(after) ?? []), section]);\n  }\n\n  const out: ({ shared: AdminSectionDefinition } | { own: S })[] = [];\n  const placed = new Set<string>();\n  const placeAfter = (id: string) => {\n    for (const section of followers.get(id) ?? []) {\n      out.push({ own: section });\n      placed.add(section.id);\n      placeAfter(section.id);\n    }\n  };\n  for (const definition of ADMIN_SECTIONS) {\n    if (!leaveOut.has(definition.id)) out.push({ shared: definition });\n    // A left-out section's followers keep its place.\n    placeAfter(definition.id);\n  }\n  const stuck = own.filter((s) => !placed.has(s.id)).map((s) => s.id);\n  if (stuck.length) throw new Error(`adminSections: ${stuck.join(\", \")} follow each other in a circle`);\n  return out;\n}\n\n/**\n * The admin area's section ids in the template's order (0.43, keksdose) — what\n * {@link adminSections} builds its groups in, without the words: for an app that needs the\n * ORDER only (a router's list of paths, a test), outside a component, with no labels.\n *\n *     adminSectionOrder([{ id: \"metrics\", after: \"overview\" }], { leaveOut: [\"billing\"] })\n *     // [\"overview\", \"metrics\", \"users\", \"invitations\", \"activity\"]\n *\n * Throws as {@link adminSections} does.\n */\nexport function adminSectionOrder<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(\n  own: readonly AdminSectionPlace<G>[] = [],\n  options: AdminSectionOrderOptions<L> = {},\n): (AdminKeptSection<L> | G)[] {\n  return orderSections(own, options.leaveOut).map((s) =>\n    \"shared\" in s ? (s.shared.id as AdminKeptSection<L>) : s.own.id,\n  );\n}\n\n/**\n * An app's admin catalogue groups, in the template's order (§2.3 decision 10, §6.8): the\n * shared sections with the kit's icons and words, and the app's own at the places they\n * name. The result is `SettingsLayout`'s `groups`; the entries stay the app's (a group\n * with no visible entry is hidden, as on any settings page — except, since 0.43, the\n * Overview, a page of tiles that needs no entry: it is `standalone`). Since 0.43 the\n * result's type leaves out the `leaveOut` sections, and {@link adminSectionOrder} gives\n * the same order as ids, without words.\n *\n *     const groups = adminSections(useAdminAreaLabels(), [\n *       { id: \"metrics\", icon: <BarChart3 />, title: t(\"…\"), help: t(\"…\"), after: \"overview\" },\n *       { id: \"messaging\", icon: <MessageSquare />, title: t(\"…\"), help: t(\"…\") },\n *       { id: \"health\", icon: <HeartPulse />, title: t(\"…\"), help: t(\"…\"), after: \"billing\" },\n *     ], { leaveOut: [\"billing\"] });\n *\n * gives keksdose's overview, metrics, users, invitations, messaging, health, activity.\n * An `after` that names a left-out section takes that section's place. Kurvenschmiede's\n * Teams needs no `after`: between Invitations and Activity is the default.\n *\n * `labels` is the `adminArea` namespace, resolved — {@link useAdminAreaLabels} inside a\n * component, or the app's catalogue for the language; `undefined` is English. Throws for\n * an own section whose id is a shared one, an id given twice, or an `after` that names no\n * section: the catalogue is built once, and a section quietly missing from it is worse.\n */\nexport function adminSections<G extends string = never, L extends AdminSharedSection = AdminSharedSection>(\n  labels: AdminAreaLabels | undefined,\n  own: readonly AdminOwnSection<G>[] = [],\n  options: AdminSectionsOptions<L> = {},\n): SettingsGroup<AdminKeptSection<L> | G>[] {\n  const words = labels ?? DEFAULT_ADMIN_AREA_LABELS;\n  return orderSections(own, options.leaveOut).map((s): SettingsGroup<AdminKeptSection<L> | G> => {\n    if (\"own\" in s) {\n      const { after: _after, ...group } = s.own;\n      return group;\n    }\n    const { id, icon } = s.shared;\n    const visible = options.visible?.[id];\n    return {\n      id: id as AdminKeptSection<L>,\n      icon: createElement(icon, { \"aria-hidden\": true }) as ReactNode,\n      title: words.sections[id].title,\n      help: words.sections[id].help,\n      // 0.43 (kastlan): the overview is a page of tiles, not of setting cards — it shows\n      // with no entry of its own.\n      ...(id === \"overview\" ? { standalone: true } : null),\n      ...(visible === undefined ? null : { visible }),\n    };\n  });\n}\n"],"mappings":"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","names":[]}

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).
@@ -50,6 +52,14 @@ interface BillingBannerBaseProps extends Omit<ComponentPropsWithRef<"div">, "chi
     actionLabel?: string;
     /** The action is under way: the button's spinner, no second press. */
     actionPending?: boolean;
+    /**
+     * 0.43 (§17): the action opens the provider's portal in a NEW TAB (`openProviderPage`
+     * in {@link onAction}): the external-link mark, "(opens in a new tab)" for a reader,
+     * and `target="_blank"` on an {@link actionHref}. Default: true for `payment-failed`
+     * with `onAction` (the portal's card page), false otherwise — an `actionHref` is
+     * usually the app's own subscription page.
+     */
+    actionNewTab?: boolean;
     /** An × that calls this; the app removes the banner and remembers that it did. */
     onDismiss?: () => void;
     dismissLabel?: string;
@@ -61,16 +71,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";
+    /**
+     * 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: "payment-failed" | "plan-ended" | "processing";
+    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

@@ -1,10 +1,12 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { CreditCard, Hourglass, PencilOff } from "lucide-react";
+import { DEFAULT_COMMON_LABELS, useKitLabels } from "../i18n/kit-labels.js";
 import { AlertBanner } from "../components/alert-banner.js";
 import { Button } from "../components/button.js";
 import { Spinner } from "../components/spinner.js";
 import { useBillingLabels } from "./billing-labels.js";
+import { ExternalMark } from "./subscription-actions.js";
 const LAST_DAYS = 3;
 function defaultTone(kind, daysLeft) {
   switch (kind) {
@@ -24,6 +26,8 @@ function BillingBanner(props) {
     kind,
     daysLeft,
     item,
+    portal,
+    buyerName,
     tone,
     variant = "strip",
     size,
@@ -31,6 +35,7 @@ function BillingBanner(props) {
     onAction,
     actionLabel,
     actionPending,
+    actionNewTab,
     onDismiss,
     dismissLabel,
     labels: labelsProp,
@@ -38,10 +43,12 @@ function BillingBanner(props) {
     ...rest
   } = props;
   const labels = useBillingLabels(labelsProp);
+  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
   const days = Math.max(0, Math.floor(daysLeft ?? 0));
   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 +61,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 +82,26 @@ 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 newTab = actionNewTab ?? (kind === "payment-failed" && actionHref === void 0 && onAction !== void 0);
+  const action = askBuyer || words === void 0 || actionHref === void 0 && onAction === void 0 ? void 0 : actionHref !== void 0 ? /* @__PURE__ */ jsxs(Button, { href: actionHref, variant: "secondary", size: "sm", external: newTab || void 0, children: [
+    words,
+    newTab && /* @__PURE__ */ jsx(ExternalMark, {})
+  ] }) : /* @__PURE__ */ jsxs(
+    Button,
+    {
+      type: "button",
+      variant: "secondary",
+      size: "sm",
+      onClick: onAction,
+      pending: actionPending,
+      className: newTab ? "relative" : void 0,
+      "data-portal-action": newTab ? "payment_method" : void 0,
+      children: [
+        words,
+        newTab && /* @__PURE__ */ jsx(ExternalMark, { reader: common.opensInNewTab })
+      ]
+    }
+  );
   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 { DEFAULT_COMMON_LABELS, useKitLabels } from \"../i18n/kit-labels\";\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\";\nimport { ExternalMark } from \"./subscription-actions\";\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  /**\n   * 0.43 (§17): the action opens the provider's portal in a NEW TAB (`openProviderPage`\n   * in {@link onAction}): the external-link mark, \"(opens in a new tab)\" for a reader,\n   * and `target=\"_blank\"` on an {@link actionHref}. Default: true for `payment-failed`\n   * with `onAction` (the portal's card page), false otherwise — an `actionHref` is\n   * usually the app's own subscription page.\n   */\n  actionNewTab?: 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    actionNewTab,\n    onDismiss,\n    dismissLabel,\n    labels: labelsProp,\n    role,\n    ...rest\n  } = props;\n  const labels = useBillingLabels(labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\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 newTab = actionNewTab ?? (kind === \"payment-failed\" && actionHref === undefined && onAction !== undefined);\n  const action =\n    askBuyer || words === undefined || (actionHref === undefined && onAction === undefined) ? undefined : actionHref !== undefined ? (\n      <Button href={actionHref} variant=\"secondary\" size=\"sm\" external={newTab || undefined}>\n        {words}\n        {newTab && <ExternalMark />}\n      </Button>\n    ) : (\n      <Button\n        type=\"button\"\n        variant=\"secondary\"\n        size=\"sm\"\n        onClick={onAction}\n        pending={actionPending}\n        className={newTab ? \"relative\" : undefined}\n        data-portal-action={newTab ? \"payment_method\" : undefined}\n      >\n        {words}\n        {newTab && <ExternalMark reader={common.opensInNewTab} />}\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":"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","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,28 @@ 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;
+    /** 0.43 (§17.3): the muted note under the actions while the portal opens in a new tab —
+     *  `provider` the provider's name ("Paddle"), `app` the app's; without the app, "this
+     *  page". "Payment and invoices open at Paddle in a new tab; Kastlan stays open here." */
+    portalOpensNewTab: (provider: string, app?: string) => string;
     /** While the checkout opens. */
     payOpening: string;
     /** A link without a transaction, or billing switched off: nothing to pay. */
@@ -154,6 +183,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,12 @@ 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",
+  portalOpensNewTab: (provider, app) => `Payment and invoices open at ${provider} in a new tab; ${app ? `${app} stays open here` : "this page stays open"}.`,
   payOpening: "Opening the secure checkout\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 +80,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  /** 0.43 (§17.3): the muted note under the actions while the portal opens in a new tab —\n   *  `provider` the provider's name (\"Paddle\"), `app` the app's; without the app, \"this\n   *  page\". \"Payment and invoices open at Paddle in a new tab; Kastlan stays open here.\" */\n  portalOpensNewTab: (provider: string, app?: string) => 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  portalOpensNewTab: (provider, app) =>\n    `Payment and invoices open at ${provider} in a new tab; ${app ? `${app} stays open here` : \"this page stays open\"}.`,\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":"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","names":[]}