@k2b/ui 0.38.0 → 0.39.0

package/dist/types/actions/Dropdown.d.ts

@@ -2,6 +2,12 @@ import { type JSX } from "solid-js";
 import { type TooltipPlacement } from "../feedback/Tooltip";
 import { type ButtonProps, type ButtonSize, type ButtonVariant } from "./Button";
 export type DropdownPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left" | "right-start";
+/** Where a menu opened without its trigger appears: an element, or any box such as a point inside one. */
+export type DropdownAnchor = {
+    getBoundingClientRect(): Pick<DOMRect, "left" | "top" | "right" | "bottom">;
+};
+/** Where focus returns as a menu opened by `openAt` closes, read at that moment when it is a function. */
+export type DropdownReturnFocus = HTMLElement | (() => HTMLElement | undefined);
 export type DropdownActionBase = {
     class?: string;
     disabled?: boolean;
@@ -109,6 +115,14 @@ export type DropdownProps = {
      * then carries each row's trigger, not each row's entries. Fixed for the menu's lifetime.
      */
     lazy?: boolean;
+    /**
+     * Receives `open`, which shows the menu without its trigger beside `anchor`, as for a context menu, a key or a
+     * grip. Focus returns to `returnFocus` when the menu or sheet closes; pass a function when an entry can move the
+     * place focus belongs to. Phones get the sheet as from the trigger.
+     */
+    openAt?: (open: (anchor: DropdownAnchor, returnFocus?: DropdownReturnFocus) => void) => void;
+    /** Receives `close`, which closes the menu or sheet and returns focus. */
+    closeWith?: (close: () => void) => void;
 };
 export type DropdownTriggerProps = Omit<ButtonProps, "aria-controls" | "aria-expanded" | "aria-haspopup" | "children" | "disabled" | "onClick" | "onKeyDown"> & {
     children: JSX.Element;
@@ -141,7 +155,7 @@ export type DropdownItemProps = {
     onSelect?: () => void;
     class?: string;
 };
-export declare const dropdownPosition: (trigger: DOMRect, menu: Pick<DOMRect, "width" | "height">, position: DropdownPosition, viewport: {
+export declare const dropdownPosition: (trigger: Pick<DOMRect, "left" | "top" | "right" | "bottom">, menu: Pick<DOMRect, "width" | "height">, position: DropdownPosition, viewport: {
     width: number;
     height: number;
 }, gap?: number) => {

package/dist/types/actions/Toolbar.d.ts

@@ -13,7 +13,10 @@ export type ToolbarActionProps = {
     label: string;
     /** Icon class, such as "ti ti-archive". */
     icon: string;
-    /** Shortcut hint, tooltip suffix, and aria-keyshortcuts; does not register a shortcut handler. */
+    /**
+     * Shortcut hint below the icon, tooltip suffix, and aria-keyshortcuts; does not register a shortcut handler.
+     * SelectionToolbar's compact actions keep only the tooltip suffix and aria-keyshortcuts.
+     */
     keys?: string;
     /** 1 is most important. Larger numbers move first; ties move later DOM actions first. Omit to keep fixed. */
     priority?: number;
@@ -39,5 +42,7 @@ type ToolbarComponent = ((props: ToolbarProps) => JSX.Element) & {
     Separator: (props: ToolbarSeparatorProps) => JSX.Element;
     Spacer: () => JSX.Element;
 };
+/** False where actions are icon-sized, such as SelectionToolbar: no room below the icon for a hint. Package-internal. */
+export declare const ToolbarHintsContext: import("solid-js").Context<boolean>;
 export declare const Toolbar: ToolbarComponent;
 export default Toolbar;

package/dist/types/actions/index.d.ts

@@ -8,7 +8,7 @@ export type { DisclosureProps } from "./Disclosure";
 export { Disclosure } from "./Disclosure";
 export type { DragPayload, DragSourceProps, DropTargetProps } from "./DragAndDrop";
 export { activeDrag, DragSource, DropTarget, useKeyboardDrag } from "./DragAndDrop";
-export type { DropdownAction, DropdownActionBase, DropdownChoice, DropdownItemProps, DropdownPosition, DropdownProps, DropdownSection, DropdownTriggerProps, } from "./Dropdown";
+export type { DropdownAction, DropdownActionBase, DropdownAnchor, DropdownChoice, DropdownItemProps, DropdownPosition, DropdownProps, DropdownReturnFocus, DropdownSection, DropdownTriggerProps, } from "./Dropdown";
 export { Dropdown, DropdownItem, dropdownPosition } from "./Dropdown";
 export type { FilterChipOption, FilterChipProps, FilterChipSection, FilterToggleProps } from "./FilterChip";
 export { FilterChip, FilterToggle } from "./FilterChip";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2b/ui",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Production-ready components for SolidJS applications.",
   "repository": {
     "type": "git",