@everfur/sdk 0.1.0 → 0.3.0

package/dist/web/records/index.d.cts

@@ -0,0 +1,194 @@
+import { R as RecordsController } from '../../view-C3qPIXGX.cjs';
+export { C as ClinicCall, F as FactOverlay, a as REQUEST_TIMELINE_TITLES, b as RecordSharesStatus, c as RecordsDashboardState, d as RecordsDashboardView, e as RecordsEmptyVariant, f as RecordsStatus, g as RequestTimelineEvent, h as RequestTimelineEventKey, i as RequestTimelineEventState, S as ShareRowView, U as UploadDocumentInput, j as UploadQueueItem, k as UploadSkipReason, l as UseEverfurRecordsState, m as UseRecordFactEditState, n as UseRecordPdfLinkState, o as UseRecordSharesState, p as UseRecordsMarkersState, q as applyFactOverlay, r as buildRequestTimeline, s as deriveRecordsDashboardState, t as isFactEditable, u as pickPetRecordsRequest, v as selectClinicCall, w as selectDashboardView, x as selectPrimaryLabel, y as selectRequestList, z as selectRequestTitle, A as useEverfurRecords, B as useEverfurRecordsClinic, D as useEverfurRecordsClinicBatch, E as useRecordFactEdit, G as useRecordPdfLink, H as useRecordShares, I as useRecordsMarkers } from '../../view-C3qPIXGX.cjs';
+import { CSSProperties, ReactNode, PointerEvent } from 'react';
+import { P as PetRef, R as RecordsRequestId } from '../../ids-B2GAAifq.cjs';
+export { B as Brand, D as DocumentId, _ as __brand } from '../../ids-B2GAAifq.cjs';
+import { d as RecordsHostSeams, i as RecordsClinicController, j as CaptureRecordsSignature, e as RecordsScreen, f as RecordsScreenBaseProps, C as ClinicDraft, k as ClinicRequestBaseProps, l as ClinicBatchBaseProps } from '../../useRecordsDepth-BHBzJ76R.cjs';
+export { m as CapturedRecordsSignature, a as ClinicLocation, n as RecordsAsk, R as RecordsAskEntityRef, b as RecordsAskHandler, c as RecordsDepthStatus, o as RecordsNavAction, p as RecordsNavState, q as RecordsSignatureContext, g as RecordsUrlKind, r as RegisterSignaturePng, s as currentRecordsScreen, t as initialRecordsNav, v as popRecordsNav, w as pushRecordsNav, x as recordsNavReducer, y as replaceRecordsNav, z as resetRecordsNav, A as transitionRecordsNav } from '../../useRecordsDepth-BHBzJ76R.cjs';
+import { d as RecordsRequestView } from '../../models-D2EUxPZY.cjs';
+export { h as ConsentState, C as CreateUploadRequestInput, G as GrantConsentInput, j as RECORDS_TERMINAL, R as RecordDocumentMeta, a as RecordEntity, k as RecordForwardItem, l as RecordIdentityField, b as RecordOrigin, m as RecordSeries, n as RecordSeriesPoint, i as RecordsDenialReason, f as RecordsRequestGroupView, c as RecordsRequestStatus, e as RecordsSimpleStatus, g as RecordsView, U as UploadedDocument, o as isTerminalStatus, r as recordsDenialReasonOf } from '../../models-D2EUxPZY.cjs';
+export { C as CreateClinicRequestBatchInput, a9 as CreateClinicRequestInput, w as FactFieldValue, z as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, A as RecordFactEditInput, B as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, D as RecordMarker, E as RecordMarkerLatest, G as RecordMarkerPoint, I as RecordMarkerSummary, J as RecordMarkersView, K as RecordPdfLink, k as RecordPhysicalExam, L as RecordShare, M as RecordShareLink, a8 as RecordsAuthorizationCopy, N as RecordsAuthorizationSignature, l as RecordsClinic, O as RecordsClinicBatch, P as RecordsClinicBatchClient, Q as RecordsClinicBatchItem, S as RecordsClinicBatchResult, a5 as RecordsClinicSearchInput, a6 as RecordsClinicSearchPage, T as RecordsClinicTarget, m as RecordsDepthClient, a7 as RecordsRecentClinicsInput, U as RecordsSignatureSuggestion, aa as RecordsSignatureUploadPolicy, n as RecordsTimelineMedication, o as RecordsTimelineVaccine, p as RecordsTimelineView, q as RecordsTimelineVisit, r as RecordsTimelineWeight } from '../../depth-CErXCU8J.cjs';
+export { a as EverfurDocumentContributionsProps, c as EverfurRecordsDepthProps } from '../../DepthViews-DbFhR4Du.cjs';
+import { U as UploadTransport, F as FileHandle } from '../../ports-BN6RHF9W.cjs';
+export { a as UploadPolicyWire } from '../../ports-BN6RHF9W.cjs';
+export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult } from '../../EverfurResult-DN9pL2Ab.cjs';
+import '../../requestFunnel-L-BQfi0z.cjs';
+import '../../ErrorPolicyPort-CNf4uQZP.cjs';
+import '../../config-CzTZGlfF.cjs';
+import '../../identity-DI4eVx9S.cjs';
+
+type RecordsHistoryMode = 'memory' | 'browser';
+interface EverfurRecordsProps extends RecordsHostSeams {
+    readonly petRef: PetRef;
+    /** The pet's display name for headers and lead copy; absent, the consumer's own `your pet` forms. */
+    readonly petName?: string;
+    /** Host/test seam: inject a records controller instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /** Host/test seam over the clinic controller. */
+    readonly clinicController?: RecordsClinicController;
+    /** The consent-text version the content-exposure grant records (host/product owned). */
+    readonly consentVersion?: string;
+    /** The owner's name the clinic authorization is signed with (the owner can correct it before signing). */
+    readonly ownerName?: string;
+    /** A host signature component for the clinic authorization, instead of the built-in canvas. */
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** The screen the flow starts on; the dashboard when omitted. */
+    readonly initialScreen?: RecordsScreen;
+    /** `memory` (default) keeps the stack in state; `browser` mirrors it onto the history stack. */
+    readonly historyMode?: RecordsHistoryMode;
+    /** The root screen's back control; absent, the root draws none. */
+    readonly onExit?: () => void;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    /** Your own placeholder while the entitlement verdict is pending on a cold mount. */
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsFlow(props: EverfurRecordsProps): ReactNode;
+/** The public prebuilt records surface: the flow, starting at the dashboard. */
+declare const EverfurRecords: typeof EverfurRecordsFlow;
+
+interface EverfurRecordsDashboardProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsDashboard(props: EverfurRecordsDashboardProps): ReactNode;
+
+interface EverfurRecordsRequestProps extends RecordsScreenBaseProps {
+    readonly requestId: RecordsRequestId;
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+    readonly nowMs?: number;
+}
+declare function EverfurRecordsRequest(props: EverfurRecordsRequestProps): ReactNode;
+
+interface EverfurRecordDetailProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDetail(props: EverfurRecordDetailProps): ReactNode;
+
+interface EverfurRecordDocumentProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDocument(props: EverfurRecordDocumentProps): ReactNode;
+
+interface EverfurRecordsConsentProps extends RecordsScreenBaseProps {
+    readonly clinic: ClinicDraft;
+    readonly ownerName?: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    readonly onCreated?: (request: RecordsRequestView) => void;
+    readonly controller?: RecordsClinicController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurRecordsConsent(props: EverfurRecordsConsentProps): ReactNode;
+
+interface EverfurClinicPickerProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsClinicController;
+    readonly recordsController?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicPicker(props: EverfurClinicPickerProps): ReactNode;
+
+interface EverfurRecordsUploadProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsUpload(props: EverfurRecordsUploadProps): ReactNode;
+
+interface EverfurClinicRequestProps extends ClinicRequestBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+/** Opt-in clinic release flow, reusing the consumer picker/scope/signature mechanics. */
+declare function EverfurClinicRequest(props: EverfurClinicRequestProps): ReactNode;
+
+interface EverfurClinicRequestBatchProps extends ClinicBatchBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicRequestBatch(props: EverfurClinicRequestBatchProps): ReactNode;
+
+interface WebRecordsUploadTransportOptions {
+    /**
+     * Test seam: the XMLHttpRequest constructor to use. Defaults to the global one. A host has no reason to
+     * set it.
+     */
+    readonly xhr?: () => XMLHttpRequest;
+}
+/**
+ * Create the browser records upload transport. Pass it as `uploadTransport` on the web `EverfurConfig`:
+ *
+ * ```tsx
+ * <EverfurProvider config={{ publishableKey, apiBaseUrl, uploadTransport: createWebRecordsUploadTransport() }} ...>
+ * ```
+ *
+ * It needs the picked file's bytes on `FileHandle.blob` (see `fileToHandle`). A handle with no blob rejects
+ * before any request is made.
+ */
+declare function createWebRecordsUploadTransport(options?: WebRecordsUploadTransportOptions): UploadTransport;
+
+/** The `accept` hint for the picker. A hint only: the signature check above is what decides. */
+declare const RECORDS_DOCUMENT_ACCEPT = "application/pdf,.pdf";
+/** True when the blob starts with the PDF signature. An unreadable blob is not a PDF. */
+declare function isPdfBlob(blob: Blob): Promise<boolean>;
+/**
+ * Build the records `FileHandle` for a browser `File` (or any Blob). `mimeType` is `application/pdf` only when
+ * the bytes carry the PDF signature; `sizeBytes` is the real size, so an oversize file is refused by the
+ * controller before initiate as well.
+ */
+declare function fileToHandle(file: Blob): Promise<FileHandle>;
+/**
+ * The same gate the controller applies before initiate (PDF, 0 < size <= 25 MiB), for a surface that must
+ * decide BEFORE it creates a request: a refused file should not leave an empty request behind.
+ */
+declare function isUploadableHandle(handle: FileHandle): boolean;
+/**
+ * Open the browser's file chooser for one document and resolve its handle, or null when the user picks
+ * nothing. For a host that builds its own records UI on `useEverfurRecords`; the prebuilt surface renders its
+ * own input instead. Must be called from a user gesture (a click handler), or the browser blocks the chooser.
+ *
+ * The input is attached to the document while the chooser is open (Safari does not open a detached input)
+ * and removed once it settles. A browser that never fires `cancel` leaves the promise pending when the user
+ * dismisses the chooser; nothing is held but the closure.
+ */
+declare function pickDocument(doc?: Document): Promise<FileHandle | null>;
+
+interface SignatureCanvasState {
+    readonly canvas: React.RefObject<HTMLCanvasElement>;
+    readonly mode: 'draw' | 'type';
+    readonly typed: string;
+    readonly signed: boolean;
+    readonly setTyped: (value: string) => void;
+    readonly toggle: () => void;
+    readonly clear: () => void;
+    readonly onPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerMove: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerUp: () => void;
+    /** The consumer's initiate / direct S3 / complete chain over the current canvas; throws on failure. */
+    readonly register: (controller: RecordsClinicController, signal: AbortSignal) => Promise<{
+        readonly signatureId: string;
+    }>;
+}
+declare function useSignatureCanvas(onEdit?: () => void): SignatureCanvasState;
+declare function SignatureCanvas({ pad, disabled }: {
+    readonly pad: SignatureCanvasState;
+    readonly disabled: boolean;
+}): ReactNode;
+
+export { CaptureRecordsSignature, ClinicBatchBaseProps, ClinicDraft, ClinicRequestBaseProps, EverfurClinicPicker, type EverfurClinicPickerProps, EverfurClinicRequest, EverfurClinicRequestBatch, type EverfurClinicRequestBatchProps, type EverfurClinicRequestProps, EverfurRecordDetail, type EverfurRecordDetailProps, EverfurRecordDocument, type EverfurRecordDocumentProps, EverfurRecords, EverfurRecordsConsent, type EverfurRecordsConsentProps, EverfurRecordsDashboard, type EverfurRecordsDashboardProps, EverfurRecordsFlow, type EverfurRecordsProps, EverfurRecordsRequest, type EverfurRecordsRequestProps, EverfurRecordsUpload, type EverfurRecordsUploadProps, FileHandle, PetRef, RECORDS_DOCUMENT_ACCEPT, RecordsClinicController, RecordsController, type RecordsHistoryMode, RecordsHostSeams, RecordsRequestId, RecordsRequestView, RecordsScreen, RecordsScreenBaseProps, SignatureCanvas, type SignatureCanvasState, UploadTransport, type WebRecordsUploadTransportOptions, createWebRecordsUploadTransport, fileToHandle, isPdfBlob, isUploadableHandle, pickDocument, useSignatureCanvas };

package/dist/web/records/index.d.ts

@@ -0,0 +1,194 @@
+import { R as RecordsController } from '../../view-DtSPYpKa.js';
+export { C as ClinicCall, F as FactOverlay, a as REQUEST_TIMELINE_TITLES, b as RecordSharesStatus, c as RecordsDashboardState, d as RecordsDashboardView, e as RecordsEmptyVariant, f as RecordsStatus, g as RequestTimelineEvent, h as RequestTimelineEventKey, i as RequestTimelineEventState, S as ShareRowView, U as UploadDocumentInput, j as UploadQueueItem, k as UploadSkipReason, l as UseEverfurRecordsState, m as UseRecordFactEditState, n as UseRecordPdfLinkState, o as UseRecordSharesState, p as UseRecordsMarkersState, q as applyFactOverlay, r as buildRequestTimeline, s as deriveRecordsDashboardState, t as isFactEditable, u as pickPetRecordsRequest, v as selectClinicCall, w as selectDashboardView, x as selectPrimaryLabel, y as selectRequestList, z as selectRequestTitle, A as useEverfurRecords, B as useEverfurRecordsClinic, D as useEverfurRecordsClinicBatch, E as useRecordFactEdit, G as useRecordPdfLink, H as useRecordShares, I as useRecordsMarkers } from '../../view-DtSPYpKa.js';
+import { CSSProperties, ReactNode, PointerEvent } from 'react';
+import { P as PetRef, R as RecordsRequestId } from '../../ids-B2GAAifq.js';
+export { B as Brand, D as DocumentId, _ as __brand } from '../../ids-B2GAAifq.js';
+import { d as RecordsHostSeams, i as RecordsClinicController, j as CaptureRecordsSignature, e as RecordsScreen, f as RecordsScreenBaseProps, C as ClinicDraft, k as ClinicRequestBaseProps, l as ClinicBatchBaseProps } from '../../useRecordsDepth-BU-OhzH6.js';
+export { m as CapturedRecordsSignature, a as ClinicLocation, n as RecordsAsk, R as RecordsAskEntityRef, b as RecordsAskHandler, c as RecordsDepthStatus, o as RecordsNavAction, p as RecordsNavState, q as RecordsSignatureContext, g as RecordsUrlKind, r as RegisterSignaturePng, s as currentRecordsScreen, t as initialRecordsNav, v as popRecordsNav, w as pushRecordsNav, x as recordsNavReducer, y as replaceRecordsNav, z as resetRecordsNav, A as transitionRecordsNav } from '../../useRecordsDepth-BU-OhzH6.js';
+import { d as RecordsRequestView } from '../../models-B-Uh2LTf.js';
+export { h as ConsentState, C as CreateUploadRequestInput, G as GrantConsentInput, j as RECORDS_TERMINAL, R as RecordDocumentMeta, a as RecordEntity, k as RecordForwardItem, l as RecordIdentityField, b as RecordOrigin, m as RecordSeries, n as RecordSeriesPoint, i as RecordsDenialReason, f as RecordsRequestGroupView, c as RecordsRequestStatus, e as RecordsSimpleStatus, g as RecordsView, U as UploadedDocument, o as isTerminalStatus, r as recordsDenialReasonOf } from '../../models-B-Uh2LTf.js';
+export { C as CreateClinicRequestBatchInput, a9 as CreateClinicRequestInput, w as FactFieldValue, z as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, A as RecordFactEditInput, B as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, D as RecordMarker, E as RecordMarkerLatest, G as RecordMarkerPoint, I as RecordMarkerSummary, J as RecordMarkersView, K as RecordPdfLink, k as RecordPhysicalExam, L as RecordShare, M as RecordShareLink, a8 as RecordsAuthorizationCopy, N as RecordsAuthorizationSignature, l as RecordsClinic, O as RecordsClinicBatch, P as RecordsClinicBatchClient, Q as RecordsClinicBatchItem, S as RecordsClinicBatchResult, a5 as RecordsClinicSearchInput, a6 as RecordsClinicSearchPage, T as RecordsClinicTarget, m as RecordsDepthClient, a7 as RecordsRecentClinicsInput, U as RecordsSignatureSuggestion, aa as RecordsSignatureUploadPolicy, n as RecordsTimelineMedication, o as RecordsTimelineVaccine, p as RecordsTimelineView, q as RecordsTimelineVisit, r as RecordsTimelineWeight } from '../../depth-DjDcJ6kH.js';
+export { a as EverfurDocumentContributionsProps, c as EverfurRecordsDepthProps } from '../../DepthViews-DNEM96Se.js';
+import { U as UploadTransport, F as FileHandle } from '../../ports-BN6RHF9W.js';
+export { a as UploadPolicyWire } from '../../ports-BN6RHF9W.js';
+export { E as EverfurError, a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult } from '../../EverfurResult-DN9pL2Ab.js';
+import '../../requestFunnel-CjW7uDuA.js';
+import '../../ErrorPolicyPort-CwbfmxzJ.js';
+import '../../config-DW60uRb9.js';
+import '../../identity-BMx2SUOM.js';
+
+type RecordsHistoryMode = 'memory' | 'browser';
+interface EverfurRecordsProps extends RecordsHostSeams {
+    readonly petRef: PetRef;
+    /** The pet's display name for headers and lead copy; absent, the consumer's own `your pet` forms. */
+    readonly petName?: string;
+    /** Host/test seam: inject a records controller instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /** Host/test seam over the clinic controller. */
+    readonly clinicController?: RecordsClinicController;
+    /** The consent-text version the content-exposure grant records (host/product owned). */
+    readonly consentVersion?: string;
+    /** The owner's name the clinic authorization is signed with (the owner can correct it before signing). */
+    readonly ownerName?: string;
+    /** A host signature component for the clinic authorization, instead of the built-in canvas. */
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** The screen the flow starts on; the dashboard when omitted. */
+    readonly initialScreen?: RecordsScreen;
+    /** `memory` (default) keeps the stack in state; `browser` mirrors it onto the history stack. */
+    readonly historyMode?: RecordsHistoryMode;
+    /** The root screen's back control; absent, the root draws none. */
+    readonly onExit?: () => void;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    /** Your own placeholder while the entitlement verdict is pending on a cold mount. */
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsFlow(props: EverfurRecordsProps): ReactNode;
+/** The public prebuilt records surface: the flow, starting at the dashboard. */
+declare const EverfurRecords: typeof EverfurRecordsFlow;
+
+interface EverfurRecordsDashboardProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsDashboard(props: EverfurRecordsDashboardProps): ReactNode;
+
+interface EverfurRecordsRequestProps extends RecordsScreenBaseProps {
+    readonly requestId: RecordsRequestId;
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+    readonly nowMs?: number;
+}
+declare function EverfurRecordsRequest(props: EverfurRecordsRequestProps): ReactNode;
+
+interface EverfurRecordDetailProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDetail(props: EverfurRecordDetailProps): ReactNode;
+
+interface EverfurRecordDocumentProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDocument(props: EverfurRecordDocumentProps): ReactNode;
+
+interface EverfurRecordsConsentProps extends RecordsScreenBaseProps {
+    readonly clinic: ClinicDraft;
+    readonly ownerName?: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    readonly onCreated?: (request: RecordsRequestView) => void;
+    readonly controller?: RecordsClinicController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurRecordsConsent(props: EverfurRecordsConsentProps): ReactNode;
+
+interface EverfurClinicPickerProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsClinicController;
+    readonly recordsController?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicPicker(props: EverfurClinicPickerProps): ReactNode;
+
+interface EverfurRecordsUploadProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsUpload(props: EverfurRecordsUploadProps): ReactNode;
+
+interface EverfurClinicRequestProps extends ClinicRequestBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+/** Opt-in clinic release flow, reusing the consumer picker/scope/signature mechanics. */
+declare function EverfurClinicRequest(props: EverfurClinicRequestProps): ReactNode;
+
+interface EverfurClinicRequestBatchProps extends ClinicBatchBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicRequestBatch(props: EverfurClinicRequestBatchProps): ReactNode;
+
+interface WebRecordsUploadTransportOptions {
+    /**
+     * Test seam: the XMLHttpRequest constructor to use. Defaults to the global one. A host has no reason to
+     * set it.
+     */
+    readonly xhr?: () => XMLHttpRequest;
+}
+/**
+ * Create the browser records upload transport. Pass it as `uploadTransport` on the web `EverfurConfig`:
+ *
+ * ```tsx
+ * <EverfurProvider config={{ publishableKey, apiBaseUrl, uploadTransport: createWebRecordsUploadTransport() }} ...>
+ * ```
+ *
+ * It needs the picked file's bytes on `FileHandle.blob` (see `fileToHandle`). A handle with no blob rejects
+ * before any request is made.
+ */
+declare function createWebRecordsUploadTransport(options?: WebRecordsUploadTransportOptions): UploadTransport;
+
+/** The `accept` hint for the picker. A hint only: the signature check above is what decides. */
+declare const RECORDS_DOCUMENT_ACCEPT = "application/pdf,.pdf";
+/** True when the blob starts with the PDF signature. An unreadable blob is not a PDF. */
+declare function isPdfBlob(blob: Blob): Promise<boolean>;
+/**
+ * Build the records `FileHandle` for a browser `File` (or any Blob). `mimeType` is `application/pdf` only when
+ * the bytes carry the PDF signature; `sizeBytes` is the real size, so an oversize file is refused by the
+ * controller before initiate as well.
+ */
+declare function fileToHandle(file: Blob): Promise<FileHandle>;
+/**
+ * The same gate the controller applies before initiate (PDF, 0 < size <= 25 MiB), for a surface that must
+ * decide BEFORE it creates a request: a refused file should not leave an empty request behind.
+ */
+declare function isUploadableHandle(handle: FileHandle): boolean;
+/**
+ * Open the browser's file chooser for one document and resolve its handle, or null when the user picks
+ * nothing. For a host that builds its own records UI on `useEverfurRecords`; the prebuilt surface renders its
+ * own input instead. Must be called from a user gesture (a click handler), or the browser blocks the chooser.
+ *
+ * The input is attached to the document while the chooser is open (Safari does not open a detached input)
+ * and removed once it settles. A browser that never fires `cancel` leaves the promise pending when the user
+ * dismisses the chooser; nothing is held but the closure.
+ */
+declare function pickDocument(doc?: Document): Promise<FileHandle | null>;
+
+interface SignatureCanvasState {
+    readonly canvas: React.RefObject<HTMLCanvasElement>;
+    readonly mode: 'draw' | 'type';
+    readonly typed: string;
+    readonly signed: boolean;
+    readonly setTyped: (value: string) => void;
+    readonly toggle: () => void;
+    readonly clear: () => void;
+    readonly onPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerMove: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerUp: () => void;
+    /** The consumer's initiate / direct S3 / complete chain over the current canvas; throws on failure. */
+    readonly register: (controller: RecordsClinicController, signal: AbortSignal) => Promise<{
+        readonly signatureId: string;
+    }>;
+}
+declare function useSignatureCanvas(onEdit?: () => void): SignatureCanvasState;
+declare function SignatureCanvas({ pad, disabled }: {
+    readonly pad: SignatureCanvasState;
+    readonly disabled: boolean;
+}): ReactNode;
+
+export { CaptureRecordsSignature, ClinicBatchBaseProps, ClinicDraft, ClinicRequestBaseProps, EverfurClinicPicker, type EverfurClinicPickerProps, EverfurClinicRequest, EverfurClinicRequestBatch, type EverfurClinicRequestBatchProps, type EverfurClinicRequestProps, EverfurRecordDetail, type EverfurRecordDetailProps, EverfurRecordDocument, type EverfurRecordDocumentProps, EverfurRecords, EverfurRecordsConsent, type EverfurRecordsConsentProps, EverfurRecordsDashboard, type EverfurRecordsDashboardProps, EverfurRecordsFlow, type EverfurRecordsProps, EverfurRecordsRequest, type EverfurRecordsRequestProps, EverfurRecordsUpload, type EverfurRecordsUploadProps, FileHandle, PetRef, RECORDS_DOCUMENT_ACCEPT, RecordsClinicController, RecordsController, type RecordsHistoryMode, RecordsHostSeams, RecordsRequestId, RecordsRequestView, RecordsScreen, RecordsScreenBaseProps, SignatureCanvas, type SignatureCanvasState, UploadTransport, type WebRecordsUploadTransportOptions, createWebRecordsUploadTransport, fileToHandle, isPdfBlob, isUploadableHandle, pickDocument, useSignatureCanvas };