@alfadocs/ui-kit 0.68.0 → 0.70.0

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/notes-panel/index.d.ts

@@ -0,0 +1,3 @@
+export { NotesPanel } from './notes-panel';
+export type { NotesPanelProps, NotesPanelNote } from './notes-panel';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/notes-panel/index.js

@@ -0,0 +1,5 @@
+import { N as a } from "../../_chunks/notes-panel-ay8_lPrA.js";
+export {
+  a as NotesPanel
+};
+//# sourceMappingURL=index.js.map

package/dist/components/notes-panel/notes-panel.d.ts

@@ -0,0 +1,64 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import type { ClinicalNoteCardProps } from '../clinical-note-card';
+import type { RichTextEditorProps, RichTextEditorToolbar, RedactorFactory } from '../rich-text-editor';
+/** One note in the panel — the data subset of `ClinicalNoteCard`. */
+export type NotesPanelNote = Pick<ClinicalNoteCardProps, 'id' | 'dateIso' | 'createdAtIso' | 'author' | 'clinical' | 'attachedTo' | 'content' | 'contentFormat' | 'pinned' | 'flagged'>;
+/** Payload handed to `onAddNote` when the composer commits. */
+export interface NotesPanelSubmission {
+    /** The note body — rich HTML (`composer='rich'`) or plain text. */
+    content: string;
+    /** Whether the "clinical note" toggle was set. */
+    clinical: boolean;
+}
+export interface NotesPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'title' | 'children'> {
+    /** Notes to render, newest-first by convention. Pinned notes lead. */
+    notes: NotesPanelNote[];
+    /** Commit a new note. Omit to hide the composer (read-only timeline). */
+    onAddNote?: (submission: NotesPanelSubmission) => void;
+    /**
+     * `'rich'` (default) mounts the kit `RichTextEditor` (Redactor; degrades to a
+     * textarea where Redactor is absent). `'plain'` keeps a simple `TextArea` for
+     * lightweight surfaces / deterministic tests.
+     */
+    composer?: 'rich' | 'plain';
+    /** Toolbar preset for the rich composer. Defaults to `'standard'`. */
+    editorToolbar?: RichTextEditorToolbar;
+    /** Inject the Redactor factory for the rich composer (else `window.$R`). */
+    redactor?: RedactorFactory;
+    /** Consumer image-upload endpoint for the rich composer. */
+    imageUploadUrl?: string;
+    /** Show the "clinical note" toggle in the composer. Default `true`. */
+    showClinicalToggle?: boolean;
+    /**
+     * Permission gate — when `false` the clinical toggle is disabled and shows
+     * `clinicalGatedReason` on hover/focus. Mirrors platform's
+     * `practice_add_clinical_note` permission. Default `true`.
+     */
+    canAddClinicalNote?: boolean;
+    /** Tooltip shown when the clinical toggle is gated off. */
+    clinicalGatedReason?: string;
+    /** Initial state of the clinical toggle. Default `false`. */
+    defaultClinical?: boolean;
+    onRequestAiDraft?: RichTextEditorProps['onRequestAiDraft'];
+    aiDraftFormat?: RichTextEditorProps['aiDraftFormat'];
+    aiPrivacyNotice?: RichTextEditorProps['aiPrivacyNotice'];
+    onDictate?: RichTextEditorProps['onDictate'];
+    onProofread?: RichTextEditorProps['onProofread'];
+    onAutoFormat?: RichTextEditorProps['onAutoFormat'];
+    /** Toggle a note's pinned state — renders an inline pin button per note. */
+    onTogglePin?: (id: string) => void;
+    /** Toggle a note's flagged state — renders an inline flag button per note. */
+    onToggleFlag?: (id: string) => void;
+    /** Panel heading. Defaults to the localised "Notes". */
+    title?: string;
+    /** Composer placeholder. */
+    composerPlaceholder?: string;
+    /** Save-button label. */
+    addNoteLabel?: string;
+    /** Rendered when there are no notes. */
+    emptyState?: ReactNode;
+    /** Accessible name for the panel region (defaults to `title`). */
+    'aria-label'?: string;
+}
+export declare const NotesPanel: import("react").ForwardRefExoticComponent<NotesPanelProps & import("react").RefAttributes<HTMLElement>>;
+//# sourceMappingURL=notes-panel.d.ts.map

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 a, i as t } from "../../_chunks/notification-card-D2jiKSJJ.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-AEun6DN2.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-CR0Rqh4-.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-details/index.d.ts

