playbook_ui 7.0.0.pre.alpha7 → 7.0.0

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_format.md

@@ -0,0 +1 @@
+A full list of formatting tokens, i.e. `"m/d/Y"` can be found [here](https://flatpickr.js.org/formatting/).

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hide_icon.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: { 
+  hide_icon: true, 
+  picker_id: "date-picker-hide-icon" 
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hide_icon.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerHideIcon = () => (
+  <div>
+    <DatePicker
+        hideIcon
+        pickerId="date-picker-hide-icon"
+    />
+  </div>
+)
+
+export default DatePickerHideIcon

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.html.erb

@@ -0,0 +1,37 @@
+<%= pb_rails("date_picker", props: {
+  label: "onChange",
+  picker_id: "date-picker-hooks-onchange"
+}) %>
+
+<%= javascript_tag do %>
+  window.addEventListener("DOMContentLoaded", () => {
+    <%# Access flatpickr instance with picker id and assign it a variable %>
+    const fp = document.querySelector("#date-picker-hooks-onchange")._flatpickr
+
+    <%# Define Hook %>
+    const changeHook = () => {
+      alert('date changed')
+    }
+    <%# Push one or more hooks to onChange config array %>
+    fp.config.onChange.push(changeHook)
+  })
+<% end %>
+
+<%= pb_rails("date_picker", props: {
+  label: "onOpen",
+  picker_id: "date-picker-hooks-onopen"
+}) %>
+
+<%= javascript_tag do %>
+  window.addEventListener("DOMContentLoaded", () => {
+    <%# Access flatpickr instance with picker id and assign it a variable %>
+    const fp = document.querySelector("#date-picker-hooks-onopen")._flatpickr
+
+    <%# Define Hook %>
+    const openHook = () => {
+      alert('calendar opened')
+    }
+    <%# Push one or more hooks to onOpen config array %>
+    fp.config.onOpen.push(openHook)
+  })
+<% end %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.jsx

@@ -0,0 +1,37 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerHooks = () => {
+  // Define hooks
+  const changeHook = () => {
+    alert('date changed')
+  }
+  const openHook = () => {
+    alert('calendar opened')
+  }
+
+  // Access flatpickr instances with picker ids and assign them variables
+  window.addEventListener('DOMContentLoaded', () => {
+    const fpChange = document.querySelector('#date-picker-hooks-onchange')._flatpickr
+    const fpOpen = document.querySelector('#date-picker-hooks-onopen')._flatpickr
+
+    // Push one or more hooks to flatpickr instance's Event config arrays
+    fpChange.config.onChange.push(changeHook)
+    fpOpen.config.onOpen.push(openHook)
+  })
+
+  return (
+    <div>
+      <DatePicker
+          label="onChange"
+          pickerId="date-picker-hooks-onchange"
+      />
+      <DatePicker
+          label="onOpen"
+          pickerId="date-picker-hooks-onopen"
+      />
+    </div>
+  )
+}
+
+export default DatePickerHooks

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_hooks.md

@@ -0,0 +1 @@
+You can find a full list of flatpickr events and hooks in their [documentation](https://flatpickr.js.org/events/).

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.html.erb

@@ -0,0 +1,26 @@
+<%= pb_rails("date_picker", props: {
+  input_aria: { label: "input-field" },
+  input_data: { key: "value", key2: "value2" },
+  name: "date-field",
+  picker_id: "date-picker-input1",
+  type: "date"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: "blank",
+  picker_id: "date-picker-input2",
+  placeholder: "Select Date",
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  default_date: "blank",
+  disable_input: true,
+  picker_id: "date-picker-input3",
+  placeholder: "Disabled Input"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  dark: true,
+  hide_label: true,
+  picker_id: "date-picker-input4"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.jsx

@@ -0,0 +1,32 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerInput = () => (
+  <div>
+    <DatePicker
+        inputAria={{ label: 'input-field' }}
+        inputData={{ key: 'value', key2: 'value2' }}
+        name="date-field"
+        pickerId="date-picker-input1"
+        type="date"
+    />
+    <DatePicker
+        defaultDate="blank"
+        pickerId="date-picker-input2"
+        placeholder="Select Date"
+    />
+    <DatePicker
+        defaultDate="blank"
+        disableInput
+        pickerId="date-picker-input3"
+        placeholder="Disabled Input"
+    />
+    <DatePicker
+        dark
+        hideLabel
+        pickerId="date-picker-input4"
+    />
+  </div>
+)
+
+export default DatePickerInput

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_input.md

@@ -0,0 +1,3 @@
+The date picker is built with the text input kit.  Text input props you pass to the date picker kit will be forwarded to the input, with a few exceptions.  The `value` attribute is automatically handled and bound to whatever date string is contained by the input field.  You cannot pass a custom value prop.  `id` props passed to the date picker kit will be assigned to it's parent/wrapper div.  The `pickerId` prop is passed directly to the input and is required to instatiate the date picker.
+
+You must use `inputAria` or `input_aria` and `inputData` or `input_data` props if you wish to pass data or aria attributes to the text input kit.  If you use `data` or `aria` props they will be passed to the date picker kit itself instead.  Also be aware the default behavior of text input aria and data props is to pass those props to attributes on the wrapping div not on the input itself.

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_label.html.erb

@@ -0,0 +1,9 @@
+<%= pb_rails("date_picker", props: {
+  label: "Your Label Here",
+  picker_id: "date-picker-label"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  hide_label: true,
+  picker_id: "date-picker-hide-label"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_label.jsx

@@ -0,0 +1,17 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerLabel = () => (
+  <div>
+    <DatePicker
+        label="Your Label Here"
+        pickerId="date-picker-label"
+    />
+    <DatePicker
+        hideLabel
+        pickerId="date-picker-hide-label"
+    />
+  </div>
+)
+
+export default DatePickerLabel

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_label.md

@@ -0,0 +1 @@
+Default label prop is `"Date Picker"`.  To remove the label set the `hideLabel` prop in React or the `hide_label` prop in Rails to `true`.

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_min_max.html.erb

@@ -0,0 +1,14 @@
+<%= pb_rails("date_picker", props: {
+  label: "Dynamic dates",
+  max_date: (Date.today + 3).httpdate,
+  min_date: (Date.today - 3).httpdate,
+  picker_id: "date-picker-min-max1"
+}) %>
+
+<%= pb_rails("date_picker", props: {
+  format: "m/d/Y",
+  label: "Absolute formatted dates",
+  max_date: "10/20/2020",
+  min_date: "10/10/2020",
+  picker_id: "date-picker-min-max2"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_min_max.jsx

@@ -0,0 +1,22 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerMinMax = () => (
+  <div>
+    <DatePicker
+        label="Dynamic dates using flatpickr increment function"
+        maxDate={new Date().fp_incr(3)}
+        minDate={new Date().fp_incr(-3)}
+        pickerId="date-picker-min-max1"
+    />
+    <DatePicker
+        format="m/d/Y"
+        label="Absolute formatted dates"
+        maxDate="10/20/2020"
+        minDate="10/10/2020"
+        pickerId="date-picker-min-max2"
+    />
+  </div>
+)
+
+export default DatePickerMinMax

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.jsx

@@ -0,0 +1,34 @@
+import React, { useState } from 'react'
+import { DatePicker, LabelValue } from '../..'
+
+const DatePickerOnChange = () => {
+  const today = new Date()
+  const [dateString, setDateString] = useState(today.toLocaleDateString())
+  const [dateObj, setDateObj] = useState([today])
+
+  const changeHandler = (dateStr, selectedDates) => {
+    setDateString(dateStr)
+    setDateObj(selectedDates)
+  }
+
+  return (
+    <div>
+      <DatePicker
+          defaultDate={dateString}
+          marginBottom="lg"
+          onChange={changeHandler}
+          pickerId="date-picker-onchange"
+      />
+      <LabelValue
+          label="Date Object"
+          marginBottom="lg"
+          value={dateObj[0] ? dateObj[0].toString() : ''}
+      />
+      <LabelValue
+          label="Date String"
+          value={dateString}
+      />
+    </div>
+  )
+}
+export default DatePickerOnChange

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.md

@@ -0,0 +1,3 @@
+Your change handler function has access to two arguments: `dateStr` and `selectedDates`.
+
+The first, `dateStr`, is a string of the chosen date.  The second, `selectedDates`, is an array of selected date objects. In many use cases `selectedDates` will have only one value but you'll still need to access it from index 0.

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_range.html.erb

@@ -0,0 +1,4 @@
+<%= pb_rails("date_picker", props: {
+  mode: "range",
+  picker_id: "date-picker-range"
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_range.jsx

@@ -0,0 +1,13 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerRange = () => (
+  <div>
+    <DatePicker
+        mode="range"
+        pickerId="date-picker-range"
+    />
+  </div>
+)
+
+export default DatePickerRange

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_year_range.html.erb

@@ -0,0 +1,7 @@
+<%= pb_rails("date_picker", props: {
+  default_date: "05/05/2015",
+  max_date: "12/31/2018",
+  min_date: "01/01/2015",
+  picker_id: "date-picker-year-range",
+  year_range: [2015, 2018]
+}) %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_year_range.jsx

@@ -0,0 +1,16 @@
+import React from 'react'
+import { DatePicker } from '../../'
+
+const DatePickerYearRange = () => (
+  <div>
+    <DatePicker
+        defaultDate="05/05/2015"
+        maxDate="12/31/2018"
+        minDate="01/01/2015"
+        pickerId="date-picker-year-range"
+        yearRange={[2015, 2018]}
+    />
+  </div>
+)
+
+export default DatePickerYearRange

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_year_range.md

@@ -0,0 +1 @@
+Defaults to `[1900, 2100]`.  Combine with min-max prop for best results.

data/app/pb_kits/playbook/pb_date_picker/docs/_description.md

@@ -0,0 +1,7 @@
+Playbook's date picker is built using [flatpickr](https://flatpickr.js.org/), a vanilla js library.  Common date picker use cases and features have been adapted into simple prop based configuration detailed in the docs below.  You can implement additional features and functionality by accessing a flatpickr instance directly.  This is done with the following code.
+
+`const fpInstance = document.querySelector('#pickerId')._flatpickr`
+
+`pickerId` is a prop passed to the date picker kit.  Flatpickr uses this id to target an input and attach a flatpickr instance to that input.
+
+To learn more [visit flatpickr's docs](https://flatpickr.js.org/instance-methods-properties-elements/) or see the hook doc section below for an applied example.

data/app/pb_kits/playbook/pb_date_picker/docs/example.yml

@@ -0,0 +1,36 @@
+examples:
+  
+  rails:
+  - date_picker_default: Default
+  - date_picker_hide_icon: Hide Input Icon
+  - date_picker_default_date: Default Date
+  - date_picker_input: Input Field
+  - date_picker_label: Label
+  - date_picker_range: Range
+  - date_picker_format: Format
+  - date_picker_disabled: Disabled Dates
+  - date_picker_min_max: Min Max
+  - date_picker_error: Error
+  - date_picker_hooks: Hooks
+  # - date_picker_allow_input: Allow Input
+  - date_picker_year_range: Year Range
+  - date_picker_dark: Dark
+  
+  
+  react:
+  - date_picker_default: Default
+  - date_picker_hide_icon: Hide Input Icon
+  - date_picker_default_date: Default Date
+  - date_picker_input: Input Field
+  - date_picker_label: Label
+  - date_picker_on_change: onChange
+  - date_picker_range: Range
+  - date_picker_format: Format
+  - date_picker_disabled: Disabled Dates
+  - date_picker_min_max: Min Max
+  - date_picker_error: Error
+  - date_picker_hooks: Hooks
+  # - date_picker_allow_input: Allow Input
+  - date_picker_year_range: Year Range
+  - date_picker_dark: Dark
+  

data/app/pb_kits/playbook/pb_date_picker/docs/index.js

@@ -0,0 +1,15 @@
+export { default as DatePickerDefault } from './_date_picker_default.jsx'
+export { default as DatePickerHideIcon } from './_date_picker_hide_icon.jsx'
+export { default as DatePickerInput } from './_date_picker_input.jsx'
+export { default as DatePickerDefaultDate } from './_date_picker_default_date.jsx'
+export { default as DatePickerLabel } from './_date_picker_label.jsx'
+export { default as DatePickerOnChange } from './_date_picker_on_change.jsx'
+export { default as DatePickerRange } from './_date_picker_range.jsx'
+export { default as DatePickerFormat } from './_date_picker_format.jsx'
+export { default as DatePickerDisabled } from './_date_picker_disabled.jsx'
+export { default as DatePickerMinMax } from './_date_picker_min_max.jsx'
+export { default as DatePickerError } from './_date_picker_error.jsx'
+export { default as DatePickerHooks } from './_date_picker_hooks.jsx'
+// export { default as DatePickerAllowInput } from './_date_picker_allow_input.jsx'
+export { default as DatePickerYearRange } from './_date_picker_year_range.jsx'
+export { default as DatePickerDark } from './_date_picker_dark.jsx'

data/app/pb_kits/playbook/pb_date_picker/sass_partials/_calendar_input_icon.scss

@@ -0,0 +1,33 @@
+// Calendar Icon Styles
+.cal_icon_wrapper {
+  pointer-events: none;
+  position: absolute;
+  top: $space_md + 2;
+  right: 0;
+  border-left: 1px solid $border_light;
+  width: $space_xl + $space_xs;
+  height: $space_xl + 5;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  padding-left: $space_sm - 1;
+  color: $text_lt_light;
+  @media (hover: hover) {
+    &:hover {
+      cursor: pointer;
+    }
+  }
+  &.dark {
+    color: $white;
+    border-color: $border_dark;
+  }
+  &.no_label_shift {
+    top: 0;
+  }
+  &.error {
+    border-left-color: $error;
+  }
+}
+.cal_icon {
+  width: $space_sm;
+}

data/app/pb_kits/playbook/pb_date_picker/sass_partials/_day_styles.scss

@@ -0,0 +1,53 @@
+// Day and Range Styles
+.flatpickr-day {
+  user-select: none;
+  @media (hover: hover) {
+    &:hover {
+      transition-duration: $transition_short;
+      transition-timing-function: $easeIn;    
+      background-color: #F6FAFF;
+      border-color: #F6FAFF;
+      box-shadow: $shadow_deep;
+    }
+  }
+}
+.flatpickr-day.today {
+  border: none;
+  font-weight: $bold;
+  color: $charcoal;
+  &.selected {
+    color: $text_dk_default;
+  }
+}
+.flatpickr-day.selected, .flatpickr-day.startRange, .flatpickr-day.endRange {
+  border-radius: $space_xl + 10;
+  background-color: $primary;
+  border-color: $primary;
+  box-shadow: $shadow_deep;
+  font-weight: $bold; 
+}
+.flatpickr-day.startRange {
+  box-shadow: $space_sm + 1 0 0 #F7FBFF
+}
+.flatpickr-day.endRange {
+  box-shadow: -$space_sm 0 0 #F7FBFF
+}
+.flatpickr-day.inRange {
+  background-color: #F7FBFF;
+  border: 2px;
+  box-shadow: -$space_xs + 4 0 0 #F7FBFF, $space_xs - 3 0 0 #F7FBFF;
+}
+.flatpickr-innerContainer {
+  overflow: visible;
+}
+.flatpickr-days {
+  overflow: visible;
+}
+// Weekday Styling
+div.flatpickr-weekdays {
+  margin-top: $space_xs;
+}
+span.flatpickr-weekday {
+  @include caption;
+  user-select: none;
+}