@boostdev/design-system-components 1.0.3 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boostdev/design-system-components",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "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

@@ -41,14 +41,17 @@
     cursor: pointer;
     scroll-padding-block-end: var(--bds-space_l);
     justify-content: center;
-    height: var(--button_height, 3em);
+    block-size: var(--button_height, 3em);
     font-size: var(--button_font-size, inherit);
     white-space: nowrap;
     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.mdx

@@ -0,0 +1,72 @@
+import { Meta, Canvas, ArgTypes } from '@storybook/blocks';
+import * as Stories from './Button.native.stories';
+
+<Meta of={Stories} />
+
+# Button (React Native)
+
+React Native button component using `Pressable`. Matches the web `Button` API as closely as possible, replacing `onClick` with `onPress` and `aria-label` with `accessibilityLabel`.
+
+> **Status: alpha** — API may change before stable release.
+
+## Usage
+
+```tsx
+import { Button } from '@boostdev/components';
+
+<Button variant="default" size="medium" onPress={() => console.log('pressed')}>
+  Save
+</Button>
+```
+
+Wrap your tree in `ThemeProvider` (once, at the app root):
+
+```tsx
+import { ThemeProvider } from '@boostdev/components/native/ThemeContext';
+
+export default function App() {
+  return <ThemeProvider><YourApp /></ThemeProvider>;
+}
+```
+
+## Examples
+
+### All variants & sizes
+<Canvas of={Stories.AllVariants} />
+
+### Default
+<Canvas of={Stories.Default} />
+
+### Ghost
+<Canvas of={Stories.Ghost} />
+
+### Sizes
+<Canvas of={Stories.Small} />
+<Canvas of={Stories.Medium} />
+<Canvas of={Stories.Large} />
+
+### Disabled
+<Canvas of={Stories.Disabled} />
+
+## Props
+
+<ArgTypes of={Stories} />
+
+## Props reference
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variant` | `"default" \| "ghost"` | `"default"` | Visual style |
+| `size` | `"small" \| "medium" \| "large"` | `"medium"` | Height and padding scale |
+| `disabled` | boolean | `false` | Prevents interaction, reduces opacity |
+| `onPress` | `() => void` | — | Called when the button is pressed |
+| `iconStart` | `ReactNode` | — | Icon before the label |
+| `iconEnd` | `ReactNode` | — | Icon after the label |
+| `accessibilityLabel` | string | — | Screen reader label (required for icon-only buttons) |
+| `style` | `StyleProp<ViewStyle>` | — | Override container styles |
+
+## Accessibility
+
+- Provide `accessibilityLabel` for icon-only buttons
+- `disabled` communicates the disabled state to assistive technologies
+- Pressed state reduces opacity to 0.75 for visual feedback

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.module.css

@@ -4,8 +4,8 @@
     border: none;
     border-radius: var(--bds-border_radius--m);
     background: transparent;
-    width: min(40rem, 90vw);
-    max-height: 70vh;
+    inline-size: min(40rem, 90vw);
+    max-block-size: 70vh;
     overflow: visible;
     margin-block-start: 10vh;
   }
@@ -23,7 +23,7 @@
     border-radius: var(--bds-border_radius--m);
     box-shadow: var(--command_shadow, var(--bds-shadow_xl));
     overflow: hidden;
-    max-height: 70vh;
+    max-block-size: 70vh;
     border: var(--command_border, none);
     --bdc_color: currentcolor;
     --bdc-outline_radius: var(--bds-border_radius--m);
@@ -42,8 +42,8 @@
   }
 
   .searchIcon {
-    width: 1.25rem;
-    height: 1.25rem;
+    inline-size: 1.25rem;
+    block-size: 1.25rem;
     color: var(--bds-color_on-bg);
     flex-shrink: 0;
   }
@@ -56,7 +56,7 @@
     font-size: var(--bds-font_size--body);
     color: var(--bds-color_on-bg);
     background: transparent;
-    min-width: 0;
+    min-inline-size: 0;
   }
 
   .search::placeholder {
@@ -78,7 +78,7 @@
   }
 
   .list {
-    overflow-y: auto;
+    overflow-block: auto;
     list-style: none;
     margin: 0;
     padding: var(--bds-space_xs) 0;

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

@@ -59,6 +59,16 @@ describe('Command', () => {
     expect(screen.getByText('Save current file')).toBeInTheDocument();
   });
 
+  it('dialog has an id for invoker targeting', () => {
+    render(<Command isOpen items={items} onClose={() => {}} />);
+    expect(document.querySelector('dialog')).toHaveAttribute('id');
+  });
+
+  it('uses provided id on dialog', () => {
+    render(<Command id="cmd-palette" isOpen items={items} onClose={() => {}} />);
+    expect(document.querySelector('dialog')).toHaveAttribute('id', 'cmd-palette');
+  });
+
   it('locks body scroll when open', () => {
     render(<Command isOpen items={items} onClose={() => {}} />);
     expect(document.body.style.overflow).toBe('hidden');
@@ -99,4 +109,31 @@ describe('Command', () => {
 
     document.body.removeChild(trigger);
   });
+
+  describe('command event (Invoker Commands API)', () => {
+    function makeCommandEvent(command: string) {
+      const event = new Event('command');
+      Object.defineProperty(event, 'command', { value: command, configurable: true });
+      return event;
+    }
+
+    it('locks scroll and calls onOpen on show-modal command', () => {
+      const onOpen = vi.fn();
+      render(<Command isOpen={false} items={items} onOpen={onOpen} onClose={() => {}} />);
+      const dialog = document.querySelector('dialog')!;
+      dialog.dispatchEvent(makeCommandEvent('show-modal'));
+      expect(document.body.style.overflow).toBe('hidden');
+      expect(onOpen).toHaveBeenCalled();
+    });
+
+    it('restores scroll and calls onClose on close command', () => {
+      const onClose = vi.fn();
+      render(<Command isOpen items={items} onClose={onClose} />);
+      document.body.style.overflow = 'hidden';
+      const dialog = document.querySelector('dialog')!;
+      dialog.dispatchEvent(makeCommandEvent('close'));
+      expect(document.body.style.overflow).toBe('');
+      expect(onClose).toHaveBeenCalled();
+    });
+  });
 });

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,12 @@
 import { useState, useEffect, useRef, useId, KeyboardEvent, useMemo } from 'react';
+import { installInvokerCommandsPolyfill } from '../../../polyfill-invoker-commands';
+
+// Install once at module load — no-op if native support is present.
+installInvokerCommandsPolyfill();
+
 import css from './Command.module.css';
 import { cn } from '@boostdev/design-system-foundation';
+import type { WithClassName } from '../../../types';
 
 export interface CommandItem {
   id: string;
@@ -11,16 +17,19 @@ export interface CommandItem {
   onSelect: () => void;
 }
 
-interface CommandProps {
+interface CommandProps extends WithClassName {
+  id?: string;
   isOpen: boolean;
+  onOpen?: () => void;
   onClose: () => void;
   items: CommandItem[];
   placeholder?: string;
-  className?: string;
 }
 
 export function Command({
+  id: idProp,
   isOpen,
+  onOpen,
   onClose,
   items,
   placeholder = 'Search commands…',
@@ -28,6 +37,8 @@ export function Command({
 }: Readonly<CommandProps>) {
   const [query, setQuery] = useState('');
   const [activeIndex, setActiveIndex] = useState(0);
+  const generatedId = useId();
+  const dialogId = idProp ?? generatedId;
   const dialogRef = useRef<HTMLDialogElement>(null);
   const inputRef = useRef<HTMLInputElement>(null);
   const listboxId = useId();
@@ -56,14 +67,14 @@ export function Command({
   useEffect(() => {
     const dialog = dialogRef.current;
     if (!dialog) return;
-    if (isOpen) {
+    if (isOpen && !dialog.open) {
       triggerRef.current = document.activeElement;
       dialog.showModal();
       document.body.style.overflow = 'hidden';
       setQuery('');
       setActiveIndex(0);
       setTimeout(() => inputRef.current?.focus(), 0);
-    } else if (dialog.open) {
+    } else if (!isOpen && dialog.open) {
       dialog.close();
       document.body.style.overflow = '';
       (triggerRef.current as HTMLElement | null)?.focus();
@@ -77,6 +88,29 @@ export function Command({
     setActiveIndex(0);
   }, [query]);
 
+  // Invoker Commands API: sync state when opened/closed via commandfor/command.
+  useEffect(() => {
+    const dialog = dialogRef.current;
+    if (!dialog) return;
+    const handleCommand = (e: CommandEvent) => {
+      if (e.command === 'show-modal') {
+        triggerRef.current = document.activeElement;
+        document.body.style.overflow = 'hidden';
+        setQuery('');
+        setActiveIndex(0);
+        setTimeout(() => inputRef.current?.focus(), 0);
+        onOpen?.();
+      } else if (e.command === 'close') {
+        document.body.style.overflow = '';
+        const trigger = triggerRef.current;
+        setTimeout(() => (trigger as HTMLElement | null)?.focus(), 0);
+        onClose();
+      }
+    };
+    dialog.addEventListener('command', handleCommand);
+    return () => dialog.removeEventListener('command', handleCommand);
+  }, [onOpen, onClose]);
+
   const handleCancel = (e: React.SyntheticEvent) => {
     e.preventDefault();
     onClose();
@@ -106,6 +140,7 @@ export function Command({
   return (
     <dialog
       ref={dialogRef}
+      id={dialogId}
       className={cn(css.dialog, className)}
       aria-label="Command palette"
       aria-modal="true"