@boostdev/design-system-components 1.0.3 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boostdev/design-system-components",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "BoostDev React component library: accessible, token-driven components built on @boostdev/design-system-foundation",
   "keywords": [
     "React",
@@ -26,6 +26,7 @@
   "type": "module",
   "exports": {
     ".": {
+      "react-native": "./dist/native/index.js",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
@@ -35,6 +36,10 @@
       "import": "./dist/client.js",
       "require": "./dist/client.cjs"
     },
+    "./web-components": {
+      "types": "./dist/web-components.d.ts",
+      "import": "./dist/web-components.js"
+    },
     "./css": "./dist/index.css",
     "./css/bdc": "./src/css/bdc.css",
     "./css/accordion": "./src/components/ui/Accordion/Accordion.module.css",
@@ -89,6 +94,7 @@
     "./css/section-header": "./src/components/layout/SectionHeader/SectionHeader.module.css"
   },
   "main": "./dist/index.js",
+  "react-native": "./dist/native/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
@@ -121,15 +127,19 @@
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@types/node": "^25.5.0",
-    "@types/react": "^18",
-    "@types/react-dom": "^18",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@types/react-native": "^0.73.0",
     "@vitejs/plugin-react": "^5.1.4",
     "eslint": "^9",
     "git-cliff": "^2.12.0",
     "identity-obj-proxy": "^3.0.0",
     "jsdom": "^28.1.0",
+    "lit": "^3.3.2",
+    "react-native-web": "^0.21.2",
     "remark-gfm": "^4.0.1",
     "storybook": "^8.6.18",
+    "storybook-addon-tag-badges": "^1.4.0",
     "stylelint": "^16",
     "stylelint-config-standard": "^37",
     "tsup": "^8",
@@ -142,7 +152,16 @@
   "peerDependencies": {
     "@boostdev/design-system-foundation": ">=1.0.4",
     "react": ">=18",
-    "react-dom": ">=18"
+    "react-dom": ">=18",
+    "react-native": ">=0.70"
+  },
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "access": "public",
@@ -150,5 +169,8 @@
   },
   "sideEffects": [
     "src/css/**/*.css"
-  ]
+  ],
+  "dependencies": {
+    "@oddbird/css-anchor-positioning": "^0.9.0"
+  }
 }

package/src/components/interaction/Button/Button.module.css

@@ -47,8 +47,11 @@
     line-height: 1;
 
     /* Colour model: override --button_color + --button_on-color to re-theme */
-    --button_color:    var(--bds-color_green);
-    --button_on-color: var(--bds-color_on-green);
+    --button_color:        var(--bds-color_green);
+    --button_on-color:     var(--bds-color_on-green);
+
+    /* Text-safe variant of --button_color for use on page background (ghost text/border) */
+    --button_color--on-bg: var(--bds-color_green--strong);
 
     background-color: var(--button_bg, var(--button_color));
     color: var(--button_text, var(--button_on-color));
@@ -63,11 +66,11 @@
   /* Default: filled with --button_color, no visible border */
   .button.--default { /* inherits base — no overrides needed */ }
 
