@api-client/ui 0.5.5 → 0.5.6

package/src/md/date-picker/README.md

@@ -0,0 +1,184 @@
+# Date Picker Components
+
+A comprehensive Material Design 3 styled date picker system with three variants to suit different use cases and screen sizes.
+
+## Components
+
+### 1. Docked Date Picker (`ui-date-picker-input`)
+
+A text field with dropdown calendar, ideal for forms and medium to large layouts.
+
+```html
+<ui-date-picker-input
+  label="Select date"
+  placeholder="MM/DD/YYYY"
+  .value=${new Date()}
+  @change=${this.handleDateChange}
+></ui-date-picker-input>
+```
+
+**Features:**
+
+- Text input with calendar dropdown
+- Keyboard and mouse input support
+- Form integration
+- Customizable date formatting
+
+### 2. Modal Date Picker (`ui-date-picker-modal`)
+
+Full-screen modal for date range selection, perfect for booking interfaces.
+
+```html
+<ui-date-picker-modal
+  .open=${true}
+  .selectedRange=${{ start: new Date(), end: null }}
+  title="Select travel dates"
+  startLabel="Check-in"
+  endLabel="Check-out"
+  @date-range-change=${this.handleRangeChange}
+  @close=${this.handleClose}
+></ui-date-picker-modal>
+```
+
+**Features:**
+
+- Full-screen modal interface
+- Date range selection
+- Calendar/input mode toggle
+- Mobile-optimized
+
+### 3. Modal Input Date Picker (`ui-date-picker-modal-input`)
+
+Manual date entry using keyboard input, ideal for compact layouts.
+
+```html
+<ui-date-picker-modal-input
+  .open=${true}
+  .rangeMode=${true}
+  .selectedRange=${{ start: null, end: null }}
+  @date-input-change=${this.handleInputChange}
+  @modal-input-close=${this.handleClose}
+></ui-date-picker-modal-input>
+```
+
+**Features:**
+
+- Keyboard-focused input
+- Single date or range mode
+- Multiple date format support
+- Validation and error handling
+
+## Calendar Component (`ui-date-picker-calendar`)
+
+The underlying calendar grid component used by other pickers.
+
+```html
+<ui-date-picker-calendar
+  .selectedDate=${new Date()}
+  .rangeSelection=${false}
+  @date-select=${this.handleDateSelect}
+></ui-date-picker-calendar>
+```
+
+## Utility Functions
+
+The `DatePickerUtils` module provides helper functions for date operations:
+
+```javascript
+import { 
+  formatDate, 
+  parseDate, 
+  generateCalendarMonth,
+  isSameDay,
+  addMonths 
+} from './internals/DatePickerUtils.js'
+
+// Format a date
+const formatted = formatDate(new Date(), 'en-US')
+
+// Parse user input
+const date = parseDate('12/25/2024')
+
+// Generate calendar data
+const calendar = generateCalendarMonth(2024, 11) // December 2024
+```
+
+## Common Properties
+
+### Date Constraints
+
+```html
+<!-- Minimum and maximum dates -->
+<ui-date-picker-input
+  .minDate=${new Date('2024-01-01')}
+  .maxDate=${new Date('2024-12-31')}
+></ui-date-picker-input>
+
+<!-- Disabled specific dates -->
+<ui-date-picker-input
+  .disabledDates=${[new Date('2024-12-25'), new Date('2024-01-01')]}
+></ui-date-picker-input>
+```
+
+### Localization
+
+```html
+<!-- Custom locale -->
+<ui-date-picker-input
+  locale="en-GB"
+  .dateFormat=${date => date.toLocaleDateString('en-GB')}
+></ui-date-picker-input>
+```
+
+## Styling
+
+All components follow Material Design 3 guidelines and respect CSS custom properties:
+
+```css
+:root {
+  --ui-color-primary: #6750a4;
+  --ui-color-surface: #fff;
+  --ui-color-on-surface: #1d1b20;
+  --ui-border-radius-medium: 12px;
+  --ui-elevation-level2: 0 2px 8px rgba(0,0,0,0.15);
+}
+```
+
+## Accessibility
+
+- Full keyboard navigation support
+- ARIA labels and roles
+- Screen reader compatible
+- Focus management
+- High contrast support
+
+## Browser Support
+
+- Modern browsers with ES2015+ support
+- Chrome 88+, Firefox 78+, Safari 14+, Edge 88+
+- Mobile browsers on iOS 14+ and Android 7+
+
+## Events
+
+### Docked Date Picker
+
+- `change`: Fired when date selection changes
+
+### Modal Date Picker
+
+- `date-range-change`: Fired when date range changes
+- `close`: Fired when modal closes
+
+### Modal Input Date Picker
+
+- `date-input-change`: Fired when input values change
+- `modal-input-close`: Fired when modal closes
+
+### Calendar Component
+
+- `date-select`: Fired when single date is selected
+- `date-range-select`: Fired when date range is selected
+
+## Examples
+
+See the demo files in `/demo/md/date-picker/` for complete usage examples.

