@zvk/ui 0.1.3 → 0.1.6

package/dist/components/dropdown-menu/dropdown-menu.js

@@ -7,8 +7,11 @@ import { useControllableState } from "../../hooks/use-controllable-state.js";
 import { Portal } from "../../internal/portal/index.js";
 import { DismissableLayer } from "../../internal/dismissable-layer/dismissable-layer.js";
 import { useFloatingPosition } from "../../internal/floating/index.js";
+import { placementFromSideAlign, placementParts } from "../../internal/floating/placement-aliases.js";
+import { Slot } from "../../internal/slot/index.js";
 const defaultContentPositioning = {
     sideOffset: 8,
+    alignOffset: 0,
     collisionPadding: 0,
     matchTriggerWidth: false
 };
@@ -35,6 +38,18 @@ function composeRefs(...refs) {
 function filterEnabledItems(items) {
     return items.filter((item) => !item.disabled && item.ref !== null);
 }
+function setComposedRef(internalRef, externalRef, node) {
+    internalRef.current = node;
+    if (typeof externalRef === "function") {
+        externalRef(node);
+    }
+    else if (externalRef !== undefined && externalRef !== null) {
+        externalRef.current = node;
+    }
+}
+function isActivationKey(key) {
+    return key === " " || key === "Space" || key === "Enter" || key === "Spacebar";
+}
 const DropdownMenuRadioGroupContext = React.createContext(null);
 function DropdownMenuRoot({ children, className, container, defaultOpen = false, onOpenChange, open: openProp, placement = "bottom", sideOffset = 8, collisionPadding = 0, matchTriggerWidth = false, ...props }) {
     const [open, setOpen] = useControllableState({
@@ -51,14 +66,16 @@ function DropdownMenuRoot({ children, className, container, defaultOpen = false,
     const wasOpenRef = React.useRef(false);
     const [contentPositioning, setContentPositioning] = React.useState({
         sideOffset,
+        alignOffset: defaultContentPositioning.alignOffset,
         collisionPadding,
         matchTriggerWidth
     });
     const floating = useFloatingPosition({
         open,
-        placement,
+        placement: contentPositioning.placement ?? placement,
         strategy: "absolute",
         offset: contentPositioning.sideOffset,
+        alignmentOffset: contentPositioning.alignOffset,
         collisionPadding: contentPositioning.collisionPadding,
         matchReferenceWidth: contentPositioning.matchTriggerWidth
     });
@@ -116,32 +133,37 @@ function DropdownMenuRoot({ children, className, container, defaultOpen = false,
             triggerRef,
             referenceRef: floating.referenceRef,
             floatingRef: floating.floatingRef,
+            floatingPlacement: floating.placement,
             floatingStyle: floating.floatingStyle,
             getEnabledItems,
             registerItem,
             unregisterItem,
             ...(container === undefined ? {} : { container })
-        }, children: _jsx("div", { ...props, className: cn("liano-dropdown-menu", className), "data-state": open ? "open" : "closed", children: children }) }));
+        }, children: _jsx("div", { ...props, className: cn("zvk-ui-dropdown-menu", className), "data-state": open ? "open" : "closed", children: children }) }));
 }
