@dashforge/tw 0.9.0-beta → 0.10.0-beta

package/dist/src/components/TimePicker/timePicker.types.d.ts

@@ -0,0 +1,80 @@
+import type { ReactNode } from 'react';
+import type { Engine } from '@dashforge/ui-core';
+import type { AccessRequirement } from '@dashforge/rbac';
+/** Per-slot `className` overrides for `<TimePicker>`. */
+export interface TimePickerSlotProps {
+    root?: {
+        className?: string;
+    };
+    label?: {
+        className?: string;
+    };
+    requiredMark?: {
+        className?: string;
+    };
+    trigger?: {
+        className?: string;
+    };
+    helperText?: {
+        className?: string;
+    };
+    errorText?: {
+        className?: string;
+    };
+}
+/**
+ * Props for the `<TimePicker>` form field (Tailwind skin).
+ *
+ * A read-only trigger paired with a `<Calendar>`-style time-list popover.
+ * The stored value is a canonical 24-hour `"HH:mm"` string, or `null`.
+ * 12-hour notation (`hour12`) is display-only. No date, no timezone.
+ *
+ * The prop surface mirrors the MUI `@dashforge/ui` `TimePicker`.
+ */
+export interface TimePickerProps {
+    /** Field name — the bridge registration key. Required. */
+    name: string;
+    /** Validation rules forwarded to the form bridge. */
+    rules?: unknown;
+    /** Field label. */
+    label?: ReactNode;
+    /** Helper text below the control (overrides a bridge error message). */
+    helperText?: ReactNode;
+    /** Explicit error state (overrides the bridge's auto error). */
+    error?: boolean;
+    /** Marks the field required (adds the label asterisk). */
+    required?: boolean;
+    /** Disables the field. */
+    disabled?: boolean;
+    /** Placeholder shown when no time is selected. */
+    placeholder?: string;
+    /** Label/control layout. */
+    layout?: 'stacked' | 'inline';
+    /** Reactive visibility predicate evaluated against the form engine. */
+    visibleWhen?: (engine: Engine) => boolean;
+    /** RBAC access requirement. */
+    access?: AccessRequirement;
+    /** Controlled value — `"HH:mm"` (24-hour) or `null`. */
+    value?: string | null;
+    /** Uncontrolled initial value. */
+    defaultValue?: string | null;
+    /** Fired with the new time (or `null` when cleared). */
+    onChange?: (value: string | null) => void;
+    /** Earliest selectable time, `"HH:mm"`. Default `"00:00"`. */
+    minTime?: string;
+    /** Latest selectable time, `"HH:mm"`. Default `"23:30"`. */
+    maxTime?: string;
+    /** Step between time-list options, in minutes. Default `30`. */
+    stepMinutes?: number;
+    /** Render the time list in 12-hour notation. Default `false`. */
+    hour12?: boolean;
+    /** Stretches the field to its container width. */
+    fullWidth?: boolean;
+    /** Root-level Tailwind class override. */
+    sx?: string;
+    /** Per-slot `className` overrides. */
+    slotProps?: TimePickerSlotProps;
+    /** Test id applied to the field root. */
+    testId?: string;
+}
+//# sourceMappingURL=timePicker.types.d.ts.map

package/dist/src/components/TimePicker/timePicker.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timePicker.types.d.ts","sourceRoot":"","sources":["../../../../src/components/TimePicker/timePicker.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,uEAAuE;IACvE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,+BAA+B;IAC/B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/src/components/TimePicker/timePicker.variants.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Slots for `<TimePicker>` — a bridge-integrated time field whose trigger
+ * is a `<button>` styled as an input, opening a time-list popover.
+ *
+ * Theme identity: bare neutral / brand token-backed classes only — no
+ * `dark:` variants on the neutral palette (the preset CSS-var swap
+ * auto-inverts). See `_shared/themeIdentity.test.ts`.
+ */
+export declare const timePickerVariants: import("tailwind-variants").TVReturnType<{
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    list: string;
+    option: string;
+    helperText: string;
+    errorText: string;
+}, undefined, {
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    list: string;
+    option: string;
+    helperText: string;
+    errorText: string;
+}, import("tailwind-variants").TVReturnType<{
+    layout: {
+        stacked: {};
+        inline: {
+            root: string;
+            label: string;
+        };
+    };
+    error: {
+        true: {
+            trigger: string;
+        };
+    };
+    fullWidth: {
+        true: {
+            root: string;
+            trigger: string;
+        };
+    };
+}, {
+    root: string;
+    label: string;
+    requiredMark: string;
+    trigger: string;
+    value: string;
+    placeholder: string;
+    icon: string;
+    list: string;
+    option: string;
+    helperText: string;
+    errorText: string;
+}, undefined, unknown, unknown, undefined>>;
+//# sourceMappingURL=timePicker.variants.d.ts.map