@@ -0,0 +1,5 @@
+export { PatientDetails } from './patient-details';
+export type { PatientDetailsProps, PatientDetailsHandle, PatientDetailsField, PatientDetailsSection, PatientDetailsFieldOption, PatientDetailsEditType, PatientDetailsEditValue, PatientDetailsDensity, } from './patient-details';
+export type { PatientField, PatientFieldSection, PatientFieldOption, PatientFieldEditType, PatientFieldEditValue, } from '../_shared/patient-fields';
+export { patientDetailsAgent } from './patient-details.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { P as e, p as i } from "../../_chunks/patient-details-Dlhqb5ig.js";
+export {
+  e as PatientDetails,
+  i as patientDetailsAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/patient-details/patient-details.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { PatientDetailsHandle } from './patient-details';
+export declare const patientDetailsAgent: AgentAdapter<PatientDetailsHandle>;
+//# sourceMappingURL=patient-details.agent.d.ts.map

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

@@ -0,0 +1,96 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type PatientField, type PatientFieldEditType, type PatientFieldEditValue, type PatientFieldOption, type PatientFieldSection } from '../_shared/patient-fields';
+declare const rootVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type { PatientField, PatientFieldSection, PatientFieldOption, PatientFieldEditType, PatientFieldEditValue, } from '../_shared/patient-fields';
+/** A label→value patient field. Alias of the shared {@link PatientField}. */
+export type PatientDetailsField = PatientField;
+/** A labelled, collapsible group of fields. Alias of {@link PatientFieldSection}. */
+export type PatientDetailsSection = PatientFieldSection;
+/** Alias of the shared {@link PatientFieldOption}. */
+export type PatientDetailsFieldOption = PatientFieldOption;
+/** Alias of the shared {@link PatientFieldEditType}. */
+export type PatientDetailsEditType = PatientFieldEditType;
+/** Alias of the shared {@link PatientFieldEditValue}. */
+export type PatientDetailsEditValue = PatientFieldEditValue;
+/**
+ * Imperative handle the agent adapter drives. Exposes only field KEYS and
+ * an opaque `patientId` for reads; `updateField` routes writes through the
+ * same `onFieldSave` path as a human inline edit (no second channel).
+ */
+export interface PatientDetailsHandle {
+    /** The current ordered list of visible field ids. */
+    getVisibleFieldOrder: () => string[];
+    /** Opaque patient id (no PHI). */
+    getPatientId: () => string | undefined;
+    /** Replace the visible set, preserving the given order (filtered to known fields). */
+    setVisibleFields: (fieldIds: string[]) => void;
+    /** Replace the full ordered visible list (filtered to known fields). */
+    setFieldOrder: (orderedIds: string[]) => void;
+    /** Write a field value — delegates to `onFieldSave`. Rejects if no handler. */
+    updateField: (fieldId: string, value: unknown) => Promise<void>;
+}
+export interface PatientDetailsProps extends Omit<HTMLAttributes<HTMLElement>, 'title' | 'children'> {
+    /** Patient display name — the panel heading. */
+    title: ReactNode;
+    /** The sectioned field catalogue (consumer-mapped from DoctorPatient). */
+    sections: PatientDetailsSection[];
+    /**
+     * Header avatar photo / initials override. The panel always fronts the name
+     * with an Avatar — initials derive from a string `title` by default; pass
+     * `src` for a photo, or `name` to override the initials source.
+     */
+    avatar?: {
+        src?: string;
+        name?: string;
+    };
+    /** At-a-glance chips under the name (consumer-composed Badge/Tag/Chip row). */
+    headerChips?: ReactNode;
+    /**
+     * Frame the identity header and each section in its own elevated `Card`,
+     * for a "control-room" rail that reads as a stack of cards rather than one
+     * flat panel. Default `false` (the flat panel with a header rule + eyebrow
+     * section headings). When framed, the header rule is dropped — the cards
+     * provide the separation.
+     */
+    framed?: boolean;
+    /** Master switch — show edit affordances on `editable` fields. */
+    editable?: boolean;
+    /**
+     * Persist a field edit. Resolve ⇒ committed; reject(Error) ⇒ the message
+     * is shown inline and the row stays in edit mode. Also the single channel
+     * the agent's `update_field` uses.
+     */
+    onFieldSave?: (fieldId: string, value: unknown) => Promise<void>;
+    /** Domain validation — return an error message, or `null` when valid. */
+    validate?: (fieldId: string, value: unknown) => string | null;
+    /**
+     * Controlled ordered list of visible field ids. `undefined` ⇒ every field
+     * visible; an explicit `[]` ⇒ none (a panel that starts collapsed).
+     */
+    visibleFieldOrder?: string[];
+    /** Uncontrolled initial order. Omit both ⇒ every field visible, in declaration order. */
+    defaultVisibleFieldOrder?: string[];
+    /** Fired whenever the user shows/hides/reorders fields via the cog. */
+    onVisibleFieldsChange?: (orderedIds: string[]) => void;
+    /** Render the loading skeleton. */
+    loading?: boolean;
+    /** Shown when there are no sections / no patient. Defaults to a localised hint. */
+    emptyState?: ReactNode;
+    /** Opaque patient id — emitted as `data-patient-id` + agent stateRead. No PHI. */
+    patientId?: string;
+    /** Agent-readiness instance id, surfaced as `data-component-id`. */
+    id?: string;
+    /** BCP-47 locale override (currency / number editors). */
+    locale?: string;
+    /** Override the cog trigger's accessible name. */
+    cogLabel?: string;
+    /** Override the panel region's accessible name (defaults to the heading). */
+    'aria-label'?: string;
+}
+export declare const PatientDetails: import("react").ForwardRefExoticComponent<PatientDetailsProps & import("react").RefAttributes<HTMLElement>>;
+/** Density variant union re-exported for downstream typing. */
+export type PatientDetailsDensity = NonNullable<VariantProps<typeof rootVariants>['density']>;
+//# sourceMappingURL=patient-details.d.ts.map

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-Be6cLrHR.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-WySCMwwA.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/patient-summary-card/patient-summary-card.d.ts

