@duro-app/ui 0.22.0 → 0.24.0

package/src/components/List/List.stories.tsx

@@ -32,7 +32,9 @@ export const Default: Story = {
           <List.Description>Reverse proxy · Port 443</List.Description>
         </List.Content>
         <List.Actions>
-          <Badge variant="success" size="sm">Running</Badge>
+          <Badge variant="success" size="sm">
+            Running
+          </Badge>
         </List.Actions>
       </List.Item>
       <List.Item>
@@ -41,7 +43,9 @@ export const Default: Story = {
           <List.Description>Web server · Port 80</List.Description>
         </List.Content>
         <List.Actions>
-          <Badge variant="success" size="sm">Running</Badge>
+          <Badge variant="success" size="sm">
+            Running
+          </Badge>
         </List.Actions>
       </List.Item>
       <List.Item>
@@ -50,7 +54,9 @@ export const Default: Story = {
           <List.Description>DNS filter · Port 53</List.Description>
         </List.Content>
         <List.Actions>
-          <Badge variant="default" size="sm">Stopped</Badge>
+          <Badge variant="default" size="sm">
+            Stopped
+          </Badge>
         </List.Actions>
       </List.Item>
     </List.Root>
@@ -77,9 +83,27 @@ const narrowContainer = css.create({
 
 function SelectionDemo() {
   const certs = [
-    {id: 'c1', serial: 'aa:bb:cc:dd:01', issued: 'Mar 21, 2026', expires: 'Jun 19, 2026', status: 'active' as const},
-    {id: 'c2', serial: 'aa:bb:cc:dd:02', issued: 'Mar 21, 2026', expires: 'Jun 19, 2026', status: 'active' as const},
-    {id: 'c3', serial: 'ee:ff:00:11:03', issued: 'Jan 10, 2025', expires: 'Jan 10, 2026', status: 'expired' as const},
+    {
+      id: 'c1',
+      serial: 'aa:bb:cc:dd:01',
+      issued: 'Mar 21, 2026',
+      expires: 'Jun 19, 2026',
+      status: 'active' as const,
+    },
+    {
+      id: 'c2',
+      serial: 'aa:bb:cc:dd:02',
+      issued: 'Mar 21, 2026',
+      expires: 'Jun 19, 2026',
+      status: 'active' as const,
+    },
+    {
+      id: 'c3',
+      serial: 'ee:ff:00:11:03',
+      issued: 'Jan 10, 2025',
+      expires: 'Jan 10, 2026',
+      status: 'expired' as const,
+    },
   ]
 
   const [selected, setSelected] = useState<Set<string>>(new Set())
@@ -117,10 +141,7 @@ function SelectionDemo() {
               </List.Description>
             </List.Content>
             <List.Actions>
-              <Badge
-                variant={cert.status === 'active' ? 'success' : 'default'}
-                size="sm"
-              >
+              <Badge variant={cert.status === 'active' ? 'success' : 'default'} size="sm">
                 {cert.status}
               </Badge>
               {cert.status === 'active' && (
@@ -178,13 +199,12 @@ function DetailPanelDemo() {
           >
             <List.Content>
               <List.Text>{user.name}</List.Text>
-              <List.Description>{user.email} · {user.role}</List.Description>
+              <List.Description>
+                {user.email} · {user.role}
+              </List.Description>
             </List.Content>
             <List.Actions>
-              <Badge
-                variant={user.status === 'Active' ? 'success' : 'default'}
-                size="sm"
-              >
+              <Badge variant={user.status === 'Active' ? 'success' : 'default'} size="sm">
                 {user.status}
               </Badge>
             </List.Actions>

package/src/components/List/List.tsx

@@ -60,11 +60,7 @@ function Item({children, selected, disabled, onClick}: ItemProps) {
       aria-selected={isSelectable ? selected : undefined}
       aria-disabled={disabled || undefined}
       onClick={disabled ? undefined : onClick}
-      style={[
-        styles.item,
-        selected && styles.itemSelected,
-        disabled && styles.itemDisabled,
-      ]}
+      style={[styles.item, selected && styles.itemSelected, disabled && styles.itemDisabled]}
     >
       {children}
     </html.div>

package/src/components/RadioGroup/RadioGroup.meta.ts

@@ -0,0 +1,25 @@
+import type {ComponentMeta} from '../component-meta'
+
+export const meta: ComponentMeta = {
+  description:
+    'Radio button group for single-select from a list of options. Compound component with Root container and Item children.',
+  whenToUse: [
+    'Selecting exactly one option from a small set (2-5 items)',
+    'Options need to be visible at all times (not hidden in a dropdown)',
+  ],
+  whenNotToUse: [
+    'Many options (5+) — use Select for space efficiency',
+    'Multi-select — use CheckboxGroup instead',
+    'Binary on/off — use Switch',
+  ],
+  relatedTo: [
+    {component: 'CheckboxGroup', relationship: 'CheckboxGroup for multi-select; RadioGroup for single-select'},
+    {component: 'Select', relationship: 'Select for larger option sets or when space is limited'},
+    {component: 'ToggleGroup', relationship: 'ToggleGroup for toolbar-style selection'},
+  ],
+  example: `<RadioGroup.Root defaultValue="email" onValueChange={(v) => console.log(v)}>
+  <RadioGroup.Item value="email">Email</RadioGroup.Item>
+  <RadioGroup.Item value="sms">SMS</RadioGroup.Item>
+  <RadioGroup.Item value="push">Push notification</RadioGroup.Item>
+</RadioGroup.Root>`,
+}

package/src/components/RadioGroup/RadioGroup.stories.tsx

@@ -0,0 +1,83 @@
+import {useState} from 'react'
+import type {Meta, StoryObj} from '@storybook/react'
+import {expect, fn} from 'storybook/test'
+import {css, html} from 'react-strict-dom'
+import {RadioGroup} from './RadioGroup'
+
+const meta: Meta = {
+  title: 'Components/RadioGroup',
+  argTypes: {
+    orientation: {control: 'select', options: ['horizontal', 'vertical']},
+    disabled: {control: 'boolean'},
+  },
+}
+
+export default meta
+type Story = StoryObj
+
+export const Default: Story = {
+  render: () => (
+    <RadioGroup.Root defaultValue="apple">
+      <RadioGroup.Item value="apple">Apple</RadioGroup.Item>
+      <RadioGroup.Item value="banana">Banana</RadioGroup.Item>
+      <RadioGroup.Item value="cherry">Cherry</RadioGroup.Item>
+    </RadioGroup.Root>
+  ),
+  play: async ({canvas}) => {
+    const radios = canvas.getAllByRole('radio')
+    await expect(radios.length).toBe(3)
+    await expect(radios[0]).toBeChecked()
+    await expect(radios[1]).not.toBeChecked()
+  },
+}
+
+export const Horizontal: Story = {
+  render: () => (
+    <RadioGroup.Root defaultValue="sm" orientation="horizontal">
+      <RadioGroup.Item value="sm">Small</RadioGroup.Item>
+      <RadioGroup.Item value="md">Medium</RadioGroup.Item>
+      <RadioGroup.Item value="lg">Large</RadioGroup.Item>
+    </RadioGroup.Root>
+  ),
+  play: async ({canvas}) => {
+    const group = canvas.getByRole('radiogroup')
+    await expect(group).toHaveAttribute('aria-orientation', 'horizontal')
+  },
+}
+
+export const Disabled: Story = {
+  render: () => (
+    <RadioGroup.Root defaultValue="on" disabled>
+      <RadioGroup.Item value="on">On</RadioGroup.Item>
+      <RadioGroup.Item value="off">Off</RadioGroup.Item>
+    </RadioGroup.Root>
+  ),
+  play: async ({canvas}) => {
+    const radios = canvas.getAllByRole('radio')
+    await expect(radios[0]).toBeDisabled()
+    await expect(radios[1]).toBeDisabled()
+  },
+}
+
+export const Controlled: Story = {
+  render: () => {
+    const [value, setValue] = useState('red')
+    return (
+      <html.div>
+        <RadioGroup.Root value={value} onValueChange={setValue}>
+          <RadioGroup.Item value="red">Red</RadioGroup.Item>
+          <RadioGroup.Item value="green">Green</RadioGroup.Item>
+          <RadioGroup.Item value="blue">Blue</RadioGroup.Item>
+        </RadioGroup.Root>
+      </html.div>
+    )
+  },
+  play: async ({canvas, userEvent}) => {
+    const radios = canvas.getAllByRole('radio')
+    await expect(radios[0]).toBeChecked()
+
+    await userEvent.click(radios[2])
+    await expect(radios[2]).toBeChecked()
+    await expect(radios[0]).not.toBeChecked()
+  },
+}

package/src/components/RadioGroup/RadioGroup.tsx

@@ -0,0 +1,113 @@
+import {type ReactNode, createContext, useContext, useCallback} from 'react'
+import {html} from 'react-strict-dom'
+import {useControllableValue} from '../../hooks/useControllableValue'
+import {styles} from './styles.css'
+
+// --- Context ---
+
+interface RadioGroupContextValue {
+  value: string
+  onSelect: (value: string) => void
+  disabled: boolean
+}
+
+const RadioGroupContext = createContext<RadioGroupContextValue | null>(null)
+
+function useRadioGroup() {
+  const ctx = useContext(RadioGroupContext)
+  if (!ctx) {
+    throw new Error('RadioGroup.Item must be used within RadioGroup.Root')
+  }
+  return ctx
+}
+
+// --- Root ---
+
+interface RootProps {
+  value?: string
+  defaultValue?: string
+  onValueChange?: (value: string) => void
+  orientation?: 'horizontal' | 'vertical'
+  disabled?: boolean
+  children: ReactNode
+}
+
+function Root({
+  value: controlledValue,
+  defaultValue = '',
+  onValueChange,
+  orientation = 'vertical',
+  disabled = false,
+  children,
+}: RootProps) {
+  const [value, setValue] = useControllableValue(controlledValue, defaultValue, onValueChange)
+
+  const onSelect = useCallback(
+    (itemValue: string) => {
+      if (!disabled) {
+        setValue(itemValue)
+      }
+    },
+    [disabled, setValue],
+  )
+
+  return (
+    <RadioGroupContext.Provider value={{value, onSelect, disabled}}>
+      <html.div
+        role="radiogroup"
+        aria-orientation={orientation}
+        style={[styles.root, orientation === 'horizontal' && styles.rootHorizontal]}
+      >
+        {children}
+      </html.div>
+    </RadioGroupContext.Provider>
+  )
+}
+
+// --- Item ---
+
+interface ItemProps {
+  value: string
+  disabled?: boolean
+  children: ReactNode
+}
+
+function Item({value, disabled: itemDisabled = false, children}: ItemProps) {
+  const {value: groupValue, onSelect, disabled: groupDisabled} = useRadioGroup()
+  const isChecked = groupValue === value
+  const isDisabled = groupDisabled || itemDisabled
+
+  const handleClick = () => {
+    if (!isDisabled) {
+      onSelect(value)
+    }
+  }
+
+  return (
+    <html.label
+      style={[styles.item, isDisabled && styles.itemDisabled]}
+      onClick={handleClick}
+    >
+      <html.input
+        type="radio"
+        value={value}
+        checked={isChecked}
+        disabled={isDisabled}
+        onChange={() => onSelect(value)}
+        style={styles.input}
+      />
+      <html.span
+        style={[styles.circle, isChecked ? styles.circleChecked : styles.circleUnchecked]}
+        aria-hidden
+      >
+        {isChecked && <html.span style={styles.dot} />}
+      </html.span>
+      {children && <html.span>{children}</html.span>}
+    </html.label>
+  )
+}
+
+export const RadioGroup = {
+  Root,
+  Item,
+}

package/src/components/RadioGroup/styles.css.ts

@@ -0,0 +1,66 @@
+import {css} from 'react-strict-dom'
+import {colors} from '@duro-app/tokens/tokens/colors.css'
+import {spacing, radii} from '@duro-app/tokens/tokens/spacing.css'
+import {typography} from '@duro-app/tokens/tokens/typography.css'
+
+export const styles = css.create({
+  root: {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: spacing.sm,
+  },
+  rootHorizontal: {
+    flexDirection: 'row',
+  },
+  item: {
+    display: 'inline-flex',
+    alignItems: 'center',
+    gap: spacing.sm,
+    cursor: 'pointer',
+    fontSize: typography.fontSizeSm,
+    color: colors.text,
+    lineHeight: typography.lineHeight,
+  },
+  itemDisabled: {
+    opacity: 0.5,
+    cursor: 'not-allowed',
+  },
+  circle: {
+    width: 18,
+    height: 18,
+    borderWidth: 1,
+    borderStyle: 'solid',
+    borderRadius: radii.full,
+    display: 'inline-flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    flexShrink: 0,
+    transitionProperty: 'background-color, border-color',
+    transitionDuration: '150ms',
+    transitionTimingFunction: 'ease',
+  },
+  circleUnchecked: {
+    backgroundColor: colors.bg,
+    borderColor: {
+      default: colors.border,
+      ':hover': colors.textMuted,
+    },
+  },
+  circleChecked: {
+    backgroundColor: colors.bg,
+    borderColor: colors.accent,
+  },
+  dot: {
+    width: 8,
+    height: 8,
+    borderRadius: radii.full,
+    backgroundColor: colors.accent,
+  },
+  input: {
+    position: 'absolute',
+    width: 1,
+    height: 1,
+    opacity: 0,
+    overflow: 'hidden',
+  },
+})

package/src/components/StatusIcon/StatusIcon.meta.ts

@@ -8,10 +8,7 @@ export const meta: ComponentMeta = {
     'List item status icons with colored backgrounds',
     'Feature or capability indicators',
   ],
-  whenNotToUse: [
-    'Inline icons without background — use Icon',
-    'Status text labels — use Badge',
-  ],
+  whenNotToUse: ['Inline icons without background — use Icon', 'Status text labels — use Badge'],
   relatedTo: [
     {component: 'Icon', relationship: 'StatusIcon wraps Icon with background; Icon is bare SVG'},
     {component: 'Badge', relationship: 'Badge for text status; StatusIcon for icon status'},

package/src/components/Table/ColumnFilter.tsx

@@ -0,0 +1,46 @@
+import type {Column} from '@tanstack/react-table'
+import {html} from 'react-strict-dom'
+import {css} from 'react-strict-dom'
+import {colors} from '@duro-app/tokens/tokens/colors.css'
+import {spacing, radii} from '@duro-app/tokens/tokens/spacing.css'
+import {typography} from '@duro-app/tokens/tokens/typography.css'
+
+const styles = css.create({
+  input: {
+    width: '100%',
+    paddingTop: 2,
+    paddingBottom: 2,
+    paddingLeft: spacing.xs,
+    paddingRight: spacing.xs,
+    marginTop: spacing.xs,
+    borderWidth: 1,
+    borderStyle: 'solid',
+    borderColor: colors.border,
+    borderRadius: radii.xs,
+    backgroundColor: colors.bg,
+    color: colors.text,
+    fontSize: typography.fontSizeXs,
+    outline: 'none',
+  },
+})
+
+interface ColumnFilterProps<TData> {
+  column: Column<TData, unknown>
+  placeholder?: string
+}
+
+export function ColumnFilter<TData>({column, placeholder}: ColumnFilterProps<TData>) {
+  if (!column.getCanFilter()) return null
+
+  const filterValue = (column.getFilterValue() as string) ?? ''
+
+  return (
+    <html.input
+      style={styles.input}
+      type="text"
+      value={filterValue}
+      onChange={(e: any) => column.setFilterValue(e.target.value || undefined)}
+      placeholder={placeholder ?? `Filter...`}
+    />
+  )
+}

package/src/components/Table/Pagination.tsx

@@ -0,0 +1,82 @@
+import type {Table} from '@tanstack/react-table'
+import {html} from 'react-strict-dom'
+import {css} from 'react-strict-dom'
+import {spacing} from '@duro-app/tokens/tokens/spacing.css'
+import {colors} from '@duro-app/tokens/tokens/colors.css'
+import {typography} from '@duro-app/tokens/tokens/typography.css'
+
+const styles = css.create({
+  root: {
+    display: 'flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    gap: spacing.sm,
+    paddingTop: spacing.md,
+    paddingBottom: spacing.sm,
+  },
+  button: {
+    display: 'inline-flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    paddingTop: spacing.xs,
+    paddingBottom: spacing.xs,
+    paddingLeft: spacing.sm,
+    paddingRight: spacing.sm,
+    borderWidth: 1,
+    borderStyle: 'solid',
+    borderColor: colors.border,
+    borderRadius: 6,
+    backgroundColor: {
+      default: 'transparent',
+      ':hover': colors.bgCardHover,
+    },
+    color: colors.text,
+    fontSize: typography.fontSizeSm,
+    cursor: 'pointer',
+    transitionProperty: 'background-color',
+    transitionDuration: '150ms',
+  },
+  buttonDisabled: {
+    opacity: 0.4,
+    cursor: 'not-allowed',
+    backgroundColor: 'transparent',
+  },
+  pageInfo: {
+    fontSize: typography.fontSizeSm,
+    color: colors.textMuted,
+  },
+})
+
+interface PaginationProps<TData> {
+  table: Table<TData>
+}
+
+export function Pagination<TData>({table}: PaginationProps<TData>) {
+  const {pageIndex, pageSize} = table.getState().pagination
+  const pageCount = table.getPageCount()
+  const totalRows = table.getFilteredRowModel().rows.length
+
+  if (totalRows <= pageSize) return null
+
+  return (
+    <html.div style={styles.root}>
+      <html.button
+        style={[styles.button, !table.getCanPreviousPage() && styles.buttonDisabled]}
+        onClick={() => table.previousPage()}
+        disabled={!table.getCanPreviousPage()}
+      >
+        Previous
+      </html.button>
+      <html.span style={styles.pageInfo}>
+        {pageIndex + 1} / {pageCount}
+      </html.span>
+      <html.button
+        style={[styles.button, !table.getCanNextPage() && styles.buttonDisabled]}
+        onClick={() => table.nextPage()}
+        disabled={!table.getCanNextPage()}
+      >
+        Next
+      </html.button>
+    </html.div>
+  )
+}

package/src/components/Table/SortIndicator.tsx

@@ -0,0 +1,56 @@
+import type {Column} from '@tanstack/react-table'
+import {html} from 'react-strict-dom'
+import {css} from 'react-strict-dom'
+import {colors} from '@duro-app/tokens/tokens/colors.css'
+
+const styles = css.create({
+  root: {
+    display: 'inline-flex',
+    alignItems: 'center',
+    marginLeft: 4,
+    fontSize: 10,
+    userSelect: 'none',
+    // Hidden by default, shown on hover or when active
+    opacity: 0,
+    transitionProperty: 'opacity',
+    transitionDuration: '120ms',
+  },
+  active: {
+    opacity: 1,
+    color: colors.accent,
+  },
+  inactive: {
+    color: colors.textMuted,
+  },
+})
+
+interface SortIndicatorProps<TData> {
+  column: Column<TData, unknown>
+}
+
+/**
+ * Sort direction chevron for table column headers.
+ *
+ * - Shows \u25B2 (asc), \u25BC (desc), or \u21C5 (unsorted)
+ * - Hidden by default, visible on header hover or when actively sorted
+ * - Clicking the header cell should call column.getToggleSortingHandler()
+ *
+ * The parent HeaderCell applies a :hover rule that sets child opacity to 1.
+ */
+export function SortIndicator<TData>({column}: SortIndicatorProps<TData>) {
+  if (!column.getCanSort()) return null
+
+  const sorted = column.getIsSorted()
+
+  return (
+    <html.span
+      style={[
+        styles.root,
+        sorted ? styles.active : styles.inactive,
+      ]}
+      data-sort-indicator=""
+    >
+      {sorted === 'asc' ? '\u25B2' : sorted === 'desc' ? '\u25BC' : '\u21C5'}
+    </html.span>
+  )
+}