@everfur/sdk 0.15.1 → 0.16.0

package/dist/health-plan/index.d.cts

@@ -1,25 +1,27 @@
 /*! @everfur/sdk. Copyright (c) 2026 Strand Health Inc. dba Everfur. All rights reserved. Use is subject to the Everfur SDK License: https://docs.everfur.com/license */
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { a as CapabilityDecision } from '../resolve.d-CoQWUy1Y.cjs';
 import { E as EverfurError } from '../EverfurError.d-8NHtlgzA.cjs';
 export { a as EverfurErrorCategory, b as EverfurErrorCode } from '../EverfurError.d-8NHtlgzA.cjs';
 import { P as PetRef } from '../ids.d-B2GAAifq.cjs';
 export { B as Brand, C as ConversationId, R as RecordsRequestId, U as UserRef, _ as __brand } from '../ids.d-B2GAAifq.cjs';
-import { c as HealthPlanFocusCopy, e as HealthPlanFocusIcon, b as HealthPlanFocusDesign, f as HealthPlanItem, g as HealthPlanSubscription, h as HealthPlanOneBoxOrder, i as HealthPlanSubscriptionRepository, j as HealthPlanPageRepository, k as HealthPlanShopOrder, l as HealthPlanCheckoutProvider } from '../focus.d-BHm_QtQ9.cjs';
-export { s as HEALTH_PLAN_FOCUS_COPY, t as HEALTH_PLAN_REASON_KINDS, m as HealthPlan, u as HealthPlanCartCheckoutRequest, v as HealthPlanCheckoutItem, w as HealthPlanCheckoutRefusal, x as HealthPlanCheckoutRequest, y as HealthPlanCheckoutSession, z as HealthPlanCheckoutState, A as HealthPlanCheckoutStatus, B as HealthPlanFocusExtra, C as HealthPlanFocusPrices, D as HealthPlanFocusReasonRow, E as HealthPlanFocusReview, F as HealthPlanFocusSign, G as HealthPlanFocusStep, I as HealthPlanFocusWait, J as HealthPlanOneBoxOffer, K as HealthPlanOneBoxOrderPage, L as HealthPlanOneBoxOrderPageOptions, M as HealthPlanOrderStatus, N as HealthPlanOrderTracking, O as HealthPlanOrderTrackingStatus, H as HealthPlanPage, r as HealthPlanPagePet, P as HealthPlanPurchase, Q as HealthPlanReason, o as HealthPlanReasonKind, n as HealthPlanRepository, R as HealthPlanRepositoryDeps, S as HealthPlanRuntime, q as HealthPlanSubscriptionQuote, T as HealthPlanSubscriptionRenewal, U as HealthPlanSubscriptionStatus, V as HealthPlanSubscriptionStep, W as HealthPlanSubscriptionSupply, X as HealthPlanTrackStep, Y as createHealthPlanPageRepository, Z as createHealthPlanPageRepositoryOver, _ as createHealthPlanRepository, $ as createHealthPlanRepositoryOver, a2 as formatHealthPlanDay, a3 as healthPlanCheckoutRefusal, a4 as healthPlanCheckoutSessionFromWire, a5 as healthPlanCheckoutStateFromWire, a7 as healthPlanFocusDesignFromWire, a8 as healthPlanFromWire, ac as healthPlanPageFromWire } from '../focus.d-BHm_QtQ9.cjs';
+import { c as HealthPlanFocusCopy, e as HealthPlanFocusIcon, b as HealthPlanFocusDesign, f as HealthPlanItem, g as HealthPlanSubscription, h as HealthPlanOneBoxOrder, i as HealthPlanSubscriptionRepository, j as HealthPlanPageRepository, k as HealthPlanShopOrder, l as HealthPlanCheckoutProvider } from '../focus.d-BQnOVAql.cjs';
+export { o as HEALTH_PLAN_FOCUS_COPY, p as HEALTH_PLAN_REASON_KINDS, q as HealthPlan, r as HealthPlanCartCheckoutRequest, s as HealthPlanCheckoutItem, t as HealthPlanCheckoutRefusal, u as HealthPlanCheckoutRequest, v as HealthPlanCheckoutSession, w as HealthPlanCheckoutState, x as HealthPlanCheckoutStatus, y as HealthPlanFocusExtra, z as HealthPlanFocusPrices, A as HealthPlanFocusReasonRow, B as HealthPlanFocusReview, C as HealthPlanFocusSign, D as HealthPlanFocusStep, E as HealthPlanFocusWait, F as HealthPlanOneBoxOffer, G as HealthPlanOneBoxOrderPage, I as HealthPlanOneBoxOrderPageOptions, J as HealthPlanOrderStatus, K as HealthPlanOrderTracking, L as HealthPlanOrderTrackingStatus, H as HealthPlanPage, n as HealthPlanPagePet, a as HealthPlanPetPronouns, M as HealthPlanPurchase, N as HealthPlanReason, O as HealthPlanReasonKind, P as HealthPlanRepository, Q as HealthPlanRepositoryDeps, R as HealthPlanRuntime, S as HealthPlanSubscriptionQuote, T as HealthPlanSubscriptionRenewal, U as HealthPlanSubscriptionStatus, V as HealthPlanSubscriptionStep, W as HealthPlanSubscriptionSupply, X as HealthPlanTrackStep, Y as createHealthPlanPageRepository, Z as createHealthPlanPageRepositoryOver, _ as createHealthPlanRepository, $ as createHealthPlanRepositoryOver, a0 as createHealthPlanSubscriptionRepository, a1 as createHealthPlanSubscriptionRepositoryOver, a2 as formatHealthPlanDay, a3 as healthPlanCheckoutRefusal, a4 as healthPlanCheckoutSessionFromWire, a5 as healthPlanCheckoutStateFromWire, a6 as healthPlanFocusCopyFor, a7 as healthPlanFocusDesignFromWire, a8 as healthPlanFromWire, a9 as healthPlanOneBoxOrderFromWire, aa as healthPlanOneBoxOrderPageFromWire, ab as healthPlanOrderTrackingFromWire, ac as healthPlanPageFromWire, ad as healthPlanPetWords, ae as healthPlanSubscriptionFromWire, af as healthPlanSubscriptionQuoteFromWire, ag as isHealthPlanSubscriptionUnavailable } from '../focus.d-BQnOVAql.cjs';
 import { i as EverfurPresentationInput } from '../presentation.d-vy8kTGfR.cjs';
 export { E as EverfurChatAnswerStyle, a as EverfurChatComposerPlaceholder, b as EverfurChatComposerStyle, c as EverfurChatHistoryBarSetting, d as EverfurChatHistoryStyle, e as EverfurChatSendButtonSetting, f as EverfurChatTopCardSetting, g as EverfurHealthPlanLayout, h as EverfurPresentation, j as EverfurSafetyDisclaimerPlacement } from '../presentation.d-vy8kTGfR.cjs';