-function DropdownMenuTrigger({ className, disabled, onClick, ref, type = "button", ...props }) {
+function DropdownMenuTrigger({ asChild = false, className, disabled, onClick, ref, type = "button", ...props }) {
     const { contentId, open, setOpen, triggerRef, triggerId, referenceRef, getEnabledItems } = useDropdownMenuContext("DropdownMenu.Trigger");
-    return (_jsx("button", { ...props, ref: composeRefs(ref, triggerRef, referenceRef), type: type, disabled: disabled, id: triggerId, role: "button", "aria-haspopup": "menu", "aria-expanded": open ? "true" : "false", "aria-controls": contentId, className: cn("liano-dropdown-menu__trigger", className), onClick: composeEventHandlers(onClick, () => {
-            if (disabled) {
-                return;
-            }
-            const nextOpen = !open;
-            setOpen(nextOpen);
-            if (!nextOpen) {
-                return;
-            }
-            queueMicrotask(() => {
-                const first = getEnabledItems()[0];
-                first?.ref?.focus();
-            });
-        }) }));
+    const handleClick = () => {
+        if (disabled) {
+            return;
+        }
+        const nextOpen = !open;
+        setOpen(nextOpen);
+        if (!nextOpen) {
+            return;
+        }
+        queueMicrotask(() => {
+            const first = getEnabledItems()[0];
+            first?.ref?.focus();
+        });
+    };
+    if (asChild) {
+        return (_jsx(Slot, { ...props, ref: composeRefs(ref, triggerRef, referenceRef), id: triggerId, "aria-controls": contentId, "aria-disabled": disabled ? true : undefined, "aria-expanded": open ? "true" : "false", "aria-haspopup": "menu", className: cn("zvk-ui-dropdown-menu__trigger", className), "data-disabled": disabled ? "true" : undefined, "data-state": open ? "open" : "closed", onClick: composeEventHandlers(onClick, handleClick), children: props.children }));
+    }
+    return (_jsx("button", { ...props, ref: composeRefs(ref, triggerRef, referenceRef), type: type, disabled: disabled, id: triggerId, role: "button", "aria-haspopup": "menu", "aria-expanded": open ? "true" : "false", "aria-controls": contentId, className: cn("zvk-ui-dropdown-menu__trigger", className), "data-state": open ? "open" : "closed", onClick: composeEventHandlers(onClick, handleClick) }));
 }
-function DropdownMenuContent({ children, className, forceMount = false, sideOffset = defaultContentPositioning.sideOffset, collisionPadding = defaultContentPositioning.collisionPadding, matchTriggerWidth = defaultContentPositioning.matchTriggerWidth, ref, onKeyDown, ...props }) {
-    const { container, contentId, open, setOpen, updateContentPositioning, triggerId, floatingRef, floatingStyle, getEnabledItems } = useDropdownMenuContext("DropdownMenu.Content");
+function DropdownMenuContent({ align, alignOffset = defaultContentPositioning.alignOffset, children, className, forceMount = false, side, sideOffset = defaultContentPositioning.sideOffset, collisionPadding = defaultContentPositioning.collisionPadding, matchTriggerWidth = defaultContentPositioning.matchTriggerWidth, ref, onKeyDown, ...props }) {
+    const { container, contentId, open, setOpen, updateContentPositioning, triggerId, floatingRef, floatingPlacement, floatingStyle, getEnabledItems } = useDropdownMenuContext("DropdownMenu.Content");
     const focusItem = React.useCallback((index, items) => {
         if (items.length === 0) {
             return;
@@ -181,14 +203,16 @@ function DropdownMenuContent({ children, className, forceMount = false, sideOffs
     }, [getEnabledItems]);
     React.useEffect(() => {
         updateContentPositioning({
+            ...(side === undefined ? {} : { placement: placementFromSideAlign(side, align, "bottom") }),
             sideOffset,
+            alignOffset,
             collisionPadding,
             matchTriggerWidth
         });
         return () => {
             updateContentPositioning(defaultContentPositioning);
         };
-    }, [collisionPadding, matchTriggerWidth, sideOffset, updateContentPositioning]);
+    }, [align, alignOffset, collisionPadding, matchTriggerWidth, side, sideOffset, updateContentPositioning]);
     if (!open && !forceMount) {
         return null;
     }
@@ -200,7 +224,7 @@ function DropdownMenuContent({ children, className, forceMount = false, sideOffs
             else if (ref) {
                 ref.current = node;
             }
-        }, id: contentId, role: "menu", "aria-labelledby": triggerId, className: cn("liano-dropdown-menu__content", className), style: floatingStyle, "data-state": open ? "open" : "closed", hidden: open ? undefined : true, onKeyDown: composeEventHandlers(onKeyDown, (event) => {
+        }, id: contentId, role: "menu", "aria-labelledby": triggerId, className: cn("zvk-ui-dropdown-menu__content", className), style: floatingStyle, "data-align": placementParts(floatingPlacement).align, "data-side": placementParts(floatingPlacement).side, "data-state": open ? "open" : "closed", hidden: open ? undefined : true, onKeyDown: composeEventHandlers(onKeyDown, (event) => {
             if (event.key === "ArrowDown") {
                 event.preventDefault();
                 moveFocus("next");
@@ -236,7 +260,7 @@ function DropdownMenuContent({ children, className, forceMount = false, sideOffs
                 setOpen(false);
             }, children: content }) }));
 }
-function DropdownMenuItem({ children, className, disabled, onClick, onSelect, onKeyDown, ref, ...props }) {
+function DropdownMenuItem({ asChild = false, children, className, disabled, onClick, onSelect, onKeyDown, ref, ...props }) {
     const context = useDropdownMenuContext("DropdownMenu.Item");
     const itemRef = React.useRef(null);
     const itemId = React.useId();
@@ -251,41 +275,50 @@ function DropdownMenuItem({ children, className, disabled, onClick, onSelect, on
         context.registerItem(itemRecord);
         return () => context.unregisterItem(itemId);
     }, [context, isDisabled, itemId, onSelect]);
-    return (_jsx("button", { ...props, ref: (node) => {
-            itemRef.current = node;
-            if (typeof ref === "function") {
-                ref(node);
-            }
-            else if (ref) {
-                ref.current = node;
-            }
-        }, type: "button", role: "menuitem", disabled: isDisabled, "aria-disabled": isDisabled ? "true" : undefined, className: cn("liano-dropdown-menu__item", className), "data-state": isDisabled ? "disabled" : "enabled", onClick: composeEventHandlers(onClick, (event) => {
-            if (isDisabled) {
-                return;
-            }
-            onSelect?.(event);
+    const select = (event) => {
+        if (isDisabled) {
+            return;
+        }
+        onSelect?.(event);
+        if (!event.defaultPrevented) {
             context.setOpen(false);
-        }), onKeyDown: composeEventHandlers(onKeyDown, (event) => {
-            if (event.key === " " || event.key === "Space" || event.key === "Enter" || event.key === "Spacebar") {
+        }
+    };
+    const itemProps = {
+        ...props,
+        ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        },
+        role: "menuitem",
+        "aria-disabled": isDisabled ? true : undefined,
+        className: cn("zvk-ui-dropdown-menu__item", className),
+        "data-disabled": isDisabled ? "true" : undefined,
+        "data-state": isDisabled ? "disabled" : "enabled",
+        onClick: composeEventHandlers(onClick, select),
+        onKeyDown: composeEventHandlers(onKeyDown, (event) => {
+            if (isActivationKey(event.key)) {
+                select(event);
                 event.preventDefault();
-                if (isDisabled) {
-                    return;
-                }
-                onSelect?.(event);
-                context.setOpen(false);
             }
-        }), children: children }));
+        })
+    };
+    if (asChild) {
+        return _jsx(Slot, { ...itemProps, children: children });
+    }
+    return (_jsx("button", { ...props, ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        }, type: "button", role: "menuitem", disabled: isDisabled, "aria-disabled": itemProps["aria-disabled"], className: itemProps.className, "data-disabled": itemProps["data-disabled"], "data-state": itemProps["data-state"], onClick: itemProps.onClick, onKeyDown: itemProps.onKeyDown, children: children }));
 }
 function DropdownMenuSeparator({ className, ref, ...props }) {
-    return (_jsx("div", { ...props, ref: ref, role: "separator", "aria-hidden": "true", className: cn("liano-dropdown-menu__separator", className) }));
+    return (_jsx("div", { ...props, ref: ref, role: "separator", "aria-hidden": "true", className: cn("zvk-ui-dropdown-menu__separator", className) }));
 }
 function DropdownMenuLabel({ className, ref, ...props }) {
-    return (_jsx("div", { ...props, ref: ref, className: cn("liano-dropdown-menu__label", className) }));
+    return (_jsx("div", { ...props, ref: ref, className: cn("zvk-ui-dropdown-menu__label", className) }));
 }
 function DropdownMenuShortcut({ className, ref, ...props }) {
-    return (_jsx("span", { ...props, ref: ref, className: cn("liano-dropdown-menu__shortcut", className) }));
+    return (_jsx("span", { ...props, ref: ref, className: cn("zvk-ui-dropdown-menu__shortcut", className) }));
 }
-function DropdownMenuCheckboxItem({ checked, children, className, defaultChecked = false, disabled, onCheckedChange, onClick, onKeyDown, onSelect, ref, ...props }) {
+function DropdownMenuCheckboxItem({ asChild = false, checked, children, className, defaultChecked = false, disabled, onCheckedChange, onClick, onKeyDown, onSelect, ref, ...props }) {
     const context = useDropdownMenuContext("DropdownMenu.CheckboxItem");
     const itemRef = React.useRef(null);
     const itemId = React.useId();
@@ -308,33 +341,46 @@ function DropdownMenuCheckboxItem({ checked, children, className, defaultChecked
         if (isDisabled) {
             return;
         }
-        setCurrentChecked((value) => !value);
         onSelect?.(event);
-        context.setOpen(false);
+        if (!event.defaultPrevented) {
+            setCurrentChecked((value) => !value);
+            context.setOpen(false);
+        }
     };
-    return (_jsxs("button", { ...props, ref: (node) => {
-            itemRef.current = node;
-            if (typeof ref === "function") {
-                ref(node);
-            }
-            else if (ref) {
-                ref.current = node;
-            }
-        }, type: "button", role: "menuitemcheckbox", disabled: isDisabled, "aria-checked": currentChecked ? "true" : "false", "aria-disabled": isDisabled ? "true" : undefined, className: cn("liano-dropdown-menu__item", "liano-dropdown-menu__checkbox-item", className), "data-checked": currentChecked ? "true" : undefined, "data-disabled": isDisabled ? "true" : undefined, onClick: composeEventHandlers(onClick, select), onKeyDown: composeEventHandlers(onKeyDown, (event) => {
-            if (event.key === " " || event.key === "Space" || event.key === "Enter" || event.key === "Spacebar") {
-                event.preventDefault();
+    const itemProps = {
+        ...props,
+        ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        },
+        role: "menuitemcheckbox",
+        "aria-checked": currentChecked,
+        "aria-disabled": isDisabled ? true : undefined,
+        className: cn("zvk-ui-dropdown-menu__item", "zvk-ui-dropdown-menu__checkbox-item", className),
+        "data-checked": currentChecked ? "true" : undefined,
+        "data-disabled": isDisabled ? "true" : undefined,
+        onClick: composeEventHandlers(onClick, select),
+        onKeyDown: composeEventHandlers(onKeyDown, (event) => {
+            if (isActivationKey(event.key)) {
                 select(event);
+                event.preventDefault();
             }
-        }), children: [_jsx("span", { className: "liano-dropdown-menu__item-indicator", "aria-hidden": "true", children: currentChecked ? "✓" : "" }), _jsx("span", { className: "liano-dropdown-menu__item-label", children: children })] }));
+        })
+    };
+    if (asChild) {
+        return _jsx(Slot, { ...itemProps, children: children });
+    }
+    return (_jsxs("button", { ...props, ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        }, type: "button", role: "menuitemcheckbox", disabled: isDisabled, "aria-checked": itemProps["aria-checked"], "aria-disabled": itemProps["aria-disabled"], className: itemProps.className, "data-checked": itemProps["data-checked"], "data-disabled": itemProps["data-disabled"], onClick: itemProps.onClick, onKeyDown: itemProps.onKeyDown, children: [_jsx("span", { className: "zvk-ui-dropdown-menu__item-indicator", "aria-hidden": "true", children: currentChecked ? "✓" : "" }), _jsx("span", { className: "zvk-ui-dropdown-menu__item-label", children: children })] }));
 }
 function DropdownMenuRadioGroup({ children, className, onValueChange, ref, value, ...props }) {
     const contextValue = React.useMemo(() => ({
         ...(value !== undefined ? { value } : {}),
         ...(onValueChange ? { onValueChange } : {})
     }), [onValueChange, value]);
-    return (_jsx(DropdownMenuRadioGroupContext.Provider, { value: contextValue, children: _jsx("div", { ...props, ref: ref, className: cn("liano-dropdown-menu__radio-group", className), role: "group", children: children }) }));
+    return (_jsx(DropdownMenuRadioGroupContext.Provider, { value: contextValue, children: _jsx("div", { ...props, ref: ref, className: cn("zvk-ui-dropdown-menu__radio-group", className), role: "group", children: children }) }));
 }
-function DropdownMenuRadioItem({ children, className, disabled, onClick, onKeyDown, onSelect, ref, value, ...props }) {
+function DropdownMenuRadioItem({ asChild = false, children, className, disabled, onClick, onKeyDown, onSelect, ref, value, ...props }) {
     const context = useDropdownMenuContext("DropdownMenu.RadioItem");
     const radioGroup = React.useContext(DropdownMenuRadioGroupContext);
     const itemRef = React.useRef(null);
@@ -354,27 +400,40 @@ function DropdownMenuRadioItem({ children, className, disabled, onClick, onKeyDo
         if (isDisabled) {
             return;
         }
-        radioGroup?.onValueChange?.(value);
         onSelect?.(event);
-        context.setOpen(false);
+        if (!event.defaultPrevented) {
+            radioGroup?.onValueChange?.(value);
+            context.setOpen(false);
+        }
     };
-    return (_jsxs("button", { ...props, ref: (node) => {
-            itemRef.current = node;
-            if (typeof ref === "function") {
-                ref(node);
-            }
-            else if (ref) {
-                ref.current = node;
-            }
-        }, type: "button", role: "menuitemradio", disabled: isDisabled, "aria-checked": checked ? "true" : "false", "aria-disabled": isDisabled ? "true" : undefined, className: cn("liano-dropdown-menu__item", "liano-dropdown-menu__radio-item", className), "data-checked": checked ? "true" : undefined, "data-disabled": isDisabled ? "true" : undefined, onClick: composeEventHandlers(onClick, select), onKeyDown: composeEventHandlers(onKeyDown, (event) => {
-            if (event.key === " " || event.key === "Space" || event.key === "Enter" || event.key === "Spacebar") {
-                event.preventDefault();
+    const itemProps = {
+        ...props,
+        ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        },
+        role: "menuitemradio",
+        "aria-checked": checked,
+        "aria-disabled": isDisabled ? true : undefined,
+        className: cn("zvk-ui-dropdown-menu__item", "zvk-ui-dropdown-menu__radio-item", className),
+        "data-checked": checked ? "true" : undefined,
+        "data-disabled": isDisabled ? "true" : undefined,
+        onClick: composeEventHandlers(onClick, select),
+        onKeyDown: composeEventHandlers(onKeyDown, (event) => {
+            if (isActivationKey(event.key)) {
                 select(event);
+                event.preventDefault();
             }
-        }), children: [_jsx("span", { className: "liano-dropdown-menu__item-indicator", "aria-hidden": "true", children: checked ? "●" : "" }), _jsx("span", { className: "liano-dropdown-menu__item-label", children: children })] }));
+        })
+    };
+    if (asChild) {
+        return _jsx(Slot, { ...itemProps, children: children });
+    }
+    return (_jsxs("button", { ...props, ref: (node) => {
+            setComposedRef(itemRef, ref, node);
+        }, type: "button", role: "menuitemradio", disabled: isDisabled, "aria-checked": itemProps["aria-checked"], "aria-disabled": itemProps["aria-disabled"], className: itemProps.className, "data-checked": itemProps["data-checked"], "data-disabled": itemProps["data-disabled"], onClick: itemProps.onClick, onKeyDown: itemProps.onKeyDown, children: [_jsx("span", { className: "zvk-ui-dropdown-menu__item-indicator", "aria-hidden": "true", children: checked ? "●" : "" }), _jsx("span", { className: "zvk-ui-dropdown-menu__item-label", children: children })] }));
 }
 function DropdownMenuSub({ children, className, ref, ...props }) {
-    return (_jsx("div", { ...props, ref: ref, className: cn("liano-dropdown-menu__sub", className), children: children }));
+    return (_jsx("div", { ...props, ref: ref, className: cn("zvk-ui-dropdown-menu__sub", className), children: children }));
 }
 export const DropdownMenu = Object.assign(DropdownMenuRoot, {
     CheckboxItem: DropdownMenuCheckboxItem,

package/dist/components/empty-state/empty-state.js

@@ -30,5 +30,5 @@ export function EmptyState({ actions, align = "center", children: _children, cla
     const hasIcon = hasRenderableNode(icon);
     const showDescription = description !== null && description !== undefined;
     const showActions = actions !== null && actions !== undefined;
-    return (_jsxs("div", { ...props, ref: ref, className: cn("liano-empty-state", className), "data-align": align, "data-size": size, children: [icon ? _jsx("div", { "aria-hidden": hasIcon ? undefined : true, className: "liano-empty-state__icon", children: icon }) : null, _jsx("h3", { className: "liano-empty-state__title", children: title }), showDescription ? _jsx("p", { className: "liano-empty-state__description", children: description }) : null, showActions ? _jsx("div", { className: "liano-empty-state__actions", children: actions }) : null] }));
+    return (_jsxs("div", { ...props, ref: ref, className: cn("zvk-ui-empty-state", className), "data-align": align, "data-size": size, children: [icon ? _jsx("div", { "aria-hidden": hasIcon ? undefined : true, className: "zvk-ui-empty-state__icon", children: icon }) : null, _jsx("h3", { className: "zvk-ui-empty-state__title", children: title }), showDescription ? _jsx("p", { className: "zvk-ui-empty-state__description", children: description }) : null, showActions ? _jsx("div", { className: "zvk-ui-empty-state__actions", children: actions }) : null] }));
 }

package/dist/components/error-boundary/error-boundary.js

@@ -39,5 +39,5 @@ export class ErrorBoundary extends React.Component {
     }
 }
 export function ErrorFallback({ action, className, error, ref, title = "Something went wrong", ...props }) {
-    return (_jsxs("div", { ...props, ref: ref, "aria-label": typeof title === "string" ? title : undefined, className: cn("liano-error-fallback", className), role: "alert", children: [_jsx("h3", { className: "liano-error-fallback__title", children: title }), error ? _jsx("p", { className: "liano-error-fallback__message", children: error.message }) : null, action ? _jsx("div", { className: "liano-error-fallback__action", children: action }) : null] }));
+    return (_jsxs("div", { ...props, ref: ref, "aria-label": typeof title === "string" ? title : undefined, className: cn("zvk-ui-error-fallback", className), role: "alert", children: [_jsx("h3", { className: "zvk-ui-error-fallback__title", children: title }), error ? _jsx("p", { className: "zvk-ui-error-fallback__message", children: error.message }) : null, action ? _jsx("div", { className: "zvk-ui-error-fallback__action", children: action }) : null] }));
 }

package/dist/components/field/field.js

@@ -2,16 +2,16 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { cn } from "../../utils/cn.js";
 function FieldRoot({ className, disabled, invalid, ref, required, ...props }) {
-    return (_jsx("div", { ...props, ref: ref, className: cn("liano-field", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalid ? "true" : undefined, "data-required": required ? "true" : undefined }));
+    return (_jsx("div", { ...props, ref: ref, className: cn("zvk-ui-field", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalid ? "true" : undefined, "data-required": required ? "true" : undefined }));
 }
 function FieldLabel({ className, ref, ...props }) {
-    return _jsx("label", { ...props, ref: ref, className: cn("liano-field__label", className) });
+    return _jsx("label", { ...props, ref: ref, className: cn("zvk-ui-field__label", className) });
 }
 function FieldDescription({ className, ref, ...props }) {
-    return _jsx("p", { ...props, ref: ref, className: cn("liano-field__description", className) });
+    return _jsx("p", { ...props, ref: ref, className: cn("zvk-ui-field__description", className) });
 }
 function FieldError({ className, ref, role = "alert", ...props }) {
-    return _jsx("p", { ...props, ref: ref, className: cn("liano-field__error", className), role: role });
+    return _jsx("p", { ...props, ref: ref, className: cn("zvk-ui-field__error", className), role: role });
 }
 export const Field = Object.assign(FieldRoot, {
     Label: FieldLabel,

package/dist/components/file-upload-input/file-upload-input.js

@@ -28,12 +28,12 @@ export function FileUploadInput({ "aria-describedby": ariaDescribedBy, buttonLab
     const descriptionId = hasDescription ? `${inputId}-description` : undefined;
     const errorId = hasError ? `${inputId}-error` : undefined;
     const summaryId = `${inputId}-summary`;
-    const describedBy = joinIds(ariaDescribedBy, descriptionId, errorId);
+    const describedBy = joinIds(ariaDescribedBy, descriptionId, errorId, summaryId);
     function handleChange(event) {
         setFiles(event.currentTarget.files);
         onChange?.(event);
     }
-    const input = (_jsxs("div", { className: "liano-file-upload-input", children: [_jsx("span", { "aria-hidden": "true", className: "liano-file-upload-input__button", children: buttonLabel }), _jsx("input", { ...props, ref: ref, "aria-describedby": describedBy, "aria-invalid": invalidState ? true : undefined, className: cn("liano-file-upload-input__control", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalidState ? "true" : undefined, "data-required": required ? "true" : undefined, "data-size": size, disabled: disabled, id: inputId, onChange: handleChange, required: required, type: "file" }), _jsx("span", { className: "liano-file-upload-input__summary", id: summaryId, children: getFileSummary(files, emptyLabel) })] }));
+    const input = (_jsxs("div", { className: "zvk-ui-file-upload-input", children: [_jsx("span", { "aria-hidden": "true", className: "zvk-ui-file-upload-input__button", children: buttonLabel }), _jsx("input", { ...props, ref: ref, "aria-describedby": describedBy, "aria-invalid": invalidState ? true : undefined, className: cn("zvk-ui-file-upload-input__control", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalidState ? "true" : undefined, "data-required": required ? "true" : undefined, "data-size": size, disabled: disabled, id: inputId, onChange: handleChange, required: required, type: "file" }), _jsx("span", { className: "zvk-ui-file-upload-input__summary", id: summaryId, children: getFileSummary(files, emptyLabel) })] }));
     if (!hasRenderableNode(label) && !hasDescription && !hasError) {
         return input;
     }

package/dist/components/form/form.js

@@ -15,7 +15,7 @@ function joinIds(ids) {
     return value.length > 0 ? value : undefined;
 }
 export function Form({ className, ref, ...props }) {
-    return _jsx("form", { ...props, ref: ref, className: cn("liano-form", className) });
+    return _jsx("form", { ...props, ref: ref, className: cn("zvk-ui-form", className) });
 }
 export function FormField({ children, className, disabled, id, invalid, required, ...props }) {
     const generatedId = React.useId();
@@ -36,14 +36,14 @@ export function FormField({ children, className, disabled, id, invalid, required
         registerDescription,
         unregisterDescription
     }), [controlId, descriptionIds, disabled, invalid, registerDescription, required, unregisterDescription]);
-    return (_jsx(FormFieldContext.Provider, { value: context, children: _jsx("div", { ...props, className: cn("liano-form-field", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalid ? "true" : undefined, "data-required": required ? "true" : undefined, children: children }) }));
+    return (_jsx(FormFieldContext.Provider, { value: context, children: _jsx("div", { ...props, className: cn("zvk-ui-form-field", className), "data-disabled": disabled ? "true" : undefined, "data-invalid": invalid ? "true" : undefined, "data-required": required ? "true" : undefined, children: children }) }));
 }
 export function FormItem({ className, ref, ...props }) {
-    return _jsx("div", { ...props, ref: ref, className: cn("liano-form-item", className) });
+    return _jsx("div", { ...props, ref: ref, className: cn("zvk-ui-form-item", className) });
 }
 export function FormLabel({ className, htmlFor, ref, ...props }) {
     const context = useFormFieldContext("FormLabel");
-    return _jsx("label", { ...props, ref: ref, className: cn("liano-form-label", className), htmlFor: htmlFor ?? context.controlId });
+    return _jsx("label", { ...props, ref: ref, className: cn("zvk-ui-form-label", className), htmlFor: htmlFor ?? context.controlId });
 }
 export function FormControl({ children }) {
     const context = useFormFieldContext("FormControl");
@@ -81,8 +81,8 @@ function FormText({ className, id, ref, role, textRole, ...props }) {
     return _jsx("p", { ...props, ref: ref, id: textId, role: role, className: className });
 }
 export function FormDescription({ className, ...props }) {
-    return _jsx(FormText, { ...props, className: cn("liano-form-description", className), textRole: "FormDescription" });
+    return _jsx(FormText, { ...props, className: cn("zvk-ui-form-description", className), textRole: "FormDescription" });
 }
 export function FormMessage({ className, role = "alert", ...props }) {
-    return _jsx(FormText, { ...props, className: cn("liano-form-message", className), role: role, textRole: "FormMessage" });
+    return _jsx(FormText, { ...props, className: cn("zvk-ui-form-message", className), role: role, textRole: "FormMessage" });
 }

package/dist/components/hover-card/hover-card.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { FloatingPlacement } from "../../internal/floating/index.js";
+import type { FloatingAlign, FloatingSide } from "../../internal/floating/placement-aliases.js";
 import type { PortalProps } from "../../internal/portal/index.js";
 export interface HoverCardProps {
     children?: React.ReactNode;
@@ -12,9 +13,14 @@ export interface HoverCardProps {
     disabled?: boolean;
 }
 export interface HoverCardTriggerProps {
+    asChild?: boolean;
     children: React.ReactElement;
 }
 export interface HoverCardContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    placement?: FloatingPlacement;
+    side?: FloatingSide;
+    align?: FloatingAlign;
+    alignOffset?: number;
     sideOffset?: number;
     collisionPadding?: number;
     forceMount?: boolean;
@@ -22,8 +28,8 @@ export interface HoverCardContentProps extends React.HTMLAttributes<HTMLDivEleme
     ref?: React.Ref<HTMLDivElement>;
 }
 declare function HoverCardRoot({ children, closeDelay, defaultOpen, disabled, onOpenChange, open: openProp, openDelay, placement }: HoverCardProps): React.JSX.Element;
-declare function HoverCardTrigger({ children }: HoverCardTriggerProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
-declare function HoverCardContent({ children, className, collisionPadding, container, forceMount, id, onBlur, onFocus, onMouseEnter, onMouseLeave, onPointerEnter, onPointerLeave, ref, sideOffset, style, ...props }: HoverCardContentProps): React.JSX.Element | null;
+declare function HoverCardTrigger({ children, asChild: _asChild }: HoverCardTriggerProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+declare function HoverCardContent({ align, alignOffset, children, className, collisionPadding, container, forceMount, id, onBlur, onFocus, onMouseEnter, onMouseLeave, onPointerEnter, onPointerLeave, placement, ref, side, sideOffset, style, ...props }: HoverCardContentProps): React.JSX.Element | null;
 export declare const HoverCard: typeof HoverCardRoot & {
     Trigger: typeof HoverCardTrigger;
     Content: typeof HoverCardContent;

package/dist/components/hover-card/hover-card.js

@@ -3,12 +3,14 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { DismissableLayer } from "../../internal/dismissable-layer/index.js";
 import { useFloatingPosition } from "../../internal/floating/index.js";
+import { placementFromSideAlign } from "../../internal/floating/placement-aliases.js";
 import { Portal } from "../../internal/portal/index.js";
 import { useControllableState } from "../../hooks/use-controllable-state.js";
 import { cn } from "../../utils/cn.js";
 import { composeEventHandlers } from "../../utils/compose-event-handlers.js";
 const defaultContentPositioning = {
     sideOffset: 8,
+    alignOffset: 0,
     collisionPadding: 0
 };
 const HoverCardContext = React.createContext(null);
@@ -25,7 +27,7 @@ function composeRefs(...refs) {
             if (typeof ref === "function") {
                 ref(node);
             }
-            else if (ref !== undefined) {
+            else if (ref !== undefined && ref !== null) {
                 ref.current = node;
             }
         }
@@ -55,8 +57,9 @@ function HoverCardRoot({ children, closeDelay = 300, defaultOpen = false, disabl
     const contentElement = React.useRef(null);
     const { floatingRef, floatingStyle, placement: resolvedPlacement, referenceRef, updatePosition } = useFloatingPosition({
         open,
-        placement,
+        placement: contentPositioning.placement ?? placement,
         offset: contentPositioning.sideOffset,
+        alignmentOffset: contentPositioning.alignOffset,
         collisionPadding: contentPositioning.collisionPadding,
         flip: true,
         shift: true
@@ -204,7 +207,7 @@ function HoverCardRoot({ children, closeDelay = 300, defaultOpen = false, disabl
     ]);
     return (_jsx(HoverCardContext.Provider, { value: contextValue, children: children }));
 }
-function HoverCardTrigger({ children }) {
+function HoverCardTrigger({ children, asChild: _asChild = false }) {
     const context = useHoverCardContext("HoverCard.Trigger");
     if (!React.isValidElement(children) || context.disabled) {
         return children;
@@ -221,7 +224,7 @@ function HoverCardTrigger({ children }) {
         "aria-describedby": joinIds(typeof childAriaDescribedBy === "string" ? childAriaDescribedBy : undefined, context.open ? context.contentId : undefined),
         "aria-expanded": context.open,
         "aria-haspopup": "dialog",
-        className: cn("liano-hover-card__trigger", childClassName),
+        className: cn("zvk-ui-hover-card__trigger", childClassName),
         "data-state": context.open ? "open" : "closed",
         onBlur: composeEventHandlers(childProps.onBlur, (event) => {
             context.closeAfterFocusLeaves(event.relatedTarget);
@@ -233,22 +236,25 @@ function HoverCardTrigger({ children }) {
         onPointerLeave: composeEventHandlers(childProps.onPointerLeave, context.closeWithDelay)
     });
 }
-function HoverCardContent({ children, className, collisionPadding = defaultContentPositioning.collisionPadding, container, forceMount = false, id, onBlur, onFocus, onMouseEnter, onMouseLeave, onPointerEnter, onPointerLeave, ref, sideOffset = defaultContentPositioning.sideOffset, style, ...props }) {
+function HoverCardContent({ align, alignOffset = defaultContentPositioning.alignOffset, children, className, collisionPadding = defaultContentPositioning.collisionPadding, container, forceMount = false, id, onBlur, onFocus, onMouseEnter, onMouseLeave, onPointerEnter, onPointerLeave, placement, ref, side, sideOffset = defaultContentPositioning.sideOffset, style, ...props }) {
     const context = useHoverCardContext("HoverCard.Content");
     const contentId = id ?? context.contentId;
     const placementParts = getPlacementParts(context.resolvedPlacement);
     const { setContentPositioning } = context;
     React.useEffect(() => {
+        const resolvedPlacement = side === undefined ? placement : placementFromSideAlign(side, align, placement ?? "bottom");
         setContentPositioning({
+            ...(resolvedPlacement === undefined ? {} : { placement: resolvedPlacement }),
             sideOffset,
+            alignOffset,
             collisionPadding
         });
         return () => setContentPositioning(defaultContentPositioning);
-    }, [collisionPadding, setContentPositioning, sideOffset]);
+    }, [align, alignOffset, collisionPadding, placement, setContentPositioning, side, sideOffset]);
     if (!context.open && !forceMount) {
         return null;
     }
-    const content = (_jsx("div", { ...props, ref: composeRefs(ref, context.floatingRef), id: contentId, role: "dialog", className: cn("liano-hover-card__content", className), "data-align": placementParts.align, "data-side": placementParts.side, "data-state": context.open ? "open" : "closed", hidden: context.open ? undefined : true, onBlur: composeEventHandlers(onBlur, (event) => {
+    const content = (_jsx("div", { ...props, ref: composeRefs(ref, context.floatingRef), id: contentId, role: "dialog", className: cn("zvk-ui-hover-card__content", className), "data-align": placementParts.align, "data-side": placementParts.side, "data-state": context.open ? "open" : "closed", hidden: context.open ? undefined : true, onBlur: composeEventHandlers(onBlur, (event) => {
             context.closeAfterFocusLeaves(event.relatedTarget);
         }), onFocus: composeEventHandlers(onFocus, context.openImmediately), onMouseEnter: composeEventHandlers(onMouseEnter, context.cancelClose), onMouseLeave: composeEventHandlers(onMouseLeave, context.closeWithDelay), onPointerEnter: composeEventHandlers(onPointerEnter, context.cancelClose), onPointerLeave: composeEventHandlers(onPointerLeave, context.closeWithDelay), style: { ...context.floatingStyle, ...style }, children: children }));
     if (!context.open) {

package/dist/components/icon-button/icon-button.js

@@ -2,7 +2,25 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { Spinner } from "../spinner/spinner.js";
 import { cn } from "../../utils/cn.js";
+function isDevelopmentEnvironment() {
+    const runtimeProcess = globalThis.process;
+    if (runtimeProcess?.env?.NODE_ENV) {
+        return runtimeProcess.env.NODE_ENV !== "production";
+    }
+    const metaEnv = import.meta.env;
+    if (typeof metaEnv?.DEV === "boolean") {
+        return metaEnv.DEV;
+    }
+    if (typeof metaEnv?.PROD === "boolean") {
+        return !metaEnv.PROD;
+    }
+    return typeof metaEnv?.MODE === "string" && metaEnv.MODE !== "production";
+}
 export function IconButton({ children, className, disabled, loading = false, ref, size = "md", type = "button", variant = "secondary", ...props }) {
     const isDisabled = disabled || loading;
-    return (_jsx("button", { ...props, ref: ref, "aria-busy": loading ? true : undefined, className: cn("liano-icon-button", className), "data-disabled": isDisabled ? "true" : undefined, "data-loading": loading ? "true" : undefined, "data-size": size, "data-variant": variant, disabled: isDisabled, type: type, children: loading ? _jsx(Spinner, { size: "sm" }) : children }));
+    const hasAccessibleName = props["aria-label"] !== undefined || props["aria-labelledby"] !== undefined;
+    if (!hasAccessibleName && isDevelopmentEnvironment()) {
+        console.warn("IconButton requires an accessible name. Provide aria-label or aria-labelledby.");
+    }
+    return (_jsx("button", { ...props, ref: ref, "aria-busy": loading ? true : undefined, className: cn("zvk-ui-icon-button", className), "data-disabled": isDisabled ? "true" : undefined, "data-loading": loading ? "true" : undefined, "data-size": size, "data-variant": variant, disabled: isDisabled, type: type, children: loading ? _jsx(Spinner, { size: "sm" }) : children }));
 }