@eifi1/ui-kit 0.53.0 → 0.55.0

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  /**\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\n      ? `“${item}” is read-only for now; its owner can lift that.`\n      : \"This is read-only for now; its owner can lift that.\",\n  processing:\n    \"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) => (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;AA8OD,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,OACI,SAAI,IAAI,0DACR;AAAA,EACN,YACE;AAAA,EACF,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,EAClB,mBAAmB,CAAC,UAAU,QAC5B,gCAAgC,QAAQ,kBAAkB,MAAM,GAAG,GAAG,qBAAqB,sBAAsB;AAAA,EAEnH,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,UAAW,UAAU,IAAI,gCAAgC,GAAG,KAAK;AAAA,EAClF,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  /* ── SubscriptionStanding (0.55, §7; Marcel 2026-11-04) ── */\n  /**\n   * The subscription's standing in one line, under the plan's name: `SubscriptionStanding`\n   * and `subscriptionStanding` say the FIRST that applies, in this order. `date` arrives\n   * formatted. The words are keksdose's reviewed ones (`billing.trial_until`, …), which\n   * kastlan's page said in words of its own (kastlan reuse audit 2026-11-02, proposal 3).\n   */\n  standing: {\n    /** Out of good standing (§3.3): the first sentence of {@link BillingLabels.planEnded}\n     *  and {@link BillingLabels.lockReason}, which the plan-ended banner goes on with —\n     *  \"Your plan has ended.\" */\n    ended: string;\n    /** `past_due` while the provider retries (§3.3): still in good standing, and NO date —\n     *  the payment-failed banner carries the action, and \"renews on\" would promise what\n     *  the retries may not keep. */\n    pastDue: string;\n    /** `trialing`, with its `trial_ends_at`: \"Trial until 9 Nov 2026\". */\n    trialUntil: (date: string) => string;\n    /** `comped`, with its `comped_until`: \"Free until 9 Nov 2026\". */\n    freeUntil: (date: string) => string;\n    /** `comped` without an end (§12.8): \"Free, with no end date\". */\n    free: string;\n    /** Set to cancel at the period's end (`cancel_at_period_end`): \"Ends on 9 Nov 2026\". */\n    endsOn: (date: string) => string;\n    /** `active`, at `current_period_end`: \"Renews on 9 Nov 2026\". */\n    renewsOn: (date: string) => string;\n  };\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  standing: {\n    ended: \"Your plan has ended.\",\n    pastDue: \"Payment failed — we’re retrying. Your plan stays active meanwhile.\",\n    trialUntil: (date) => `Trial until ${date}`,\n    freeUntil: (date) => `Free until ${date}`,\n    free: \"Free, with no end date\",\n    endsOn: (date) => `Ends on ${date}`,\n    renewsOn: (date) => `Renews on ${date}`,\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\n      ? `“${item}” is read-only for now; its owner can lift that.`\n      : \"This is read-only for now; its owner can lift that.\",\n  processing:\n    \"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) => (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":[]}

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

@@ -0,0 +1,61 @@
+import type { ComponentPropsWithRef } from "react";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { DateInput } from "../lib/format.js";
+import type { BillingLabels } from "./billing-labels.js";
+import type { BillingOverview } from "./billing-overview.js";
+/**
+ * What the standing line reads of `GET /billing/overview` (docs/billing-harmonization.md
+ * §4), under the wire names. Pass the overview as it came — or with the app's own
+ * knowledge laid over it: kastlan says "Ends on …" the moment its in-app cancel is asked
+ * (`{ ...overview, cancel_at_period_end: view.cancelScheduled }`, `useCancelRequest`).
+ */
+export type SubscriptionStandingOverview = Pick<BillingOverview, "status" | "in_good_standing" | "trial_ends_at" | "comped_until" | "current_period_end" | "cancel_at_period_end">;
+/**
+ * The subscription's standing in one line — or `null` when nothing applies (kastlan reuse
+ * audit 2026-11-02, proposal 3; billing §7, Marcel 2026-11-04). The FIRST that applies:
+ *
+ * 1. not in good standing → "Your plan has ended." (`billing.standing.ended`, the first
+ *    sentence of the plan-ended banner's);
+ * 2. `past_due` → "Payment failed — we’re retrying. Your plan stays active meanwhile.",
+ *    with NO renewal date: the payment-failed banner keeps the action;
+ * 3. `trialing` → "Trial until {trial_ends_at}" (a pure guest's trial that has not
+ *    started, §12.9, has no date and says nothing);
+ * 4. `comped` → "Free until {comped_until}", or "Free, with no end date";
+ * 5. set to cancel at the period's end → "Ends on {current_period_end}";
+ * 6. `active` → "Renews on {current_period_end}";
+ * 7. otherwise nothing.
+ *
+ * kastlan and keksdose each wrote this line, and they drifted: kastlan said nothing for
+ * an ended plan or a failed payment, and keksdose's `past_due` said "Renews on …".
+ *
+ * `format` prints a date in a sentence; default the kit's `formatDate` (`"medium"`) in
+ * the runtime's locale. Inside a component, `<SubscriptionStanding>` prints it the
+ * provider's way — its `formatDate` (the app's date preference), else its locale and
+ * time zone.
+ */
+export declare function subscriptionStanding(overview: SubscriptionStandingOverview, labels: Pick<BillingLabels, "standing">, format?: (value: DateInput) => string): string | null;
+export interface SubscriptionStandingProps extends Omit<ComponentPropsWithRef<"p">, "children"> {
+    /** The overview, or the fields of it the line reads. */
+    overview: SubscriptionStandingOverview;
+    /** The date's locale. Default: the provider's. */
+    locale?: string;
+    /** Prop > `<UiKitProvider labels={{ billing: { standing } }}>` > English. */
+    labels?: LabelOverride<BillingLabels>;
+}
+/**
+ * {@link subscriptionStanding} as the muted line under the plan's name on the
+ * subscription page (billing §7) — nothing at all when no line applies. The date is a
+ * day in a sentence, without its weekday: the `<UiKitProvider formatDate>` (the app's
+ * date preference) when it set one, else the kit's `formatDate`, `"medium"`, in the
+ * provider's locale and `timeZone` — as `CancelSubscriptionConfirm` names the same day.
+ *
+ * Carries `data-standing` with the line's key (`ended`, `pastDue`, `trialUntil`,
+ * `freeUntil`, `free`, `endsOn`, `renewsOn`), for a test or a style hook.
+ *
+ *     <SubscriptionStanding overview={overview} />
+ *
+ * Back from a checkout whose webhook has not landed (§12.21), the ended line is the stale
+ * one: render it only when `useCheckoutProcessing`'s `processing` is false, and the
+ * processing banner speaks meanwhile.
+ */
+export declare function SubscriptionStanding({ overview, locale: localeProp, labels: labelsProp, className, ...rest }: SubscriptionStandingProps): import("react").JSX.Element | null;