-import { H as HealthPlanBlanksFacts, a as HealthPlanPriceFormat, b as HealthPlanLayoutProps, e as HealthPlanCardOptions, f as HealthPlanImageVariant, g as HealthPlanReasonVariant, d as HealthPlanCart } from '../usePresentation.d-BcdCIuEU.cjs';
-export { E as EverfurHealthPlanOptions, h as EverfurHealthPlanState, i as EverfurHealthPlanStatus, j as HEALTH_PLAN_COPY, k as HEALTH_PLAN_COPY_PLACEHOLDERS, l as HEALTH_PLAN_LAYOUT_DEFAULTS, m as HEALTH_PLAN_REASON_LABELS, n as HEALTH_PLAN_TEMPLATES, o as HealthPlanAddButtonSize, p as HealthPlanAddedVariant, q as HealthPlanBlanksPhase, r as HealthPlanCardShadow, s as HealthPlanCartBarPlacement, t as HealthPlanCartBarVisibility, u as HealthPlanCategoryVariant, v as HealthPlanFontWeight, w as HealthPlanHeaderContext, x as HealthPlanPageContext, y as HealthPlanShadow, z as formatHealthPlanPrice, A as formatHealthPlanPriceWith, B as healthPlanBlanksFacts, C as healthPlanCart, D as healthPlanNextShotsAt, F as healthPlanRecordsWeightKg, G as isHealthPlanSessionRequired, I as showHealthPlanCartBar, J as useEverfurHealthPlan, K as useEverfurHealthPlanRepository, L as useEverfurPresentation } from '../usePresentation.d-BcdCIuEU.cjs';
+import { H as HealthPlanBlanksFacts, a as HealthPlanPriceFormat, b as HealthPlanLayoutProps, c as HealthPlanEmptyCopy, d as HealthPlanCardOptions, e as HealthPlanImageVariant, f as HealthPlanReasonVariant, g as HealthPlanCart } from '../usePresentation.d-YkJeq9mf.cjs';
+export { E as EverfurHealthPlanOptions, h as EverfurHealthPlanState, i as EverfurHealthPlanStatus, j as HEALTH_PLAN_COPY, k as HEALTH_PLAN_COPY_PLACEHOLDERS, l as HEALTH_PLAN_LAYOUT_DEFAULTS, m as HEALTH_PLAN_REASON_LABELS, n as HEALTH_PLAN_TEMPLATES, o as HealthPlanAddButtonSize, p as HealthPlanAddedVariant, q as HealthPlanBlanksPhase, r as HealthPlanCardShadow, s as HealthPlanCartBarPlacement, t as HealthPlanCartBarVisibility, u as HealthPlanCategoryVariant, v as HealthPlanFontWeight, w as HealthPlanHeaderContext, x as HealthPlanPageContext, y as HealthPlanShadow, z as formatHealthPlanPrice, A as formatHealthPlanPriceWith, B as healthPlanBlanksFacts, C as healthPlanCart, D as healthPlanNextShotsAt, F as healthPlanRecordsWeightKg, G as isHealthPlanSessionRequired, I as showHealthPlanCartBar, J as useEverfurHealthPlan, K as useEverfurHealthPlanRepository, L as useEverfurPresentation } from '../usePresentation.d-YkJeq9mf.cjs';
 import { L as LifecyclePort } from '../LifecyclePort.d-Cr1p33a7.cjs';
 import { E as EverfurResult } from '../EverfurResult.d-BFH-3s6E.cjs';
 import { R as RecordsRecordWire } from '../ports.d-BX4f4UsB.cjs';
-export { H as HealthPlanCartDock, a as HealthPlanCartScope, b as HealthPlanCartScopeProps, c as HealthPlanController, d as HealthPlanNoVetListener, e as HealthPlanPageOptions, f as HealthPlanPagePhase, g as HealthPlanPageState, h as HealthPlanPhase, i as HealthPlanRecordsLandedListener, j as HealthPlanRecordsLandedSource, k as HealthPlanSnapshot, l as healthPlanNoVet, n as notifyHealthPlanRecordsLanded, o as onHealthPlanNoVet, m as onHealthPlanRecordsLanded, s as setHealthPlanNoVet, u as useHealthPlanCartDock, p as useHealthPlanPage, q as useHealthPlanPageRepository } from '../planSignals.d-Dha2CMDF.cjs';
-export { A as AuthContext, I as IdentityProvider, M as MintedToken, T as TokenProvider } from '../identity.d-HbwYQ4-z.cjs';
-export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config.d-BQgrIDdu.cjs';
+import { C as HealthPlanTopCardOptions } from '../useHealthPlanSubscription.d-OhLZpn-n.cjs';
+export { a as HEALTH_PLAN_TOP_CARD_COPY, b as HealthPlanCartDock, c as HealthPlanCartScope, d as HealthPlanCartScopeProps, e as HealthPlanController, f as HealthPlanNoVetListener, g as HealthPlanPageOptions, h as HealthPlanPagePhase, i as HealthPlanPageState, j as HealthPlanPhase, D as HealthPlanPossessivePet, k as HealthPlanRecordsLandedListener, l as HealthPlanRecordsLandedSource, m as HealthPlanSnapshot, n as HealthPlanSubscriptionOptions, o as HealthPlanSubscriptionPhase, p as HealthPlanSubscriptionState, H as HealthPlanTopCardCopy, q as HealthPlanTopCardFocus, r as HealthPlanTopCardPet, s as healthPlanNoVet, E as healthPlanPossessive, F as healthPlanTopCard, t as notifyHealthPlanRecordsLanded, u as onHealthPlanNoVet, v as onHealthPlanRecordsLanded, w as setHealthPlanNoVet, x as useHealthPlanCartDock, y as useHealthPlanPage, z as useHealthPlanPageRepository, A as useHealthPlanSubscription, B as useHealthPlanSubscriptionRepository } from '../useHealthPlanSubscription.d-OhLZpn-n.cjs';
+export { A as AuthContext, I as IdentityProvider, M as MintedToken, T as TokenProvider } from '../identity.d-nRZBzkG2.cjs';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config.d-84fNJFv9.cjs';
 export { E as ErrorPolicyPort } from '../ErrorPolicyPort.d-DirW9hgO.cjs';