package/dist/src/components/TimePicker/timePicker.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timePicker.variants.d.ts","sourceRoot":"","sources":["../../../../src/components/TimePicker/timePicker.variants.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA0C7B,CAAC"}

package/dist/src/index.d.ts

@@ -50,9 +50,21 @@ export { otpFieldVariants } from './components/OTPField/otpField.variants.js';
 export { Autocomplete } from './components/Autocomplete/Autocomplete.js';
 export type { AutocompleteProps, AutocompleteOption, AutocompleteSlotProps, AutocompleteValue, } from './components/Autocomplete/autocomplete.types.js';
 export { autocompleteVariants } from './components/Autocomplete/autocomplete.variants.js';
-export { DateTimePicker, isoToInputValue, } from './components/DateTimePicker/DateTimePicker.js';
-export type { DateTimePickerProps, DateTimePickerMode, DateTimePickerSlotProps, } from './components/DateTimePicker/dateTimePicker.types.js';
+export { Calendar } from './components/Calendar/Calendar.js';
+export type { CalendarProps, CalendarSlotProps, } from './components/Calendar/calendar.types.js';
+export { calendarVariants, calendarDayVariants, } from './components/Calendar/calendar.variants.js';
+export { DatePicker } from './components/DatePicker/DatePicker.js';
+export type { DatePickerProps, DatePickerSlotProps, } from './components/DatePicker/datePicker.types.js';
+export { datePickerVariants } from './components/DatePicker/datePicker.variants.js';
+export { TimePicker } from './components/TimePicker/TimePicker.js';
+export type { TimePickerProps, TimePickerSlotProps, } from './components/TimePicker/timePicker.types.js';
+export { timePickerVariants } from './components/TimePicker/timePicker.variants.js';
+export { DateTimePicker } from './components/DateTimePicker/DateTimePicker.js';
+export type { DateTimePickerProps, DateTimePickerSlotProps, } from './components/DateTimePicker/dateTimePicker.types.js';
 export { dateTimePickerVariants } from './components/DateTimePicker/dateTimePicker.variants.js';
+export { DateRangePicker } from './components/DateRangePicker/DateRangePicker.js';
+export type { DateRangePickerProps, DateRangePickerSlotProps, } from './components/DateRangePicker/dateRangePicker.types.js';
+export { dateRangePickerVariants, dateRangeDayVariants, } from './components/DateRangePicker/dateRangePicker.variants.js';
 export { Breadcrumbs } from './components/Breadcrumbs/Breadcrumbs.js';
 export type { BreadcrumbsProps, BreadcrumbItem, BreadcrumbsSlotProps, BreadcrumbLinkComponent, } from './components/Breadcrumbs/breadcrumbs.types.js';
 export { breadcrumbsVariants } from './components/Breadcrumbs/breadcrumbs.variants.js';
@@ -130,5 +142,5 @@ export type { VariantProps } from 'tailwind-variants';
 /**
  * Package version (synced with `package.json` at publish time).
  */
-export declare const VERSION = "0.7.0-beta";
+export declare const VERSION = "0.9.1-beta";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashforge/tw",
-  "version": "0.9.0-beta",
+  "version": "0.10.0-beta",
   "private": false,
   "type": "module",
   "main": "./dist/index.esm.js",
@@ -28,9 +28,10 @@
     "clsx": "^2.1.0",
     "tailwind-merge": "^3.0.0",
     "tailwind-variants": "^3.1.1",
-    "@dashforge/forms": "0.2.3-beta",
+    "@dashforge/calendar-core": "0.2.0-beta",
+    "@dashforge/ui-core": "0.2.3-beta",
     "@dashforge/rbac": "0.2.3-beta",
-    "@dashforge/ui-core": "0.2.3-beta"
+    "@dashforge/forms": "0.2.3-beta"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/src/components/Calendar/Calendar.test.tsx

