@boostdev/design-system-components 1.1.0 → 1.1.1

package/src/components/interaction/Popover/Popover.tsx

@@ -3,20 +3,21 @@ import {
   ReactNode,
   cloneElement,
   isValidElement,
-  useCallback,
   useEffect,
   useId,
   useRef,
   useState,
 } from 'react';
+import { installInvokerCommandsPolyfill } from '../../../polyfill-invoker-commands';
+
+// Install once at module load — no-op if native support is present.
+installInvokerCommandsPolyfill();
+
 import css from './Popover.module.css';
 import { cn } from '@boostdev/design-system-foundation';
 import type { WithClassName } from '../../../types';
 
-const GAP = 8; // --bds-space_xs
-
 // Load the CSS Anchor Positioning polyfill once, only in browsers that need it.
-// The CSS.supports guard is defensive: older environments may not expose it at all.
 if (
   typeof window !== 'undefined' &&
   !(typeof CSS !== 'undefined' && typeof CSS.supports === 'function' && CSS.supports('anchor-name: --a'))
@@ -40,90 +41,73 @@ export function Popover({
 }: Readonly<PopoverProps>) {
   const [isOpen, setIsOpen] = useState(false);
   const containerRef = useRef<HTMLSpanElement>(null);
-  const dialogRef = useRef<HTMLDialogElement>(null);
+  const panelRef = useRef<HTMLDivElement>(null);
   const rawId = useId();
   // CSS anchor-name must be a valid custom-ident: strip non-word characters.
   const anchorName = `--popover-${rawId.replace(/\W/g, '') || 'a'}`;
   const panelId = rawId;
 
-  // Light-dismiss: close on outside click or Escape key.
+  // Sync isOpen state via the popover toggle event (fires on both native and
+  // polyfilled open/close, including light-dismiss and Escape).
+  useEffect(() => {
+    const panel = panelRef.current;
+    if (!panel) return;
+    const handleToggle = (e: Event) => {
+      setIsOpen((e as ToggleEvent).newState === 'open');
+    };
+    panel.addEventListener('toggle', handleToggle);
+    return () => panel.removeEventListener('toggle', handleToggle);
+  }, []);
+
+  // Close the popover when the anchor scrolls out of the viewport.
+  // Light-dismiss (outside click) and Escape are handled natively by popover="auto".
   useEffect(() => {
     if (!isOpen) return;
-    const handleMouseDown = (e: MouseEvent) => {
-      if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
-        setIsOpen(false);
+    const handleScroll = () => {
+      const rect = containerRef.current?.getBoundingClientRect();
+      if (!rect) return;
+      const { innerWidth: vw, innerHeight: vh } = window;
+      if (rect.bottom < 0 || rect.top > vh || rect.right < 0 || rect.left > vw) {
+        panelRef.current?.hidePopover();
       }
     };
-    const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') setIsOpen(false);
-    };
-    document.addEventListener('mousedown', handleMouseDown);
-    document.addEventListener('keydown', handleKeyDown);
+    window.addEventListener('scroll', handleScroll, { capture: true, passive: true });
+    window.addEventListener('resize', handleScroll, { passive: true });
     return () => {
-      document.removeEventListener('mousedown', handleMouseDown);
-      document.removeEventListener('keydown', handleKeyDown);
+      window.removeEventListener('scroll', handleScroll, { capture: true });
+      window.removeEventListener('resize', handleScroll);
     };
   }, [isOpen]);
 
-  // CSS anchor positioning handles placement. JS only constrains max-height/max-width
-  // so tall content scrolls rather than overflows the viewport.
-  const constrainPanel = useCallback(() => {
-    const dialog = dialogRef.current;
-    const container = containerRef.current;
-    if (!dialog || !container) return;
-    const rect = container.getBoundingClientRect();
-    const vw = window.innerWidth;
-    const vh = window.innerHeight;
-    dialog.style.maxHeight = '';
-    dialog.style.maxWidth = '';
-    if (placement === 'bottom') {
-      dialog.style.maxHeight = `${Math.max(0, vh - rect.bottom - GAP * 2)}px`;
-      dialog.style.maxWidth = `${Math.max(0, vw - rect.left - GAP)}px`;
-    } else if (placement === 'top') {
-      dialog.style.maxHeight = `${Math.max(0, rect.top - GAP * 2)}px`;
-      dialog.style.maxWidth = `${Math.max(0, vw - rect.left - GAP)}px`;
-    } else if (placement === 'right') {
-      dialog.style.maxHeight = `${Math.max(0, vh - rect.top - GAP)}px`;
-      dialog.style.maxWidth = `${Math.max(0, vw - rect.right - GAP * 2)}px`;
-    } else {
-      dialog.style.maxHeight = `${Math.max(0, vh - rect.top - GAP)}px`;
-      dialog.style.maxWidth = `${Math.max(0, rect.left - GAP * 2)}px`;
-    }
-  }, [placement]);
-
-  const toggle = useCallback(() => {
-    if (isOpen) {
-      setIsOpen(false);
-    } else {
-      constrainPanel();
-      setIsOpen(true);
-    }
-  }, [isOpen, constrainPanel]);
-
+  // Inject invoker command attrs and accessibility props onto the trigger.
+  // commandfor/command="toggle-popover" replaces the onClick toggle handler —
+  // the browser (or polyfill) calls togglePopover() on the panel, which fires
+  // the toggle event above to sync state.
   const trigger = isValidElement(children)
     ? cloneElement(children as ReactElement<Record<string, unknown>>, {
         'aria-expanded': isOpen,
         'aria-controls': panelId,
         'aria-haspopup': true,
+        commandfor: panelId,
+        command: 'toggle-popover',
         style: {
           ...((children.props as Record<string, unknown>).style as object | undefined),
           anchorName,
         },
-        onClick: (e: MouseEvent) => {
-          toggle();
-          const existingOnClick = (children.props as Record<string, unknown>).onClick;
-          if (typeof existingOnClick === 'function') existingOnClick(e);
-        },
+        // Forward any existing onClick on the child (for custom side-effects).
+        // Do NOT add our own toggle here — commandfor/command handles it to
+        // avoid a double-toggle when both onClick and invoker fire.
+        onClick: (children.props as Record<string, unknown>).onClick as (() => void) | undefined,
       })
     : children;
 
   return (
     <span ref={containerRef} className={cn(css.wrapper, className)}>
       {trigger}
-      <dialog
-        ref={dialogRef}
+      <div
+        ref={panelRef}
         id={panelId}
-        open={isOpen}
+        popover="auto"
         data-placement={placement}
         role={ariaLabel ? 'region' : undefined}
         aria-label={ariaLabel}
@@ -131,7 +115,7 @@ export function Popover({
         style={{ positionAnchor: anchorName }}
       >
         {content}
-      </dialog>
+      </div>
     </span>
   );
 }

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

@@ -2,8 +2,8 @@
   .toastContainer {
     position: fixed;
     inset: unset; /* override UA popover default (inset: 0) */
-    bottom: var(--bds-space_xl);
-    right: var(--bds-space_xl);
+    inset-block-end: var(--bds-space_xl);
+    inset-inline-end: var(--bds-space_xl);
     display: flex;
     flex-direction: column;
     gap: var(--bds-space_m);
@@ -23,7 +23,7 @@
     display: flex;
     align-items: center;
     gap: var(--bds-space_m);
-    min-width: 300px;
+    min-inline-size: 300px;
     animation: slideIn var(--bds-animation_duration--fast) var(--bds-animation_easing);
   }
 
@@ -56,8 +56,8 @@
     align-items: center;
     justify-content: center;
     flex-shrink: 0;
-    width: 1.25rem;
-    height: 1.25rem;
+    inline-size: 1.25rem;
+    block-size: 1.25rem;
     padding: 0;
     background: none;
     border: none;
@@ -66,8 +66,8 @@
   }
 
   .closeButton svg {
-    width: 1rem;
-    height: 1rem;
+    inline-size: 1rem;
+    block-size: 1rem;
   }
 }
 

package/src/components/interaction/form/Checkbox/Checkbox.module.css

@@ -14,8 +14,8 @@
 
   .checkbox {
     margin-block-start: 0.25em;
-    width: var(--inputSize);
-    height: var(--inputSize);
+    inline-size: var(--inputSize);
+    block-size: var(--inputSize);
     color: var(--checkbox_color, var(--bds-color_on-bg));
     border: var(--checkbox_border, none);
     --bdc_color: currentcolor;
@@ -40,10 +40,10 @@
   .checkbox:checked::after {
     content: '';
     position: absolute;
-    left: 0.6em;
-    top: 0.2em;
-    width: 0.5em;
-    height: 1em;
+    inset-inline-start: 0.6em;
+    inset-block-start: 0.2em;
+    inline-size: 0.5em;
+    block-size: 1em;
     border: solid var(--checkbox_color-on-active, var(--bdc-color_on-active));
     border-width: 0 2px 2px 0;
     transform: rotate(45deg);

package/src/components/interaction/form/Checkbox/Checkbox.native.mdx

@@ -0,0 +1,74 @@
+import { Meta, Canvas, ArgTypes } from '@storybook/blocks';
+import * as Stories from './Checkbox.native.stories';
+
+<Meta of={Stories} />
+
+# Checkbox (React Native)
+
+React Native checkbox component with label, optional hint, and error state. Fully controlled — manage checked state via `checked` + `onChange`.
+
+> **Status: alpha** — API may change before stable release.
+
+## Usage
+
+```tsx
+import { Checkbox } from '@boostdev/components';
+import { useState } from 'react';
+
+function Example() {
+  const [checked, setChecked] = useState(false);
+  return (
+    <Checkbox
+      name="terms"
+      label="Accept terms and conditions"
+      checked={checked}
+      onChange={setChecked}
+    />
+  );
+}
+```
+
+## Examples
+
+### Interactive
+<Canvas of={Stories.Interactive} />
+
+### Unchecked
+<Canvas of={Stories.Unchecked} />
+
+### Checked
+<Canvas of={Stories.Checked} />
+
+### With hint
+<Canvas of={Stories.WithHint} />
+
+### With error
+<Canvas of={Stories.WithError} />
+
+### Disabled
+<Canvas of={Stories.Disabled} />
+
+### Disabled + checked
+<Canvas of={Stories.DisabledChecked} />
+
+## Props
+
+<ArgTypes of={Stories} />
+
+## Props reference
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `name` | string | — | Field name (used for accessibility grouping) |
+| `label` | string | — | Visible label text |
+| `checked` | boolean | `false` | Controlled checked state |
+| `onChange` | `(checked: boolean) => void` | — | Called with the new value on press |
+| `disabled` | boolean | `false` | Prevents interaction, reduces opacity |
+| `hint` | string | — | Helper text below the label |
+| `error` | string | — | Error message; shown instead of hint when set |
+
+## Accessibility
+
+- The label, hint, and error are announced together by screen readers
+- `disabled` communicates the disabled state via `accessibilityState`
+- Group related checkboxes using a wrapping `View` with `accessibilityRole="radiogroup"` or a labelled `fieldset` equivalent

package/src/components/interaction/form/Combobox/Combobox.module.css

@@ -12,7 +12,7 @@
 
   .input {
     appearance: none;
-    width: 100%;
+    inline-size: 100%;
     font-family: var(--bds-font_family--body);
     font-size: var(--bds-font_size--body);
     padding: var(--bds-space_s);
@@ -59,18 +59,17 @@
   }
 
   .chevron svg {
-    width: 1rem;
-    height: 1rem;
+    inline-size: 1rem;
+    block-size: 1rem;
   }
 
   .listbox {
     position: absolute;
-    top: calc(100% + var(--bds-space_xxs));
-    left: 0;
-    right: 0;
+    inset-block-start: calc(100% + var(--bds-space_xxs));
+    inset-inline: 0;
     z-index: var(--bds-z-index_dropdown);
-    max-height: 15rem;
-    overflow-y: auto;
+    max-block-size: 15rem;
+    overflow-block: auto;
     list-style: none;
     margin: 0;
     padding: var(--bds-space_xxs) 0;

package/src/components/interaction/form/FileInput/FileInput.module.css

@@ -48,8 +48,8 @@
   }
 
   .icon {
-    width: 2rem;
-    height: 2rem;
+    inline-size: 2rem;
+    block-size: 2rem;
     flex-shrink: 0;
   }
 
@@ -70,8 +70,8 @@
 
   .hiddenInput {
     position: absolute;
-    width: 1px;
-    height: 1px;
+    inline-size: 1px;
+    block-size: 1px;
     overflow: hidden;
     clip: rect(0, 0, 0, 0);
     white-space: nowrap;

package/src/components/interaction/form/NumberInput/NumberInput.module.css

@@ -38,7 +38,7 @@
     padding: var(--bds-space_s);
     background: transparent;
     color: var(--numberInput_color, var(--bds-color_on-bg));
-    min-width: 0;
+    min-inline-size: 0;
     appearance: textfield;
   }
 

package/src/components/interaction/form/Radio/Radio.module.css

@@ -29,8 +29,8 @@
   .radio {
     flex-shrink: 0;
     margin-block-start: 0.2em;
-    width: var(--inputSize);
-    height: var(--inputSize);
+    inline-size: var(--inputSize);
+    block-size: var(--inputSize);
     color: var(--radio_color, var(--bds-color_on-bg));
     border: var(--radio_border, none);
     --bdc_color: currentcolor;
@@ -55,11 +55,11 @@
   .radio:checked::after {
     content: '';
     position: absolute;
-    left: 50%;
-    top: 50%;
+    inset-inline-start: 50%;
+    inset-block-start: 50%;
     transform: translate(-50%, -50%);
-    width: 0.4em;
-    height: 0.4em;
+    inline-size: 0.4em;
+    block-size: 0.4em;
     border-radius: 50%;
     background-color: var(--radio_color-on-active, var(--bdc-color_on-active));
   }

package/src/components/interaction/form/SegmentedControl/SegmentedControl.module.css

@@ -12,10 +12,9 @@
 
   .thumb {
     position: absolute;
-    top: var(--bds-space_xxxs);
-    bottom: var(--bds-space_xxxs);
-    left: var(--bds-space_xxxs);
-    width: calc((100% - 2 * var(--bds-space_xxxs)) / var(--control_count, 1));
+    inset-block: var(--bds-space_xxxs);
+    inset-inline-start: var(--bds-space_xxxs);
+    inline-size: calc((100% - 2 * var(--bds-space_xxxs)) / var(--control_count, 1));
     border-radius: var(--bds-border_radius--s);
     background-color: var(--control_thumb-bg, var(--bds-color_bg));
     box-shadow: var(--bds-shadow_s);
@@ -43,8 +42,8 @@
   .radio {
     position: absolute;
     opacity: 0;
-    width: 0;
-    height: 0;
+    inline-size: 0;
+    block-size: 0;
     margin: 0;
   }
 

package/src/components/interaction/form/Select/Select.module.css

@@ -12,7 +12,7 @@
 
   .select {
     appearance: none;
-    width: 100%;
+    inline-size: 100%;
     font-family: var(--bds-font_family--body);
     font-size: var(--bds-font_size--body);
     padding: var(--bds-space_s);
@@ -60,7 +60,7 @@
   }
 
   .chevron svg {
-    width: 1rem;
-    height: 1rem;
+    inline-size: 1rem;
+    block-size: 1rem;
   }
 }

package/src/components/interaction/form/Slider/Slider.module.css

@@ -24,8 +24,8 @@
 
     color: var(--slider_color, var(--bds-color_on-bg));
     appearance: none;
-    width: 100%;
-    height: var(--slider_track-height);
+    inline-size: 100%;
+    block-size: var(--slider_track-height);
     border-radius: 999px;
     background: linear-gradient(
       to right,
@@ -52,8 +52,8 @@
   /* Thumb — Webkit */
   .slider::-webkit-slider-thumb {
     appearance: none;
-    width: var(--slider_thumb-size);
-    height: var(--slider_thumb-size);
+    inline-size: var(--slider_thumb-size);
+    block-size: var(--slider_thumb-size);
     border-radius: 50%;
     background-color: var(--slider_color-active, var(--bdc-color_active));
     box-shadow: var(--bds-shadow_s);
@@ -63,8 +63,8 @@
 
   /* Thumb — Firefox */
   .slider::-moz-range-thumb {
-    width: var(--slider_thumb-size);
-    height: var(--slider_thumb-size);
+    inline-size: var(--slider_thumb-size);
+    block-size: var(--slider_thumb-size);
     border: none;
     border-radius: 50%;
     background-color: var(--slider_color-active, var(--bdc-color_active));

package/src/components/interaction/form/Switch/Switch.module.css

@@ -25,8 +25,8 @@
     display: inline-flex;
     align-items: center;
     flex-shrink: 0;
-    width: var(--switch_track-width);
-    height: var(--switch_track-height);
+    inline-size: var(--switch_track-width);
+    block-size: var(--switch_track-height);
   }
 
   /* Real input — invisible overlay to capture pointer/keyboard events */
@@ -35,8 +35,8 @@
     inset: 0;
     appearance: none;
     opacity: 0;
-    width: 100%;
-    height: 100%;
+    inline-size: 100%;
+    block-size: 100%;
     margin: 0;
     cursor: pointer;
     z-index: 1;
@@ -50,8 +50,8 @@
   .track {
     display: inline-flex;
     align-items: center;
-    width: var(--switch_track-width);
-    height: var(--switch_track-height);
+    inline-size: var(--switch_track-width);
+    block-size: var(--switch_track-height);
     border-radius: 999px;
     background-color: var(--switch_track-bg, var(--bds-color_grey--subtle));
     padding-inline: var(--switch_track-pad);
@@ -69,8 +69,8 @@
   /* Thumb */
   .thumb {
     display: block;
-    width: var(--switch_thumb-size);
-    height: var(--switch_thumb-size);
+    inline-size: var(--switch_thumb-size);
+    block-size: var(--switch_thumb-size);
     border-radius: 50%;
     background-color: var(--switch_thumb-bg, var(--bds-color_grey));
     box-shadow: var(--bds-shadow_s);

package/src/components/interaction/form/Textarea/Textarea.module.css

@@ -20,7 +20,7 @@
     background-color: var(--textarea_color_bg, var(--bds-color_bg));
     color: var(--textarea_color, var(--bds-color_on-bg));
     resize: vertical;
-    min-height: calc(var(--bds-space_m) * 5);
+    min-block-size: calc(var(--bds-space_m) * 5);
     transition: --bdc_color var(--bds-animation_transition-duration) var(--bds-animation_easing),
                 background-color var(--bds-animation_transition-duration) var(--bds-animation_easing);
   }

package/src/components/layout/IconWrapper/IconWrapper.module.css

@@ -1,7 +1,7 @@
 @layer component {
   .wrapper {
-    width: 2em;
-    height: 2em;
+    inline-size: 2em;
+    block-size: 2em;
     font-size: 3em;
     border-radius: 50%;
     display: flex;

package/src/components/ui/Accordion/Accordion.module.css

@@ -13,11 +13,11 @@
   }
 
   .item {
-    border-bottom: 1px solid var(--bds-color_bg--subtle);
+    border-block-end: 1px solid var(--bds-color_bg--subtle);
   }
 
   .item:last-child {
-    border-bottom: none;
+    border-block-end: none;
   }
 
   .heading {
@@ -29,7 +29,7 @@
     display: flex;
     align-items: center;
     justify-content: space-between;
-    width: 100%;
+    inline-size: 100%;
     padding: var(--bds-space_m);
     font-family: var(--bds-font_family--body);
     font-size: var(--bds-font_size--body);
@@ -63,8 +63,8 @@
   }
 
   .chevron {
-    width: 1.25rem;
-    height: 1.25rem;
+    inline-size: 1.25rem;
+    block-size: 1.25rem;
     flex-shrink: 0;
     transition: transform var(--bds-animation_transition-duration) var(--bds-animation_easing);
   }

package/src/components/ui/Alert/Alert.native.mdx

@@ -0,0 +1,62 @@
+import { Meta, Canvas, ArgTypes } from '@storybook/blocks';
+import * as Stories from './Alert.native.stories';
+
+<Meta of={Stories} />
+
+# Alert (React Native)
+
+React Native alert component for inline status messages. Supports four semantic variants, an optional title, and a dismissible mode — matching the web `Alert` API.
+
+> **Status: alpha** — API may change before stable release.
+
+## Usage
+
+```tsx
+import { Alert } from '@boostdev/components';
+
+<Alert variant="success" title="Saved">
+  Your changes have been saved successfully.
+</Alert>
+```
+
+## Examples
+
+### All variants
+<Canvas of={Stories.AllVariants} />
+
+### Info
+<Canvas of={Stories.Info} />
+
+### Success
+<Canvas of={Stories.Success} />
+
+### Warning
+<Canvas of={Stories.Warning} />
+
+### Error
+<Canvas of={Stories.Error} />
+
+### With title
+<Canvas of={Stories.WithTitle} />
+
+### Dismissible
+<Canvas of={Stories.Dismissible} />
+
+## Props
+
+<ArgTypes of={Stories} />
+
+## Props reference
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variant` | `"info" \| "success" \| "warning" \| "error"` | `"info"` | Semantic colour and icon |
+| `title` | string | — | Optional heading above body content |
+| `onDismiss` | `() => void` | — | When set, a dismiss button is shown; called on press |
+| `children` | `ReactNode` | — | Alert body content |
+
+## Accessibility
+
+- `error` and `warning` variants announce content as `assertive`
+- `info` and `success` variants announce content as `polite`
+- The dismiss button has a descriptive accessibility label