@everfur/sdk 0.15.1 → 0.16.0

package/CHANGELOG.md

@@ -10,6 +10,128 @@ changes that has not been earned by any production integration yet.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-10-24
+
+This release covers the React Native parity work: the React Native chat, tabs, Health Plan, shop, records and
+texting now follow the web. Web output is unchanged.
+
+### Added
+
+- **Chat dictation (React Native).** `registerEverfurDictation(loader)` turns on the composer mic. The loader returns
+  the optional peer `expo-speech-recognition` (version 1 or later); without it the mic is not drawn. A registration
+  made after the chat mounts is picked up. New export `EverfurDictationLoader`.
+- **Chat opening card and empty header (React Native).** `ask(prompt, card)` and the `initialAskCard` prop show the
+  same opening card as the web, and `renderEmptyHeader` draws above an empty thread. New exports
+  `EverfurChatOpeningCard` (also from `@everfur/sdk/tabs`), `EverfurChatEmptyHeaderContext` and `ChatFollowUpPolicy`
+  (the `followUpPolicy` prop). The opening card takes `styles` (card, icon, kicker, title, body), and
+  `answerCards.styles` adds `feedback`, `feedbackChip`, `feedbackChipText`, `followUps`, `followUpsLabel`,
+  `followUp`, `followUpText`, `followUpAction` and `followUpActionText`: the web's `classNames` as React Native styles.
+- **Chat foreground re-read (React Native).** `createAppStateLifecycle()` builds a lifecycle from `AppState`.
+- **Health Plan (React Native).** `HealthPlanTopRisk`, `useHealthPlanTopCard` and the top card exports,
+  `HealthPlanScrollScope`, `focus.trackingTexts`, `onAvailability`, `onAsk`, `emptyCopy` (`HealthPlanEmptyCopy`),
+  `healthPlanPetWords` (`HealthPlanPetPronouns`), and re-exports of the subscription hooks and mappers.
+- **Shop cart storage (React Native).** `EverfurShop` takes `cartStorageKey`. The cart and checkout are kept in the
+  `KvPort`.
+- **Records (React Native).** `recordsSheet` and `RECORDS_SHEET_ROW_BUTTON_STYLE`, and the `EverfurRecords` props
+  `renderUpcomingCareAction`, `noVet`, `weightUnit`, `onOpenPlan`, `onOpenScreenings`, `onRequestFromClinic`,
+  `onNavigate` and `alwaysShowWays`. The sheet takes the `raph` palette, fonts, `topRiskLine` and `stage`, and gains
+  the care timeline and the medications, history and weight cards, `RequestDocumentsList`, and pull to refresh.
+
+### Changed
+
+- **Chat re-reads in the foreground by default (React Native).** The chat and the tabs re-read the thread when the app
+  comes back to the foreground. Pass `lifecycle={null}` to opt out. In the tabs a hidden Ask pane does not re-read.
+- **Chat copy matches the web (React Native).** The footnote is the web footnote, a failed turn uses the web title,
+  and the vet chip reads "Book a video visit".
+- **Chat behaviour matches the web (React Native).** `answer_footer` is drawn outside the tabs too. Non-urgent banners
+  no longer alert. Past check-ins render as plain rows. New chat sits in the chat header. The WORSE check-in tries the
+  vet visit first. `maxPerMessage` defaults to 5. A top card with no `closeLabel` draws no close. One pet with
+  `onAddPet` opens the switcher. `onOpenHealthPlan` receives the pet.
+- **Chat look matches the web (React Native).** The texting line puts the name over its bubble and its two answers
+  side by side as pills. Footer controls are spaced as on the web, and the cards style draws no footer under the
+  member's question. The footnote in the thread is left-aligned at the caption size. The failed-turn notice uses the
+  web's cream card and body-face title, and no longer takes the `card` slot.
+- **Records session-required state (React Native).** The sheet, dashboard, requests, request and document screens
+  show a session-required state when there is no session. Hosts that mount Records before sign-in now see it.
+  The consent screen has one sign-mode toggle and Cancel, and the consent gate is no longer a dead end.
+- **Health Plan and shop (React Native).** `onAvailabilityChange` is deprecated for `onAvailability`. Loading shows a
+  skeleton. Buy controls are always drawn and are disabled when unpriced. Order steps are always 4. The weight limit
+  is 90 kg. A dev warning shows when the shop is on with no return URL.
+- **Shared types.** The chat opening card, empty header and top card shapes, and the Health Plan top card helpers,
+  now live in one shared module for web and React Native. Public type names are unchanged.
+
+### Fixed
+
+- **Chat dictation (React Native).** Dictation stops when the conversation changes and when the Ask pane is hidden.
+  The draft is not written while dictating. The dictation error line and the feedback failed note are announced on
+  iOS and are a live region on Android.
+- **Chat (React Native).** A refused thumb shows the feedback failed note. An empty reasons submit sends nothing.
+  Load earlier keeps the reading position.
+- **Health Plan (React Native).** A failed return shows a toast.
+- **Texting (React Native).** The pop-up scrolls, avoids the keyboard and works in both orientations, its text is
+  centred, and announcements reach iOS. Buttons are 44 high, the pill edge changes colour on focus, and the opt-in card shows a
+  busy state. The entry's placeholders are grey, and focus moves to the code field on the code step.
+
+## [0.15.6] - 2026-10-24
+
+### Fixed
+
+- **Shop: an order whose payment failed no longer reads confirmed.** Under "Payment failed" the order page drew the
+  status line too ("Confirmed, sending to the pharmacy" for an order waiting to be placed). The line is now left out
+  while the payment has failed or still waits for the member. Web and React Native. No new copy.
+- **Shop: Paid with only on a paid order.** The card row showed on unpaid, voided and failed orders. It now shows only
+  once the payment is authorized or captured. Web and React Native. No new copy.
+- **Shop: the cart drops the placed lines before the card step opens.** A checkout that needs 3-D Secure left the
+  lines in the cart when the in-app browser or the redirect did not hand back. `confirmWithPayerActions` takes a
+  `beforePayerAction` hook, and the cart checkout empties the placed lines there. Web and React Native.
+
+## [0.15.5] - 2026-10-24
+
+### Fixed
+
+- **Shop: no stale card line on a paid order (React Native).** When the bank's 3-D Secure step finished but the
+  in-app browser closed before it handed back, the order page still said the card was not verified although the
+  order already held the payment. The order page now drops that line once the order reads authorized or captured
+  and has nothing left to pay. No new copy.
+
+## [0.15.4] - 2026-10-24
+
+### Fixed
+
+- **Shop: Buy again on an Rx-only order (React Native).** A delivered or ended order that holds only Rx items now
+  offers Buy again, which opens the product page (where the prescription is chosen), as the web order page already
+  did. A mixed order still puts only its items with no prescription back in the cart.
+
+## [0.15.3] - 2026-10-23
+
+### Fixed
+
+- **Shop: the order headline says its status once (web and React Native).** A shipped order with no arrival date
+  showed "Shipped" as the headline and again as the line under it. A status line that repeats the headline is no
+  longer drawn.
+- **Shop: Buy again only on an order that is over (web and React Native).** Buy again shows on a delivered order and on
+  one that ended without arriving (cancelled, not approved, being looked into). An order still on its way (in review,
+  being prepared, shipped) no longer offers it.
+- **Shop: no main landmark inside the host's (web).** The cart, orders, order and placed pages drew their own `<main>`
+  inside the host page's `<main>`. They now use a plain container; the host page owns the landmark.
+
+## [0.15.2] - 2026-10-23
+
+### Fixed
+
+- **Shop: the order pages read again (web and React Native).** An order and the orders list read again behind what is
+  drawn, with no loading state, when the app comes back from the background on React Native (`AppState`) and when the
+  tab becomes visible again on the web (`visibilitychange`). A burst of signals makes one request, a read already in
+  flight is joined, and a failed re-read keeps the page shown. The list does not re-read once older pages are loaded.
+  On React Native the order and orders screens also refresh on a pull (`RefreshControl`).
+- **Shop: a refused cancel reads the order again (web and React Native).** When the OMS refuses a cancel (the order
+  shipped or was already cancelled), the order is read again so Cancel goes when it no longer applies.
+- **Shop: the refund row counts only refunds that succeeded (web and React Native).** A pending or failed refund no
+  longer adds to the amount shown.
+- **Shop: a prescription that cannot be filled right now (web and React Native).** The product page for a prescription
+  that is `being_prepared` (an open order is using it) or `too_soon` (filled too recently) now says the pet has a
+  prescription with the `rxBeingPrepared` or `rxTooSoon` line, instead of "No prescription on file" with Book a visit.
+
 ## [0.15.1] - 2026-10-23
 
 This patch changes packaging and documentation for the Everfur SDK License version 2.1, and carries the Records,