-  /* Ghost: transparent background, border and text use --button_color */
+  /* Ghost: transparent background, border and text use text-safe --button_color--on-bg */
   .button.--ghost {
     --button_bg:   transparent;
-    --button_text: var(--button_color);
-    --bdc_color:   var(--button_color);
+    --button_text: var(--button_color--on-bg);
+    --bdc_color:   var(--button_color--on-bg);
   }
 
   .button.--size_small {
@@ -141,8 +144,8 @@
   @media (hover: hover) and (pointer: fine) {
     .button.--default:hover {
       --button_bg:          var(--bds-color_bg);
-      --button_text:        var(--bds-color_interactive);
-      --button_pulse-color: var(--bds-color_interactive);
+      --button_text:        var(--bds-color_interactive_on-bg);
+      --button_pulse-color: var(--bds-color_interactive_on-bg);
       --bdc_color:          currentcolor;
     }
   }

package/src/components/interaction/Button/Button.native.spec.tsx

@@ -0,0 +1,35 @@
+import { render, screen } from '@testing-library/react';
+import { ThemeProvider } from '../../../native/ThemeContext';
+import { Button } from './Button.native';
+
+function renderWithTheme(ui: React.ReactElement) {
+  return render(<ThemeProvider>{ui}</ThemeProvider>);
+}
+
+describe('Button (native)', () => {
+  it('has button role', () => {
+    renderWithTheme(<Button>Save</Button>);
+    expect(screen.getByRole('button', { name: 'Save' })).toBeInTheDocument();
+  });
+
+  it('exposes disabled state', () => {
+    renderWithTheme(<Button disabled>Save</Button>);
+    expect(screen.getByRole('button', { name: 'Save' })).toHaveAttribute('aria-disabled', 'true');
+  });
+
+  it('renders with icon-start without throwing', () => {
+    // Icon wrappers have importantForAccessibility="no-hide-descendants" (Android)
+    // and accessibilityElementsHidden={true} (iOS) so decorative icons are hidden on device.
+    const icon = <span data-testid="icon">★</span>;
+    renderWithTheme(<Button iconStart={icon}>Save</Button>);
+    expect(screen.getByRole('button')).toBeInTheDocument();
+    expect(screen.getByTestId('icon')).toBeInTheDocument();
+  });
+
+  it('renders with icon-end without throwing', () => {
+    const icon = <span data-testid="icon-end">→</span>;
+    renderWithTheme(<Button iconEnd={icon}>Next</Button>);
+    expect(screen.getByRole('button')).toBeInTheDocument();
+    expect(screen.getByTestId('icon-end')).toBeInTheDocument();
+  });
+});

package/src/components/interaction/Button/Button.native.stories.tsx

@@ -0,0 +1,42 @@
+import React from 'react';
+import type { Meta, StoryObj } from '@storybook/react';
+import { ThemeProvider } from '../../../native/ThemeContext';
+import { Button } from './Button.native';
+
+const meta = {
+  tags: ['!stable', 'alpha'],
+  title: 'React Native/Interaction/Button',
+  component: Button,
+  decorators: [(Story) => <ThemeProvider><Story /></ThemeProvider>],
+  parameters: { layout: 'centered' },
+  argTypes: {
+    variant: { control: 'select', options: ['default', 'ghost'] },
+    size: { control: 'select', options: ['small', 'medium', 'large'] },
+    onPress: { action: 'pressed' },
+  },
+} satisfies Meta<typeof Button>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = { args: { children: 'Default', variant: 'default' } };
+export const Ghost: Story = { args: { children: 'Ghost', variant: 'ghost' } };
+export const Small: Story = { args: { children: 'Small', size: 'small' } };
+export const Medium: Story = { args: { children: 'Medium', size: 'medium' } };
+export const Large: Story = { args: { children: 'Large', size: 'large' } };
+export const Disabled: Story = { args: { children: 'Disabled', disabled: true } };
+export const AllVariants: Story = {
+  render: () => (
+    <ThemeProvider>
+      <div style={{ display: 'flex', flexDirection: 'column', gap: '12px' }}>
+        {(['default', 'ghost'] as const).map(v => (
+          <div key={v} style={{ display: 'flex', gap: '8px', alignItems: 'center' }}>
+            {(['small', 'medium', 'large'] as const).map(s => (
+              <Button key={s} variant={v} size={s}>{v} {s}</Button>
+            ))}
+          </div>
+        ))}
+      </div>
+    </ThemeProvider>
+  ),
+};

package/src/components/interaction/Button/Button.native.tsx

@@ -0,0 +1,95 @@
+import { ReactNode } from 'react';
+import { StyleSheet, Pressable, Text, View, StyleProp, ViewStyle } from 'react-native';
+import { spacing, font, border } from '../../../native/tokens';
+import { useTheme } from '../../../native/ThemeContext';
+
+type ButtonVariant = 'default' | 'ghost';
+type ButtonSize = 'small' | 'medium' | 'large';
+
+export interface ButtonProps {
+  children?: ReactNode;
+  variant?: ButtonVariant;
+  size?: ButtonSize;
+  iconStart?: ReactNode;
+  iconEnd?: ReactNode;
+  disabled?: boolean;
+  onPress?: () => void;
+  accessibilityLabel?: string;
+  style?: StyleProp<ViewStyle>;
+}
+
+const sizeTokens: Record<ButtonSize, { height: number; px: number; fontSize: number; radius: number }> = {
+  small:  { height: 36,  px: spacing.m,   fontSize: font.size.bodyS,    radius: border.radius.xs },
+  medium: { height: 48,  px: spacing.m,   fontSize: font.size.body,     radius: border.radius.s },
+  large:  { height: 56,  px: spacing.xxl, fontSize: font.size.heading3, radius: border.radius.m },
+};
+
+const styles = StyleSheet.create({
+  pressable: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    justifyContent: 'center',
+    gap: spacing.xs,
+    alignSelf: 'flex-start',
+  },
+  label: {
+    fontFamily: font.family.body,
+    fontWeight: font.weight.semibold,
+    includeFontPadding: false,
+  },
+});
+
+export function Button({
+  children,
+  variant = 'default',
+  size = 'medium',
+  iconStart,
+  iconEnd,
+  disabled = false,
+  onPress,
+  accessibilityLabel,
+  style,
+}: Readonly<ButtonProps>) {
+  const { colors } = useTheme();
+  const { height, px, fontSize, radius } = sizeTokens[size];
+
+  // Color model: filled = green bg, ghost = transparent bg + darker green border/text
+  const primaryColor = colors.colorGreen;
+  const onPrimaryColor = colors.colorOnGreen;
+  // Ghost uses colorGreenStrong for text/border — colorGreen (#00c950) fails 3:1 on white (2.15:1)
+  const ghostTextColor = colors.colorGreenStrong;
+
+  const containerStyle: ViewStyle = {
+    height,
+    paddingHorizontal: px,
+    borderRadius: radius,
+    opacity: disabled ? 0.4 : 1,
+    ...(variant === 'default' && { backgroundColor: primaryColor }),
+    ...(variant === 'ghost' && {
+      backgroundColor: 'transparent',
+      borderWidth: 1,
+      borderColor: ghostTextColor,
+    }),
+  };
+
+  const textColor = variant === 'default' ? onPrimaryColor : ghostTextColor;
+
+  return (
+    <Pressable
+      onPress={onPress}
+      disabled={disabled}
+      accessibilityRole="button"
+      accessibilityLabel={accessibilityLabel}
+      accessibilityState={{ disabled }}
+      style={({ pressed }) => [styles.pressable, containerStyle, pressed && { opacity: 0.75 }, style]}
+    >
+      {iconStart && <View importantForAccessibility="no-hide-descendants" accessibilityElementsHidden={true}>{iconStart}</View>}
+      {children && (
+        <Text style={[styles.label, { fontSize, color: textColor }]}>
+          {children}
+        </Text>
+      )}
+      {iconEnd && <View importantForAccessibility="no-hide-descendants">{iconEnd}</View>}
+    </Pressable>
+  );
+}

