@tempoxyz/ds 0.2.6 → 0.3.1

package/src/web/components/AssetChip.tsx

@@ -0,0 +1,110 @@
+import { useRender } from '@base-ui/react/use-render'
+import type * as zyzz from 'zyzz'
+import { style } from '../zyzz.config.js'
+
+/**
+ * A small, gray label for a supported asset or network. It renders a `span`, or a `button` when
+ * it has an `onClick`, which then fills on hover, scales slightly while pressed, shows an outline
+ * on keyboard focus, and fills dark while `selected`. Place a `TokenLogo` before the text to add a 12px token logo.
+ *
+ * - List what a row or value supports, such as the assets a network accepts, under a row title.
+ * - Give it an `onClick` to pick one asset from a short set, and set `selected` on the picked one.
+ * - Use `Badge` for a status and `Token` for a token the person can change.
+ *
+ * @example
+ * <AssetChip>USDT</AssetChip>
+ * <AssetChip onClick={() => setAsset('USDC')} selected={asset === 'USDC'}>
+ *   <TokenLogo symbol="USDC" />
+ *   USDC
+ * </AssetChip>
+ *
+ * @see {@link https://base-ui.com/react/utils/use-render | Base UI useRender}
+ * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/button/ | WAI-ARIA APG Button pattern}
+ */
+export function AssetChip(props: AssetChip.Props) {
+  const { className, ref, render, selected, vars, ...attributes } = props
+  const pressable = attributes.onClick !== undefined
+  const button = pressable && render === undefined
+
+  return useRender({
+    defaultTagName: button ? 'button' : 'span',
+    props: {
+      ...attributes,
+      ...(pressable && { 'aria-pressed': selected }),
+      ...(button && { type: 'button' }),
+      'data-selected': selected || undefined,
+      ...styles.chip({ className, style: props.style, vars }),
+    },
+    ref,
+    render,
+  })
+}
+
+export namespace AssetChip {
+  export type Props = useRender.ComponentProps<'span'> &
+    zyzz.Props.Variants<typeof styles.chip> & {
+      /**
+       * Fills the chip with `content.primary`. A chip with an `onClick` sets `aria-pressed` from
+       * it, so pass it on every chip of a set. Absent, the chip renders no pressed state. A chip
+       * rendered through `render` takes its `type` from that element, such as
+       * `<button type="button" />`.
+       */
+      selected?: boolean | undefined
+    }
+}
+
+namespace styles {
+  // Figma's Asset Chip pads 2px and 4px inside radius `2xs`, below the 1.5x padding ratio.
+  export const chip = style(
+    {
+      alignItems: 'center',
+      backgroundColor: 'background.primary',
+      border: 'none !custom',
+      borderRadius: '2xs',
+      boxSizing: 'border-box',
+      color: 'content.secondary',
+      columnGap: '4',
+      display: 'inline-flex',
+      flexShrink: '0 !custom',
+      height: '20',
+      margin: '0',
+      outlineColor: 'transparent !custom',
+      outlineOffset: '0',
+      outlineStyle: 'solid !custom',
+      outlineWidth: '2',
+      paddingBlock: '2',
+      paddingInline: '4',
+      transitionDuration: '160',
+      transitionProperty: 'background-color, color, outline-color, scale !custom',
+      transitionTimingFunction: 'snappy',
+      typography: 'body.b3Strong',
+      verticalAlign: 'middle',
+      whiteSpace: 'nowrap',
+      selectors: {
+        // A nested `TokenLogo` shrinks to the 12px logo slot.
+        '& > img': { flexShrink: '0 !custom', height: '12', width: '12' },
+        '&:is(button)': { cursor: 'pointer' },
+        // A chip rendered as a disabled `button` dims and takes no hover or press feedback.
+        '&:is(button):disabled': { cursor: 'default', opacity: 'disabled' },
+        '&:is(button):not(:disabled):active': { scale: 'press', transitionDuration: '100' },
+        // Figma's focused chip widens by 2px on each side and draws its ring inside the edge.
+        '&:is(button):focus-visible': {
+          outlineColor: 'border.focus',
+          outlineOffset: '-2',
+          paddingInline: '6',
+        },
+        '&:is(button):not([data-selected], :disabled):hover': {
+          backgroundColor: 'container.strong',
+        },
+        '&[data-selected]': { backgroundColor: 'content.primary', color: 'background.elevated' },
+        // An inside ring would vanish into the selected fill, so a selected chip draws it outside.
+        '&[data-selected]:focus-visible': { outlineOffset: '2' },
+      },
+      '@media (prefers-reduced-motion: reduce)': {
+        transitionProperty: 'background-color, color, outline-color !custom',
+        selectors: { '&:is(button):not(:disabled):active': { scale: 'none !custom' } },
+      },
+    },
+    { id: 'tds/web/asset-chip' },
+  )
+}

