@telus-uds/components-base 1.10.0 → 1.11.0

package/CHANGELOG.md

@@ -1,12 +1,30 @@
 # Change Log - @telus-uds/components-base
 
-This log was last generated on Wed, 20 Jul 2022 23:56:08 GMT and should not be manually modified.
+This log was last generated on Mon, 25 Jul 2022 18:17:39 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## 1.11.0
+
+Mon, 25 Jul 2022 18:17:39 GMT
+
+### Minor changes
+
+- adding reference for html dom element (tiagohldb@gmail.com)
+- adding useScrollBlocking hook to avoid modal background content from scrolling (tiagohldb@gmail.com)
+- feat: add InputSupports to the base exports (ruslan.bredikhin@nearform.com)
+- limiting skeleton width to be max to container width (tiagohldb@gmail.com)
+
+### Patches
+
+- Fill in RN TextInput handlers (alan.slater@nearform.com)
+- Make Carousel multi-lingual with nameable items (alan.slater@nearform.com)
+- Carousel accessibility: unordered list with hidden siblings (alan.slater@nearform.com)
+- fix: react native and web version updates (srikanthkhari@gmail.com)
+
 ## 1.10.0
 
-Wed, 20 Jul 2022 23:56:08 GMT
+Wed, 20 Jul 2022 23:57:28 GMT
 
 ### Minor changes
 
@@ -15,7 +33,7 @@ Wed, 20 Jul 2022 23:56:08 GMT
 
 ### Patches
 
-- Fix an issue where StepTracker might break where `stepLabel` and/or `stepTrackerLabel` are not read before reading their `dictionary` values  (shahzaibkhalidmalik@outlook.com)
+- Fix an issue where StepTracker might break where `stepLabel` and/or `stepTrackerLabel` are not read before reading their `dictionary` values (shahzaibkhalidmalik@outlook.com)
 
 ## 1.9.0
 

package/component-docs.json

@@ -4334,6 +4334,125 @@
         }
       }
     },