package/dist/billing/subscription-standing.js

@@ -0,0 +1,51 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { cn } from "../lib/cn.js";
+import { useDayFormatter } from "../lib/day-format.js";
+import { formatDate } from "../lib/format.js";
+import { useBillingLabels } from "./billing-labels.js";
+const given = (value) => value !== null && value !== void 0 && value !== "";
+function standingOf(o) {
+  if (!o.in_good_standing) return { kind: "ended" };
+  if (o.status === "past_due") return { kind: "pastDue" };
+  if (o.status === "trialing") return given(o.trial_ends_at) ? { kind: "trialUntil", date: o.trial_ends_at } : null;
+  if (o.status === "comped") {
+    return given(o.comped_until) ? { kind: "freeUntil", date: o.comped_until } : { kind: "free" };
+  }
+  if (!given(o.current_period_end)) return null;
+  if (o.cancel_at_period_end) return { kind: "endsOn", date: o.current_period_end };
+  if (o.status === "active") return { kind: "renewsOn", date: o.current_period_end };
+  return null;
+}
+function standingText(s, words, day) {
+  switch (s.kind) {
+    case "ended":
+    case "pastDue":
+    case "free":
+      return words[s.kind];
+    default:
+      return words[s.kind](day(s.date));
+  }
+}
+function subscriptionStanding(overview, labels, format = (value) => formatDate(value)) {
+  const s = standingOf(overview);
+  return s && standingText(s, labels.standing, format);
+}
+function SubscriptionStanding({
+  overview,
+  locale: localeProp,
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useBillingLabels(labelsProp);
+  const day = useDayFormatter(void 0, localeProp);
+  const s = standingOf(overview);
+  if (!s) return null;
+  return /* @__PURE__ */ jsx("p", { ...rest, "data-standing": s.kind, className: cn("text-sm text-muted", className), children: standingText(s, labels.standing, (value) => day(value)) });
+}
+export {
+  SubscriptionStanding,
+  subscriptionStanding
+};
+//# sourceMappingURL=subscription-standing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/subscription-standing.tsx"],"sourcesContent":["import type { ComponentPropsWithRef } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useDayFormatter } from \"../lib/day-format\";\nimport { formatDate } from \"../lib/format\";\nimport type { DateInput } from \"../lib/format\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\nimport type { BillingOverview } from \"./billing-overview\";\n\n/**\n * What the standing line reads of `GET /billing/overview` (docs/billing-harmonization.md\n * §4), under the wire names. Pass the overview as it came — or with the app's own\n * knowledge laid over it: kastlan says \"Ends on …\" the moment its in-app cancel is asked\n * (`{ ...overview, cancel_at_period_end: view.cancelScheduled }`, `useCancelRequest`).\n */\nexport type SubscriptionStandingOverview = Pick<\n  BillingOverview,\n  \"status\" | \"in_good_standing\" | \"trial_ends_at\" | \"comped_until\" | \"current_period_end\" | \"cancel_at_period_end\"\n>;\n\n/** Which of `billing.standing`'s lines applies, and the date it names. */\ntype Standing =\n  | { kind: \"ended\" | \"pastDue\" | \"free\" }\n  | { kind: \"trialUntil\" | \"freeUntil\" | \"endsOn\" | \"renewsOn\"; date: DateInput };\n\nconst given = (value: DateInput): boolean => value !== null && value !== undefined && value !== \"\";\n\n/** Marcel's order (billing §7, 2026-11-04): the first that applies, or none. */\nfunction standingOf(o: SubscriptionStandingOverview): Standing | null {\n  // The server's word beats the status: `canceled` and `expired` are never in good\n  // standing, and a lapsed `past_due` is no longer \"retrying\" (§3.3).\n  if (!o.in_good_standing) return { kind: \"ended\" };\n  // Still in good standing, and no date: a renewal the retries may not reach.\n  if (o.status === \"past_due\") return { kind: \"pastDue\" };\n  if (o.status === \"trialing\") return given(o.trial_ends_at) ? { kind: \"trialUntil\", date: o.trial_ends_at } : null;\n  if (o.status === \"comped\") {\n    return given(o.comped_until) ? { kind: \"freeUntil\", date: o.comped_until } : { kind: \"free\" };\n  }\n  if (!given(o.current_period_end)) return null;\n  if (o.cancel_at_period_end) return { kind: \"endsOn\", date: o.current_period_end };\n  if (o.status === \"active\") return { kind: \"renewsOn\", date: o.current_period_end };\n  return null;\n}\n\nfunction standingText(s: Standing, words: BillingLabels[\"standing\"], day: (value: DateInput) => string): string {\n  switch (s.kind) {\n    case \"ended\":\n    case \"pastDue\":\n    case \"free\":\n      return words[s.kind];\n    default:\n      return words[s.kind](day(s.date));\n  }\n}\n\n/**\n * The subscription's standing in one line — or `null` when nothing applies (kastlan reuse\n * audit 2026-11-02, proposal 3; billing §7, Marcel 2026-11-04). The FIRST that applies:\n *\n * 1. not in good standing → \"Your plan has ended.\" (`billing.standing.ended`, the first\n *    sentence of the plan-ended banner's);\n * 2. `past_due` → \"Payment failed — we’re retrying. Your plan stays active meanwhile.\",\n *    with NO renewal date: the payment-failed banner keeps the action;\n * 3. `trialing` → \"Trial until {trial_ends_at}\" (a pure guest's trial that has not\n *    started, §12.9, has no date and says nothing);\n * 4. `comped` → \"Free until {comped_until}\", or \"Free, with no end date\";\n * 5. set to cancel at the period's end → \"Ends on {current_period_end}\";\n * 6. `active` → \"Renews on {current_period_end}\";\n * 7. otherwise nothing.\n *\n * kastlan and keksdose each wrote this line, and they drifted: kastlan said nothing for\n * an ended plan or a failed payment, and keksdose's `past_due` said \"Renews on …\".\n *\n * `format` prints a date in a sentence; default the kit's `formatDate` (`\"medium\"`) in\n * the runtime's locale. Inside a component, `<SubscriptionStanding>` prints it the\n * provider's way — its `formatDate` (the app's date preference), else its locale and\n * time zone.\n */\nexport function subscriptionStanding(\n  overview: SubscriptionStandingOverview,\n  labels: Pick<BillingLabels, \"standing\">,\n  format: (value: DateInput) => string = (value) => formatDate(value),\n): string | null {\n  const s = standingOf(overview);\n  return s && standingText(s, labels.standing, format);\n}\n\nexport interface SubscriptionStandingProps extends Omit<ComponentPropsWithRef<\"p\">, \"children\"> {\n  /** The overview, or the fields of it the line reads. */\n  overview: SubscriptionStandingOverview;\n  /** The date's locale. Default: the provider's. */\n  locale?: string;\n  /** Prop > `<UiKitProvider labels={{ billing: { standing } }}>` > English. */\n  labels?: LabelOverride<BillingLabels>;\n}\n\n/**\n * {@link subscriptionStanding} as the muted line under the plan's name on the\n * subscription page (billing §7) — nothing at all when no line applies. The date is a\n * day in a sentence, without its weekday: the `<UiKitProvider formatDate>` (the app's\n * date preference) when it set one, else the kit's `formatDate`, `\"medium\"`, in the\n * provider's locale and `timeZone` — as `CancelSubscriptionConfirm` names the same day.\n *\n * Carries `data-standing` with the line's key (`ended`, `pastDue`, `trialUntil`,\n * `freeUntil`, `free`, `endsOn`, `renewsOn`), for a test or a style hook.\n *\n *     <SubscriptionStanding overview={overview} />\n *\n * Back from a checkout whose webhook has not landed (§12.21), the ended line is the stale\n * one: render it only when `useCheckoutProcessing`'s `processing` is false, and the\n * processing banner speaks meanwhile.\n */\nexport function SubscriptionStanding({\n  overview,\n  locale: localeProp,\n  labels: labelsProp,\n  className,\n  ...rest\n}: SubscriptionStandingProps) {\n  const labels = useBillingLabels(labelsProp);\n  const day = useDayFormatter(undefined, localeProp);\n  const s = standingOf(overview);\n  if (!s) return null;\n  return (\n    <p {...rest} data-standing={s.kind} className={cn(\"text-sm text-muted\", className)}>\n      {standingText(s, labels.standing, (value) => day(value))}\n    </p>\n  );\n}\n"],"mappings":";AA8HI;AA3HJ,SAAS,UAAU;AACnB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAE3B,SAAS,wBAAwB;AAoBjC,MAAM,QAAQ,CAAC,UAA8B,UAAU,QAAQ,UAAU,UAAa,UAAU;AAGhG,SAAS,WAAW,GAAkD;AAGpE,MAAI,CAAC,EAAE,iBAAkB,QAAO,EAAE,MAAM,QAAQ;AAEhD,MAAI,EAAE,WAAW,WAAY,QAAO,EAAE,MAAM,UAAU;AACtD,MAAI,EAAE,WAAW,WAAY,QAAO,MAAM,EAAE,aAAa,IAAI,EAAE,MAAM,cAAc,MAAM,EAAE,cAAc,IAAI;AAC7G,MAAI,EAAE,WAAW,UAAU;AACzB,WAAO,MAAM,EAAE,YAAY,IAAI,EAAE,MAAM,aAAa,MAAM,EAAE,aAAa,IAAI,EAAE,MAAM,OAAO;AAAA,EAC9F;AACA,MAAI,CAAC,MAAM,EAAE,kBAAkB,EAAG,QAAO;AACzC,MAAI,EAAE,qBAAsB,QAAO,EAAE,MAAM,UAAU,MAAM,EAAE,mBAAmB;AAChF,MAAI,EAAE,WAAW,SAAU,QAAO,EAAE,MAAM,YAAY,MAAM,EAAE,mBAAmB;AACjF,SAAO;AACT;AAEA,SAAS,aAAa,GAAa,OAAkC,KAA2C;AAC9G,UAAQ,EAAE,MAAM;AAAA,IACd,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,MAAM,EAAE,IAAI;AAAA,IACrB;AACE,aAAO,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;AAAA,EACpC;AACF;AAyBO,SAAS,qBACd,UACA,QACA,SAAuC,CAAC,UAAU,WAAW,KAAK,GACnD;AACf,QAAM,IAAI,WAAW,QAAQ;AAC7B,SAAO,KAAK,aAAa,GAAG,OAAO,UAAU,MAAM;AACrD;AA2BO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR;AAAA,EACA,GAAG;AACL,GAA8B;AAC5B,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,MAAM,gBAAgB,QAAW,UAAU;AACjD,QAAM,IAAI,WAAW,QAAQ;AAC7B,MAAI,CAAC,EAAG,QAAO;AACf,SACE,oBAAC,OAAG,GAAG,MAAM,iBAAe,EAAE,MAAM,WAAW,GAAG,sBAAsB,SAAS,GAC9E,uBAAa,GAAG,OAAO,UAAU,CAAC,UAAU,IAAI,KAAK,CAAC,GACzD;AAEJ;","names":[]}

package/dist/billing/usage-meter.d.ts

@@ -0,0 +1,52 @@
+import type { ReactNode } from "react";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { ProgressBarSize } from "../components/progress-bar.js";
+import type { BillingLabels } from "./billing-labels.js";
+export interface UsageMeterProps {
+    /** The dimension's name in the reader's language: "Budgets", "Units", "Files". The
+     *  meter's visible label and its accessible name. */
+    label: ReactNode;
+    /** What the payer has — the overview's `usage[dimension]` (§12.15). */
+    used: number;
+    /**
+     * The plan's limit — the overview's `limits[dimension]`. `null` is unlimited (§3.1), and
+     * so is a dimension the overview's `limits` leaves out: no bar and no tone, the count
+     * and "Unlimited" as text.
+     */
+    limit?: number | null;
+    /** How a figure is written — kastlan's storage limit is bytes (`formatFileSize`).
+     *  Default: a number in the kit's locale, with its digit grouping ("12’345"). */
+    formatValue?: (value: number) => string;
+    /** The track's height. Default `slim` (6px), a bar under a line of text. */
+    size?: ProgressBarSize;
+    /** Over the provider's locale, for the default figures. */
+    locale?: string;
+    className?: string;
+    /** Prop > `<UiKitProvider labels={{ billing }}>` > English: `usage` ("3 of 10") and
+     *  `unlimited`. The over-the-limit line is `progressBar.overLimit`'s. */
+    labels?: LabelOverride<BillingLabels>;
+    [key: `data-${string}`]: string | number | boolean | undefined;
+}
+/**
+ * What the payer uses of one plan limit, on `ProgressBar`'s meter variant (billing §7;
+ * kastlan reuse audit 2026-11-02, proposal 3): the dimension's name, "3 of 10", and a
+ * bar whose tone says what creating one more would do (Marcel 2026-11-04):
+ *
+ * - below the limit: `neutral` — nothing to warn about;
+ * - AT it: `warning` — nothing more can be created (§3.4);
+ * - PAST it: `danger` — after a downgrade, which never deletes what is over the new limit
+ *   (§3.4); the bar stays full and a line under it says by how much
+ *   (`progressBar.overLimit`, "2 over the limit");
+ * - unlimited (`null`): no bar and no tone, the count and "Unlimited" as text.
+ *
+ * Carries `data-usage` (`below`, `at`, `over`, `unlimited`), for a test or a style hook.
+ *
+ * kastlan's `UsageProgressBar` turned amber past 80 % and wrote its counts with
+ * `n.toString()`; keksdose's own `UsageMeter` warned at the limit but drew nothing past
+ * it. Every figure here goes through {@link UsageMeterProps.formatValue}, the overage too.
+ *
+ *     {DIMENSIONS.map((d) => (
+ *       <UsageMeter key={d} label={names[d]} used={overview.usage[d] ?? 0} limit={overview.limits[d]} />
+ *     ))}
+ */
+export declare function UsageMeter({ label, used, limit, formatValue, size, locale: localeProp, className, labels: labelsProp, ...rest }: UsageMeterProps): import("react").JSX.Element;

package/dist/billing/usage-meter.js

@@ -0,0 +1,52 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useKitLabels, useKitLocale } from "../i18n/kit-labels.js";
+import { formatNumber } from "../lib/format.js";
+import { ProgressBar } from "../components/progress-bar.js";
+import { DEFAULT_PROGRESS_BAR_LABELS } from "../components/progress-bar-labels.js";
+import { useBillingLabels } from "./billing-labels.js";
+const TONE = {
+  below: "neutral",
+  at: "warning",
+  over: "danger"
+};
+function UsageMeter({
+  label,
+  used,
+  limit = null,
+  formatValue,
+  size = "slim",
+  locale: localeProp,
+  className,
+  labels: labelsProp,
+  ...rest
+}) {
+  const labels = useBillingLabels(labelsProp);
+  const bar = useKitLabels("progressBar", DEFAULT_PROGRESS_BAR_LABELS);
+  const locale = useKitLocale(localeProp);
+  const figure = (value) => formatValue ? formatValue(value) : formatNumber(value, { locale });
+  const state = limit === null ? "unlimited" : used < limit ? "below" : used === limit ? "at" : "over";
+  return /* @__PURE__ */ jsx(
+    ProgressBar,
+    {
+      ...rest,
+      variant: "meter",
+      size,
+      label,
+      showValue: true,
+      value: used,
+      max: limit,
+      tone: state === "unlimited" ? void 0 : TONE[state],
+      formatValue: () => limit === null ? figure(used) : labels.usage(figure(used), figure(limit)),
+      overage: (over) => bar.overLimit(figure(over)),
+      locale,
+      labels: { unlimited: labels.unlimited },
+      "data-usage": state,
+      className
+    }
+  );
+}
+export {
+  UsageMeter
+};
+//# sourceMappingURL=usage-meter.js.map

