@eifi1/ui-kit 0.51.7 → 0.52.0

package/src/auth/register-form-labels.ts

@@ -2,7 +2,7 @@
 // catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
 // chunk like the other languages (0.34, KS U8). ./register-form re-exports them.
 
-import { englishRateLimited } from "./auth-errors";
+import { englishRateLimited } from "./auth-errors-labels";
 import type { RegisterLabels } from "./register-form";
 
 /** `Required`: every key, the 0.30 one included, has its English here. */

package/src/auth/reset-password-form-labels.ts

@@ -3,7 +3,7 @@
 // loads as one chunk like the other languages (0.34, KS U8). ./reset-password-form
 // re-exports them.
 
-import { englishRateLimited } from "./auth-errors";
+import { englishRateLimited } from "./auth-errors-labels";
 import type { ResetPasswordLabels } from "./reset-password-form";
 
 /** `Required`: every key, the 0.30 one included, has its English here. */

package/src/auth/reset-password-form.tsx

@@ -2,6 +2,7 @@ import { useEffect, useId, useRef, useState } from "react";
 import type { ComponentPropsWithRef, FormEvent, ReactNode } from "react";
 import { CheckCircle2, XCircle } from "lucide-react";
 import { cn } from "../lib/cn";
+import { describeFailure } from "../lib/describe-failure";
 import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
 import { AlertBanner } from "../components/alert-banner";
 import { LoadingState } from "../components/loading-state";
@@ -291,12 +292,15 @@ export function ResetPasswordForm({
             setPhase({ token, phase: { kind: "invalid" } });
             return;
           }
-          // The app's words first, then the throttle's, then the kit's catch-all.
+          // The app's words first, then the throttle's, then the kit's catch-all — an app's
+          // "" is no words (refactor audit 2026-10-30, DUP-14: `??` drew an empty alert).
           setFailure(
-            describeError?.(error) ??
-              (isRateLimited(error)
+            describeFailure(
+              describeError?.(error),
+              isRateLimited(error)
                 ? (labels.rateLimited ?? DEFAULT_RESET_PASSWORD_LABELS.rateLimited)(retryAfterSeconds(error))
-                : labels.failed),
+                : labels.failed,
+            ),
           );
         },
       );

package/src/auth/sign-in-form-labels.ts

@@ -2,7 +2,7 @@
 // catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
 // chunk like the other languages (0.34, KS U8). ./sign-in-form re-exports them.
 
-import { englishRateLimited } from "./auth-errors";
+import { englishRateLimited } from "./auth-errors-labels";
 import type { SignInLabels } from "./sign-in-form";
 
 /** `Required`: every key, the 0.30 ones included, has its English here. */

package/src/auth/status-parts.tsx

@@ -91,12 +91,6 @@ export function useOncePerKey<T>(
   }, [key]);
 }
 
