@tempoxyz/ds 0.3.0 → 0.3.2

package/src/web/components/AppShell.tsx

@@ -1,16 +1,22 @@
 import * as BaseUi from '@base-ui/react/drawer'
+import { useRender } from '@base-ui/react/use-render'
 import {
   type ComponentPropsWithRef,
   createContext,
   use,
+  useId,
+  useLayoutEffect,
   useState,
   useSyncExternalStore,
 } from 'react'
 import type * as zyzz from 'zyzz'
 import { keyframes } from 'zyzz/web'
 import { style, variants, vars } from '../zyzz.config.js'
+import * as TabBar from './internal/TabBar.js'
+import * as Text from './internal/Text.js'
 
 type Context = {
+  collapse: boolean
   container: HTMLDivElement | null
   handle: BaseUi.Drawer.Handle<unknown>
   open: boolean
@@ -19,21 +25,25 @@ type Context = {
 
 const context = createContext<Context | undefined>(undefined)
 
-const compactQuery = '(max-width: 1023px)'
-
-// The viewport breakpoint is a literal because media queries cannot read CSS variables.
-function useCompact() {
+/** Reads a media query, and `false` on the server and during hydration. */
+function useQuery(query: string) {
   return useSyncExternalStore(
     (notify) => {
-      const query = window.matchMedia(compactQuery)
-      query.addEventListener('change', notify)
-      return () => query.removeEventListener('change', notify)
+      const list = window.matchMedia(query)
+      list.addEventListener('change', notify)
+      return () => list.removeEventListener('change', notify)
     },
-    () => window.matchMedia(compactQuery).matches,
+    () => window.matchMedia(query).matches,
     () => false,
   )
 }
 
+// The sidebar opens as a drawer below 1024px, or below 768px when it collapses to its icons from
+// 768px to 1023px. The breakpoints are literals because media queries cannot read CSS variables.
+function useCompact(collapse: boolean) {
+  return useQuery(collapse ? '(max-width: 767px)' : '(max-width: 1023px)')
+}
+
 function useShell() {
   const value = use(context)
   if (!value) throw new Error('AppShell parts must render inside AppShell.Root')
@@ -112,7 +122,9 @@ export namespace AppShell {
   export function Root(props: Root.Props) {
     const {
       align,
+      children,
       className,
+      collapse = false,
       defaultOpen = false,
       onOpenChange,
       open,
@@ -121,6 +133,7 @@ export namespace AppShell {
       ...attributes
     } = props
     const [handle] = useState(() => BaseUi.Drawer.createHandle<unknown>())
+    const [tabBar] = useState(TabBar.create)
     const [uncontrolled, setUncontrolled] = useState(defaultOpen)
     const [container, setContainer] = useState<HTMLDivElement | null>(null)
     const current = open ?? uncontrolled
@@ -128,6 +141,7 @@ export namespace AppShell {
     return (
       <context.Provider
         value={{
+          collapse,
           container,
           handle,
           open: current,
@@ -140,13 +154,19 @@ export namespace AppShell {
         <div
           {...attributes}
           {...styles.root({ align, className, style: props.style, vars })}
+          data-app-shell-collapse={collapse ? '' : undefined}
           data-state={current ? 'open' : 'closed'}
           ref={(node) => {
             setContainer(node)
             if (typeof ref === 'function') ref(node)
             else if (ref) ref.current = node
           }}
-        />
+        >
+          <TabBar.Context.Provider value={tabBar}>
+            {children}
+            <BottomBar />
+          </TabBar.Context.Provider>
+        </div>
       </context.Provider>
     )
   }
@@ -154,6 +174,14 @@ export namespace AppShell {
   export namespace Root {
     export type Props = ComponentPropsWithRef<'div'> &
       zyzz.Props.Variants<typeof styles.root> & {
+        /**
+         * Collapses the inline sidebar to a 64px column of icons from 768px to 1023px, and opens
+         * the drawer only below 768px. Give every `SidebarMenu.Item` an icon as its first child.
+         * Absent, the sidebar opens as a drawer below 1024px.
+         * @default false
+         */
+        collapse?: boolean | undefined
+
         /**
          * Initial drawer state when `open` is uncontrolled.
          * @default false
@@ -177,10 +205,18 @@ export namespace AppShell {
   export function Sidebar(props: Sidebar.Props) {
     const { className, vars, ...attributes } = props
     const shell = useShell()
-    const compact = useCompact()
+    const compact = useCompact(shell.collapse)
     const sidebar = styles.sidebar({ className, style: props.style, vars })
 
-    if (!compact) return <aside {...attributes} {...styles.inline(sidebar)} />
+    if (!compact)
+      return (
+        <aside
+          {...attributes}
+          {...styles.inline(sidebar)}
+          data-app-shell-rail={shell.collapse ? '' : undefined}
+          data-app-shell-sidebar="inline"
+        />
+      )
 
     return (
       <BaseUi.Drawer.Root
@@ -189,7 +225,8 @@ export namespace AppShell {
         open={shell.open}
         swipeDirection="right"
       >
-        <BaseUi.Drawer.Portal container={shell.container}>
+        {/* The closed drawer stays mounted, so its items register in the bottom bar. */}
+        <BaseUi.Drawer.Portal container={shell.container} keepMounted>
           <BaseUi.Drawer.Backdrop {...styles.backdrop()} />
           <BaseUi.Drawer.Viewport {...styles.viewport()}>
             <BaseUi.Drawer.Popup
@@ -262,25 +299,49 @@ export namespace AppShell {
    * Toggles the sidebar drawer from a button fixed to the top-right corner, above the drawer, whose
    * two bars turn into a close mark while it is open. Hidden from 1024px, where the sidebar is
    * always visible. It is named `Open menu` or `Close menu` and exposes `aria-expanded`. Pass
-   * `aria-label` to replace the name, or `children` to replace the bars.
+   * `aria-label` to replace the name, or `children` to replace the bars. With `tabBar`, the bottom
+   * bar renders it as its floating action button below 768px instead of the top-right button.
+   *
+   * @example
+   * <AppShell.Trigger tabBar />
    */
   export function Trigger(props: Trigger.Props) {
-    const { children, className, vars, ...attributes } = props
+    const { children, className, ref, tabBar = false, vars, ...attributes } = props
     const shell = useShell()
+    const store = use(TabBar.Context)
+    const id = useId()
+    // The bottom bar shows below 768px, so the ref follows whichever of the two buttons shows.
+    const bar = useQuery('(max-width: 767px)') && tabBar
+
+    // Registers on every render, so the bottom bar repeats the current props of the trigger.
+    useLayoutEffect(() => {
+      if (!store) return
+      if (!tabBar) return store.delete(id)
+
+      const { style: _, ...rest } = attributes
+      store.set(id, {
+        active: false,
+        attributes: { ...rest, ref: bar ? ref : undefined },
+        children,
+        variant: 'menu',
+      })
+    })
+
+    useLayoutEffect(() => {
+      if (!store) return
+      return () => store.delete(id)
+    }, [id, store])
 
     return (
       <BaseUi.Drawer.Trigger
         aria-label={shell.open ? 'Close menu' : 'Open menu'}
         {...attributes}
         {...styles.trigger({ className, style: props.style, vars })}
+        data-app-shell-tab-bar={tabBar ? '' : undefined}
         handle={shell.handle}
+        ref={bar ? undefined : ref}
       >
-        {children ?? (
-          <span aria-hidden="true" {...styles.bars()}>
-            <span {...styles.bar()} />
-            <span {...styles.bar()} />
-          </span>
-        )}
+        {children ?? <Bars />}
       </BaseUi.Drawer.Trigger>
     )
   }
@@ -288,10 +349,101 @@ export namespace AppShell {
   export namespace Trigger {
     export type Props = ComponentPropsWithRef<'button'> &
       zyzz.Props.Variants<typeof styles.trigger> &
-      Pick<BaseUi.Drawer.Trigger.Props, 'nativeButton' | 'render'>
+      Pick<BaseUi.Drawer.Trigger.Props, 'nativeButton' | 'render'> & {
+        /**
+         * Renders the trigger as the floating action button of the bottom bar below 768px, after
+         * the `action` items, in place of the top-right button. While the drawer is open, the
+         * button stays above it as a close mark, and the other items of the bar fade out.
+         */
+        tabBar?: boolean | undefined
+      }
   }
 }
 
+/** The two bars of a trigger, which cross into a close mark while the drawer is open. */
+function Bars() {
+  return (
+    <span aria-hidden="true" {...styles.bars()}>
+      <span {...styles.bar()} />
+      <span {...styles.bar()} />
+    </span>
+  )
+}
+
+/**
+ * Repeats the `SidebarMenu.Item`s that set `tabBar` in a bar fixed to the bottom edge below 768px:
+ * `tab` items as icons in a pill `<nav>`, then each `action` item as a floating action button, then
+ * the `AppShell.Trigger` that sets `tabBar`. Renders nothing while nothing registers.
+ */
+function BottomBar() {
+  const store = use(TabBar.Context)!
+  const entries = useSyncExternalStore(store.subscribe, store.snapshot, store.snapshot)
+  const tabs = entries.filter(([, entry]) => entry.variant === 'tab')
+  const actions = entries.filter(([, entry]) => entry.variant === 'action')
+  const menus = entries.filter(([, entry]) => entry.variant === 'menu')
+
+  if (entries.length === 0) return null
+
+  return (
+    <div
+      {...styles.bottomBar()}
+      data-app-shell-bottom-bar=""
+      data-app-shell-menu={menus.length > 0 ? '' : undefined}
+    >
+      {tabs.length > 0 && (
+        <nav aria-label="Main" {...styles.tabBar()}>
+          {tabs.map(([id, entry]) => (
+            <BottomBarItem entry={entry} key={id} />
+          ))}
+        </nav>
+      )}
+      {actions.map(([id, entry]) => (
+        <BottomBarItem entry={entry} key={id} />
+      ))}
+      {menus.map(([id, entry]) => (
+        <BottomBarTrigger entry={entry} key={id} />
+      ))}
+    </div>
+  )
+}
+
+/**
+ * Renders the element of a `SidebarMenu.Item` with the attributes and `render` of the item, and
+ * shows only its first element, such as its icon. Its text stays in the accessible name.
+ */
+function BottomBarItem(props: { entry: TabBar.Entry }) {
+  const { entry } = props
+
+  return useRender({
+    defaultTagName: 'a',
+    props: {
+      ...entry.attributes,
+      'aria-current': entry.active ? 'page' : undefined,
+      ...(entry.variant === 'tab' ? styles.tab({ active: entry.active }) : styles.action()),
+      children: Text.wrap(entry.children, styles.label()),
+    },
+    render: entry.render,
+  })
+}
+
+/** Renders the `AppShell.Trigger` that sets `tabBar` as a floating action button. */
+function BottomBarTrigger(props: { entry: TabBar.Entry }) {
+  const { entry } = props
+  const shell = useShell()
+
+  return (
+    <BaseUi.Drawer.Trigger
+      aria-label={shell.open ? 'Close menu' : 'Open menu'}
+      {...(entry.attributes as BaseUi.Drawer.Trigger.Props)}
+      {...styles.action()}
+      data-app-shell-menu-trigger=""
+      handle={shell.handle}
+    >
+      {entry.children ?? <Bars />}
+    </BaseUi.Drawer.Trigger>
+  )
+}
+
 const fadeIn = keyframes(
   { from: { opacity: 0 }, to: { opacity: 1 } },
   { id: 'tds/web/app-shell/fade-in' },
@@ -303,6 +455,54 @@ const fadeOut = keyframes(
 )
 
 namespace styles {
+  // The 56px circle of the Platform Floating Action Button.
+  export const action = style(
+    {
+      alignItems: 'center',
+      backgroundColor: 'inverse.background.secondary',
+      borderRadius: 'full',
+      boxShadow: 'large',
+      boxSizing: 'border-box',
+      color: 'inverse.content.primary',
+      cornerShape: 'round',
+      cursor: 'pointer',
+      display: 'flex',
+      flexShrink: '0 !custom',
+      height: '56',
+      justifyContent: 'center',
+      outlineColor: 'transparent !custom',
+      outlineOffset: '0',
+      outlineStyle: 'solid !custom',
+      outlineWidth: '2',
+      position: 'relative',
+      textDecoration: 'none !custom',
+      transitionDuration: '160',
+      transitionProperty: 'opacity, outline-color, scale !custom',
+      transitionTimingFunction: 'snappy',
+      width: '56',
+      selectors: {
+        '& > :first-child': { flexShrink: '0 !custom', fontSize: '24' },
+        '& > :not(:first-child)': {
+          clipPath: 'inset(50%) !custom',
+          height: '1px !custom',
+          overflow: 'hidden',
+          position: 'absolute',
+          whiteSpace: 'nowrap',
+          width: '1px !custom',
+        },
+        '&:active': { scale: 'press', transitionDuration: '100' },
+        '&:focus-visible': { outlineColor: 'border.focus' },
+        // The design dims the button to 88% under the pointer, which no opacity token sets.
+        '&:hover': { opacity: '0.88 !custom' },
+      },
+      '@media (prefers-reduced-motion: reduce)': {
+        transitionProperty: 'opacity, outline-color !custom',
+        selectors: { '&:active': { scale: 'none !custom' } },
+      },
+    },
+    { id: 'tds/web/app-shell/action' },
+  )
+
   export const backdrop = style(
     {
       backgroundColor: 'neutral.100',
@@ -350,6 +550,31 @@ namespace styles {
     { id: 'tds/web/app-shell/bar' },
   )
 
+  // Floats over the content, inset by the 24px page margin of the Mobile layout and 16px from the
+  // bottom edge. It sits below the drawer and its backdrop.
+  export const bottomBar = style(
+    {
+      alignItems: 'center',
+      bottom: 'calc(1rem + env(safe-area-inset-bottom)) !custom',
+      columnGap: '12',
+      display: 'none',
+      insetInline: '24',
+      position: 'fixed',
+      zIndex: '39 !custom',
+      selectors: {
+        // A bar that holds the trigger rises above the open drawer, so the trigger closes it. The
+        // other items fade out and leave the drawer uncovered.
+        '[data-state="open"] > &[data-app-shell-menu]': { zIndex: 'modal' },
+        '[data-state="open"] > &[data-app-shell-menu] > :not([data-app-shell-menu-trigger])': {
+          opacity: '0 !custom',
+          pointerEvents: 'none',
+        },
+      },
+      '@media (max-width: 767px)': { display: 'flex' },
+    },
+    { id: 'tds/web/app-shell/bottom-bar' },
+  )
+
   export const bars = style(
     { display: 'block', height: '16', position: 'relative', width: '16' },
     { id: 'tds/web/app-shell/bars' },
@@ -375,6 +600,14 @@ namespace styles {
         },
         '&[data-starting-style]': { transform: 'translateX(100%) !custom' },
         '&[data-swiping]': { transitionDuration: '0', userSelect: 'none' },
+        // The trigger in the bottom bar stays above the open drawer, so the drawer ends 16px above
+        // it, and its footer stays uncovered.
+        '[data-state]:has(> [data-app-shell-bottom-bar][data-app-shell-menu]) &': {
+          paddingBlockEnd: 'calc(5.5rem + env(safe-area-inset-bottom)) !custom',
+        },
+        // The closed drawer stays mounted with the `hidden` attribute, which the flex layout of
+        // the sidebar would override.
+        '&[hidden]': { display: 'none !custom' },
       },
       '@media (prefers-reduced-motion: reduce)': {
         transitionProperty: 'opacity !custom',
@@ -411,8 +644,11 @@ namespace styles {
         paddingInline: '16',
         '@media (min-width: 640px)': { marginInline: '-2rem !custom', paddingInline: '24' },
         // Below 1024px the fixed trigger covers the end of the bar, so header actions end 8px
-        // before it: its 40px plus its 16px inset.
+        // before it: its 40px plus its 16px inset. A collapsed sidebar hides it from 768px.
         '@media (max-width: 1023px)': { paddingInlineEnd: '64' },
+        '@media (min-width: 768px) and (max-width: 1023px)': {
+          selectors: { '[data-app-shell-collapse] > main > &': { paddingInlineEnd: '24' } },
+        },
       },
     },
     { id: 'tds/web/app-shell/header' },
@@ -454,6 +690,15 @@ namespace styles {
         '@media (max-width: 1023px)': {
           selectors: { '&::after, &::before': { display: 'none !custom' } },
         },
+        // The bottom bar covers the end of the page, so content can scroll clear of it: 16px
+        // below the bar, its 56px, and 16px above it.
+        '@media (max-width: 767px)': {
+          selectors: {
+            '&:has(> [data-app-shell-bottom-bar]) > main': {
+              paddingBottom: 'calc(5.5rem + env(safe-area-inset-bottom)) !custom',
+            },
+          },
+        },
       },
       defaultVariants: { align: 'center' },
       variants: {
@@ -504,6 +749,19 @@ namespace styles {
     { id: 'tds/web/app-shell/sidebar' },
   )
 
+  // Keeps the label of a bottom bar item in its accessible name without painting it.
+  export const label = style(
+    {
+      clipPath: 'inset(50%) !custom',
+      height: '1px !custom',
+      overflow: 'hidden',
+      position: 'absolute',
+      whiteSpace: 'nowrap',
+      width: '1px !custom',
+    },
+    { id: 'tds/web/app-shell/label' },
+  )
+
   // Follows `sidebar`, so its compact `display: none` overrides the sidebar's `display: flex` in
   // server-rendered markup, which always emits the wide layout.
   export const inline = style(
@@ -517,6 +775,12 @@ namespace styles {
       position: 'sticky',
       width: 'var(--sidebar-width, 16rem) !custom',
       '@media (max-width: 1023px)': { display: 'none !custom' },
+      // A collapsed sidebar stays inline as a column of icons, which `SidebarMenu` centers.
+      '@media (min-width: 768px) and (max-width: 1023px)': {
+        selectors: {
+          '&[data-app-shell-rail]': { display: 'flex !custom', width: '4rem !custom' },
+        },
+      },
     },
     { id: 'tds/web/app-shell/inline' },
   )
@@ -538,6 +802,15 @@ namespace styles {
         // Classic scrollbars keep their own lane instead of covering content at the edge.
         scrollbarGutter: 'stable',
         scrollbarWidth: 'thin',
+        // The collapsed sidebar has no room for a scrollbar lane beside its 40px icons.
+        '@media (min-width: 768px) and (max-width: 1023px)': {
+          selectors: {
+            '[data-app-shell-rail] &': {
+              scrollbarGutter: 'auto !custom',
+              scrollbarWidth: 'none !custom',
+            },
+          },
+        },
         selectors: {
           // Curtains fade content into the sidebar at whichever end has more to scroll.
           '&::after, &::before': {
@@ -598,6 +871,86 @@ namespace styles {
     { id: 'tds/web/app-shell/sidebar-header' },
   )
 
+  // An icon-only item of the Platform Tab Bar, which fills its share of the pill.
+  export const tab = variants(
+    {
+      base: {
+        alignItems: 'center',
+        borderRadius: 'full',
+        boxSizing: 'border-box',
+        color: 'content.secondary',
+        cornerShape: 'round',
+        cursor: 'pointer',
+        display: 'flex',
+        flex: '1 !custom',
+        height: '100% !custom',
+        justifyContent: 'center',
+        minWidth: '0',
+        outlineColor: 'transparent !custom',
+        outlineOffset: '-2',
+        outlineStyle: 'solid !custom',
+        outlineWidth: '2',
+        position: 'relative',
+        textDecoration: 'none !custom',
+        transitionDuration: '160',
+        transitionProperty: 'background-color, color, outline-color, scale !custom',
+        transitionTimingFunction: 'snappy',
+        selectors: {
+          '& > :first-child': { flexShrink: '0 !custom', fontSize: '24' },
+          '& > :not(:first-child)': {
+            clipPath: 'inset(50%) !custom',
+            height: '1px !custom',
+            overflow: 'hidden',
+            position: 'absolute',
+            whiteSpace: 'nowrap',
+            width: '1px !custom',
+          },
+          '&:active': { scale: 'press', transitionDuration: '100' },
+          '&:focus-visible': { outlineColor: 'border.focus' },
+          '&:hover': { color: 'content.primary' },
+        },
+        '@media (prefers-reduced-motion: reduce)': {
+          transitionProperty: 'background-color, color, outline-color !custom',
+          selectors: { '&:active': { scale: 'none !custom' } },
+        },
+      },
+      defaultVariants: { active: false },
+      variants: {
+        active: {
+          false: {},
+          true: { backgroundColor: 'container.strong', color: 'content.primary' },
+        },
+      },
+    },
+    { id: 'tds/web/app-shell/tab' },
+  )
+
+  // The 56px pill of the Platform Tab Bar, which takes the width beside the action button. Its 48px
+  // items sit 4px inside the 1px border at either end and 3px inside it at the top and bottom.
+  export const tabBar = style(
+    {
+      alignItems: 'center',
+      backgroundColor: 'background.elevated',
+      borderColor: 'line.secondary',
+      borderRadius: 'full',
+      borderStyle: 'solid',
+      borderWidth: 'regular',
+      boxShadow: 'regular',
+      boxSizing: 'border-box',
+      cornerShape: 'round',
+      display: 'flex',
+      flex: '1 !custom',
+      height: '56',
+      minWidth: '0',
+      paddingBlock: '3',
+      paddingInline: '4',
+      transitionDuration: '200',
+      transitionProperty: 'opacity !custom',
+      transitionTimingFunction: 'snappy',
+    },
+    { id: 'tds/web/app-shell/tab-bar' },
+  )
+
   export const title = variants(
     {
       base: {
@@ -654,6 +1007,13 @@ namespace styles {
           },
         },
         '@media (min-width: 1024px)': { display: 'none !custom' },
+        '@media (min-width: 768px) and (max-width: 1023px)': {
+          selectors: { '[data-app-shell-collapse] &': { display: 'none !custom' } },
+        },
+        // The bottom bar renders this trigger as its floating action button.
+        '@media (max-width: 767px)': {
+          selectors: { '&[data-app-shell-tab-bar]': { display: 'none !custom' } },
+        },
         '@media (prefers-reduced-motion: reduce)': {
           transitionProperty: 'background-color, outline-color, outline-offset !custom',
           selectors: { '&:active': { transform: 'none !custom' } },
@@ -670,6 +1030,7 @@ namespace styles {
       justifyContent: 'flex-end',
       position: 'fixed',
       zIndex: 'popover',
+      selectors: { '&[hidden]': { display: 'none !custom' } },
     },
     { id: 'tds/web/app-shell/viewport' },
   )

package/src/web/components/AssetChip.tsx

@@ -96,7 +96,10 @@ namespace styles {
         '&:is(button):not([data-selected], :disabled):hover': {
           backgroundColor: 'container.strong',
         },
-        '&[data-selected]': { backgroundColor: 'content.primary', color: 'background.elevated' },
+        '&[data-selected]': {
+          backgroundColor: 'inverse.background.primary',
+          color: 'inverse.content.primary',
+        },
         // An inside ring would vanish into the selected fill, so a selected chip draws it outside.
         '&[data-selected]:focus-visible': { outlineOffset: '2' },
       },