playbook_ui 18.0.0 → 18.0.1.pre.rc.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ba21582839d4a05178fc1ea74ca0ad1b8ca652238e4119192fe4c461dcbb9ae
-  data.tar.gz: 453a53b804b46fb84aaa6d9efd1bf1f316b7525633a57134da3d3f4b6b8c46dd
+  metadata.gz: 4f7783b8463c90951131604bdf5eac75eb7fff9767a5c356de003e2eec536569
+  data.tar.gz: 99211c843243aa798424571effdacca18bc2a7bb5aab3bd3fb0f7934dd58a4b8
 SHA512:
-  metadata.gz: 02f76fdc192859f041aa853a8f155c01248c0bf849a00484409ed5154f99dc4f92bb9829bf24da859c5c38bc532108724eda2dcbe1f11edd1ff527eaa89e1826
-  data.tar.gz: 8fa85b1670735641741175e82792867fc72459c5ac1040a5117314a66d2a3ce874c83b017fd4342b56d1d80c5c03c90a23c75629ba15cb74c05240696a2cf6fb
+  metadata.gz: a19623f9af10397c92244acd88d1e80773655bb988c7b7ed8a9472ee0b018ab53514430911f3b6a0ea3a146ba54534a28704f9d13b010746445591d6f46c941f
+  data.tar.gz: c3ef61f6dadfcfcf8c07f757596816573834536e757bab91a2f85e886692e3cf3db7b8633e957b032c776b2422fd20d3a7245f0b6b58fc4be14f4a60c5c43e42

data/app/pb_kits/playbook/pb_body/_body.tsx

@@ -3,6 +3,7 @@ import classnames from 'classnames'
 
 import { buildAriaProps, buildCss, buildDataProps, buildHtmlProps } from '../utilities/props'
 import { deprecatedProps, globalProps, GlobalProps } from '../utilities/globalProps'
+import { globalEventProps, GlobalEventProps } from '../utilities/globalEventProps'
 
 import Highlight from '../pb_highlight/_highlight'
 
@@ -21,7 +22,7 @@ type BodyProps = {
   tag?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'span' | 'div',
   text?: string,
   variant?: null | 'link',
-} & GlobalProps
+} & GlobalProps & GlobalEventProps
 
 const Body = (props: BodyProps): React.ReactElement => {
   if (props.variant) deprecatedProps() //status prop is deprecated, use color instead please
@@ -56,6 +57,7 @@ const Body = (props: BodyProps): React.ReactElement => {
         {...ariaProps}
         {...dataProps}
         {...htmlProps}
+        {...globalEventProps(props)}
         className={classes}
         id={id}
     >

data/app/pb_kits/playbook/pb_body/kit.schema.json

@@ -94,6 +94,7 @@
     }
   },
   "globalProps": true,