-import '../requestFunnel.d-JoqddYSx.cjs';
+import { b as EverfurChatTopCard } from '../threadOptions.d-6hfQS1x7.cjs';
+import '../requestFunnel.d-mEu6B-n8.cjs';
 import '../models.d-BSqvbTE1.cjs';
 
 /** The pet facts the words are sized to. */
@@ -29,8 +31,7 @@ interface HealthPlanPetWords {
     /** The partner texts tracking numbers (Q9): the "by text" lines are drawn. Absent = false. */
     readonly trackingTexts?: boolean;
 }
-/** "her" for a female, "his" for a male, "Georgia's" for a named pet of unknown sex, else null. */
-declare function healthPlanPossessive(pet: HealthPlanPetWords): string | null;
+
 /** The words the React Native focus layout adds over `HealthPlanFocusCopy`. Each '' hides what it labels. */
 interface HealthPlanFocusRnCopy extends HealthPlanFocusCopy {
     /**
@@ -38,10 +39,6 @@ interface HealthPlanFocusRnCopy extends HealthPlanFocusCopy {
      * app's own words (everfur-frontend app/lib/error-handler.ts:66).
      */
     readonly checkoutFailed: string;
-    /** The weight sheet's error with `weightUnit="kg"`. No approved words yet: '' (a copy ask for Raph). */
-    readonly weightErrorKg: string;
-    /** The toast after a weight saved in kilograms. No approved words yet: returns '' and no toast shows. */
-    readonly weightSavedKg: (kilograms: string) => string;
     /** The back control over a pushed screen when the host draws no header of its own (src/rn/records/ScreenHeader.tsx). */
     readonly back: string;
 }
