@panphora/bevel 0.3.1 → 0.3.2

package/bevel.js

@@ -717,10 +717,10 @@
       setExpanded(root, true);
       if (!root.matches(".bevel-combobox__listbox") && (source !== "external" || !document.activeElement || document.activeElement === document.body)) {
         let interrupted = false;
-        const interrupt = () => { interrupted = true; };
-        document.addEventListener("keydown", interrupt, true); document.addEventListener("pointerdown", interrupt, true);
+        const interrupt = () => { interrupted = true; }, focusInside = event => { if (root.contains(event.target)) interrupted = true; };
+        document.addEventListener("keydown", interrupt, true); document.addEventListener("pointerdown", interrupt, true); document.addEventListener("focusin", focusInside, true);
         requestAnimationFrame(() => {
-          document.removeEventListener("keydown", interrupt, true); document.removeEventListener("pointerdown", interrupt, true);
+          document.removeEventListener("keydown", interrupt, true); document.removeEventListener("pointerdown", interrupt, true); document.removeEventListener("focusin", focusInside, true);
           if (!interrupted) (root.querySelector("[autofocus]") || focusable(root))?.focus();
         });
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@panphora/bevel",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Beveled controls in an editorial page. One stylesheet, one script, no build.",
   "license": "MIT-0",
   "author": "David Miranda",

package/react/README.md

@@ -64,6 +64,8 @@ Field and Form retain native name, form, reset, validity and submission behavior
 
 `AppShell.SidebarToggle` is labelled Collapse sidebar or Expand sidebar unless you pass `label`. In classic markup, `data-bevel-label-collapse` and `data-bevel-label-expand` on the `[data-bevel-shell-collapse]` button replace those two labels.
 
+Base UI defaults `closeOnClick` to `false` on `Menu.RadioItem`, `Menu.CheckboxItem` and `Menu.LinkItem`, while `Menu.Item` defaults to `true`. When picking a radio item, client-routed link, download link or new-tab link should dismiss the popup instead of leaving `aria-expanded="true"` on the trigger, pass `closeOnClick` at the call site rather than changing Bevel's `Menu` wrapper, and assert in tests that the menu closed.
+
 ## Dialogs
 
 ```tsx
@@ -118,6 +120,8 @@ FilterBuilder edits a draft and validates before Apply. Its shared filter model
 
 Sortable uses stable string IDs and supports pointer movement and arrows/Home/End. SplitPanes uses a percentage ratio, measured pixel minimums, a keyboard separator and mobile stacking. Escape or pointer cancellation discards the preview. KanbanBoard receives ordered column card IDs and immutable card records. Its inspector, editor, checklist, archive controls and explicit Move operation use application callbacks. Filtered boards disable ambiguous dragging while preserving explicit moves. Supply `today` as an ISO date when due styling is needed. New cards, checklist items, filter rules and accepted uploads receive random UUIDs that remain independent of React tree IDs after reload.
 
+In native HTML5 drag and drop (including `FileTree` and `useFileTreeOutsideDrop`), Chrome intersects the source's `effectAllowed` with the target's `dropEffect` and silently cancels the drop with `dragend.dropEffect === "none"` when they do not overlap, even after `dragover` calls `preventDefault()`. Set `dropEffect = transfer.types.includes('Files') ? 'copy' : 'move'` on the drop target instead of hardcoding one value, and verify drop wiring with real pointer input in a browser because synthetic jsdom `DataTransfer` tests skip effect negotiation.
+
 ## Forms, drafts and feedback
 
 `FormErrorSummary` accepts ordered `{ id, message }` errors. `nativeFormErrors(form)` collects invalid controls with stable IDs from that form. Increment `focusToken` for each failed submission to focus the summary, or pass `focus="first-field"`. Rendering existing server errors alone does not move focus. Error links retain the control's existing descriptions.
@@ -130,6 +134,10 @@ SaveStatus receives explicit clean/dirty/saving/saved/error state. A new eventKe
 
 Tooltip follows [Base UI's visual hint contract](https://base-ui.com/react/components/tooltip). Give its trigger a matching accessible name. Put essential descriptions in inline text or Popover; Tooltip.Popup does not add a tooltip role or an automatic accessible description.
 
+`<Field.Error>{problem}</Field.Error>` renders nothing unless `match` is passed, because Base UI otherwise gates it on native browser validity failures and ignores custom validation state. Always render custom field errors as `<Field.Error match role="alert">{problem}</Field.Error>` so the message mounts and wires `aria-describedby`, and test validation by asserting the error is present for bad input rather than absent for good input.
+
+A `Toast` with `priority: 'high'` sets `aria-hidden="true"` on its popup until focused, so `getByRole` queries for `dialog` or `alertdialog` find nothing even while the toast is visible on screen (`priority: 'high'` also leaves auto-dismiss unchanged, gated on timeout greater than zero). Assert high-priority toast messages through the separate `role="alert"` live region rendered by the provider.
+
 ## Optional integrations and recipes
 
 These entries are excluded from the root barrel and basic component graphs. They accept consumer supplied peers and do not fetch or install them.