+  "globalEventProps": true,
   "usage": {
     "react": {
       "import": "import { Body } from 'playbook-ui'",

data/app/pb_kits/playbook/pb_card/_card.tsx

@@ -7,6 +7,7 @@ import classnames from 'classnames'
 
 import { buildAriaProps, buildDataProps, buildHtmlProps } from '../utilities/props'
 import { GlobalProps, globalProps, globalInlineProps } from '../utilities/globalProps'
+import { GlobalEventProps, globalEventProps } from '../utilities/globalEventProps'
 import type { ProductColors, CategoryColors, BackgroundColors, StatusColors } from '../types/colors'
 
 import Icon from '../pb_icon/_icon'
@@ -34,7 +35,7 @@ type CardPropTypes = {
   padding?: string,
   selected?: boolean,
   tag?: "div" | "section" | "footer" | "header" | "article" | "aside" | "main" | "nav",
-} & GlobalProps
+} & GlobalProps & GlobalEventProps
 
 type CardHeaderProps = {
   headerColor?: BackgroundColors | ProductColors | CategoryColors | StatusColors | "none",
@@ -156,6 +157,7 @@ const Card = (props: CardPropTypes): React.ReactElement => {
             {...dataProps}
             className={classnames(cardCss, globalProps(props), className)}
             {...restHtmlProps}
+            {...globalEventProps(props)}
             style={mergedStyles}
         >
           {subComponentTags('Header')}
@@ -185,6 +187,7 @@ const Card = (props: CardPropTypes): React.ReactElement => {
               {...dataProps}
               className={classnames(cardCss, globalProps(props), className)}
               {...restHtmlProps}
+              {...globalEventProps(props)}
               style={mergedStyles}
             >
               {subComponentTags('Header')}

data/app/pb_kits/playbook/pb_card/_card_mixin.scss

@@ -25,6 +25,16 @@ $additional_colors: (
 );
 $background_colors: map-merge($product_colors, $additional_colors);
 $pb_card_header_colors: map-merge(map-merge(map-merge($product_colors, $additional_colors), $category_colors), $status_colors);
+// Prop sizes only — legacy $border_radius keys like "light" collide with background_light.
+$pb_card_border_radius_values: (
+  xs: $border_radius_xs,
+  sm: $border_radius_sm,
+  md: $border_radius_md,
+  lg: $border_radius_lg,
+  xl: $border_radius_xl,
+  none: $border_radius_none,
+  rounded: $border_radius_rounded,
+);
 
 @mixin pb_card_selected($border_color: $primary) {
   border-color: $border_color;
@@ -63,8 +73,8 @@ $pb_card_header_colors: map-merge(map-merge(map-merge($product_colors, $addition
     }
   }
 
-  @each $name, $radius in $border_radius {
-    &[class*=_#{$name}] {
+  @each $name, $radius in $pb_card_border_radius_values {
+    &.pb_card_kit_border_radius_#{$name} {
       border-radius: $radius;
     }
   }

data/app/pb_kits/playbook/pb_card/kit.schema.json

@@ -186,6 +186,7 @@
     }
   },
   "globalProps": true,
+  "globalEventProps": true,
   "usage": {
     "react": {
       "import": "import { Card } from 'playbook-ui'",

data/app/pb_kits/playbook/pb_dropdown/_dropdown.tsx

@@ -112,6 +112,8 @@ type DropdownProps = {
     isClosed?: boolean;
     label?: string;
     multiSelect?: boolean;
+    name?: string;
+    onChange?: (event: { target: { name?: string; value: any } }) => void;
     onSelect?: (arg: GenericObject) => null;
     options?: GenericObject;
     placeholder?: string;
@@ -156,6 +158,8 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
         label,
         multiSelect = false,
         formPillProps,
+        name,
+        onChange,
         onSelect,
         options,
         placeholder,
@@ -414,6 +418,10 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
         setIsDropDownClosed(false);
     };
 
+    const handleSelectionChange = (value: any) => {
+        onSelect && onSelect(value);
+        onChange && onChange({ target: { name, value } });
+    };
 
       const handleOptionClick = (clickedItem: GenericObject) => {
                 if (disabled) return;
@@ -426,7 +434,7 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
                        const next = exists
                        ? list.filter((option) => option.value !== clickedItem.value)
                            : [...list, clickedItem];
-                   onSelect && onSelect(next);
+                   handleSelectionChange(next);
                        return next;
                    });
                    setFilterItem("");
@@ -439,7 +447,7 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
                    if (shouldCloseOnClick) {
                        setIsDropDownClosed(true);
                    }
-                   onSelect && onSelect(clickedItem);
+                   handleSelectionChange(clickedItem);
                    
                    // Sync with DatePickers if this is a quickpick variant
                    if (variant === "quickpick" && Array.isArray(clickedItem.value)) {
@@ -468,10 +476,10 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
       if (disabled) return;
       if (multiSelect) {
         setSelected([]);
-        onSelect && onSelect([]);
+        handleSelectionChange([]);
       } else {
         setSelected({});
-        onSelect && onSelect(null);
+        handleSelectionChange(null);
         setFocusedOptionIndex(-1);
         setFilterItem("");
         
@@ -505,10 +513,10 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
       clearSelected: () => {
         if (multiSelect) {
           setSelected([]);
-          onSelect && onSelect([]);
+          handleSelectionChange([]);
         } else {
           setSelected({});
-          onSelect && onSelect(null);
+          handleSelectionChange(null);
         }
         setFilterItem("");
         setIsDropDownClosed(true);
@@ -522,16 +530,16 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
         clearSelected: () => {
           if (multiSelect) {
             setSelected([]);
-            onSelect && onSelect([]);
+            handleSelectionChange([]);
           } else {
             setSelected({});
-            onSelect && onSelect(null);
+            handleSelectionChange(null);
           }
           setFilterItem("");
           setIsDropDownClosed(true);
         },
       };
-    }, [multiSelect, onSelect, setSelected, setFilterItem, setIsDropDownClosed]);
+    }, [multiSelect, handleSelectionChange, setSelected, setFilterItem, setIsDropDownClosed]);
 
     useImperativeHandle(ref, () => imperativeRef.current);
 
@@ -594,6 +602,7 @@ let Dropdown = (props: DropdownProps, ref: any): React.ReactElement | null => {
                     handleBackspace,
                     handleChange,
                     handleOptionClick,
+                    handleSelectionChange,
                     handleWrapperClick,
                     inputRef,
                     inputWrapperRef,

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options.html.erb

@@ -0,0 +1,34 @@
+<%= pb_rails("select", props: {
+  id: "color_context_dropdown",
+  label: "Choose a Color",
+  name: "color_name",
+  options: [
+    { value: "red", value_text: "Red" },
+    { value: "blue", value_text: "Blue" },
+    { value: "green", value_text: "Green" },
+  ],
+}) %>
+
+<%= pb_rails("dropdown", props: {
+  id: "dropdown-dynamic-options",
+  label: "Pick a Shade",
+  name: "shade_name",
+  context_selector: "color_context_dropdown",
+  options_by_context: {
+    "red" => [
+      { id: "scarlet", label: "Scarlet", value: "scarlet" },
+      { id: "mahogany", label: "Mahogany", value: "mahogany" },
+      { id: "crimson", label: "Crimson", value: "crimson" },
+    ],
+    "blue" => [
+      { id: "sky", label: "Sky Blue", value: "sky" },
+      { id: "cerulean", label: "Cerulean", value: "cerulean" },
+      { id: "navy", label: "Navy", value: "navy" },
+    ],
+    "green" => [
+      { id: "emerald", label: "Emerald", value: "emerald" },
+      { id: "mint", label: "Mint", value: "mint" },
+      { id: "olive", label: "Olive", value: "olive" },
+    ],
+  },
+}) %>

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options.md

@@ -0,0 +1,4 @@
+You can set up a dropdown to update its options dynamically based on another input. To achieve this:
+- Give the dropdown a unique `id` so it can be targeted by events and linked to a controlling input.
+- Use `context_selector` to point at the controlling select’s `id`. On connect, and whenever that select’s value changes, the Dropdown reads the current value as its context.
+- Use `options_by_context` to pass a hash of option lists. Keys must match the possible values of the controlling select; each key maps to an array of `{ id, label, value }` options that replace the Dropdown’s options for that context.

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options_with_autocomplete.html.erb

@@ -0,0 +1,35 @@
+<%= pb_rails("select", props: {
+  id: "color_context_dropdown_autocomplete",
+  label: "Choose a Color",
+  name: "color_name_autocomplete",
+  options: [
+    { value: "red", value_text: "Red" },
+    { value: "blue", value_text: "Blue" },
+    { value: "green", value_text: "Green" },
+  ],
+}) %>
+
+<%= pb_rails("dropdown", props: {
+  id: "dropdown-dynamic-options-autocomplete",
+  label: "Pick a Shade",
+  name: "shade_name_autocomplete",
+  autocomplete: true,
+  context_selector: "color_context_dropdown_autocomplete",
+  options_by_context: {
+    "red" => [
+      { id: "scarlet", label: "Scarlet", value: "scarlet" },
+      { id: "mahogany", label: "Mahogany", value: "mahogany" },
+      { id: "crimson", label: "Crimson", value: "crimson" },
+    ],
+    "blue" => [
+      { id: "sky", label: "Sky Blue", value: "sky" },
+      { id: "cerulean", label: "Cerulean", value: "cerulean" },
+      { id: "navy", label: "Navy", value: "navy" },
+    ],
+    "green" => [
+      { id: "emerald", label: "Emerald", value: "emerald" },
+      { id: "mint", label: "Mint", value: "mint" },
+      { id: "olive", label: "Olive", value: "olive" },
+    ],
+  },
+}) %>

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options_with_autocomplete.md

@@ -0,0 +1 @@
+Dynamic options also work with `autocomplete`. Use the same `context_selector` and `options_by_context` setup as Dynamic Options, and set `autocomplete: true` so the Dropdown can be filtered by typing. 

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options_with_multi_select.html.erb

@@ -0,0 +1,35 @@
+<%= pb_rails("select", props: {
+  id: "color_context_dropdown_multi",
+  label: "Choose a Color",
+  name: "color_name_multi",
+  options: [
+    { value: "red", value_text: "Red" },
+    { value: "blue", value_text: "Blue" },
+    { value: "green", value_text: "Green" },
+  ],
+}) %>
+
+<%= pb_rails("dropdown", props: {
+  id: "dropdown-dynamic-options-multi",
+  label: "Pick Shades",
+  name: "shade_names",
+  multi_select: true,
+  context_selector: "color_context_dropdown_multi",
+  options_by_context: {
+    "red" => [
+      { id: "scarlet", label: "Scarlet", value: "scarlet" },
+      { id: "mahogany", label: "Mahogany", value: "mahogany" },
+      { id: "crimson", label: "Crimson", value: "crimson" },
+    ],
+    "blue" => [
+      { id: "sky", label: "Sky Blue", value: "sky" },
+      { id: "cerulean", label: "Cerulean", value: "cerulean" },
+      { id: "navy", label: "Navy", value: "navy" },
+    ],
+    "green" => [
+      { id: "emerald", label: "Emerald", value: "emerald" },
+      { id: "mint", label: "Mint", value: "mint" },
+      { id: "olive", label: "Olive", value: "olive" },
+    ],
+  },
+}) %>

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_dynamic_options_with_multi_select.md

@@ -0,0 +1 @@
+Dynamic options also work with `multi_select`. Use the same `context_selector` and `options_by_context` setup as Dynamic Options, and set `multi_select: true` to allow selecting multiple options.

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_multi_select_react_hook.jsx

@@ -0,0 +1,45 @@
+import React from 'react'
+
+import Dropdown from '../_dropdown'
+import Title from '../../pb_title/_title'
+import { useForm } from 'react-hook-form'
+
+const options = [
+  { label: 'United States', value: 'unitedStates', id: 'us' },
+  { label: 'United Kingdom', value: 'unitedKingdom', id: 'gb' },
+  { label: 'Canada', value: 'canada', id: 'ca' },
+  { label: 'Pakistan', value: 'pakistan', id: 'pk' },
+  { label: 'India', value: 'india', id: 'in' },
+  { label: 'Australia', value: 'australia', id: 'au' },
+  { label: 'New Zealand', value: 'new Zealand', id: 'nz' },
+  { label: 'Italy', value: 'italy', id: 'it' },
+  { label: 'Spain', value: 'spain', id: 'es' },
+]
+
+const DropdownMultiSelectReactHook = (props) => {
+  const { register, watch } = useForm()
+
+  const selectedCountries = watch('countries')
+
+  return (
+    <>
+      <Dropdown
+          label="Countries"
+          multiSelect
+          options={options}
+          {...props}
+          {...register('countries')}
+      />
+      <Title
+          marginTop="sm"
+          size={4}
+          text="Selected Countries"
+      />
+      {selectedCountries && selectedCountries.map(country => (
+        <p key={country.id}>{`${country.label} - ${country.value}`}</p>
+      ))}
+    </>
+  )
+}
+
+export default DropdownMultiSelectReactHook

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_multi_select_react_hook.md

@@ -0,0 +1 @@
+You can pass `react-hook-form` props to a multi-select Dropdown. Spread `register` onto Dropdown with `multiSelect` to keep the selected options array in form state.

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_react_hook.jsx

@@ -0,0 +1,36 @@
+import React from 'react'
+
+import Dropdown from '../_dropdown'
+import Title from '../../pb_title/_title'
+import { useForm } from 'react-hook-form'
+
+const options = [
+  { label: 'United States', value: 'unitedStates', id: 'us' },
+  { label: 'Canada', value: 'canada', id: 'ca' },
+  { label: 'Pakistan', value: 'pakistan', id: 'pk' },
+]
+
+const DropdownReactHook = (props) => {
+  const { register, watch } = useForm()
+
+  const selectedCountry = watch('country')
+
+  return (
+    <>
+      <Dropdown
+          label="Countries"
+          options={options}
+          {...props}
+          {...register('country')}
+      />
+      <Title
+          marginTop="sm"
+          size={4}
+          text="Selected Country"
+      />
+      <p>{selectedCountry && `${selectedCountry.label} - ${selectedCountry.value}`}</p>
+    </>
+  )
+}
+
+export default DropdownReactHook

data/app/pb_kits/playbook/pb_dropdown/docs/_dropdown_react_hook.md

@@ -0,0 +1 @@
+You can pass `react-hook-form` props to the Dropdown kit. Spread `register` onto a single-select Dropdown to keep the selected option in form state.

data/app/pb_kits/playbook/pb_dropdown/docs/_playground.json

@@ -88,6 +88,7 @@
       "name": "Content",
       "props": [
         "label",
+        "name",
         "placeholder",
         "options",
         "defaultValue",
@@ -130,6 +131,7 @@
     {
       "name": "Events",
       "props": [
+        "onChange",
         "onSelect"
       ]
     }

data/app/pb_kits/playbook/pb_dropdown/docs/_playground.overrides.json

@@ -70,6 +70,7 @@
       "name": "Content",
       "props": [
         "label",
+        "name",
         "placeholder",
         "options",
         "defaultValue",
@@ -111,7 +112,7 @@
     },
     {
       "name": "Events",
-      "props": ["onSelect"]
+      "props": ["onChange", "onSelect"]
     }
   ],
   "presets": [

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

@@ -39,6 +39,9 @@ examples:
   - dropdown_disabled: Disabled Input
   - dropdown_grouped_options: Grouped Options
   - dropdown_custom_event_type: Custom Event Type
+  - dropdown_dynamic_options: Dynamic Options
+  - dropdown_dynamic_options_with_autocomplete: Dynamic Options with Autocomplete
+  - dropdown_dynamic_options_with_multi_select: Dynamic Options with Multi Select
 
   react:
   - dropdown_default: Default
@@ -81,3 +84,6 @@ examples:
   - dropdown_required_indicator: Required Indicator
   - dropdown_disabled: Disabled Input
   - dropdown_grouped_options: Grouped Options
+  - dropdown_react_hook: React Hook
+  - dropdown_multi_select_react_hook: React Hook Multi Select
+

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

@@ -1,4 +1,6 @@
 export { default as DropdownDefault } from './_dropdown_default.jsx'
+export { default as DropdownReactHook } from './_dropdown_react_hook.jsx'
+export { default as DropdownMultiSelectReactHook } from './_dropdown_multi_select_react_hook.jsx'
 export { default as DropdownWithCustomDisplay } from './_dropdown_with_custom_display.jsx'
 export { default as DropdownWithCustomOptions } from './_dropdown_with_custom_options.jsx'
 export { default as DropdownWithCustomTrigger } from './_dropdown_with_custom_trigger.jsx'

data/app/pb_kits/playbook/pb_dropdown/dropdown.rb

@@ -59,6 +59,14 @@ module Playbook
                                 default: false
       prop :custom_event_type, type: Playbook::Props::String,
                                default: ""
+      prop :options_by_context, type: Playbook::Props::HashProp,
+                                default: {}
+      prop :context_selector, type: Playbook::Props::String,
+                              default: ""
+      prop :clear_on_context_change, type: Playbook::Props::Boolean,
+                                     default: true
+      prop :options_event_type, type: Playbook::Props::String,
+                                default: ""
 
       def data
         Hash(prop(:data)).merge(
@@ -73,7 +81,11 @@ module Playbook
           end_date_id: variant == "quickpick" ? end_date_id : nil,
           controls_start_id: variant == "quickpick" && controls_start_id.present? ? controls_start_id : nil,
           controls_end_id: variant == "quickpick" && controls_end_id.present? ? controls_end_id : nil,
-          custom_event_type: custom_event_type.presence
+          custom_event_type: custom_event_type.presence,
+          pb_dropdown_options_by_context: options_by_context.present? ? options_by_context.to_json : nil,
+          pb_dropdown_context_selector: context_selector.presence,
+          pb_dropdown_clear_on_context_change: clear_on_context_change,
+          options_event_type: options_event_type.presence
         ).compact
       end