@everfur/sdk 0.13.0 → 0.15.0

package/dist/{focus.d-az9cqUz3.d.cts → focus.d-Dsm39DjO.d.cts}

@@ -1,10 +1,8 @@
-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 { P as PetRef, U as UserRef } from './ids.d-B2GAAifq.cjs';
+import { R as RequestFunnel } from './requestFunnel.d-CR4akGCY.cjs';
+import { A as AuthContext } from './identity.d-CioQhZrq.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). */
@@ -83,209 +81,6 @@ declare function createHealthPlanRepository(runtime: HealthPlanRuntime): HealthP
 /** 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. */
@@ -298,6 +93,12 @@ interface HealthPlanFocusStep {
     readonly tone?: 'y' | 'c' | 'g' | 'r';
     /** The icon beside the tip's number. */
     readonly icon?: HealthPlanFocusIcon;
+    /**
+     * The vet's own tip: its source line names the vet from the page's one vet setting (`byline.shortName`, "From
+     * {shortName}") in place of `source`, and is not drawn when the setting has no short name. A vet's name is never
+     * typed into a tip.
+     */
+    readonly fromVet?: boolean;
 }
 /** One review of the product, word for word from the partner's store. */
 interface HealthPlanFocusReview {
@@ -323,7 +124,11 @@ interface HealthPlanFocusExtra {
     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. */
+    /**
+     * The button's words before ("Add a kit") and after ("Added to cart") it is pressed. An offer that is a plan item
+     * (`productId`) reads `copy.viewCart` once in the cart, so the backend may leave `added` out; the SDK then keeps
+     * `action` here.
+     */
     readonly action: string;
     readonly added: string;
     /**
@@ -331,6 +136,8 @@ interface HealthPlanFocusExtra {
      * 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;
+    /** True when the member already ordered it: an item she owns is not offered again (Raph round 5, step 3). */
+    readonly owned?: boolean;
 }
 /** 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 {
@@ -354,10 +161,15 @@ interface HealthPlanFocusWait {
     readonly track?: readonly HealthPlanTrackStep[];
     /** The heading over the rows ("What her plan will hold"). */
     readonly heading?: string;
+    /**
+     * A row with `fromVet` names the vet from the page's one vet setting ("Free tips from {byline.name}, built around
+     * that risk") in place of `text`, and is not drawn without a byline.
+     */
     readonly rows?: readonly {
         readonly icon: HealthPlanFocusIcon;
         readonly label: string;
         readonly text: string;
+        readonly fromVet?: boolean;
     }[];
     /** The line with the chat icon under the rows ("We'll text you when it's ready."). */
     readonly note?: string;
@@ -377,6 +189,11 @@ interface HealthPlanFocusSign {
     readonly body: string;
     /** An emergency sign: drawn with the alert icon and the `sign:urgent` modifier. */
     readonly urgent?: boolean;
+    /**
+     * The sign that sends her to her vet ("Call her vet today"). Its title follows what the SDK knows of her vet: with
+     * her vet records, `title`; without them, `copy.callYourVet`; with no vet yet, `copy.callAVet` (Raph round 5).
+     */
+    readonly callVet?: boolean;
 }
 /**
  * Everything the focus layout says about the pet. Every string is the host's (or the backend page's), drawn verbatim.
@@ -386,12 +203,23 @@ interface HealthPlanFocusDesign {
     readonly eyebrow?: string;
     readonly title: string;
     readonly subtitle?: string;
+    /** The line under the title in place of `subtitle` while her vet records are missing (`recordsMissing`). */
+    readonly subtitleNoRecords?: string;
     /** https or a same-origin path; the pet's photo beside the title. */
     readonly headImageUrl?: string;
+    /**
+     * THE VET, ONE SETTING (Raph round 5, `VET`). Every vet mention on the page reads it: the byline ("Built with
+     * {name}"), the vet's note (photo and short name), the vet's tips (`fromVet`, "From {shortName}") and the waiting
+     * card's tips row. Absent, every vet mention hides. On Everfur's plan page it is drawn only when the page is vet
+     * reviewed (Q2). `name` is the vet's own full name, as the vet is credited: the SDK says "Built with" itself. `role`
+     * is the line under it (credentials and title). `shortName` is the short form the vet goes by on the page; absent,
+     * the short-form mentions hide (the SDK never derives one from `name`).
+     */
     readonly byline?: {
         readonly name: string;
         readonly role?: string;
         readonly imageUrl?: string;
+        readonly shortName?: string;
     };
     readonly focus?: {
         readonly kicker: string;
@@ -413,11 +241,16 @@ interface HealthPlanFocusDesign {
             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. */
+        /**
+         * The vet's note. Drawn only with a `byline` (the vet, one setting): the vet's photo and short name come from the
+         * byline, never from here. `kicker` and `imageUrl` are kept for older hosts and no longer drawn.
+         */
         readonly quote?: {
-            readonly kicker: string;
+            /** @deprecated Not drawn: the note names the vet from `byline.shortName`. */
+            readonly kicker?: string;
             readonly tag?: string;
             readonly text: string;
+            /** @deprecated Not drawn: the note's photo is `byline.imageUrl`. */
             readonly imageUrl?: string;
         };
         /** The strip that jumps to the product. Its kicker is `copy.jumpKicker`. */
@@ -434,6 +267,17 @@ interface HealthPlanFocusDesign {
     };
     readonly pick: {
         readonly title: string;
+        /**
+         * True when no product fits her risk (Raph round 5, step 2 "No"): part 2 and the jump strip are not drawn, and
+         * `copy.noPick` takes their place ("No supplement for this one. Her vet comes first."). The rest of `pick` is not
+         * read. The page's plan item, if any, is not offered.
+         */
+        readonly none?: boolean;
+        /**
+         * True when the page has no product part at all (the everyday plan, the waiting screen, a pet whose risk is not
+         * known yet): with `none`, not even `copy.noPick` is drawn, and the plan's other items are not listed.
+         */
+        readonly hidden?: boolean;
         /**
          * 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.
@@ -454,7 +298,11 @@ interface HealthPlanFocusDesign {
         };
         /** 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"). */
+        /**
+         * Why it fits, one row per real signal. With `score`, the count line under them is drawn, counted from the rows
+         * (`copy.signalsFit`, "2 of 2 signals fit Georgia", "2/2"), never from `score`'s own words, and hidden with fewer
+         * than two rows (Raph round 5, step 3).
+         */
         readonly why?: {
             readonly title: string;
             readonly rows: readonly HealthPlanFocusReasonRow[];
@@ -463,14 +311,25 @@ interface HealthPlanFocusDesign {
                 readonly value: string;
             };
         };
+        /**
+         * Sized for her. A stat's `kind` names what it is; the daily dose (`dose`, "1" "chew a day") also fills the three
+         * blanks' dose row. With no stat marked `dose`, the first stat is the daily dose (Everfur's plan page sends the
+         * daily dose first, then the days a box).
+         */
         readonly dose?: {
             readonly title: string;
             readonly stats: readonly {
                 readonly value: string;
                 readonly label: string;
+                readonly kind?: 'weight' | 'dose' | 'days';
             }[];
             readonly note?: string;
         };
+        /**
+         * The daily dose's unit ("chew a day") when her weight is not known yet, so `dose` is not sized. The three blanks
+         * keep their dose row with this label and an empty blank until her records give a weight.
+         */
+        readonly doseLabel?: string;
         readonly ingredients?: {
             readonly label?: string;
             readonly items: readonly string[];
@@ -498,7 +357,12 @@ interface HealthPlanFocusDesign {
         readonly add: string;
         readonly added: string;
     };
-    /** The partner's other offers, last ("More from <your brand>"). Drawn only with `onExtra`. */
+    /**
+     * The partner's other offers, last ("More from <your brand>"). An offer with a `productId` that is one of the plan's
+     * items is drawn whenever the surface can sell it (the shop on, or the one-box checkout); any other offer only with
+     * `onExtra`. When any offer names a `productId`, the plan's other items are not listed under the pick: these
+     * offers are the partner's own list of them.
+     */
     readonly extras?: {
         readonly title: string;
         readonly items: readonly HealthPlanFocusExtra[];
@@ -699,6 +563,54 @@ interface HealthPlanFocusCopy {
     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 byline's title: "Built with {vet}". */
+    readonly builtWith: (vet: string) => string;
+    /** A vet's tip's source line (`fromVet`): "From {shortName}". */
+    readonly fromVet: (shortName: string) => string;
+    /** The waiting card's tips row (`fromVet`): "Free tips from {vet}, built around that risk". */
+    readonly waitVetTips: (vet: string) => string;
+    /** The score line under why it fits, counted from the rows: "2 of 2 signals fit Georgia". */
+    readonly signalsFit: (count: number) => string;
+    /** The score's short form beside it: "2/2". */
+    readonly signalsValue: (count: number) => string;
+    /** In place of part 2 and the jump strip when no product fits (`pick.none`). */
+    readonly noPick: string;
+    /** The vet sign's title (`HealthPlanFocusSign.callVet`) without her vet records: "Call your vet today". */
+    readonly callYourVet: string;
+    /** The vet sign's title when she has no vet yet: "Call a vet today". */
+    readonly callAVet: string;
+    /** The checkup button without her vet records or without a vet: "Save for her next checkup". */
+    readonly saveForCheckup: string;
+    /** The same button once pressed: "Saved for her next checkup". */
+    readonly savedForCheckup: string;
+    /** The card's accessible name ("Her three blanks"). */
+    readonly blanksLabel: string;
+    /** The waiting card's kicker: "Asked {clinic}". */
+    readonly blanksAsked: (clinic: string) => string;
+    /** The waiting card's kicker when the request names no clinic. Empty by default (copy owed by design): no kicker. */
+    readonly blanksAskedNoClinic: string;
+    /** The waiting card's pill: "2 to 5 days". */
+    readonly blanksWaitPill: string;
+    /** The filled card's kicker: "From her vet records". */
+    readonly blanksFilledKicker: string;
+    /** The filled card's pill, counted from the rows: "3 of 3 filled". */
+    readonly blanksFilled: (filled: number, total: number) => string;
+    /** Before her weight: "Keep her at " (then the weight, then `weightUnit` or `weightUnitKg`). */
+    readonly blanksWeight: string;
+    /** Her weight row's source line: "From her vet visits". */
+    readonly blanksWeightSource: string;
+    /** After her dose: "{chew a day} of {product}". Both are data (the dose's label and the product's name). */
+    readonly blanksDose: (dose: string, product: string) => string;
+    /** Her dose row's source line: "Sized to her weight". */
+    readonly blanksDoseSource: string;
+    /** Before her next shots' date: "Her next shots are due ". */
+    readonly blanksShots: string;
+    /** Her next shots row's source line: "From her clinic". */
+    readonly blanksShotsSource: string;
+    /** A blank's name for a screen reader. */
+    readonly blankEmpty: string;
+    /** The toast when her records land and the blanks fill. */
+    readonly recordsLanded: string;
 }
 /** The steps an order goes through, in order. */
 type HealthPlanOrderStatus = 'ordered' | 'shipped' | 'out_for_delivery' | 'delivered';
@@ -1001,143 +913,8 @@ declare function createHealthPlanPageRepositoryOver(deps: HealthPlanRepositoryDe
 /** 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';
+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' | 'blanks' | 'blanksCard' | 'blanksHead' | 'blank' | 'noPick' | 'mgOrders';
 /**
  * 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.
@@ -1175,4 +952,4 @@ 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 };
+export { createHealthPlanRepositoryOver as $, type HealthPlanCheckoutStatus as A, type HealthPlanFocusExtra as B, type HealthPlanFocusPrices as C, type HealthPlanFocusReasonRow as D, type HealthPlanFocusReview as E, type HealthPlanFocusSign as F, type HealthPlanFocusStep as G, type HealthPlanPage as H, type HealthPlanFocusWait as I, type HealthPlanOneBoxOffer as J, type HealthPlanOneBoxOrderPage as K, type HealthPlanOneBoxOrderPageOptions as L, type HealthPlanOrderStatus as M, type HealthPlanOrderTracking as N, type HealthPlanOrderTrackingStatus as O, type HealthPlanPurchase as P, type HealthPlanReason as Q, type HealthPlanRepositoryDeps as R, type HealthPlanRuntime as S, type HealthPlanSubscriptionRenewal as T, type HealthPlanSubscriptionStatus as U, type HealthPlanSubscriptionStep as V, type HealthPlanSubscriptionSupply as W, type HealthPlanTrackStep as X, createHealthPlanPageRepository as Y, createHealthPlanPageRepositoryOver as Z, createHealthPlanRepository as _, type HealthPlanPetWords as a, createHealthPlanSubscriptionRepository as a0, createHealthPlanSubscriptionRepositoryOver as a1, formatHealthPlanDay as a2, healthPlanCheckoutRefusal as a3, healthPlanCheckoutSessionFromWire as a4, healthPlanCheckoutStateFromWire as a5, healthPlanFocusCopyFor as a6, healthPlanFocusDesignFromWire as a7, healthPlanFromWire as a8, healthPlanOneBoxOrderFromWire as a9, healthPlanOneBoxOrderPageFromWire as aa, healthPlanOrderTrackingFromWire as ab, healthPlanPageFromWire as ac, healthPlanPetWords as ad, healthPlanSubscriptionFromWire as ae, healthPlanSubscriptionQuoteFromWire as af, isHealthPlanSubscriptionUnavailable as ag, type HealthPlanFocusDesign as b, type HealthPlanFocusCopy as c, type HealthPlanFocusClassNames as d, type HealthPlanFocusIcon as e, type HealthPlanItem as f, type HealthPlanSubscription as g, type HealthPlanOneBoxOrder as h, type HealthPlanSubscriptionRepository as i, type HealthPlanPageRepository as j, type HealthPlanShopOrder as k, type HealthPlanCheckoutProvider as l, type HealthPlan as m, type HealthPlanRepository as n, type HealthPlanReasonKind as o, type HealthPlanFocusPart as p, type HealthPlanSubscriptionQuote as q, type HealthPlanPagePet as r, HEALTH_PLAN_FOCUS_COPY as s, HEALTH_PLAN_REASON_KINDS as t, type HealthPlanCartCheckoutRequest as u, type HealthPlanCheckoutItem as v, type HealthPlanCheckoutRefusal as w, type HealthPlanCheckoutRequest as x, type HealthPlanCheckoutSession as y, type HealthPlanCheckoutState as z };