@alfadocs/ui-kit 0.68.0 → 0.70.0

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

@@ -0,0 +1,172 @@
+/**
+ * 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, …)` (one field per column — split identity,
+ *     grouped hidden columns, dynamic custom fields) merged with a
+ *     consumer-supplied `columns` override.
+ *   • 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`.
+ *   • `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, PatientCustomFieldDef, 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';
+    /**
+     * 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
+     * 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;
+    /**
+     * 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
+     * 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'];
+    /**
+     * 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. */
+    className?: string;
+}
+export declare const PatientTable: import("react").ForwardRefExoticComponent<PatientTableProps & import("react").RefAttributes<PatientTableHandle>>;
+//# sourceMappingURL=patient-table.d.ts.map

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

@@ -0,0 +1,222 @@
+/**
+ * patient-table — domain types
+ * ----------------------------------------------------------------------------
+ * Type surface for the `patient-table` Domain-Specific component, a thin
+ * composition over the kit's `data-table` engine (AG Grid Community).
+ *
+ * CONVENTIONS (CI-blocking — see src/docs/23-constraints.mdx + 26-agent-readiness.mdx):
+ *
+ * • MONEY IS INTEGER CENTS. Every monetary field on `PatientRow`
+ *   (`unpaidAmount`, `billableAmount`) and on the financial thresholds is the
+ *   smallest currency unit (cents). Format to a display currency only at the
+ *   render boundary — never store fractional units.
+ *
+ * • PHI MUST NEVER REACH THE DOM. Only `PatientRow.id` may appear in DOM
+ *   `data-*` attributes (PRS 26 §6). Name, date of birth, email, phone, fiscal
+ *   code and every other identifying field stay out of attribute hooks, agent
+ *   snapshots and selectors. Renderers surface them as text content only.
+ *
+ * These types are the public contract for `buildPatientColumns(t)`, the patient
+ * cell renderers, and the `PatientTable` component (Phase 2). They carry no
+ * runtime values — pure type declarations.
+ *
+ * GROUND-TRUTH NOTE: `ColDef` / `ColGroupDef` are NOT re-exported from the
+ * data-table barrel; they are imported here straight from `ag-grid-community`,
+ * exactly as `data-table.tsx` does. `DataTableHandle` IS re-exported from the
+ * barrel and is imported from there.
+ */
+import type { ColDef, ColGroupDef } from 'ag-grid-community';
+import type { DataTableHandle, DataTableSortEntry } from '../data-table';
+/** Tri-state marketing consent: `0` = no, `1` = yes, `2` = not specified. */
+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. */
+export interface PatientPhoneNumber {
+    /** Display string, e.g. `"+39 055 123 4567"`. Never a DOM attribute value. */
+    number: string;
+    /** Whether SMS reminders can be sent to this number. */
+    smsEnabled: boolean;
+}
+/**
+ * The patient row model rendered by `patient-table`.
+ *
+ * Mirrors the story-only mock schema in the workflow plan. `id` is the ONLY
+ * field permitted in DOM `data-*` hooks (PHI rule); every other field is
+ * display/content-only. Monetary amounts (`unpaidAmount`, `billableAmount`)
+ * are integer cents.
+ */
+export interface PatientRow {
+    /** Stable identifier — the ONLY field allowed in DOM data-* (PHI rule). */
+    id: string;
+    firstName: string;
+    lastName: string;
+    avatarUrl?: string;
+    email?: string;
+    /** Whether email contact is enabled — gates the email-reminder action. */
+    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 (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. */
+    unpaidAmount: number;
+    /** Billable plan value in cents. */
+    billableAmount: number;
+    carePlanStatus?: PatientCarePlanStatus;
+    tags?: string[];
+    /** 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' | '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
+ * column `hide` by tier; an explicit user ColumnToggle override wins and is
+ * what gets persisted.
+ */
+export type ResponsiveTier = 'P0' | 'P1' | 'P2' | 'P3';
+/** Closed set of per-row action keys. */
+export type PatientRowActionKey = 'show' | 'edit' | 'sendEmailReminder' | 'sendSmsReminder' | 'reassign' | 'delete';
+/**
+ * A per-row action descriptor. `id` is the stable key; the display fields feed
+ * the `ActionsCellRenderer` (icon + accessible label + intent). Visibility and
+ * disablement are resolved per-row against the `PatientRow` at render time.
+ */
+export interface PatientRowAction {
+    /** Stable action key — the value passed back to `onRowAction`. */
+    id: PatientRowActionKey;
+    /** Localised accessible label / tooltip. */
+    label: string;
+    /** Lucide-style icon node (sized by the renderer). */
+    icon?: import('react').ReactNode;
+    /** `destructive` swaps the button intent (e.g. delete). */
+    variant?: 'default' | 'destructive';
+    /** Hide the action for a given row (e.g. SMS reminder with no SMS phone). */
+    hidden?: boolean | ((patient: PatientRow) => boolean);
+    /** Disable the action for a given row. */
+    disabled?: boolean | ((patient: PatientRow) => boolean);
+    /** Human-readable reason shown in the tooltip when disabled. */
+    disabledReason?: string;
+}
+/** Closed set of bulk-action keys (operate on the current selection). */
+export type PatientBulkActionKey = 'exportCsv' | 'exportPdf' | 'reassign' | 'tag' | 'sendReminder' | 'delete';
+/**
+ * A bulk-action descriptor for the toolbar. Invoked with the selected row ids
+ * (resolved from `DataTableHandle.getSelection()`); only ids cross this
+ * boundary — never PHI.
+ */
+export interface PatientBulkAction {
+    /** Stable bulk-action key. */
+    id: PatientBulkActionKey;
+    /** Localised button label. */
+    label: string;
+    /** Lucide-style icon node. */
+    icon?: import('react').ReactNode;
+    /** `destructive` swaps the button intent (e.g. bulk delete). */
+    variant?: 'default' | 'destructive';
+    /** Invoked with the ids of the currently-selected rows. */
+    onSelect: (selectedIds: string[]) => void;
+}
+/**
+ * A saved view: a named column/filter/sort preset applied to the grid.
+ * `columns` is the ordered, visible subset; `filterModel` and `sortModel` are
+ * fed straight to `DataTableHandle.setFilter` / `setSort`.
+ */
+export interface PatientView {
+    /** Stable view id. */
+    id: string;
+    /** Localised view label shown in the view switcher. */
+    label: string;
+    /** Ordered list of visible columns for this view. */
+    columns: PatientColumnId[];
+    /** AG Grid filter model passed to `DataTableHandle.setFilter`. */
+    filterModel: Record<string, unknown>;
+    /** Sort model passed to `DataTableHandle.setSort`. */
+    sortModel: DataTableSortEntry[];
+}
+/**
+ * The curated imperative handle exposed by `PatientTable` via `forwardRef`,
+ * specialised to `PatientRow`. Re-exported so column/renderer/component files
+ * import a single patient-typed handle.
+ */
+export type PatientTableHandle = DataTableHandle<PatientRow>;
+/** Column definition typed to `PatientRow` (AG Grid Community). */
+export type PatientColDef = ColDef<PatientRow>;
+/** Column-group (two-row header) definition typed to `PatientRow`. */
+export type PatientColGroupDef = ColGroupDef<PatientRow>;
+/** Mixed leaf / group column-definition array, as `DataTable.columnDefs` expects. */
+export type PatientColumnDef = PatientColDef | PatientColGroupDef;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1,111 @@
+/**
+ * patient-table — responsive column hook
+ * ----------------------------------------------------------------------------
+ * `useResponsiveColumns(handleRef, opts)` toggles column visibility by the
+ * `responsiveTier` (`P0`–`P3`) baked onto each `ColDef` by `buildPatientColumns`,
+ * driven by the *grid container's* width — measured with a `ResizeObserver`, NOT
+ * the viewport — so the table responds correctly when embedded in a narrow panel,
+ * split pane or sidebar rather than only at browser-window breakpoints.
+ *
+ * BREAKPOINTS (container inline-size → highest tier kept visible):
+ *
+ *   < 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 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
+ * ---------------------------------------
+ * `data-table.tsx` persists the full AG Grid column state to
+ * `localStorage["data-table-col-state:<gridId>"]` (load on grid-ready, save on
+ * unmount). A user's explicit `ColumnToggle` choice lives in that persisted state
+ * and MUST win over — and survive — the responsive baseline. Reconciliation:
+ *
+ *   1. The responsive baseline is exactly that — a *baseline*. We only auto
+ *      show/hide a column the user has NOT manually toggled this session.
+ *   2. We track a `Set<colId>` of user-touched columns. We learn of a manual
+ *      toggle from the grid's `columnVisible` event: any such event whose
+ *      `source` is NOT `'api'` is user-driven (ColumnToggle tool panel, column
+ *      menu, context menu, drag), so we add those colIds to the set. Our own
+ *      responsive calls go through `setColumnsVisible(..., 'api')`, so they never
+ *      pollute the set (and we additionally guard with a re-entrancy flag).
+ *   3. Once a column is user-touched, the hook leaves it alone forever this
+ *      session — its visibility is whatever the user chose, which is what
+ *      `data-table.tsx` then persists on unmount. The persisted choice therefore
+ *      wins on the next mount too: we seed the user-touched set from the saved
+ *      column state so a previously hidden/shown column is treated as a manual
+ *      override and not clobbered by the baseline on re-entry.
+ *
+ * CONSTRAINTS: no `any` (AG Grid's `ColumnEventType` is read off the typed event,
+ * tier read via the typed `getResponsiveTier` helper). No DOM `data-*` attribute
+ * is written here (PHI rule is moot — this hook only reads colIds and widths).
+ */
+import { type RefObject } from 'react';
+import type { PatientTableHandle, ResponsiveTier } from './types';
+/**
+ * Container inline-size breakpoints. Each entry is the *minimum* container width
+ * (px) at which the named tier becomes visible. Below the first threshold only
+ * `P0` shows; at or above the last, everything shows.
+ */
+interface Breakpoint {
+    /** Minimum container inline-size (px) for this tier to be shown. */
+    minWidth: number;
+    /** The tier this breakpoint reveals. */
+    tier: ResponsiveTier;
+}
+export interface UseResponsiveColumnsOptions {
+    /**
+     * The grid container element to observe. The hook measures THIS element's
+     * inline-size (not the viewport) so it works embedded. When the ref is unset
+     * the hook is inert.
+     */
+    containerRef: RefObject<HTMLElement | null>;
+    /**
+     * Disable responsive toggling entirely (the `responsive={false}` escape hatch
+     * on `PatientTable`). When `false` the hook unobserves and makes no visibility
+     * changes — column visibility is left entirely to persistence / ColumnToggle.
+     * Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * Override the container-width breakpoints. Ordered low→high `minWidth`; each
+     * reveals its `tier`. Defaults to 640 / 900 / 1200 (P1 / P2 / P3).
+     */
+    breakpoints?: readonly Breakpoint[];
+}
+/**
+ * Imperative surface returned by {@link useResponsiveColumns}. The responsive
+ * effect runs internally; `lockColumns` lets a caller (the view switcher) mark
+ * columns as user-touched so the responsive baseline stops auto-managing them.
+ */
+export interface UseResponsiveColumnsResult {
+    /**
+     * Mark the given colIds as "user-touched" so the responsive baseline leaves
+     * their visibility alone from here on — exactly as if the user had toggled
+     * them via `ColumnToggle`. The view switcher calls this when it applies a
+     * view's column visibility, so its programmatic (`source: 'api'`) visibility
+     * writes are not immediately re-hidden/re-shown by the next responsive
+     * reconcile pass. No-op (with the colIds still recorded for a later mount of
+     * the effect) when the hook is disabled.
+     */
+    lockColumns: (colIds: readonly string[]) => void;
+}
+/**
+ * Wire responsive, tier-driven column visibility to the patient grid.
+ *
+ * @param handleRef The `PatientTable` imperative handle ref — the hook reaches
+ *                  the raw AG Grid API via `handleRef.current.getRawApi()`.
+ * @param opts      Container ref to observe, plus enable flag / breakpoint
+ *                  overrides. See {@link UseResponsiveColumnsOptions}.
+ * @returns         {@link UseResponsiveColumnsResult} — `lockColumns(colIds)`
+ *                  to mark columns user-touched (see the view-switcher
+ *                  coordination note in patient-table.tsx).
+ */
+export declare function useResponsiveColumns(handleRef: RefObject<PatientTableHandle | null>, opts: UseResponsiveColumnsOptions): UseResponsiveColumnsResult;
+export {};
+//# sourceMappingURL=use-responsive-columns.d.ts.map

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-CYE5vhZ0.js";
+import { P as t, a as n, p as r, b as s } from "../../_chunks/payment-request-card-BcZJwu9z.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-nXocS_MX.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,

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-GsfNqeeT.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-QfebdLOd.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/periodontal-chart-card/index.js

@@ -1,4 +1,4 @@
-import { P as o, a as t, p as d } from "../../_chunks/periodontal-chart-card-Dh3KgvYG.js";
+import { P as o, a as t, p as d } from "../../_chunks/periodontal-chart-card-hRRJY1NN.js";
 export {
   o as PERIODONTAL_SITE_ORDER,
   t as PeriodontalChartCard,

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

@@ -1,4 +1,4 @@
-import { P as n, c as p, p as t, a as e } from "../../_chunks/phone-input-DVXhNlIl.js";
+import { P as n, c as p, p as t, a as e } from "../../_chunks/phone-input-DjU-XmO_.js";
 export {
   n as PhoneInput,
   p as countryTriggerVariants,

package/dist/components/popover/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as r } from "../../_chunks/popover-DTbfAuR0.js";
+import { P as e, p as r } from "../../_chunks/popover-B2qCDhJC.js";
 export {
   e as Popover,
   r as popoverAgent

package/dist/components/practice-results/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as a } from "../../_chunks/practice-results-DND2SAt7.js";
+import { P as t, p as a } from "../../_chunks/practice-results-C6qDfxos.js";
 export {
   t as PracticeResults,
   a as practiceResultsAgent

package/dist/components/pregnancy-dating/index.js

@@ -1,4 +1,4 @@
-import { P as r } from "../../_chunks/pregnancy-dating-QY-sqpvj.js";
+import { P as r } from "../../_chunks/pregnancy-dating-CRVWswD-.js";
 export {
   r as PregnancyDating
 };

package/dist/components/pregnancy-weight-gain/index.js

@@ -1,4 +1,4 @@
-import { P as s, R as n, T as i, a as r, r as A } from "../../_chunks/pregnancy-weight-gain-DOJXXNYP.js";
+import { P as s, R as n, T as i, a as r, r as A } from "../../_chunks/pregnancy-weight-gain-BUNpTsH-.js";
 export {
   s as PregnancyWeightGain,
   n as RATE_BANDS,

package/dist/components/privacy-lock/index.js

@@ -1,4 +1,4 @@
-import { P as o, p as r } from "../../_chunks/privacy-lock-C7JyMf0y.js";
+import { P as o, p as r } from "../../_chunks/privacy-lock-BzMLQu-j.js";
 export {
   o as PrivacyLock,
   r as privacyLockAgent

package/dist/components/product-hub-tray/index.js

@@ -1,4 +1,4 @@
-import { P as u, a as o, p as t, b as e } from "../../_chunks/product-hub-panel-CAXDFeGP.js";
+import { P as u, a as o, p as t, b as e } from "../../_chunks/product-hub-panel-e6pW220e.js";
 import { i as s } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   u as ProductHubPanel,

package/dist/components/progress/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as o } from "../../_chunks/progress-kzIRcdaq.js";
+import { P as e, p as o } from "../../_chunks/progress-DA413-zn.js";
 export {
   e as Progress,
   o as progressAgent

package/dist/components/public-footer/index.js

@@ -1,4 +1,4 @@
-import { D as s, a as A, P as L, S as e, c as S, p as _ } from "../../_chunks/public-footer.agent-CfXuW1x6.js";
+import { D as s, a as A, P as L, S as e, c as S, p as _ } from "../../_chunks/public-footer.agent-D0cFbjWl.js";
 export {
   s as DEFAULT_MARKETING_BASE_URL,
   A as DEFAULT_SOCIAL_URLS,

package/dist/components/public-header/index.js

@@ -1,4 +1,4 @@
-import { P as r, p } from "../../_chunks/public-header.agent-BOhJgZEU.js";
+import { P as r, p } from "../../_chunks/public-header.agent-DqkqA-ca.js";
 export {
   r as PublicHeader,
   p as publicHeaderAgent

package/dist/components/qr-code/index.js

@@ -1,4 +1,4 @@
-import { Q as a, c as s, q as t, s as o } from "../../_chunks/qr-code-DNXhi6se.js";
+import { Q as a, c as s, q as t, s as o } from "../../_chunks/qr-code-CPkEs5mG.js";
 export {
   a as QrCode,
   s as createQrMatrix,

package/dist/components/radio-group/index.js

@@ -1,5 +1,5 @@
 import { R as a } from "../../_chunks/radio-TWf9Q-mp.js";
-import { R as p } from "../../_chunks/radio-group-CLjK-SlK.js";
+import { R as p } from "../../_chunks/radio-group-BPt7pKZW.js";
 export {
   a as Radio,
   p as RadioGroup

package/dist/components/radiograph-panel/index.d.ts

@@ -0,0 +1,4 @@
+export { RadiographPanel, RadiographPanelIcon } from './radiograph-panel';
+export type { RadiographPanelProps, RadiographPanelHandle, } from './radiograph-panel';
+export { radiographPanelAgent } from './radiograph-panel.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,7 @@
+import { R as o, a as e, r as n } from "../../_chunks/radiograph-panel.agent-CAX-C3g3.js";
+export {
+  o as RadiographPanel,
+  e as RadiographPanelIcon,
+  n as radiographPanelAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/radiograph-panel/radiograph-panel.agent.d.ts

@@ -0,0 +1,13 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { RadiographPanelHandle } from './radiograph-panel';
+import type { Radiograph } from '../tooth-scheme';
+/**
+ * The Imaging panel for the Control Room rail. It DISPLAYS the selected tooth's
+ * radiographs and drives the fullscreen viewer; uploads and deletes are the
+ * host's responsibility (the `onAddRadiograph` / `onDeleteRadiograph` props),
+ * so they are not exposed here — the consuming pattern/app owns those `write` /
+ * `destructive` workflows and their `radiograph.*` API contracts.
+ */
+export declare const radiographPanelAgent: AgentAdapter<RadiographPanelHandle>;
+export type { Radiograph };
+//# sourceMappingURL=radiograph-panel.agent.d.ts.map