-/** Whether a callback's return is a promise to wait for. A callback that returns
- *  nothing is done when it returns. */
-export function isThenable(value: unknown): value is PromiseLike<unknown> {
-  return typeof (value as PromiseLike<unknown> | null)?.then === "function";
-}
-
 /**
  * Move focus to `ref` when `active` turns true — the outcome a person's own submit led
  * to ("If an account exists … the link is on its way", "Your password has been

package/src/auth/verify-email-labels.ts

@@ -2,7 +2,7 @@
 // catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
 // chunk like the other languages (0.34, KS U8). ./verify-email re-exports them.
 
-import { englishRateLimited } from "./auth-errors";
+import { englishRateLimited } from "./auth-errors-labels";
 import type { VerifyEmailLabels } from "./verify-email";
 
 export const DEFAULT_VERIFY_EMAIL_LABELS: VerifyEmailLabels = {

package/src/auth/verify-email.tsx

@@ -2,13 +2,15 @@ import { useEffect, useState } from "react";
 import type { ComponentPropsWithRef, ReactNode } from "react";
 import { CheckCircle2, MailWarning, TimerOff, XCircle } from "lucide-react";
 import { cn } from "../lib/cn";
+import { describeFailure } from "../lib/describe-failure";
 import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
 import { useAnnounce } from "../hooks/use-announce";
 import { AlertBanner } from "../components/alert-banner";
 import { LoadingState } from "../components/loading-state";
 import { Button } from "../components/button";
 import { EmptyState } from "../components/empty-state";
-import { OUTCOME_CLASS, STATUS_HEADING_CLASS, isThenable, useOncePerKey } from "./status-parts";
+import { isThenable } from "../lib/thenable";
+import { OUTCOME_CLASS, STATUS_HEADING_CLASS, useOncePerKey } from "./status-parts";
 import { authErrorCode, englishRateLimited, isRateLimited, retryAfterSeconds } from "./auth-errors";
 import type { AuthHeadingLevel } from "./status-parts";
 import { DEFAULT_VERIFY_EMAIL_LABELS } from "./verify-email-labels";
@@ -150,13 +152,16 @@ function ResendStatus({
   labels: VerifyEmailLabels;
   className?: string;
 }) {
-  // The app's words first, then the throttle's, then the kit's catch-all.
+  // The app's words first, then the throttle's, then the kit's catch-all — an app's ""
+  // is no words (refactor audit 2026-10-30, DUP-14: `??` printed an empty status).
   const failed =
     phase === "failed"
-      ? (describeError?.(error) ??
-        (isRateLimited(error)
-          ? (labels.rateLimited ?? englishRateLimited)(retryAfterSeconds(error))
-          : labels.resendError))
+      ? describeFailure(
+          describeError?.(error),
+          isRateLimited(error)
+            ? (labels.rateLimited ?? englishRateLimited)(retryAfterSeconds(error))
+            : labels.resendError,
+        )
       : "";
   return (
     <span role="status" className={cn(phase === "failed" ? "text-danger" : "text-success", className)}>

package/src/billing/cancel-subscription.tsx

@@ -1,21 +1,29 @@
-import { useKitLabels, useKitLocale } from "../i18n/kit-labels";
+import { useKitLabels } from "../i18n/kit-labels";
 import type { LabelOverride } from "../i18n/kit-labels";
 import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels";
-import { formatDate } from "../lib/format";
+import { useDayFormatter } from "../lib/day-format";
 import type { DateInput } from "../lib/format";
 import { Button } from "../components/button";
 import { DialogFrame } from "../components/dialog-frame";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock";
 import { useBillingLabels } from "./billing-labels";
 import type { BillingLabels } from "./billing-labels";
+import { dialogClose } from "./dialog-close";
+import type { WithDialogClose } from "./dialog-close";
 
-export interface CancelSubscriptionConfirmProps {
+/** {@link CancelSubscriptionConfirmProps} before one of its two close props is required. */
+interface CancelSubscriptionConfirmFields {
   open: boolean;
-  /** `false` when the admin dismisses it — Back, Escape, the backdrop. Confirm leaves it
-   *  open: close it once `POST /billing/cancel` answers. */
-  onOpenChange: (open: boolean) => void;
-  /** The overview's `current_period_end`: the day the subscription ends. Formatted with
-   *  the kit's date formatter (`formatDate`, `"medium"`). */
+  /** The admin dismissed it — Back, Escape, the backdrop. Confirm leaves it open: close it
+   *  once `POST /billing/cancel` answers. 0.52: every other kit dialog's `onClose`
+   *  (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). */
+  onClose?: () => void;
+  /** @deprecated 0.52 — `onClose`, as every other kit dialog; removed in 0.53. Called with
+   *  `false` when there is no `onClose`. */
+  onOpenChange?: (open: boolean) => void;
+  /** The overview's `current_period_end`: the day the subscription ends, in a sentence —
+   *  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` (0.52). */
   periodEnd: DateInput;
   /** Confirm: the app's `POST /billing/cancel` (server-kit 0.14, §16.3). */
   onConfirm: () => void;
@@ -28,6 +36,11 @@ export interface CancelSubscriptionConfirmProps {
   labels?: LabelOverride<BillingLabels>;
 }
 
+/** What {@link CancelSubscriptionConfirm} takes: `onClose`, or alone the deprecated
+ *  `onOpenChange`, is required (0.52 code review: with neither it compiled, and nothing
+ *  could dismiss it). */
+export type CancelSubscriptionConfirmProps = WithDialogClose<CancelSubscriptionConfirmFields>;
+
 /**
  * The in-app cancel's confirm (docs/billing-harmonization.md §16.2 decision 2, §16.4,
  * ui-kit 0.42): "Cancel subscription" for an admin the provider's portal doesn't open for
@@ -38,7 +51,7 @@ export interface CancelSubscriptionConfirmProps {
  *
  *     <CancelSubscriptionConfirm
  *       open={asking}
- *       onOpenChange={setAsking}
+ *       onClose={() => setAsking(false)}
  *       periodEnd={overview.current_period_end}
  *       pending={cancel.isPending}
  *       onConfirm={() => cancel.mutate()}
@@ -54,6 +67,7 @@ export interface CancelSubscriptionConfirmProps {
  */
 export function CancelSubscriptionConfirm({
   open,
+  onClose,
   onOpenChange,
   periodEnd,
   onConfirm,
@@ -63,14 +77,14 @@ export function CancelSubscriptionConfirm({
 }: CancelSubscriptionConfirmProps) {
   const labels = useBillingLabels(labelsProp);
   const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
-  const locale = useKitLocale(localeProp);
+  const day = useDayFormatter(undefined, localeProp);
 
   return (
     <DialogFrame
       open={open}
       title={labels.cancelConfirmTitle}
-      description={labels.cancelConfirmBody(formatDate(periodEnd, "medium", { locale }))}
-      onClose={() => onOpenChange(false)}
+      description={labels.cancelConfirmBody(day(periodEnd))}
+      onClose={dialogClose({ onClose, onOpenChange })}
       busy={pending}
       data-cancel-subscription-confirm=""
       actions={(close) => (

package/src/billing/dialog-close.ts

@@ -0,0 +1,34 @@
+/**
+ * How the three billing confirms — `CancelSubscriptionConfirm`, `PlanSwitchConfirm`,
+ * `GrantWarningConfirm` — are closed in 0.52: `onClose`, as every other kit dialog
+ * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5), and for one minor the deprecated
+ * `onOpenChange`, called with `false` when there is no `onClose`.
+ *
+ * 0.52 made `onOpenChange` optional for its deprecation and gave `onClose` beside it as
+ * optional too, so a confirm given NEITHER compiled — `<CancelSubscriptionConfirm open
+ * periodEnd={…} onConfirm={…} />` — and Back, Escape and the backdrop then called nothing:
+ * a dialog nobody could dismiss, where 0.51's compiler had required `onOpenChange` (0.52
+ * code review, cancel-subscription.tsx). And the fallback between the two was written
+ * three times, once per dialog.
+ *
+ * @internal Not part of the barrel; each dialog's props type is.
+ */
+
+/** The two close props as a dialog's own props interface declares them. */
+interface CloseProps {
+  onClose?: () => void;
+  onOpenChange?: (open: boolean) => void;
+}
+
+/**
+ * `P` with ONE of its two close props required — `onClose`, or alone the deprecated
+ * `onOpenChange`; both may be given, and `onClose` is then the one called. Built from
+ * `P`'s own members (`Pick`), so their docs and the deprecation stay the ones `P` writes.
+ */
+export type WithDialogClose<P extends CloseProps> = P &
+  (Required<Pick<P, "onClose">> | Required<Pick<P, "onOpenChange">>);
+
+/** The dialog's close: `onClose`, else `onOpenChange(false)`. */
+export function dialogClose({ onClose, onOpenChange }: CloseProps): () => void {
+  return () => (onClose ? onClose() : onOpenChange?.(false));
+}

package/src/billing/plan-card.tsx

@@ -14,6 +14,8 @@ import { Button } from "../components/button";
 import { DialogFrame } from "../components/dialog-frame";
 import { useBillingLabels } from "./billing-labels";
 import type { BillingLabels } from "./billing-labels";
+import { dialogClose } from "./dialog-close";
+import type { WithDialogClose } from "./dialog-close";
 import { BILLING_INTERVALS, billingCurrencyFor, formatPlanPrice, planPrice } from "./plan-price";
 import type { BillingCurrency, BillingInterval, PlanPrices } from "./plan-price";
 
@@ -489,9 +491,7 @@ export function PlanPicker({
       {permanentGrant && !switching && (
         <GrantWarningConfirm
           open={warned !== null}
-          onOpenChange={(open) => {
-            if (!open) setWarned(null);
-          }}
+          onClose={() => setWarned(null)}
           onConfirm={() => {
             if (warned) onChoose(warned);
           }}
@@ -502,11 +502,16 @@ export function PlanPicker({
   );
 }
 
-export interface GrantWarningConfirmProps {
+/** {@link GrantWarningConfirmProps} before one of its two close props is required. */
+interface GrantWarningConfirmFields {
   /** Shown, controlled. */
   open: boolean;
-  /** `false` on "Back", Escape, the backdrop — and after "Buy anyway". */
-  onOpenChange: (open: boolean) => void;
+  /** "Back", Escape, the backdrop — and after "Buy anyway". 0.52: every other kit
+   *  dialog's `onClose` (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). */
+  onClose?: () => void;
+  /** @deprecated 0.52 — `onClose`, as every other kit dialog; removed in 0.53. Called with
+   *  `false` when there is no `onClose`. */
+  onOpenChange?: (open: boolean) => void;
   /** "Buy anyway": the app opens its checkout. The dialog closes itself after it. */
   onConfirm: () => void;
   /** Prop > `<UiKitProvider labels={{ billing }}>` > English: `grantWarningTitle`,
@@ -514,6 +519,11 @@ export interface GrantWarningConfirmProps {
   labels?: LabelOverride<BillingLabels>;
 }
 
+/** What {@link GrantWarningConfirm} takes: `onClose`, or alone the deprecated
+ *  `onOpenChange`, is required (0.52 code review: with neither it compiled, and nothing
+ *  could dismiss it). */
+export type GrantWarningConfirmProps = WithDialogClose<GrantWarningConfirmFields>;
+
 /**
  * 0.42 (§16.8 B): the permanent-grant warning before a checkout — `grantWarningTitle`,
  * `grantWarningBody`, "Back" and "Buy anyway" (`grantWarningAction`). {@link PlanPicker}
@@ -523,26 +533,41 @@ export interface GrantWarningConfirmProps {
  * to a checkout — show this before that checkout, so a permanent-grant holder is still
  * warned. Carries `data-grant-warning`.
  */
-export function GrantWarningConfirm({ open, onOpenChange, onConfirm, labels: labelsProp }: GrantWarningConfirmProps) {
+export function GrantWarningConfirm({
+  open,
+  onClose,
+  onOpenChange,
+  onConfirm,
+  labels: labelsProp,
+}: GrantWarningConfirmProps) {
   const labels = useBillingLabels(labelsProp);
   const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
+  const close = dialogClose({ onClose, onOpenChange });
   return (
     <DialogFrame
       open={open}
       title={labels.grantWarningTitle}
       description={labels.grantWarningBody}
-      onClose={() => onOpenChange(false)}
+      onClose={close}
       data-grant-warning=""
-      actions={(close) => (
+      actions={(lower) => (
         <>
-          <Button variant="secondary" onClick={close}>
+          <Button variant="secondary" onClick={lower}>
             {common.back}
           </Button>
           <Button
             variant="default"
             onClick={() => {
+              // Already closed, and lowering: a second press is no second checkout, for an
+              // app that shows this dialog itself as much as for PlanPicker.
+              if (!open) return;
               onConfirm();
-              onOpenChange(false);
+              // The caller's close, at once — not `lower`, the panel's animated one, which
+              // reports the close 220 ms later. PlanPicker clears the warned choice in it,
+              // and the lowering panel is not inert: a double click on "Buy anyway" opened
+              // the checkout twice (0.52 code review, plan-card.tsx). The caller's `open`
+              // turning false still plays the exit.
+              close();
             }}
           >
             {labels.grantWarningAction}

package/src/billing/plan-change-labels.ts

@@ -0,0 +1,66 @@
+// The words of admin/plan-change and their type, in a module with no component code: the
+// English catalogue (src/i18n/defaults.ts) imports them without the component, so `en`
+// loads as one chunk like the other languages (0.34, KS U8). In billing/ since 0.52:
+// PlanSwitchConfirm reads them too, and with them in admin/ the billing and admin folders
+// imported each other (refactor audit 2026-10-30, MOD-6). admin/plan-change re-exports
+// both, and admin/plan-change-labels still answers for the old path.
+
+/** The `planChange` namespace: the column, the grant dialog and the result's lines. */
+export interface PlanChangeLabels {
+  /** The column's header: "Plan". */
+  column: string;
+  /** The dialog's title: "Change plan". */
+  title: string;
+  /** Its confirm button: "Change plan". */
+  confirm: string;
+  /** The plan select's label: "Plan". */
+  plan: string;
+  /** The line over the select: "Current plan: Free". */
+  current: (plan: string) => string;
+  /** Under the select — the fact that is not on the button. */
+  keepsItems: string;
+  /** The end of a free grant's field: "Free until". */
+  until: string;
+  /** Under it. */
+  untilHint: string;
+  /** Why the confirm is held while nothing would change. */
+  needsChange: string;
+  /** The result: the plan moved from one to another. */
+  changed: (from: string, to: string) => string;
+  /** The result: an account with no plan before, or the same plan again. */
+  set: (to: string) => string;
+  /** The result: a running beta kept its own end (§12.34); only the plan moved. */
+  keptBeta: string;
+  /** The result: the grant runs until `date` (formatted). */
+  untilDone: (date: string) => string;
+  /** The result: the account owns more than the new plan allows. */
+  overLimit: string;
+  /**
+   * The column's usage, spelled out (its tooltip): "1 of 5 budgets". Figures arrive
+   * formatted; `dimension` is the app's word, as `usage.label` gives it — since 0.33.1
+   * in the form the LIMIT takes when the label gives its plural forms ("1 of 1 budget",
+   * "1 of 5 budgets"): in every shipped language the word follows the limit, or heads
+   * the line in German, whose `von` would want a dative plural no app form carries
+   * ("Budgets: 1 von 5"). An override of yours gets the same word. Since 0.34 the grant
+   * dialog's usage line too, when `usage` comes as the column's shape.
+   */
+  usageOf: (used: string, limit: string, dimension: string) => string;
+}
+
+export const DEFAULT_PLAN_CHANGE_LABELS: PlanChangeLabels = {
+  column: "Plan",
+  title: "Change plan",
+  confirm: "Change plan",
+  plan: "Plan",
+  current: (plan) => `Current plan: ${plan}`,
+  keepsItems: "A smaller plan only blocks creating more; nothing is deleted.",
+  until: "Free until",
+  untilHint: "Leave empty for no end. A running beta keeps its own end.",
+  needsChange: "Pick another plan or an end date.",
+  changed: (from, to) => `Plan changed from ${from} to ${to}.`,
+  set: (to) => `Plan set to ${to}.`,
+  keptBeta: "The beta keeps its end; only the plan changed.",
+  untilDone: (date) => `Free until ${date}.`,
+  overLimit: "Above the new plan’s limit: nothing is removed, new items are blocked.",
+  usageOf: (used, limit, dimension) => `${used} of ${limit} ${dimension}`,
+};

package/src/billing/plan-switch.tsx

@@ -3,15 +3,18 @@ import type { LabelOverride } from "../i18n/kit-labels";
 import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels";
 import { pluralForm } from "../i18n/plurals";
 import type { PluralForms } from "../i18n/plurals";
-import { formatDate, formatMoney, formatNumber } from "../lib/format";
+import { useDayFormatter } from "../lib/day-format";
+import { formatMoney, formatNumber } from "../lib/format";
 import { AlertBanner } from "../components/alert-banner";
 import { Button } from "../components/button";
 import { DialogFrame } from "../components/dialog-frame";
 import { Spinner } from "../components/spinner";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock";
-import { DEFAULT_PLAN_CHANGE_LABELS } from "../admin/plan-change-labels";
+import { DEFAULT_PLAN_CHANGE_LABELS } from "./plan-change-labels";
 import { useBillingLabels } from "./billing-labels";
 import type { BillingLabels } from "./billing-labels";
+import { dialogClose } from "./dialog-close";
+import type { WithDialogClose } from "./dialog-close";
 import type { PlanSwitchPreview } from "./billing-overview";
 import { minorToMajor } from "./plan-price";
 import type { BillingInterval } from "./plan-price";
@@ -36,11 +39,16 @@ export interface PlanSwitchSide {
   interval: BillingInterval;
 }
 
-export interface PlanSwitchConfirmProps {
+/** {@link PlanSwitchConfirmProps} before one of its two close props is required. */
+interface PlanSwitchConfirmFields {
   open: boolean;
-  /** `false` when the payer dismisses it — Cancel, Escape, the backdrop. Confirm leaves
-   *  it open: close it once the switch answers. */
-  onOpenChange: (open: boolean) => void;
+  /** The payer dismissed it — Cancel, Escape, the backdrop. Confirm leaves it open: close
+   *  it once the switch answers. 0.52: every other kit dialog's `onClose` (CONTRIBUTING
+   *  §4; refactor audit 2026-10-30, API-5). */
+  onClose?: () => void;
+  /** @deprecated 0.52 — `onClose`, as every other kit dialog; removed in 0.53. Called with
+   *  `false` when there is no `onClose`. */
+  onOpenChange?: (open: boolean) => void;
   /** What the payer pays now: the overview's `paid`. */
   from: PlanSwitchSide;
   /** The pick. */
@@ -64,7 +72,8 @@ export interface PlanSwitchConfirmProps {
   formatLimit?: (dimension: string, value: number) => string;
   /** Confirm: the app's `POST /billing/plan` with `{plan, interval}` of `to`. */
   onConfirm: () => void;
-  /** The figures' and the date's locale. Default: the provider's. */
+  /** The figures' and the date's locale. Default: the provider's. The next charge's date
+   *  is written by the `<UiKitProvider formatDate>` when the app set one (0.52). */
   locale?: string;
   /**
    * 0.42 (§16.2 decision 5, §16.8 B): the payer's free grant runs without an end —
@@ -79,6 +88,11 @@ export interface PlanSwitchConfirmProps {
   labels?: LabelOverride<BillingLabels>;
 }
 
+/** What {@link PlanSwitchConfirm} takes: `onClose`, or alone the deprecated
+ *  `onOpenChange`, is required (0.52 code review: with neither it compiled, and nothing
+ *  could dismiss it). */
+export type PlanSwitchConfirmProps = WithDialogClose<PlanSwitchConfirmFields>;
+
 /**
  * The confirm for a plan switch (§15.2.10): from → to, each with its billing period;
  * Paddle's preview — "Charged now" (an upgrade) or "Credited towards your next charges"
@@ -88,7 +102,7 @@ export interface PlanSwitchConfirmProps {
  *     const preview = useMutation({ mutationFn: api.previewPlanSwitch });
  *     <PlanSwitchConfirm
  *       open={pick !== null}
- *       onOpenChange={(open) => !open && setPick(null)}
+ *       onClose={() => setPick(null)}
  *       from={overview.paid}
  *       to={pick}
  *       preview={preview.data}
@@ -103,6 +117,7 @@ export interface PlanSwitchConfirmProps {
  */
 export function PlanSwitchConfirm({
   open,
+  onClose,
   onOpenChange,
   from,
   to,
@@ -120,6 +135,7 @@ export function PlanSwitchConfirm({
   const planChange = useKitLabels("planChange", DEFAULT_PLAN_CHANGE_LABELS);
   const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
   const locale = useKitLocale(localeProp);
+  const day = useDayFormatter(undefined, localeProp);
 
   const period = (interval: BillingInterval) => (interval === "year" ? labels.yearly : labels.monthly);
   const side = (s: PlanSwitchSide) => `${planName(s.plan.toLowerCase())} (${period(s.interval)})`;
@@ -149,7 +165,7 @@ export function PlanSwitchConfirm({
       open={open}
       title={labels.switchTitle}
       description={labels.switchFromTo(side(from), side(to))}
-      onClose={() => onOpenChange(false)}
+      onClose={dialogClose({ onClose, onOpenChange })}
       busy={pending}
       // A preview that loads is busy too, but holds nothing: Cancel stays a way out.
       aria-busy={preview === undefined || undefined}
@@ -189,9 +205,7 @@ export function PlanSwitchConfirm({
             </dd>
             {preview.next_billed_at && preview.next_minor != null && (
               <>
-                <dt className="text-secondary">
-                  {labels.switchNextCharge(formatDate(preview.next_billed_at, "medium", { locale }))}
-                </dt>
+                <dt className="text-secondary">{labels.switchNextCharge(day(preview.next_billed_at))}</dt>
                 <dd className="text-right tabular-nums">{money(preview.next_minor, preview.currency)}</dd>
               </>
             )}

package/src/chart.ts

@@ -2,22 +2,36 @@
 //
 // A re-slicing of what the main barrel already exports, not a new API. It exists so a
 // consumer can reach the chart kit WITHOUT the barrel: `import("@eifi1/ui-kit/chart")`
-// is a 31KB chunk, where the same lazy import through the barrel pulls 221KB, because
-// a dynamic import of the barrel cannot be tree-shaken down to one of its members.
+// is a chunk of its own (50.4 KB min, 19.9 KB gzip at 0.51.6, refactor audit 2026-10-30
+// MOD-7; it was 31KB when this was written), where the same lazy import through the barrel
+// pulls the barrel, because a dynamic import of it cannot be tree-shaken down to one member.
 //
 // It is about chunk size, not about the peer: `recharts` is a REQUIRED peer (since 0.5.0),
 // because the main barrel re-exports everything here too, so `import { Button } from
 // "@eifi1/ui-kit"` reaches recharts as well (packaging-contract.test.ts asserts it).
 export * from "./components/chart";
 export * from "./theme/chart-palette";
+// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4,
+// decision 4), tagged on their specifiers as the barrel's are — the modules keep them.
+export {
+  /** @deprecated 0.52 — `chartEdge`, which measures a fill against it (API-4); removed in 0.53 */
+  EDGE_MIN_CONTRAST,
+  /** @deprecated 0.52 — `--chart-ink` (`CHART_ROLES.outline`), the same ink as a token (API-4); removed in 0.53 */
+  CHART_INK_HEX,
+} from "./theme/chart-palette";
 
 // The tile chart (treemap) the apps share — moved here from keksdose so every consumer
-// derives it from the package rather than from a copy.
+// derives it from the package rather than from a copy. 0.52: its `treemap` label namespace.
 export * from "./components/treemap";
+export * from "./components/treemap-labels";
 
 // lenkbank's zoomable series chart, its synced x-zoom, the toggle legend and the
 // mirrored-pair axis geometry — moved here so the apps derive them from the package.
 export * from "./components/series-chart";
+export {
+  /** @deprecated 0.52 — `SeriesChart`, which places its tooltip with it (API-4); removed in 0.53 */
+  resolveTooltipPlacement,
+} from "./components/series-chart";
 // 0.32.1 (keksdose's 0.32 report): the height every chart takes, for an app's wrappers.
 export type { ChartHeight } from "./components/chart-height";
 // SharedXZoom and the zoom's types: the public face of ./chart-zoom-core, whose arithmetic
@@ -28,6 +42,10 @@ export * from "./components/chart-zoom";
 // recharts, so chart-zoom-core has to be one of them (MOD-6).
 export { SharedXZoom } from "./components/chart-zoom-core";
 export * from "./components/toggle-legend";
+export {
+  /** @deprecated 0.52 — `strokeDash`, which picks a series' pattern from it (API-4); removed in 0.53 */
+  STROKE_PATTERNS,
+} from "./components/toggle-legend";
 export * from "./components/facing-pair";
 export * from "./components/series-chart-labels";