@@ -1,5 +1,6 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
+import { type PatientFieldSection } from '../_shared/patient-fields';
 declare const rootVariants: (props?: ({
     surface?: "flat" | "elevated" | null | undefined;
     density?: "compact" | "comfortable" | null | undefined;
@@ -75,7 +76,45 @@ export interface PatientSummaryCardProps extends Omit<ComponentPropsWithoutRef<'
      * dropped and the heading renders as plain text.
      */
     patientUrl?: string;
-    /** Patient email. Compiled into a `mailto:` link when `emailEnabled`. */
+    /**
+     * Patient fields in the shared model — the SAME `sections` shape
+     * `PatientDetails` consumes (`@alfadocs/ui-kit` `PatientFieldSection`).
+     * When provided, the card renders these (honouring `visibleFieldOrder`)
+     * instead of the legacy contact props, so a consumer defines its patient-
+     * field registry once and reuses it across every patient surface.
+     *
+     * The card renders each field's `label`, `value`, and `icon` only — it is
+     * flat (section headings are not shown in the body) and never inline-edits;
+     * `sensitive` / `copyable` / `mono` / `editable` are honoured by
+     * `PatientDetails`, not the card (so the PHI lock glyph does not appear here).
+     *
+     * Pass `onVisibleFieldsChange` alongside `sections` to make THIS placement
+     * self-curating (a "Customize fields" cog appears — show/hide + drag-and-drop
+     * reorder).
+     */
+    sections?: PatientFieldSection[];
+    /**
+     * Ordered visible field ids for THIS placement. The order is a
+     * per-INSTANCE, per-CONTEXT preference the kit never persists — wire it to
+     * whatever scope the consumer wants (e.g. a global per-user setting, or a
+     * different config in the care-plan view vs the patient folder). The same
+     * field vocabulary can therefore display differently in different parts of
+     * the app. Omit (`undefined`) ⇒ show every field; an explicit empty array
+     * `[]` ⇒ show none (a card that starts collapsed to name + identity chips and
+     * reveals fields via the cog). Also applied to the legacy contact rows (ids
+     * `email` / `phone` / `cityProvince` / `marketingConsent` / `aiConsent` /
+     * `assignedTo`).
+     */
+    visibleFieldOrder?: string[];
+    /**
+     * Make this card's field set user-customizable. When provided alongside
+     * `sections`, a "Customize fields" cog renders in the header (show/hide +
+     * drag-and-drop / Alt+Arrow reorder), and this fires with the next ordered
+     * visible set. The consumer owns persistence + its scope — editing here
+     * writes only THIS context's preference, never a shared/global one.
+     */
+    onVisibleFieldsChange?: (orderedIds: string[]) => void;
+    /** @deprecated Pass via `sections`. Patient email — `mailto:` link when `emailEnabled`. */
     email?: string;
     /** Whether email contact is enabled — gates the `mailto:` link. */
     emailEnabled?: boolean;

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/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/columns.d.ts

@@ -0,0 +1,131 @@
+/**
+ * patient-table — column definitions
+ * ----------------------------------------------------------------------------
+ * `buildPatientColumns(t, opts)` returns the ordered `ColDef<PatientRow>[]` for
+ * the patient grid. Every patient field is its OWN column — sortable, filterable
+ * and individually hideable via ColumnToggle — rather than several fields jumbled
+ * into one composite cell. Each column wires the right kit cell renderer + the
+ * right kit filter + floatingFilter, a localised `headerName` (from
+ * `ui.patientTable.column.*`) and a stable `colId`.
+ *
+ * Identity is SPLIT across three pinned-start columns (the spec's
+ * "Avatar · First · Last"):
+ *  • `avatar`    — ImageCellRenderer (photo, initials fallback), sr-only header.
+ *  • `firstName` — plain text.
+ *  • `lastName`  — LinkCellRenderer (the patient-detail link, `identityHref`).
+ * All three are pinned-start P0 anchors and never auto-hide.
+ *
+ * COLUMN VISIBILITY
+ * -----------------
+ * `●` default-visible columns carry a `responsiveTier`; the responsive hook hides
+ * them by tier as the grid narrows. Every other (grouped) column ships
+ * `hide: true` and NO tier, so the hook leaves it alone and a user ColumnToggle
+ * override wins. The anchors (avatar / firstName / lastName / actions) omit a
+ * tier so they are never auto-hidden.
+ *
+ * RESPONSIVE TIER MECHANISM
+ * -------------------------
+ * Each column may carry a custom `responsiveTier` (`P0`–`P3`) property. AG Grid's
+ * `ColDef` is an open/extensible shape — extra properties pass through untouched
+ * at runtime — but its TS type is closed, so we type each entry as
+ * `PatientColDefWithTier` and read the tier back via {@link getResponsiveTier}
+ * (no `any`, no reliance on AG Grid's loose `context`).
+ *
+ * CUSTOM FIELDS
+ * -------------
+ * `opts.customFields` appends one dynamic column per descriptor after the
+ * standard columns: `colId: \`custom:${fieldName}\``, a LITERAL `headerName`
+ * (the practice-defined label — never i18n-keyed), a `valueGetter` reading
+ * `row.customFields?.[fieldName]`, and a renderer + filter chosen by `type`
+ * (`text` → plain text · `checkbox` → ✓/— · `dropdown` → Tag chip). All ship
+ * `hide: true` and no tier.
+ *
+ * CONSTRAINTS:
+ *  • No colour / spacing / radius / font literal in any `cellStyle`/`cellClass`
+ *    here — only token-bound `ds:` utility classes — so the AG Grid theme bridge
+ *    stays in control of theming.
+ *  • CSS logical properties only.
+ *  • 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, PatientCustomFieldDef, 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 — the pinned anchors and every
+ * `hide: true` grouped column deliberately omit a tier so they are never
+ * auto-managed by the responsive hook.
+ */
+export declare function getResponsiveTier(colDef: PatientColumnDef): ResponsiveTier | undefined;
+/** Options threaded into {@link buildPatientColumns}. */
+export interface BuildPatientColumnsOptions {
+    /**
+     * Mask sensitive contact details (email) — when `true` the `email` column
+     * ships hidden. Forwarded from `PatientTable`'s `hidePatientDetails`. 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 `lastName` link column, e.g.
+     * `(row) => \`/patients/${row.id}\``. When omitted the lastName cell renders a
+     * button that calls `onRowAction` with the `show` action instead.
+     */
+    identityHref?: string | ((row: PatientRow) => string | undefined);
+    /**
+     * Per-practice custom-field descriptors. Each appends one dynamic `custom:*`
+     * column (hidden by default) after the standard columns. See
+     * {@link PatientCustomFieldDef}.
+     */
+    customFields?: PatientCustomFieldDef[];
+}
+/**
+ * The fixed number of per-row actions the patient grid builds (show · edit ·
+ * email reminder · sms reminder · reassign · delete — see {@link buildRowActions}).
+ * Exposed so the component can size the actions column to its EXPANDED footprint
+ * (`actionsColumnWidth(PATIENT_ROW_ACTION_COUNT)`) when flipping the runtime
+ * compact-actions toggle off, without rebuilding the column defs. Keep in sync
+ * with the array {@link buildRowActions} returns.
+ */
+export declare const PATIENT_ROW_ACTION_COUNT = 6;
+/**
+ * Build the ordered patient-grid column definitions — one field per column.
+ *
+ * @param t    `react-i18next` translation fn (default `ui` namespace).
+ * @param opts See {@link BuildPatientColumnsOptions} — density getter, row-action
+ *             callback, detail masking, identity href, custom fields.
+ * @returns    Ordered `PatientColumnDef[]`. Default-visible columns carry a
+ *             `responsiveTier` (read via {@link getResponsiveTier}); the pinned
+ *             anchors and every grouped (`hide: true`) column omit it so they are
+ *             never auto-hidden.
+ */
+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,20 @@
+/**
+ * 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, PATIENT_ROW_ACTION_COUNT, type BuildPatientColumnsOptions, type PatientColDefWithTier, } from './columns';
+export { useResponsiveColumns, type UseResponsiveColumnsOptions, type UseResponsiveColumnsResult, } from './use-responsive-columns';
+export type { PatientRow, PatientPhoneNumber, PatientGender, PatientMarketingConsent, PatientCarePlanStatus, PatientCustomFieldDef, PatientColumnId, ResponsiveTier, PatientRowActionKey, PatientRowAction, PatientBulkActionKey, PatientBulkAction, PatientView, PatientTableHandle, PatientColDef, PatientColGroupDef, PatientColumnDef, } from './types';
+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';
+//# sourceMappingURL=index.d.ts.map

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

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