package/src/web/components/Autocomplete.tsx

@@ -103,16 +103,16 @@ export namespace Autocomplete {
   }
 
   /**
-   * Draws the field surface around `Input` and its actions. `size` sets a 32, 40 or 56px height,
-   * and `invalid` shows the error ring without setting `aria-invalid` on the input.
+   * Draws the 48px field surface around `Input` and its actions. `invalid` fills it red without
+   * setting `aria-invalid` on the input.
    */
   export function InputGroup(props: InputGroup.Props) {
-    const { className, invalid, size, variant, vars, ...attributes } = props
+    const { className, invalid, variant, vars, ...attributes } = props
 
     return (
       <BaseUi.Autocomplete.InputGroup
         {...attributes}
-        {...Field.styles.field({ className, size, style: props.style, variant, vars })}
+        {...Field.styles.field({ className, style: props.style, variant, vars })}
         data-invalid={invalid || undefined}
       />
     )

package/src/web/components/Avatar.tsx

@@ -4,21 +4,26 @@ import type * as zyzz from 'zyzz'
 import { variants } from '../zyzz.config.js'
 
 /**
- * A circular `<span>` that shows a person's or entity's image, with a `Fallback` such as initials
- * while the image loads or after it fails. `Avatar` is the same component as `Avatar.Root`.
+ * A circular `<span>` that represents a person, contact, or wallet with initials or an icon in its
+ * `Fallback`. `Avatar` is the same component as `Avatar.Root`.
  *
- * - Give `Avatar.Image` an `alt` with the name, or `alt=""` when the name is already adjacent.
- * - Always include a `Fallback`, since the image does not render until it has loaded.
- * - Pair the avatar with a visible name. Do not rely on the picture alone to identify someone.
+ * - Use initials for people and contacts, and an icon for wallets and apps.
+ * - Pair the avatar with a visible name. Do not rely on initials or an icon alone to identify
+ *   someone.
  *
  * @example
- * <Avatar size="40">
- *   <Avatar.Image alt="Ada Lovelace" src={url} />
+ * <Avatar size="32">
  *   <Avatar.Fallback>AL</Avatar.Fallback>
  * </Avatar>
  *
+ * @example
+ * <Avatar size="40">
+ *   <Avatar.Fallback>
+ *     <Wallet />
+ *   </Avatar.Fallback>
+ * </Avatar>
+ *
  * @see {@link https://base-ui.com/react/components/avatar | Base UI Avatar}
- * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img | MDN img element}
  * @see {@link https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/img_role | MDN img role}
  * @see {@link https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html | WCAG 2.2 Non-text Content}
  */
@@ -30,8 +35,8 @@ export namespace Avatar {
   export type Props = Root.Props
 
   /**
-   * Renders a `<span>` while the image is not loaded, filling the avatar and uppercasing its text.
-   * `delay` postpones it by that many milliseconds, so fast loads skip the fallback flash.
+   * Renders the `<span>` that fills the avatar with initials or an icon, and uppercases its text.
+   * An icon renders at 16px in a `24` or `32` avatar, and at 20px in a `40` avatar.
    */
   export function Fallback(props: Fallback.Props) {
     const { className, vars, ...attributes } = props
@@ -45,57 +50,13 @@ export namespace Avatar {
   }
 
   export namespace Fallback {
-    export type Props = ComponentPropsWithRef<'span'> &
-      zyzz.Props.Variants<typeof styles.fallback> &
-      Pick<BaseUi.Avatar.Fallback.Props, 'delay'>
-  }
-
-  /**
-   * Stacks avatars. Set `overlap` to pull each one over the previous, and `expandOnHover` to spread
-   * an overlapped stack apart on hover and keyboard focus.
-   */
-  export function Group(props: Group.Props) {
-    const { className, expandOnHover, overlap, vars, ...attributes } = props
-
-    return (
-      <div
-        role="group"
-        {...attributes}
-        {...styles.group({ className, expand: expandOnHover, overlap, style: props.style, vars })}
-      />
-    )
-  }
-
-  export namespace Group {
-    export type Props = ComponentPropsWithRef<'div'> &
-      Omit<zyzz.Props.Variants<typeof styles.group>, 'expand'> & {
-        expandOnHover?: boolean | undefined
-      }
+    export type Props = ComponentPropsWithRef<'span'> & zyzz.Props.Variants<typeof styles.fallback>
   }
 
   /**
-   * Renders the `<img>`, cropped to cover the circle. Base UI mounts it only after `src` has
-   * loaded, unless `keepMounted` is set, in which case it stays in the DOM and is `aria-hidden`
-   * until loaded. `onLoadingStatusChange` reports `loading`, `loaded` and `error`.
+   * Renders the circular `<span>`, filled with `container.strong`. `size` sets its diameter in
+   * pixels.
    */
-  export function Image(props: Image.Props) {
-    const { className, vars, ...attributes } = props
-
-    return (
-      <BaseUi.Avatar.Image
-        {...attributes}
-        {...styles.image({ className, style: props.style, vars })}
-      />
-    )
-  }
-
-  export namespace Image {
-    export type Props = ComponentPropsWithRef<'img'> &
-      zyzz.Props.Variants<typeof styles.image> &
-      Pick<BaseUi.Avatar.Image.Props, 'keepMounted' | 'onLoadingStatusChange'>
-  }
-
-  /** Renders the circular `<span>` that clips the image. `size` sets its diameter in pixels. */
   export function Root(props: Root.Props) {
     const { className, size, vars, ...attributes } = props
 
@@ -117,8 +78,7 @@ namespace styles {
     {
       base: {
         alignItems: 'center',
-        backgroundColor: 'grayAlpha.100',
-        color: 'gray.900',
+        color: 'content.secondary',
         display: 'inline-flex',
         font: 'inherit !custom',
         height: '100% !custom',
@@ -130,66 +90,14 @@ namespace styles {
     { id: 'tds/web/avatar/fallback' },
   )
 
-  export const group = variants(
-    {
-      base: { alignItems: 'center', display: 'inline-flex' },
-      compoundVariants: [
-        {
-          when: { expand: true, overlap: true },
-          style: {
-            selectors: {
-              // Margin changes the group's width, which a transform cannot. Transitions retarget from
-              // the current margin, so a brief hover reverses smoothly.
-              '& > * + *': {
-                transitionDuration: '220',
-                transitionProperty: 'margin-inline-start',
-                transitionTimingFunction: 'snappy',
-              },
-              '&:hover > * + *, &:focus-within > * + *': { marginInlineStart: '4' },
-            },
-            '@media (prefers-reduced-motion: reduce)': {
-              selectors: { '& > * + *': { transitionProperty: 'none' } },
-            },
-          },
-        },
-      ],
-      defaultVariants: { expand: false, overlap: false },
-      variants: {
-        expand: { false: {}, true: {} },
-        overlap: {
-          false: { columnGap: '8' },
-          true: {
-            selectors: {
-              '& > * + *': { marginInlineStart: '-8' },
-              '& > *': {
-                outlineColor: 'background.primary',
-                outlineStyle: 'solid !custom',
-                outlineWidth: '2',
-              },
-            },
-          },
-        },
-      },
-    },
-    { id: 'tds/web/avatar/group' },
-  )
-
-  export const image = variants(
-    {
-      base: { display: 'block', height: '100% !custom', objectFit: 'cover', width: '100% !custom' },
-    },
-    { id: 'tds/web/avatar/image' },
-  )
-
   export const root = variants(
     {
       base: {
         alignItems: 'center',
-        backgroundColor: 'background.surface',
-        border: '1px solid !custom',
-        borderColor: 'grayAlpha.200',
+        backgroundColor: 'container.strong',
         borderRadius: 'full',
         boxSizing: 'border-box',
+        cornerShape: 'round',
         display: 'inline-flex',
         flexShrink: '0 !custom',
         overflow: 'hidden',
@@ -197,14 +105,29 @@ namespace styles {
         userSelect: 'none',
         verticalAlign: 'middle',
       },
-      defaultVariants: { size: '48' },
+      defaultVariants: { size: '40' },
       variants: {
+        // Icons size by font size, so an `Identicon`, which sets its own width, keeps filling the
+        // circle.
         size: {
-          '24': { height: '24', typography: 'label.12', width: '24' },
-          '32': { height: '32', typography: 'label.12', width: '32' },
-          '40': { height: '40', typography: 'label.14', width: '40' },
-          '48': { height: '48', typography: 'label.16', width: '48' },
-          '64': { height: '64', typography: 'label.20', width: '64' },
+          '24': {
+            height: '24',
+            typography: 'body.b3Strong',
+            width: '24',
+            selectors: { '& svg': { fontSize: '16' } },
+          },
+          '32': {
+            height: '32',
+            typography: 'body.b3Strong',
+            width: '32',
+            selectors: { '& svg': { fontSize: '16' } },
+          },
+          '40': {
+            height: '40',
+            typography: 'body.b2Strong',
+            width: '40',
+            selectors: { '& svg': { fontSize: '20' } },
+          },
         },
       },
     },

package/src/web/components/Badge.tsx

@@ -0,0 +1,122 @@
+import { useRender } from '@base-ui/react/use-render'
+import type { ComponentPropsWithRef } from 'react'
+import type * as zyzz from 'zyzz'
+import { variants } from '../zyzz.config.js'
+
+/**
+ * A compact label for a status or category, rendered as a `span` at least 80px wide. Pass
+ * `render`, such as `<button type="button" />` or an `a` element, to make it interactive. Those
+ * badges keep the badge look and add pointer, focus-visible and press feedback.
+ *
+ * - Keep the text to a word or two that names a status or attribute, such as Testnet.
+ * - Place it next to a title or row value. Use `inverse` for one recommended option.
+ * - Render a static badge for display. Reach for `render` only when the badge performs an action.
+ *
+ * @example
+ * <Badge size="small" variant="outlined">
+ *   Testnet
+ * </Badge>
+ *
+ * @see {@link https://base-ui.com/react/utils/use-render | Base UI useRender}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/span | MDN span element}
+ * @see {@link https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html | WCAG 2.2 Contrast (Minimum)}
+ */
+export function Badge(props: Badge.Props) {
+  const { className, ref, render, size, variant, vars, ...attributes } = props
+
+  return useRender({
+    defaultTagName: 'span',
+    props: {
+      ...attributes,
+      ...styles.badge({ className, size, style: props.style, variant, vars }),
+    },
+    ref,
+    render,
+  })
+}
+
+export namespace Badge {
+  export type Props = ComponentPropsWithRef<'span'> &
+    zyzz.Props.Variants<typeof styles.badge> & { render?: useRender.RenderProp | undefined }
+}
+
+namespace styles {
+  export const badge = variants(
+    {
+      base: {
+        alignItems: 'center',
+        border: '1px solid !custom',
+        borderColor: 'transparent !custom',
+        borderRadius: '2xs',
+        boxSizing: 'border-box',
+        columnGap: '4',
+        display: 'inline-flex',
+        height: '32',
+        justifyContent: 'center',
+        minWidth: '80',
+        // The 1px border sits inside the padding, so every style keeps Figma's width.
+        paddingInline: 'calc(0.75rem - 1px) !custom',
+        typography: 'body.b2',
+        whiteSpace: 'nowrap',
+        selectors: {
+          '& > svg': { flexShrink: '0 !custom', height: '16', width: '16' },
+          // Button and link badges keep the badge look and add only pointer, focus and press feedback.
+          '&:is(button, a)': {
+            cursor: 'pointer',
+            outlineColor: 'transparent !custom',
+            outlineOffset: '0',
+            outlineStyle: 'solid !custom',
+            outlineWidth: '2',
+            textDecoration: 'none !custom',
+            transitionDuration: '160',
+            transitionProperty: 'opacity, outline-color, outline-offset, scale',
+            transitionTimingFunction: 'snappy',
+          },
+          '&:is(button, a):active': { scale: 'press' },
+          '&:is(button, a):focus-visible': {
+            outlineColor: 'border.focus',
+            outlineOffset: '2',
+          },
+          '&:is(button, a):hover': { opacity: '0.8 !custom' },
+          '&:is(button):disabled': { cursor: 'default', opacity: 'disabled' },
+        },
+        '@media (prefers-reduced-motion: reduce)': {
+          selectors: {
+            '&:is(button, a)': { transitionProperty: 'opacity, outline-color' },
+            '&:is(button, a):active': { scale: 'none !custom' },
+          },
+        },
+      },
+      defaultVariants: { size: 'medium', variant: 'soft' },
+      variants: {
+        size: {
+          medium: {},
+          small: {
+            // Platform has no 6px radius step, so the literal takes the squircle scale of the steps.
+            borderRadius: 'calc(0.375rem * var(--tds-corner-scale, 1)) !custom',
+            height: '28',
+            paddingInline: 'calc(0.5rem - 1px) !custom',
+            typography: 'body.b3',
+            selectors: { '& > svg': { height: '12', width: '12' } },
+          },
+        },
+        variant: {
+          // The accent text follows the inverse content color, which turns black in dark mode.
+          accent: { backgroundColor: 'accent.blue.background', color: 'inverse.content.primary' },
+          elevated: { backgroundColor: 'background.elevated', color: 'content.primary' },
+          inverse: {
+            backgroundColor: 'inverse.background.secondary',
+            color: 'inverse.content.primary',
+          },
+          outlined: {
+            backgroundColor: 'transparent !custom',
+            borderColor: 'line.secondary',
+            color: 'content.primary',
+          },
+          soft: { backgroundColor: 'container.regular', color: 'content.primary' },
+        },
+      },
+    },
+    { id: 'tds/web/badge' },
+  )
+}

package/src/web/components/Banner.tsx

@@ -8,7 +8,7 @@ import { style, variants } from '../zyzz.config.js'
  * A full-width strip for a system or page-wide message, rendered as a plain `div` with no live
  * region. Add `role="status"` or `role="alert"` only when the banner appears after the page loads.
  *
- * - Use it for messages about the whole product or page. Use `Callout` for a note tied to content.
+ * - Use it for messages about the whole product or page. Use `Alert` for a note tied to content.
  * - State severity in the text. `intent` color alone does not reach every reader.
  * - `Dismiss` only renders the button. Remove the banner in its `onClick`.
  *
@@ -97,6 +97,7 @@ namespace styles {
       border: 'none !custom',
       borderRadius: 'full',
       color: 'inherit !custom',
+      cornerShape: 'round',
       cursor: 'pointer',
       display: 'inline-flex',
       flexShrink: '0 !custom',
@@ -114,11 +115,11 @@ namespace styles {
       transitionDuration: '160',
       transitionProperty: 'outline-color, outline-offset, text-decoration-color, scale',
       transitionTimingFunction: 'snappy',
-      typography: 'copy.14.strong',
+      typography: 'body.b2Strong',
       whiteSpace: 'nowrap',
       selectors: {
         '&:active': { scale: 'press' },
-        '&:focus-visible': { outlineColor: 'blue.700', outlineOffset: '2' },
+        '&:focus-visible': { outlineColor: 'border.focus', outlineOffset: '2' },
         '&:hover': { textDecorationColor: 'transparent !custom' },
       },
       '@media (prefers-reduced-motion: reduce)': {
@@ -141,17 +142,17 @@ namespace styles {
         paddingBlock: '8',
         paddingInline: '16',
         position: 'relative',
-        typography: 'copy.14',
+        typography: 'body.b2',
         width: '100% !custom',
       },
       defaultVariants: { intent: 'neutral' },
       variants: {
         intent: {
-          info: { backgroundColor: 'blue.100', color: 'blue.900' },
-          negative: { backgroundColor: 'red.100', color: 'red.900' },
-          neutral: { backgroundColor: 'grayAlpha.100', color: 'foreground' },
-          positive: { backgroundColor: 'green.100', color: 'green.900' },
-          warning: { backgroundColor: 'amber.100', color: 'amber.900' },
+          info: { backgroundColor: 'container.regular', color: 'content.primary' },
+          negative: { backgroundColor: 'container.negative', color: 'content.negative' },
+          neutral: { backgroundColor: 'container.regular', color: 'content.primary' },
+          positive: { backgroundColor: 'container.positive', color: 'content.positive' },
+          warning: { backgroundColor: 'container.warning', color: 'content.warning' },
         },
       },
     },
@@ -170,6 +171,7 @@ namespace styles {
       border: 'none !custom',
       borderRadius: 'full',
       color: 'inherit !custom',
+      cornerShape: 'round',
       cursor: 'pointer',
       display: 'inline-flex',
       flexShrink: '0 !custom',
@@ -191,8 +193,8 @@ namespace styles {
       width: '32',
       selectors: {
         '&:active': { scale: 'press' },
-        '&:focus-visible': { outlineColor: 'blue.700', outlineOffset: '2' },
-        '&:hover': { backgroundColor: 'grayAlpha.200' },
+        '&:focus-visible': { outlineColor: 'border.focus', outlineOffset: '2' },
+        '&:hover': { backgroundColor: 'container.strong' },
       },
       '@media (prefers-reduced-motion: reduce)': {
         transitionProperty: 'background-color, outline-color',