@k2b/ui 0.38.1 → 0.40.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/dist/types/layout/AppWorkspace.d.ts

@@ -46,6 +46,14 @@ export type AppWorkspaceProps = {
     layoutState?: () => AppWorkspaceLayoutState | null | undefined;
     /** Called with the full layout whenever a resize settles. Persist it here. */
     onLayoutChange?: (state: AppWorkspaceLayoutState) => void;
+    /**
+     * `false` draws no head row. The application then shows the page's title itself and gives people the sidebar and
+     * Detail buttons the head would hold: a control with `data-app-workspace-sidebar-toggle` (it opens the overlay
+     * sidebar, and shows or hides a sidebar with `onHiddenChange` where it is a column) and, for each Detail with
+     * `toggle={false}`, a control with `data-app-workspace-detail-toggle` and `aria-controls` set to
+     * `appWorkspaceDetailElementId(id)`. The controller runs both and keeps their `aria-expanded` current.
+     */
+    head?: false;
     /**
      * Opt out of the built-in controller. Only needed when the application calls
      * `installAppWorkspaceController` itself — installing twice would double up
@@ -118,6 +126,12 @@ export type AppWorkspaceDetailProps = {
     open: boolean;
     /** Keeps the shared head control reachable while closed; set the app's existing open state synchronously. */
     onOpen?: () => void;
+    /**
+     * `false` draws no Details button of the workspace's own: the application gives one with
+     * `data-app-workspace-detail-toggle` and `aria-controls` set to `appWorkspaceDetailElementId(id)`, as with
+     * `AppWorkspace head={false}`.
+     */
+    toggle?: false;
     /** Whether the current object may show details. False disables reopening and hides the panel. */
     available?: boolean;
     /**

package/dist/types/layout/app-workspace-controller.d.ts

@@ -11,6 +11,8 @@ export declare const parkWorkspaceDetailDrawers: (root?: ParentNode) => void;
  * stays application state, so the controller only requests the change.
  */
 export declare const APP_WORKSPACE_SIDEBAR_HIDE_EVENT = "k2b-app-workspace-sidebar-hide";
+/** Asks the owning `AppWorkspace.Sidebar` to show again; its `onHiddenChange` decides. */
+export declare const APP_WORKSPACE_SIDEBAR_SHOW_EVENT = "k2b-app-workspace-sidebar-show";
 /** Asks the owning Detail to reopen its current available object. */
 export declare const APP_WORKSPACE_DETAIL_OPEN_EVENT = "k2b-app-workspace-detail-open";
 /** Asks the owning `AppWorkspace.Detail` to close; its `onClose` decides. */

package/package.json

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