package/dist/{DepthViews.d-BuEWI6Ln.d.ts → DepthViews.d-A7S-XYiI.d.ts}

@@ -1,6 +1,6 @@
 /*! @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 { CSSProperties, ReactNode } from 'react';
-import { c as RecordsScreenBaseProps } from './screenProps.d-BuJLzFkN.js';
+import { c as RecordsScreenBaseProps } from './screenProps.d-D9n-ancr.js';
 
 interface EverfurRecordsDepthProps extends Pick<RecordsScreenBaseProps, 'petRef' | 'petName' | 'onNavigate' | 'onBack'> {
     readonly style?: CSSProperties;

package/dist/{DepthViews.d--1daZblh.d.cts → DepthViews.d-C4TIZDfz.d.cts}

@@ -1,6 +1,6 @@
 /*! @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 { CSSProperties, ReactNode } from 'react';
-import { c as RecordsScreenBaseProps } from './screenProps.d-C-AuHoyF.cjs';
+import { c as RecordsScreenBaseProps } from './screenProps.d-CR1lrpzR.cjs';
 
 interface EverfurRecordsDepthProps extends Pick<RecordsScreenBaseProps, 'petRef' | 'petName' | 'onNavigate' | 'onBack'> {
     readonly style?: CSSProperties;

package/dist/{DepthViews.d-CKTnEeUo.d.ts → DepthViews.d-CNjaHLAS.d.ts}

@@ -1,7 +1,7 @@
 /*! @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 { StyleProp, ViewStyle } from 'react-native';
-import { c as RecordsScreenBaseProps } from './screenProps.d-BuJLzFkN.js';
+import { c as RecordsScreenBaseProps } from './screenProps.d-D9n-ancr.js';
 
 interface EverfurRecordsDepthProps extends Pick<RecordsScreenBaseProps, 'petRef' | 'petName' | 'onNavigate' | 'onBack'> {
     readonly style?: StyleProp<ViewStyle>;

package/dist/{DepthViews.d-PuBGdAYk.d.cts → DepthViews.d-DapfRz1S.d.cts}

@@ -1,7 +1,7 @@
 /*! @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 { StyleProp, ViewStyle } from 'react-native';
-import { c as RecordsScreenBaseProps } from './screenProps.d-C-AuHoyF.cjs';
+import { c as RecordsScreenBaseProps } from './screenProps.d-CR1lrpzR.cjs';
 
 interface EverfurRecordsDepthProps extends Pick<RecordsScreenBaseProps, 'petRef' | 'petName' | 'onNavigate' | 'onBack'> {
     readonly style?: StyleProp<ViewStyle>;

package/dist/{RecordsPage.d-CBB8sfoY.d.ts → RecordsPage.d-6WMbieaV.d.ts}

@@ -3,7 +3,7 @@ import { CSSProperties, ReactNode } from 'react';
 import { R as RecordsClinicController, C as CaptureRecordsSignature } from './clinicRequestProps.d-CjsMg_OD.js';
 import { R as RecordsController } from './useRecords.d-DWk61a4c.js';
 import { c as RecordForwardItem } from './models.d-DOwnr8fi.js';
-import { c as RecordsScreenBaseProps } from './screenProps.d-BuJLzFkN.js';
+import { c as RecordsScreenBaseProps } from './screenProps.d-D9n-ancr.js';
 import { E as EverfurRecordsSheet } from './sheetSeam.d-B09jf4YC.js';
 
 interface EverfurRecordsPageProps extends RecordsScreenBaseProps {

package/dist/{RecordsPage.d-Dq5gpQG0.d.cts → RecordsPage.d-B2gLf8RH.d.cts}

@@ -3,7 +3,7 @@ import { CSSProperties, ReactNode } from 'react';
 import { R as RecordsClinicController, C as CaptureRecordsSignature } from './clinicRequestProps.d-1dCtouGA.cjs';
 import { R as RecordsController } from './useRecords.d-BYNX01El.cjs';
 import { c as RecordForwardItem } from './models.d-BSqvbTE1.cjs';
-import { c as RecordsScreenBaseProps } from './screenProps.d-C-AuHoyF.cjs';
+import { c as RecordsScreenBaseProps } from './screenProps.d-CR1lrpzR.cjs';
 import { E as EverfurRecordsSheet } from './sheetSeam.d-BBuEIVsa.cjs';
 
 interface EverfurRecordsPageProps extends RecordsScreenBaseProps {

package/dist/animations/index.d.cts

@@ -2,8 +2,8 @@
 import { ReactNode } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { E as EverfurResult } from '../EverfurResult.d-BFH-3s6E.cjs';
-import { A as AuthContext } from '../identity.d-HbwYQ4-z.cjs';
-export { I as IdentityProvider, n as newSessionId } from '../identity.d-HbwYQ4-z.cjs';
+import { A as AuthContext } from '../identity.d-nRZBzkG2.cjs';
+export { I as IdentityProvider, n as newSessionId } from '../identity.d-nRZBzkG2.cjs';
 import { P as PetRef } from '../ids.d-B2GAAifq.cjs';
 export { B as Brand, U as UserRef, _ as __brand } from '../ids.d-B2GAAifq.cjs';
 import { z } from 'zod';
@@ -14,7 +14,7 @@ import { E as EverfurError } from '../EverfurError.d-8NHtlgzA.cjs';
 export { a as EverfurErrorCategory, b as EverfurErrorCode } from '../EverfurError.d-8NHtlgzA.cjs';
 import { D as DisabledLevel, a as CapabilityDecision } from '../resolve.d-CoQWUy1Y.cjs';
 export { b as CapabilityDisabled, C as CapabilityName } from '../resolve.d-CoQWUy1Y.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';
+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';
 
 /**
  * The full /state payload. `degraded` + `cache_epoch` + `cache_key` are additive fields an older backend
@@ -134,7 +134,7 @@ declare const petStateResponseWireSchema: z.ZodObject<{
     degraded: z.ZodDefault<z.ZodBoolean>;
     cache_epoch: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    category: "idle" | "health" | "attention" | "moment" | "activity" | "mood";
+    category: "idle" | "mood" | "health" | "attention" | "moment" | "activity";
     idle: "bundled";
     tiers: {
         image?: {
@@ -165,7 +165,7 @@ declare const petStateResponseWireSchema: z.ZodObject<{
     degraded: boolean;
     cache_epoch: number;
 }, {
-    category: "idle" | "health" | "attention" | "moment" | "activity" | "mood";
+    category: "idle" | "mood" | "health" | "attention" | "moment" | "activity";
     ttl_seconds: number;
     idle?: "bundled" | undefined;
     tiers?: {

package/dist/animations/index.d.ts

@@ -2,8 +2,8 @@
 import { ReactNode } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { E as EverfurResult } from '../EverfurResult.d-D_-254ZY.js';
-import { A as AuthContext } from '../identity.d-Be2Es9Td.js';
-export { I as IdentityProvider, n as newSessionId } from '../identity.d-Be2Es9Td.js';
+import { A as AuthContext } from '../identity.d-DxNvhj3a.js';
+export { I as IdentityProvider, n as newSessionId } from '../identity.d-DxNvhj3a.js';
 import { P as PetRef } from '../ids.d-B2GAAifq.js';
 export { B as Brand, U as UserRef, _ as __brand } from '../ids.d-B2GAAifq.js';
 import { z } from 'zod';
@@ -14,7 +14,7 @@ import { E as EverfurError } from '../EverfurError.d-8NHtlgzA.js';
 export { a as EverfurErrorCategory, b as EverfurErrorCode } from '../EverfurError.d-8NHtlgzA.js';
 import { D as DisabledLevel, a as CapabilityDecision } from '../resolve.d-CoQWUy1Y.js';
 export { b as CapabilityDisabled, C as CapabilityName } from '../resolve.d-CoQWUy1Y.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';
+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';
 
 /**
  * The full /state payload. `degraded` + `cache_epoch` + `cache_key` are additive fields an older backend
@@ -134,7 +134,7 @@ declare const petStateResponseWireSchema: z.ZodObject<{
     degraded: z.ZodDefault<z.ZodBoolean>;
     cache_epoch: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    category: "idle" | "health" | "attention" | "moment" | "activity" | "mood";
+    category: "idle" | "mood" | "health" | "attention" | "moment" | "activity";
     idle: "bundled";
     tiers: {
         image?: {
@@ -165,7 +165,7 @@ declare const petStateResponseWireSchema: z.ZodObject<{
     degraded: boolean;
     cache_epoch: number;
 }, {
-    category: "idle" | "health" | "attention" | "moment" | "activity" | "mood";
+    category: "idle" | "mood" | "health" | "attention" | "moment" | "activity";
     ttl_seconds: number;
     idle?: "bundled" | undefined;
     tiers?: {

package/dist/{Chat.d-BlsnQwCQ.d.ts → appStateLifecycle.d-B7L427MF.d.ts}

@@ -3,143 +3,18 @@ import { ReactNode } from 'react';
 import { StyleProp, ViewStyle } from 'react-native';
 import { P as PetRef, C as ConversationId } from './ids.d-B2GAAifq.js';
 import { i as EverfurPresentationInput } from './presentation.d-vy8kTGfR.js';
-import { a as ChatCheckinTarget } from './ports.d-DzEJMVRs.js';
-import { W as WidgetPet, P as PetProfileInput } from './petsRepository.d-DUaAWoTv.js';
+import { a as ChatCheckinTarget } from './ports.d-BxCVSbSi.js';
+import { W as WidgetPet, P as PetProfileInput } from './petsRepository.d-BtuooSOW.js';
 import { E as EverfurStarterPrompt } from './quickPrompts.d-NM_81Jc1.js';
 import { L as LifecyclePort } from './LifecyclePort.d-Cr1p33a7.js';
-import { U as UrgencyDisplayLevel, E as EverfurChatDraftStore } from './attachments.d-DFP9yvz9.js';
+import { U as UrgencyDisplayLevel, E as EverfurChatDraftStore, b as ChatFollowUpPolicy } from './attachments.d-CB0R1_vK.js';
 import { F as FileHandle } from './ports.d-BX4f4UsB.js';
+import { g as EverfurChatOpeningCard, a as EverfurChatAnswerCards, f as EverfurChatHistorySheet, e as EverfurChatHistoryBar, c as EverfurChatEmptyState } from './threadOptions.d-BerQM1Ql.js';
+import { a as EverfurChatEmptyHeaderContext, b as EverfurChatTopCard } from './threadOptions.d-6hfQS1x7.js';
 
 /** Where a picked image comes from: the host's photo library, or its camera. */
 type AttachmentSource = 'photo' | 'camera';
 