@@ -100,8 +97,18 @@ interface HealthPlanFocusRnOptions {
     readonly onOverlayChange?: (overlay: HealthPlanFocusRnOverlay, controls: HealthPlanFocusRnOverlayControls) => void;
     readonly onSubscriptionChange?: (subscription: HealthPlanSubscription) => void;
     readonly onOneBoxOrder?: (order: HealthPlanOneBoxOrder) => void;
-    /** The jump strip under the focus card was pressed: scroll your container to the pick. Omit it and the strip is not a control. */
+    /**
+     * The jump strip under the focus card was pressed: scroll your container to the pick. Omit it and the strip scrolls
+     * the surrounding `HealthPlanScrollScope` (EverfurTabs wraps its plan in one) to the pick; with neither the strip is
+     * not a control.
+     */
     readonly onJump?: () => void;
+    /**
+     * Q9: the partner texts tracking numbers, so the "Tracking comes by text" lines are drawn. Everfur's plan page says
+     * it itself (`trackingTextsEnabled`); with your own `design` this is yours to say (the web's option). Absent: the
+     * plan read's `trackingTextsEnabled`, else false.
+     */
+    readonly trackingTexts?: boolean;
     /** Number and date locale. */
     readonly locale?: string;
     readonly subscriptionRepository?: HealthPlanSubscriptionRepository;
@@ -181,11 +188,6 @@ interface HealthPlanFocusProps extends Omit<HealthPlanFocusRnOptions, 'design'>
     readonly fromBackend?: boolean;
     /** Q2: the page says its template is vet reviewed. Only then is a backend page's byline drawn. */
     readonly vetReviewed?: boolean;
-    /**
-     * Q9: the partner texts tracking numbers (`trackingTextsEnabled` on the plan page or the plan read). Only then are
-     * the "Tracking comes by text" lines drawn. Absent = false.
-     */
-    readonly trackingTexts?: boolean;
     readonly onCheckout?: (items: readonly HealthPlanItem[]) => void;
     readonly priceFormat?: HealthPlanPriceFormat;
     readonly style?: StyleProp<ViewStyle>;
@@ -223,10 +225,19 @@ interface EverfurHealthPlanProps extends HealthPlanLayoutProps {
      */
     readonly focus?: HealthPlanFocusRnOptions;
     /**
-     * Whether this pet has a plan to show (Q1): false for no plan (nothing is drawn, so hide your tab or entry), true
-     * once the plan is drawn. Not called while it is still loading or after a refused read.
+     * Whether this pet has a plan to show (Q1), with the pet it is about: false for no plan (hide your tab or entry for
+     * that pet), true once the plan is drawn. Not called while it is still loading or after a refused read. The same
+     * name and signature as the web's.
+     */
+    readonly onAvailability?: (available: boolean, petRef: PetRef | null) => void;
+    /**
+     * @deprecated Use `onAvailability(available, petRef)`, the web's name. Still called, with the same value.
      */
     readonly onAvailabilityChange?: (available: boolean) => void;
+    /** The empty state's Ask control (drawn only when `emptyAsk` has words). */
+    readonly onAsk?: () => void;
+    /** Your words for the empty state, over the SDK's (empty until approved: then nothing is drawn). */
+    readonly emptyCopy?: Partial<HealthPlanEmptyCopy>;
 }
 /** One pet's Health Plan in a React Native app. Mount it under the `EverfurProvider` from "@everfur/sdk". */
 declare function EverfurHealthPlan(props: EverfurHealthPlanProps): ReactNode;
@@ -265,6 +276,36 @@ interface HealthPlanCartBarProps {
 /** The cart bar of a Health Plan. */
 declare function HealthPlanCartBar(props: HealthPlanCartBarProps): ReactNode;
 
+interface HealthPlanTopRiskProps {
+    /** The line over the sentence ("Her top risk"). */
+    readonly kicker: string;
+    /** The one sentence ("Georgia's top disease risk is IVDD, a back problem, so she should start a Health Plan for it."). */
+    readonly sentence: string;
+    /** The button's words ("Start her Health Plan"). */
+    readonly action: string;
+    readonly onOpenPlan: () => void;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** The top-risk sentence with its way into the Health Plan. */
+declare function HealthPlanTopRisk(props: HealthPlanTopRiskProps): ReactNode;
+
+/** The minimal ScrollView surface the scope uses. */
+interface HealthPlanScrollable {
+    scrollTo(options: {
+        readonly x?: number;
+        readonly y?: number;
+        readonly animated?: boolean;
+    }): void;
+}
+interface HealthPlanScrollScopeProps {
+    /** The ref of the ScrollView the plan sits in. */
+    readonly scrollRef: RefObject<HealthPlanScrollable | null>;
+    readonly children?: ReactNode;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** Wrap your plan (inside your ScrollView) so the focus layout's jump strip scrolls it to the pick. */
+declare function HealthPlanScrollScope({ scrollRef, children, style }: HealthPlanScrollScopeProps): ReactNode;
+
 /** One row: the words before the blank, the value (null: still a blank), the words after it, and its source line. */
 interface HealthPlanBlanksRow {
     readonly key: string;
@@ -291,4 +332,16 @@ interface HealthPlanBlanksProps {
 }
 declare function HealthPlanBlanks(props: HealthPlanBlanksProps): ReactNode;
 
-export { EverfurError, EverfurHealthPlan, type EverfurHealthPlanProps, EverfurPresentationInput, EverfurResult, HEALTH_PLAN_FOCUS_RN_COPY, HealthPlanBlanks, HealthPlanBlanksFacts, type HealthPlanBlanksProps, type HealthPlanBlanksRow, HealthPlanCardOptions, HealthPlanCart, HealthPlanCartBar, type HealthPlanCartBarProps, HealthPlanCheckoutProvider, HealthPlanFocus, type HealthPlanFocusCheckoutRow, HealthPlanFocusCopy, HealthPlanFocusDesign, HealthPlanFocusIcon, type HealthPlanFocusProps, type HealthPlanFocusRnCopy, type HealthPlanFocusRnOptions, type HealthPlanFocusRnOverlay, type HealthPlanFocusRnOverlayControls, HealthPlanImageVariant, HealthPlanItem, HealthPlanItemCard, type HealthPlanItemCardProps, HealthPlanLayoutProps, HealthPlanOneBoxOrder, HealthPlanPageRepository, type HealthPlanPetWords, HealthPlanPriceFormat, HealthPlanReasonVariant, type HealthPlanRecordsReader, HealthPlanShopOrder, HealthPlanSubscription, HealthPlanSubscriptionRepository, LifecyclePort, PetRef, RecordsRecordWire, healthPlanPetCopy, healthPlanPossessive };
+interface UseHealthPlanTopCardOptions extends HealthPlanTopCardOptions {
+    readonly petRef: PetRef | null;
+    /** False skips the page read (and the card). Defaults to true. */
+    readonly enabled?: boolean;
+}
+/**
+ * The chat's top card for one pet, from its Health Plan page; undefined while the page loads, on a refused read, or
+ * when the page has no focus. Keep `onOpenPlan`, `copy` and `renderIcon` stable (module constants or memoised), so the
+ * card is rebuilt only when the page changes.
+ */
+declare function useHealthPlanTopCard(options: UseHealthPlanTopCardOptions): EverfurChatTopCard | undefined;
+
+export { EverfurChatTopCard, EverfurError, EverfurHealthPlan, type EverfurHealthPlanProps, EverfurPresentationInput, EverfurResult, HEALTH_PLAN_FOCUS_RN_COPY, HealthPlanBlanks, HealthPlanBlanksFacts, type HealthPlanBlanksProps, type HealthPlanBlanksRow, HealthPlanCardOptions, HealthPlanCart, HealthPlanCartBar, type HealthPlanCartBarProps, HealthPlanCheckoutProvider, HealthPlanEmptyCopy, HealthPlanFocus, type HealthPlanFocusCheckoutRow, HealthPlanFocusCopy, HealthPlanFocusDesign, HealthPlanFocusIcon, type HealthPlanFocusProps, type HealthPlanFocusRnCopy, type HealthPlanFocusRnOptions, type HealthPlanFocusRnOverlay, type HealthPlanFocusRnOverlayControls, HealthPlanImageVariant, HealthPlanItem, HealthPlanItemCard, type HealthPlanItemCardProps, HealthPlanLayoutProps, HealthPlanOneBoxOrder, HealthPlanPageRepository, type HealthPlanPetWords, HealthPlanPriceFormat, HealthPlanReasonVariant, type HealthPlanRecordsReader, HealthPlanScrollScope, type HealthPlanScrollScopeProps, type HealthPlanScrollable, HealthPlanShopOrder, HealthPlanSubscription, HealthPlanSubscriptionRepository, HealthPlanTopCardOptions, HealthPlanTopRisk, type HealthPlanTopRiskProps, LifecyclePort, PetRef, RecordsRecordWire, type UseHealthPlanTopCardOptions, healthPlanPetCopy, useHealthPlanTopCard };

package/dist/health-plan/index.d.ts

@@ -1,25 +1,27 @@
 /*! @everfur/sdk. Copyright (c) 2026 Strand Health Inc. dba Everfur. All rights reserved. Use is subject to the Everfur SDK License: https://docs.everfur.com/license */
-import { ReactNode } from 'react';
+import { ReactNode, RefObject } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { a as CapabilityDecision } from '../resolve.d-CoQWUy1Y.js';
 import { E as EverfurError } from '../EverfurError.d-8NHtlgzA.js';
 export { a as EverfurErrorCategory, b as EverfurErrorCode } from '../EverfurError.d-8NHtlgzA.js';
 import { P as PetRef } from '../ids.d-B2GAAifq.js';
 export { B as Brand, C as ConversationId, R as RecordsRequestId, U as UserRef, _ as __brand } from '../ids.d-B2GAAifq.js';
-import { c as HealthPlanFocusCopy, e as HealthPlanFocusIcon, b as HealthPlanFocusDesign, f as HealthPlanItem, g as HealthPlanSubscription, h as HealthPlanOneBoxOrder, i as HealthPlanSubscriptionRepository, j as HealthPlanPageRepository, k as HealthPlanShopOrder, l as HealthPlanCheckoutProvider } from '../focus.d-CjL6Cj0m.js';
-export { s as HEALTH_PLAN_FOCUS_COPY, t as HEALTH_PLAN_REASON_KINDS, m as HealthPlan, u as HealthPlanCartCheckoutRequest, v as HealthPlanCheckoutItem, w as HealthPlanCheckoutRefusal, x as HealthPlanCheckoutRequest, y as HealthPlanCheckoutSession, z as HealthPlanCheckoutState, A as HealthPlanCheckoutStatus, B as HealthPlanFocusExtra, C as HealthPlanFocusPrices, D as HealthPlanFocusReasonRow, E as HealthPlanFocusReview, F as HealthPlanFocusSign, G as HealthPlanFocusStep, I as HealthPlanFocusWait, J as HealthPlanOneBoxOffer, K as HealthPlanOneBoxOrderPage, L as HealthPlanOneBoxOrderPageOptions, M as HealthPlanOrderStatus, N as HealthPlanOrderTracking, O as HealthPlanOrderTrackingStatus, H as HealthPlanPage, r as HealthPlanPagePet, P as HealthPlanPurchase, Q as HealthPlanReason, o as HealthPlanReasonKind, n as HealthPlanRepository, R as HealthPlanRepositoryDeps, S as HealthPlanRuntime, q as HealthPlanSubscriptionQuote, T as HealthPlanSubscriptionRenewal, U as HealthPlanSubscriptionStatus, V as HealthPlanSubscriptionStep, W as HealthPlanSubscriptionSupply, X as HealthPlanTrackStep, Y as createHealthPlanPageRepository, Z as createHealthPlanPageRepositoryOver, _ as createHealthPlanRepository, $ as createHealthPlanRepositoryOver, a2 as formatHealthPlanDay, a3 as healthPlanCheckoutRefusal, a4 as healthPlanCheckoutSessionFromWire, a5 as healthPlanCheckoutStateFromWire, a7 as healthPlanFocusDesignFromWire, a8 as healthPlanFromWire, ac as healthPlanPageFromWire } from '../focus.d-CjL6Cj0m.js';
+import { c as HealthPlanFocusCopy, e as HealthPlanFocusIcon, b as HealthPlanFocusDesign, f as HealthPlanItem, g as HealthPlanSubscription, h as HealthPlanOneBoxOrder, i as HealthPlanSubscriptionRepository, j as HealthPlanPageRepository, k as HealthPlanShopOrder, l as HealthPlanCheckoutProvider } from '../focus.d-BZ2sEpbU.js';
+export { o as HEALTH_PLAN_FOCUS_COPY, p as HEALTH_PLAN_REASON_KINDS, q as HealthPlan, r as HealthPlanCartCheckoutRequest, s as HealthPlanCheckoutItem, t as HealthPlanCheckoutRefusal, u as HealthPlanCheckoutRequest, v as HealthPlanCheckoutSession, w as HealthPlanCheckoutState, x as HealthPlanCheckoutStatus, y as HealthPlanFocusExtra, z as HealthPlanFocusPrices, A as HealthPlanFocusReasonRow, B as HealthPlanFocusReview, C as HealthPlanFocusSign, D as HealthPlanFocusStep, E as HealthPlanFocusWait, F as HealthPlanOneBoxOffer, G as HealthPlanOneBoxOrderPage, I as HealthPlanOneBoxOrderPageOptions, J as HealthPlanOrderStatus, K as HealthPlanOrderTracking, L as HealthPlanOrderTrackingStatus, H as HealthPlanPage, n as HealthPlanPagePet, a as HealthPlanPetPronouns, M as HealthPlanPurchase, N as HealthPlanReason, O as HealthPlanReasonKind, P as HealthPlanRepository, Q as HealthPlanRepositoryDeps, R as HealthPlanRuntime, S as HealthPlanSubscriptionQuote, T as HealthPlanSubscriptionRenewal, U as HealthPlanSubscriptionStatus, V as HealthPlanSubscriptionStep, W as HealthPlanSubscriptionSupply, X as HealthPlanTrackStep, Y as createHealthPlanPageRepository, Z as createHealthPlanPageRepositoryOver, _ as createHealthPlanRepository, $ as createHealthPlanRepositoryOver, a0 as createHealthPlanSubscriptionRepository, a1 as createHealthPlanSubscriptionRepositoryOver, a2 as formatHealthPlanDay, a3 as healthPlanCheckoutRefusal, a4 as healthPlanCheckoutSessionFromWire, a5 as healthPlanCheckoutStateFromWire, a6 as healthPlanFocusCopyFor, a7 as healthPlanFocusDesignFromWire, a8 as healthPlanFromWire, a9 as healthPlanOneBoxOrderFromWire, aa as healthPlanOneBoxOrderPageFromWire, ab as healthPlanOrderTrackingFromWire, ac as healthPlanPageFromWire, ad as healthPlanPetWords, ae as healthPlanSubscriptionFromWire, af as healthPlanSubscriptionQuoteFromWire, ag as isHealthPlanSubscriptionUnavailable } from '../focus.d-BZ2sEpbU.js';
 import { i as EverfurPresentationInput } from '../presentation.d-vy8kTGfR.js';
 export { E as EverfurChatAnswerStyle, a as EverfurChatComposerPlaceholder, b as EverfurChatComposerStyle, c as EverfurChatHistoryBarSetting, d as EverfurChatHistoryStyle, e as EverfurChatSendButtonSetting, f as EverfurChatTopCardSetting, g as EverfurHealthPlanLayout, h as EverfurPresentation, j as EverfurSafetyDisclaimerPlacement } from '../presentation.d-vy8kTGfR.js';
-import { H as HealthPlanBlanksFacts, a as HealthPlanPriceFormat, b as HealthPlanLayoutProps, e as HealthPlanCardOptions, f as HealthPlanImageVariant, g as HealthPlanReasonVariant, d as HealthPlanCart } from '../usePresentation.d-Bne14SlX.js';
-export { E as EverfurHealthPlanOptions, h as EverfurHealthPlanState, i as EverfurHealthPlanStatus, j as HEALTH_PLAN_COPY, k as HEALTH_PLAN_COPY_PLACEHOLDERS, l as HEALTH_PLAN_LAYOUT_DEFAULTS, m as HEALTH_PLAN_REASON_LABELS, n as HEALTH_PLAN_TEMPLATES, o as HealthPlanAddButtonSize, p as HealthPlanAddedVariant, q as HealthPlanBlanksPhase, r as HealthPlanCardShadow, s as HealthPlanCartBarPlacement, t as HealthPlanCartBarVisibility, u as HealthPlanCategoryVariant, v as HealthPlanFontWeight, w as HealthPlanHeaderContext, x as HealthPlanPageContext, y as HealthPlanShadow, z as formatHealthPlanPrice, A as formatHealthPlanPriceWith, B as healthPlanBlanksFacts, C as healthPlanCart, D as healthPlanNextShotsAt, F as healthPlanRecordsWeightKg, G as isHealthPlanSessionRequired, I as showHealthPlanCartBar, J as useEverfurHealthPlan, K as useEverfurHealthPlanRepository, L as useEverfurPresentation } from '../usePresentation.d-Bne14SlX.js';
+import { H as HealthPlanBlanksFacts, a as HealthPlanPriceFormat, b as HealthPlanLayoutProps, c as HealthPlanEmptyCopy, d as HealthPlanCardOptions, e as HealthPlanImageVariant, f as HealthPlanReasonVariant, g as HealthPlanCart } from '../usePresentation.d-CBtBx38t.js';
+export { E as EverfurHealthPlanOptions, h as EverfurHealthPlanState, i as EverfurHealthPlanStatus, j as HEALTH_PLAN_COPY, k as HEALTH_PLAN_COPY_PLACEHOLDERS, l as HEALTH_PLAN_LAYOUT_DEFAULTS, m as HEALTH_PLAN_REASON_LABELS, n as HEALTH_PLAN_TEMPLATES, o as HealthPlanAddButtonSize, p as HealthPlanAddedVariant, q as HealthPlanBlanksPhase, r as HealthPlanCardShadow, s as HealthPlanCartBarPlacement, t as HealthPlanCartBarVisibility, u as HealthPlanCategoryVariant, v as HealthPlanFontWeight, w as HealthPlanHeaderContext, x as HealthPlanPageContext, y as HealthPlanShadow, z as formatHealthPlanPrice, A as formatHealthPlanPriceWith, B as healthPlanBlanksFacts, C as healthPlanCart, D as healthPlanNextShotsAt, F as healthPlanRecordsWeightKg, G as isHealthPlanSessionRequired, I as showHealthPlanCartBar, J as useEverfurHealthPlan, K as useEverfurHealthPlanRepository, L as useEverfurPresentation } from '../usePresentation.d-CBtBx38t.js';
 import { L as LifecyclePort } from '../LifecyclePort.d-Cr1p33a7.js';
 import { E as EverfurResult } from '../EverfurResult.d-D_-254ZY.js';
 import { R as RecordsRecordWire } from '../ports.d-BX4f4UsB.js';
-export { H as HealthPlanCartDock, a as HealthPlanCartScope, b as HealthPlanCartScopeProps, c as HealthPlanController, d as HealthPlanNoVetListener, e as HealthPlanPageOptions, f as HealthPlanPagePhase, g as HealthPlanPageState, h as HealthPlanPhase, i as HealthPlanRecordsLandedListener, j as HealthPlanRecordsLandedSource, k as HealthPlanSnapshot, l as healthPlanNoVet, n as notifyHealthPlanRecordsLanded, o as onHealthPlanNoVet, m as onHealthPlanRecordsLanded, s as setHealthPlanNoVet, u as useHealthPlanCartDock, p as useHealthPlanPage, q as useHealthPlanPageRepository } from '../planSignals.d-CON9gTvJ.js';
-export { A as AuthContext, I as IdentityProvider, M as MintedToken, T as TokenProvider } from '../identity.d-Be2Es9Td.js';
-export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config.d-XSMThgVj.js';
+import { C as HealthPlanTopCardOptions } from '../useHealthPlanSubscription.d-CUbHE6eK.js';
+export { a as HEALTH_PLAN_TOP_CARD_COPY, b as HealthPlanCartDock, c as HealthPlanCartScope, d as HealthPlanCartScopeProps, e as HealthPlanController, f as HealthPlanNoVetListener, g as HealthPlanPageOptions, h as HealthPlanPagePhase, i as HealthPlanPageState, j as HealthPlanPhase, D as HealthPlanPossessivePet, k as HealthPlanRecordsLandedListener, l as HealthPlanRecordsLandedSource, m as HealthPlanSnapshot, n as HealthPlanSubscriptionOptions, o as HealthPlanSubscriptionPhase, p as HealthPlanSubscriptionState, H as HealthPlanTopCardCopy, q as HealthPlanTopCardFocus, r as HealthPlanTopCardPet, s as healthPlanNoVet, E as healthPlanPossessive, F as healthPlanTopCard, t as notifyHealthPlanRecordsLanded, u as onHealthPlanNoVet, v as onHealthPlanRecordsLanded, w as setHealthPlanNoVet, x as useHealthPlanCartDock, y as useHealthPlanPage, z as useHealthPlanPageRepository, A as useHealthPlanSubscription, B as useHealthPlanSubscriptionRepository } from '../useHealthPlanSubscription.d-CUbHE6eK.js';
+export { A as AuthContext, I as IdentityProvider, M as MintedToken, T as TokenProvider } from '../identity.d-DxNvhj3a.js';
+export { A as AcceptedFrame, a as AnalysisCompleteFrame, b as AnalysisStartedFrame, D as DeltaFrame, c as DoneFrame, E as ErrorFrame, d as EverfurRequest, e as EverfurRequestBase, F as Frame, f as FrameBase, g as FrameKind, H as HeartbeatFrame, h as HttpMethod, M as MultipartBody, T as TransportPort, U as UnknownFrame, i as UrgencyLevel } from '../config.d-B4-Mrwq2.js';
 export { E as ErrorPolicyPort } from '../ErrorPolicyPort.d-68yrE3BE.js';
-import '../requestFunnel.d-YabU6G-Z.js';
+import { b as EverfurChatTopCard } from '../threadOptions.d-6hfQS1x7.js';
+import '../requestFunnel.d-Cxt0JqYx.js';
 import '../models.d-DOwnr8fi.js';
 
 /** The pet facts the words are sized to. */
@@ -29,8 +31,7 @@ interface HealthPlanPetWords {
     /** The partner texts tracking numbers (Q9): the "by text" lines are drawn. Absent = false. */
     readonly trackingTexts?: boolean;
 }
-/** "her" for a female, "his" for a male, "Georgia's" for a named pet of unknown sex, else null. */
-declare function healthPlanPossessive(pet: HealthPlanPetWords): string | null;
+
 /** The words the React Native focus layout adds over `HealthPlanFocusCopy`. Each '' hides what it labels. */
 interface HealthPlanFocusRnCopy extends HealthPlanFocusCopy {
     /**
@@ -38,10 +39,6 @@ interface HealthPlanFocusRnCopy extends HealthPlanFocusCopy {
      * app's own words (everfur-frontend app/lib/error-handler.ts:66).
      */
     readonly checkoutFailed: string;
-    /** The weight sheet's error with `weightUnit="kg"`. No approved words yet: '' (a copy ask for Raph). */
-    readonly weightErrorKg: string;
-    /** The toast after a weight saved in kilograms. No approved words yet: returns '' and no toast shows. */
-    readonly weightSavedKg: (kilograms: string) => string;
     /** The back control over a pushed screen when the host draws no header of its own (src/rn/records/ScreenHeader.tsx). */
     readonly back: string;
 }
@@ -100,8 +97,18 @@ interface HealthPlanFocusRnOptions {
     readonly onOverlayChange?: (overlay: HealthPlanFocusRnOverlay, controls: HealthPlanFocusRnOverlayControls) => void;
     readonly onSubscriptionChange?: (subscription: HealthPlanSubscription) => void;
     readonly onOneBoxOrder?: (order: HealthPlanOneBoxOrder) => void;
-    /** The jump strip under the focus card was pressed: scroll your container to the pick. Omit it and the strip is not a control. */
+    /**
+     * The jump strip under the focus card was pressed: scroll your container to the pick. Omit it and the strip scrolls
+     * the surrounding `HealthPlanScrollScope` (EverfurTabs wraps its plan in one) to the pick; with neither the strip is
+     * not a control.
+     */
     readonly onJump?: () => void;
+    /**
+     * Q9: the partner texts tracking numbers, so the "Tracking comes by text" lines are drawn. Everfur's plan page says
+     * it itself (`trackingTextsEnabled`); with your own `design` this is yours to say (the web's option). Absent: the
+     * plan read's `trackingTextsEnabled`, else false.
+     */
+    readonly trackingTexts?: boolean;
     /** Number and date locale. */
     readonly locale?: string;
     readonly subscriptionRepository?: HealthPlanSubscriptionRepository;
@@ -181,11 +188,6 @@ interface HealthPlanFocusProps extends Omit<HealthPlanFocusRnOptions, 'design'>
     readonly fromBackend?: boolean;
     /** Q2: the page says its template is vet reviewed. Only then is a backend page's byline drawn. */
     readonly vetReviewed?: boolean;
-    /**
-     * Q9: the partner texts tracking numbers (`trackingTextsEnabled` on the plan page or the plan read). Only then are
-     * the "Tracking comes by text" lines drawn. Absent = false.
-     */
-    readonly trackingTexts?: boolean;
     readonly onCheckout?: (items: readonly HealthPlanItem[]) => void;
     readonly priceFormat?: HealthPlanPriceFormat;
     readonly style?: StyleProp<ViewStyle>;
@@ -223,10 +225,19 @@ interface EverfurHealthPlanProps extends HealthPlanLayoutProps {
      */
     readonly focus?: HealthPlanFocusRnOptions;
     /**
-     * Whether this pet has a plan to show (Q1): false for no plan (nothing is drawn, so hide your tab or entry), true
-     * once the plan is drawn. Not called while it is still loading or after a refused read.
+     * Whether this pet has a plan to show (Q1), with the pet it is about: false for no plan (hide your tab or entry for
+     * that pet), true once the plan is drawn. Not called while it is still loading or after a refused read. The same
+     * name and signature as the web's.
+     */
+    readonly onAvailability?: (available: boolean, petRef: PetRef | null) => void;
+    /**
+     * @deprecated Use `onAvailability(available, petRef)`, the web's name. Still called, with the same value.
      */
     readonly onAvailabilityChange?: (available: boolean) => void;
+    /** The empty state's Ask control (drawn only when `emptyAsk` has words). */
+    readonly onAsk?: () => void;
+    /** Your words for the empty state, over the SDK's (empty until approved: then nothing is drawn). */
+    readonly emptyCopy?: Partial<HealthPlanEmptyCopy>;
 }
 /** One pet's Health Plan in a React Native app. Mount it under the `EverfurProvider` from "@everfur/sdk". */
 declare function EverfurHealthPlan(props: EverfurHealthPlanProps): ReactNode;
@@ -265,6 +276,36 @@ interface HealthPlanCartBarProps {
 /** The cart bar of a Health Plan. */
 declare function HealthPlanCartBar(props: HealthPlanCartBarProps): ReactNode;
 
+interface HealthPlanTopRiskProps {
+    /** The line over the sentence ("Her top risk"). */
+    readonly kicker: string;
+    /** The one sentence ("Georgia's top disease risk is IVDD, a back problem, so she should start a Health Plan for it."). */
+    readonly sentence: string;
+    /** The button's words ("Start her Health Plan"). */
+    readonly action: string;
+    readonly onOpenPlan: () => void;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** The top-risk sentence with its way into the Health Plan. */
+declare function HealthPlanTopRisk(props: HealthPlanTopRiskProps): ReactNode;
+
+/** The minimal ScrollView surface the scope uses. */
+interface HealthPlanScrollable {
+    scrollTo(options: {
+        readonly x?: number;
+        readonly y?: number;
+        readonly animated?: boolean;
+    }): void;
+}
+interface HealthPlanScrollScopeProps {
+    /** The ref of the ScrollView the plan sits in. */
+    readonly scrollRef: RefObject<HealthPlanScrollable | null>;
+    readonly children?: ReactNode;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/** Wrap your plan (inside your ScrollView) so the focus layout's jump strip scrolls it to the pick. */
+declare function HealthPlanScrollScope({ scrollRef, children, style }: HealthPlanScrollScopeProps): ReactNode;
+
 /** One row: the words before the blank, the value (null: still a blank), the words after it, and its source line. */
 interface HealthPlanBlanksRow {
     readonly key: string;
@@ -291,4 +332,16 @@ interface HealthPlanBlanksProps {
 }
 declare function HealthPlanBlanks(props: HealthPlanBlanksProps): ReactNode;
 
-export { EverfurError, EverfurHealthPlan, type EverfurHealthPlanProps, EverfurPresentationInput, EverfurResult, HEALTH_PLAN_FOCUS_RN_COPY, HealthPlanBlanks, HealthPlanBlanksFacts, type HealthPlanBlanksProps, type HealthPlanBlanksRow, HealthPlanCardOptions, HealthPlanCart, HealthPlanCartBar, type HealthPlanCartBarProps, HealthPlanCheckoutProvider, HealthPlanFocus, type HealthPlanFocusCheckoutRow, HealthPlanFocusCopy, HealthPlanFocusDesign, HealthPlanFocusIcon, type HealthPlanFocusProps, type HealthPlanFocusRnCopy, type HealthPlanFocusRnOptions, type HealthPlanFocusRnOverlay, type HealthPlanFocusRnOverlayControls, HealthPlanImageVariant, HealthPlanItem, HealthPlanItemCard, type HealthPlanItemCardProps, HealthPlanLayoutProps, HealthPlanOneBoxOrder, HealthPlanPageRepository, type HealthPlanPetWords, HealthPlanPriceFormat, HealthPlanReasonVariant, type HealthPlanRecordsReader, HealthPlanShopOrder, HealthPlanSubscription, HealthPlanSubscriptionRepository, LifecyclePort, PetRef, RecordsRecordWire, healthPlanPetCopy, healthPlanPossessive };
+interface UseHealthPlanTopCardOptions extends HealthPlanTopCardOptions {
+    readonly petRef: PetRef | null;
+    /** False skips the page read (and the card). Defaults to true. */
+    readonly enabled?: boolean;
+}
+/**
+ * The chat's top card for one pet, from its Health Plan page; undefined while the page loads, on a refused read, or
+ * when the page has no focus. Keep `onOpenPlan`, `copy` and `renderIcon` stable (module constants or memoised), so the
+ * card is rebuilt only when the page changes.
+ */
+declare function useHealthPlanTopCard(options: UseHealthPlanTopCardOptions): EverfurChatTopCard | undefined;
+
+export { EverfurChatTopCard, EverfurError, EverfurHealthPlan, type EverfurHealthPlanProps, EverfurPresentationInput, EverfurResult, HEALTH_PLAN_FOCUS_RN_COPY, HealthPlanBlanks, HealthPlanBlanksFacts, type HealthPlanBlanksProps, type HealthPlanBlanksRow, HealthPlanCardOptions, HealthPlanCart, HealthPlanCartBar, type HealthPlanCartBarProps, HealthPlanCheckoutProvider, HealthPlanEmptyCopy, HealthPlanFocus, type HealthPlanFocusCheckoutRow, HealthPlanFocusCopy, HealthPlanFocusDesign, HealthPlanFocusIcon, type HealthPlanFocusProps, type HealthPlanFocusRnCopy, type HealthPlanFocusRnOptions, type HealthPlanFocusRnOverlay, type HealthPlanFocusRnOverlayControls, HealthPlanImageVariant, HealthPlanItem, HealthPlanItemCard, type HealthPlanItemCardProps, HealthPlanLayoutProps, HealthPlanOneBoxOrder, HealthPlanPageRepository, type HealthPlanPetWords, HealthPlanPriceFormat, HealthPlanReasonVariant, type HealthPlanRecordsReader, HealthPlanScrollScope, type HealthPlanScrollScopeProps, type HealthPlanScrollable, HealthPlanShopOrder, HealthPlanSubscription, HealthPlanSubscriptionRepository, HealthPlanTopCardOptions, HealthPlanTopRisk, type HealthPlanTopRiskProps, LifecyclePort, PetRef, RecordsRecordWire, type UseHealthPlanTopCardOptions, healthPlanPetCopy, useHealthPlanTopCard };