@api-client/ui 0.5.5 → 0.5.7

package/src/elements/highlight/MarkdownStyles.ts

@@ -1,17 +1,4 @@
 /**
-@license
-Copyright 2016 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
-/**
 ## Styles for markdown viewer
 
 It should be included where the `marked-highlight` is used.

package/src/elements/http/BodyEditor.ts

@@ -1,16 +1,3 @@
-/**
-@license
-Copyright 2020 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
 import { html, TemplateResult, PropertyValues, nothing } from 'lit'
 import { property, query } from 'lit/decorators.js'
 import type { IBodyMetaModel, IRawBody, IUrlEncodedBodyMeta } from '@api-client/core/models/RequestUiMeta.js'

package/src/elements/http/BodyTextEditor.ts

@@ -1,17 +1,4 @@
 /* eslint-disable @typescript-eslint/ban-ts-comment */
-/**
-@license
-Copyright 2018 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
 import { html, nothing, TemplateResult } from 'lit'
 import { property, query } from 'lit/decorators.js'
 // import * as monaco from 'monaco-editor'; // /esm/vs/editor/editor.main.js

package/src/elements/http/BodyUrlEncodedEditor.ts

@@ -1,16 +1,3 @@
-/**
-@license
-Copyright 2020 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
 import { html, TemplateResult, PropertyValues, nothing } from 'lit'
 import { property } from 'lit/decorators.js'
 import { live } from 'lit/directives/live.js'

package/src/elements/http/UrlInput.ts

@@ -1,16 +1,3 @@
-/**
- @license
-Copyright 2018 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
 import { html, TemplateResult } from 'lit'
 import { classMap } from 'lit/directives/class-map.js'
 import { StyleInfo, styleMap } from 'lit/directives/style-map.js'

package/src/index.ts

@@ -9,6 +9,23 @@ export { default as Menu } from './md/menu/internal/Menu.js'
 export { default as MenuItem } from './md/menu/internal/MenuItem.js'
 export { default as SubMenu } from './md/menu/internal/SubMenu.js'
 
+// Date Picker Components
+export {
+  UiDatePickerCalendar,
+  UiDatePickerInput,
+  UiDatePickerModal,
+  UiDatePickerModalInput,
+} from './md/date-picker/index.js'
+export type {
+  DateRange,
+  CalendarDay,
+  CalendarMonth,
+  DateSelectEvent,
+  DateRangeSelectEvent,
+  ModalDatePickerChangeEvent,
+  ModalInputDatePickerChangeEvent,
+} from './md/date-picker/index.js'
+
 // Demo
 export { DemoPage } from './demo/DemoPage.js'
 

package/src/md/button/internals/base.ts

@@ -234,6 +234,8 @@ export default class BaseButton extends UiElement {
     const allowedReasons = reason === 'enter' || reason === 'space'
     if (this.type === 'submit' && (!reason || allowedReasons)) {
       this.handleSubmit()
+    } else if (this.type === 'reset' && (!reason || allowedReasons)) {
+      this.handleReset()
     } else if (allowedReasons) {
       this.click()
     }
@@ -337,6 +339,11 @@ export default class BaseButton extends UiElement {
     }
   }
 
+  protected handleReset(): void {
+    const form = this.form as HTMLFormElement
+    form?.reset()
+  }
+
   override handlePointerEnter(e: PointerEvent): void {
     super.handlePointerEnter(e)
     this.ripple?.beginHover(e)

package/src/md/button/internals/button.styles.ts

@@ -269,7 +269,7 @@ export default css`
 
   /* Outlined Button */
   :host([color='outlined']) {
-    border: 1px var(--md-sys-color-outline-variant) solid;
+    border: 1px var(--md-button-outline-color, var(--md-sys-color-outline-variant)) solid;
     --_color: var(--md-sys-color-on-surface-variant);
   }
 

package/src/md/date/internals/DateTime.ts

@@ -1,17 +1,3 @@
-/**
-@license
-Copyright 2016 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
-
 export type DateTimeTextOptions = 'long' | 'short' | 'narrow'
 export type DateTimeNumberOptions = 'numeric' | '2-digit'
 export type DateTimeTimezoneOptions = 'long' | 'short'

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'