@dxos/react-ui-tabs 0.8.3 → 0.8.4-main.1068cf700f

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "@dxos/react-ui-tabs",
-  "version": "0.8.3",
+  "version": "0.8.4-main.1068cf700f",
   "description": "Components for facilitating a Tabs pattern.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dxos/dxos"
+  },
   "license": "MIT",
   "author": "DXOS.org",
-  "sideEffects": true,
+  "sideEffects": false,
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
       "browser": "./dist/lib/browser/index.mjs",
       "node": "./dist/lib/node-esm/index.mjs"
@@ -24,33 +29,32 @@
     "src"
   ],
   "dependencies": {
-    "@fluentui/react-tabster": "^9.24.2",
-    "@preact-signals/safe-react": "^0.9.0",
+    "@fluentui/react-tabster": "9.26.11",
     "@radix-ui/primitive": "1.1.1",
     "@radix-ui/react-context": "1.1.1",
     "@radix-ui/react-primitive": "2.0.2",
     "@radix-ui/react-slot": "1.1.2",
     "@radix-ui/react-tabs": "1.1.3",
     "@radix-ui/react-use-controllable-state": "1.1.0",
-    "@dxos/react-ui-attention": "0.8.3",
-    "@dxos/util": "0.8.3"
+    "@dxos/react-ui-attention": "0.8.4-main.1068cf700f",
+    "@dxos/util": "0.8.4-main.1068cf700f"
   },
   "devDependencies": {
-    "@types/react": "~18.2.0",
-    "@types/react-dom": "~18.2.0",
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "vite": "5.4.7",
-    "@dxos/random": "0.8.3",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/react-ui-theme": "0.8.3",
-    "@dxos/storybook-utils": "0.8.3"
+    "@types/react": "~19.2.7",
+    "@types/react-dom": "~19.2.3",
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "vite": "7.1.9",
+    "@dxos/storybook-utils": "0.8.4-main.1068cf700f",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f",
+    "@dxos/random": "0.8.4-main.1068cf700f"
   },
   "peerDependencies": {
-    "react": "~18.2.0",
-    "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.3",
-    "@dxos/react-ui-theme": "0.8.3"
+    "react": "~19.2.3",
+    "react-dom": "~19.2.3",
+    "@dxos/ui-theme": "0.8.4-main.1068cf700f",
+    "@dxos/react-ui": "0.8.4-main.1068cf700f"
   },
   "publishConfig": {
     "access": "public"

package/src/Tabs.stories.tsx

@@ -2,16 +2,52 @@
 // Copyright 2024 DXOS.org
 //
 
+import { type Meta, type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 
 import { faker } from '@dxos/random';
 import { Dialog, Icon } from '@dxos/react-ui';
-import { withTheme } from '@dxos/storybook-utils';
+import { withTheme } from '@dxos/react-ui/testing';
 
 import { Tabs as NaturalTabs } from './Tabs';
 
 faker.seed(1234);
 
+export const DefaultStory = () => {
+  return (
+    <Dialog.Root open>
+      <Dialog.Overlay blockAlign='start'>
+        <Dialog.Content size='xl'>
+          <NaturalTabs.Root orientation='vertical' defaultValue={Object.keys(content)[3]} defaultActivePart='list'>
+            <NaturalTabs.Viewport>
+              <NaturalTabs.Tablist>
+                {Object.entries(content).map(([id, { title }]) => {
+                  return (
+                    <NaturalTabs.Tab key={id} value={id}>
+                      {title}
+                    </NaturalTabs.Tab>
+                  );
+                })}
+              </NaturalTabs.Tablist>
+              {Object.entries(content).map(([id, { panel }]) => {
+                return (
+                  <NaturalTabs.Tabpanel key={id} value={id} classNames='m-1'>
+                    <NaturalTabs.BackButton density='fine'>
+                      <Icon icon='ph--arrow-left--bold' size={4} />
+                      <span>Back to tab list</span>
+                    </NaturalTabs.BackButton>
+                    <p className='pli-1'>{panel}</p>
+                  </NaturalTabs.Tabpanel>
+                );
+              })}
+            </NaturalTabs.Viewport>
+          </NaturalTabs.Root>
+        </Dialog.Content>
+      </Dialog.Overlay>
+    </Dialog.Root>
+  );
+};
+
 const content = [...Array(24)].reduce((acc: { [key: string]: { title: string; panel: string } }, _, index) => {
   acc[`t${index}`] = {
     title: faker.commerce.productName(),
@@ -20,46 +56,15 @@ const content = [...Array(24)].reduce((acc: { [key: string]: { title: string; pa
   return acc;
 }, {});
 
-export default {
+const meta = {
   title: 'ui/react-ui-tabs/Tabs',
   component: NaturalTabs.Root,
-  decorators: [withTheme],
-  // parameters: { translations },
-};
+  render: DefaultStory,
+  decorators: [withTheme()],
+} satisfies Meta<typeof DefaultStory>;
 
-export const Tabs = {
-  render: () => {
-    return (
-      <Dialog.Root open>
-        <Dialog.Overlay blockAlign='start'>
-          <Dialog.Content classNames='is-[calc(100dvw-4rem)] !max-is-full'>
-            <NaturalTabs.Root orientation='vertical' defaultValue={Object.keys(content)[3]} defaultActivePart='list'>
-              <NaturalTabs.Viewport>
-                <NaturalTabs.Tablist>
-                  {Object.entries(content).map(([id, { title }]) => {
-                    return (
-                      <NaturalTabs.Tab key={id} value={id}>
-                        {title}
-                      </NaturalTabs.Tab>
-                    );
-                  })}
-                </NaturalTabs.Tablist>
-                {Object.entries(content).map(([id, { panel }]) => {
-                  return (
-                    <NaturalTabs.Tabpanel key={id} value={id} classNames='m-1'>
-                      <NaturalTabs.BackButton density='fine'>
-                        <Icon icon='ph--arrow-left--bold' size={4} />
-                        <span>Back to tab list</span>
-                      </NaturalTabs.BackButton>
-                      <p className='pli-1'>{panel}</p>
-                    </NaturalTabs.Tabpanel>
-                  );
-                })}
-              </NaturalTabs.Viewport>
-            </NaturalTabs.Root>
-          </Dialog.Content>
-        </Dialog.Overlay>
-      </Dialog.Root>
-    );
-  },
-};
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};

package/src/Tabs.tsx

@@ -2,15 +2,29 @@
 // Copyright 2024 DXOS.org
 //
 
-import { useFocusFinders, useArrowNavigationGroup, useFocusableGroup } from '@fluentui/react-tabster';
+import { useArrowNavigationGroup, useFocusFinders, useFocusableGroup } from '@fluentui/react-tabster';
 import { createContext } from '@radix-ui/react-context';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
 import { useControllableState } from '@radix-ui/react-use-controllable-state';
-import React, { type ComponentPropsWithoutRef, type MouseEvent, useCallback, useLayoutEffect, useRef } from 'react';
+import React, {
+  Activity,
+  type ComponentPropsWithoutRef,
+  type MouseEvent,
+  forwardRef,
+  useCallback,
+  useLayoutEffect,
+} from 'react';
 
-import { Button, type ButtonProps, type ThemedClassName } from '@dxos/react-ui';
+import {
+  Button,
+  type ButtonProps,
+  IconButton,
+  type IconButtonProps,
+  type ThemedClassName,
+  useForwardedRef,
+} from '@dxos/react-ui';
 import { useAttention } from '@dxos/react-ui-attention';
-import { ghostHover, ghostSelectedContainerMd, mx } from '@dxos/react-ui-theme';
+import { ghostSelectedContainerMd, mx } from '@dxos/ui-theme';
 
 type TabsActivePart = 'list' | 'panel';
 
@@ -36,83 +50,90 @@ type TabsRootProps = ThemedClassName<TabsPrimitive.TabsProps> &
     defaultActivePart: TabsActivePart;
   }>;
 
-const TabsRoot = ({
-  children,
-  classNames,
-  activePart: propsActivePart,
-  onActivePartChange,
-  defaultActivePart,
-  value: propsValue,
-  onValueChange,
-  defaultValue,
-  orientation = 'vertical',
-  activationMode = 'manual',
-  verticalVariant = 'stateful',
-  attendableId,
-  ...props
-}: TabsRootProps) => {
-  // TODO(thure): Without these, we get Groupper/Mover `API used before initialization`, but why?
-  const _1 = useArrowNavigationGroup();
-  const _2 = useFocusableGroup();
-  const [activePart = 'list', setActivePart] = useControllableState({
-    prop: propsActivePart,
-    onChange: onActivePartChange,
-    defaultProp: defaultActivePart,
-  });
-
-  const [value, setValue] = useControllableState({
-    prop: propsValue,
-    onChange: onValueChange,
-    defaultProp: defaultValue,
-  });
-
-  const handleValueChange = useCallback(
-    (nextValue: string) => {
-      setActivePart('panel');
-      setValue(nextValue);
+const TabsRoot = forwardRef<HTMLDivElement, TabsRootProps>(
+  (
+    {
+      children,
+      classNames,
+      activePart: propsActivePart,
+      onActivePartChange,
+      defaultActivePart,
+      value: propsValue,
+      onValueChange,
+      defaultValue,
+      orientation = 'vertical',
+      activationMode = 'manual',
+      verticalVariant = 'stateful',
+      attendableId,
+      ...props
     },
-    [value],
-  );
+    forwardedRef,
+  ) => {
+    // const tabsRoot = useRef<HTMLDivElement | null>(null);
+    const tabsRoot = useForwardedRef(forwardedRef);
 
-  const { findFirstFocusable } = useFocusFinders();
-  const tabsRoot = useRef<HTMLDivElement | null>(null);
+    // TODO(thure): Without these, we get Groupper/Mover `API used before initialization`, but why?
+    const _1 = useArrowNavigationGroup();
+    const _2 = useFocusableGroup();
+    const [activePart = 'list', setActivePart] = useControllableState({
+      prop: propsActivePart,
+      onChange: onActivePartChange,
+      defaultProp: defaultActivePart,
+    });
 
-  useLayoutEffect(() => {
-    if (tabsRoot.current) {
-      findFirstFocusable(tabsRoot.current)?.focus();
-    }
-  }, [activePart]);
+    const [value, setValue] = useControllableState({
+      prop: propsValue,
+      onChange: onValueChange,
+      defaultProp: defaultValue,
+    });
 
-  return (
-    <TabsContextProvider
-      orientation={orientation}
-      activePart={activePart}
-      setActivePart={setActivePart}
-      value={value}
-      attendableId={attendableId}
-      verticalVariant={verticalVariant}
-    >
-      <TabsPrimitive.Root
-        activationMode={activationMode}
-        data-active={activePart}
+    const handleValueChange = useCallback(
+      (nextValue: string) => {
+        setActivePart('panel');
+        setValue(nextValue);
+      },
+      [value],
+    );
+
+    const { findFirstFocusable } = useFocusFinders();
+
+    useLayoutEffect(() => {
+      if (tabsRoot.current) {
+        findFirstFocusable(tabsRoot.current)?.focus();
+      }
+    }, [activePart]);
+
+    return (
+      <TabsContextProvider
         orientation={orientation}
-        {...props}
+        activePart={activePart}
+        setActivePart={setActivePart}
         value={value}
-        onValueChange={handleValueChange}
-        className={mx(
-          'overflow-hidden',
-          orientation === 'vertical' &&
-            verticalVariant === 'stateful' &&
-            '[&[data-active=list]_[role=tabpanel]]:invisible @md:[&[data-active=list]_[role=tabpanel]]:visible',
-          classNames,
-        )}
-        ref={tabsRoot}
+        attendableId={attendableId}
+        verticalVariant={verticalVariant}
       >
-        {children}
-      </TabsPrimitive.Root>
-    </TabsContextProvider>
-  );
-};
+        <TabsPrimitive.Root
+          activationMode={activationMode}
+          data-active={activePart}
+          orientation={orientation}
+          {...props}
+          value={value}
+          onValueChange={handleValueChange}
+          className={mx(
+            'overflow-hidden',
+            orientation === 'vertical' &&
+              verticalVariant === 'stateful' &&
+              '[&[data-active=list]_[role=tabpanel]]:invisible @md:[&[data-active=list]_[role=tabpanel]]:visible',
+            classNames,
+          )}
+          ref={tabsRoot}
+        >
+          {children}
+        </TabsPrimitive.Root>
+      </TabsContextProvider>
+    );
+  },
+);
 
 type TabsViewportProps = ThemedClassName<ComponentPropsWithoutRef<'div'>>;
 
@@ -144,6 +165,7 @@ const TabsTablist = ({ children, classNames, ...props }: TabsTablistProps) => {
   return (
     <TabsPrimitive.List
       {...props}
+      data-arrow-keys={orientation === 'vertical' ? 'up down' : 'left right'}
       className={mx(
         'max-bs-full is-full',
         // NOTE: Padding should be common to Toolbar.
@@ -185,6 +207,7 @@ type TabsTabProps = ButtonProps & Pick<TabsPrimitive.TabsTriggerProps, 'value'>;
 const TabsTab = ({ value, classNames, children, onClick, ...props }: TabsTabProps) => {
   const { setActivePart, orientation, value: contextValue, attendableId } = useTabsContext('TabsTab');
   const { hasAttention } = useAttention(attendableId);
+
   const handleClick = useCallback(
     // NOTE: This handler is only called if the tab is *already active*.
     (event: MouseEvent<HTMLButtonElement>) => {
@@ -204,10 +227,8 @@ const TabsTab = ({ value, classNames, children, onClick, ...props }: TabsTabProp
         {...props}
         onClick={handleClick}
         classNames={[
-          'pli-2 rounded-sm',
           orientation === 'vertical' && 'block justify-start text-start is-full',
           orientation === 'vertical' && ghostSelectedContainerMd,
-          ghostHover,
           classNames,
         ]}
       >
@@ -217,13 +238,50 @@ const TabsTab = ({ value, classNames, children, onClick, ...props }: TabsTabProp
   );
 };
 
+type TabsIconTabProps = IconButtonProps & Pick<TabsPrimitive.TabsTriggerProps, 'value'>;
+
+const TabsIconTab = ({ value, classNames, onClick, ...props }: TabsIconTabProps) => {
+  const { setActivePart, orientation, value: contextValue, attendableId } = useTabsContext('TabsTab');
+  const { hasAttention } = useAttention(attendableId);
+
+  // NOTE: This handler is only called if the tab is *already active*.
+  const handleClick = useCallback(
+    (event: MouseEvent<HTMLButtonElement>) => {
+      setActivePart('panel');
+      onClick?.(event);
+    },
+    [setActivePart, onClick],
+  );
+
+  return (
+    <TabsPrimitive.Trigger value={value} asChild>
+      <IconButton
+        density='fine'
+        variant={
+          orientation === 'horizontal' && contextValue === value ? (hasAttention ? 'primary' : 'default') : 'ghost'
+        }
+        {...props}
+        onClick={handleClick}
+        classNames={[
+          orientation === 'vertical' && 'justify-start text-start is-full',
+          orientation === 'vertical' && ghostSelectedContainerMd,
+          classNames,
+        ]}
+      />
+    </TabsPrimitive.Trigger>
+  );
+};
+
 type TabsTabpanelProps = ThemedClassName<TabsPrimitive.TabsContentProps>;
 
 const TabsTabpanel = ({ classNames, children, ...props }: TabsTabpanelProps) => {
+  const { value: contextValue } = useTabsContext('TabsTab');
   return (
-    <TabsPrimitive.Content {...props} className={mx('dx-focus-ring-inset-over-all', classNames)}>
-      {children}
-    </TabsPrimitive.Content>
+    <Activity mode={contextValue === props.value ? 'visible' : 'hidden'}>
+      <TabsPrimitive.Content {...props} className={mx('dx-focus-ring-inset-over-all', classNames)}>
+        {children}
+      </TabsPrimitive.Content>
+    </Activity>
   );
 };
 
@@ -233,6 +291,7 @@ export const Tabs = {
   Root: TabsRoot,
   Tablist: TabsTablist,
   Tab: TabsTab,
+  IconTab: TabsIconTab,
   TabPrimitive: TabsPrimitive.Trigger,
   TabGroupHeading: TabsTabGroupHeading,
   Tabpanel: TabsTabpanel,