@alfadocs/ui-kit 0.68.0 → 0.69.0

package/dist/components/list/index.js

@@ -1,4 +1,4 @@
-import { L as a, l as e } from "../../_chunks/list-BOwqwy03.js";
+import { L as a, l as e } from "../../_chunks/list-DgE1xWBM.js";
 export {
   a as List,
   e as listAgent

package/dist/components/locale-picker/index.js

@@ -1,4 +1,4 @@
-import { L, a as c, b as r } from "../../_chunks/locale-picker-C9JmBht3.js";
+import { L, a as c, b as r } from "../../_chunks/locale-picker-ChYYSX2N.js";
 export {
   L as LOCALE_STORAGE_KEY,
   c as LocalePicker,

package/dist/components/map-view/index.js

@@ -1,4 +1,4 @@
-import { M as o } from "../../_chunks/map-view-Tb5VfK9Y.js";
+import { M as o } from "../../_chunks/map-view-BkOoGoX2.js";
 export {
   o as MapView
 };

package/dist/components/message-card/index.js

@@ -1,5 +1,5 @@
 import { M as a } from "../../_chunks/message-card-Bx4GmLvf.js";
-import { m as o } from "../../_chunks/message-card.agent-4IeIgrnJ.js";
+import { m as o } from "../../_chunks/message-card.agent-ZLhx3Bs5.js";
 import { i as f } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   a as MessageCard,

package/dist/components/message-tray/index.js

@@ -1,4 +1,4 @@
-import { M as s, m as r } from "../../_chunks/message-tray-CVyJajVJ.js";
+import { M as s, m as r } from "../../_chunks/message-tray-DwrBLJlf.js";
 export {
   s as MessageTray,
   r as messageTrayAgent

package/dist/components/multi-select/index.js

@@ -1,4 +1,4 @@
-import { M as a, m as l, a as i } from "../../_chunks/multi-select-BcPylvHR.js";
+import { M as a, m as l, a as i } from "../../_chunks/multi-select-BdHHDrRN.js";
 export {
   a as MultiSelect,
   l as multiSelectAgent,

package/dist/components/navigation-menu/index.js

@@ -1,4 +1,4 @@
-import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-C6lBYVv9.js";
+import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-DRUi6sSj.js";
 import { S as r } from "../../_chunks/skip-link-BaSMtPwB.js";
 export {
   i as NavigationMenu,

package/dist/components/notification-card/index.js

@@ -1,5 +1,5 @@
 import { N as a, i as t } from "../../_chunks/notification-card-BiESdm8q.js";
-import { n as f } from "../../_chunks/notification-card.agent-Rqt3ofk9.js";
+import { n as f } from "../../_chunks/notification-card.agent-DxGBZb8T.js";
 export {
   a as NotificationCard,
   t as isSafeNotificationUrl,

package/dist/components/notification-tray/index.js

@@ -1,4 +1,4 @@
-import { N as o, n as t } from "../../_chunks/notification-tray-DlgenTEe.js";
+import { N as o, n as t } from "../../_chunks/notification-tray-Btb9oQeZ.js";
 export {
   o as NotificationTray,
   t as notificationTrayAgent

package/dist/components/number-input/index.js

@@ -1,4 +1,4 @@
-import { N as r, u as a } from "../../_chunks/number-input-Dj5L3pXK.js";
+import { N as r, u as a } from "../../_chunks/number-input-DxphVG_A.js";
 export {
   r as NumberInput,
   a as useLocaleNumber

package/dist/components/operator-hero/index.js

@@ -1,4 +1,4 @@
-import { O as e, o as a } from "../../_chunks/operator-hero-f_KaRhw5.js";
+import { O as e, o as a } from "../../_chunks/operator-hero-CP2Nhupm.js";
 export {
   e as OperatorHero,
   a as operatorHeroAgent

package/dist/components/otp-input/index.js

@@ -1,4 +1,4 @@
-import { O as r } from "../../_chunks/otp-input-xQ4Ps5VY.js";
+import { O as r } from "../../_chunks/otp-input-DzBQ-CpE.js";
 export {
   r as OTPInput
 };

package/dist/components/pagination/index.js

@@ -1,4 +1,4 @@
-import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-DQOgnxxw.js";
+import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-D58kglCr.js";
 export {
   n as Pagination,
   s as PaginationEllipsis,

package/dist/components/password-input/index.js

@@ -1,4 +1,4 @@
-import { P as r, u as a } from "../../_chunks/use-password-requirements-DsgduV1x.js";
+import { P as r, u as a } from "../../_chunks/use-password-requirements-BXvS2MBS.js";
 export {
   r as PasswordInput,
   a as usePasswordRequirements

package/dist/components/patient-search/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as r } from "../../_chunks/patient-search-DR9XUYRQ.js";
+import { P as t, p as r } from "../../_chunks/patient-search-CBC_ySF6.js";
 export {
   t as PatientSearch,
   r as patientSearchAgent

package/dist/components/patient-summary-card/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as m } from "../../_chunks/patient-summary-card-hEmr4eTW.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-B836_fDB.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/patient-table/cell-renderers/balance-badge-cell.d.ts

@@ -0,0 +1,13 @@
+import type { CustomCellRendererProps } from 'ag-grid-react';
+import type { PatientRow } from '../types';
+export interface BalanceBadgeCellParams {
+    /** ISO 4217 currency code used to format the balance. Default `'EUR'`. */
+    currency?: string;
+    /**
+     * `Intl.NumberFormat` escape hatch, merged on top of the currency defaults.
+     * E.g. `{ maximumFractionDigits: 0 }` for whole-currency display.
+     */
+    options?: Intl.NumberFormatOptions;
+}
+export declare function BalanceBadgeCell(props: CustomCellRendererProps<PatientRow> & BalanceBadgeCellParams): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=balance-badge-cell.d.ts.map

package/dist/components/patient-table/cell-renderers/care-plan-status-cell.d.ts

@@ -0,0 +1,43 @@
+/**
+ * care-plan-status-cell — patient-table cell renderer
+ * ----------------------------------------------------------------------------
+ * A thin domain preset over the data-table `StatusCellRenderer` / kit `Badge`:
+ * it bakes the patient care-plan lifecycle `variantMap` so consumers don't have
+ * to re-declare it on every column, and localises the label via the `ui`
+ * namespace (`ui.patientTable.carePlanStatus.*`).
+ *
+ * Reads `PatientRow.carePlanStatus` (preferring `data.carePlanStatus`, falling
+ * back to AG Grid's resolved `value`), maps it to a Badge variant:
+ *
+ *   accepted → success    estimate → info    none → neutral (muted)
+ *
+ * GROUND-TRUTH NOTES (vs. the task brief):
+ *  • `StatusCellRenderer` is not exported from a barrel and is a tiny wrapper
+ *    around `Badge`; this preset composes `Badge` directly (same primitive,
+ *    no extra indirection) rather than wrapping the wrapper.
+ *  • The brand says the "muted" variant is `none`; `Badge`'s neutral variant is
+ *    already the muted grey chip, so `none → 'neutral'`.
+ *  • No event handling: a status badge is presentational, so there are no
+ *    provided callbacks to wire.
+ */
+import type { CustomCellRendererProps } from 'ag-grid-react';
+import type { PatientCarePlanStatus, PatientRow } from '../types';
+/**
+ * `cellRendererParams` for `CarePlanStatusCell`.
+ *
+ * The lifecycle status, label source and variant map are all baked in, so the
+ * only knob is the Badge size — defaults to the compact `sm` chip that fits the
+ * standard AG Grid row height.
+ */
+export interface CarePlanStatusCellParams {
+    /** Badge size. Defaults to `'sm'` to fit the standard row height. */
+    size?: 'sm' | 'md' | 'lg';
+}
+/**
+ * Patient care-plan lifecycle badge cell.
+ *
+ * Pass as `cellRenderer` on the `carePlanStatus` column; the patient
+ * `variantMap` and localisation are handled internally.
+ */
+export declare function CarePlanStatusCell(props: CustomCellRendererProps<PatientRow, PatientCarePlanStatus> & CarePlanStatusCellParams): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=care-plan-status-cell.d.ts.map

package/dist/components/patient-table/cell-renderers/contact-cell.d.ts

@@ -0,0 +1,45 @@
+import type { CustomCellRendererProps } from 'ag-grid-react';
+import type { PatientRow } from '../types';
+/**
+ * `cellRendererParams` for {@link ContactCell}.
+ *
+ * Passed through AG Grid's `cellRendererParams` on the column definition.
+ * Everything the renderer needs about the patient comes from the row `data`
+ * (PHI stays as text content — never a DOM attribute); these params only tune
+ * presentation.
+ */
+export interface ContactCellParams {
+    /**
+     * Mask the email line — replaces the address with a fixed placeholder so the
+     * cell still communicates that an email exists without exposing it (privacy /
+     * screen-share contexts). The phone line and eligibility affordances are
+     * unaffected. Default `false`.
+     */
+    hideDetails?: boolean;
+}
+/**
+ * Contact + reminder-eligibility cell for the patient grid.
+ *
+ * Renders the primary phone (`phoneNumbers[0].number`) and email stacked, plus
+ * two small inline status glyphs:
+ *
+ *   • SMS-reminder eligibility — eligible when **any** phone number has
+ *     `smsEnabled`.
+ *   • Email-reminder eligibility — eligible when `emailEnabled && emailValid`.
+ *
+ * The glyphs are informational only — no row action is dispatched and they are
+ * not keyboard-focusable. Each is a labelled `role="img"` element: the
+ * eligibility state is exposed to assistive tech through its `aria-label`, with
+ * a pointer `Tooltip` reinforcing it for sighted users.
+ *
+ * Honours the `hideDetails` `cellRendererParam`: when `true`, the email address
+ * is masked behind a placeholder while still indicating an address is on file.
+ *
+ * PHI rule (PRS 26 §6): phone / email reach the DOM as **text content only** —
+ * never as `data-*` attributes.
+ */
+export declare function ContactCell(props: CustomCellRendererProps<PatientRow> & ContactCellParams): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace ContactCell {
+    var displayName: string;
+}
+//# sourceMappingURL=contact-cell.d.ts.map

package/dist/components/patient-table/cell-renderers/next-appointment-cell.d.ts

@@ -0,0 +1,24 @@
+import type { CustomCellRendererProps } from 'ag-grid-react';
+import type { PatientRow } from '../types';
+/**
+ * `cellRendererParams` for {@link NextAppointmentCell}.
+ *
+ * Localisation and the relative-date formatting are handled internally; the
+ * only knob is the imminence window.
+ */
+export interface NextAppointmentCellParams {
+    /**
+     * Highlight the cell when the appointment is at most this many days away
+     * (and not in the past). Defaults to `7`. A value `<= 0` disables the
+     * highlight.
+     */
+    soonWithinDays?: number;
+}
+/**
+ * Smart upcoming-appointment cell.
+ *
+ * Pass as `cellRenderer` on the `nextAppointment` column; the relative
+ * formatting, imminence emphasis and empty state are handled internally.
+ */
+export declare function NextAppointmentCell(props: CustomCellRendererProps<PatientRow, string> & NextAppointmentCellParams): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=next-appointment-cell.d.ts.map

package/dist/components/patient-table/cell-renderers/patient-identity-cell.d.ts

@@ -0,0 +1,26 @@
+import type { CustomCellRendererProps } from 'ag-grid-react';
+import type { PatientRow } from '../types';
+/** Derive a value directly or from the row, mirroring LinkCellRenderer. */
+type Getter<T> = T | ((row: PatientRow) => T | undefined);
+export interface PatientIdentityCellParams {
+    /**
+     * Anchor href for the patient detail — a string, or a function deriving it
+     * from the row (e.g. `(row) => \`/patients/${row.id}\``). When omitted the
+     * cell renders a button that invokes `onSelect` instead.
+     */
+    href?: Getter<string>;
+    /**
+     * Fallback / additional handler. Invoked with the row on click. When `href`
+     * is absent the click default is prevented so navigation is driven entirely
+     * by this callback.
+     */
+    onSelect?: (row: PatientRow) => void;
+}
+/**
+ * Composite identity cell: Avatar + bold name + muted fiscal-code caption,
+ * wrapped in a link (or button) to the patient detail. Returns `null` for
+ * pinned (header/total) rows and for empty rows so the cell stays blank.
+ */
+export declare function PatientIdentityCell(props: CustomCellRendererProps<PatientRow> & PatientIdentityCellParams): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=patient-identity-cell.d.ts.map

package/dist/components/patient-table/columns.d.ts

@@ -0,0 +1,102 @@
+/**
+ * patient-table — column definitions
+ * ----------------------------------------------------------------------------
+ * `buildPatientColumns(t, opts)` returns the ordered `ColDef<PatientRow>[]` for
+ * the patient grid: one leaf column per the workflow plan's 17-column spec, each
+ * wiring the right cell renderer + the right kit filter + floatingFilter, a
+ * localised `headerName` (from `ui.patientTable.column.*`) and a stable `colId`.
+ *
+ * RESPONSIVE TIER MECHANISM
+ * -------------------------
+ * Each column carries a custom `responsiveTier` (`P0`–`P3`) property. AG Grid's
+ * `ColDef` is an open/extensible shape — extra properties on a colDef are passed
+ * through untouched at runtime — but its TS type is closed, so a bare extra key
+ * would not type-check. We therefore type each entry as `PatientColDefWithTier`
+ * (`PatientColDef & { responsiveTier?: ResponsiveTier }`) and read the tier back
+ * via the exported {@link getResponsiveTier} helper rather than through AG Grid's
+ * loosely-typed `context: any` field — so the tier is fully typed end-to-end with
+ * no `any`. The `useResponsiveColumns` hook consumes these tiers to toggle column
+ * visibility by grid-container width.
+ *
+ * GROUND-TRUTH NOTES (vs. the task brief / workflow plan):
+ *  • The `select` checkbox column is NOT emitted here. The spec marks it
+ *    "(built-in)" — it is provided by the grid's `rowSelection` config
+ *    (`headerCheckbox: true, checkboxes: true`, see data-table.tsx), not as a
+ *    leaf colDef. It is always P0 and grid-managed, so the responsive hook never
+ *    touches it. `PatientColumnId` still lists `'select'` for ColumnToggle/agent
+ *    addressing parity.
+ *  • There is no standalone `Icon`/`IconButton` colDef primitive; the actions
+ *    column uses the kit's `ActionsCellRenderer` with `PatientRowAction`-shaped
+ *    `ActionDef`s. Its `collapsed` getter (`opts.getActionsCompact`) drives the
+ *    180→88px compact density from the spec without rebuilding column state.
+ *  • `Default insurance` and `Fiscal code` are plain text columns (no dedicated
+ *    renderer) per the spec; they still get a `TextFilter` + floating filter.
+ *  • No colour, spacing, radius or font literal appears in any ColDef
+ *    `cellStyle`/`cellClass` here — only token-bound `ds:` utility classes — so
+ *    the AG Grid theme bridge (`ag-grid-theme.css`) stays in control of theming.
+ *  • PHI rule (PRS 26 §6): no `PatientRow` field other than `id` is ever placed
+ *    in a DOM `data-*` attribute. Renderers surface name/contact/DOB as text
+ *    content only; these defs pass values, not attributes.
+ */
+import type { TFunction } from 'i18next';
+import type { PatientColDef, PatientColumnDef, PatientRow, PatientRowAction, ResponsiveTier } from './types';
+/**
+ * A patient leaf column carrying its responsive-priority tier. AG Grid passes
+ * the extra `responsiveTier` key through untouched; we keep it strongly typed
+ * (no `any`, no reliance on AG Grid's `context: any`) so the responsive hook can
+ * read it back via {@link getResponsiveTier}.
+ */
+export type PatientColDefWithTier = PatientColDef & {
+    /**
+     * Responsive priority. Lower numbers survive longer as the grid narrows:
+     * `P0` always visible, `P3` first to hide. Consumed by `useResponsiveColumns`.
+     */
+    responsiveTier?: ResponsiveTier;
+};
+/**
+ * Read the responsive tier off a column definition. Returns `undefined` for
+ * columns that opt out of responsive toggling (e.g. the pinned Identity / pinned
+ * Actions columns deliberately omit a tier so they never auto-hide).
+ */
+export declare function getResponsiveTier(colDef: PatientColumnDef): ResponsiveTier | undefined;
+/** Options threaded into {@link buildPatientColumns}. */
+export interface BuildPatientColumnsOptions {
+    /**
+     * Mask sensitive contact details (email) in the Contact/Email cells. Forwarded
+     * to `ContactCell`'s `hideDetails` param. Default `false`.
+     */
+    hideDetails?: boolean;
+    /**
+     * Live getter for the actions-column density. When it returns `true`, the
+     * `ActionsCellRenderer` collapses its inline buttons into a single "…" overflow
+     * menu (the spec's 180→88px compact density). Reading via a getter lets a
+     * density toggle flip without rebuilding column defs (preserves column state) —
+     * call `api.refreshCells({ force: true })` after flipping the backing value.
+     * Defaults to a getter that always returns `false`.
+     */
+    getActionsCompact?: () => boolean;
+    /**
+     * Invoked when a per-row action button is activated, with the resolved action
+     * descriptor and the patient row. Only `row.id` ever leaves this boundary into
+     * persistence / agent surfaces — never PHI.
+     */
+    onRowAction?: (action: PatientRowAction, patient: PatientRow) => void;
+    /**
+     * Derive the patient-detail href for the Identity cell, e.g.
+     * `(row) => \`/patients/${row.id}\``. When omitted the Identity cell renders a
+     * button that calls `onRowAction` with the `show` action instead.
+     */
+    identityHref?: string | ((row: PatientRow) => string | undefined);
+}
+/**
+ * Build the ordered patient-grid column definitions.
+ *
+ * @param t    `react-i18next` translation fn (default `ui` namespace).
+ * @param opts See {@link BuildPatientColumnsOptions} — density getter, row-action
+ *             callback, detail masking, identity href.
+ * @returns    Ordered `PatientColumnDef[]`. Leaf columns carry a `responsiveTier`
+ *             (read via {@link getResponsiveTier}); the pinned Identity and
+ *             Actions columns omit it so they never auto-hide.
+ */
+export declare function buildPatientColumns(t: TFunction, opts?: BuildPatientColumnsOptions): PatientColumnDef[];
+//# sourceMappingURL=columns.d.ts.map

package/dist/components/patient-table/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * patient-table — public barrel
+ * ----------------------------------------------------------------------------
+ * Re-exports the `PatientTable` component, its public type surface, the
+ * `buildPatientColumns` builder (so consumers can compose / extend columns)
+ * and every patient cell renderer + its params type (so consumers can reuse
+ * them when supplying a custom `columns` prop).
+ */
+export { PatientTable } from './patient-table';
+export type { PatientTableProps } from './patient-table';
+export { buildPatientColumns, getResponsiveTier, type BuildPatientColumnsOptions, type PatientColDefWithTier, } from './columns';
+export { useResponsiveColumns, type UseResponsiveColumnsOptions, type UseResponsiveColumnsResult, } from './use-responsive-columns';
+export type { PatientRow, PatientPhoneNumber, PatientGender, PatientMarketingConsent, PatientCarePlanStatus, PatientColumnId, ResponsiveTier, PatientRowActionKey, PatientRowAction, PatientBulkActionKey, PatientBulkAction, PatientView, PatientTableHandle, PatientColDef, PatientColGroupDef, PatientColumnDef, } from './types';
+export { PatientIdentityCell } from './cell-renderers/patient-identity-cell';
+export type { PatientIdentityCellParams } from './cell-renderers/patient-identity-cell';
+export { NextAppointmentCell } from './cell-renderers/next-appointment-cell';
+export type { NextAppointmentCellParams } from './cell-renderers/next-appointment-cell';
+export { BalanceBadgeCell } from './cell-renderers/balance-badge-cell';
+export type { BalanceBadgeCellParams } from './cell-renderers/balance-badge-cell';
+export { CarePlanStatusCell } from './cell-renderers/care-plan-status-cell';
+export type { CarePlanStatusCellParams } from './cell-renderers/care-plan-status-cell';
+export { ContactCell } from './cell-renderers/contact-cell';
+export type { ContactCellParams } from './cell-renderers/contact-cell';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/patient-table/index.js

@@ -0,0 +1,13 @@
+import { B as s, C as t, a as l, N as n, P as C, b as i, c as o, g as u, u as p } from "../../_chunks/patient-table-CDuosVru.js";
+export {
+  s as BalanceBadgeCell,
+  t as CarePlanStatusCell,
+  l as ContactCell,
+  n as NextAppointmentCell,
+  C as PatientIdentityCell,
+  i as PatientTable,
+  o as buildPatientColumns,
+  u as getResponsiveTier,
+  p as useResponsiveColumns
+};
+//# sourceMappingURL=index.js.map

package/dist/components/patient-table/patient-table.d.ts

@@ -0,0 +1,138 @@
+/**
+ * patient-table — Domain-Specific component
+ * ----------------------------------------------------------------------------
+ * `PatientTable` is a thin composition over the kit's `data-table` engine
+ * (AG Grid Community) specialised for the AlfaDocs patient list. It bakes in:
+ *
+ *   • `buildPatientColumns(t, …)` (the 17-column spec) merged with a
+ *     consumer-supplied `columns` override.
+ *   • the patient cell renderers (Identity / NextAppointment / BalanceBadge /
+ *     CarePlanStatus / Contact) via the column defs above.
+ *   • a default toolbar — `QuickSearch` + `FilterChips` + `ColumnToggle` +
+ *     `ExportMenu` + a `BulkAction` per `props.bulkActions` — overridable
+ *     wholesale via `props.toolbar`.
+ *   • `useResponsiveColumns` (container-width column-priority tiers) when
+ *     `props.responsive` (default `true`).
+ *   • multiple row selection, pagination, archived-row tint, loading / empty
+ *     overlays.
+ *   • `useAgentRegistration(dataTableAgent, handle, gridId)` — the SAME agent
+ *     adapter `data-table` registers, keyed by `gridId`.
+ *
+ * The `forwardRef` exposes the inner `DataTableHandle<PatientRow>` so consumers
+ * (e.g. the `patients` pattern's WarningStack "View" actions) can drive the
+ * grid imperatively — `setFilter`, `setSort`, `getSelection`, etc.
+ *
+ * CONSTRAINTS (CI-blocking — src/docs/23-constraints.mdx, 26-agent-readiness.mdx):
+ *  • No hardcoded colour / spacing / radius / shadow / font — token-bound `ds:`
+ *    utilities only. Row tint goes through the token-bound
+ *    `data-table-row-archived` class on the AG Grid theme bridge, never an
+ *    inline `cellStyle`.
+ *  • CSS logical properties only (`ms/me/ps/pe`, `text-start/text-end`).
+ *  • All user-visible strings via `useTranslation('ui')` → `ui.patientTable.*`.
+ *  • TypeScript strict — no `any`. `forwardRef` exposes the curated handle.
+ *  • PHI rule (PRS 26 §6): only `row.id` reaches DOM `data-*`. This component
+ *    writes no PHI attribute; AG Grid surfaces ids via its native `row-id`.
+ */
+import { type ReactNode } from 'react';
+import { type BuildPatientColumnsOptions } from './columns';
+import type { PatientBulkAction, PatientColumnDef, PatientRow, PatientRowAction, PatientTableHandle, PatientView } from './types';
+export interface PatientTableProps {
+    /**
+     * Row data. `undefined` ⇒ the grid renders its loading overlay (the
+     * data-table contract: `rowData === undefined` is the loading sentinel). Pass
+     * `[]` for an explicit empty state.
+     */
+    rowData?: PatientRow[];
+    /**
+     * Override / extend the baked patient columns. When provided, these column
+     * definitions REPLACE the kit defaults entirely (the consumer is expected to
+     * compose `buildPatientColumns(t, …)` — re-exported from the barrel — with
+     * their own additions). When omitted, the kit's `buildPatientColumns` output
+     * is used.
+     */
+    columns?: PatientColumnDef[];
+    /**
+     * REQUIRED. Persistence key (column state → `localStorage`) AND the agent
+     * instance address (`data-component-id`). Two tables on one page need
+     * distinct `gridId`s.
+     */
+    gridId: string;
+    /** Row-height preset. Defaults to the engine default (`'default'`). */
+    density?: 'compact' | 'default' | 'expanded';
+    /**
+     * Enable container-width column-priority responsiveness (lower-priority
+     * columns hide as the grid narrows). Default `true`. Set `false` to leave
+     * column visibility entirely to persistence / `ColumnToggle`.
+     */
+    responsive?: boolean;
+    /**
+     * Saved column/filter/sort presets. When non-empty AND no custom `toolbar`
+     * is supplied, the default toolbar renders a `Select`-based view switcher in
+     * the FilterBar; choosing a view applies its column visibility (via the
+     * responsive-hook lock so the choice is honoured like a manual ColumnToggle),
+     * `filterModel` (`setFilter`) and `sortModel` (`setSort`). Omitted entirely
+     * when empty / undefined or when `toolbar` is supplied (a custom toolbar owns
+     * its own view UI).
+     */
+    views?: PatientView[];
+    /**
+     * Invoked when a per-row action button is activated, with the resolved action
+     * descriptor and the patient row. Only `row.id` ever leaves this boundary into
+     * persistence / agent surfaces — never PHI.
+     */
+    onRowAction?: (action: PatientRowAction, patient: PatientRow) => void;
+    /**
+     * Toolbar bulk actions (operate on the current selection). Each renders a
+     * `DataTable.Toolbar.BulkAction` that surfaces only while rows are selected;
+     * its `onSelect` receives the selected row ids (never PHI).
+     */
+    bulkActions?: PatientBulkAction[];
+    /**
+     * Force the loading overlay independently of `rowData`. When `true` the grid
+     * shows the loading skeleton even if `rowData` is an array (e.g. a background
+     * refresh). `rowData === undefined` also triggers loading.
+     */
+    loading?: boolean;
+    /**
+     * Replace the default toolbar wholesale. Pass a `<DataTable.Toolbar>…</…>`
+     * tree (it has access to the same toolbar context). When omitted the default
+     * QuickSearch + FilterChips + ColumnToggle + ExportMenu + BulkActions toolbar
+     * is rendered.
+     */
+    toolbar?: ReactNode;
+    /**
+     * Omit the `QuickSearch` field from the DEFAULT toolbar. The rest of the
+     * default toolbar (view switcher when `views` is supplied, FilterChips,
+     * ColumnToggle, ExportMenu, BulkActions) is unaffected. Ignored when a custom
+     * `toolbar` is supplied (that toolbar owns its own composition). Default
+     * `false` (search shown). Use for surfaces that provide their own search
+     * affordance elsewhere on the page.
+     */
+    hideQuickSearch?: boolean;
+    /**
+     * Page-size dropdown options shown in the pagination panel — forwarded to the
+     * underlying `DataTable.paginationPageSizeSelector`. Pass `false` to hide the
+     * page-size chooser entirely (pagination navigation is unaffected). Default
+     * `[10, 25, 50, 100]` (the engine default).
+     */
+    paginationPageSizeSelector?: number[] | false;
+    /**
+     * Mask sensitive contact details (email) in the Contact / Email columns.
+     * Forwarded to `buildPatientColumns`' `hideDetails`. Ignored when `columns`
+     * is supplied (the consumer owns their columns then). Default `false`.
+     */
+    hideDetails?: boolean;
+    /**
+     * Derive the patient-detail href for the Identity cell, e.g.
+     * `(row) => \`/patients/${row.id}\``. Forwarded to `buildPatientColumns`.
+     * Ignored when `columns` is supplied. When omitted the Identity cell routes
+     * its click through `onRowAction` with the `show` action.
+     */
+    identityHref?: BuildPatientColumnsOptions['identityHref'];
+    /** Override the default region aria-label (`ui.patientTable.regionLabel`). */
+    'aria-label'?: string;
+    /** Extra class names merged onto the inner grid wrapper. */
+    className?: string;
+}
+export declare const PatientTable: import("react").ForwardRefExoticComponent<PatientTableProps & import("react").RefAttributes<PatientTableHandle>>;
+//# sourceMappingURL=patient-table.d.ts.map