@@ -0,0 +1,75 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi } from 'vitest';
+import { render, screen, fireEvent } from '@testing-library/react';
+
+import { Calendar } from './Calendar.js';
+
+describe('Calendar', () => {
+  it('renders a labelled month grid', () => {
+    render(<Calendar today="2026-05-20" />);
+    expect(screen.queryByRole('grid', { name: 'Calendar' })).not.toBeNull();
+    expect(screen.queryByText('May 2026')).not.toBeNull();
+    expect(screen.getAllByRole('columnheader')).toHaveLength(7);
+  });
+
+  it('renders a fixed 42-cell grid', () => {
+    render(<Calendar today="2026-05-20" />);
+    expect(screen.getAllByRole('gridcell')).toHaveLength(42);
+  });
+
+  it('fires onChange when a day is clicked', () => {
+    const onChange = vi.fn();
+    render(<Calendar today="2026-05-20" onChange={onChange} />);
+    fireEvent.click(screen.getByRole('button', { name: /May 15, 2026/ }));
+    expect(onChange).toHaveBeenCalledWith('2026-05-15');
+  });
+
+  it('marks the controlled selected day as pressed', () => {
+    render(<Calendar today="2026-05-20" value="2026-05-10" />);
+    expect(
+      screen
+        .getByRole('button', { name: /May 10, 2026/ })
+        .getAttribute('aria-pressed'),
+    ).toBe('true');
+  });
+
+  it('navigates to the next and previous month', () => {
+    render(<Calendar today="2026-05-20" />);
+    fireEvent.click(screen.getByRole('button', { name: 'Next month' }));
+    expect(screen.queryByText('June 2026')).not.toBeNull();
+    fireEvent.click(screen.getByRole('button', { name: 'Previous month' }));
+    expect(screen.queryByText('May 2026')).not.toBeNull();
+  });
+
+  it('moves roving focus with the arrow keys', () => {
+    render(<Calendar today="2026-05-20" />);
+    const grid = screen.getByRole('grid');
+    expect(
+      screen
+        .getByRole('button', { name: /May 20, 2026/ })
+        .getAttribute('tabindex'),
+    ).toBe('0');
+    fireEvent.keyDown(grid, { key: 'ArrowRight' });
+    expect(
+      screen
+        .getByRole('button', { name: /May 21, 2026/ })
+        .getAttribute('tabindex'),
+    ).toBe('0');
+    expect(
+      screen
+        .getByRole('button', { name: /May 20, 2026/ })
+        .getAttribute('tabindex'),
+    ).toBe('-1');
+  });
+
+  it('does not select a disabled date', () => {
+    const onChange = vi.fn();
+    render(
+      <Calendar today="2026-05-20" minDate="2026-05-15" onChange={onChange} />,
+    );
+    const blocked = screen.getByRole('button', { name: /May 10, 2026/ });
+    expect(blocked.getAttribute('aria-disabled')).toBe('true');
+    fireEvent.click(blocked);
+    expect(onChange).not.toHaveBeenCalled();
+  });
+});

package/src/components/Calendar/Calendar.tsx

