@everfur/sdk 0.12.0 → 0.13.0

package/dist/focus.d-az9cqUz3.d.cts

@@ -0,0 +1,1178 @@
+import { ReactNode } from 'react';
+import { P as PetRef, U as UserRef } from './ids.d-B2GAAifq.cjs';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.cjs';
+import { L as LifecyclePort } from './LifecyclePort.d-Cr1p33a7.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { R as RequestFunnel } from './requestFunnel.d-DWQQpjFR.cjs';
+import { A as AuthContext } from './identity.d-60LeJt_s.cjs';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-DirW9hgO.cjs';
+
+/** Where a reason comes from. An unknown kind reads as `profile` (a fact about the pet). */
+declare const HEALTH_PLAN_REASON_KINDS: readonly ["dna", "records", "inside", "profile"];
+type HealthPlanReasonKind = (typeof HEALTH_PLAN_REASON_KINDS)[number];
+interface HealthPlanReason {
+    readonly kind: HealthPlanReasonKind;
+    /** The partner's catalog text or an Everfur fact, verbatim. */
+    readonly text: string;
+}
+/** One product in a pet's plan. */
+interface HealthPlanItem {
+    readonly productId: string;
+    /** The partner's own SKU: what `onCheckout` hands back so the partner's cart can find it. */
+    readonly partnerSku: string | null;
+    readonly title: string;
+    readonly description: string | null;
+    /** The partner's catalog category (`Supplement`), up to 60 characters, or null. */
+    readonly category: string | null;
+    /** The price as a number in `currency` units, or null when the catalog carries none. */
+    readonly price: number | null;
+    /** ISO 4217 (`USD`), or null. */
+    readonly currency: string | null;
+    /** https only; anything else is dropped. */
+    readonly imageUrl: string | null;
+    /** The partner's product page, https only, or null. */
+    readonly url: string | null;
+    readonly reasons: readonly HealthPlanReason[];
+    /** Whether the member has this item in the plan. */
+    readonly inPlan: boolean;
+    /** A demo product, labelled as a sample wherever it is drawn. */
+    readonly sample: boolean;
+}
+interface HealthPlan {
+    readonly petRef: PetRef;
+    /** The plan title the tenant's template rendered for this pet, or null. */
+    readonly headline: string | null;
+    readonly items: readonly HealthPlanItem[];
+    /** ISO 8601, or null. */
+    readonly updatedAt: string | null;
+    /**
+     * Wire `tracking_texts_enabled`: Everfur texts the owner when the partner sets tracking. Absent on the wire reads as
+     * false. Optional here so a host's own plan objects keep compiling.
+     */
+    readonly trackingTextsEnabled?: boolean;
+}
+interface HealthPlanRepository {
+    /** `GET /widget/v1/pets/{pet_ref}/plan`. Settles; never throws. */
+    read(petRef: PetRef, opts?: {
+        readonly signal?: AbortSignal;
+    }): Promise<EverfurResult<HealthPlan>>;
+    /** `PUT .../plan/items/{product_id}`. Settles the plan the server returned, or null for an empty answer. */
+    addItem(petRef: PetRef, productId: string): Promise<EverfurResult<HealthPlan | null>>;
+    /** `DELETE .../plan/items/{product_id}`. Settles the plan the server returned, or null for an empty answer. */
+    removeItem(petRef: PetRef, productId: string): Promise<EverfurResult<HealthPlan | null>>;
+}
+/** The part of the runtime this repository needs (`useEverfurContext().runtime` satisfies it). */
+interface HealthPlanRuntime {
+    readonly isDisposed: boolean;
+    readonly registry: {
+        readonly services: {
+            authFor(userRef: UserRef | null): AuthContext;
+            readonly errorPolicy: ErrorPolicyPort | undefined;
+        };
+    };
+}
+interface HealthPlanRepositoryDeps {
+    readonly auth: AuthContext;
+    readonly errorPolicy?: ErrorPolicyPort;
+    readonly funnel?: RequestFunnel;
+}
+/** The allowlist mapper for one plan body. `items` must be a list; a row that is not an item is dropped. */
+declare function healthPlanFromWire(raw: unknown, petRef: PetRef): HealthPlan | null;
+/** The repository over the runtime under your provider. Auth is read at CALL time; a disposed runtime sends nothing. */
+declare function createHealthPlanRepository(runtime: HealthPlanRuntime): HealthPlanRepository;
+/** The same repository over one auth context (or an injected funnel). Internal seam, for deterministic tests. */
+declare function createHealthPlanRepositoryOver(deps: HealthPlanRepositoryDeps): HealthPlanRepository;
+
+type EverfurHealthPlanStatus = 'signedOut' | 'noPet' | 'loading' | 'failed' | 'empty' | 'ready';
+/** The member's cart: the items in the plan, and their total when one can honestly be given. */
+interface HealthPlanCart {
+    readonly items: readonly HealthPlanItem[];
+    readonly count: number;
+    /**
+     * The sum of the priced items, or null when any item has no price or the items do not share one currency
+     * (a total across currencies is a number nobody can pay).
+     */
+    readonly subtotal: number | null;
+    /** The shared currency of `subtotal`, or null. */
+    readonly currency: string | null;
+}
+interface EverfurHealthPlanOptions {
+    /** The pet whose plan to show. Omit it and the provider's active pet is used. */
+    readonly petRef?: PetRef | null;
+    /**
+     * The host's lifecycle signals: coming back to the foreground re-reads a plan shown for more than a minute, quietly
+     * (the plan stays on screen). Absent, only `refreshKey` and `refresh()` re-read.
+     */
+    readonly lifecycle?: LifecyclePort | null;
+    /** Change it to re-read the plan now, quietly (for example after your checkout completed). */
+    readonly refreshKey?: string | number;
+}
+interface EverfurHealthPlanState {
+    readonly status: EverfurHealthPlanStatus;
+    readonly petRef: PetRef | null;
+    readonly plan: HealthPlan | null;
+    readonly cart: HealthPlanCart;
+    /** Product ids whose add or remove is in flight. */
+    readonly pending: readonly string[];
+    /** The last refused write per product id. */
+    readonly itemErrors: Readonly<Record<string, EverfurError>>;
+    /** The refused read, or null. */
+    readonly error: EverfurError | null;
+    /** Put an item in the plan (`true`) or take it out (`false`). Optimistic; rolls back on a refusal. */
+    setInPlan(productId: string, inPlan: boolean): Promise<boolean>;
+    refresh(): Promise<void>;
+}
+/** The cart a plan makes. Pure, so a partner's own cart UI reads the same totals. */
+declare function healthPlanCart(plan: HealthPlan | null): HealthPlanCart;
+/**
+ * A price as the member reads it: the platform's own currency format (`$19.99`), or `USD 19.99` where the runtime
+ * has no formatter for that currency. Null for an item with no price; the surface shows none rather than `$0`.
+ * `locale` picks the number format (omit it for the platform default). With `format.dropZeroCents` a whole amount
+ * reads without minor units (`$39`); a non-whole one keeps them (`$29.99`).
+ */
+declare function formatHealthPlanPrice(amount: number | null, currency: string | null, locale?: string, format?: Pick<HealthPlanPriceFormat, 'dropZeroCents'>): string | null;
+/** `formatHealthPlanPrice` with a page's `priceFormat` option. */
+declare function formatHealthPlanPriceWith(amount: number | null, currency: string | null, format?: HealthPlanPriceFormat): string | null;
+/** The Health Plan repository bound to the runtime under your provider, for a partner's own UI. */
+declare function useEverfurHealthPlanRepository(): HealthPlanRepository;
+/** One pet's Health Plan and the member's cart. `EverfurHealthPlan` renders it on either host. */
+declare function useEverfurHealthPlan(options?: EverfurHealthPlanOptions): EverfurHealthPlanState;
+
+/** Where a product's picture sits on its card. */
+type HealthPlanImageVariant = 'wide' | 'thumbnail';
+/** How a product's reasons are drawn. */
+type HealthPlanReasonVariant = 'pills' | 'rows';
+/** When the page draws the cart bar. */
+type HealthPlanCartBarVisibility = 'whenItems' | 'always';
+/** Where the cart bar lives: stuck to the foot of the page, or nowhere on the page (the host docks its own). */
+type HealthPlanCartBarPlacement = 'sticky' | 'none';
+/** The size of a product card's add control: a named size, or the pill's height in px. */
+type HealthPlanAddButtonSize = 'full' | 'compact' | number;
+/** How a product in the cart shows: "Added" with a Remove link, or the add pill held pressed. */
+type HealthPlanAddedVariant = 'link' | 'pressed';
+/** How a product's category reads: body text, or the reason-row label face (mono, uppercase). */
+type HealthPlanCategoryVariant = 'text' | 'label';
+/** A shadow of the partner's own, painted the same way on both hosts. Lengths are px. */
+interface HealthPlanShadow {
+    /** Any colour the theme parser reads (`#RRGGBB`, `rgba(...)`). */
+    readonly color: string;
+    readonly offsetX?: number;
+    readonly offsetY: number;
+    readonly blur: number;
+    /** 0..1, multiplied into the colour's own alpha. Default 1. */
+    readonly opacity?: number;
+}
+/** A card shadow: `true` for the SDK's soft one, a CSS shadow string, or a `HealthPlanShadow`. */
+type HealthPlanCardShadow = boolean | string | HealthPlanShadow;
+/** A font weight a card text accepts. */
+type HealthPlanFontWeight = 400 | 500 | 600 | 700 | 800 | 900;
+/** How a price reads. Prices always go through `Intl.NumberFormat` with the item's own currency. */
+interface HealthPlanPriceFormat {
+    /** A BCP 47 locale for the number format. Omit it and the platform's default locale is used. */
+    readonly locale?: string;
+    /** True to drop zero minor units on a whole amount (`$39` instead of `$39.00`). A non-whole amount keeps them. */
+    readonly dropZeroCents?: boolean;
+}
+declare const HEALTH_PLAN_LAYOUT_DEFAULTS: Readonly<{
+    imageVariant: HealthPlanImageVariant;
+    reasonVariant: HealthPlanReasonVariant;
+    cartBarVisibility: HealthPlanCartBarVisibility;
+    cartBarPlacement: HealthPlanCartBarPlacement;
+    addButtonSize: HealthPlanAddButtonSize;
+    addedVariant: HealthPlanAddedVariant;
+    categoryVariant: HealthPlanCategoryVariant;
+    showCategory: false;
+    cardShadow: false;
+    cardBorder: true;
+}>;
+/** True when the page should draw the cart bar for a cart of `count` items. */
+declare function showHealthPlanCartBar(visibility: HealthPlanCartBarVisibility | undefined, count: number): boolean;
+/**
+ * What a partner's header and footer nodes are handed: the pet, its plan and the member's cart, as the page draws
+ * them. `cart.items` are the products in the plan, `cart.count` how many, `cart.subtotal` their sum (null when the
+ * currencies differ or a price is missing).
+ */
+interface HealthPlanHeaderContext {
+    readonly petRef: PetRef | null;
+    readonly plan: HealthPlan | null;
+    readonly cart: HealthPlanCart;
+    /**
+     * Put a product in the plan (`true`) or take it out (`false`), through the same optimistic write the cards use:
+     * the card flips at once and a refusal puts it back. Resolves true when the server accepted it.
+     */
+    readonly setInPlan: (productId: string, inPlan: boolean) => Promise<boolean>;
+    /** Put every product not yet in the plan into it. Resolves true when every write was accepted. */
+    readonly addAll: () => Promise<boolean>;
+}
+/** The same context, named for the page footer. */
+type HealthPlanPageContext = HealthPlanHeaderContext;
+/** The card options `HealthPlanItemCard` takes, on both hosts. */
+interface HealthPlanCardOptions {
+    /** True to draw the product's category above its name. Default false. */
+    readonly showCategory?: boolean;
+    /**
+     * A shadow under the card: `true` for the SDK's soft one (the theme's shadow colour at 8%), a CSS shadow string
+     * (`0 1px 3px rgba(38,37,35,.06)`; React Native reads the first shadow's offset, blur and colour), or a
+     * `HealthPlanShadow`. Default none.
+     */
+    readonly cardShadow?: HealthPlanCardShadow;
+    /** False to drop the card's hairline edge. Default true. */
+    readonly cardBorder?: boolean;
+    /** `'full'` (default, 44 high), `'compact'` (32 high), or the pill's height in px. The tap area stays 44. */
+    readonly addButtonSize?: HealthPlanAddButtonSize;
+    /** The add control's font size in px. Default: body for a pill 40 or taller, else caption. */
+    readonly addButtonFontSize?: number;
+    /** `'link'` (default): "Added" and a Remove link. `'pressed'`: the pill stays, pressed; a tap removes it. */
+    readonly addedVariant?: HealthPlanAddedVariant;
+    /** `'text'` (default) or `'label'` (the reason-row label face). Only read with `showCategory`. */
+    readonly categoryVariant?: HealthPlanCategoryVariant;
+    /** The card's inner padding in px. Default the theme's `space.lg`. */
+    readonly cardPadding?: number;
+    /** The product name's size (px) and weight. Default body size, bold. */
+    readonly itemTitleSize?: number;
+    readonly itemTitleWeight?: HealthPlanFontWeight;
+    /** The price's size (px) and weight. Default body size, bold. */
+    readonly priceSize?: number;
+    readonly priceWeight?: HealthPlanFontWeight;
+    /** The reason text's size (px). Default caption size. */
+    readonly reasonTextSize?: number;
+    /** The label column of `'rows'` reasons in px. Default sized to the longest label (web) or 72 (React Native). */
+    readonly reasonLabelWidth?: number;
+    /** The space between a reason row's label and its text in px. Default the theme's `space.lg`. */
+    readonly reasonGap?: number;
+}
+/** The layout props `EverfurHealthPlan` takes on both hosts. Paint stays the theme's. */
+interface HealthPlanLayoutProps extends HealthPlanCardOptions {
+    /** Where each product's picture sits. Default `'wide'`. */
+    readonly imageVariant?: HealthPlanImageVariant;
+    /** How each product's reasons are drawn. Default `'pills'`. */
+    readonly reasonVariant?: HealthPlanReasonVariant;
+    /** When the cart bar is drawn. Default `'whenItems'`. */
+    readonly cartBarVisibility?: HealthPlanCartBarVisibility;
+    /** How prices and the subtotal read. */
+    readonly priceFormat?: HealthPlanPriceFormat;
+    /**
+     * Your own node between the plan title and the products (a summary or risk card of yours). Drawn on the plan and
+     * on the empty plan. A throw while rendering it draws nothing in its place.
+     */
+    readonly renderHeader?: (context: HealthPlanHeaderContext) => ReactNode;
+    /** Your own node at the foot of each product card, above its control. A throw draws nothing in its place. */
+    readonly renderItemFooter?: (item: HealthPlanItem) => ReactNode;
+    /**
+     * Your own node after the products, before the cart bar (totals, an upsell row, fine print). Drawn on the plan only.
+     * A throw draws nothing in its place.
+     */
+    readonly renderFooter?: (context: HealthPlanPageContext) => ReactNode;
+    /** The plan title's font size in px. Default the theme's heading size. */
+    readonly titleSize?: number;
+    /** The space under the plan title in px. Default the section gap. */
+    readonly titleGap?: number;
+    /** The space between the page's blocks in px. Default the theme's `space.lg`. */
+    readonly sectionGap?: number;
+    /** Where the cart bar lives. Default `'sticky'`. With `'none'`, wrap the page and your bar in `HealthPlanCartScope`. */
+    readonly cartBarPlacement?: HealthPlanCartBarPlacement;
+    /** The plan title's line height as a ratio of its size (1.15 reads tight). Default the theme's snug ratio. */
+    readonly titleLineHeight?: number;
+    /**
+     * Your own node between two products (a group label such as a list heading), drawn before the product at `index`
+     * (1 and up; never before the first). Return null for no node. A throw draws nothing in its place.
+     */
+    readonly renderBetweenItems?: (index: number, item: HealthPlanItem) => ReactNode;
+}
+/**
+ * True for a refusal because the session is not a SIGNED member session: the plan routes answer a publishable-key or
+ * unsigned caller 403 `session_required` (EFBackend partner_shop_widget_router.py). A retry cannot help, so the
+ * surface shows the sign-in line and no retry.
+ */
+declare function isHealthPlanSessionRequired(error: EverfurError | null): boolean;
+
+/** The icons the layout draws. `renderIcon` lets the host draw its own; the SDK has a plain default for each. */
+type HealthPlanFocusIcon = 'shield' | 'arrow' | 'check' | 'star' | 'truck' | 'refresh' | 'card' | 'alert' | 'x' | 'chat' | 'repeat' | 'calendar' | 'flame' | 'box' | 'cart' | 'minus' | 'plus' | 'chev' | 'pulse' | 'file' | 'kit' | 'dna' | 'heart' | 'bottle' | 'harness' | 'ramp';
+/** One free tip of the routine. Tips are numbered in order and never checked off. */
+interface HealthPlanFocusStep {
+    readonly title: string;
+    readonly body?: string;
+    /** Where the tip comes from ("From her vet records"). */
+    readonly source?: string;
+    /** The card's tint, a `tip:<tone>` class for a host that styles parts (Raph v3 draws the tips as tinted cards). */
+    readonly tone?: 'y' | 'c' | 'g' | 'r';
+    /** The icon beside the tip's number. */
+    readonly icon?: HealthPlanFocusIcon;
+}
+/** One review of the product, word for word from the partner's store. */
+interface HealthPlanFocusReview {
+    /** Whole stars, 1..5. */
+    readonly stars: number;
+    readonly text: string;
+    /** Who wrote it ("Robin"). */
+    readonly by: string;
+}
+/** Another offer of the partner's, after the plan ("Another dog at home?"). The words and prices are the host's. */
+interface HealthPlanFocusExtra {
+    /** Your id for it, handed back to `onExtra`. */
+    readonly key: string;
+    readonly title: string;
+    readonly body?: string;
+    /** The price as you show it ("$75") and, struck, the usual price ("$139"). */
+    readonly price?: string;
+    readonly was?: string;
+    /** A small tag beside the price ("Illustrative"). */
+    readonly tag?: string;
+    /** https or a same-origin path; drawn in place of `icon`. */
+    readonly imageUrl?: string;
+    readonly icon?: HealthPlanFocusIcon;
+    /** A modifier kind for the row (`extra:<kind>`) and for its title (`extraTitle:<kind>`). */
+    readonly kind?: string;
+    /** The button's words before ("Add a kit") and after ("Added to cart") it is pressed. */
+    readonly action: string;
+    readonly added: string;
+    /**
+     * The Everfur product this offer is, when it is one of the pet's plan items. With the shop on (`shop: true`), its
+     * button puts that item in the cart (and reads "View cart" once it is in). Without one, the button is `onExtra`'s.
+     */
+    readonly productId?: string;
+}
+/** One step of a tracker (an order's, a test kit's). The words and dates are the host's or the server's. */
+interface HealthPlanTrackStep {
+    readonly title: string;
+    /** The line under it: a date, or "Expected Dec 8". */
+    readonly detail?: string;
+    /** `done` draws the check, `now` the current step; anything else is still ahead. */
+    readonly state?: 'done' | 'now' | 'next';
+    /** A tag after the line (a demo marks a made-up date "Illustrative"). */
+    readonly tag?: string;
+}
+/**
+ * What the page says while the pet's plan cannot be made yet (the partner's test results are not back yet). With it, the page
+ * draws its title, this card and the partner's other offers only: no focus, routine, pick or signs. The words and the
+ * kit's tracker are the partner's (Everfur does not know where a kit is).
+ */
+interface HealthPlanFocusWait {
+    readonly kicker: string;
+    readonly title: string;
+    readonly icon?: HealthPlanFocusIcon;
+    readonly track?: readonly HealthPlanTrackStep[];
+    /** The heading over the rows ("What her plan will hold"). */
+    readonly heading?: string;
+    readonly rows?: readonly {
+        readonly icon: HealthPlanFocusIcon;
+        readonly label: string;
+        readonly text: string;
+    }[];
+    /** The line with the chat icon under the rows ("We'll text you when it's ready."). */
+    readonly note?: string;
+    /** The button under it; drawn only with `onWaitAction`. */
+    readonly action?: string;
+}
+interface HealthPlanFocusReasonRow {
+    /** The chip word ("Record", "Ask"). */
+    readonly chip: string;
+    /** A modifier kind for the chip class (`chip:<kind>`). */
+    readonly kind?: string;
+    readonly title: string;
+    readonly body?: string;
+}
+interface HealthPlanFocusSign {
+    readonly title: string;
+    readonly body: string;
+    /** An emergency sign: drawn with the alert icon and the `sign:urgent` modifier. */
+    readonly urgent?: boolean;
+}
+/**
+ * Everything the focus layout says about the pet. Every string is the host's (or the backend page's), drawn verbatim.
+ * `focus`, `routine` and `signs` are optional: a section that is absent is not drawn.
+ */
+interface HealthPlanFocusDesign {
+    readonly eyebrow?: string;
+    readonly title: string;
+    readonly subtitle?: string;
+    /** https or a same-origin path; the pet's photo beside the title. */
+    readonly headImageUrl?: string;
+    readonly byline?: {
+        readonly name: string;
+        readonly role?: string;
+        readonly imageUrl?: string;
+    };
+    readonly focus?: {
+        readonly kicker: string;
+        readonly sources?: readonly {
+            readonly label: string;
+            readonly kind?: string;
+        }[];
+        readonly title: string;
+        /** The risk line: a bold lead and the rest of the sentence. `kind` picks the dot modifier. */
+        readonly risk?: {
+            readonly lead: string;
+            readonly body?: string;
+            readonly kind?: string;
+        };
+        readonly odds?: {
+            readonly label: string;
+            readonly tag?: string;
+            readonly from: string;
+            readonly to: string;
+            readonly toLabel?: string;
+        };
+        /** The vet's line. With `imageUrl`, a host that styles parts gets the one-row form: photo, then the kicker in bold before the text. */
+        readonly quote?: {
+            readonly kicker: string;
+            readonly tag?: string;
+            readonly text: string;
+            readonly imageUrl?: string;
+        };
+        /** The strip that jumps to the product. Its kicker is `copy.jumpKicker`. */
+        readonly jump?: {
+            readonly title: string;
+            readonly go: string;
+        };
+    };
+    readonly routine?: {
+        readonly title: string;
+        /** The line beside the title ("5 free tips"). */
+        readonly label?: string;
+        readonly steps: readonly HealthPlanFocusStep[];
+    };
+    readonly pick: {
+        readonly title: string;
+        /**
+         * The plan item to recommend: the item with this Everfur product id, else the item with `partnerSku` (your own
+         * catalog id, the same in every environment). Neither found or given: the plan's first item.
+         */
+        readonly productId?: string;
+        readonly partnerSku?: string;
+        /** The rating as the partner shows it ("4.4") and its label ("· 92 reviews"). */
+        readonly rating?: {
+            readonly value: string;
+            readonly label?: string;
+        };
+        /** One line under the product name. Defaults to the catalog description. */
+        readonly line?: string;
+        /** Real reviews under the stars, word for word from your store. `label` names where they come from. */
+        readonly reviews?: {
+            readonly label: string;
+            readonly items: readonly HealthPlanFocusReview[];
+        };
+        /** The line under the product in the checkout and manage sheets ("For her back · 1 chew a day"). Defaults to `line`. */
+        readonly checkoutLine?: string;
+        /** Why it fits, one row per real signal; `score` is the count line under them ("3 of 3 signals fit Georgia", "3/3"). */
+        readonly why?: {
+            readonly title: string;
+            readonly rows: readonly HealthPlanFocusReasonRow[];
+            readonly score?: {
+                readonly text: string;
+                readonly value: string;
+            };
+        };
+        readonly dose?: {
+            readonly title: string;
+            readonly stats: readonly {
+                readonly value: string;
+                readonly label: string;
+            }[];
+            readonly note?: string;
+        };
+        readonly ingredients?: {
+            readonly label?: string;
+            readonly items: readonly string[];
+        };
+        /** A line under the buy button with the flame icon, on a true number of the partner's ("Built on <a count your data backs>"). Hidden once subscribed. */
+        readonly proof?: string;
+        readonly trust?: readonly {
+            readonly icon: HealthPlanFocusIcon;
+            readonly label: string;
+        }[];
+        /** The "Why this product?" link. Drawn only with `onMore`. */
+        readonly more?: string;
+        readonly fine?: string;
+        /** The check-in question the started screen names ("how's she moving?"). */
+        readonly checkin?: string;
+    };
+    readonly signs?: {
+        readonly title: string;
+        readonly items: readonly HealthPlanFocusSign[];
+    };
+    /** What to ask at the checkup. With `signs` it sits in the signs section under its own kicker; alone, it is a section. */
+    readonly checkup?: {
+        readonly title: string;
+        readonly questions: readonly string[];
+        readonly add: string;
+        readonly added: string;
+    };
+    /** The partner's other offers, last ("More from <your brand>"). Drawn only with `onExtra`. */
+    readonly extras?: {
+        readonly title: string;
+        readonly items: readonly HealthPlanFocusExtra[];
+    };
+    readonly fine?: string;
+    /** Checkout rows ("Ships to" / "Home, on file with <your brand>"). The partner knows these; Everfur does not. */
+    readonly checkoutRows?: readonly {
+        readonly icon: HealthPlanFocusIcon;
+        readonly label: string;
+        readonly value: string;
+    }[];
+    /** The plan cannot be made yet: draw this card in place of the plan (see `HealthPlanFocusWait`). */
+    readonly wait?: HealthPlanFocusWait;
+    readonly copy?: Partial<HealthPlanFocusCopy>;
+}
+/** Facts the copy functions receive, all formatted from the server's answers. */
+interface HealthPlanFocusPrices {
+    readonly petName: string | null;
+    readonly productName: string;
+    /** The first box as the member reads it (`$23.99`), or the box price when no offer applies. */
+    readonly first: string | null;
+    /** The regular box price (`$29.99`). */
+    readonly box: string | null;
+    /** One box, no renewal (`$28.49`), or the box price when there is no one-box discount. */
+    readonly once: string | null;
+    /** The one-box discount, 0 when none. */
+    readonly onceDiscountPercent: number;
+    readonly intervalDays: number;
+    readonly discountPercent: number;
+    readonly offer: boolean;
+}
+/** The words the SDK says about buying. Defaults: Raph's v3 design, 2026-10-16. */
+interface HealthPlanFocusCopy {
+    readonly jumpKicker: (p: HealthPlanFocusPrices, subscribed: boolean) => string;
+    readonly optionsLabel: string;
+    readonly subscribe: string;
+    readonly bestValue: string;
+    readonly subscribeLine: (p: HealthPlanFocusPrices) => string;
+    readonly priceLine: (p: HealthPlanFocusPrices) => string;
+    readonly once: string;
+    readonly onceLine: (p: HealthPlanFocusPrices) => string;
+    readonly buyOnce: (p: HealthPlanFocusPrices) => string;
+    readonly subscribed: string;
+    readonly subscribedLine: (p: HealthPlanFocusPrices, nextBox: string | null) => string;
+    readonly manage: string;
+    readonly checkoutKicker: string;
+    readonly checkoutTitle: (p: HealthPlanFocusPrices) => string;
+    readonly checkoutOffer: (p: HealthPlanFocusPrices) => string;
+    readonly shipsEvery: string;
+    readonly days: (n: number) => string;
+    readonly buyOnceOption: string;
+    readonly checkoutGo: (p: HealthPlanFocusPrices, subscribe: boolean, today: string) => string;
+    readonly renews: (p: HealthPlanFocusPrices) => string;
+    readonly onceFine: string;
+    /** The checkout's Buy once line under its price. */
+    readonly onceOffer: (p: HealthPlanFocusPrices) => string;
+    /** Appended to the checkout's fine print (a sandbox says nothing is charged). Empty by default. */
+    readonly checkoutNote: string;
+    readonly close: string;
+    readonly startedTitle: (p: HealthPlanFocusPrices) => string;
+    /** The started screen's title after a one-box order. */
+    readonly orderedTitle: (p: HealthPlanFocusPrices) => string;
+    readonly startedWhat: (p: HealthPlanFocusPrices) => string;
+    /** A line under the started title (a sandbox says nothing was charged). Empty by default. */
+    readonly startedNote: string;
+    readonly startedSteps: string;
+    readonly tomorrow: string;
+    readonly firstBoxShips: string;
+    /**
+     * Added after `firstBoxShips` and `placedShips`, and the order screen's `trackingByText` is drawn, only when Everfur
+     * texts the tracking number for this partner (the plan page's `tracking_texts_enabled`, or `trackingTexts`).
+     */
+    readonly trackingComesByText: string;
+    readonly checkin: (question: string | null) => string;
+    readonly refill: string;
+    readonly nextBoxShips: (p: HealthPlanFocusPrices) => string;
+    readonly startedDone: string;
+    readonly manageKicker: string;
+    readonly manageTitle: (p: HealthPlanFocusPrices) => string;
+    readonly skip: string;
+    readonly cancel: string;
+    readonly skipped: (p: HealthPlanFocusPrices, nextBox: string | null) => string;
+    readonly cancelled: (p: HealthPlanFocusPrices) => string;
+    readonly orders: string;
+    /** The host header's title over each pushed screen (`onOverlayChange` hands it over). */
+    readonly startedHeader: string;
+    readonly placedHeader: string;
+    readonly cartCheckoutTitle: string;
+    /** Appended to an Everfur order's fine print (a sandbox says nothing was charged). Empty by default. */
+    readonly orderNote: string;
+    /** The cart button's label: `count` items in it, 0 when empty. */
+    readonly cartLabel: (count: number) => string;
+    /** The pick's button with the shop on, at the price of the picked way to buy. */
+    readonly addToCart: (price: string) => string;
+    readonly viewCart: string;
+    /** The toast when the pick goes in the cart. */
+    readonly addedToCart: (p: HealthPlanFocusPrices, subscription: boolean) => string;
+    readonly removedFromCart: (productName: string) => string;
+    readonly cartTitle: string;
+    readonly cartEmptyTitle: string;
+    readonly cartEmptyBody: (p: HealthPlanFocusPrices) => string;
+    readonly seeOrders: string;
+    readonly quantityLabel: (productName: string) => string;
+    readonly fewer: string;
+    readonly more: string;
+    readonly remove: string;
+    /** Under a subscription line's price. */
+    readonly cartSubLine: (p: HealthPlanFocusPrices) => string;
+    /** Under a one-box line's price; `subscribed`: the pet's plan already ships this product. */
+    readonly cartOnceLine: (p: HealthPlanFocusPrices, subscribed: boolean) => string;
+    readonly cartModeLabel: (productName: string) => string;
+    readonly cartModeSubscribe: (p: HealthPlanFocusPrices) => string;
+    readonly cartModeOnce: (p: HealthPlanFocusPrices) => string;
+    readonly subtotal: string;
+    readonly shipping: string;
+    /** The shipping row's value; empty (the default) leaves the row out, as Everfur's checkout prices no shipping. */
+    readonly shippingValue: string;
+    /** A tag beside "Shipping" (a demo marks it "Illustrative"). Empty by default. */
+    readonly shippingTag: string;
+    readonly total: string;
+    readonly dueToday: string;
+    readonly thenRenews: (p: HealthPlanFocusPrices) => string;
+    readonly renewsEvery: (p: HealthPlanFocusPrices) => string;
+    readonly checkoutCart: (total: string) => string;
+    /**
+     * Under the cart's Checkout button when it cannot check out: the cart is off for this partner (the server answered
+     * `cart_disabled`), so Everfur's checkout takes one product, one box, per order. Also the toast when that answer
+     * comes. Empty by default (copy owed by design): the button is disabled either way, and the toast is the error's
+     * own line.
+     */
+    readonly cartOneAtATime: string;
+    /**
+     * In the cart checkout's fine print when the cart holds a subscription and other items: a subscription checks out
+     * on its own, so this checkout takes the other items and the subscription stays in the cart. Empty by default (copy
+     * owed by design).
+     */
+    readonly cartSubscriptionApart: string;
+    readonly cartItemSubscription: (p: HealthPlanFocusPrices) => string;
+    readonly cartItemQuantity: (quantity: number) => string;
+    readonly placeOrder: (total: string, subscribe: boolean) => string;
+    /** The cart checkout's fine print; `p` is the subscription line's, or null with none. */
+    readonly cartFine: (p: HealthPlanFocusPrices | null) => string;
+    readonly placedSteps: string;
+    readonly placedShips: string;
+    /** The order placed screen's last row, beside the expected delivery day (drawn only when the day is known). */
+    readonly placedArrives: string;
+    readonly viewOrder: string;
+    readonly herSubscription: string;
+    readonly nextBox: (day: string) => string;
+    readonly everyDays: (days: number) => string;
+    /** The orders list's heading, after the subscription card or alone. */
+    readonly ordersHeading: (afterSubscription: boolean) => string;
+    /** Under the orders list and an order (a demo says its dates are illustrative). Empty by default. */
+    readonly ordersFine: string;
+    readonly ordersEmptyTitle: string;
+    readonly ordersEmptyBody: (p: HealthPlanFocusPrices) => string;
+    /**
+     * The button under the orders list that reads the next page. Empty by default (copy owed by design): the next page
+     * then loads as the list's end scrolls into view, with no button.
+     */
+    readonly moreOrders: string;
+    /** The order steps, in order: ordered, shipped, out for delivery, delivered. */
+    readonly orderSteps: readonly [string, string, string, string];
+    readonly subscriptionBox: string;
+    readonly orderTitle: (number: string | null) => string;
+    readonly arrivesBy: (day: string) => string;
+    readonly deliveredOn: (day: string) => string;
+    readonly expected: (day: string) => string;
+    readonly tracking: string;
+    readonly trackingByText: string;
+    readonly trackOn: (carrier: string) => string;
+    /**
+     * The tracking link's label when the order has a tracking link but no carrier name. Empty by default (copy owed by
+     * design): the link is then not drawn.
+     */
+    readonly trackLink: string;
+    readonly inThisOrder: string;
+    readonly orderItemLine: (quantity: number, subscriptionBox: boolean) => string;
+    readonly paidWith: string;
+    readonly buyAgain: string;
+    readonly orderHelp: string;
+    readonly addWeightTitle: string;
+    readonly addWeightBody: string;
+    readonly connectRecordsTitle: string;
+    readonly connectRecordsBody: string;
+    readonly weightKicker: string;
+    readonly weightTitle: (p: HealthPlanFocusPrices) => string;
+    readonly weightBody: string;
+    readonly weightField: string;
+    readonly weightUnit: string;
+    /** The unit beside the field with `weightUnit: 'kg'`. */
+    readonly weightUnitKg: string;
+    readonly weightError: string;
+    /** The error for a weight in kilograms that does not read. */
+    readonly weightErrorKg: string;
+    readonly weightSave: string;
+    readonly weightSaved: (pounds: string) => string;
+    readonly weightSavedKg: (kilograms: string) => string;
+    /** A payment that failed or a checkout that expired: the cart opens again with its items and this line. */
+    readonly checkoutFailed: string;
+}
+/** The steps an order goes through, in order. */
+type HealthPlanOrderStatus = 'ordered' | 'shipped' | 'out_for_delivery' | 'delivered';
+/**
+ * An order from the partner's own shop (its kits, its tests), handed in by the host so the member's orders read as
+ * one list. Everything in it is the partner's: Everfur draws it and never changes it. Everfur's own orders (a box
+ * bought through its checkout) are read from Everfur and need nothing here.
+ */
+interface HealthPlanShopOrder {
+    /** Stable id; also the order number shown when `number` is absent and the host wants one. */
+    readonly key: string;
+    /** The partner's order number ("EMB-31907"). */
+    readonly number?: string;
+    readonly status: HealthPlanOrderStatus;
+    /** ISO dates per step, in `HealthPlanOrderStatus` order: a done step's date, or a later step's expected date. */
+    readonly dates?: readonly (string | null)[];
+    readonly items: readonly {
+        readonly title: string;
+        readonly quantity: number;
+        /** The line's total, in `currency`. */
+        readonly price: number;
+        readonly imageUrl?: string;
+        readonly icon?: HealthPlanFocusIcon;
+    }[];
+    readonly currency: string;
+    /** A subscription's box ("Subscription box" pill). */
+    readonly subscriptionBox?: boolean;
+    readonly carrier?: string;
+    readonly trackingNumber?: string;
+    /** A tag beside the tracking number (a demo marks it "Illustrative"). */
+    readonly trackingTag?: string;
+    /** Where "Track on {carrier}" goes; without it the button is not drawn. */
+    readonly trackingUrl?: string;
+}
+
+type HealthPlanSubscriptionStatus = 'active' | 'cancelled';
+/** One step still ahead on a subscription's schedule. The surface writes the words; these are the facts. */
+interface HealthPlanSubscriptionStep {
+    readonly step: 'first_box_ships' | 'checkin' | 'refill_reminder' | 'next_box_ships';
+    /** ISO `YYYY-MM-DD`, a UTC calendar date. */
+    readonly on: string;
+}
+interface HealthPlanSubscriptionRenewal {
+    readonly amount: number;
+    readonly currency: string;
+    readonly intervalDays: number;
+}
+interface HealthPlanSubscription {
+    readonly subscriptionId: string;
+    readonly productId: string;
+    readonly title: string | null;
+    readonly status: HealthPlanSubscriptionStatus;
+    readonly intervalDays: number;
+    readonly intervalOptions: readonly number[];
+    readonly currency: string;
+    readonly boxPrice: number;
+    /** The CURRENT run's first box. */
+    readonly firstBoxPrice: number;
+    readonly offerApplied: boolean;
+    /** ISO `YYYY-MM-DD`, or null when cancelled. */
+    readonly nextBoxDate: string | null;
+    readonly renewal: HealthPlanSubscriptionRenewal | null;
+    readonly timeline: readonly HealthPlanSubscriptionStep[];
+}
+interface HealthPlanSubscriptionSupply {
+    readonly unitsPerBox: number;
+    readonly unitLabel: string | null;
+    readonly unitsPerDay: number;
+    readonly supplyDays: number;
+    readonly doseBasis: 'weight' | 'assumed';
+}
+/** Buy once: one box, no renewal. `price` is the box price less the one-box discount (the server's figure). */
+interface HealthPlanOneBoxOffer {
+    readonly price: number;
+    readonly discountPercent: number;
+}
+/** Where a one-box order is on its way. Only the partner moves it; it may also move back to correct a mistake. */
+type HealthPlanOrderTrackingStatus = 'ordered' | 'shipped' | 'delivered';
+/**
+ * A one-box order's tracking, as the partner wrote it. Every field but `status` is null until the partner sends it,
+ * and a value that fails the server's own rules (control or bidi characters, a tracking url that is not plain https)
+ * reads as null here too.
+ */
+interface HealthPlanOrderTracking {
+    readonly status: HealthPlanOrderTrackingStatus;
+    readonly orderNumber: string | null;
+    readonly carrier: string | null;
+    readonly trackingNumber: string | null;
+    /** An `https://` url with no spaces and no `@`; open it in a new tab with `rel="noopener noreferrer"`. */
+    readonly trackingUrl: string | null;
+    /** ISO date-time. */
+    readonly shippedAt: string | null;
+    /** ISO `YYYY-MM-DD`, a calendar date. */
+    readonly estimatedDelivery: string | null;
+    /** The server time of the partner's last write (ISO date-time). */
+    readonly updatedAt: string | null;
+}
+/** One recorded one-box order. The partner charges and ships it; Everfur never charges. */
+interface HealthPlanOneBoxOrder {
+    readonly orderId: string;
+    readonly productId: string;
+    readonly title: string | null;
+    readonly currency: string;
+    readonly boxPrice: number;
+    /** The price of ONE box. */
+    readonly price: number;
+    readonly discountPercent: number;
+    /** ISO `YYYY-MM-DD`. */
+    readonly shipsOn: string | null;
+    /** When it was recorded (ISO date-time), from the orders list; absent from an older server. */
+    readonly createdAt?: string | null;
+    /** How many boxes (1..10). Absent from an older server, which means one. */
+    readonly quantity?: number;
+    /** `price` x `quantity`, the server's figure. Absent from an older server, which means `price`. */
+    readonly total?: number;
+    /** Absent from an older server, which knows only that the order was recorded. */
+    readonly tracking?: HealthPlanOrderTracking;
+}
+/** One page of a pet's one-box orders, newest first. */
+interface HealthPlanOneBoxOrderPage {
+    readonly orders: readonly HealthPlanOneBoxOrder[];
+    /** Pass it as `cursor` for the next page; null on the last page. */
+    readonly nextCursor: string | null;
+}
+interface HealthPlanOneBoxOrderPageOptions {
+    /** 1..50; default 50. */
+    readonly limit?: number;
+    /** The `nextCursor` of the previous page. */
+    readonly cursor?: string;
+}
+interface HealthPlanSubscriptionQuote {
+    readonly productId: string;
+    readonly currency: string;
+    readonly boxPrice: number;
+    readonly firstBoxPrice: number;
+    readonly firstBoxDiscountPercent: number;
+    readonly offerApplies: boolean;
+    /** Buy once. Null from a server older than contract v2: the surface then hands a one-time buy to the partner. */
+    readonly oneBox: HealthPlanOneBoxOffer | null;
+    readonly intervalOptions: readonly number[];
+    readonly defaultIntervalDays: number;
+    readonly supply: HealthPlanSubscriptionSupply | null;
+    readonly firstBoxShipsOn: string | null;
+    /** The member's existing active or cancelled row for this pet and product, or null. */
+    readonly subscription: HealthPlanSubscription | null;
+}
+interface HealthPlanSubscriptionRepository {
+    quote(petRef: PetRef, productId: string): Promise<EverfurResult<HealthPlanSubscriptionQuote>>;
+    list(petRef: PetRef): Promise<EverfurResult<readonly HealthPlanSubscription[]>>;
+    create(petRef: PetRef, productId: string, intervalDays?: number): Promise<EverfurResult<HealthPlanSubscription>>;
+    changeInterval(petRef: PetRef, subscriptionId: string, intervalDays: number): Promise<EverfurResult<HealthPlanSubscription>>;
+    skip(petRef: PetRef, subscriptionId: string): Promise<EverfurResult<HealthPlanSubscription>>;
+    cancel(petRef: PetRef, subscriptionId: string): Promise<EverfurResult<HealthPlanSubscription>>;
+    restart(petRef: PetRef, subscriptionId: string, intervalDays?: number): Promise<EverfurResult<HealthPlanSubscription>>;
+    /**
+     * Buy one box. `tapKey` names the member's one confirm tap: pass the same value on a retry of that tap and the
+     * server answers with the same order instead of recording a second one. Omitted, each call is a new order.
+     */
+    buyOneBox(petRef: PetRef, productId: string, tapKey?: string): Promise<EverfurResult<HealthPlanOneBoxOrder>>;
+    /** The pet's one-box orders, newest first. Optional so a host's own repository keeps compiling; absent, no orders list. */
+    listOneBoxOrders?(petRef: PetRef): Promise<EverfurResult<readonly HealthPlanOneBoxOrder[]>>;
+    /**
+     * One page of the pet's one-box orders, newest first. Optional like `listOneBoxOrders`; absent, the surface reads
+     * that one list instead. A cursor that is no longer this pet's answers `reasonCode` `invalid_cursor` (422): start
+     * again without one.
+     */
+    listOneBoxOrderPage?(petRef: PetRef, opts?: HealthPlanOneBoxOrderPageOptions): Promise<EverfurResult<HealthPlanOneBoxOrderPage>>;
+}
+/** A 404 on a subscription route: the switch is off, or the product is not subscribable. */
+declare function isHealthPlanSubscriptionUnavailable(error: EverfurError | null | undefined): boolean;
+/** The allowlist mapper for one Subscription body; null when a required fact is missing. */
+declare function healthPlanSubscriptionFromWire(raw: unknown): HealthPlanSubscription | null;
+/** The allowlist mapper for one OneBoxOrder body; null when a required fact is missing. */
+declare function healthPlanOneBoxOrderFromWire(raw: unknown): HealthPlanOneBoxOrder | null;
+/**
+ * The allowlist mapper for an order's `tracking` (always sent by a current server); null when absent or not an
+ * object (an older server). An unknown status reads as `ordered`, the one step every order has.
+ */
+declare function healthPlanOrderTrackingFromWire(raw: unknown): HealthPlanOrderTracking | null;
+/** The allowlist mapper for one page of the orders list; null when `orders` is not a list. */
+declare function healthPlanOneBoxOrderPageFromWire(raw: unknown): HealthPlanOneBoxOrderPage | null;
+/** The allowlist mapper for one quote body; null when a required fact is missing. */
+declare function healthPlanSubscriptionQuoteFromWire(raw: unknown): HealthPlanSubscriptionQuote | null;
+/** The repository over one auth context (or an injected funnel). */
+declare function createHealthPlanSubscriptionRepositoryOver(deps: HealthPlanRepositoryDeps): Required<HealthPlanSubscriptionRepository>;
+/** The repository over the runtime under your provider. Auth is read at CALL time; a disposed runtime sends nothing. */
+declare function createHealthPlanSubscriptionRepository(runtime: HealthPlanRuntime): Required<HealthPlanSubscriptionRepository>;
+
+/** Whose checkout runs Buy and Subscribe: Everfur's Stripe Checkout, or the partner's own (today's handoff). */
+type HealthPlanCheckoutProvider = 'everfur_stripe' | 'partner';
+type HealthPlanPurchase = 'one_box' | 'subscription';
+type HealthPlanCheckoutStatus = 'pending' | 'paid' | 'expired' | 'failed';
+/** The pet facts the page was built from. */
+interface HealthPlanPagePet {
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly sex: 'female' | 'male' | null;
+    readonly breed: string | null;
+    readonly weightKg: number | null;
+    readonly weightLb: number | null;
+}
+interface HealthPlanPage {
+    readonly petRef: PetRef;
+    readonly pet: HealthPlanPagePet;
+    readonly checkout: HealthPlanCheckoutProvider;
+    /** The focus layout's content, or null when the plan has no items for this pet. */
+    readonly page: HealthPlanFocusDesign | null;
+    /**
+     * True only when the page draws a condition template the Medical Director reviewed (`vet_reviewed`). The focus
+     * layout draws the vet byline only then. Absent: false.
+     */
+    readonly vetReviewed?: boolean;
+    /**
+     * True only when Everfur texts the member the tracking number once the partner sets it (`tracking_texts_enabled`).
+     * The "tracking comes by text" lines are drawn only then. Absent: false.
+     */
+    readonly trackingTextsEnabled?: boolean;
+}
+interface HealthPlanCheckoutRequest {
+    readonly productId: string;
+    readonly purchase: HealthPlanPurchase;
+    /** Subscriptions only: one of the quote's interval options. */
+    readonly intervalDays?: number;
+    /** Where Stripe sends the member back after paying, and after backing out. Absolute http(s). */
+    readonly successUrl: string;
+    readonly cancelUrl: string;
+}
+/** One cart line for the cart checkout. Each product at most once; a subscription line is quantity 1 and alone. */
+interface HealthPlanCheckoutItem {
+    readonly productId: string;
+    readonly purchase: HealthPlanPurchase;
+    /** Subscriptions only. */
+    readonly intervalDays?: number;
+    /** 1..10, default 1. */
+    readonly quantity?: number;
+}
+/** The cart checkout: 1..10 lines in one Stripe Checkout. */
+interface HealthPlanCartCheckoutRequest {
+    readonly items: readonly HealthPlanCheckoutItem[];
+    readonly successUrl: string;
+    readonly cancelUrl: string;
+}
+/**
+ * Why the server refused a checkout start, when it said so (a 409's `detail`): `cart_disabled` (the cart switch is
+ * off for this tenant: buy one product at a time), `cart_has_subscription` (check the subscription out on its own),
+ * or the older refusals.
+ */
+type HealthPlanCheckoutRefusal = 'cart_disabled' | 'cart_has_subscription' | 'cart_currency_mixed' | 'sample_product' | 'partner_endpoint_missing' | 'checkout_pending' | 'already_subscribed';
+/**
+ * The refusal a checkout start's 409 named, or null. The route answers `{"detail": "<token>"}`, which reaches the SDK
+ * as the error's server message (or its `reasonCode`); only the tokens above are recognised, so free text never is.
+ */
+declare function healthPlanCheckoutRefusal(error: EverfurError | null | undefined): HealthPlanCheckoutRefusal | null;
+interface HealthPlanCheckoutSession {
+    readonly checkoutId: string;
+    /** The Stripe Checkout page to send the member to (https). */
+    readonly url: string;
+}
+interface HealthPlanCheckoutState {
+    readonly status: HealthPlanCheckoutStatus;
+    readonly purchase: HealthPlanPurchase;
+    /** The first one-box order, once the server has one (`orders[0]`). */
+    readonly order: HealthPlanOneBoxOrder | null;
+    /** Every one-box order the checkout made, in cart line order; empty until paid (and from an older server). */
+    readonly orders: readonly HealthPlanOneBoxOrder[];
+    /** The subscription, once the server has one. */
+    readonly subscription: HealthPlanSubscription | null;
+}
+interface HealthPlanPageRepository {
+    /** `GET .../plan/page`. Settles; never throws. */
+    getPage(petRef: PetRef, opts?: {
+        readonly signal?: AbortSignal;
+    }): Promise<EverfurResult<HealthPlanPage>>;
+    /**
+     * `POST .../plan/checkout`. `idempotencyKey` names the member's one tap: the same value on a retry answers with the
+     * same session.
+     */
+    startCheckout(petRef: PetRef, body: HealthPlanCheckoutRequest, idempotencyKey: string): Promise<EverfurResult<HealthPlanCheckoutSession>>;
+    /**
+     * `POST .../plan/checkout` in the cart form (`items`). Optional so a host's own repository keeps compiling; absent,
+     * the surface checks out one product at a time. A refusal names its reason through `healthPlanCheckoutRefusal`.
+     */
+    startCartCheckout?(petRef: PetRef, body: HealthPlanCartCheckoutRequest, idempotencyKey: string): Promise<EverfurResult<HealthPlanCheckoutSession>>;
+    /** `GET .../plan/checkout/{checkout_id}`. */
+    getCheckout(petRef: PetRef, checkoutId: string): Promise<EverfurResult<HealthPlanCheckoutState>>;
+}
+/**
+ * The allowlist mapper for one plan page (`page` of the page route). Null when the page has no title or no pick:
+ * the layout cannot be drawn without them. The SDK's buying words (`copy`) are never read from the wire.
+ */
+declare function healthPlanFocusDesignFromWire(raw: unknown): HealthPlanFocusDesign | null;
+/** The allowlist mapper for one page-route body. Null when it is not a page answer (no `page` key at all). */
+declare function healthPlanPageFromWire(raw: unknown, petRef: PetRef): HealthPlanPage | null;
+/** The allowlist mapper for one checkout-start body; null without an id or an https url. */
+declare function healthPlanCheckoutSessionFromWire(raw: unknown): HealthPlanCheckoutSession | null;
+/** The allowlist mapper for one checkout-status body; null without a known status and purchase. */
+declare function healthPlanCheckoutStateFromWire(raw: unknown): HealthPlanCheckoutState | null;
+/** The repository over one auth context (or an injected funnel). */
+declare function createHealthPlanPageRepositoryOver(deps: HealthPlanRepositoryDeps): HealthPlanPageRepository;
+/** The repository over the runtime under your provider. Auth is read at CALL time; a disposed runtime sends nothing. */
+declare function createHealthPlanPageRepository(runtime: HealthPlanRuntime): HealthPlanPageRepository;
+
+/** What a docked bar needs, as the plan page last published it. */
+interface HealthPlanCartDock {
+    /** The member's cart: the items in the plan, their count and subtotal. */
+    readonly cart: HealthPlanCart;
+    /** True while an add or remove is in flight (draw the checkout control disabled). */
+    readonly busy: boolean;
+    /** The pet whose plan the page shows, or null. */
+    readonly petRef: PetRef | null;
+    /** The plan the page shows, or null before it loads. */
+    readonly plan: HealthPlan | null;
+    /** Adds (`true`) or removes (`false`) one product, as the page's own control does. Resolves true when it took. */
+    readonly setInPlan: (productId: string, inPlan: boolean) => Promise<boolean>;
+    /** Adds every product not yet in the plan. Resolves true when every add took. */
+    readonly addAll: () => Promise<boolean>;
+}
+interface HealthPlanCartScopeProps {
+    readonly children?: ReactNode;
+}
+/** The scope a plan page with `cartBarPlacement: 'none'` publishes its cart to. Wrap the page and your bar in it. */
+declare function HealthPlanCartScope({ children }: HealthPlanCartScopeProps): ReactNode;
+/** The cart the plan page in the nearest `HealthPlanCartScope` published, or null (no scope, or no page yet). */
+declare function useHealthPlanCartDock(): HealthPlanCartDock | null;
+
+declare const HEALTH_PLAN_COPY: Readonly<{
+    loading: "Loading";
+    retry: "Try again";
+    signedOut: "Sign in required";
+    addToCart: "Add to cart";
+    added: "Added";
+    remove: "Remove";
+    checkout: "Checkout";
+    subtotal: "Subtotal";
+    sample: "Sample";
+    cartEmpty: "Your cart is empty.";
+    choosePet: "Choose a pet";
+    emptyTitle: "";
+    emptyBody: "";
+    emptyAsk: "";
+}>;
+/** The Health Plan's empty state words (Q1). Each is '' by default: an empty title and body draw nothing. */
+interface HealthPlanEmptyCopy {
+    readonly emptyTitle: string;
+    readonly emptyBody: string;
+    /** The empty state's Ask button. */
+    readonly emptyAsk: string;
+}
+/**
+ * The reason labels, one per kind. An empty label is not drawn (the reason's text still is). `profile` (a pet profile
+ * fact) has no source yet; `dna` names one partner's product, so the SDK leaves it to that partner (Q3).
+ */
+declare const HEALTH_PLAN_REASON_LABELS: Readonly<Record<HealthPlanReasonKind, string>>;
+/** ADAPTED from Raph. Listed for approval. */
+declare const HEALTH_PLAN_TEMPLATES: Readonly<{
+    /** Raph: "Georgia's care plan". Used only when the plan carries no `headline` of the tenant's own. */
+    planTitle: (petName: string) => string;
+    /** Raph: "<brand> cart" (his demo named the partner). */
+    cartLabel: (brand: string) => string;
+}>;
+/** Every key still waiting on Raph's words (empty, so not drawn), so the list a reviewer approves cannot drift from the file. */
+declare const HEALTH_PLAN_COPY_PLACEHOLDERS: readonly string[];
+
+type HealthPlanPagePhase = 'idle' | 'loading' | 'failed' | 'ready';
+interface HealthPlanPageOptions {
+    readonly petRef: PetRef | null;
+    /** False skips the read. Defaults to true. */
+    readonly enabled?: boolean;
+    /** A repository of your own (tests, a stub backend). Defaults to the one over the provider's runtime. */
+    readonly repository?: HealthPlanPageRepository;
+    /** Coming back to the foreground re-reads a page shown for more than a minute, quietly. Absent, it does not. */
+    readonly lifecycle?: LifecyclePort | null;
+    /** Change it to re-read the page now, quietly. */
+    readonly refreshKey?: string | number;
+}
+interface HealthPlanPageState {
+    readonly phase: HealthPlanPagePhase;
+    /** The answer for `petRef`, or null until it lands. */
+    readonly page: HealthPlanPage | null;
+    readonly error: EverfurError | null;
+    /** True when the read answered not found: this pet has no plan page. `phase` is then `ready` and `page` null. */
+    readonly missing: boolean;
+    refresh(): Promise<void>;
+}
+/** The plan page repository bound to the runtime under your provider. */
+declare function useHealthPlanPageRepository(): HealthPlanPageRepository;
+/** One pet's Health Plan page. Re-read when the pet changes. */
+declare function useHealthPlanPage(options: HealthPlanPageOptions): HealthPlanPageState;
+
+type HealthPlanPhase = 'idle' | 'loading' | 'failed' | 'ready';
+interface HealthPlanSnapshot {
+    readonly phase: HealthPlanPhase;
+    readonly petRef: PetRef | null;
+    readonly plan: HealthPlan | null;
+    /** Product ids whose add or remove is in flight. */
+    readonly pending: readonly string[];
+    /** The last refused write per product id. */
+    readonly itemErrors: Readonly<Record<string, EverfurError>>;
+    /** The refused read, or null. */
+    readonly error: EverfurError | null;
+}
+declare class HealthPlanController {
+    private readonly repository;
+    private snapshot;
+    private readonly listeners;
+    private generation;
+    /** Bumped by every add or remove, so a quiet re-read that started before one never overwrites it. */
+    private writes;
+    /** Bumped by every quiet re-read, so an older one that settles after a newer one never overwrites it. */
+    private revalidations;
+    /** A host refresh asked for while a write was in flight: the quiet re-read runs once the last write settles. */
+    private refreshAfterWrites;
+    private disposed;
+    constructor(repository: HealthPlanRepository);
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getSnapshot: () => HealthPlanSnapshot;
+    private set;
+    /** Read the plan for `petRef` (null clears to `idle`). A different pet drops the old plan before the read lands. */
+    load(petRef: PetRef | null): Promise<void>;
+    /**
+     * Re-read the shown plan WITHOUT a loading state (a member coming back to a page that sat open, a host's
+     * `refreshKey`). Only from `ready` with nothing in flight; the answer replaces the plan only while the same pet is
+     * shown and no add, remove or full read happened meanwhile. A refused re-read keeps the plan on screen.
+     */
+    revalidate(): Promise<void>;
+    /**
+     * The host says the plan changed (its `refreshKey`), so the request is never dropped: from `ready` a quiet
+     * re-read, held until the last add or remove in flight settles; from `failed` or `loading` a full read for the
+     * shown pet (there is no plan to keep on screen, and a read in flight may predate the change).
+     */
+    refresh(): Promise<void>;
+    private settleWrite;
+    /** Put an item in the plan (`true`) or take it out (`false`). Settles true when the server accepted it. */
+    setInPlan(productId: string, inPlan: boolean): Promise<boolean>;
+    dispose(): void;
+}
+
+/** A named element of the focus layout. Pass a class for it in `classNames` and its inline default is dropped. */
+type HealthPlanFocusPart = 'root' | 'head' | 'eyebrow' | 'serif' | 'headImage' | 'by' | 'byOk' | 'need' | 'needKicker' | 'sources' | 'source' | 'needRisk' | 'dot' | 'odds' | 'oddsKicker' | 'oddsNumbers' | 'tag' | 'says' | 'saysKicker' | 'jump' | 'jumpGo' | 'steps' | 'stepsHead' | 'n' | 'list' | 'tip' | 'tipN' | 'tipTop' | 'section' | 'sectionTitle' | 'pick' | 'others' | 'other' | 'otherCategory' | 'pickTop' | 'pickImage' | 'stars' | 'pickLine' | 'reviews' | 'review' | 'reviewStars' | 'score' | 'why' | 'mini' | 'chip' | 'dose' | 'ingredients' | 'opts' | 'opt' | 'optText' | 'optTag' | 'price' | 'optPrice' | 'buy' | 'button' | 'proof' | 'trust' | 'on' | 'onIcon' | 'more' | 'fine' | 'sign' | 'questionsKicker' | 'questions' | 'add' | 'extras' | 'extrasTitle' | 'extra' | 'extraIcon' | 'extraTitle' | 'extraPrice' | 'extraGo' | 'pageFine' | 'stateOn' | 'scrim' | 'sheet' | 'sheetGrab' | 'sheetTop' | 'sheetKicker' | 'sheetClose' | 'srOnly' | 'co' | 'coProd' | 'coProdImage' | 'coProdTitle' | 'coOpts' | 'coOpt' | 'coHit' | 'radio' | 'coPrice' | 'coWhen' | 'coKey' | 'coEvery' | 'coRows' | 'buttonLarge' | 'buttonGhost' | 'coFine' | 'mgCancel' | 'started' | 'startedScroll' | 'done' | 'doneCheck' | 'doneTitle' | 'doneWhen' | 'doneWho' | 'next' | 'nextIcon' | 'foot' | 'toast' | 'tools' | 'toolsEnd' | 'ordersButton' | 'cartButton' | 'cartCount' | 'askRow' | 'askRowIcon' | 'wait' | 'waitTop' | 'waitTile' | 'waitKey' | 'waitText' | 'track' | 'trackDot' | 'push' | 'shop' | 'shopTitle' | 'shopSub' | 'shopKey' | 'shopCard' | 'shopItems' | 'shopItem' | 'shopItemImage' | 'shopItemPrice' | 'shopItemActions' | 'stepper' | 'shopRemove' | 'shopMode' | 'summary' | 'shopFine' | 'shopEmpty' | 'shopTile' | 'shopLink' | 'shopActions' | 'subCard' | 'orderList' | 'order' | 'orderTop' | 'orderPill' | 'orderNo' | 'orderWhat' | 'orderMeta' | 'orderPics' | 'carrier' | 'carrierIcon' | 'carrierWait' | 'buttonSmall' | 'coItems' | 'weightField' | 'weightInput' | 'weightUnit' | 'weightError' | 'weightActions' | 'summaryRow' | 'trackStep' | 'shopTag' | 'sheetBody';
+/**
+ * Classes per part. A key `part:kind` adds a modifier class for one kind of a part (`sign:urgent`, `chip:rec`,
+ * `source:dna`, `dot:risk`, `opt:once`, `extra:kit`); the kinds come from the design rows.
+ */
+type HealthPlanFocusClassNames = Readonly<Partial<Record<HealthPlanFocusPart, string>>> & Readonly<Record<string, string | undefined>>;
+
+/**
+ * The words for the pet in the buying copy: "her" for a female, "his" for a male, else the pet's name ("Georgia's"),
+ * else "your pet" (the SDK's existing fallback, CHAT_COPY.emptyTitlePetFallback).
+ */
+interface HealthPlanPetWords {
+    /** The name mid-sentence: "Georgia", else "your pet". */
+    readonly name: string;
+    /** The name at a sentence's start: "Georgia", else "Your pet". */
+    readonly Name: string;
+    /** "her", "his", "Georgia's", "your pet's". */
+    readonly poss: string;
+    /** The same at a sentence's start. */
+    readonly Poss: string;
+    /** "her", "him", "Georgia", "your pet". */
+    readonly obj: string;
+}
+/** The pet's words from the plan page's `name` and `sex`. Pure. */
+declare function healthPlanPetWords(name: string | null | undefined, sex: 'female' | 'male' | null | undefined): HealthPlanPetWords;
+/**
+ * The buying words for one pet: Raph's (the v3 design of 2026-10-16 and round 5 of 2026-10-20) with "her" taken
+ * from the pet (`healthPlanPetWords`). The prices' `petName`, when set, names the pet in the lines that use its name.
+ */
+declare function healthPlanFocusCopyFor(pet: {
+    readonly name?: string | null;
+    readonly sex?: 'female' | 'male' | null;
+}): HealthPlanFocusCopy;
+/** The buying words for a female pet: Raph's own, word for word. `EverfurHealthPlan` builds them from the pet's sex. */
+declare const HEALTH_PLAN_FOCUS_COPY: HealthPlanFocusCopy;
+/** A UTC calendar date (`2026-10-30`) as a short day (`Oct 30`). */
+declare function formatHealthPlanDay(iso: string | null, locale?: string): string | null;
+
+export { type HealthPlanOneBoxOffer as $, type HealthPlanAddedVariant as A, type HealthPlanCardShadow as B, type HealthPlanCartBarPlacement as C, type HealthPlanCartBarVisibility as D, type EverfurHealthPlanOptions as E, type HealthPlanCartCheckoutRequest as F, type HealthPlanCartDock as G, type HealthPlanFocusCopy as H, HealthPlanCartScope as I, type HealthPlanCartScopeProps as J, type HealthPlanCategoryVariant as K, type HealthPlanCheckoutItem as L, type HealthPlanCheckoutRefusal as M, type HealthPlanCheckoutRequest as N, type HealthPlanCheckoutSession as O, type HealthPlanCheckoutState as P, type HealthPlanCheckoutStatus as Q, HealthPlanController as R, type HealthPlanFocusExtra as S, type HealthPlanFocusPrices as T, type HealthPlanFocusReasonRow as U, type HealthPlanFocusReview as V, type HealthPlanFocusSign as W, type HealthPlanFocusStep as X, type HealthPlanFocusWait as Y, type HealthPlanFontWeight as Z, type HealthPlanHeaderContext as _, type HealthPlanFocusIcon as a, type HealthPlanOneBoxOrderPage as a0, type HealthPlanOneBoxOrderPageOptions as a1, type HealthPlanOrderStatus as a2, type HealthPlanOrderTracking as a3, type HealthPlanOrderTrackingStatus as a4, type HealthPlanPage as a5, type HealthPlanPageContext as a6, type HealthPlanPageOptions as a7, type HealthPlanPagePet as a8, type HealthPlanPagePhase as a9, healthPlanCheckoutStateFromWire as aA, healthPlanFocusDesignFromWire as aB, healthPlanFromWire as aC, healthPlanPageFromWire as aD, isHealthPlanSessionRequired as aE, showHealthPlanCartBar as aF, useEverfurHealthPlan as aG, useEverfurHealthPlanRepository as aH, useHealthPlanCartDock as aI, useHealthPlanPage as aJ, useHealthPlanPageRepository as aK, type HealthPlanFocusClassNames as aL, type HealthPlanEmptyCopy as aM, type HealthPlanFocusPart as aN, type HealthPlanPetWords as aO, createHealthPlanSubscriptionRepository as aP, createHealthPlanSubscriptionRepositoryOver as aQ, healthPlanFocusCopyFor as aR, healthPlanOneBoxOrderFromWire as aS, healthPlanOneBoxOrderPageFromWire as aT, healthPlanOrderTrackingFromWire as aU, healthPlanPetWords as aV, healthPlanSubscriptionFromWire as aW, healthPlanSubscriptionQuoteFromWire as aX, isHealthPlanSubscriptionUnavailable as aY, type HealthPlanPageState as aa, type HealthPlanPhase as ab, type HealthPlanPurchase as ac, type HealthPlanReason as ad, type HealthPlanReasonKind as ae, type HealthPlanRepository as af, type HealthPlanRepositoryDeps as ag, type HealthPlanRuntime as ah, type HealthPlanShadow as ai, type HealthPlanSnapshot as aj, type HealthPlanSubscriptionQuote as ak, type HealthPlanSubscriptionRenewal as al, type HealthPlanSubscriptionStatus as am, type HealthPlanSubscriptionStep as an, type HealthPlanSubscriptionSupply as ao, type HealthPlanTrackStep as ap, createHealthPlanPageRepository as aq, createHealthPlanPageRepositoryOver as ar, createHealthPlanRepository as as, createHealthPlanRepositoryOver as at, formatHealthPlanDay as au, formatHealthPlanPrice as av, formatHealthPlanPriceWith as aw, healthPlanCart as ax, healthPlanCheckoutRefusal as ay, healthPlanCheckoutSessionFromWire as az, type HealthPlanFocusDesign as b, type HealthPlanItem as c, type HealthPlanSubscription as d, type HealthPlanOneBoxOrder as e, type HealthPlanSubscriptionRepository as f, type HealthPlanPageRepository as g, type HealthPlanShopOrder as h, type HealthPlanCheckoutProvider as i, type HealthPlanPriceFormat as j, type HealthPlanLayoutProps as k, type HealthPlanCardOptions as l, type HealthPlanImageVariant as m, type HealthPlanReasonVariant as n, type HealthPlanCart as o, type EverfurHealthPlanState as p, type EverfurHealthPlanStatus as q, HEALTH_PLAN_COPY as r, HEALTH_PLAN_COPY_PLACEHOLDERS as s, HEALTH_PLAN_FOCUS_COPY as t, HEALTH_PLAN_LAYOUT_DEFAULTS as u, HEALTH_PLAN_REASON_KINDS as v, HEALTH_PLAN_REASON_LABELS as w, HEALTH_PLAN_TEMPLATES as x, type HealthPlan as y, type HealthPlanAddButtonSize as z };