@alfadocs/ui-kit 0.69.0 → 0.71.0

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

@@ -0,0 +1,41 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+/**
+ * Provides rail-injected actions that every descendant `PanelHeader`
+ * appends to its action cluster, after the panel's own `actions`. The
+ * rail (or any host) wraps the panel subtree once; standalone panels
+ * render without a provider and inject nothing.
+ */
+export declare function PanelHeaderActionsProvider({ actions, children, }: {
+    actions: ReactNode;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** Reads the rail-injected actions for the current subtree (default `null`). */
+export declare function usePanelHeaderActions(): ReactNode;
+declare const headerVariants: (props?: ({
+    sticky?: boolean | null | undefined;
+    divider?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface PanelHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'>, VariantProps<typeof headerVariants> {
+    /** Heading content. Already translated upstream. */
+    title: ReactNode;
+    /** Optional leading glyph — auto `aria-hidden` and sized to `--spacing` 4. */
+    icon?: ReactNode;
+    /** `id` applied to the heading so panels can wire `aria-labelledby`. */
+    headingId?: string;
+    /** Semantic heading level. Default `2`. */
+    headingLevel?: 2 | 3;
+    /** Panel-owned actions, rendered inline-end of the title row. */
+    actions?: ReactNode;
+    /** Optional second row, typically filter controls. */
+    filters?: ReactNode;
+    /** Pin to the top of the scroll region. Default `false`. */
+    sticky?: boolean;
+    /** Bottom hairline. Default `true`. */
+    divider?: boolean;
+    /** Type scale of the heading. Default `'card'`. */
+    titleScale?: 'card' | 'section';
+}
+export declare const PanelHeader: import("react").ForwardRefExoticComponent<PanelHeaderProps & import("react").RefAttributes<HTMLElement>>;
+export {};
+//# sourceMappingURL=panel-header.d.ts.map

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-DgfTJimE.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-CBC_ySF6.js";
+import { P as t, p as r } from "../../_chunks/patient-search-CSWQKOSP.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-B836_fDB.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-D4NdgYJB.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/columns.d.ts

@@ -2,44 +2,55 @@
  * 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`.
+ * 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 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.
+ * 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`).
  *
- * 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.
+ * 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, PatientRow, PatientRowAction, ResponsiveTier } from './types';
+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
@@ -55,15 +66,17 @@ export type PatientColDefWithTier = PatientColDef & {
 };
 /**
  * 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).
+ * 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) in the Contact/Email cells. Forwarded
-     * to `ContactCell`'s `hideDetails` param. Default `false`.
+     * Mask sensitive contact details (email) — when `true` the `email` column
+     * ships hidden. Forwarded from `PatientTable`'s `hidePatientDetails`. Default
+     * `false`.
      */
     hideDetails?: boolean;
     /**
@@ -82,21 +95,37 @@ export interface BuildPatientColumnsOptions {
      */
     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
+     * 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[];
 }
 /**
- * Build the ordered patient-grid column definitions.
+ * 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.
- * @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.
+ *             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

@@ -8,17 +8,13 @@
  */
 export { PatientTable } from './patient-table';
 export type { PatientTableProps } from './patient-table';
-export { buildPatientColumns, getResponsiveTier, type BuildPatientColumnsOptions, type PatientColDefWithTier, } from './columns';
+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, 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 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';
-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

@@ -1,13 +1,12 @@
-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";
+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-CERknpd8.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
+  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

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

@@ -4,10 +4,12 @@
  * `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
+ *   • `buildPatientColumns(t, …)` (one field per column — split identity,
+ *     grouped hidden columns, dynamic custom fields) merged with a
  *     consumer-supplied `columns` override.
- *   • the patient cell renderers (Identity / NextAppointment / BalanceBadge /
- *     CarePlanStatus / Contact) via the column defs above.
+ *   • the kit data-table built-in renderers (Image / Link / Date / Currency /
+ *     Status / TagList / User) plus the three patient renderers kept for the
+ *     domain columns (NextAppointment / BalanceBadge / CarePlanStatus).
  *   • a default toolbar — `QuickSearch` + `FilterChips` + `ColumnToggle` +
  *     `ExportMenu` + a `BulkAction` per `props.bulkActions` — overridable
  *     wholesale via `props.toolbar`.
@@ -35,7 +37,7 @@
  */
 import { type ReactNode } from 'react';
 import { type BuildPatientColumnsOptions } from './columns';
-import type { PatientBulkAction, PatientColumnDef, PatientRow, PatientRowAction, PatientTableHandle, PatientView } from './types';
+import type { PatientBulkAction, PatientColumnDef, PatientCustomFieldDef, PatientRow, PatientRowAction, PatientTableHandle, PatientView } from './types';
 export interface PatientTableProps {
     /**
      * Row data. `undefined` ⇒ the grid renders its loading overlay (the
@@ -59,6 +61,24 @@ export interface PatientTableProps {
     gridId: string;
     /** Row-height preset. Defaults to the engine default (`'default'`). */
     density?: 'compact' | 'default' | 'expanded';
+    /**
+     * Collapse the per-row actions column into a single "…" overflow trigger
+     * independently of row `density`. When `true` the actions cells render the
+     * collapsed menu and the column shrinks to its 88px compact footprint; when
+     * `false` they render the inline button group at the full expanded width.
+     * When `undefined` (the default) compactness FOLLOWS `density` — `compact`
+     * density collapses the actions, every other density keeps them inline — so
+     * existing consumers are unaffected. Flipping this at runtime re-reads the
+     * actions cells via a stable ref-backed getter (no `columnDefs` rebuild, so
+     * column state is preserved) and resizes the actions column to match.
+     */
+    actionsCompact?: boolean;
+    /**
+     * Grid height — forwarded to the underlying `DataTable.heightClass` (a Tailwind
+     * height class). Pass `"ds:h-full"` to fill a sized parent, or an explicit
+     * value like `"ds:h-[75vh]"`. Omit to use the engine default (`ds:h-[500px]`).
+     */
+    heightClass?: string;
     /**
      * Enable container-width column-priority responsiveness (lower-priority
      * columns hide as the grid narrows). Default `true`. Set `false` to leave
@@ -109,6 +129,13 @@ export interface PatientTableProps {
      * affordance elsewhere on the page.
      */
     hideQuickSearch?: boolean;
+    /**
+     * Enable the grid's client-side pagination. When `false`, every row loads into
+     * a single virtualised, scrollable view and filter / sort act over the WHOLE
+     * set (no pager) — the right model for a "load and filter all" list. Default
+     * `true`.
+     */
+    pagination?: boolean;
     /**
      * Page-size dropdown options shown in the pagination panel — forwarded to the
      * underlying `DataTable.paginationPageSizeSelector`. Pass `false` to hide the
@@ -129,6 +156,13 @@ export interface PatientTableProps {
      * its click through `onRowAction` with the `show` action.
      */
     identityHref?: BuildPatientColumnsOptions['identityHref'];
+    /**
+     * Per-practice custom-field descriptors. Each appends one dynamic `custom:*`
+     * column (hidden by default, toggleable via ColumnToggle) after the standard
+     * columns. Forwarded to `buildPatientColumns`. Ignored when `columns` is
+     * supplied (the consumer owns their columns then).
+     */
+    customFields?: PatientCustomFieldDef[];
     /** Override the default region aria-label (`ui.patientTable.regionLabel`). */
     'aria-label'?: string;
     /** Extra class names merged onto the inner grid wrapper. */

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

@@ -31,6 +31,23 @@ import type { DataTableHandle, DataTableSortEntry } from '../data-table';
 export type PatientMarketingConsent = 0 | 1 | 2;
 /** Biological-sex marker used for the demographic column / gender filter. */
 export type PatientGender = 'm' | 'f' | 'x';
+/**
+ * A per-practice custom field descriptor. Drives the dynamic `custom:*` columns
+ * appended after the standard ones by `buildPatientColumns`. The `label` is
+ * practice-defined display copy — NOT i18n-keyed (it is the header verbatim).
+ */
+export interface PatientCustomFieldDef {
+    /** Stable descriptor id. */
+    id: string;
+    /** Key into {@link PatientRow.customFields}. */
+    fieldName: string;
+    /** Practice-defined header label — rendered verbatim, never i18n-keyed. */
+    label: string;
+    /** Renderer + filter shape: plain text, a yes/no checkbox, or a chip. */
+    type: 'text' | 'checkbox' | 'dropdown';
+    /** Closed value set for `dropdown` fields (feeds the SelectFilter options). */
+    options?: string[];
+}
 /** Care-plan acceptance state surfaced by `CarePlanStatusCell`. */
 export type PatientCarePlanStatus = 'accepted' | 'estimate' | 'none';
 /** A single phone number plus its SMS-reminder eligibility. */
@@ -59,20 +76,47 @@ export interface PatientRow {
     emailEnabled: boolean;
     /** Whether the stored email passed validation. */
     emailValid?: boolean;
+    /** PEC (certified email) address. */
+    pecAddress?: string;
     phoneNumbers: PatientPhoneNumber[];
+    /** Whether the patient is eligible to receive SMS reminders. */
+    smsReminderEligible?: boolean;
+    /** Whether the patient is eligible to receive email reminders. */
+    emailReminderEligible?: boolean;
     /** ISO-8601 date string. Age is computed at the render boundary. */
     dateOfBirth?: string;
     gender?: PatientGender;
+    /** Place (comune) of birth. */
+    placeOfBirth?: string;
+    /** ISO-3166-1 alpha-2 country of birth. */
+    countryOfBirth?: string;
+    street?: string;
+    postcode?: string;
     city?: string;
     province?: string;
-    /** ISO-3166-1 alpha-2 country code. */
+    /** ISO-3166-1 alpha-2 country code (residence). */
     countryCode?: string;
     italianFiscalCode?: string;
+    /** Acquisition source (the practice-configured channel). */
     source?: string;
+    /** Free-text source override when `source` is `'Other'`. */
+    customSource?: string;
     defaultInsurance?: string;
+    /** Default discount percentage applied to this patient's plans. */
+    defaultDiscount?: number;
+    /** Primary clinical diagnosis note. */
+    diagnosis?: string;
+    /** Patient's occupation. */
+    job?: string;
     /** Operator / personal assistant the patient is assigned to. */
     personalAssistant?: string;
     marketingConsent: PatientMarketingConsent;
+    /** Year component of the yearly patient numbering (`YYYY`). */
+    yearlyNumberingYear?: number;
+    /** Sequence component of the yearly patient numbering (`N`). */
+    yearlyNumberingNumber?: number;
+    /** Whether the patient has a MyDentista portal account. */
+    mydentista?: boolean;
     nextAppointment?: string;
     lastAppointment?: string;
     /** Outstanding balance in cents. */
@@ -84,13 +128,19 @@ export interface PatientRow {
     /** ISO-8601 creation timestamp. */
     createdAt: string;
     isArchived?: boolean;
+    /**
+     * Per-practice custom-field values, keyed by `PatientCustomFieldDef.fieldName`.
+     * Strings for text/dropdown fields; booleans for checkbox fields. Surfaced by
+     * the dynamic `custom:*` columns. Never a DOM attribute (PHI rule).
+     */
+    customFields?: Record<string, string | boolean>;
 }
 /**
  * Stable column ids for the patient grid. Drives `ColumnToggle`, the
  * responsive-priority map, view presets and the agent column address.
  * Keep in sync with `buildPatientColumns(t)`.
  */
-export type PatientColumnId = 'select' | 'identity' | 'actions' | 'nextAppointment' | 'unpaidBalance' | 'phone' | 'email' | 'carePlanStatus' | 'lastVisit' | 'dateOfBirth' | 'gender' | 'source' | 'defaultInsurance' | 'fiscalCode' | 'tags' | 'assignedMember' | 'createdAt';
+export type PatientColumnId = 'select' | 'avatar' | 'lastName' | 'actions' | 'firstName' | 'fiscalCode' | 'age' | 'gender' | 'dateOfBirth' | 'placeOfBirth' | 'countryOfBirth' | 'phone' | 'email' | 'smsReminders' | 'emailReminders' | 'pec' | 'nextAppointment' | 'lastVisit' | 'unpaidBalance' | 'billableAmount' | 'discount' | 'carePlanStatus' | 'diagnosis' | 'insurance' | 'assignedTo' | 'job' | 'source' | 'marketingConsent' | 'patientNumber' | 'portal' | 'createdAt' | 'city' | 'province' | 'postcode' | 'country' | 'street' | `custom:${string}`;
 /**
  * Responsive priority tier. Lower numbers survive longer as the grid narrows:
  * `P0` always visible, `P3` first to hide. The responsive hook toggles

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

@@ -9,13 +9,15 @@
  *
  * BREAKPOINTS (container inline-size → highest tier kept visible):
  *
- *   < 640px   → P0 only          (Identity + Actions; both are grid-anchored)
- *   < 900px   → P0 + P1
- *   < 1200px  → P0 + P1 + P2
- *   ≥ 1200px  → all tiers (P0–P3)
+ *   < 640px   → P0 only          (pinned avatar / firstName / lastName / actions)
+ *   < 900px   → P0 + P1          (+ phone, nextAppointment, balance)
+ *   < 1200px  → P0 + P1 + P2     (+ email, carePlanStatus)
+ *   ≥ 1200px  → all tiers (P0–P3) (+ fiscalCode, age, gender, source)
  *
- * Columns without a tier (the pinned Identity + Actions columns) are never
- * touched — they are the row anchors and stay visible at every width.
+ * Columns without a tier (the pinned avatar / firstName / lastName / actions
+ * anchors, and every grouped `hide: true` column) are never touched — the
+ * anchors stay visible at every width; the grouped columns are owned by
+ * ColumnToggle only.
  *
  * RESPONSIVE ↔ PERSISTENCE RECONCILIATION
  * ---------------------------------------

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

@@ -1,4 +1,4 @@
-import { P as t, a as n, p as r, b as s } from "../../_chunks/payment-request-card-DioWKBUq.js";
+import { P as t, a as n, p as r, b as s } from "../../_chunks/payment-request-card-Blf-MFNY.js";
 export {
   t as PaymentCard,
   n as PaymentRequestCard,

package/dist/components/payment-form/index.js

@@ -1,4 +1,4 @@
-import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-DvjwYVIT.js";
+import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-CxqIXqw7.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,