+    "InputSupports": {
+      "docs": {
+        "description": "",
+        "props": {
+          "copy": {
+            "defaultValue": {
+              "value": "'en'",
+              "computed": false
+            },
+            "type": {
+              "name": "enum",
+              "value": [
+                {
+                  "value": "'en'",
+                  "computed": false
+                },
+                {
+                  "value": "'fr'",
+                  "computed": false
+                }
+              ]
+            },
+            "required": false,
+            "description": "Whether the English or French copy will be used (e.g. for accessibility labels)."
+          },
+          "hintPosition": {
+            "defaultValue": {
+              "value": "'inline'",
+              "computed": false
+            },
+            "type": {
+              "name": "enum",
+              "value": [
+                {
+                  "value": "'inline'",
+                  "computed": false
+                },
+                {
+                  "value": "'below'",
+                  "computed": false
+                }
+              ]
+            },
+            "required": false,
+            "description": "Position of the hint relative to label."
+          },
+          "children": {
+            "type": {
+              "name": "union",
+              "value": [
+                {
+                  "name": "func"
+                },
+                {
+                  "name": "node"
+                }
+              ]
+            },
+            "required": false,
+            "description": ""
+          },
+          "label": {
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "The input label."
+          },
+          "hint": {
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "A short description of the expected input."
+          },
+          "feedback": {
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "A detailed description of validation error/success or additional instructions.\nVisual variant is determined based on the `validation` prop."
+          },
+          "tooltip": {
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "Content of an optional `Tooltip`. If set, a tooltip button will be shown next to the label."
+          },
+          "validation": {
+            "type": {
+              "name": "enum",
+              "value": [
+                {
+                  "value": "'error'",
+                  "computed": false
+                },
+                {
+                  "value": "'success'",
+                  "computed": false
+                }
+              ]
+            },
+            "required": false,
+            "description": "Use to visually mark an input as valid or invalid."
+          },
+          "nativeID": {
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "ID for DOM element on web"
+          }
+        },
+        "attributes": {
+          "acceptsRNA11yProps": false
+        }
+      }
+    },
     "List": {
       "docs": {
         "description": "An unordered List component has a child a ListItem that\nallows icon, dividers and customized typography",
@@ -6916,15 +7035,24 @@
               "computed": false
             },
             "type": {
-              "name": "enum",
+              "name": "union",
               "value": [
                 {
-                  "value": "'en'",
-                  "computed": false
+                  "name": "enum",
+                  "value": [
+                    {
+                      "value": "'en'",
+                      "computed": false
+                    },
+                    {
+                      "value": "'fr'",
+                      "computed": false
+                    }
+                  ]
                 },
                 {
-                  "value": "'fr'",
-                  "computed": false
+                  "name": "custom",
+                  "raw": "dictionaryContentShape"
                 }
               ]
             },
@@ -6940,31 +7068,13 @@
               "name": "shape",
               "value": {
                 "en": {
-                  "name": "shape",
-                  "value": {
-                    "stepLabel": {
-                      "name": "string",
-                      "required": false
-                    },
-                    "stepTrackerLabel": {
-                      "name": "string",
-                      "required": false
-                    }
-                  },
+                  "name": "custom",
+                  "raw": "dictionaryContentShape",
                   "required": false
                 },
                 "fr": {
-                  "name": "shape",
-                  "value": {
-                    "stepLabel": {
-                      "name": "string",
-                      "required": false
-                    },
-                    "stepTrackerLabel": {
-                      "name": "string",
-                      "required": false
-                    }
-                  },
+                  "name": "custom",
+                  "raw": "dictionaryContentShape",
                   "required": false
                 }
               }
@@ -8300,6 +8410,17 @@
       "docs": {
         "description": "Carousel is a general-purpose content slider that can be used to render content in terms of slides.\n\n  ## Usage\n  - `Carousel` is a top-level export from `@telus-uds/components-base` which is used to render a Carousel\n  - Immediately within `Carousel`, individual slides are wrapped in `Carousel.Item` for the top-level `Carousel` to know how to identify an individual slide\n  - You can use any UDS component or other platform-specific component, (based on the platform you're rendering) to achieve any desired layout\n  - By default, Carousel takea all the `width` available to it and the `height` is determined based on the content in the slide with more content\n  - You may want to wrap Carousel in other layout components like `Box`, `FlexGrid` etc, to achieve a responsive layout of your need\n\n  ## `useCarousel` custom hook\n\n  ```jsx\n  import { useCarousel } from '@telus-uds/components-base'\n\n  const SomeComponentWithinCarouselItem = () => {\n    const {\n      activeIndex,\n      totalItems,\n      width,\n      goTo\n    } = useCarousel()\n    return <Text>Hi!</Text>\n  }\n  ```\n\n  You can use `useCarousel` to hook into internal state of the Carousel component like:\n  - `activeIndex`: Index of the current slide\n  - `totalItems`: Total number of items/slides passed to the Carousel\n  - `width`: Width of the individual carousel slide\n  - `goTo`: A function to go to a particular slide by passing the index of that slide, e.g: goTo(0) where `0` is the index of the first slide\n\n  ## Accessibility\n\n  - Top-level `Carousel` and `Carousel.Item` can take all possible React Native's `View` and `a11y` props\n  - If your slide contains input elements like buttons, you may want to configure them to be only focusable when `activeIndex` is equal to the current slide index in order to avoid tabbing going between slides\n\n  ## Platform considerations\n  The component is available on both native platforms and web.\n\n  ## Other considerations\n  - You may want to use the same kind of layout in all your slides to avoid visual and height differences\n  - `previous` and `next` navigation buttons are automatically removed in `sm` and `xs` viewports, as these smaller viewports offers swipe functionality\n\n  ## Tokens\n\n  You can override the following tokens in exceptional circumstances:\n  - `previousIcon` - Icon of the previous button\n  - `nextIcon` - Icon of the next button\n  - `showPreviousNextNavigation` - If you want to show/hide the previous/next navigation\n  - `showPanelNavigation` - If you want to show/hide the panel navigation\n  - `spaceBetweenSlideAndPreviousNextNavigation` - Horizontal space between slide and previous/next navigational buttons\n  - `spaceBetweenSlideAndPanelNavigation` - Vertical space between slide area and panel navigation area",
         "props": {
+          "itemLabel": {
+            "defaultValue": {
+              "value": "'item'",
+              "computed": false
+            },
+            "type": {
+              "name": "string"
+            },
+            "required": false,
+            "description": "Lowercase language-appropriate user-facing description of what each Carousel slide represents.\nThis is used when generating item labels. For example, if a carousel contains offers,\npass itemLabel=\"summer offer\" (or copy=\"fr\" and an appropriate French translation) to genereate\naccessible labels such as \"Summer offer 1 of 3\" and \"Show summer offer 2 of 3\"."
+          },
           "previousNextNavigationPosition": {
             "defaultValue": {
               "value": "'inside'",
@@ -8383,38 +8504,94 @@
             "required": false,
             "description": "Carousel uses `Animated.spring` to animate slide changes, use this option to pass custom animation configuration"
           },
-          "panelNavigationTextDictionary": {
+          "tag": {
             "defaultValue": {
-              "value": "{\n  en: {\n    stepTrackerLabel: 'Showing %{stepNumber} of %{stepCount}'\n  },\n  fr: {\n    stepTrackerLabel: 'Étape %{stepNumber} sur %{stepCount}: %{stepLabel}'\n  }\n}",
+              "value": "'ul'",
               "computed": false
             },
             "type": {
-              "name": "shape",
-              "value": {
-                "en": {
-                  "name": "shape",
-                  "value": {
-                    "stepTrackerLabel": {
-                      "name": "string",
-                      "required": true
-                    }
-                  },
-                  "required": false
+              "name": "enum",
+              "value": [
+                {
+                  "value": "'h1'",
+                  "computed": false
                 },
-                "fr": {
-                  "name": "shape",
-                  "value": {
-                    "stepTrackerLabel": {
-                      "name": "string",
-                      "required": true
-                    }
-                  },
-                  "required": false
+                {
+                  "value": "'h2'",
+                  "computed": false
+                },
+                {
+                  "value": "'h3'",
+                  "computed": false
+                },
+                {
+                  "value": "'h4'",
+                  "computed": false
+                },
+                {
+                  "value": "'h5'",
+                  "computed": false
+                },
+                {
+                  "value": "'h6'",
+                  "computed": false
+                },
+                {
+                  "value": "'article'",
+                  "computed": false
+                },
+                {
+                  "value": "'aside'",
+                  "computed": false
+                },
+                {
+                  "value": "'blockquote'",
+                  "computed": false
+                },
+                {
+                  "value": "'footer'",
+                  "computed": false
+                },
+                {
+                  "value": "'figure'",
+                  "computed": false
+                },
+                {
+                  "value": "'form'",
+                  "computed": false
+                },
+                {
+                  "value": "'header'",
+                  "computed": false
+                },
+                {
+                  "value": "'ul'",
+                  "computed": false
+                },
+                {
+                  "value": "'li'",
+                  "computed": false
+                },
+                {
+                  "value": "'main'",
+                  "computed": false
+                },
+                {
+                  "value": "'nav'",
+                  "computed": false
+                },
+                {
+                  "value": "'section'",
+                  "computed": false
+                },
+                {
+                  "value": "'label'",
+                  "computed": false
                 }
-              }
+              ]
             },
             "required": false,
-            "description": "Use this to override the default text for panel navigation"
+            "description": "HTML tag to use for the Carousel item's immediate parent. Defaults to `'ul'` so that\nassistive technology tools know to intepret the carousel as a list.\n\nNote that if the immediate Carousel children do not all render as `'li'` elements,\nthis should be changed (e.g. pass tag=\"div\") because only 'li' is a valid child of 'ul'."
           },
           "accessibilityRole": {
             "defaultValue": {
@@ -8519,6 +8696,35 @@
             },
             "required": false,
             "description": "When slide animation end with parameter of current index (after animation ends)\nThis function is also provided with a parameter indicating the updated slide index after animation ends\nUse it as follows:\n```js\n   const onAnimationEndCallback = React.useCallback((changedIndex) => {\n     console.log(changedIndex)\n   }, [])  // pass local dependencies as per your component\n   <Carousel\n     onAnimationEnd={onAnimationEndCallback}\n   >\n     <Carousel.Item>First Slide</Carousel.Item>\n   </Carousel>\n```\nCaution: Always consider wrapping your callback for `onAnimationEnd` in `useCallback` in order to avoid bugs and performance issues"
+          },
+          "panelNavigationTextDictionary": {
+            "type": {
+              "name": "shape",
+              "value": {
+                "en": {
+                  "name": "shape",
+                  "value": {
+                    "stepTrackerLabel": {
+                      "name": "string",
+                      "required": true
+                    }
+                  },
+                  "required": false
+                },
+                "fr": {
+                  "name": "shape",
+                  "value": {
+                    "stepTrackerLabel": {
+                      "name": "string",
+                      "required": true
+                    }
+                  },
+                  "required": false
+                }
+              }
+            },
+            "required": false,
+            "description": "Use this to override the default text for panel navigation"
           }
         },
         "attributes": {
@@ -8529,6 +8735,95 @@
         "docs": {
           "description": "`Carousel.Item` is used to wrap the content of an individual slide and is suppsoed to be the\nonly top-level component passed to the `Carousel`",
           "props": {
+            "tag": {
+              "defaultValue": {
+                "value": "'li'",
+                "computed": false
+              },
+              "type": {
+                "name": "enum",
+                "value": [
+                  {
+                    "value": "'h1'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'h2'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'h3'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'h4'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'h5'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'h6'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'article'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'aside'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'blockquote'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'footer'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'figure'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'form'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'header'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'ul'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'li'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'main'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'nav'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'section'",
+                    "computed": false
+                  },
+                  {
+                    "value": "'label'",
+                    "computed": false
+                  }
+                ]
+              },
+              "required": false,
+              "description": "Sets the HTML tag of the outer container. By default `'li'` so that assistive technology sees\nthe Carousel as a list of items.\n\nCarousel's innermost container defaults to `'ul'` which can be overridden. If the tag of either\n`Carousel` or `Carousel.Item` is overriden, the other should be too, to avoid producing invalid HTML."
+            },
             "elementIndex": {
               "type": {
                 "name": "number"