@enonic/ui 1.4.0 → 1.6.0

package/dist/types/components/toast/toast.d.ts

@@ -46,7 +46,8 @@ export declare const Toast: import('preact').FunctionalComponent<import('preact/
     }>;
     Close: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<{
         asChild?: boolean;
-    } & Omit<IconButtonProps, "icon">> & {
+        'aria-label'?: string;
+    } & Omit<IconButtonProps, "aria-label" | "icon">> & {
         ref?: import('preact').Ref<HTMLButtonElement> | undefined;
     }>;
 };

package/dist/types/components/tree-list/tree-list.d.ts

@@ -6,7 +6,6 @@ export declare const treeListRowVariants: (props?: ({
     active?: boolean | null | undefined;
     selected?: boolean | null | undefined;
     disabled?: boolean | null | undefined;
-    selectable?: boolean | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 export type TreeListRootProps = {
     selection?: ReadonlySet<string>;
@@ -146,8 +145,9 @@ export type TreeListRowExpandControlProps = {
     onToggle?: () => void;
     icon?: LucideIcon;
     selected?: boolean;
+    'aria-label'?: string;
     className?: string;
-} & Omit<IconButtonProps, 'icon' | 'onClick'>;
+} & Omit<IconButtonProps, 'icon' | 'onClick' | 'aria-label'>;
 export declare const TreeListRowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<TreeListRowExpandControlProps> & {
     ref?: import('preact').Ref<HTMLButtonElement> | undefined;
 }>;

package/dist/types/components/virtualized-tree-list/virtualized-tree-list.d.ts

@@ -206,7 +206,7 @@ export type VirtualizedTreeListRowProps = {
     selected?: boolean;
     /** Whether this row is disabled */
     disabled?: boolean;
-    /** Whether this row is selectable */
+    /** @deprecated Has no effect. Selection is governed by `getItemInteraction` and `RowSelectionControl`'s `selectable`. */
     selectable?: boolean;
     /** Additional class names */
     className?: string;
@@ -234,8 +234,9 @@ export type VirtualizedTreeListRowExpandControlProps = {
     onToggle?: () => void;
     icon?: LucideIcon;
     selected?: boolean;
+    'aria-label'?: string;
     className?: string;
-} & Omit<IconButtonProps, 'icon' | 'onClick'>;
+} & Omit<IconButtonProps, 'icon' | 'onClick' | 'aria-label'>;
 export declare const VirtualizedTreeListRowExpandControl: import('preact').FunctionalComponent<import('preact/compat').PropsWithoutRef<VirtualizedTreeListRowExpandControlProps> & {
     ref?: import('preact').Ref<HTMLButtonElement> | undefined;
 }>;

package/dist/types/hooks/use-focus-outside.d.ts

@@ -0,0 +1,9 @@
+import { RefObject } from 'react';
+type UseFocusOutsideConfig = {
+    enabled: boolean;
+    contentRef: RefObject<HTMLElement | null>;
+    onInteractOutside?: (event: Event) => void;
+    onClose?: () => void;
+};
+export declare const useFocusOutside: ({ enabled, contentRef, onInteractOutside, onClose, }: UseFocusOutsideConfig) => ((branch: HTMLElement) => () => void);
+export {};

package/dist/types/hooks/use-portal-focus-container.d.ts

@@ -6,6 +6,7 @@ import { RefObject } from 'react';
  *
  * @param elementRef - Ref to the popup element to register
  * @param isEnabled - Whether registration is active (typically: open && isPortalMode)
+ * @returns A stable callback for cancellable focus after the parent trap acknowledges the container.
  *
  * @example
  * ```tsx
@@ -18,7 +19,10 @@ import { RefObject } from 'react';
  *   setIsPortalMode(contentRef.current.parentElement === portalContainer);
  * }, [open, portalContainer]);
  *
- * usePortalFocusContainer(contentRef, isPortalMode);
+ * const requestFocus = usePortalFocusContainer(contentRef, open && isPortalMode);
+ * useLayoutEffect(() => {
+ *   if (open) return requestFocus(() => contentRef.current?.focus());
+ * }, [open, requestFocus]);
  * ```
  */
-export declare const usePortalFocusContainer: (elementRef: RefObject<HTMLElement | null>, isEnabled: boolean) => void;
+export declare const usePortalFocusContainer: (elementRef: RefObject<HTMLElement | null>, isEnabled: boolean) => ((focus: () => void) => () => void);

package/dist/types/i18n/phrases.d.ts

@@ -23,6 +23,9 @@ export declare const uiPhrases: Readonly<{
     readonly 'enonic.ui.stepper.goToStep': "Go to step {0}";
 } & {
     readonly 'enonic.ui.dialog.close': "Close";
+} & {
+    readonly 'enonic.ui.tab.scrollLeft': "Scroll tabs left";
+    readonly 'enonic.ui.tab.scrollRight': "Scroll tabs right";
 } & {
     readonly 'enonic.ui.timePicker.hour': "Hour";
     readonly 'enonic.ui.timePicker.minute': "Minute";

package/dist/types/providers/combobox-provider.d.ts

@@ -10,6 +10,7 @@ export type ComboboxContextValue = {
     baseId: string;
     contentRef: RefObject<HTMLDivElement>;
     controlRef: RefObject<HTMLDivElement> | null;
+    inputRef: RefObject<HTMLInputElement>;
     applyRef: RefObject<HTMLButtonElement>;
     popupRef: RefObject<HTMLDivElement>;
     restoreFocusOnCloseRef: RefObject<boolean>;

package/dist/types/providers/context-menu-content-provider.d.ts

@@ -14,6 +14,7 @@ export type ContextMenuContentContextValue = {
     getItems: () => string[];
     isItemDisabled: (id: string) => boolean;
     getItemElement: (id: string) => HTMLElement | null;
+    registerFocusBranch: (element: HTMLElement) => () => void;
     /**
      * Safe-triangle check registered by a currently-open child `Sub`. When non-null,
      * the Content's pointer-move capture handler consults it to decide whether to

package/dist/types/providers/dialog-provider.d.ts

@@ -1,11 +1,12 @@
-import { ReactElement, ReactNode } from 'react';
+import { Dispatch, ReactElement, ReactNode, SetStateAction } from 'react';
 export type DialogContextValue = {
     open: boolean;
     setOpen: (next: boolean) => void;
-    titleId: string;
-    descriptionId: string;
-    setTitleId: (id: string) => void;
-    setDescriptionId: (id: string) => void;
+    titleId: string | undefined;
+    descriptionId: string | undefined;
+    setTitleId: Dispatch<SetStateAction<string | undefined>>;
+    setDescriptionId: Dispatch<SetStateAction<string | undefined>>;
+    isUsingStepper?: boolean;
 };
 export type DialogProviderProps = {
     value: DialogContextValue;

package/dist/types/providers/focus-container-provider.d.ts

@@ -4,11 +4,13 @@
  * Used by Dialog.Content to extend focus-trap-react's containerElements
  * to include portaled popups (e.g., Combobox.Popup in portal mode).
  *
- * @see .cursor/rules/patterns.mdc — "Focus Trap with Portaled Content"
+ * @see docs/patterns.md — "Focus Trap with Portaled Content"
  */
 export type FocusContainerRegistry = {
     register: (element: HTMLElement) => void;
     unregister: (element: HTMLElement) => void;
+    /** Focus once the trap has acknowledged this container. Returns a cancellation callback. */
+    requestFocus?: (container: HTMLElement, focus: () => void) => () => void;
 };
 export declare const FocusContainerContext: import('preact').Context<FocusContainerRegistry | null>;
 /**

package/dist/types/providers/menu-provider.d.ts

@@ -11,6 +11,7 @@ export type MenuContextValue = {
     isItemDisabled: (id: string) => boolean;
     getItemElement: (id: string) => HTMLElement | null;
     triggerRef: RefObject<HTMLButtonElement> | null;
+    contentRef: RefObject<HTMLDivElement>;
 };
 export type MenuProviderProps = {
     value: MenuContextValue;

package/dist/types/providers/stepper-provider.d.ts

@@ -19,4 +19,6 @@ export declare const StepperProvider: {
     ({ value, children }: StepperProviderProps): ReactElement;
     displayName: string;
 };
+/** The enclosing stepper, if any — for parts that adapt to steps without requiring them. */
+export declare const useStepperOptional: () => StepperContextValue | undefined;
 export declare const useStepper: () => StepperContextValue;

package/dist/types/utils/dom.d.ts

@@ -20,3 +20,11 @@ export declare const getActiveElement: () => Element | null;
  * node focused inside a nested root reads as outside the host that holds it.
  */
 export declare const containsDeep: (container: Node | null | undefined, node: Node | null | undefined) => boolean;
+/**
+ * The element a container asks to receive focus: the first `[data-autofocus]` that is not under a
+ * `[hidden]` ancestor. The consumer marks the target; the caller decides when focus moves.
+ *
+ * `data-autofocus="false"` is skipped, since Preact writes a `false` boolean to a `data-*`
+ * attribute as a string — toggle the marker with `data-autofocus={condition || undefined}`.
+ */
+export declare const getAutofocusTarget: (container: Element | null | undefined) => HTMLElement | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enonic/ui",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Enonic UI Component Library",
   "author": "Enonic",
   "license": "Apache-2.0",
@@ -90,26 +90,26 @@
   "devDependencies": {
     "@preact/preset-vite": "~2.10.6",
     "@radix-ui/react-slot": "^1.3.3",
-    "@size-limit/preset-small-lib": "~14.1.0",
-    "@storybook/addon-a11y": "~10.6.0",
-    "@storybook/addon-docs": "~10.6.0",
-    "@storybook/addon-themes": "~10.6.0",
-    "@storybook/preact-vite": "~10.6.0",
-    "@storybook/test-runner": "^0.24.4",
+    "@size-limit/preset-small-lib": "~14.3.0",
+    "@storybook/addon-a11y": "~10.6.3",
+    "@storybook/addon-docs": "~10.6.3",
+    "@storybook/addon-themes": "~10.6.3",
+    "@storybook/preact-vite": "~10.6.3",
+    "@storybook/test-runner": "^0.26.0",
     "@tailwindcss/vite": "~4.3.3",
     "@types/node": "~26.4.1",
     "@types/react": "~19.3.0",
     "@types/react-dom": "~19.3.0",
     "@typescript/typescript6": "~6.0.2",
     "http-server": "^14.1.1",
-    "lucide-preact": "~1.48.0",
+    "lucide-preact": "~1.65.0",
     "playwright": "^1.62.1",
     "publint": "^0.3.24",
-    "react-doctor": "0.9.14",
+    "react-doctor": "0.9.18",
     "react-virtuoso": "^4.18.11",
     "rollup-plugin-visualizer": "~7.1.1",
-    "size-limit": "~14.1.0",
-    "storybook": "~10.6.0",
+    "size-limit": "~14.3.0",
+    "storybook": "~10.6.3",
     "tailwindcss": "~4.3.3",
     "terser": "~5.51.2",
     "tw-animate-css": "^1.4.0",
@@ -130,14 +130,14 @@
       "ignore": [
         "focus-trap-react"
       ],
-      "limit": "60 KB"
+      "limit": "65 KB"
     },
     {
       "path": "dist/enonic-ui.cjs",
       "ignore": [
         "focus-trap-react"
       ],
-      "limit": "60 KB"
+      "limit": "65 KB"
     },
     {
       "path": "dist/styles/style.css",