package/src/md/date-picker/index.ts

@@ -0,0 +1,17 @@
+// Export main components
+export { UiDatePickerCalendar } from './internals/DatePickerCalendar.js'
+export { UiDatePickerInput } from './ui-date-picker-input.js'
+export { UiDatePickerModal } from './ui-date-picker-modal.js'
+export { UiDatePickerModalInput } from './ui-date-picker-modal-input.js'
+
+// Export utilities and types
+export * from './internals/DatePickerUtils.js'
+export type { DateSelectEvent, DateRangeSelectEvent } from './internals/DatePickerCalendar.js'
+export type { ModalDatePickerChangeEvent } from './ui-date-picker-modal.js'
+export type { ModalInputDatePickerChangeEvent } from './ui-date-picker-modal-input.js'
+
+// Import components for registration
+import './ui-date-picker-input.js'
+import './ui-date-picker-modal.js'
+import './ui-date-picker-modal-input.js'
+import './internals/DatePickerCalendar.js'

package/src/md/date-picker/internals/DatePicker.styles.ts

@@ -0,0 +1,338 @@
+import { css } from 'lit'
+
+export const calendarStyles = css`
+  :host {
+    display: block;
+    font-family: 'Roboto', sans-serif;
+    font-size: 14px;
+    border-radius: 12px;
+    background: var(--md-sys-color-surface-container-high);
+    border: 1px solid var(--md-sys-color-outline-variant);
+    box-shadow: var(--md-sys-elevation-2);
+    overflow: hidden;
+  }
+
+  .calendar {
+    padding: 20px 12px 12px 12px;
+  }
+
+  /* Header */
+  .header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 30px;
+    gap: 8px;
+  }
+
+  .month-year {
+    display: flex;
+    align-items: center;
+    flex: 1;
+    justify-content: space-between;
+  }
+
+  .month-selector,
+  .year-selector {
+    display: flex;
+    align-items: center;
+  }
+
+  .month-year-text {
+    font-size: 16px;
+    font-weight: 500;
+    color: var(--md-sys-color-on-surface);
+    min-width: 120px;
+  }
+
+  /* Weekdays header */
+  .weekdays {
+    display: grid;
+    grid-template-columns: repeat(7, 40px);
+    margin-bottom: 16px;
+  }
+
+  .weekday {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: 32px;
+    font-size: 12px;
+    font-weight: 500;
+    color: var(--md-sys-color-on-surface-variant);
+    text-transform: uppercase;
+  }
+
+  /* Calendar grid */
+  .days {
+    display: grid;
+    grid-template-columns: repeat(7, 40px);
+    gap: 0;
+  }
+
+  .day-cell {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    position: relative;
+    width: 40px;
+  }
+
+  .day-cell.in-range.has-complete-range {
+    background: var(--md-sys-color-secondary-container);
+  }
+
+  .day-cell.range-start.has-complete-range:not(.range-end) {
+    background: linear-gradient(to right, transparent 50%, var(--md-sys-color-secondary-container) 50%);
+  }
+
+  .day-cell.range-end.has-complete-range:not(.range-start) {
+    background: linear-gradient(to left, transparent 50%, var(--md-sys-color-secondary-container) 50%);
+  }
+
+  .day-cell.range-start.range-end.has-complete-range {
+    background: transparent;
+  }
+
+  .day-button {
+    width: 40px !important;
+    height: 40px !important;
+    min-width: 40px !important;
+    padding: 0;
+  }
+
+  .day-button.other-month {
+    opacity: 0.38;
+  }
+
+  .nav-button,
+  .month-button,
+  .year-button,
+  .other-month .day-button:not([color='filled']):not([disabled]) {
+    color: var(--md-sys-color-on-surface-variant);
+  }
+
+  .month-button,
+  .year-button {
+    padding: 0;
+  }
+
+  .weekday:not([color='filled']),
+  .day-button:not([color='filled']):not([disabled]) {
+    color: var(--md-sys-color-on-surface);
+  }
+
+  .today .day-button:not([color='filled']) {
+    color: var(--md-sys-color-primary);
+  }
+
+  .today .day-button {
+    --md-button-outline-color: var(--md-sys-color-primary);
+  }
+
+  /* Dropdown views */
+  .dropdown-view {
+    min-height: 300px;
+  }
+
+  .close-button {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 32px;
+    height: 32px;
+    border: none;
+    background: transparent;
+    color: var(--md-sys-color-on-surface-variant);
+    cursor: pointer;
+    border-radius: 16px;
+    transition: background-color 0.2s ease;
+  }
+
+  .close-button:hover {
+    background: color-mix(in srgb, var(--md-sys-color-on-surface) 8%, transparent);
+  }
+
+  .close-button:focus {
+    outline: none;
+    background: color-mix(in srgb, var(--md-sys-color-on-surface) 12%, transparent);
+  }
+
+  /* Month dropdown */
+  .month-list {
+    display: grid;
+    grid-template-columns: repeat(3, 1fr);
+    gap: 8px;
+  }
+
+  .year-option:not(.selected),
+  .month-option:not(.selected) {
+    color: var(--md-sys-color-on-surface-variant);
+  }
+
+  /* Year dropdown */
+  .year-grid {
+    display: grid;
+    grid-template-columns: repeat(4, 1fr);
+    gap: 4px;
+    max-height: 240px;
+    overflow-y: auto;
+    padding: 4px;
+  }
+
+  .actions {
+    margin-top: 8px;
+    display: flex;
+    justify-content: flex-end;
+  }
+`
+
+export const inputStyles = css`
+  :host {
+    display: inline-block;
+    width: 100%;
+  }
+
+  .input-container {
+    position: relative;
+  }
+
+  .dropdown-container {
+    position: absolute;
+    position-anchor: --ui-date-picker-anchor;
+    top: anchor(bottom);
+    left: anchor(left);
+    z-index: 1000;
+    margin-top: 4px;
+    min-width: anchor-size(width);
+    width: max-content;
+    max-width: calc(100vw - 32px);
+  }
+
+  .backdrop {
+    position: fixed;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    z-index: 999;
+    background: transparent;
+  }
+`
+
+export const modalStyles = css`
+  .modal-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 24px 24px 16px;
+  }
+
+  .modal-title {
+    font-size: 24px;
+    font-weight: 400;
+    color: var(--md-sys-color-on-surface);
+    margin: 0;
+  }
+
+  .modal-content {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 24px;
+    max-height: 60vh;
+    overflow-y: auto;
+  }
+
+  .modal-content ui-date-picker-calendar {
+    box-shadow: none;
+  }
+
+  .date-range-display {
+    display: flex;
+    align-items: center;
+    gap: 16px;
+    padding: 16px;
+    background: var(--md-sys-color-surface-container-highest);
+    border-radius: 12px;
+    width: 100%;
+    max-width: 320px;
+  }
+
+  .date-display {
+    flex: 1;
+    text-align: center;
+  }
+
+  .date-label {
+    font-size: 12px;
+    font-weight: 500;
+    color: var(--md-sys-color-on-surface-variant);
+    text-transform: uppercase;
+    margin-bottom: 4px;
+  }
+
+  .date-value {
+    font-size: 16px;
+    font-weight: 400;
+    color: var(--md-sys-color-on-surface);
+  }
+
+  .date-separator {
+    color: var(--md-sys-color-on-surface-variant);
+    font-size: 18px;
+  }
+
+  .modal-actions {
+    display: flex;
+    justify-content: flex-end;
+    gap: 8px;
+    padding: 16px 24px;
+    border-top: 1px solid var(--md-sys-color-outline-variant);
+  }
+
+  /* Calendar Action Buttons */
+  .actions {
+    display: flex;
+    justify-content: flex-end;
+    gap: 8px;
+    margin-top: 16px;
+    padding-top: 16px;
+    border-top: 1px solid var(--md-sys-color-outline-variant);
+  }
+
+  /* Pending selection state */
+  .day.pending {
+    background: var(--md-sys-color-secondary-container);
+    color: var(--md-sys-color-on-secondary-container);
+    border: 2px solid var(--md-sys-color-secondary);
+  }
+
+  .day.pending.selected {
+    background: var(--md-sys-color-secondary);
+    color: var(--md-sys-color-on-secondary);
+  }
+
+  .day.pending.range-start,
+  .day.pending.range-end {
+    background: var(--md-sys-color-secondary);
+    color: var(--md-sys-color-on-secondary);
+  }
+
+  .day.pending.in-range {
+    background: var(--md-sys-color-secondary-container);
+    color: var(--md-sys-color-on-secondary-container);
+  }
+
+  /* Responsive */
+  @media (max-width: 640px) {
+    .modal-content {
+      padding: 16px;
+    }
+
+    .calendar {
+      width: 100%;
+      max-width: 320px;
+    }
+  }
+`