package/src/components/interaction/Button/Button.stories.tsx

@@ -2,7 +2,7 @@ import type { Meta, StoryObj } from '@storybook/react';
 import { Button } from './Button';
 
 const meta = {
-  title: 'Interaction/Button',
+  title: 'React/Interaction/Button',
   component: Button,
   argTypes: {
     variant: { control: 'select', options: ['default', 'ghost'] },

package/src/components/interaction/Button/Button.tsx

@@ -1,8 +1,9 @@
 import {ButtonHTMLAttributes, MouseEventHandler, ReactNode} from 'react';
 import css from './Button.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
-export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement | HTMLAnchorElement> {
+export interface ButtonProps extends WithClassName, ButtonHTMLAttributes<HTMLButtonElement | HTMLAnchorElement> {
   href?: string;
   variant?: 'default' | 'ghost';
   type?: 'button' | 'submit' | 'reset';
@@ -10,7 +11,6 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement | HT
   iconStart?: ReactNode;
   iconEnd?: ReactNode;
   children?: ReactNode;
-  className?: string;
   disabled?: boolean;
   hasPulse?: boolean;
   onClick?: MouseEventHandler<HTMLElement>;

package/src/components/interaction/Command/Command.mdx

@@ -20,6 +20,22 @@ Keyboard-first command palette for searching and executing actions. Commonly tri
 
 <ArgTypes of={Stories} />
 
+## CSS variables
+
+
+<table>
+<thead>
+<tr><th>Variable</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr><td>`--command_color`</td><td>`var(--bds-color_bg)`</td><td>Panel background colour</td></tr>
+<tr><td>`--command_on-color`</td><td>`var(--bds-color_on-bg)`</td><td>Text and icon colour</td></tr>
+<tr><td>`--command_shadow`</td><td>`var(--bds-shadow_xl)`</td><td>Panel box shadow</td></tr>
+<tr><td>`--command_border`</td><td>`none`</td><td>Panel border</td></tr>
+</tbody>
+</table>
+
+
 ## Accessibility
 
 - Input has `role="combobox"` with `aria-controls` pointing to the results list

package/src/components/interaction/Command/Command.stories.tsx

@@ -5,7 +5,7 @@ import type { CommandItem } from './Command';
 import { Button } from '../Button/Button';
 
 const meta = {
-  title: 'Interaction/Command',
+  title: 'React/Interaction/Command',
   component: Command,
 } satisfies Meta<typeof Command>;
 

package/src/components/interaction/Command/Command.tsx

@@ -1,6 +1,7 @@
 import { useState, useEffect, useRef, useId, KeyboardEvent, useMemo } from 'react';
 import css from './Command.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
 export interface CommandItem {
   id: string;
@@ -11,12 +12,11 @@ export interface CommandItem {
   onSelect: () => void;
 }
 
-interface CommandProps {
+interface CommandProps extends WithClassName {
   isOpen: boolean;
   onClose: () => void;
   items: CommandItem[];
   placeholder?: string;
-  className?: string;
 }
 
 export function Command({

package/src/components/interaction/Dialog/Dialog.stories.tsx

@@ -4,7 +4,7 @@ import { Dialog } from './Dialog';
 import { Button } from '../Button/Button';
 
 const meta = {
-  title: 'Interaction/Dialog',
+  title: 'React/Interaction/Dialog',
   component: Dialog,
 } satisfies Meta<typeof Dialog>;
 

package/src/components/interaction/Dialog/Dialog.tsx

@@ -3,10 +3,10 @@ import { ReactNode, useEffect, useRef } from 'react';
 const FOCUSABLE_SELECTOR = 'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])';
 import css from './Dialog.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
-interface DialogProps {
+interface DialogProps extends WithClassName {
   children: ReactNode;
-  className?: string;
   isOpen?: boolean;
   onClose?: () => void;
 }

package/src/components/interaction/Drawer/Drawer.mdx

@@ -28,6 +28,20 @@ Slide-in panel from the left or right edge of the viewport. Use for navigation,
 
 <ArgTypes of={Stories} />
 
+## CSS variables
+
+
+<table>
+<thead>
+<tr><th>Variable</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr><td>`--drawer_color`</td><td>`var(--bds-color_bg)`</td><td>Panel background colour</td></tr>
+<tr><td>`--drawer_on-color`</td><td>`var(--bds-color_on-bg)`</td><td>Text colour</td></tr>
+</tbody>
+</table>
+
+
 ## Accessibility
 
 - Uses `<dialog>` internally — provides native focus trapping and `Escape` to close

package/src/components/interaction/Drawer/Drawer.stories.tsx

@@ -4,7 +4,7 @@ import { Drawer } from './Drawer';
 import { Button } from '../Button/Button';
 
 const meta = {
-  title: 'Interaction/Drawer',
+  title: 'React/Interaction/Drawer',
   component: Drawer,
 } satisfies Meta<typeof Drawer>;
 

package/src/components/interaction/Drawer/Drawer.tsx

@@ -1,14 +1,14 @@
 import { ReactNode, useEffect, useRef } from 'react';
 import css from './Drawer.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
-interface DrawerProps {
+interface DrawerProps extends WithClassName {
   isOpen: boolean;
   onClose: () => void;
   title: ReactNode;
   children: ReactNode;
   side?: 'left' | 'right';
-  className?: string;
   ariaLabel?: string;
 }
 

package/src/components/interaction/DropdownMenu/DropdownMenu.stories.tsx

@@ -3,7 +3,7 @@ import { DropdownMenu } from './DropdownMenu';
 import {Button} from "../Button";
 
 const meta = {
-  title: 'Interaction/DropdownMenu',
+  title: 'React/Interaction/DropdownMenu',
   component: DropdownMenu,
   decorators: [
     Story => (

package/src/components/interaction/DropdownMenu/DropdownMenu.tsx

@@ -10,6 +10,7 @@ import {
 } from 'react';
 import css from './DropdownMenu.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
 export interface DropdownMenuItem {
   id: string;
@@ -20,11 +21,10 @@ export interface DropdownMenuItem {
   separator?: boolean;
 }
 
-interface DropdownMenuProps {
+interface DropdownMenuProps extends WithClassName {
   trigger: ReactElement;
   items: DropdownMenuItem[];
   placement?: 'bottom-start' | 'bottom-end';
-  className?: string;
 }
 
 export function DropdownMenu({

package/src/components/interaction/Popover/Popover.mdx

@@ -27,6 +27,23 @@ Floating panel anchored to a trigger element. Unlike `Tooltip`, popovers can con
 
 <ArgTypes of={Stories} />
 
+## CSS variables
+
+
+<table>
+<thead>
+<tr><th>Variable</th><th>Default</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr><td>`--popover_color`</td><td>`var(--bds-color_bg)`</td><td>Panel background colour</td></tr>
+<tr><td>`--popover_on-color`</td><td>`var(--bds-color_on-bg)`</td><td>Text colour</td></tr>
+<tr><td>`--popover_shadow`</td><td>`var(--bds-shadow_m)`</td><td>Panel box shadow</td></tr>
+<tr><td>`--popover_border`</td><td>`none`</td><td>Panel border</td></tr>
+<tr><td>`--popover_radius`</td><td>`var(--bdc-outline_radius)`</td><td>Panel corner radius</td></tr>
+</tbody>
+</table>
+
+
 ## Accessibility
 
 - Trigger element gets `aria-haspopup="true"` and `aria-expanded` toggled on open/close

package/src/components/interaction/Popover/Popover.module.css

@@ -5,8 +5,13 @@
   }
 
   .panel {
+    /* Absolute positioning keeps the panel anchored to the wrapper/trigger and
+       scrolls with the page. CSS anchor positioning sets the exact placement;
+       @position-try fallbacks handle automatic repositioning on overflow. */
     position: absolute;
-    z-index: var(--bds-z-index_popover);
+    margin: 0;
+    overflow-y: auto;
+    z-index: var(--popover_z-index, 100);
     min-width: 12rem;
     padding: var(--bds-space_m);
     border: var(--popover_border, none);
@@ -22,23 +27,75 @@
     font-size: var(--bds-font_size--body);
   }
 
-  .--placement_bottom {
-    top: calc(100% + var(--bds-space_xs));
-    left: 0;
+  /* Primary placements via CSS anchor positioning.
+     anchor() resolves relative to the element tagged with the matching anchor-name.
+     @position-try fallbacks are tried in order when the primary placement overflows. */
+
+  .panel[data-placement='bottom'] {
+    top: anchor(bottom);
+    left: anchor(left);
+    margin-top: var(--bds-space_xs, 8px);
+    position-try-fallbacks: --popover-top, --popover-right, --popover-left;
+  }
+
+  .panel[data-placement='top'] {
+    bottom: anchor(top);
+    left: anchor(left);
+    margin-bottom: var(--bds-space_xs, 8px);
+    position-try-fallbacks: --popover-bottom, --popover-right, --popover-left;
+  }
+
+  .panel[data-placement='right'] {
+    top: anchor(top);
+    left: anchor(right);
+    margin-left: var(--bds-space_xs, 8px);
+    position-try-fallbacks: --popover-left, --popover-bottom, --popover-top;
+  }
+
+  .panel[data-placement='left'] {
+    top: anchor(top);
+    right: anchor(left);
+    margin-right: var(--bds-space_xs, 8px);
+    position-try-fallbacks: --popover-right, --popover-bottom, --popover-top;
+  }
+
+  /* Fallback placements — used by the browser (or polyfill) when the primary
+     placement would overflow the viewport. Each block resets all inset/margin
+     properties so nothing bleeds in from the primary placement. */
+
+  @position-try --popover-bottom {
+    top: anchor(bottom);
+    right: unset;
+    bottom: unset;
+    left: anchor(left);
+    margin: 0;
+    margin-top: var(--bds-space_xs, 8px);
   }
 
-  .--placement_top {
-    bottom: calc(100% + var(--bds-space_xs));
-    left: 0;
+  @position-try --popover-top {
+    top: unset;
+    right: unset;
+    bottom: anchor(top);
+    left: anchor(left);
+    margin: 0;
+    margin-bottom: var(--bds-space_xs, 8px);
   }
 
-  .--placement_right {
-    left: calc(100% + var(--bds-space_xs));
-    top: 0;
+  @position-try --popover-right {
+    top: anchor(top);
+    right: unset;
+    bottom: unset;
+    left: anchor(right);
+    margin: 0;
+    margin-left: var(--bds-space_xs, 8px);
   }
 
-  .--placement_left {
-    right: calc(100% + var(--bds-space_xs));
-    top: 0;
+  @position-try --popover-left {
+    top: anchor(top);
+    right: anchor(left);
+    bottom: unset;
+    left: unset;
+    margin: 0;
+    margin-right: var(--bds-space_xs, 8px);
   }
 }