-/**
- * The history bar: a "Chats" control with the member's thread count that opens the history, and a "New chat"
- * control. For a surface that hides the SDK header and still wants the member's past chats.
- */
-interface EverfurChatHistoryBar {
-    /** The history control's words ("Chats"). */
-    readonly chats: string;
-    /** The new-chat control's words ("New chat"). */
-    readonly newChat: string;
-    /** Draw the two icons your way. */
-    readonly renderIcon?: (icon: 'history' | 'edit') => ReactNode;
-    /** Your own control after "Chats". Absent, nothing is drawn. */
-    readonly extra?: ReactNode;
-}
-/** The empty thread's own title and chip fills. Absent, the empty state is Everfur's own. */
-interface EverfurChatEmptyState {
-    /** The title over the starter chips, in place of "What can we help {pet} with today?". */
-    readonly title?: string;
-    /**
-     * Fills for the chips that bring none of their own, taken in turn (the first chip the first fill, and round
-     * again). Each is a fill and its ink. Absent, Raph's v3 cycle on a light theme; empty, the theme's paint.
-     */
-    readonly chipTints?: readonly {
-        readonly tint: string;
-        readonly ink?: string;
-    }[];
-}
-/** One card under an answer in the cards answer style: a record, a stat, or a link to one of your screens. */
-interface EverfurChatAnswerCard {
-    /** Stable key within the answer. */
-    readonly key: string;
-    readonly title: string;
-    /** The small line under the title. */
-    readonly meta?: string;
-    /** A status pill. */
-    readonly pill?: {
-        readonly label: string;
-        readonly tone?: string;
-    };
-    /** A stat card's value: drawn in place of the pill and the chevron. */
-    readonly value?: {
-        readonly amount: string;
-        readonly unit?: string;
-    };
-    /** The tile at the start: an icon of yours, or an https image. */
-    readonly tile?: {
-        readonly icon?: ReactNode;
-        readonly imageUrl?: string;
-        readonly tone?: string;
-    };
-    readonly variant?: string;
-    /** Given, the card is a button that calls this. Absent, a static card. */
-    readonly onPress?: () => void;
-    /** A card of your own, drawn in the card's place. If it throws, the slot draws nothing. */
-    readonly render?: () => ReactNode;
-}
-/** What `answerCards.cards` receives: the settled answer's text and the question it answered. */
-interface EverfurChatAnswerContext {
-    readonly answer: string;
-    readonly question: string | null;
-    /** The answer's message id, stable for the life of the thread. */
-    readonly messageId: string;
-}
-/** The cards answer style's content (used while presentation `chatAnswerStyle` is `cards`). The words are yours. */
-interface EverfurChatAnswerCards {
-    /** The line over each answer (an icon and your words). Absent, the assistant's name line. */
-    readonly byline?: {
-        readonly label: string;
-        readonly icon?: ReactNode;
-    };
-    /** Your cards under a settled answer. A throw draws none. */
-    readonly cards?: (context: EverfurChatAnswerContext) => readonly EverfurChatAnswerCard[];
-    /** Two feedback chips in place of the footer's thumbs, mapped to thumbs up and thumbs down. */
-    readonly feedback?: {
-        readonly helpful: string;
-        readonly notHelpful: string;
-    };
-    /** Your own rows at the top of the follow-ups, for the answer it receives. */
-    readonly followUpActions?: (context: EverfurChatAnswerContext) => readonly EverfurChatFollowUpAction[];
-    /** Draw the chevron your way. Absent, Everfur's glyph. */
-    readonly renderIcon?: (icon: 'chevron') => ReactNode;
-}
-/** A row of yours at the top of the follow-ups under an answer. */
-interface EverfurChatFollowUpAction {
-    readonly key: string;
-    readonly label: string;
-    readonly icon?: ReactNode;
-    readonly onPress: () => void;
-}
-/**
- * The card at the top of the empty thread (presentation `chatTopCard: "focus"`): one finding, in your words, with
- * an action of yours and a question it can ask in the thread. Its close control folds it into a pill.
- */
-interface EverfurChatTopCard {
-    /** The small heading ("Her focus"). */
-    readonly kicker: string;
-    /** A source badge ("<your brand> results"). */
-    readonly badge?: string;
-    readonly title: string;
-    /** The finding: a bold lead and the rest of the sentence. */
-    readonly lead?: string;
-    readonly body?: string;
-    /** Your action ("See her Health Plan"). */
-    readonly action?: {
-        readonly label: string;
-        readonly onPress: () => void;
-    };
-    /** A question the card asks in this thread. */
-    readonly ask?: {
-        readonly label: string;
-        readonly prompt: string;
-    };
-    /** The close control's accessible name. Absent, the shared `Close`. */
-    readonly closeLabel?: string;
-    /** The pill's words while the card is closed (defaults to `kicker`). */
-    readonly pill?: string;
-    /** Draw the close glyph your way. */
-    readonly renderIcon?: (icon: 'close') => ReactNode;
-}
-/** The history bottom sheet (presentation `chatHistoryStyle: "sheet"`). */
-interface EverfurChatHistorySheet {
-    /** The sheet's small title ("Chats with Ask <your brand>"). Absent, Everfur's history heading. */
-    readonly title?: string;
-    /** Draw the icons your way. */
-    readonly renderIcon?: (icon: 'close' | 'chat' | 'edit') => ReactNode;
-}
-
 /**
  * The host's image picker for chat attachments. The SDK depends on no picker or camera module: open your own
  * (for example `expo-image-picker`'s `launchImageLibraryAsync({ mediaTypes: ['images'] })`, or your camera
@@ -155,7 +30,7 @@ interface EverfurChatAttachments {
     readonly pick: (source: AttachmentSource) => Promise<FileHandle | readonly FileHandle[] | null>;
     /** The sources to offer, one popover tile each; default `['photo']`. */
     readonly sources?: readonly AttachmentSource[];
