@eifi1/ui-kit 0.31.1 → 0.32.0

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

@@ -0,0 +1,158 @@
+import { ReactNode } from 'react';
+import { e4 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-BvdQdbv3.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../data-table-labels-kpAAVi6g.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../hooks/use-breakpoint.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-parts.js';
+import '../components/field-sync.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../lib/person-name.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../auth/sign-in-form.js';
+import '../landing/access.js';
+import '../landing/landing-labels.js';
+import '../shell/topbar-controls.js';
+import '../theme/palette-presets.js';
+import '../theme/chart-palette.js';
+import '../theme/theme-store.js';
+import 'zustand/middleware';
+import 'zustand';
+import '../auth/complete-name-dialog.js';
+import '../auth/forgot-password-form.js';
+import '../auth/status-parts.js';
+import '../auth/reset-password-form.js';
+import '../auth/verify-email.js';
+import '../auth/not-found-page.js';
+import '../auth/accept-invitation.js';
+import '../shell/company-switcher.js';
+import '../account/email-change-setting.js';
+import '../account/sessions-setting.js';
+import '../lib/format.js';
+import '../account/data-export-setting.js';
+import '../components/account-chips.js';
+import '../admin/admin-parts.js';
+import '../admin/admin-action-log.js';
+import '../settings/settings-labels.js';
+import '../demo/demo-labels.js';
+import '../components/appearance-labels.js';
+import '../theme/contrast.js';
+import '../theme/text-size.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/focus-ring.js';
+
+/** One reason an app may lock writing: whether it locks now, and its one sentence. */
+interface WriteLockSource {
+    locked: boolean;
+    /** The sentence a locked commit shows ("Not possible in the demo."). */
+    reason?: ReactNode;
+}
+/** What {@link combineWriteLocks} answers: the props of one `WriteLockProvider`. */
+interface CombinedWriteLock {
+    locked: boolean;
+    /** The first locked source's reason; `undefined` while nothing locks. */
+    reason: ReactNode | undefined;
+}
+/**
+ * Several reasons to lock writing, as ONE `WriteLockProvider` (docs/billing-harmonization.md
+ * §12.6): the demo's read-only data and billing's read-only lapse, in keksdose's case on
+ * the same budget page.
+ *
+ *     const demo = useDemoLabels();
+ *     const billingReason = useBillingLockReason({ guest: !isOwner, item: budget.name });
+ *     <WriteLockProvider {...combineWriteLocks([
+ *       { locked: demoReadOnly, reason: demo.writeLocked },
+ *       { locked: budget.locked === "billing", reason: billingReason },
+ *     ])}>
+ *
+ * WHY NOT TWO NESTED PROVIDERS: the nearest provider wins (write-lock.tsx), and an inner
+ * `locked={false}` REOPENS an outer lock on purpose — a viewer's own notes on a shared
+ * curve. So `<Demo locked><Billing locked={false}>` would unlock the demo's data, and an
+ * app would have to mount the inner provider only while it locks. One provider fed by
+ * this function has no such order to get wrong.
+ *
+ * Locked when any source is; the reason is the FIRST locked source's, so list them in the
+ * order the server refuses them (§12.3): the demo's 403 before billing's 402. One sentence,
+ * not two joined: a tooltip answers "why can't I?" once, and in practice one source locks
+ * at a time — demo users have no subscription row and are never gated (§12.7). `null`,
+ * `undefined` and `false` entries are skipped, for `cond && { … }`.
+ */
+declare function combineWriteLocks(sources: ReadonlyArray<WriteLockSource | null | undefined | false>): CombinedWriteLock;
+interface BillingLockReasonOptions {
+    /**
+     * The reader is a GUEST in someone else's item (§12.6): the reason never says why
+     * beyond "for now", because the owner's payment status is the owner's personal data —
+     * "This budget is read-only for now; its owner can lift that." Default false: the
+     * reader is the payer, "Your plan has ended. Choose a plan to make changes again."
+     */
+    guest?: boolean;
+    /** A guest's item, by its own name ("Household 2026"). Ignored for the payer. */
+    item?: string;
+    labels?: LabelOverride<BillingLabels>;
+}
+/**
+ * The billing lock's sentence for a `WriteLockProvider` (§3.3), in the `billing` words of
+ * the nearest provider: the payer's `lockReason`, or a guest's `guestReadOnly`. Feed it
+ * to {@link combineWriteLocks} beside the demo's.
+ */
+declare function useBillingLockReason(options?: BillingLockReasonOptions): string;
+
+export { type BillingLockReasonOptions, type CombinedWriteLock, type WriteLockSource, combineWriteLocks, useBillingLockReason };

package/dist/billing/billing-lock.js

@@ -0,0 +1,17 @@
+"use client";
+import { useBillingLabels } from "./billing-labels.js";
+function combineWriteLocks(sources) {
+  for (const source of sources) {
+    if (source && source.locked) return { locked: true, reason: source.reason };
+  }
+  return { locked: false, reason: void 0 };
+}
+function useBillingLockReason(options = {}) {
+  const labels = useBillingLabels(options.labels);
+  return options.guest ? labels.guestReadOnly(options.item) : labels.lockReason;
+}
+export {
+  combineWriteLocks,
+  useBillingLockReason
+};
+//# sourceMappingURL=billing-lock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/billing/billing-lock.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { useBillingLabels } from \"./billing-labels\";\nimport type { BillingLabels } from \"./billing-labels\";\n\n/** One reason an app may lock writing: whether it locks now, and its one sentence. */\nexport interface WriteLockSource {\n  locked: boolean;\n  /** The sentence a locked commit shows (\"Not possible in the demo.\"). */\n  reason?: ReactNode;\n}\n\n/** What {@link combineWriteLocks} answers: the props of one `WriteLockProvider`. */\nexport interface CombinedWriteLock {\n  locked: boolean;\n  /** The first locked source's reason; `undefined` while nothing locks. */\n  reason: ReactNode | undefined;\n}\n\n/**\n * Several reasons to lock writing, as ONE `WriteLockProvider` (docs/billing-harmonization.md\n * §12.6): the demo's read-only data and billing's read-only lapse, in keksdose's case on\n * the same budget page.\n *\n *     const demo = useDemoLabels();\n *     const billingReason = useBillingLockReason({ guest: !isOwner, item: budget.name });\n *     <WriteLockProvider {...combineWriteLocks([\n *       { locked: demoReadOnly, reason: demo.writeLocked },\n *       { locked: budget.locked === \"billing\", reason: billingReason },\n *     ])}>\n *\n * WHY NOT TWO NESTED PROVIDERS: the nearest provider wins (write-lock.tsx), and an inner\n * `locked={false}` REOPENS an outer lock on purpose — a viewer's own notes on a shared\n * curve. So `<Demo locked><Billing locked={false}>` would unlock the demo's data, and an\n * app would have to mount the inner provider only while it locks. One provider fed by\n * this function has no such order to get wrong.\n *\n * Locked when any source is; the reason is the FIRST locked source's, so list them in the\n * order the server refuses them (§12.3): the demo's 403 before billing's 402. One sentence,\n * not two joined: a tooltip answers \"why can't I?\" once, and in practice one source locks\n * at a time — demo users have no subscription row and are never gated (§12.7). `null`,\n * `undefined` and `false` entries are skipped, for `cond && { … }`.\n */\nexport function combineWriteLocks(\n  sources: ReadonlyArray<WriteLockSource | null | undefined | false>,\n): CombinedWriteLock {\n  for (const source of sources) {\n    if (source && source.locked) return { locked: true, reason: source.reason };\n  }\n  return { locked: false, reason: undefined };\n}\n\nexport interface BillingLockReasonOptions {\n  /**\n   * The reader is a GUEST in someone else's item (§12.6): the reason never says why\n   * beyond \"for now\", because the owner's payment status is the owner's personal data —\n   * \"This budget is read-only for now; its owner can lift that.\" Default false: the\n   * reader is the payer, \"Your plan has ended. Choose a plan to make changes again.\"\n   */\n  guest?: boolean;\n  /** A guest's item, by its own name (\"Household 2026\"). Ignored for the payer. */\n  item?: string;\n  labels?: LabelOverride<BillingLabels>;\n}\n\n/**\n * The billing lock's sentence for a `WriteLockProvider` (§3.3), in the `billing` words of\n * the nearest provider: the payer's `lockReason`, or a guest's `guestReadOnly`. Feed it\n * to {@link combineWriteLocks} beside the demo's.\n */\nexport function useBillingLockReason(options: BillingLockReasonOptions = {}): string {\n  const labels = useBillingLabels(options.labels);\n  return options.guest ? labels.guestReadOnly(options.item) : labels.lockReason;\n}\n"],"mappings":";AAGA,SAAS,wBAAwB;AAyC1B,SAAS,kBACd,SACmB;AACnB,aAAW,UAAU,SAAS;AAC5B,QAAI,UAAU,OAAO,OAAQ,QAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,OAAO;AAAA,EAC5E;AACA,SAAO,EAAE,QAAQ,OAAO,QAAQ,OAAU;AAC5C;AAoBO,SAAS,qBAAqB,UAAoC,CAAC,GAAW;AACnF,QAAM,SAAS,iBAAiB,QAAQ,MAAM;AAC9C,SAAO,QAAQ,QAAQ,OAAO,cAAc,QAAQ,IAAI,IAAI,OAAO;AACrE;","names":[]}

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

@@ -0,0 +1,149 @@
+import { DateInput } from '../lib/format.js';
+import { fb as SubscriptionStatus } from '../delete-account-setting-BvdQdbv3.js';
+import 'react';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../data-table-labels-kpAAVi6g.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../hooks/use-breakpoint.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-parts.js';
+import '../components/field-sync.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../lib/person-name.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../auth/sign-in-form.js';
+import '../landing/access.js';
+import '../landing/landing-labels.js';
+import '../shell/topbar-controls.js';
+import '../theme/palette-presets.js';
+import '../theme/chart-palette.js';
+import '../theme/theme-store.js';
+import 'zustand/middleware';
+import 'zustand';
+import '../auth/complete-name-dialog.js';
+import '../auth/forgot-password-form.js';
+import '../auth/status-parts.js';
+import '../auth/reset-password-form.js';
+import '../auth/verify-email.js';
+import '../auth/not-found-page.js';
+import '../auth/accept-invitation.js';
+import '../shell/company-switcher.js';
+import '../account/email-change-setting.js';
+import '../account/sessions-setting.js';
+import '../account/data-export-setting.js';
+import '../components/account-chips.js';
+import '../admin/admin-parts.js';
+import '../admin/admin-action-log.js';
+import '../settings/settings-labels.js';
+import '../demo/demo-labels.js';
+import '../components/appearance-labels.js';
+import '../theme/contrast.js';
+import '../theme/text-size.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/focus-ring.js';
+
+/**
+ * What a device knows of the payer's standing — the fields of `GET /billing/overview`
+ * (docs/billing-harmonization.md §4) that decide the read-only lock, under their wire
+ * names. Pass the overview as it came; the other fields are ignored.
+ */
+interface BillingStanding {
+    status: SubscriptionStatus;
+    /** The server's answer at the time of the read (§3.3). */
+    in_good_standing: boolean;
+    /** When a trial ends (§3.2). Empty for a pure guest whose trial has not started (§12.9). */
+    trial_ends_at?: DateInput;
+    /** When a free grant ends: a beta user's 12 months, an operator's grant. Empty for a
+     *  grant without an end (§12.8). */
+    comped_until?: DateInput;
+}
+/**
+ * The moment this payer's data becomes read-only by itself, known IN ADVANCE — or `null`
+ * when no date says so (docs/billing-harmonization.md §12.5).
+ *
+ * A device writes locally first and sends later (keksdose's outbox, an encrypted budget
+ * always), so a lock that only arrives with the server's 402 comes after the UI already
+ * said "saved" — keksdose's phantom save (dev#496). The two dates that end good standing
+ * on a schedule are in the overview, so the device locks itself on time, offline too:
+ * a trial at `trial_ends_at`, a grant at `comped_until`. Only `past_due` → `expired`
+ * depends on the provider's retries and waits for the next sync.
+ */
+declare function billingLockAt(standing: BillingStanding): Date | null;
+/**
+ * Whether the payer's data is read-only at `now` (default: the present moment): the
+ * server already said so (`in_good_standing: false`), or a date from
+ * {@link billingLockAt} has passed since the overview was read. Mirror it into the app's
+ * offline write gate and its `WriteLockProvider` (§3.3, §12.5).
+ *
+ * A GUEST's device cannot do this for the owner: the owner's dates are the owner's
+ * personal data (§12.6). An item shared with a guest carries `locked: "billing" | null`,
+ * which the guest's device mirrors as it comes.
+ */
+declare function isBillingReadOnly(standing: BillingStanding, now?: number | Date): boolean;
+/**
+ * Whole calendar days from `now` to `endsAt`, in the device's time zone — 0 on the day
+ * itself (and after it), 1 the day before — or `null` for no readable date. The count a
+ * trial or grant banner says ("ends tomorrow", "ends in 5 days"), from the day a reader
+ * lives in rather than from 24-hour blocks: a trial ending at 01:00 tomorrow ends
+ * "tomorrow", not "today".
+ */
+declare function billingDaysLeft(endsAt: DateInput, now?: number | Date): number | null;
+
+export { type BillingStanding, billingDaysLeft, billingLockAt, isBillingReadOnly };

package/dist/billing/billing-standing.js

@@ -0,0 +1,28 @@
+"use client";
+import { toDate } from "../lib/format.js";
+function billingLockAt(standing) {
+  if (standing.status === "trialing") return toDate(standing.trial_ends_at ?? null);
+  if (standing.status === "comped") return toDate(standing.comped_until ?? null);
+  return null;
+}
+function isBillingReadOnly(standing, now = Date.now()) {
+  if (!standing.in_good_standing) return true;
+  const at = billingLockAt(standing);
+  const instant = typeof now === "number" ? now : now.getTime();
+  return at !== null && at.getTime() <= instant;
+}
+const DAY = 864e5;
+function billingDaysLeft(endsAt, now = Date.now()) {
+  const end = toDate(endsAt);
+  if (!end) return null;
+  const from = typeof now === "number" ? new Date(now) : now;
+  const endDay = new Date(end.getFullYear(), end.getMonth(), end.getDate()).getTime();
+  const fromDay = new Date(from.getFullYear(), from.getMonth(), from.getDate()).getTime();
+  return Math.max(0, Math.round((endDay - fromDay) / DAY));
+}
+export {
+  billingDaysLeft,
+  billingLockAt,
+  isBillingReadOnly
+};
+//# sourceMappingURL=billing-standing.js.map

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

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

package/dist/billing/plan-card.d.ts

@@ -0,0 +1,248 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { e4 as LabelOverride, bH as BillingLabels } from '../delete-account-setting-BvdQdbv3.js';
+import { ChoiceCardProps } from '../components/choice-card.js';
+import { PlanPrices, BillingCurrency, BillingInterval } from './plan-price.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../data-table-labels-kpAAVi6g.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../hooks/use-breakpoint.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-parts.js';
+import '../components/field-sync.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../lib/person-name.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../auth/sign-in-form.js';
+import '../landing/access.js';
+import '../landing/landing-labels.js';
+import '../shell/topbar-controls.js';
+import '../theme/palette-presets.js';
+import '../theme/chart-palette.js';
+import '../theme/theme-store.js';
+import 'zustand/middleware';
+import 'zustand';
+import '../auth/complete-name-dialog.js';
+import '../auth/forgot-password-form.js';
+import '../auth/status-parts.js';
+import '../auth/reset-password-form.js';
+import '../auth/verify-email.js';
+import '../auth/not-found-page.js';
+import '../auth/accept-invitation.js';
+import '../shell/company-switcher.js';
+import '../account/email-change-setting.js';
+import '../account/sessions-setting.js';
+import '../lib/format.js';
+import '../account/data-export-setting.js';
+import '../components/account-chips.js';
+import '../admin/admin-parts.js';
+import '../admin/admin-action-log.js';
+import '../settings/settings-labels.js';
+import '../demo/demo-labels.js';
+import '../components/appearance-labels.js';
+import '../theme/contrast.js';
+import '../theme/text-size.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/focus-ring.js';
+
+/**
+ * One plan of the app's catalogue (docs/billing-harmonization.md §3.1) as a page shows it:
+ * server-kit's `PlanSpec` from `GET /billing/plans`, plus the words, which are the app's
+ * (display names and feature lines come from its i18n, never from the provider).
+ */
+interface BillingPlan {
+    /** The plan code, lowercase on the wire (§12.16); compared without case here. */
+    code: string;
+    /** The app's display name, in the reader's language: "Pro". */
+    name: string;
+    /** A line under the price. */
+    description?: ReactNode;
+    /** Gross prices in minor units, per currency and period (§3.1, §12.17). None at all —
+     *  or 0 — is a free plan. */
+    prices?: PlanPrices | null;
+    /** Dimension → limit; `null` is unlimited (§3.1). Shown in the object's order. */
+    limits?: Readonly<Record<string, number | null>>;
+    /** The app's feature lines. */
+    features?: readonly ReactNode[];
+    /** Not choosable — a plan being retired, say. */
+    disabled?: boolean;
+}
+/**
+ * How a plan stands to the one the payer pays for now: `current` is it, `upgrade` comes
+ * after it in the catalogue's order (`PlanSpec.sort`), `downgrade` before it.
+ */
+type PlanRelation = "current" | "upgrade" | "downgrade";
+/** The plan's place against `current`, by the order of `plans`; `undefined` without a
+ *  current plan (a trial, an ended plan) or for a code that is not in the list. */
+declare function planRelation(plans: readonly Pick<BillingPlan, "code">[], code: string, current: string | null | undefined): PlanRelation | undefined;
+/** What both parts need to draw a plan. */
+interface PlanDisplayProps {
+    /** The currency the prices are shown in (§2.6). */
+    currency: BillingCurrency;
+    /** The period the prices are shown for. */
+    interval: BillingInterval;
+    /** The app's name of each limit's dimension ("Budgets"). A dimension without one is
+     *  shown by its key. */
+    dimensionLabels?: Readonly<Record<string, string>>;
+    /** How a limit's figure is written — kastlan's storage is bytes (`formatFileSize`).
+     *  Default: a number in the kit's locale. */
+    formatLimit?: (dimension: string, value: number) => string;
+    /** Over the provider's locale. */
+    locale?: string;
+    /** Prop > `<UiKitProvider labels={{ billing }}>` > English. */
+    labels?: LabelOverride<BillingLabels>;
+}
+interface PlanCardProps extends Omit<ChoiceCardProps, "type" | "title" | "description" | "icon" | "indeterminate" | "value" | "labels">, PlanDisplayProps {
+    plan: BillingPlan;
+    /** See {@link PlanRelation}. `current` draws the "Current plan" chip — a word in the
+     *  card's name, never a colour alone. */
+    relation?: PlanRelation;
+    /**
+     * The provider's own localised price in place of the catalogue's figure (§12.17) — a
+     * Merchant of Record's price preview for the buyer's country, tax included. The period
+     * and "VAT included" stay: the law asks for a gross price, and the card says so.
+     */
+    pricePreview?: ReactNode;
+}
+/**
+ * One plan as a {@link ChoiceCard} radio (§7): the name (and "Current plan"), the GROSS
+ * price in the chosen currency and period through `formatMoney` ("CHF 49 per year, VAT
+ * included", §12.17), the limits ("Budgets: 3", "Seats: Unlimited") and the app's feature
+ * lines. A plan with prices but none for this currency and period is shown, "Not offered
+ * for this billing period", and cannot be picked.
+ *
+ * A radio of a set: give the cards one `name`, or use {@link PlanPicker}, which does that
+ * and owns the choice. Everything else a `ChoiceCard` takes goes to it — `checked`,
+ * `onCheckedChange`, `name`, `className`. Carries `data-plan` and `data-relation`.
+ */
+declare const PlanCard: react.ForwardRefExoticComponent<PlanCardProps & react.RefAttributes<HTMLInputElement>>;
+/** What {@link PlanPickerProps.onChoose} is handed: everything `POST /billing/checkout`
+ *  takes (§4). */
+interface PlanChoice {
+    plan: string;
+    interval: BillingInterval;
+    currency: BillingCurrency;
+}
+interface PlanPickerProps extends Omit<PlanDisplayProps, "currency" | "interval"> {
+    /** The catalogue, in its order (`PlanSpec.sort`): cheapest first. The order decides
+     *  upgrade and downgrade. */
+    plans: readonly BillingPlan[];
+    /**
+     * The plan the payer pays for now (`plan` of the overview while `active` or
+     * `past_due`). Leave it out during a trial and after a plan ended: then every plan is
+     * "Choose …", the trial's plan included, since none is paid for yet.
+     */
+    current?: string | null;
+    /** The picked plan, controlled. `null` while none is. */
+    value?: string | null;
+    /** The picked plan, uncontrolled. Default: `current`, else nothing. */
+    defaultValue?: string | null;
+    onValueChange?: (plan: string) => void;
+    /** The period, controlled. */
+    interval?: BillingInterval;
+    /** The period, uncontrolled. Default `year` — lead with yearly (§12.17). */
+    defaultInterval?: BillingInterval;
+    onIntervalChange?: (interval: BillingInterval) => void;
+    /** The currency, controlled. */
+    currency?: BillingCurrency;
+    /** The currency, uncontrolled. Default: the account's stored currency is the app's to
+     *  pass here (§12.18); without it, {@link billingCurrencyFor} the kit's locale. */
+    defaultCurrency?: BillingCurrency;
+    onCurrencyChange?: (currency: BillingCurrency) => void;
+    /** The currencies the payer may switch between. Default: every currency a plan has a
+     *  price in. The switch shows only for more than one. */
+    currencies?: readonly BillingCurrency[];
+    /** The button: the app starts its checkout (`POST /billing/checkout`, then off to the
+     *  provider's page). The kit sends no request. */
+    onChoose: (choice: PlanChoice) => void;
+    /** The checkout is being opened: the button's spinner, no second press. */
+    pending?: boolean;
+    /** The provider's localised price for a plan, or `undefined` for the catalogue's —
+     *  see {@link PlanCardProps.pricePreview}. */
+    pricePreview?: (plan: BillingPlan, choice: Omit<PlanChoice, "plan">) => ReactNode | undefined;
+    /** A visible question over the cards. Without one the set is named "Plans". */
+    legend?: ReactNode;
+    /** Shared by the radios. Generated if omitted. */
+    name?: string;
+    /** Classes for the whole picker. */
+    className?: string;
+    /** Classes for the card grid. Default: one column, two from `sm`, three from `lg`. */
+    gridClassName?: string;
+    /** Classes for every card. */
+    cardClassName?: string;
+}
+/**
+ * The plans to choose from (§7): the period switch — yearly first (§12.17) — and, where
+ * the payer may pay in either, the currency switch (§2.6); a {@link PlanCard} per plan in
+ * a radio set; and one button that says what pressing it does: "Upgrade to Pro", "Switch
+ * to Free", or "Choose Pro" with no plan paid for yet.
+ *
+ * One button under the set rather than one per card: each card IS a radio — a `<label>`
+ * round an `<input>` — and a button inside a label is interactive content inside
+ * interactive content. Picking and committing are two steps anyway: the price under the
+ * picked card is what checkout will charge.
+ *
+ * The button never takes the write lock: billing itself always works, a read-only payer
+ * must be able to pay (§3.3). It is off, with the reason on hover and focus, while
+ * nothing is picked or the current plan is.
+ */
+declare function PlanPicker({ plans, current, value: valueProp, defaultValue, onValueChange, interval: intervalProp, defaultInterval, onIntervalChange, currency: currencyProp, defaultCurrency, onCurrencyChange, currencies: currenciesProp, onChoose, pending, pricePreview, legend, name, className, gridClassName, cardClassName, dimensionLabels, formatLimit, locale: localeProp, labels: labelsProp, }: PlanPickerProps): react.JSX.Element;
+
+export { type BillingPlan, PlanCard, type PlanCardProps, type PlanChoice, PlanPicker, type PlanPickerProps, type PlanRelation, planRelation };