package/dist/billing/usage-meter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/usage-meter.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nimport { useKitLabels, useKitLocale } from \"../i18n/kit-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { formatNumber } from \"../lib/format\";\nimport { ProgressBar } from \"../components/progress-bar\";\nimport type { ProgressBarSize, ProgressBarTone } from \"../components/progress-bar\";\nimport { DEFAULT_PROGRESS_BAR_LABELS } from \"../components/progress-bar-labels\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\nexport interface UsageMeterProps {\n  /** The dimension's name in the reader's language: \"Budgets\", \"Units\", \"Files\". The\n   *  meter's visible label and its accessible name. */\n  label: ReactNode;\n  /** What the payer has — the overview's `usage[dimension]` (§12.15). */\n  used: number;\n  /**\n   * The plan's limit — the overview's `limits[dimension]`. `null` is unlimited (§3.1), and\n   * so is a dimension the overview's `limits` leaves out: no bar and no tone, the count\n   * and \"Unlimited\" as text.\n   */\n  limit?: number | null;\n  /** How a figure is written — kastlan's storage limit is bytes (`formatFileSize`).\n   *  Default: a number in the kit's locale, with its digit grouping (\"12’345\"). */\n  formatValue?: (value: number) => string;\n  /** The track's height. Default `slim` (6px), a bar under a line of text. */\n  size?: ProgressBarSize;\n  /** Over the provider's locale, for the default figures. */\n  locale?: string;\n  className?: string;\n  /** Prop > `<UiKitProvider labels={{ billing }}>` > English: `usage` (\"3 of 10\") and\n   *  `unlimited`. The over-the-limit line is `progressBar.overLimit`'s. */\n  labels?: LabelOverride<BillingLabels>;\n  [key: `data-${string}`]: string | number | boolean | undefined;\n}\n\n/** Where the use stands against the limit — `data-usage`, and the tone it takes. */\ntype UsageState = \"below\" | \"at\" | \"over\" | \"unlimited\";\n\nconst TONE: Record<Exclude<UsageState, \"unlimited\">, ProgressBarTone> = {\n  below: \"neutral\",\n  at: \"warning\",\n  over: \"danger\",\n};\n\n/**\n * What the payer uses of one plan limit, on `ProgressBar`'s meter variant (billing §7;\n * kastlan reuse audit 2026-11-02, proposal 3): the dimension's name, \"3 of 10\", and a\n * bar whose tone says what creating one more would do (Marcel 2026-11-04):\n *\n * - below the limit: `neutral` — nothing to warn about;\n * - AT it: `warning` — nothing more can be created (§3.4);\n * - PAST it: `danger` — after a downgrade, which never deletes what is over the new limit\n *   (§3.4); the bar stays full and a line under it says by how much\n *   (`progressBar.overLimit`, \"2 over the limit\");\n * - unlimited (`null`): no bar and no tone, the count and \"Unlimited\" as text.\n *\n * Carries `data-usage` (`below`, `at`, `over`, `unlimited`), for a test or a style hook.\n *\n * kastlan's `UsageProgressBar` turned amber past 80 % and wrote its counts with\n * `n.toString()`; keksdose's own `UsageMeter` warned at the limit but drew nothing past\n * it. Every figure here goes through {@link UsageMeterProps.formatValue}, the overage too.\n *\n *     {DIMENSIONS.map((d) => (\n *       <UsageMeter key={d} label={names[d]} used={overview.usage[d] ?? 0} limit={overview.limits[d]} />\n *     ))}\n */\nexport function UsageMeter({\n  label,\n  used,\n  limit = null,\n  formatValue,\n  size = \"slim\",\n  locale: localeProp,\n  className,\n  labels: labelsProp,\n  ...rest\n}: UsageMeterProps) {\n  const labels = useBillingLabels(labelsProp);\n  const bar = useKitLabels(\"progressBar\", DEFAULT_PROGRESS_BAR_LABELS);\n  const locale = useKitLocale(localeProp);\n  const figure = (value: number) => (formatValue ? formatValue(value) : formatNumber(value, { locale }));\n  const state: UsageState = limit === null ? \"unlimited\" : used < limit ? \"below\" : used === limit ? \"at\" : \"over\";\n\n  return (\n    <ProgressBar\n      {...rest}\n      variant=\"meter\"\n      size={size}\n      label={label}\n      showValue\n      value={used}\n      max={limit}\n      tone={state === \"unlimited\" ? undefined : TONE[state]}\n      // The bar hands its formatter the value clamped at `max`; the figures are the real\n      // ones, so \"5 of 3\" after a downgrade says what the bar cannot draw. Unlimited, it\n      // asks with `max` = Infinity and shows the count beside \"Unlimited\".\n      formatValue={() => (limit === null ? figure(used) : labels.usage(figure(used), figure(limit)))}\n      overage={(over) => bar.overLimit(figure(over))}\n      locale={locale}\n      labels={{ unlimited: labels.unlimited }}\n      data-usage={state}\n      className={className}\n    />\n  );\n}\n"],"mappings":";AAsFI;AApFJ,SAAS,cAAc,oBAAoB;AAE3C,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAE5B,SAAS,mCAAmC;AAC5C,SAAS,wBAAwB;AAgCjC,MAAM,OAAkE;AAAA,EACtE,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,MAAM;AACR;AAwBO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AAAA,EACA,OAAO;AAAA,EACP,QAAQ;AAAA,EACR;AAAA,EACA,QAAQ;AAAA,EACR,GAAG;AACL,GAAoB;AAClB,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,MAAM,aAAa,eAAe,2BAA2B;AACnE,QAAM,SAAS,aAAa,UAAU;AACtC,QAAM,SAAS,CAAC,UAAmB,cAAc,YAAY,KAAK,IAAI,aAAa,OAAO,EAAE,OAAO,CAAC;AACpG,QAAM,QAAoB,UAAU,OAAO,cAAc,OAAO,QAAQ,UAAU,SAAS,QAAQ,OAAO;AAE1G,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,SAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA,WAAS;AAAA,MACT,OAAO;AAAA,MACP,KAAK;AAAA,MACL,MAAM,UAAU,cAAc,SAAY,KAAK,KAAK;AAAA,MAIpD,aAAa,MAAO,UAAU,OAAO,OAAO,IAAI,IAAI,OAAO,MAAM,OAAO,IAAI,GAAG,OAAO,KAAK,CAAC;AAAA,MAC5F,SAAS,CAAC,SAAS,IAAI,UAAU,OAAO,IAAI,CAAC;AAAA,MAC7C;AAAA,MACA,QAAQ,EAAE,WAAW,OAAO,UAAU;AAAA,MACtC,cAAY;AAAA,MACZ;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/chart.d.ts

