@boostdev/design-system-components 1.1.0 → 1.1.1

package/dist/web-components.d.ts

@@ -235,6 +235,7 @@ declare class BdsPopover extends LitElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     private _onKeydown;
+    private _onCommand;
     private _onOutsideClick;
     private _toggle;
     private _open;

package/dist/web-components.js

@@ -1719,15 +1719,23 @@ var BdsPopover = class extends i3 {
     this.style.setProperty("--bds-popover-anchor", this._anchorName);
     document.addEventListener("keydown", this._onKeydown);
     document.addEventListener("mousedown", this._onOutsideClick);
+    this.addEventListener("command", this._onCommand);
   }
   disconnectedCallback() {
     super.disconnectedCallback();
     document.removeEventListener("keydown", this._onKeydown);
     document.removeEventListener("mousedown", this._onOutsideClick);
+    this.removeEventListener("command", this._onCommand);
   }
   _onKeydown = (e3) => {
     if (this.open && e3.key === "Escape") this._close();
   };
+  _onCommand = (e3) => {
+    const command = e3.command;
+    if (command === "--toggle") this._toggle();
+    else if (command === "--open") this._open();
+    else if (command === "--close") this._close();
+  };
   _onOutsideClick = (e3) => {
     if (this.open && !this.contains(e3.target)) this._close();
   };
