mgh-components 1.1.3 → 1.2.1

package/README.md

@@ -2,12 +2,14 @@
 
 Metrolina Greenhouses (MGH) component library for React applications.
 
-This package ships two data grids:
+This package ships two data grids and a date range picker:
 
 - **`MGHGrid`** – a self-contained data grid with **no MUI dependency** (and therefore no
   `@mui/x-data-grid-premium` license). This is the grid to use going forward.
 - **`MGHDataGrid`** – the legacy wrapper around MUI X Data Grid Premium. It is kept for backwards
   compatibility and still requires the MUI peer dependencies.
+- **`MGHDateRangePicker`** – a MUI-free port of MUI X Pro's `DateRangePicker` (no
+  `@mui/x-date-pickers-pro` license).
 
 Plus a few helpers built on MUI (`Label`, `ConfirmDialog`, `ExportingDialog`, `Iconify`).
 
@@ -21,7 +23,7 @@ pnpm add mgh-components
 
 ## Peer Dependencies
 
-`MGHGrid` only needs:
+`MGHGrid` and `MGHDateRangePicker` only need:
 
 - `react`
 - `react-dom`
@@ -257,6 +259,71 @@ Or globally in your CSS:
 
 ---
 
+## MGHDateRangePicker (MUI-free)
+
+A port of MUI X Pro's `DateRangePicker` (desktop variant) with **no MUI dependency** and no
+`@mui/x-date-pickers-pro` license. Values are dayjs `[start, end]` tuples, so existing
+`DateRange<Dayjs>` state works unchanged.
+
+```tsx
+import { useState } from 'react';
+import type { Dayjs } from 'dayjs';
+import { MGHDateRangePicker, MGH_DATE_RANGE_DEFAULT_SHORTCUTS, type MGHDateRange } from 'mgh-components';
+
+export default function Example() {
+  const [range, setRange] = useState<MGHDateRange>([null, null]);
+
+  return (
+    <MGHDateRangePicker
+      label="Ship date"
+      value={range}
+      onChange={(value) => setRange(value)}
+      onAccept={(value) => refetch(value)}          // fires once the range is complete / accepted
+      shortcuts={MGH_DATE_RANGE_DEFAULT_SHORTCUTS}  // This Week, Last Week, Last 7 Days, Current Month, Next Month, Reset
+      clearable
+    />
+  );
+}
+```
+
+Drop it into the grid toolbar with `toolbarProps.renderDateRange` (or the card header with
+`renderHeaderCenterContent`) – inside an `MGHGrid` card it inherits the grid palette automatically,
+and without an explicit `themeMode` it follows the card's light / dark mode (popover included).
+
+### Props
+
+| Area | Details |
+| --- | --- |
+| Value | `value` / `defaultValue` / `onChange(value, { validationError, shortcut })`, `onAccept(value)`, `onError(error, value)` |
+| Field | `label`, `format` (`'MM/DD/YYYY'`), `fieldVariant` (`'single'` → "start – end" in one field, `'multi'` → Start and End fields), `size` (`'small'` \| `'medium'`), `fullWidth`, `clearable`, `placeholder`, `helperText`, `error`, `required`, `disabled`, `readOnly`, `name`, `id`, `inputRef` |
+| Opening | Calendar icon button (like MUI), `openOnClick` to also open from the text, `disableOpenPicker`, controlled `open` / `onOpen` / `onClose`, `placement` |
+| Calendar | `calendars` (1–3, default 2), `referenceDate`, `showDaysOutsideCurrentMonth`, `fixedWeekNumber`, `dayOfWeekFormatter`, `disableHighlightToday`, `showRangePreview`, `onMonthChange` |
+| Validation | `minDate`, `maxDate`, `disablePast`, `disableFuture`, `shouldDisableDate(day, position)`; errors: `invalidDate`, `invalidRange`, `minDate`, `maxDate`, `disablePast`, `disableFuture`, `shouldDisableDate` |
+| Selection | `rangePosition` / `onRangePositionChange`, `closeOnSelect` (default `true`, `false` when `actions` contains `'accept'`) |
+| Layout | `shortcuts` (`{ label, getValue }`, same shape as MUI `slotProps.shortcuts.items`), `actions` (`'clear'`, `'today'`, `'cancel'`, `'accept'`), `showToolbar` |
+| Theming | `themeMode="light" \| "dark"`, `themeVars` (any `--mgh-drp-*` variable), `className` / `style`, `popoverClassName` / `popoverStyle`, `localeText` |
+| Keyboard | Type dates directly (strict `format` plus `M/D/YYYY`, `YYYY-MM-DD` fallbacks), **↓** opens the calendar, arrows / Home / End / PageUp / PageDown move between days, Enter or Space selects, Escape closes |
+
+Selection follows MUI: the first click sets the start, the second sets the end and closes the
+popover (`closeOnSelect`). Picking an end before the start makes it the new start. Hovering while
+choosing the end previews the interval with a dashed outline.
+
+`MGHDateRangeCalendar` (the calendar without the field / popover) is exported for inline use.
+
+### Theming
+
+```tsx
+<MGHDateRangePicker themeMode="dark" themeVars={{ '--mgh-drp-primary': '#00a76f' }} … />
+```
+
+Or globally in your CSS:
+
+```css
+.mgh-drp, .mgh-drp-popover { --mgh-drp-primary: #00a76f; --mgh-drp-day-size: 40px; }
+```
+
+---
+
 ## Legacy: MGHDataGrid (MUI X Premium)
 
 ```tsx
@@ -273,6 +340,7 @@ import { MGHDataGrid } from 'mgh-components';
 
 ## Components
 
+- `MGHDateRangePicker` (+ `MGHDateRangeCalendar`, `MGH_DATE_RANGE_DEFAULT_SHORTCUTS`, `MGHDateRangeIcons`, `useMGHDateRangePickerStyles`)
 - `MGHGrid` (+ `MGHGridDefaultToolbar`, `MGHGridQuickFilter`, `MGHGridExportMenu`, `MGHGridExportMenuItem`,
   `MGHGridActionsCellItem`, `MGHGridNoRowsOverlay`, `MGHGridIcons`, `useMGHGridApiRef`, `useMGHGridApiContext`)
 - `MGHDataGrid`, `MGHGridToolbar`, `DataGridQuickFilter`, `CustomNoRowsOverlay`, `CustomGridToolbarExport` (legacy, MUI)

package/dist/components/MGHDateRangePicker/MGHDateRangeCalendar.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { MGHDateRangeCalendarProps } from './MGHDateRangePicker.types';
+/**
+ * Pure-React port of MUI X's `DateRangeCalendar`: one to three months side by side with range
+ * highlighting, hover preview, keyboard navigation and min/max/disabled-day validation.
+ */
+export declare function MGHDateRangeCalendar({ value: valueProp, defaultValue, onChange, rangePosition: rangePositionProp, onRangePositionChange, calendars, referenceDate, minDate, maxDate, disablePast, disableFuture, shouldDisableDate, disabled, readOnly, showDaysOutsideCurrentMonth, fixedWeekNumber, dayOfWeekFormatter, disableHighlightToday, showRangePreview, autoFocus, onMonthChange, localeText, themeMode, className, style, }: MGHDateRangeCalendarProps): React.JSX.Element;
+export default MGHDateRangeCalendar;

package/dist/components/MGHDateRangePicker/MGHDateRangePicker.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { MGHDateRangePickerLocaleText, MGHDateRangePickerProps } from './MGHDateRangePicker.types';
+export declare const MGH_DATE_RANGE_PICKER_DEFAULT_LOCALE_TEXT: MGHDateRangePickerLocaleText;
+/**
+ * MUI-free port of MUI X Pro's `DateRangePicker` (desktop variant): an outlined text field with a
+ * calendar button that opens a two-month range calendar, optional shortcuts and an action bar.
+ * Values are dayjs `[start, end]` tuples so existing `DateRange<Dayjs>` state works unchanged.
+ */
+export declare const MGHDateRangePicker: React.ForwardRefExoticComponent<MGHDateRangePickerProps & React.RefAttributes<HTMLDivElement>>;
+export default MGHDateRangePicker;

package/dist/components/MGHDateRangePicker/MGHDateRangePicker.styles.d.ts

@@ -0,0 +1,9 @@
+export declare const MGH_DATE_RANGE_PICKER_STYLE_ID = "mgh-drp-styles";
+/**
+ * Stylesheet for MGHDateRangePicker. Injected once into <head> the first time a picker mounts.
+ * Colours are CSS variables (`--mgh-drp-*`). When the picker is rendered inside an MGHGrid card
+ * it inherits the grid palette (`--mgh-grid-*`) automatically.
+ */
+export declare const MGH_DATE_RANGE_PICKER_CSS = "\n.mgh-drp, .mgh-drp-popover, .mgh-drp-calendars {\n  --mgh-drp-font-family: var(--mgh-grid-font-family, inherit);\n  --mgh-drp-font-size: var(--mgh-grid-font-size, 14px);\n  --mgh-drp-paper: var(--mgh-grid-paper, #ffffff);\n  --mgh-drp-fg: var(--mgh-grid-fg, rgba(0, 0, 0, 0.87));\n  --mgh-drp-fg-secondary: var(--mgh-grid-fg-secondary, rgba(0, 0, 0, 0.6));\n  --mgh-drp-fg-disabled: var(--mgh-grid-fg-disabled, rgba(0, 0, 0, 0.38));\n  --mgh-drp-border: var(--mgh-grid-border, rgba(224, 224, 224, 1));\n  --mgh-drp-input-border: var(--mgh-grid-input-border, rgba(0, 0, 0, 0.23));\n  --mgh-drp-hover: var(--mgh-grid-hover, rgba(0, 0, 0, 0.04));\n  --mgh-drp-primary: var(--mgh-grid-primary, #1976d2);\n  --mgh-drp-primary-contrast: var(--mgh-grid-primary-contrast, #ffffff);\n  --mgh-drp-focus: var(--mgh-grid-focus, #1976d2);\n  --mgh-drp-selected: var(--mgh-grid-selected, rgba(25, 118, 210, 0.12));\n  --mgh-drp-preview: rgba(0, 0, 0, 0.06);\n  --mgh-drp-error: #d32f2f;\n  --mgh-drp-radius: 4px;\n  --mgh-drp-popover-radius: 8px;\n  --mgh-drp-popover-shadow: var(--mgh-grid-popover-shadow, 0 5px 5px -3px rgba(0,0,0,.2), 0 8px 10px 1px rgba(0,0,0,.14), 0 3px 14px 2px rgba(0,0,0,.12));\n  --mgh-drp-day-size: 36px;\n  --mgh-drp-day-margin: 2px;\n  font-family: var(--mgh-drp-font-family);\n  font-size: var(--mgh-drp-font-size);\n  color: var(--mgh-drp-fg);\n  line-height: 1.5;\n}\n/* Dark values also apply to a calendar nested inside a dark picker / popover, so the calendar's own\n   defaults (declared above for standalone use) never reset the colours back to light. */\n.mgh-drp[data-mgh-theme=\"dark\"], .mgh-drp-popover[data-mgh-theme=\"dark\"], .mgh-drp-calendars[data-mgh-theme=\"dark\"],\n.mgh-drp[data-mgh-theme=\"dark\"] .mgh-drp-calendars, .mgh-drp-popover[data-mgh-theme=\"dark\"] .mgh-drp-calendars {\n  --mgh-drp-paper: #212b36;\n  --mgh-drp-fg: #ffffff;\n  --mgh-drp-fg-secondary: rgba(255, 255, 255, 0.7);\n  --mgh-drp-fg-disabled: rgba(255, 255, 255, 0.5);\n  --mgh-drp-border: rgba(81, 81, 81, 1);\n  --mgh-drp-input-border: rgba(255, 255, 255, 0.23);\n  --mgh-drp-hover: rgba(255, 255, 255, 0.08);\n  --mgh-drp-primary: #90caf9;\n  --mgh-drp-primary-contrast: rgba(0, 0, 0, 0.87);\n  --mgh-drp-focus: #90caf9;\n  --mgh-drp-selected: rgba(144, 202, 249, 0.16);\n  --mgh-drp-preview: rgba(255, 255, 255, 0.08);\n  --mgh-drp-error: #f44336;\n}\n[class*=\"mgh-drp\"], [class*=\"mgh-drp\"]::before, [class*=\"mgh-drp\"]::after { box-sizing: border-box; }\n\n/* ---- root / multi-input layout ---- */\n.mgh-drp { display: inline-flex; flex-direction: column; vertical-align: top; min-width: 0; }\n.mgh-drp--full-width { display: flex; width: 100%; }\n.mgh-drp-fields { display: flex; align-items: flex-start; gap: 8px; min-width: 0; }\n.mgh-drp-fields .mgh-drp-field { flex: 1 1 0; min-width: 0; }\n.mgh-drp-fields-separator { align-self: center; color: var(--mgh-drp-fg-secondary); padding: 0 2px; }\n\n/* ---- outlined text field (MUI TextField look-alike) ---- */\n.mgh-drp-field { position: relative; display: inline-flex; align-items: center; min-width: 0; width: 100%; border-radius: var(--mgh-drp-radius); color: var(--mgh-drp-fg); }\n.mgh-drp-field--medium { height: 56px; }\n.mgh-drp-field--small { height: 40px; }\n.mgh-drp-field:not(.mgh-drp-field--full-width) { width: 260px; }\n.mgh-drp-field--multi:not(.mgh-drp-field--full-width) { width: 170px; }\n.mgh-drp-field--full-width { width: 100%; }\n.mgh-drp-input { flex: 1 1 auto; min-width: 0; width: 100%; height: 100%; margin: 0; border: 0; outline: none; background: transparent; color: inherit; font: inherit; font-size: 1rem; letter-spacing: inherit; padding: 16.5px 14px; }\n.mgh-drp-field--small .mgh-drp-input { padding: 8.5px 14px; }\n.mgh-drp-field--adorned .mgh-drp-input { padding-right: 0; }\n.mgh-drp-input::placeholder { color: var(--mgh-drp-fg-disabled); opacity: 1; }\n.mgh-drp-input::-webkit-calendar-picker-indicator { display: none; }\n.mgh-drp-field--disabled .mgh-drp-input { color: var(--mgh-drp-fg-disabled); -webkit-text-fill-color: var(--mgh-drp-fg-disabled); }\n.mgh-drp-field--disabled { cursor: default; }\n.mgh-drp-field--clickable .mgh-drp-input { cursor: pointer; }\n.mgh-drp-adornment { display: flex; align-items: center; gap: 0; margin-right: 6px; flex: 0 0 auto; color: var(--mgh-drp-fg-secondary); }\n.mgh-drp-field--small .mgh-drp-adornment { margin-right: 4px; }\n\n/* notched outline */\n.mgh-drp-outline { position: absolute; inset: -5px 0 0 0; margin: 0; padding: 0 8px; pointer-events: none; border: 1px solid var(--mgh-drp-input-border); border-radius: inherit; min-width: 0; overflow: hidden; text-align: left; transition: border-color .15s; }\n.mgh-drp-outline legend { float: unset; width: auto; padding: 0; height: 11px; font-size: 0.75em; visibility: hidden; max-width: 0.01px; white-space: nowrap; transition: max-width 50ms cubic-bezier(0.0, 0, 0.2, 1) 0ms; overflow: hidden; display: block; line-height: 11px; }\n.mgh-drp-outline legend > span { padding-left: 5px; padding-right: 5px; display: inline-block; opacity: 0; visibility: visible; }\n.mgh-drp-field--shrink .mgh-drp-outline legend { max-width: 100%; transition: max-width 100ms cubic-bezier(0.0, 0, 0.2, 1) 50ms; }\n.mgh-drp-field--no-label .mgh-drp-outline legend { display: none; }\n.mgh-drp-field:hover:not(.mgh-drp-field--disabled) .mgh-drp-outline { border-color: var(--mgh-drp-fg); }\n.mgh-drp-field--focused .mgh-drp-outline, .mgh-drp-field--focused:hover .mgh-drp-outline { border-color: var(--mgh-drp-focus); border-width: 2px; }\n.mgh-drp-field--error .mgh-drp-outline, .mgh-drp-field--error:hover .mgh-drp-outline { border-color: var(--mgh-drp-error); }\n.mgh-drp-field--disabled .mgh-drp-outline { border-color: var(--mgh-drp-fg-disabled); }\n\n/* floating label */\n.mgh-drp-label { position: absolute; left: 0; top: 0; transform-origin: top left; transform: translate(14px, 16px) scale(1); color: var(--mgh-drp-fg-secondary); font-size: 1rem; line-height: 1.4375em; pointer-events: none; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: calc(100% - 24px); transition: color .15s, transform .15s cubic-bezier(0.0, 0, 0.2, 1), max-width .15s; z-index: 1; }\n.mgh-drp-field--small .mgh-drp-label { transform: translate(14px, 9px) scale(1); }\n.mgh-drp-field--shrink .mgh-drp-label, .mgh-drp-field--small.mgh-drp-field--shrink .mgh-drp-label { transform: translate(14px, -9px) scale(0.75); max-width: calc(133% - 32px); }\n.mgh-drp-field--focused .mgh-drp-label { color: var(--mgh-drp-focus); }\n.mgh-drp-field--error .mgh-drp-label { color: var(--mgh-drp-error); }\n.mgh-drp-field--disabled .mgh-drp-label { color: var(--mgh-drp-fg-disabled); }\n.mgh-drp-label-asterisk { margin-left: 2px; }\n\n.mgh-drp-helper { margin: 3px 14px 0; font-size: 0.75rem; line-height: 1.66; color: var(--mgh-drp-fg-secondary); }\n.mgh-drp-helper--error { color: var(--mgh-drp-error); }\n\n/* ---- buttons ---- */\n.mgh-drp-btn { display: inline-flex; align-items: center; justify-content: center; gap: 6px; border: 0; margin: 0; background: transparent; color: var(--mgh-drp-fg-secondary); font: inherit; font-size: 0.8125rem; font-weight: 500; line-height: 1.75; letter-spacing: .02em; padding: 4px 8px; border-radius: 4px; cursor: pointer; user-select: none; transition: background-color .15s, color .15s; white-space: nowrap; text-transform: uppercase; }\n.mgh-drp-btn:hover { background: var(--mgh-drp-hover); color: var(--mgh-drp-fg); }\n.mgh-drp-btn:focus-visible { outline: 2px solid var(--mgh-drp-focus); outline-offset: 1px; }\n.mgh-drp-btn:disabled { color: var(--mgh-drp-fg-disabled); cursor: default; background: transparent; }\n.mgh-drp-btn--primary { color: var(--mgh-drp-primary); }\n.mgh-drp-btn--primary:hover { background: var(--mgh-drp-selected); color: var(--mgh-drp-primary); }\n.mgh-drp-btn--icon { padding: 8px; border-radius: 50%; width: 40px; height: 40px; text-transform: none; }\n.mgh-drp-btn--icon.mgh-drp-btn--small { width: 32px; height: 32px; padding: 4px; }\n.mgh-drp-icon { flex: 0 0 auto; }\n\n/* ---- popover ---- */\n.mgh-drp-popover { position: fixed; z-index: 1300; display: flex; flex-direction: column; background: var(--mgh-drp-paper); color: var(--mgh-drp-fg); border-radius: var(--mgh-drp-popover-radius); box-shadow: var(--mgh-drp-popover-shadow); outline: none; max-height: calc(100vh - 16px); max-width: calc(100vw - 16px); overflow: auto; animation: mgh-drp-pop .12s ease-out; }\n@keyframes mgh-drp-pop { from { opacity: 0; transform: translateY(-4px); } to { opacity: 1; transform: none; } }\n.mgh-drp-layout { display: flex; flex-direction: row; align-items: stretch; }\n.mgh-drp-layout--with-toolbar { flex-direction: column; }\n.mgh-drp-layout-main { display: flex; flex-direction: row; align-items: stretch; }\n.mgh-drp-toolbar { padding: 16px 24px 0; }\n.mgh-drp-toolbar-title { font-size: 0.75rem; text-transform: uppercase; letter-spacing: .08em; color: var(--mgh-drp-fg-secondary); margin: 0 0 8px; }\n.mgh-drp-toolbar-range { display: flex; align-items: center; gap: 8px; font-size: 1.5rem; font-weight: 400; line-height: 1.334; }\n.mgh-drp-toolbar-range button { border: 0; background: transparent; padding: 0 2px; font: inherit; color: var(--mgh-drp-fg-secondary); cursor: pointer; border-radius: 4px; }\n.mgh-drp-toolbar-range button.mgh-drp-toolbar-range--active { color: var(--mgh-drp-fg); }\n.mgh-drp-toolbar-range button:hover { background: var(--mgh-drp-hover); }\n\n/* shortcuts (left column) */\n.mgh-drp-shortcuts { list-style: none; margin: 0; padding: 8px 0; min-width: 140px; max-height: 340px; overflow: auto; border-right: 1px solid var(--mgh-drp-border); display: flex; flex-direction: column; gap: 4px; padding-left: 8px; padding-right: 8px; }\n.mgh-drp-shortcut { display: inline-flex; align-items: center; height: 32px; padding: 0 12px; border-radius: 16px; border: 1px solid var(--mgh-drp-input-border); background: transparent; color: var(--mgh-drp-fg); font: inherit; font-size: 0.8125rem; cursor: pointer; white-space: nowrap; justify-content: flex-start; transition: background-color .15s; }\n.mgh-drp-shortcut:hover { background: var(--mgh-drp-hover); }\n.mgh-drp-shortcut:focus-visible { outline: 2px solid var(--mgh-drp-focus); outline-offset: 1px; }\n.mgh-drp-shortcut:disabled { color: var(--mgh-drp-fg-disabled); cursor: default; }\n.mgh-drp-shortcut--selected { background: var(--mgh-drp-selected); border-color: var(--mgh-drp-primary); color: var(--mgh-drp-primary); }\n\n/* ---- calendars ---- */\n.mgh-drp-calendars { display: flex; flex-direction: row; align-items: flex-start; }\n.mgh-drp-calendar { display: flex; flex-direction: column; width: calc(7 * (var(--mgh-drp-day-size) + 2 * var(--mgh-drp-day-margin)) + 24px); padding: 0 12px 8px; }\n.mgh-drp-calendar + .mgh-drp-calendar { border-left: 1px solid var(--mgh-drp-border); }\n.mgh-drp-calendar-header { display: flex; align-items: center; justify-content: space-between; min-height: 40px; margin: 12px 0 8px; padding: 0 4px; }\n.mgh-drp-calendar-label { flex: 1 1 auto; text-align: center; font-size: 1rem; font-weight: 500; }\n.mgh-drp-calendar-header .mgh-drp-btn--icon { color: var(--mgh-drp-fg-secondary); }\n.mgh-drp-calendar-nav-spacer { width: 40px; height: 40px; flex: 0 0 auto; }\n.mgh-drp-weekdays, .mgh-drp-week { display: flex; justify-content: center; }\n.mgh-drp-weekday { width: var(--mgh-drp-day-size); height: 40px; margin: 0 var(--mgh-drp-day-margin); display: flex; align-items: center; justify-content: center; font-size: 0.75rem; color: var(--mgh-drp-fg-secondary); font-weight: 400; }\n.mgh-drp-weeks { display: flex; flex-direction: column; min-height: calc(6 * (var(--mgh-drp-day-size) + 2 * var(--mgh-drp-day-margin))); }\n.mgh-drp-week { margin: var(--mgh-drp-day-margin) 0; }\n\n/* day cell: the outer wrapper carries the range highlight, the inner button the day itself */\n.mgh-drp-day-wrap { position: relative; width: calc(var(--mgh-drp-day-size) + 2 * var(--mgh-drp-day-margin)); height: var(--mgh-drp-day-size); display: flex; align-items: center; justify-content: center; }\n.mgh-drp-day-wrap--in-range { background: var(--mgh-drp-selected); }\n.mgh-drp-day-wrap--range-start { border-top-left-radius: 50%; border-bottom-left-radius: 50%; }\n.mgh-drp-day-wrap--range-end { border-top-right-radius: 50%; border-bottom-right-radius: 50%; }\n.mgh-drp-day-wrap--preview { border-top: 1px dashed var(--mgh-drp-fg-secondary); border-bottom: 1px dashed var(--mgh-drp-fg-secondary); }\n.mgh-drp-day-wrap--preview-start { border-left: 1px dashed var(--mgh-drp-fg-secondary); border-top-left-radius: 50%; border-bottom-left-radius: 50%; }\n.mgh-drp-day-wrap--preview-end { border-right: 1px dashed var(--mgh-drp-fg-secondary); border-top-right-radius: 50%; border-bottom-right-radius: 50%; }\n.mgh-drp-day-wrap--first-visible.mgh-drp-day-wrap--in-range:not(.mgh-drp-day-wrap--range-start) { border-top-left-radius: 50%; border-bottom-left-radius: 50%; }\n.mgh-drp-day-wrap--last-visible.mgh-drp-day-wrap--in-range:not(.mgh-drp-day-wrap--range-end) { border-top-right-radius: 50%; border-bottom-right-radius: 50%; }\n.mgh-drp-day-wrap--first-visible.mgh-drp-day-wrap--preview:not(.mgh-drp-day-wrap--preview-start) { border-top-left-radius: 50%; border-bottom-left-radius: 50%; border-left: 1px dashed var(--mgh-drp-fg-secondary); }\n.mgh-drp-day-wrap--last-visible.mgh-drp-day-wrap--preview:not(.mgh-drp-day-wrap--preview-end) { border-top-right-radius: 50%; border-bottom-right-radius: 50%; border-right: 1px dashed var(--mgh-drp-fg-secondary); }\n.mgh-drp-day { width: var(--mgh-drp-day-size); height: var(--mgh-drp-day-size); border-radius: 50%; border: 0; margin: 0; padding: 0; background: transparent; color: var(--mgh-drp-fg); font: inherit; font-size: 0.75rem; cursor: pointer; display: inline-flex; align-items: center; justify-content: center; transition: background-color .15s, color .15s; position: relative; }\n.mgh-drp-day:hover { background: var(--mgh-drp-hover); }\n.mgh-drp-day:focus-visible { outline: 2px solid var(--mgh-drp-focus); outline-offset: -1px; }\n.mgh-drp-day--today:not(.mgh-drp-day--selected) { border: 1px solid var(--mgh-drp-fg-secondary); }\n.mgh-drp-day--outside { color: var(--mgh-drp-fg-secondary); opacity: .6; }\n.mgh-drp-day--hidden { visibility: hidden; pointer-events: none; }\n.mgh-drp-day--disabled, .mgh-drp-day--disabled:hover { color: var(--mgh-drp-fg-disabled); cursor: default; background: transparent; }\n.mgh-drp-day--selected, .mgh-drp-day--selected:hover { background: var(--mgh-drp-primary); color: var(--mgh-drp-primary-contrast); font-weight: 500; }\n.mgh-drp-day--selected:focus-visible { outline-offset: 2px; }\n.mgh-drp-calendar--read-only .mgh-drp-day, .mgh-drp-calendar--disabled .mgh-drp-day { cursor: default; }\n.mgh-drp-calendar--disabled .mgh-drp-day { color: var(--mgh-drp-fg-disabled); }\n.mgh-drp-calendar--disabled .mgh-drp-day--selected { opacity: .6; }\n\n/* ---- action bar ---- */\n.mgh-drp-actions { display: flex; align-items: center; justify-content: flex-end; gap: 8px; padding: 8px; border-top: 1px solid var(--mgh-drp-border); }\n.mgh-drp-actions--spread { justify-content: space-between; }\n.mgh-drp-actions-group { display: flex; gap: 8px; }\n\n@media (max-width: 599.95px) {\n  .mgh-drp-layout-main { flex-direction: column; }\n  .mgh-drp-shortcuts { flex-direction: row; flex-wrap: wrap; border-right: 0; border-bottom: 1px solid var(--mgh-drp-border); max-height: none; }\n  .mgh-drp-calendars { flex-direction: column; align-items: center; }\n  .mgh-drp-calendar + .mgh-drp-calendar { border-left: 0; border-top: 1px solid var(--mgh-drp-border); }\n}\n";
+/** Injects the MGHDateRangePicker stylesheet once per document. Safe on the server (no-op). */
+export declare const useMGHDateRangePickerStyles: () => void;

package/dist/components/MGHDateRangePicker/MGHDateRangePicker.types.d.ts

@@ -0,0 +1,125 @@
+import type React from 'react';
+import type { Dayjs } from 'dayjs';
+/** `[start, end]` – the same shape as MUI's `DateRange<Dayjs>`. */
+export type MGHDateRange = [Dayjs | null, Dayjs | null];
+export type MGHDateRangePosition = 'start' | 'end';
+export type MGHDateRangeThemeMode = 'light' | 'dark';
+export type MGHDateRangeValidationError = 'invalidDate' | 'invalidRange' | 'minDate' | 'maxDate' | 'disablePast' | 'disableFuture' | 'shouldDisableDate' | null;
+export type MGHDateRangeAction = 'clear' | 'today' | 'cancel' | 'accept';
+export interface MGHDateRangeShortcut {
+    label: string;
+    /** Return the range to apply. `isValid` reports whether a range passes the picker's validation. */
+    getValue: (context: {
+        isValid: (value: MGHDateRange) => boolean;
+    }) => MGHDateRange;
+    id?: string;
+}
+export interface MGHDateRangeChangeContext {
+    validationError: [MGHDateRangeValidationError, MGHDateRangeValidationError];
+    /** Set when the change came from a shortcut. */
+    shortcut?: MGHDateRangeShortcut;
+}
+export interface MGHDateRangePickerLocaleText {
+    start: string;
+    end: string;
+    /** Placeholder for a single date, e.g. `MM/DD/YYYY`. Defaults to the `format`. */
+    datePlaceholder?: string;
+    fieldSeparator: string;
+    openPicker: string;
+    clear: string;
+    today: string;
+    cancel: string;
+    accept: string;
+    previousMonth: string;
+    nextMonth: string;
+    /** Range summary shown in the toolbar, e.g. "Select date range". */
+    toolbarTitle: string;
+}
+export interface MGHDateRangeCalendarProps {
+    value?: MGHDateRange;
+    defaultValue?: MGHDateRange;
+    /** Fires on every click in the calendar; `selectedDay` is the day that was clicked. */
+    onChange?: (value: MGHDateRange, selectedDay: Dayjs, position: MGHDateRangePosition) => void;
+    rangePosition?: MGHDateRangePosition;
+    onRangePositionChange?: (position: MGHDateRangePosition) => void;
+    /** Number of months displayed side by side. @default 2 */
+    calendars?: 1 | 2 | 3;
+    /** Month shown in the first calendar when nothing is selected. @default today */
+    referenceDate?: Dayjs;
+    minDate?: Dayjs | null;
+    maxDate?: Dayjs | null;
+    disablePast?: boolean;
+    disableFuture?: boolean;
+    shouldDisableDate?: (day: Dayjs, position: MGHDateRangePosition) => boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    /** Render the days of the previous / next month in the empty cells. @default false */
+    showDaysOutsideCurrentMonth?: boolean;
+    /** Always render this many week rows (MUI: `fixedWeekNumber`). */
+    fixedWeekNumber?: number;
+    /** Weekday header formatter. @default first letter of the weekday */
+    dayOfWeekFormatter?: (day: Dayjs) => string;
+    /** Do not outline today's date. @default false */
+    disableHighlightToday?: boolean;
+    /** Highlight the hovered interval while the end date is being chosen. @default true */
+    showRangePreview?: boolean;
+    /** Focus the selected (or current) day when the calendar mounts. */
+    autoFocus?: boolean;
+    /** Called when the visible month changes (the month of the *first* calendar). */
+    onMonthChange?: (month: Dayjs) => void;
+    localeText?: Partial<Pick<MGHDateRangePickerLocaleText, 'previousMonth' | 'nextMonth'>>;
+    themeMode?: MGHDateRangeThemeMode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export interface MGHDateRangePickerProps extends Omit<MGHDateRangeCalendarProps, 'onChange' | 'autoFocus' | 'className' | 'style' | 'localeText'> {
+    onChange?: (value: MGHDateRange, context: MGHDateRangeChangeContext) => void;
+    /** Fires when a complete range is committed (closing after the end date, the Accept action, or a shortcut). */
+    onAccept?: (value: MGHDateRange) => void;
+    /** Fires when the validation error of either date changes. */
+    onError?: (error: [MGHDateRangeValidationError, MGHDateRangeValidationError], value: MGHDateRange) => void;
+    open?: boolean;
+    onOpen?: () => void;
+    onClose?: () => void;
+    /** Text field label (single-input field). For the multi-input field use `localeText.start` / `localeText.end`. */
+    label?: React.ReactNode;
+    /** dayjs display / parse format. @default 'MM/DD/YYYY' */
+    format?: string;
+    /** `'single'` renders one field "start – end"; `'multi'` renders two fields. @default 'single' */
+    fieldVariant?: 'single' | 'multi';
+    size?: 'small' | 'medium';
+    fullWidth?: boolean;
+    /** Show a clear (×) button when a value is set. @default false */
+    clearable?: boolean;
+    /** Open the calendar when the text field itself is clicked (MUI only opens from the icon button). @default false */
+    openOnClick?: boolean;
+    /** Hide the calendar icon button. @default false */
+    disableOpenPicker?: boolean;
+    /** Close the popover as soon as the end date is picked. @default true (false when `actions` includes 'accept') */
+    closeOnSelect?: boolean;
+    /** Quick ranges listed on the left of the calendars (MUI `slotProps.shortcuts.items`). */
+    shortcuts?: MGHDateRangeShortcut[];
+    /** Buttons in the action bar under the calendars (MUI `slotProps.actionBar.actions`). @default [] */
+    actions?: MGHDateRangeAction[];
+    /** Show the "Start – End" summary toolbar above the calendars. @default false */
+    showToolbar?: boolean;
+    localeText?: Partial<MGHDateRangePickerLocaleText>;
+    name?: string;
+    id?: string;
+    placeholder?: string;
+    required?: boolean;
+    /** Force the error state. Validation errors from the value are shown automatically. */
+    error?: boolean;
+    helperText?: React.ReactNode;
+    autoFocus?: boolean;
+    inputRef?: React.Ref<HTMLInputElement>;
+    themeMode?: MGHDateRangeThemeMode;
+    /** Override any `--mgh-drp-*` CSS variable for this instance. */
+    themeVars?: Record<string, string>;
+    className?: string;
+    style?: React.CSSProperties;
+    popoverClassName?: string;
+    popoverStyle?: React.CSSProperties;
+    /** Placement of the popover relative to the field. @default 'bottom-start' */
+    placement?: 'bottom-start' | 'bottom-end' | 'bottom';
+}

package/dist/components/MGHDateRangePicker/icons.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export interface MGHDateRangeIconProps extends React.SVGProps<SVGSVGElement> {
+    size?: number;
+}
+export declare const DateRangeIcon: React.ForwardRefExoticComponent<Omit<MGHDateRangeIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronLeftIcon: React.ForwardRefExoticComponent<Omit<MGHDateRangeIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const ChevronRightIcon: React.ForwardRefExoticComponent<Omit<MGHDateRangeIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+export declare const CloseIcon: React.ForwardRefExoticComponent<Omit<MGHDateRangeIconProps, "ref"> & React.RefAttributes<SVGSVGElement>>;

package/dist/components/MGHDateRangePicker/index.d.ts

@@ -0,0 +1,7 @@
+export { default } from './MGHDateRangePicker';
+export { MGHDateRangePicker, MGH_DATE_RANGE_PICKER_DEFAULT_LOCALE_TEXT } from './MGHDateRangePicker';
+export { MGHDateRangeCalendar } from './MGHDateRangeCalendar';
+export * from './MGHDateRangePicker.types';
+export { MGH_DATE_RANGE_PICKER_CSS, MGH_DATE_RANGE_PICKER_STYLE_ID, useMGHDateRangePickerStyles, } from './MGHDateRangePicker.styles';
+export { MGH_DATE_RANGE_DEFAULT_SHORTCUTS, validateRange as mghDateRangeValidate, parseDateText as mghDateRangeParseDate, isRangeEqual as mghDateRangeIsEqual, } from './utils';
+export * as MGHDateRangeIcons from './icons';

package/dist/components/MGHDateRangePicker/utils.d.ts

@@ -0,0 +1,46 @@
+import { Dayjs } from 'dayjs';
+import type { MGHDateRange, MGHDateRangePosition, MGHDateRangeShortcut, MGHDateRangeValidationError } from './MGHDateRangePicker.types';
+export declare const cx: (...classNames: Array<string | false | null | undefined>) => string;
+export declare const clamp: (value: number, min: number, max: number) => number;
+export declare const EMPTY_RANGE: MGHDateRange;
+/** Coerces Dayjs / Date / ISO string / timestamp into a valid Dayjs (or null). */
+export declare const toDayjs: (value: unknown) => Dayjs | null;
+export declare const isSameDay: (a: Dayjs | null | undefined, b: Dayjs | null | undefined) => boolean;
+export declare const isBeforeDay: (a: Dayjs, b: Dayjs) => boolean;
+export declare const isAfterDay: (a: Dayjs, b: Dayjs) => boolean;
+export declare const isWithinRange: (day: Dayjs, start: Dayjs | null, end: Dayjs | null) => boolean;
+export declare const isRangeEqual: (a: MGHDateRange | undefined, b: MGHDateRange | undefined) => boolean;
+export declare const normalizeRange: (value: unknown) => MGHDateRange;
+/** Strict parse with the display format first, then a handful of forgiving fallbacks. */
+export declare const parseDateText: (text: string, format: string) => Dayjs | null;
+export declare const formatDate: (value: Dayjs | null, format: string) => string;
+/** Splits "start – end" text typed into the single-input field. */
+export declare const splitRangeText: (text: string) => [string, string];
+export interface DateValidationOptions {
+    minDate?: Dayjs | null;
+    maxDate?: Dayjs | null;
+    disablePast?: boolean;
+    disableFuture?: boolean;
+    shouldDisableDate?: (day: Dayjs, position: MGHDateRangePosition) => boolean;
+}
+export declare const validateDay: (day: Dayjs | null, position: MGHDateRangePosition, options: DateValidationOptions, now?: Dayjs) => MGHDateRangeValidationError;
+export declare const validateRange: (value: MGHDateRange, options: DateValidationOptions) => [MGHDateRangeValidationError, MGHDateRangeValidationError];
+export declare const isDayDisabled: (day: Dayjs, position: MGHDateRangePosition, options: DateValidationOptions) => boolean;
+export interface CalendarWeek {
+    key: string;
+    days: Array<{
+        day: Dayjs;
+        outsideMonth: boolean;
+    }>;
+}
+/**
+ * Builds the weeks of `month`. Weeks start on the locale's first day of the week (Sunday for `en`).
+ * Pass `fixedWeekNumber` (usually 6) to always render the same number of rows.
+ */
+export declare const getMonthWeeks: (month: Dayjs, fixedWeekNumber?: number) => CalendarWeek[];
+export declare const getWeekDayLabels: (formatter: (day: Dayjs) => string) => {
+    key: string;
+    label: string;
+    full: string;
+}[];
+export declare const MGH_DATE_RANGE_DEFAULT_SHORTCUTS: MGHDateRangeShortcut[];

package/dist/components/index.d.ts

@@ -5,3 +5,4 @@ export * from './Confirm-Dialog';
 export * from './Exporting';
 export * from './iconify';
 export * from './Label';
+export * from './MGHDateRangePicker';