@@ -3,6 +3,7 @@ export { PALETTE_SIZE, CVD_ORDER, paletteFor, CHART_COLORS, CHART_ROLES, CHART_M
 export * from "./components/treemap.js";
 export * from "./components/treemap-labels.js";
 export { AXIS_TICK_WIDTH, AXIS_TITLE_STRIP, anchoredBand, axisBandWidth, mergeSeries, oneAxis, padBand, paddedDomain, seriesKey, soleSeriesColor, visibleSeries, seriesLegendEntries, StaticSeriesChart, SeriesChart, type TimeTickUnit, type SeriesChartAxisBudget, type SeriesSource, type SeriesChartSeries, type SeriesChartType, type SeriesChartPoint, type SeriesChartRow, type SeriesChartXValue, type SeriesChartTickValues, type SeriesChartAxis, type SeriesChartXTick, type SeriesChartX, type SeriesChartTooltipPlacement, type SeriesChartTooltip, type SeriesChartSpan, type SeriesChartTone, type SeriesChartReference, type SeriesChartMarker, type SeriesChartHit, type SeriesChartProps, type SeriesLegendAxes, } from "./components/series-chart.js";
+export { LegendedSeriesChart, type LegendedSeriesChartLegend, type LegendedSeriesChartProps, } from "./components/legended-series-chart.js";
 export type { ChartHeight } from "./components/chart-height.js";
 export * from "./components/chart-zoom.js";
 export { SharedXZoom } from "./components/chart-zoom-core.js";

package/dist/chart.js

@@ -31,6 +31,9 @@ import {
   StaticSeriesChart,
   SeriesChart
 } from "./components/series-chart.js";
+import {
+  LegendedSeriesChart
+} from "./components/legended-series-chart.js";
 export * from "./components/chart-zoom.js";
 import { SharedXZoom } from "./components/chart-zoom-core.js";
 import {
@@ -56,6 +59,7 @@ export {
   HEATMAP_HEX,
   LegendColumn,
   LegendGroup,
+  LegendedSeriesChart,
   PALETTE_HEX,
   PALETTE_SIZE,
   STEP_DASH,

package/dist/chart.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/chart.ts"],"sourcesContent":["// `@eifi1/ui-kit/chart` — the chart shell and its colour system.\n//\n// A re-slicing of what the main barrel already exports, not a new API. It exists so a\n// consumer can reach the chart kit WITHOUT the barrel: `import(\"@eifi1/ui-kit/chart\")`\n// is a chunk of its own (50.4 KB min, 19.9 KB gzip at 0.51.6, refactor audit 2026-10-30\n// MOD-7; it was 31KB when this was written), where the same lazy import through the barrel\n// pulls the barrel, because a dynamic import of it cannot be tree-shaken down to one member.\n//\n// It is about chunk size, not about the peer: `recharts` is a REQUIRED peer (since 0.5.0),\n// because the main barrel re-exports everything here too, so `import { Button } from\n// \"@eifi1/ui-kit\"` reaches recharts as well (packaging-contract.test.ts asserts it).\nexport * from \"./components/chart\";\n// Named, not `*`, for chart-palette, series-chart and toggle-legend: 0.53 took the slice's\n// share of the 55 names no app reads off the surface (deprecated in 0.52, refactor audit\n// 2026-10-30, API-4) — `EDGE_MIN_CONTRAST`, `resolveTooltipPlacement`, `STROKE_PATTERNS`,\n// which their modules keep for the kit's own use.\nexport {\n  PALETTE_SIZE,\n  CVD_ORDER,\n  paletteFor,\n  CHART_COLORS,\n  CHART_ROLES,\n  CHART_MUTED_HEX,\n  chartEdge,\n  PALETTE_HEX,\n  HEATMAP_HEX,\n  lerpHex,\n  textOn,\n  type PaletteForOptions,\n  type HeatStops,\n} from \"./theme/chart-palette\";\n\n// The tile chart (treemap) the apps share — moved here from keksdose so every consumer\n// derives it from the package rather than from a copy. 0.52: its `treemap` label namespace.\nexport * from \"./components/treemap\";\nexport * from \"./components/treemap-labels\";\n\n// lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the\n// mirrored-pair axis geometry — moved here so the apps derive them from the package.\nexport {\n  AXIS_TICK_WIDTH,\n  AXIS_TITLE_STRIP,\n  anchoredBand,\n  axisBandWidth,\n  mergeSeries,\n  oneAxis,\n  padBand,\n  paddedDomain,\n  seriesKey,\n  soleSeriesColor,\n  visibleSeries,\n  seriesLegendEntries,\n  StaticSeriesChart,\n  SeriesChart,\n  type TimeTickUnit,\n  type SeriesChartAxisBudget,\n  type SeriesSource,\n  type SeriesChartSeries,\n  type SeriesChartType,\n  type SeriesChartPoint,\n  type SeriesChartRow,\n  type SeriesChartXValue,\n  type SeriesChartTickValues,\n  type SeriesChartAxis,\n  type SeriesChartXTick,\n  type SeriesChartX,\n  type SeriesChartTooltipPlacement,\n  type SeriesChartTooltip,\n  type SeriesChartSpan,\n  type SeriesChartTone,\n  type SeriesChartReference,\n  type SeriesChartMarker,\n  type SeriesChartHit,\n  type SeriesChartProps,\n  type SeriesLegendAxes,\n} from \"./components/series-chart\";\n// 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.\nexport type { ChartHeight } from \"./components/chart-height\";\n// SharedXZoom and the zoom's types: the public face of ./chart-zoom-core, whose arithmetic\n// stays the kit's (refactor audit 2026-10, API-6b; off the surface in 0.35).\nexport * from \"./components/chart-zoom\";\n// The same binding, named from the module that holds it and the drag layer (recharts): the\n// packaging contract reads this entry's own imports to know which modules may import\n// recharts, so chart-zoom-core has to be one of them (MOD-6).\nexport { SharedXZoom } from \"./components/chart-zoom-core\";\nexport {\n  strokeDash,\n  STEP_DASH,\n  toggleHidden,\n  ToggleLegend,\n  StaticLegend,\n  LegendColumn,\n  LegendGroup,\n  type LegendEntry,\n  type ToggleLegendProps,\n  type StaticLegendProps,\n} from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\n\n// The part-to-whole chart (donut / pie) — moved here from kastlan's dashboard and reports.\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\n"],"mappings":";AAWA,cAAc;AAKd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAIP,cAAc;AACd,cAAc;AAId;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAsBK;AAKP,cAAc;AAId,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;","names":[]}
+{"version":3,"sources":["../src/chart.ts"],"sourcesContent":["// `@eifi1/ui-kit/chart` — the chart shell and its colour system.\n//\n// A re-slicing of what the main barrel already exports, not a new API. It exists so a\n// consumer can reach the chart kit WITHOUT the barrel: `import(\"@eifi1/ui-kit/chart\")`\n// is a chunk of its own (50.4 KB min, 19.9 KB gzip at 0.51.6, refactor audit 2026-10-30\n// MOD-7; it was 31KB when this was written), where the same lazy import through the barrel\n// pulls the barrel, because a dynamic import of it cannot be tree-shaken down to one member.\n//\n// It is about chunk size, not about the peer: `recharts` is a REQUIRED peer (since 0.5.0),\n// because the main barrel re-exports everything here too, so `import { Button } from\n// \"@eifi1/ui-kit\"` reaches recharts as well (packaging-contract.test.ts asserts it).\nexport * from \"./components/chart\";\n// Named, not `*`, for chart-palette, series-chart and toggle-legend: 0.53 took the slice's\n// share of the 55 names no app reads off the surface (deprecated in 0.52, refactor audit\n// 2026-10-30, API-4) — `EDGE_MIN_CONTRAST`, `resolveTooltipPlacement`, `STROKE_PATTERNS`,\n// which their modules keep for the kit's own use.\nexport {\n  PALETTE_SIZE,\n  CVD_ORDER,\n  paletteFor,\n  CHART_COLORS,\n  CHART_ROLES,\n  CHART_MUTED_HEX,\n  chartEdge,\n  PALETTE_HEX,\n  HEATMAP_HEX,\n  lerpHex,\n  textOn,\n  type PaletteForOptions,\n  type HeatStops,\n} from \"./theme/chart-palette\";\n\n// The tile chart (treemap) the apps share — moved here from keksdose so every consumer\n// derives it from the package rather than from a copy. 0.52: its `treemap` label namespace.\nexport * from \"./components/treemap\";\nexport * from \"./components/treemap-labels\";\n\n// lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the\n// mirrored-pair axis geometry — moved here so the apps derive them from the package.\nexport {\n  AXIS_TICK_WIDTH,\n  AXIS_TITLE_STRIP,\n  anchoredBand,\n  axisBandWidth,\n  mergeSeries,\n  oneAxis,\n  padBand,\n  paddedDomain,\n  seriesKey,\n  soleSeriesColor,\n  visibleSeries,\n  seriesLegendEntries,\n  StaticSeriesChart,\n  SeriesChart,\n  type TimeTickUnit,\n  type SeriesChartAxisBudget,\n  type SeriesSource,\n  type SeriesChartSeries,\n  type SeriesChartType,\n  type SeriesChartPoint,\n  type SeriesChartRow,\n  type SeriesChartXValue,\n  type SeriesChartTickValues,\n  type SeriesChartAxis,\n  type SeriesChartXTick,\n  type SeriesChartX,\n  type SeriesChartTooltipPlacement,\n  type SeriesChartTooltip,\n  type SeriesChartSpan,\n  type SeriesChartTone,\n  type SeriesChartReference,\n  type SeriesChartMarker,\n  type SeriesChartHit,\n  type SeriesChartProps,\n  type SeriesLegendAxes,\n} from \"./components/series-chart\";\n// 0.55: the chart with its legend under it, keksdose's report wrapper as the kit's layout.\nexport {\n  LegendedSeriesChart,\n  type LegendedSeriesChartLegend,\n  type LegendedSeriesChartProps,\n} from \"./components/legended-series-chart\";\n// 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.\nexport type { ChartHeight } from \"./components/chart-height\";\n// SharedXZoom and the zoom's types: the public face of ./chart-zoom-core, whose arithmetic\n// stays the kit's (refactor audit 2026-10, API-6b; off the surface in 0.35).\nexport * from \"./components/chart-zoom\";\n// The same binding, named from the module that holds it and the drag layer (recharts): the\n// packaging contract reads this entry's own imports to know which modules may import\n// recharts, so chart-zoom-core has to be one of them (MOD-6).\nexport { SharedXZoom } from \"./components/chart-zoom-core\";\nexport {\n  strokeDash,\n  STEP_DASH,\n  toggleHidden,\n  ToggleLegend,\n  StaticLegend,\n  LegendColumn,\n  LegendGroup,\n  type LegendEntry,\n  type ToggleLegendProps,\n  type StaticLegendProps,\n} from \"./components/toggle-legend\";\nexport * from \"./components/facing-pair\";\nexport * from \"./components/series-chart-labels\";\n\n// The part-to-whole chart (donut / pie) — moved here from kastlan's dashboard and reports.\nexport * from \"./components/pie-chart\";\nexport * from \"./components/pie-chart-labels\";\n"],"mappings":";AAWA,cAAc;AAKd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAIP,cAAc;AACd,cAAc;AAId;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAsBK;AAEP;AAAA,EACE;AAAA,OAGK;AAKP,cAAc;AAId,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,cAAc;AACd,cAAc;AAGd,cAAc;AACd,cAAc;","names":[]}

package/dist/components/alert-banner.js

@@ -5,7 +5,7 @@ import { AlertTriangle, CheckCircle2, ChevronRight, Info, X } from "lucide-react
 import { cn } from "../lib/cn.js";
 import { FOCUS_RING } from "./focus-ring.js";
 import { DEFAULT_COMMON_LABELS, useKitLabels } from "../i18n/kit-labels.js";
-import { focusFirst, focusIsLost, tabStopsAround, whenFocusLeftForNothing } from "../lib/focus-left.js";
+import { returnFocus, tabStopsAround, whenFocusLeftForNothing } from "../lib/focus-left.js";
 const TONE_FRAME = {
   danger: "border-2 border-danger-strong bg-danger-soft",
   warning: "border-2 border-warning bg-warning-soft",
@@ -105,8 +105,7 @@ function AlertBanner({
     () => () => {
       unwatchFocus.current?.();
       const around = dismissedFrom.current;
-      if (!around || !focusIsLost()) return;
-      focusFirst([dismissTarget.current?.current, ...around]);
+      if (around) returnFocus({ opener: dismissTarget.current?.current, fallback: around });
     },
     []
   );