@@ -1739,10 +1747,12 @@ var BdsPopover = class extends i3 {
     }
   }
   _open() {
+    if (this.open) return;
     this.open = true;
     this.dispatchEvent(new CustomEvent("bds-open", { bubbles: true, composed: true }));
   }
   _close() {
+    if (!this.open) return;
     this.open = false;
     this.dispatchEvent(new CustomEvent("bds-close", { bubbles: true, composed: true }));
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boostdev/design-system-components",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "BoostDev React component library: accessible, token-driven components built on @boostdev/design-system-foundation",
   "keywords": [
     "React",

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

@@ -41,7 +41,7 @@
     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;

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/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.tsx

@@ -1,4 +1,9 @@
 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';
@@ -13,14 +18,18 @@ export interface CommandItem {
 }
 
 interface CommandProps extends WithClassName {
+  id?: string;
   isOpen: boolean;
+  onOpen?: () => void;
   onClose: () => void;
   items: CommandItem[];
   placeholder?: 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"

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

@@ -12,29 +12,26 @@
     background-color: var(--dialog_color ,var(--bds-color_grey--subtle));
     color: var(--dialog_on-color, var(--bds-color_on-grey--subtle));
     padding: var(--bds-space_l);
-    max-width: 90svw;
-    max-height: 90svh;
+    max-inline-size: 90svw;
+    max-block-size: 90svh;
     overflow: visible;
   }
 
   .dialogContent {
     display: grid;
     gap: var(--bds-grid_gap);
-    overflow-y: auto;
-    min-height: 0;
+    overflow-block: auto;
+    min-block-size: 0;
     flex: 1;
   }
 
-  .closeForm {
+  .closeButton {
+    all: unset;
     position: absolute;
     inset-block-start: -1em;
     inset-inline-end: -1em;
-  }
-
-  .closeButton {
-    all: unset;
-    width: 2em;
-    height: 2em;
+    inline-size: 2em;
+    block-size: 2em;
     display: flex;
     align-items: center;
     justify-content: center;
@@ -50,8 +47,8 @@
   }
 
   .closeButton svg {
-    width: 1.25em;
-    height: 1.25em;
+    inline-size: 1.25em;
+    block-size: 1.25em;
   }
 
   .dialog::backdrop {

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

@@ -29,7 +29,26 @@ describe('Dialog', () => {
     expect(screen.getByRole('button', { name: /close dialog/i })).toBeInTheDocument();
   });
 
-  it('calls onClose when close button is clicked', async () => {
+  it('close button is type="button"', () => {
+    render(<Dialog isOpen><span>Content</span></Dialog>);
+    expect(screen.getByRole('button', { name: /close dialog/i })).toHaveAttribute('type', 'button');
+  });
+
+  it('close button always uses commandfor/command', () => {
+    render(<Dialog isOpen><span>Content</span></Dialog>);
+    const closeBtn = screen.getByRole('button', { name: /close dialog/i });
+    expect(closeBtn).toHaveAttribute('commandfor');
+    expect(closeBtn).toHaveAttribute('command', 'close');
+  });
+
+  it('close button commandfor matches dialog id', () => {
+    render(<Dialog id="my-dialog" isOpen><span>Content</span></Dialog>);
+    const closeBtn = screen.getByRole('button', { name: /close dialog/i });
+    expect(closeBtn).toHaveAttribute('commandfor', 'my-dialog');
+    expect(document.querySelector('dialog')).toHaveAttribute('id', 'my-dialog');
+  });
+
+  it('close button click via polyfill calls onClose', async () => {
     const user = userEvent.setup();
     const onClose = vi.fn();
     render(<Dialog isOpen onClose={onClose}><span>Content</span></Dialog>);
@@ -42,6 +61,12 @@ describe('Dialog', () => {
     expect(HTMLDialogElement.prototype.showModal).not.toHaveBeenCalled();
   });
 
+  it('does not call showModal again when dialog is already open', () => {
+    const { rerender } = render(<Dialog isOpen><span>Content</span></Dialog>);
+    rerender(<Dialog isOpen><span>Content</span></Dialog>);
+    expect(HTMLDialogElement.prototype.showModal).toHaveBeenCalledTimes(1);
+  });
+
   it('locks body scroll when open', () => {
     render(<Dialog isOpen><span>Content</span></Dialog>);
     expect(document.body.style.overflow).toBe('hidden');
@@ -77,4 +102,31 @@ describe('Dialog', () => {
 
     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(<Dialog onOpen={onOpen}><span>Content</span></Dialog>);
+      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(<Dialog isOpen onClose={onClose}><span>Content</span></Dialog>);
+      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/Dialog/Dialog.stories.tsx

@@ -33,3 +33,20 @@ export const Interactive: Story = {
     );
   },
 };
+
+// Open and close using the Invoker Commands API — no JS event handlers needed.
+// The browser wires up the buttons to the dialog natively via commandfor/command.
+export const InvokerCommands: Story = {
+  render: () => (
+    <>
+      <Button type="button" commandfor="invoker-dialog" command="show-modal">
+        Open Dialog (no JS)
+      </Button>
+      <Dialog id="invoker-dialog">
+        <h2>Invoker Dialog</h2>
+        <p>This dialog was opened with a declarative HTML invoker command — no onClick needed.</p>
+        <p>The close button (×) inside also uses an invoker command.</p>
+      </Dialog>
+    </>
+  ),
+};

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

@@ -1,4 +1,8 @@
-import { ReactNode, useEffect, useRef } from 'react';
+import { ReactNode, useEffect, useId, useRef } from 'react';
+import { installInvokerCommandsPolyfill } from '../../../polyfill-invoker-commands';
+
+// Install once at module load — no-op if native support is present.
+installInvokerCommandsPolyfill();
 
 const FOCUSABLE_SELECTOR = 'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])';
 import css from './Dialog.module.css';
@@ -7,22 +11,28 @@ import type { WithClassName } from '../../../types';
 
 interface DialogProps extends WithClassName {
   children: ReactNode;
+  id?: string;
   isOpen?: boolean;
+  onOpen?: () => void;
   onClose?: () => void;
 }
 
-export function Dialog({ children, isOpen = false, className, onClose }: DialogProps) {
+export function Dialog({ children, id: idProp, isOpen = false, className, onOpen, onClose }: DialogProps) {
+  const generatedId = useId();
+  const id = idProp ?? generatedId;
+
   const dialogRef = useRef<HTMLDialogElement | null>(null);
   const triggerRef = useRef<Element | null>(null);
 
+  // Controlled mode: open/close in response to the isOpen prop.
   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';
-    } else if (dialog.open) {
+    } else if (!isOpen && dialog.open) {
       dialog.close();
       document.body.style.overflow = '';
       (triggerRef.current as HTMLElement | null)?.focus();
@@ -32,6 +42,30 @@ export function Dialog({ children, isOpen = false, className, onClose }: DialogP
     };
   }, [isOpen]);
 
+  // Invoker Commands API: sync state when the dialog is opened or closed via
+  // a <button commandfor="id" command="show-modal|close"> without JS.
+  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';
+        onOpen?.();
+      } else if (e.command === 'close') {
+        document.body.style.overflow = '';
+        // Defer focus restoration: the dialog is still open when the command
+        // event fires (the action runs after), so focusing outside would be
+        // blocked by the focus-trap. setTimeout defers until after close.
+        const trigger = triggerRef.current;
+        setTimeout(() => (trigger as HTMLElement | null)?.focus(), 0);
+        onClose?.();
+      }
+    };
+    dialog.addEventListener('command', handleCommand);
+    return () => dialog.removeEventListener('command', handleCommand);
+  }, [onOpen, onClose]);
+
   const handleBackdropClick = (e: React.MouseEvent<HTMLDialogElement>) => {
     if (e.target === dialogRef.current) onClose?.();
   };
@@ -59,24 +93,24 @@ export function Dialog({ children, isOpen = false, className, onClose }: DialogP
   return (
     <dialog
       ref={dialogRef}
+      id={id}
       className={cn(className, css.dialog)}
       aria-modal="true"
       onClick={handleBackdropClick}
       onCancel={handleCancel}
       onKeyDown={handleKeyDown}
     >
-      <form method="dialog" className={css.closeForm}>
-        <button
-          type="submit"
-          className={css.closeButton}
-          onClick={onClose}
-          aria-label="Close dialog"
-        >
-          <svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
-            <path strokeLinecap="round" strokeLinejoin="round" d="M18 6L6 18M6 6l12 12" />
-          </svg>
-        </button>
-      </form>
+      <button
+        type="button"
+        className={css.closeButton}
+        commandfor={id}
+        command="close"
+        aria-label="Close dialog"
+      >
+        <svg aria-hidden="true" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
+          <path strokeLinecap="round" strokeLinejoin="round" d="M18 6L6 18M6 6l12 12" />
+        </svg>
+      </button>
       <div className={css.dialogContent}>
         {children}
       </div>

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

@@ -4,10 +4,10 @@
     inset: 0;
     margin: 0;
     padding: 0;
-    width: 100%;
-    max-width: 100%;
-    height: 100%;
-    max-height: 100%;
+    inline-size: 100%;
+    max-inline-size: 100%;
+    block-size: 100%;
+    max-block-size: 100%;
     border: none;
     background: transparent;
     overflow: hidden;
@@ -23,8 +23,8 @@
     inset-block: 0;
     display: flex;
     flex-direction: column;
-    width: min(28rem, 90vw);
-    height: 100%;
+    inline-size: min(28rem, 90vw);
+    block-size: 100%;
     background-color: var(--drawer_color, var(--bds-color_bg));
     color: var(--drawer_on-color, var(--bds-color_on-bg));
     box-shadow: var(--bds-shadow_xl);
@@ -54,16 +54,16 @@
     display: flex;
     align-items: center;
     justify-content: center;
-    width: 2rem;
-    height: 2rem;
+    inline-size: 2rem;
+    block-size: 2rem;
     border-radius: 50%;
     cursor: pointer;
     transition: var(--bds-animation_transition);
   }
 
   .closeButton svg {
-    width: 1.25rem;
-    height: 1.25rem;
+    inline-size: 1.25rem;
+    block-size: 1.25rem;
   }
 
   .closeButton:focus-visible {
@@ -79,7 +79,7 @@
 
   .body {
     flex: 1;
-    overflow-y: auto;
+    overflow-block: auto;
     padding: var(--bds-space_l);
     display: flex;
     flex-direction: column;