-    /** Images per message; default 1 (the app's composer), at most 5 (the server's cap). */
+    /** Images per message; default 5, the web composer's and the server's cap. */
     readonly maxPerMessage?: number;
 }
 
@@ -235,10 +110,12 @@ interface EverfurChatProps {
      * Your app's lifecycle signals. Everfur has no socket and no polling here, so a message the platform
      * writes into the thread (a follow-up check-in, a reminder) is not visible until something re-reads it.
      * Tell Everfur when your app comes back to the foreground, when connectivity returns and when a push
-     * announced a change, and the thread and the unread dot catch up on that signal alone. Without this, chat
-     * refreshes only when the user does something.
+     * announced a change, and the thread and the unread dot catch up on that signal alone. Absent, Everfur uses
+     * React Native's own signal (AppState returning to `active` from the background; see `createAppStateLifecycle`).
+     * Pass your own port to add connectivity or a push announcement, or `null` to turn the re-read off, in which
+     * case chat refreshes only when the user does something.
      */
-    readonly lifecycle?: LifecyclePort;
+    readonly lifecycle?: LifecyclePort | null;
     /**
      * Your own storage for an unsent draft. Given, what the user typed and did not send survives leaving this
      * screen; absent, the draft lives in memory for as long as the surface is mounted and nowhere else.
@@ -290,19 +167,47 @@ interface EverfurChatProps {
     /**
      * The layout settings (Raph v3): the answer style, the history style, the top card, the composer style and
      * placeholder, the history bar's place, the general banner, the send button, the follow-up count and the upload
-     * control. Each also comes from your console (render_hints.branding.presentation); a field you set here wins
-     * unless the console locks it. `attachments` counts as your explicit `chatComposerUpload: true`. The microphone
-     * setting (`chatComposerMic`) has no control on this surface. `topCard`, `answerCards` and `historySheet` are
-     * content only and never switch a layout on by themselves.
+     * control, and the microphone (`chatComposerMic`). Each also comes from your console
+     * (render_hints.branding.presentation); a field you set here wins unless the console locks it. `attachments` counts
+     * as your explicit `chatComposerUpload: true`, `dictation` as your `chatComposerMic` and `followUpPolicy` as your
+     * follow-up count. `topCard`, `answerCards` and `historySheet` are content only and never switch a layout on by
+     * themselves.
      */
     readonly presentation?: EverfurPresentationInput;
+    /**
+     * Voice dictation on the composer (the device's own speech recognizer, no Everfur service). On by default; the
+     * control appears only when your app has the optional `expo-speech-recognition` module installed and the device
+     * has a recognizer. `false` is the kill switch.
+     */
+    readonly dictation?: boolean;
+    /**
+     * Your own content for the top of the empty thread, above its title and starter chips (for example a card of the
+     * pet's top findings). Rendered only while the thread is empty; if it throws, the empty state draws as usual.
+     * Absent, the empty state is Everfur's own. It receives `{ ask }`: a row of your card can ask its question in
+     * this thread directly, with no screen in between.
+     */
+    readonly renderEmptyHeader?: (context: EverfurChatEmptyHeaderContext) => ReactNode;
+    /**
+     * Your rule for the follow-ups under a reply: how many (exactly, with `fill`), which backend prompts to drop
+     * (`exclude`, for example visit or booking prompts you do not offer), your own prompts to top up with, and a
+     * visible `label` over them. Absent, at most three of the backend's, as before.
+     */
+    readonly followUpPolicy?: ChatFollowUpPolicy;
+    /**
+     * The card a notification-opened thread starts with: drawn in place of the first bubble while that bubble is
+     * `initialAsk`. Pair it with `initialAsk` (the notification's question). Absent, the bubble draws as usual.
+     */
+    readonly initialAskCard?: EverfurChatOpeningCard;
     /**
      * The focus card's content (drawn while `chatTopCard` resolves to `focus`). Absent, the card is built from the
      * pet's Health Plan page focus; no page, no focus, a refused read or a page still loading draws no card.
      */
     readonly topCard?: EverfurChatTopCard;
-    /** Opens the pet's Health Plan (your tab or screen): the plan-built focus card's `See her Health Plan` button. */
-    readonly onOpenHealthPlan?: () => void;
+    /**
+     * Opens the pet's Health Plan (your tab or screen), called with the pet (the chat's `petRef`, else the provider's
+     * active pet): the plan-built focus card's `See her Health Plan` button.
+     */
+    readonly onOpenHealthPlan?: (petRef: PetRef | null) => void;
     /** The cards answer style's content (used while `chatAnswerStyle` resolves to `cards`). */
     readonly answerCards?: EverfurChatAnswerCards;
     /** The history sheet's title and icons (used while `chatHistoryStyle` resolves to `sheet`). */
@@ -335,4 +240,22 @@ interface EverfurChatProps {
  */
 declare function EverfurChat(props: EverfurChatProps): ReactNode;
 
-export { type AttachmentSource as A, EverfurChat as E, type RenderVetAction as R, type EverfurChatAnswerCard as a, type EverfurChatAnswerCards as b, type EverfurChatAnswerContext as c, type EverfurChatAttachments as d, type EverfurChatEmptyState as e, type EverfurChatFollowUpAction as f, type EverfurChatHistoryBar as g, type EverfurChatHistorySheet as h, type EverfurChatProps as i, type EverfurChatTopCard as j };
+/** The host's loader: a thunk that requires the expo-speech-recognition module and returns it. */
+type EverfurDictationLoader = () => unknown;
+/**
+ * Turns on the chat composer's microphone on React Native: register the optional `expo-speech-recognition` module's
+ * loader once, in your app entry.
+ *
+ * Pass a thunk that requires the expo-speech-recognition module and returns it; the chat docs ("Dictation") show the
+ * exact line.
+ *
+ * Without it, or where the module has no native side (Expo Go, an older binary), the composer draws no microphone.
+ * Passing `null` unregisters it. Registering clears the memo, so a later registration always wins, and a composer
+ * already on screen re-reads it (best practice is still to register before the first chat renders).
+ */
+declare function registerEverfurDictation(next: EverfurDictationLoader | null): void;
+
+/** The app's foreground edge for EverfurChat: AppState going from `background` back to `active`. */
+declare function createAppStateLifecycle(): LifecyclePort;
+
+export { type AttachmentSource as A, EverfurChat as E, type RenderVetAction as R, type EverfurChatAttachments as a, type EverfurChatProps as b, type EverfurDictationLoader as c, createAppStateLifecycle as d, registerEverfurDictation as r };