@alfadocs/ui-kit 0.67.1 → 0.69.0

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

@@ -0,0 +1,172 @@
+/**
+ * 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';
+/** 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;
+    phoneNumbers: PatientPhoneNumber[];
+    /** ISO-8601 date string. Age is computed at the render boundary. */
+    dateOfBirth?: string;
+    gender?: PatientGender;
+    city?: string;
+    province?: string;
+    /** ISO-3166-1 alpha-2 country code. */
+    countryCode?: string;
+    italianFiscalCode?: string;
+    source?: string;
+    defaultInsurance?: string;
+    /** Operator / personal assistant the patient is assigned to. */
+    personalAssistant?: string;
+    marketingConsent: PatientMarketingConsent;
+    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;
+}
+/**
+ * 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';
+/**
+ * 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,109 @@
+/**
+ * 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          (Identity + Actions; both are grid-anchored)
+ *   < 900px   → P0 + P1
+ *   < 1200px  → P0 + P1 + P2
+ *   ≥ 1200px  → all tiers (P0–P3)
+ *
+ * Columns without a tier (the pinned Identity + Actions columns) are never
+ * touched — they are the row anchors and stay visible at every width.
+ *
+ * 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-DioWKBUq.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-DvjwYVIT.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-D6BPfW2D.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-BuDEMbHE.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-KrTHqZua.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-DORUAOHB.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-DVz4rr7-.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/recaptcha-widget/index.js

@@ -1,4 +1,4 @@
-import { R as t, r as c } from "../../_chunks/recaptcha-widget-BCNHsgqt.js";
+import { R as t, r as c } from "../../_chunks/recaptcha-widget-BC-4To9b.js";
 export {
   t as RecaptchaWidget,
   c as recaptchaWidgetAgent

package/dist/components/resizable/index.js

@@ -1,4 +1,4 @@
-import { H as s, P as l, a as n, R as r, r as o, u as t } from "../../_chunks/resizable-3vzqDlg6.js";
+import { H as s, P as l, a as n, R as r, r as o, u as t } from "../../_chunks/resizable-DVGcfOrk.js";
 export {
   s as Handle,
   l as Panel,

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

@@ -1,4 +1,4 @@
-import { R as r, r as s } from "../../_chunks/reviews-panel-DBktKm7i.js";
+import { R as r, r as s } from "../../_chunks/reviews-panel-Dq7LMDcH.js";
 export {
   r as ReviewsPanel,
   s as reviewsPanelAgent

package/dist/components/rich-text-editor/index.js

@@ -1,4 +1,4 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-DAeCXiQG.js";
+import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-BsV7zUdg.js";
 export {
   a as RichTextEditor,
   e as richTextEditorAgent,

package/dist/components/rich-text-editor/rich-text-editor.d.ts

@@ -67,6 +67,21 @@ export interface RichTextEditorProps {
         onPartialTranscript: (text: string) => void;
         onFinalTranscript: (text: string) => void;
     }) => Promise<void>;
+    /**
+     * One-shot AI document actions (CONSUMER-PROVIDED backend). Each gets the
+     * current HTML + an AbortSignal and resolves with rewritten HTML; while one
+     * runs the editor is disabled with a spinner and the result replaces the whole
+     * document. `onProofread` corrects spelling/grammar; `onAutoFormat` tidies the
+     * document's structure/formatting. Each adds a FAB segment when provided.
+     */
+    onProofread?: (ctx: {
+        html: string;
+        signal: AbortSignal;
+    }) => Promise<string>;
+    onAutoFormat?: (ctx: {
+        html: string;
+        signal: AbortSignal;
+    }) => Promise<string>;
 }
 /** Block/inline formats the editor can toggle via `applyFormat`. */
 export type EditorFormat = 'bold' | 'italic' | 'strikethrough' | 'bulletedList' | 'numberedList' | 'heading' | 'quote' | 'paragraph';

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