@@ -0,0 +1,264 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import type { KeyboardEvent } from 'react';
+import {
+  formatLongDate,
+  resolveCalendarKey,
+  useCalendar,
+} from '@dashforge/calendar-core';
+import type { ISODate } from '@dashforge/calendar-core';
+import { cn } from '../../utils/cn.js';
+import { calendarDayVariants, calendarVariants } from './calendar.variants.js';
+import type { CalendarProps } from './calendar.types.js';
+
+// Inline 16×16 stroke chevrons — no icon dependency (tw convention).
+function ChevronLeftIcon() {
+  return (
+    <svg
+      width="1em"
+      height="1em"
+      viewBox="0 0 16 16"
+      fill="none"
+      aria-hidden="true"
+    >
+      <path
+        d="M10 4 6 8l4 4"
+        stroke="currentColor"
+        strokeWidth="1.5"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+function ChevronRightIcon() {
+  return (
+    <svg
+      width="1em"
+      height="1em"
+      viewBox="0 0 16 16"
+      fill="none"
+      aria-hidden="true"
+    >
+      <path
+        d="m6 4 4 4-4 4"
+        stroke="currentColor"
+        strokeWidth="1.5"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+/**
+ * `<Calendar>` — a standalone, inline month-grid date picker.
+ *
+ * The Tailwind presentation layer over the headless `useCalendar` engine
+ * from `@dashforge/calendar-core` (the same engine the MUI `@dashforge/ui`
+ * calendar consumes — only the skin differs). Implements the WCAG grid
+ * pattern with roving tab-index focus.
+ *
+ * It is a primitive: no form-bridge / RBAC integration — use `<DatePicker>`
+ * for a form-bound date field.
+ */
+export function Calendar(props: CalendarProps) {
+  const {
+    value,
+    defaultValue,
+    onChange,
+    month,
+    year,
+    defaultMonth,
+    defaultYear,
+    onMonthChange,
+    minDate,
+    maxDate,
+    disabledDates,
+    isDateDisabled,
+    weekStartDay,
+    locale,
+    today,
+    disabled = false,
+    autoFocus = false,
+    sx,
+    slotProps,
+    testId,
+    'aria-label': ariaLabel = 'Calendar',
+  } = props;
+
+  const isValueControlled = value !== undefined;
+  const [internalValue, setInternalValue] = useState<ISODate | null>(
+    defaultValue ?? null,
+  );
+  const selectedValue: ISODate | null = isValueControlled
+    ? value
+    : internalValue;
+
+  const handleSelect = useCallback(
+    (iso: ISODate) => {
+      if (!isValueControlled) {
+        setInternalValue(iso);
+      }
+      onChange?.(iso);
+    },
+    [isValueControlled, onChange],
+  );
+
+  const calendar = useCalendar({
+    selected: selectedValue,
+    month,
+    year,
+    defaultMonth,
+    defaultYear,
+    onMonthChange,
+    minDate,
+    maxDate,
+    disabledDates,
+    isDateDisabled,
+    weekStartDay,
+    locale,
+    today,
+    onSelect: handleSelect,
+  });
+
+  // Roving focus: the active day cell holds DOM focus; it is moved only
+  // after a keyboard interaction (or on mount when `autoFocus`). `focus`
+  // uses `preventScroll` so opening the calendar inside a popup never
+  // scroll-jumps the page before the popup is positioned.
+  const focusedCellRef = useRef<HTMLButtonElement | null>(null);
+  const shouldFocusRef = useRef(autoFocus);
+
+  useEffect(() => {
+    if (shouldFocusRef.current && focusedCellRef.current) {
+      focusedCellRef.current.focus({ preventScroll: true });
+      shouldFocusRef.current = false;
+    }
+  }, [calendar.focusedDate]);
+
+  const handleKeyDown = useCallback(
+    (event: KeyboardEvent<HTMLDivElement>) => {
+      if (disabled) {
+        return;
+      }
+      const action = resolveCalendarKey(event.key);
+      if (action === null) {
+        return;
+      }
+      event.preventDefault();
+      shouldFocusRef.current = true;
+      switch (action) {
+        case 'select':
+          calendar.selectDate(calendar.focusedDate);
+          break;
+        case 'monthForward':
+          calendar.goToNextMonth();
+          break;
+        case 'monthBackward':
+          calendar.goToPreviousMonth();
+          break;
+        default:
+          calendar.navigate(action);
+      }
+    },
+    [disabled, calendar],
+  );
+
+  const resolvedLocale = locale ?? 'en-US';
+  const v = calendarVariants({ disabled });
+
+  return (
+    <div
+      data-testid={testId}
+      className={cn(v.root(), sx, slotProps?.root?.className)}
+    >
+      {/* Header: month navigation + label */}
+      <div className={cn(v.header(), slotProps?.header?.className)}>
+        <button
+          type="button"
+          className={v.navButton()}
+          disabled={disabled}
+          aria-label="Previous month"
+          onClick={() => {
+            calendar.goToPreviousMonth();
+          }}
+        >
+          <ChevronLeftIcon />
+        </button>
+        <span aria-live="polite" className={v.monthLabel()}>
+          {calendar.monthLabel}
+        </span>
+        <button
+          type="button"
+          className={v.navButton()}
+          disabled={disabled}
+          aria-label="Next month"
+          onClick={() => {
+            calendar.goToNextMonth();
+          }}
+        >
+          <ChevronRightIcon />
+        </button>
+      </div>
+
+      {/* Grid */}
+      <div
+        role="grid"
+        aria-label={ariaLabel}
+        onKeyDown={handleKeyDown}
+        className={cn(v.grid(), slotProps?.grid?.className)}
+      >
+        <div role="row" className={v.weekdayRow()}>
+          {calendar.weekdayNames.map((dayName, index) => (
+            <span
+              key={`weekday-${String(index)}`}
+              role="columnheader"
+              className={v.weekday()}
+            >
+              {dayName}
+            </span>
+          ))}
+        </div>
+
+        {calendar.weeks.map((week) => (
+          <div key={week.key} role="row" className={v.weekRow()}>
+            {week.days.map((day) => {
+              const isActiveCell = day.iso === calendar.focusedDate;
+              return (
+                <span key={day.iso} role="gridcell" className="flex">
+                  <button
+                    type="button"
+                    ref={isActiveCell ? focusedCellRef : null}
+                    tabIndex={isActiveCell ? 0 : -1}
+                    disabled={disabled}
+                    aria-label={formatLongDate(
+                      { year: day.year, month: day.month, day: day.day },
+                      resolvedLocale,
+                    )}
+                    aria-current={day.isToday ? 'date' : undefined}
+                    aria-pressed={day.isSelected}
+                    aria-disabled={day.isDisabled}
+                    onClick={() => {
+                      calendar.selectDate(day.iso);
+                    }}
+                    className={cn(
+                      calendarDayVariants({
+                        siblingMonth: day.isSiblingMonth,
+                        today: day.isToday,
+                        selected: day.isSelected,
+                        disabled: day.isDisabled,
+                      }),
+                      slotProps?.day?.className,
+                    )}
+                  >
+                    {day.day}
+                  </button>
+                </span>
+              );
+            })}
+          </div>
+        ))}
+      </div>
+    </div>
+  );
+}

package/src/components/Calendar/calendar.types.ts

@@ -0,0 +1,65 @@
+import type { ISODate, WeekDay } from '@dashforge/calendar-core';
+
+/** Per-slot `className` overrides for `<Calendar>`. */
+export interface CalendarSlotProps {
+  root?: { className?: string };
+  header?: { className?: string };
+  grid?: { className?: string };
+  /** Applied to every day-cell button. */
+  day?: { className?: string };
+}
+
+/**
+ * Props for the `<Calendar>` primitive — a standalone, inline month grid.
+ *
+ * `Calendar` is NOT a form field (no bridge / RBAC integration). It is the
+ * low-level building block used inside `<DatePicker>`. For a form-bound date
+ * input use `<DatePicker>`.
+ *
+ * Dates are ISO `YYYY-MM-DD` strings throughout. The headless date engine is
+ * `@dashforge/calendar-core` — shared with the MUI `@dashforge/ui` calendar.
+ */
+export interface CalendarProps {
+  /** Selected date (controlled). */
+  value?: ISODate | null;
+  /** Initial selected date (uncontrolled). */
+  defaultValue?: ISODate | null;
+  /** Fired when a day is chosen. */
+  onChange?: (value: ISODate) => void;
+  /** Controlled displayed month (1-indexed). Pair with `year`. */
+  month?: number;
+  /** Controlled displayed year. Pair with `month`. */
+  year?: number;
+  /** Initial displayed month (1-indexed, uncontrolled). */
+  defaultMonth?: number;
+  /** Initial displayed year (uncontrolled). */
+  defaultYear?: number;
+  /** Fired when the displayed month changes. */
+  onMonthChange?: (month: number, year: number) => void;
+  /** Earliest selectable date (inclusive). */
+  minDate?: ISODate;
+  /** Latest selectable date (inclusive). */
+  maxDate?: ISODate;
+  /** Explicit list of disabled dates. */
+  disabledDates?: readonly ISODate[];
+  /** Predicate marking arbitrary dates disabled. */
+  isDateDisabled?: (date: ISODate) => boolean;
+  /** Weekday of the grid's first column (`0` = Sunday). Default `0`. */
+  weekStartDay?: WeekDay;
+  /** BCP-47 locale for month/weekday names. Default `"en-US"`. */
+  locale?: string;
+  /** Overrides "today" (ISO `YYYY-MM-DD`), mainly for testing. */
+  today?: ISODate;
+  /** Disables the whole calendar. */
+  disabled?: boolean;
+  /** Moves DOM focus to the active day cell on mount. */
+  autoFocus?: boolean;
+  /** Accessible label for the grid. Default `"Calendar"`. */
+  'aria-label'?: string;
+  /** Root-level Tailwind class override. */
+  sx?: string;
+  /** Per-slot `className` overrides. */
+  slotProps?: CalendarSlotProps;
+  /** Test id applied to the root element. */
+  testId?: string;
+}