@telus-uds/components-base 1.1.0 → 1.3.1

package/src/StackView/StackWrapBox.jsx

@@ -1,23 +1,25 @@
 import React, { forwardRef } from 'react'
 import PropTypes from 'prop-types'
 import { View } from 'react-native'
-
 import {
-  spacingProps,
   a11yProps,
+  getA11yPropsFromHtmlTag,
   getTokensPropType,
+  layoutTags,
   responsiveProps,
+  selectSystemProps,
+  spacingProps,
   useSpacingScale,
   useResponsiveProp,
-  viewProps,
-  getA11yPropsFromHtmlTag,
-  layoutTags
+  viewProps
 } from '../utils'
 import { useThemeTokens } from '../ThemeProvider'
 import { useViewport } from '../ViewportProvider'
 import getStackedContent from './getStackedContent'
 import { staticStyles, selectFlexStyles } from './common'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
 const offsetSides = {
   row: 'marginBottom',
   column: 'marginRight'
@@ -64,11 +66,10 @@ const StackWrapBox = forwardRef(
     const direction = useResponsiveProp(directionProp, 'row')
     const themeTokens = useThemeTokens('StackView', tokens, variant, { viewport })
     const flexStyles = selectFlexStyles(themeTokens)
-    const props = {
+    const selectedProps = selectProps({
       ...getA11yPropsFromHtmlTag(tag, accessibilityRole),
-      ...a11yProps.select(rest),
-      ...viewProps.select(rest)
-    }
+      ...rest
+    })
 
     // Mimic CSS `gap` using box spacing on the side after a wrapped row then offsetting it on the last row.
     const gapSize = useSpacingScale(gap)
@@ -79,7 +80,7 @@ const StackWrapBox = forwardRef(
     return (
       <View
         ref={ref}
-        {...props}
+        {...selectedProps}
         style={[flexStyles, staticStyles.wrap, staticStyles[direction], offsetStyle]}
       >
         {content}
@@ -90,8 +91,7 @@ const StackWrapBox = forwardRef(
 StackWrapBox.displayName = 'StackWrapBox'
 
 StackWrapBox.propTypes = {
-  ...a11yProps.propTypes,
-  ...viewProps.types,
+  ...selectedSystemPropTypes,
   tokens: getTokensPropType('StackView'),
   /**
    * Sets the `flexDirection` of the container

package/src/StackView/StackWrapGap.jsx

@@ -4,16 +4,19 @@ import { View } from 'react-native'
 import StackWrapBox from './StackWrapBox'
 import {
   a11yProps,
+  getA11yPropsFromHtmlTag,
+  selectSystemProps,
   useSpacingScale,
   useResponsiveProp,
-  viewProps,
-  getA11yPropsFromHtmlTag
+  viewProps
 } from '../utils'
 import { useThemeTokens } from '../ThemeProvider'
 import { useViewport } from '../ViewportProvider'
 import getStackedContent from './getStackedContent'
 import { staticStyles, selectFlexStyles } from './common'
 
+const [selectProps] = selectSystemProps([a11yProps, viewProps])
+
 /**
  * The primary implementation of StackWrap.
  *
@@ -42,11 +45,10 @@ const StackWrapGap = forwardRef(
     const direction = useResponsiveProp(directionProp, 'row')
     const themeTokens = useThemeTokens('StackView', tokens, variant, { viewport })
     const flexStyles = selectFlexStyles(themeTokens)
-    const props = {
+    const selectedProps = selectProps({
       ...getA11yPropsFromHtmlTag(tag, accessibilityRole),
-      ...a11yProps.select(rest),
-      ...viewProps.select(rest)
-    }
+      ...rest
+    })
 
     const size = useSpacingScale(space)
     const gapStyle = { gap: size }
@@ -56,7 +58,7 @@ const StackWrapGap = forwardRef(
     return (
       <View
         ref={ref}
-        {...props}
+        {...selectedProps}
         style={[flexStyles, staticStyles.wrap, staticStyles[direction], gapStyle]}
       >
         {content}

package/src/StackView/getStackedContent.jsx

@@ -7,7 +7,7 @@ import Spacer from '../Spacer'
 /**
  * @typedef {import('react').ReactChildren} ReactChildren
  * @typedef {import('react').ReactElement} ReactElement
- * @typedef {import('../utils/propTypes.js').SpacingValue} SpacingValue
+ * @typedef {import('../utils/props/spacingProps.js').SpacingValue} SpacingValue
  */
 
 /**

package/src/StepTracker/Step.jsx

@@ -1,12 +1,13 @@
 import React from 'react'
 import PropTypes from 'prop-types'
 import { StyleSheet, Text, View } from 'react-native'
-
 import StackView from '../StackView'
 import Icon from '../Icon'
-import { getTokensPropType, variantProp } from '../utils'
+import { a11yProps, getTokensPropType, selectSystemProps, variantProp, viewProps } from '../utils'
 import { applyTextStyles } from '../ThemeProvider'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
 const selectCompletedIconTokens = ({ completedIconColor, completedIconSize }) => ({
   size: completedIconSize,
   color: completedIconColor
@@ -117,7 +118,7 @@ const getStepTestID = (isCompleted, isCurrent) => {
 /**
  * A single step of a StepTracker.
  */
-const Step = ({ label, name, status = 0, stepCount = 0, stepIndex = 0, tokens }) => {
+const Step = ({ label, name, status = 0, stepCount = 0, stepIndex = 0, tokens, ...rest }) => {
   const { completedIcon, showStepLabel, showStepName, ...themeTokens } = tokens
   const isFirst = stepIndex === 0
   const isLast = stepIndex === stepCount - 1
@@ -131,7 +132,8 @@ const Step = ({ label, name, status = 0, stepCount = 0, stepIndex = 0, tokens })
       tokens={{ alignItems: 'stretch', flexGrow: 1 }}
       accessibilityLabel={label}
       accessibilityLevel={2}
-      accessibilityCurrent={status === stepIndex ? 'true' : 'false'}
+      accessibilityCurrent={status === stepIndex}
+      {...selectProps(rest)}
     >
       <StackView direction="row" space={0} tokens={{ alignItems: 'center', flexGrow: 0 }}>
         <View
@@ -178,6 +180,7 @@ const Step = ({ label, name, status = 0, stepCount = 0, stepIndex = 0, tokens })
 }
 
 Step.propTypes = {
+  ...selectedSystemPropTypes,
   label: PropTypes.string.isRequired,
   name: PropTypes.string.isRequired,
   status: PropTypes.number.isRequired,

package/src/StepTracker/StepTracker.jsx

@@ -1,17 +1,16 @@
 import React, { forwardRef } from 'react'
 import PropTypes from 'prop-types'
 import { StyleSheet, Text, View } from 'react-native'
-
 import StackView from '../StackView'
 import { applyTextStyles, useThemeTokens } from '../ThemeProvider'
-import { getTokensPropType, variantProp } from '../utils'
-import { a11yProps } from '../utils/propTypes'
+import { a11yProps, getTokensPropType, selectSystemProps, variantProp, viewProps } from '../utils'
 import { useViewport } from '../ViewportProvider'
 import useCopy from '../utils/useCopy'
-
 import Step from './Step'
 import defaultDictionary from './dictionary'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
 const selectContainerStyles = ({
   containerPaddingBottom,
   containerPaddingLeft,
@@ -101,7 +100,7 @@ const StepTracker = forwardRef(
       .replace('%{stepCount}', steps.length)
       .replace('%{stepLabel}', current < steps.length ? steps[current] : steps[steps.length - 1])
     if (!steps.length) return null
-    const accessibilityProps = {
+    const selectedProps = selectProps({
       accessibilityLabel: stepTrackerLabel,
       accessibilityLevel: 1,
       accessibilityRole: 'progressbar',
@@ -111,11 +110,11 @@ const StepTracker = forwardRef(
         now: current,
         text: steps[current]
       },
-      ...a11yProps.select(rest)
-    }
+      ...rest
+    })
 
     return (
-      <View ref={ref} style={selectContainerStyles(themeTokens)} {...accessibilityProps}>
+      <View ref={ref} style={selectContainerStyles(themeTokens)} {...selectedProps}>
         <StackView space={0}>
           <View style={staticStyles.stepsContainer}>
             {steps.map((label, index) => {
@@ -150,6 +149,7 @@ const StepTracker = forwardRef(
 StepTracker.displayName = 'StepTracker'
 
 StepTracker.propTypes = {
+  ...selectedSystemPropTypes,
   current: PropTypes.number,
   copy: PropTypes.oneOf(['en', 'fr']),
   dictionary: PropTypes.shape({

package/src/Tabs/Tabs.jsx

@@ -1,16 +1,26 @@
 import React, { forwardRef, useCallback } from 'react'
 import PropTypes from 'prop-types'
 import ABBPropTypes from 'airbnb-prop-types'
-
 import { useThemeTokens } from '../ThemeProvider'
 import StackView from '../StackView'
-import { getTokensPropType, variantProp, useHash, useInputValue } from '../utils'
+import {
+  a11yProps,
+  getTokensPropType,
+  selectSystemProps,
+  useHash,
+  useInputValue,
+  variantProp,
+  viewProps,
+  withLinkRouter
+} from '../utils'
 import HorizontalScroll, {
   horizontalScrollUtils,
   HorizontalScrollButton
 } from '../HorizontalScroll'
 import TabsItem from './TabsItem'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
 const { selectHorizontalScrollTokens, useItemPositions } = horizontalScrollUtils
 
 /**
@@ -19,7 +29,19 @@ const { selectHorizontalScrollTokens, useItemPositions } = horizontalScrollUtils
  */
 const Tabs = forwardRef(
   (
-    { tokens, itemTokens, scrollButtonTokens, variant, value, initialValue, onChange, items = [] },
+    {
+      tokens,
+      itemTokens,
+      scrollButtonTokens,
+      variant,
+      value,
+      initialValue,
+      onChange,
+      items = [],
+      LinkRouter,
+      linkRouterProps,
+      ...rest
+    },
     ref
   ) => {
     const { space, ...themeTokens } = useThemeTokens('Tabs', tokens, variant)
@@ -47,28 +69,43 @@ const Tabs = forwardRef(
         tokens={selectHorizontalScrollTokens(themeTokens)}
         scrollButtonTokens={scrollButtonTokens}
         accessibilityRole="tablist"
+        {...selectProps(rest)}
       >
         <StackView space={space} direction="row">
-          {items.map(({ href, label, id, ref: itemRef }, index) => {
-            const itemId = id ?? label
-            const isSelected = Boolean(currentValue && currentValue === itemId)
-            const handlePress = (event) => setValue(itemId, event)
-            return (
-              <TabsItem
-                ref={itemRef}
-                key={itemId}
-                href={href}
-                variant={variant}
-                tokens={itemTokens}
-                onPress={handlePress}
-                selected={isSelected}
-                itemPositions={itemPositions}
-                index={index}
-              >
-                {label}
-              </TabsItem>
-            )
-          })}
+          {items.map(
+            (
+              {
+                href,
+                label,
+                id,
+                ref: itemRef,
+                LinkRouter: ItemLinkRouter = LinkRouter,
+                linkRouterProps: itemLinkRouterProps
+              },
+              index
+            ) => {
+              const itemId = id ?? label
+              const isSelected = Boolean(currentValue && currentValue === itemId)
+              const handlePress = (event) => setValue(itemId, event)
+              return (
+                <TabsItem
+                  ref={itemRef}
+                  key={itemId}
+                  href={href}
+                  variant={variant}
+                  tokens={itemTokens}
+                  onPress={handlePress}
+                  selected={isSelected}
+                  itemPositions={itemPositions}
+                  index={index}
+                  LinkRouter={ItemLinkRouter}
+                  linkRouterProps={{ ...linkRouterProps, ...itemLinkRouterProps }}
+                >
+                  {label}
+                </TabsItem>
+              )
+            }
+          )}
         </StackView>
       </HorizontalScroll>
     )
@@ -77,8 +114,11 @@ const Tabs = forwardRef(
 Tabs.displayName = 'Tabs'
 
 Tabs.propTypes = {
+  ...selectedSystemPropTypes,
+  ...withLinkRouter.PropTypes,
   items: PropTypes.arrayOf(
     PropTypes.shape({
+      ...withLinkRouter.PropTypes,
       href: PropTypes.string,
       label: PropTypes.string,
       id: PropTypes.string,

package/src/Tabs/TabsItem.jsx

@@ -4,16 +4,22 @@ import { Platform, Pressable, StyleSheet, Text, View } from 'react-native'
 
 import { applyTextStyles, useThemeTokensCallback } from '../ThemeProvider'
 import {
+  a11yProps,
+  clickProps,
+  getTokensPropType,
+  linkProps,
   resolvePressableTokens,
+  selectSystemProps,
   selectTokens,
   variantProp,
-  getTokensPropType,
-  linkProps,
-  a11yProps
+  viewProps,
+  withLinkRouter
 } from '../utils'
 import Spacer from '../Spacer'
 import { horizontalScrollUtils } from '../HorizontalScroll'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
+
 const { itemPositionsPropType, getItemPositionLayoutHandler } = horizontalScrollUtils
 
 const selectHighlightBarStyles = ({
@@ -73,7 +79,6 @@ const selectContainerStyles = ({
 const TabsItem = forwardRef(
   (
     {
-      onPress,
       href,
       variant,
       tokens,
@@ -86,10 +91,13 @@ const TabsItem = forwardRef(
         ? // Web links can't be aria-selected but can be aria-current
           { current: selected ? 'page' : false }
         : { selected },
-      ...rest
+      ...rawRest
     },
     ref
   ) => {
+    // Convert onClick etc to onPress etc if used in an integration
+    const { onPress, ...rest } = clickProps.toPressProps(rawRest)
+
     const getTokens = useThemeTokensCallback('TabsItem', tokens, variant)
     const resolveTokens = (pressableState) =>
       resolvePressableTokens(getTokens, pressableState, { selected })
@@ -105,17 +113,17 @@ const TabsItem = forwardRef(
     const openHref = href && linkProps.handleHref({ href })
     const handlePress =
       onPress || openHref
-        ? () => {
-            if (onPress) onPress()
-            if (openHref) openHref()
+        ? (...args) => {
+            if (onPress) onPress(...args)
+            if (openHref) openHref(...args)
           }
         : undefined
 
-    const a11y = {
+    const selectedProps = selectProps({
       accessibilityRole,
       accessibilityState,
-      ...a11yProps.select(rest)
-    }
+      ...rest
+    })
 
     useEffect(() => {
       // If this is selected while off-screen, scroll it into view
@@ -141,7 +149,7 @@ const TabsItem = forwardRef(
         href={href}
         style={getPressableStyle}
         onLayout={handleLayout}
-        {...a11y}
+        {...selectedProps}
       >
         {(pressableState) => {
           const { space, textAlign, ...themeTokens } = resolveTokens(pressableState)
@@ -181,7 +189,7 @@ const TabsItem = forwardRef(
 TabsItem.displayName = 'TabsItem'
 
 TabsItem.propTypes = {
-  ...a11yProps.propTypes,
+  ...selectedSystemPropTypes,
   tokens: getTokensPropType('TabsItem'),
   variant: variantProp.propType,
   onPress: PropTypes.func,
@@ -209,4 +217,4 @@ const staticStyles = StyleSheet.create({
   }
 })
 
-export default TabsItem
+export default withLinkRouter(TabsItem)

package/src/Tags/Tags.jsx

@@ -10,14 +10,18 @@ import { useViewport } from '../ViewportProvider'
 import { useThemeTokens, useThemeTokensCallback } from '../ThemeProvider'
 import {
   a11yProps,
+  getTokensPropType,
   pressProps,
+  selectSystemProps,
+  selectTokens,
   variantProp,
-  getTokensPropType,
-  selectTokens
-} from '../utils/propTypes'
+  viewProps
+} from '../utils/props'
 import { useMultipleInputValues } from '../utils/input'
 import { getPressHandlersWithArgs } from '../utils/pressability'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, pressProps, viewProps])
+
 const selectIconTextTokens = ({
   icon,
   iconPosition,
@@ -85,14 +89,20 @@ const Tags = forwardRef(
       readOnly
     })
 
-    const a11y = a11yProps.select({
+    const selectedProps = selectProps({
       accessibilityRole,
       ...rest
     })
     const itemA11yRole = 'checkbox'
 
     return (
-      <StackWrap ref={ref} {...a11y} space={space} direction={direction} tokens={stackTokens}>
+      <StackWrap
+        ref={ref}
+        {...selectedProps}
+        space={space}
+        direction={direction}
+        tokens={stackTokens}
+      >
         {items.map(({ label, id = label, accessibilityLabel, ref: itemRef }, index) => {
           const isSelected = currentValues.includes(id)
 
@@ -161,8 +171,7 @@ const Tags = forwardRef(
 Tags.displayName = 'Tags'
 
 Tags.propTypes = {
-  ...a11yProps.propTypes,
-  ...pressProps.propTypes,
+  ...selectedSystemPropTypes,
   tokens: getTokensPropType('Tags'),
   variant: variantProp.propType,
   /**

package/src/TextInput/TextArea.jsx

@@ -1,13 +1,25 @@
 import React, { forwardRef, useState } from 'react'
 
 import { Platform } from 'react-native'
-import { getTokensPropType, variantProp } from '../utils'
+import {
+  a11yProps,
+  getTokensPropType,
+  inputSupportsProps,
+  selectSystemProps,
+  variantProp,
+  viewProps
+} from '../utils'
 import InputSupports from '../InputSupports'
 import TextInputBase from './TextInputBase'
 import { useThemeTokens } from '../ThemeProvider'
-import inputSupportProps from '../InputSupports/propTypes'
 import textInputPropTypes from './propTypes'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([
+  a11yProps,
+  inputSupportsProps,
+  viewProps
+])
+
 /**
  * Use to collect long-form information such as product feedback or support queries.
  * Due to React Native's implementation of `TextInput` it's not possible to access the current value by passing a ref.
@@ -32,7 +44,7 @@ import textInputPropTypes from './propTypes'
  * or an indicator that the field is optional.
  * It is a more usable and accessible option than the HTML `placeholder` attribute.
  */
-const TextArea = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref) => {
+const TextArea = forwardRef(({ tokens, variant = {}, ...rest }, ref) => {
   const themeTokens = useThemeTokens('TextArea', tokens, variant)
   const [inputHeight, setInputHeight] = useState()
 
@@ -48,10 +60,10 @@ const TextArea = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref) =
     }
   }
 
-  const { props: supportsProps, rest } = inputSupportProps.select(remainingProps)
+  const { props: supportsProps, ...selectedProps } = selectProps(rest)
 
   const inputProps = {
-    ...rest,
+    ...selectedProps,
     variant: { ...variant, validation: supportsProps.validation },
     multiline: true,
     onContentSizeChange: onHeightChange,
@@ -61,8 +73,8 @@ const TextArea = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref) =
 
   return (
     <InputSupports {...supportsProps}>
-      {({ a11yProps, inputId }) => (
-        <TextInputBase ref={ref} {...inputProps} {...a11yProps} nativeID={inputId} />
+      {({ inputId, ...props }) => (
+        <TextInputBase ref={ref} {...inputProps} nativeID={inputId} {...props} />
       )}
     </InputSupports>
   )
@@ -70,7 +82,7 @@ const TextArea = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref) =
 TextArea.displayName = 'TextArea'
 
 TextArea.propTypes = {
-  ...inputSupportProps.types,
+  ...selectedSystemPropTypes,
   ...textInputPropTypes,
   tokens: getTokensPropType('TextArea', 'TextInput'), // TODO: support both TextArea and TextInput tokens
   variant: variantProp.propType

package/src/TextInput/TextInput.jsx

@@ -1,11 +1,23 @@
 import React, { forwardRef } from 'react'
 
-import { getTokensPropType, variantProp } from '../utils'
+import {
+  a11yProps,
+  getTokensPropType,
+  inputSupportsProps,
+  selectSystemProps,
+  variantProp,
+  viewProps
+} from '../utils'
 import InputSupports from '../InputSupports'
 import TextInputBase from './TextInputBase'
-import inputSupportProps from '../InputSupports/propTypes'
 import textInputPropTypes from './propTypes'
 
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([
+  a11yProps,
+  inputSupportsProps,
+  viewProps
+])
+
 /**
  * A basic text input component. Use in forms or individually to receive user's input.
  * Due to React Native's implementation of `TextInput` it's not possible to access the current value by passing a ref.
@@ -24,19 +36,19 @@ import textInputPropTypes from './propTypes'
  * supported props and <a href="https://reactnative.dev/docs/textinput" target="_blank">React Native Web documentation</a> for
  * their implementation on the web.
  */
-const TextInput = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref) => {
-  const { props: supportsProps, rest } = inputSupportProps.select(remainingProps)
+const TextInput = forwardRef(({ tokens, variant = {}, ...rest }, ref) => {
+  const { props: supportsProps, ...selectedProps } = selectProps(rest)
 
   const inputProps = {
-    ...rest,
+    ...selectedProps,
     tokens,
     variant: { ...variant, validation: supportsProps.validation }
   }
 
   return (
     <InputSupports {...supportsProps}>
-      {({ a11yProps, inputId }) => (
-        <TextInputBase ref={ref} {...inputProps} {...a11yProps} nativeID={inputId} />
+      {({ inputId, ...props }) => (
+        <TextInputBase ref={ref} {...inputProps} nativeID={inputId} {...props} />
       )}
     </InputSupports>
   )
@@ -44,7 +56,7 @@ const TextInput = forwardRef(({ tokens, variant = {}, ...remainingProps }, ref)
 TextInput.displayName = 'TextInput'
 
 TextInput.propTypes = {
-  ...inputSupportProps.types,
+  ...selectedSystemPropTypes,
   ...textInputPropTypes,
   tokens: getTokensPropType('TextInput'),
   variant: variantProp.propType

package/src/TextInput/TextInputBase.jsx

@@ -3,7 +3,16 @@ import { Platform, StyleSheet, TextInput as NativeTextInput, View } from 'react-
 
 import PropTypes from 'prop-types'
 import { applyTextStyles, useThemeTokens, applyOuterBorder } from '../ThemeProvider'
-import { getTokensPropType, useInputValue, variantProp } from '../utils'
+import {
+  a11yProps,
+  getTokensPropType,
+  selectSystemProps,
+  useInputValue,
+  variantProp,
+  viewProps
+} from '../utils'
+
+const [selectProps, selectedSystemPropTypes] = selectSystemProps([a11yProps, viewProps])
 
 const selectInputStyles = (
   {
@@ -114,7 +123,7 @@ const TextInputBase = forwardRef(
       onMouseOut,
       tokens,
       variant = {},
-      ...remainingProps
+      ...rest
     },
     ref
   ) => {
@@ -158,7 +167,7 @@ const TextInputBase = forwardRef(
     const { icon: IconComponent } = themeTokens
 
     const inputProps = {
-      ...remainingProps,
+      ...selectProps(rest),
       editable: !inactive,
       onFocus: handleFocus,
       onBlur: handleBlur,
@@ -191,6 +200,7 @@ const TextInputBase = forwardRef(
 TextInputBase.displayName = 'TextInputBase'
 
 TextInputBase.propTypes = {
+  ...selectedSystemPropTypes,
   value: PropTypes.string,
   height: PropTypes.number,
   initialValue: PropTypes.string,

package/src/ThemeProvider/useThemeTokens.js

@@ -2,9 +2,9 @@ import { useCallback } from 'react'
 import useTheme from './useTheme'
 import { getComponentTheme, getThemeTokens, resolveThemeTokens, mergeAppearances } from './utils'
 /**
- * @typedef {import('../utils/propTypes.js').AppearanceSet} AppearanceSet
- * @typedef {import('../utils/propTypes.js').TokensProp} TokensProp
- * @typedef {import('../utils/propTypes.js').TokensSet} TokensSet
+ * @typedef {import('../utils/props/variantProp.js').AppearanceSet} AppearanceSet
+ * @typedef {import('../utils/props/tokens.js').TokensProp} TokensProp
+ * @typedef {import('../utils/props/tokens.js').TokensSet} TokensSet
  */
 
 /**