@@ -1,4 +1,4 @@
-import { S as e, f as s, s as t } from "../../_chunks/search-bar-SY2BcV2N.js";
+import { S as e, f as s, s as t } from "../../_chunks/search-bar-C_T3pBJn.js";
 export {
   e as SearchBar,
   s as filterSearchResults,

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

@@ -1,5 +1,5 @@
-import { S as t } from "../../_chunks/search-input-DbxrnHkW.js";
-import { s as o } from "../../_chunks/search-input.agent-CfZvViOd.js";
+import { S as t } from "../../_chunks/search-input-DQvGxR74.js";
+import { s as o } from "../../_chunks/search-input.agent-DRH54coT.js";
 export {
   t as SearchInput,
   o as searchInputAgent

package/dist/components/select/index.js

@@ -1,4 +1,4 @@
-import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-CEtRcon5.js";
+import { S as a, a as l, b as S, c, d as s, e as o, f as r, g as p, h as g, i, j as m } from "../../_chunks/select-DMLG44F5.js";
 export {
   a as Select,
   l as SelectContent,

package/dist/components/session-countdown/index.js

@@ -1,4 +1,4 @@
-import { S as n, s as e } from "../../_chunks/session-countdown-LPnhTHjn.js";
+import { S as n, s as e } from "../../_chunks/session-countdown-X1Ki6i0M.js";
 export {
   n as SessionCountdown,
   e as sessionCountdownAgent

package/dist/components/sheet/index.js

@@ -1,4 +1,4 @@
-import { S as t, s as a } from "../../_chunks/sheet-taJer-Ha.js";
+import { S as t, s as a } from "../../_chunks/sheet-BxsE7eQm.js";
 export {
   t as Sheet,
   a as sheetAgent

package/dist/components/sidebar/index.js

@@ -1,4 +1,4 @@
-import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as p, k as l, l as c, m as g, n as u, o as I, p as P, q as f, s as h, u as B } from "../../_chunks/sidebar-DaB4ulxH.js";
+import { S as r, a as i, b as s, c as d, d as S, e as b, f as t, g as o, h as m, i as n, j as p, k as l, l as c, m as g, n as u, o as I, p as P, q as f, s as h, u as B } from "../../_chunks/sidebar-DY9jGjgt.js";
 import { u as k } from "../../_chunks/use-persistent-state-i23OWy6G.js";
 export {
   r as Sidebar,

package/dist/components/sidebar/sidebar.d.ts

@@ -75,6 +75,13 @@ declare const SidebarGroup: import("react").ForwardRefExoticComponent<SidebarGro
 export interface SidebarItemProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
     /** Mark the item as the current page (`aria-current='page'`). */
     isActive?: boolean;
+    /**
+     * Stable identifier emitted as `data-nav-id` on the rendered row so an agent
+     * can locate and activate this nav item without traversing React state.
+     * Optional — when omitted the row carries no nav id. (See sidebar.agent.ts
+     * `domHooks.item`.)
+     */
+    navId?: string;
     /** Render through Radix `Slot` so a router link can take over. */
     asChild?: boolean;
     /**

package/dist/components/sign-document/index.js

@@ -1,4 +1,4 @@
-import { S as o, s } from "../../_chunks/sign-document-CdAiHiCh.js";
+import { S as o, s } from "../../_chunks/sign-document-B4DeRhTe.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

package/dist/components/signature-capture/index.js

@@ -1,4 +1,4 @@
-import { S as r, s as t } from "../../_chunks/signature-capture-COi0Uiqu.js";
+import { S as r, s as t } from "../../_chunks/signature-capture-Ct_4Md4e.js";
 export {
   r as SignatureCapture,
   t as signatureCaptureAgent

package/dist/components/slider/index.js

@@ -1,4 +1,4 @@
-import { S as o } from "../../_chunks/slider-BHWzXdjt.js";
+import { S as o } from "../../_chunks/slider-DN1CWkKB.js";
 export {
   o as Slider
 };

package/dist/components/sparkline/index.js

@@ -1,4 +1,4 @@
-import { S as r, s, u as n } from "../../_chunks/sparkline-DGhCSw8M.js";
+import { S as r, s, u as n } from "../../_chunks/sparkline-iOXYgvJe.js";
 export {
   r as Sparkline,
   s as sparklineAgent,

package/dist/components/stepper-accordion/index.js

@@ -1,5 +1,5 @@
 import { S as e } from "../../_chunks/stepper-accordion-Dki6r9ZE.js";
-import { s as t } from "../../_chunks/stepper-accordion.agent-C4quJ-MD.js";
+import { s as t } from "../../_chunks/stepper-accordion.agent-cmEguIdx.js";
 export {
   e as StepperAccordion,
   t as stepperAccordionAgent

package/dist/components/stepper-progress/index.js

@@ -1,4 +1,4 @@
-import { S as s, s as p } from "../../_chunks/stepper-progress-DDjq5nei.js";
+import { S as s, s as p } from "../../_chunks/stepper-progress-Bv0njx4g.js";
 export {
   s as StepperProgress,
   p as stepperProgressAgent

package/dist/components/suggestion-chip/index.js

@@ -1,5 +1,5 @@
 import { S as g, a as e } from "../../_chunks/suggestion-chip-Bk4PmYTg.js";
-import { s as p } from "../../_chunks/suggestion-chip.agent-6sNWFj7m.js";
+import { s as p } from "../../_chunks/suggestion-chip.agent-Brn3CiFE.js";
 export {
   g as SuggestionChip,
   e as SuggestionChipGroup,

package/dist/components/switch/index.js

@@ -1,4 +1,4 @@
-import { S as t } from "../../_chunks/switch-BJ6HD3Mn.js";
+import { S as t } from "../../_chunks/switch-OILsBLWo.js";
 export {
   t as Switch
 };

package/dist/components/tabs/index.js

@@ -1,4 +1,4 @@
-import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs-BIQ0ew1T.js";
+import { T as t, a as b, b as T, c as e, t as r } from "../../_chunks/tabs-BxcOziCo.js";
 export {
   t as Tabs,
   b as TabsContent,

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

@@ -1,5 +1,5 @@
 import { T as s, i as t } from "../../_chunks/task-card-BwY9jaV1.js";
-import { t as o } from "../../_chunks/task-card.agent-CUPKYd7w.js";
+import { t as o } from "../../_chunks/task-card.agent-Bt14CzUd.js";
 export {
   s as TaskCard,
   t as isSafeTaskUrl,

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

@@ -1,4 +1,4 @@
-import { T as s, t } from "../../_chunks/task-tray-CAncV-QQ.js";
+import { T as s, t } from "../../_chunks/task-tray-qOEQflu4.js";
 export {
   s as TaskTray,
   t as taskTrayAgent

package/dist/components/text-area/index.js

@@ -1,4 +1,4 @@
-import { T as a } from "../../_chunks/text-area-BIx0tZ05.js";
+import { T as a } from "../../_chunks/text-area-Bt3p7Pt0.js";
 export {
   a as TextArea
 };

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

@@ -1,4 +1,4 @@
-import { T as o } from "../../_chunks/text-input-BaClJL8Y.js";
+import { T as o } from "../../_chunks/text-input-B-OWQ1Je.js";
 export {
   o as TextInput
 };

package/dist/components/theme-toggle/index.js

@@ -1,4 +1,4 @@
-import { T as o, t } from "../../_chunks/theme-toggle-DETmSu_h.js";
+import { T as o, t } from "../../_chunks/theme-toggle-XB6o_lgs.js";
 export {
   o as ThemeToggle,
   t as themeToggleAgent

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

@@ -1,4 +1,4 @@
-import { T as r, t } from "../../_chunks/time-picker-B5umYwfv.js";
+import { T as r, t } from "../../_chunks/time-picker-BPlJWm8w.js";
 export {
   r as TimePicker,
   t as timePickerAgent

package/dist/components/timeline/index.js

@@ -1,4 +1,4 @@
-import { T as t, t as m } from "../../_chunks/timeline-DQa5Tyz4.js";
+import { T as t, t as m } from "../../_chunks/timeline-CqA4nKTI.js";
 export {
   t as Timeline,
   m as timelineAgent