@djangocfg/ui-tools 2.1.464 → 2.1.466

package/dist/tree/index.d.cts

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
 import { T as TreeNode, a as TreeItemId, b as TreeRowSlot, c as TreeContextMenuSlot, d as TreeContextMenuActionsResolver, F as FlatRow, e as TreeRowRenderProps, f as TreeContextMenuItem } from '../slots-ClRpIzoh.cjs';
@@ -354,7 +353,7 @@ interface TreeActionsHandle {
  * For full control, compose with <TreeProvider>, <TreeContent>,
  * <TreeSearchInput>, <TreeRow>, etc. directly from `@djangocfg/ui-tools/tree`.
  */
-declare function TreeRoot<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeRoot<T>(props: TreeRootProps<T>): react.JSX.Element;
 
 /**
  * `<FinderTree>` — opinionated Finder/Explorer-style preset.
@@ -375,7 +374,7 @@ declare function TreeRoot<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Ele
  * />
  * ```
  */
-declare function FinderTree<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Element;
+declare function FinderTree<T>(props: TreeRootProps<T>): react.JSX.Element;
 
 type ClipboardKind = 'cut' | 'copy';
 interface ClipboardEntry {
@@ -552,7 +551,7 @@ declare function useTreeContext<T>(): TreeContextValue<T>;
 interface TreeProviderProps<T> extends Pick<TreeRootProps<T>, 'data' | 'getItemName' | 'loadChildren' | 'selectionMode' | 'activationMode' | 'initialExpandedIds' | 'initialSelectedIds' | 'indent' | 'appearance' | 'onSelectionChange' | 'onExpansionChange' | 'onActivate' | 'filterNode' | 'enableSearch' | 'showIndentGuides' | 'renderIcon' | 'renderLabel' | 'renderActions' | 'renderContextMenu' | 'contextMenuActions' | 'labels' | 'persistKey' | 'persistSelection' | 'adapter' | 'defaultMenuItems' | 'enableInlineRename' | 'enableDnD' | 'canDrop'> {
     children: react.ReactNode;
 }
-declare function TreeProvider<T>(props: TreeProviderProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeProvider<T>(props: TreeProviderProps<T>): react.JSX.Element;
 
 interface FlattenInput<T> {
     roots: TreeNode<T>[];
@@ -844,7 +843,7 @@ interface TreeChevronProps {
  * Memoised: re-renders only when `isExpanded`, `isFolder` or `className`
  * change. Reads appearance from context.
  */
-declare function TreeChevronRaw({ isExpanded, isFolder, className }: TreeChevronProps): react_jsx_runtime.JSX.Element;
+declare function TreeChevronRaw({ isExpanded, isFolder, className }: TreeChevronProps): react.JSX.Element;
 declare const TreeChevron: react.MemoExoticComponent<typeof TreeChevronRaw>;
 
 interface TreeIconProps {
@@ -859,7 +858,7 @@ interface TreeIconProps {
  * change. Reads appearance from context — context updates will still
  * trigger re-render as expected.
  */
-declare function TreeIconRaw({ isFolder, isExpanded, className }: TreeIconProps): react_jsx_runtime.JSX.Element;
+declare function TreeIconRaw({ isFolder, isExpanded, className }: TreeIconProps): react.JSX.Element;
 declare const TreeIcon: react.MemoExoticComponent<typeof TreeIconRaw>;
 
 interface TreeLabelProps {
@@ -873,7 +872,7 @@ interface TreeLabelProps {
  * Memoised: re-renders only when `children`, `isMatchingSearch` or
  * `className` change. `children` is compared by reference.
  */
-declare function TreeLabelRaw({ children, isMatchingSearch, className }: TreeLabelProps): react_jsx_runtime.JSX.Element;
+declare function TreeLabelRaw({ children, isMatchingSearch, className }: TreeLabelProps): react.JSX.Element;
 declare const TreeLabel: react.MemoExoticComponent<typeof TreeLabelRaw>;
 
 interface TreeRowProps<T> {
@@ -887,7 +886,7 @@ interface TreeRowProps<T> {
  * `row` is treated as immutable — the parent should not mutate node
  * objects in place.
  */
-declare function TreeRowRaw<T>({ row, className }: TreeRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeRowRaw<T>({ row, className }: TreeRowProps<T>): react.JSX.Element;
 declare const TreeRow: typeof TreeRowRaw;
 
 interface TreeContentProps<T> {
@@ -903,31 +902,31 @@ interface TreeContentProps<T> {
      */
     role?: 'tree' | 'group' | 'presentation';
 }
-declare function TreeContent<T>({ children, className, ariaLabel, role, }: TreeContentProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeContent<T>({ children, className, ariaLabel, role, }: TreeContentProps<T>): react.JSX.Element;
 
 interface TreeSearchInputProps {
     className?: string;
     showMatches?: boolean;
 }
-declare function TreeSearchInput({ className, showMatches }: TreeSearchInputProps): react_jsx_runtime.JSX.Element;
+declare function TreeSearchInput({ className, showMatches }: TreeSearchInputProps): react.JSX.Element;
 
 interface TreeEmptyProps {
     children: React.ReactNode;
     className?: string;
 }
-declare function TreeEmpty({ children, className }: TreeEmptyProps): react_jsx_runtime.JSX.Element;
+declare function TreeEmpty({ children, className }: TreeEmptyProps): react.JSX.Element;
 
 interface TreeSkeletonProps {
     rows?: number;
     className?: string;
 }
-declare function TreeSkeleton({ rows, className }: TreeSkeletonProps): react_jsx_runtime.JSX.Element;
+declare function TreeSkeleton({ rows, className }: TreeSkeletonProps): react.JSX.Element;
 
 interface TreeErrorProps {
     children: React.ReactNode;
     className?: string;
 }
-declare function TreeError({ children, className }: TreeErrorProps): react_jsx_runtime.JSX.Element;
+declare function TreeError({ children, className }: TreeErrorProps): react.JSX.Element;
 
 interface TreeIndentGuidesProps {
     level: number;
@@ -938,7 +937,7 @@ interface TreeIndentGuidesProps {
  * 1px column per ancestor level. Decorative — `aria-hidden` and
  * pointer-events disabled. Opacity comes from the tree appearance.
  */
-declare function TreeIndentGuides({ level, indent }: TreeIndentGuidesProps): react_jsx_runtime.JSX.Element;
+declare function TreeIndentGuides({ level, indent }: TreeIndentGuidesProps): react.JSX.Element;
 
 interface TreeRenameInputProps {
     initialValue: string;
@@ -962,7 +961,7 @@ interface TreeRenameInputProps {
  *   - all other keys are stopped from bubbling so Tree's container
  *     hotkeys (↑↓ delete F2 etc.) don't fire while typing.
  */
-declare function TreeRenameInput({ initialValue, isFolder, onCommit, onCancel, className, }: TreeRenameInputProps): react_jsx_runtime.JSX.Element;
+declare function TreeRenameInput({ initialValue, isFolder, onCommit, onCancel, className, }: TreeRenameInputProps): react.JSX.Element;
 
 interface TreeDropIndicatorProps {
     position: TreeMovePosition;
@@ -982,7 +981,7 @@ interface TreeDropIndicatorProps {
  *
  * Positioned absolutely — the parent `TreeRow` provides `position: relative`.
  */
-declare function TreeDropIndicator({ position, indent, invalid, }: TreeDropIndicatorProps): react_jsx_runtime.JSX.Element;
+declare function TreeDropIndicator({ position, indent, invalid, }: TreeDropIndicatorProps): react.JSX.Element;
 
 interface TreeEmptyAreaProps {
     className?: string;
@@ -1000,6 +999,6 @@ interface TreeEmptyAreaProps {
  * `adapter.createFile/Folder` and without a clipboard payload shows
  * no menu at all.
  */
-declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react_jsx_runtime.JSX.Element;
+declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react.JSX.Element;
 
 export { type ChildCache, type ChildEntry, type ChildEntryStatus, DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, type DemoNode, FinderTree, FlatRow, type FlattenInput, type PersistedTreeState, type ResolvedAppearance, TREE_DND_MIME, TreeRoot as Tree, type TreeAccentIntensity, type TreeActionsHandle, type TreeActivateOptions, type TreeActivationMode, type TreeAdapter, type TreeAppearance, type TreeBuiltinAction, TreeChevron, type TreeChevronProps, TreeContent, type TreeContentProps, TreeContextMenuActionsResolver, TreeContextMenuItem, TreeContextMenuSlot, type TreeContextValue, type TreeDensity, TreeDropIndicator, type TreeDropIndicatorProps, TreeEmpty, TreeEmptyArea, type TreeEmptyAreaProps, type TreeEmptyProps, TreeError, type TreeErrorProps, TreeIcon, type TreeIconProps, TreeIndentGuides, type TreeIndentGuidesProps, TreeItemId, TreeLabel, type TreeLabelProps, type TreeLabels, type TreeLoadChildren, type TreeMovePosition, TreeNode, TreeProvider, type TreeProviderProps, type TreeRadius, TreeRenameInput, type TreeRenameInputProps, TreeRoot, type TreeRootProps, TreeRow, type TreeRowProps, TreeRowRenderProps, type TreeRowSizing, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, type TreeVariant, type UseTreeFinderHotkeysOptions, type UseTreeKeyboardOptions, type UseTreeTypeAheadOptions, appearanceToStyle, autoSelectRange, clearTreeState, createChildCache, createDemoTree, TreeRoot as default, defaultCanDrop, flattenTree, loadTreeState, resolveAppearance, resolveChildren, resolveDropZone, saveTreeState, splitFileName, useTreeActions, useTreeClipboard, useTreeContext, useTreeDnd, useTreeExpansion, useTreeFinderHotkeys, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRename, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead };

package/dist/tree/index.d.ts

@@ -1,4 +1,3 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties } from 'react';
 import { T as TreeNode, a as TreeItemId, b as TreeRowSlot, c as TreeContextMenuSlot, d as TreeContextMenuActionsResolver, F as FlatRow, e as TreeRowRenderProps, f as TreeContextMenuItem } from '../slots-ClRpIzoh.js';
@@ -354,7 +353,7 @@ interface TreeActionsHandle {
  * For full control, compose with <TreeProvider>, <TreeContent>,
  * <TreeSearchInput>, <TreeRow>, etc. directly from `@djangocfg/ui-tools/tree`.
  */
-declare function TreeRoot<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeRoot<T>(props: TreeRootProps<T>): react.JSX.Element;
 
 /**
  * `<FinderTree>` — opinionated Finder/Explorer-style preset.
@@ -375,7 +374,7 @@ declare function TreeRoot<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Ele
  * />
  * ```
  */
-declare function FinderTree<T>(props: TreeRootProps<T>): react_jsx_runtime.JSX.Element;
+declare function FinderTree<T>(props: TreeRootProps<T>): react.JSX.Element;
 
 type ClipboardKind = 'cut' | 'copy';
 interface ClipboardEntry {
@@ -552,7 +551,7 @@ declare function useTreeContext<T>(): TreeContextValue<T>;
 interface TreeProviderProps<T> extends Pick<TreeRootProps<T>, 'data' | 'getItemName' | 'loadChildren' | 'selectionMode' | 'activationMode' | 'initialExpandedIds' | 'initialSelectedIds' | 'indent' | 'appearance' | 'onSelectionChange' | 'onExpansionChange' | 'onActivate' | 'filterNode' | 'enableSearch' | 'showIndentGuides' | 'renderIcon' | 'renderLabel' | 'renderActions' | 'renderContextMenu' | 'contextMenuActions' | 'labels' | 'persistKey' | 'persistSelection' | 'adapter' | 'defaultMenuItems' | 'enableInlineRename' | 'enableDnD' | 'canDrop'> {
     children: react.ReactNode;
 }
-declare function TreeProvider<T>(props: TreeProviderProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeProvider<T>(props: TreeProviderProps<T>): react.JSX.Element;
 
 interface FlattenInput<T> {
     roots: TreeNode<T>[];
@@ -844,7 +843,7 @@ interface TreeChevronProps {
  * Memoised: re-renders only when `isExpanded`, `isFolder` or `className`
  * change. Reads appearance from context.
  */
-declare function TreeChevronRaw({ isExpanded, isFolder, className }: TreeChevronProps): react_jsx_runtime.JSX.Element;
+declare function TreeChevronRaw({ isExpanded, isFolder, className }: TreeChevronProps): react.JSX.Element;
 declare const TreeChevron: react.MemoExoticComponent<typeof TreeChevronRaw>;
 
 interface TreeIconProps {
@@ -859,7 +858,7 @@ interface TreeIconProps {
  * change. Reads appearance from context — context updates will still
  * trigger re-render as expected.
  */
-declare function TreeIconRaw({ isFolder, isExpanded, className }: TreeIconProps): react_jsx_runtime.JSX.Element;
+declare function TreeIconRaw({ isFolder, isExpanded, className }: TreeIconProps): react.JSX.Element;
 declare const TreeIcon: react.MemoExoticComponent<typeof TreeIconRaw>;
 
 interface TreeLabelProps {
@@ -873,7 +872,7 @@ interface TreeLabelProps {
  * Memoised: re-renders only when `children`, `isMatchingSearch` or
  * `className` change. `children` is compared by reference.
  */
-declare function TreeLabelRaw({ children, isMatchingSearch, className }: TreeLabelProps): react_jsx_runtime.JSX.Element;
+declare function TreeLabelRaw({ children, isMatchingSearch, className }: TreeLabelProps): react.JSX.Element;
 declare const TreeLabel: react.MemoExoticComponent<typeof TreeLabelRaw>;
 
 interface TreeRowProps<T> {
@@ -887,7 +886,7 @@ interface TreeRowProps<T> {
  * `row` is treated as immutable — the parent should not mutate node
  * objects in place.
  */
-declare function TreeRowRaw<T>({ row, className }: TreeRowProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeRowRaw<T>({ row, className }: TreeRowProps<T>): react.JSX.Element;
 declare const TreeRow: typeof TreeRowRaw;
 
 interface TreeContentProps<T> {
@@ -903,31 +902,31 @@ interface TreeContentProps<T> {
      */
     role?: 'tree' | 'group' | 'presentation';
 }
-declare function TreeContent<T>({ children, className, ariaLabel, role, }: TreeContentProps<T>): react_jsx_runtime.JSX.Element;
+declare function TreeContent<T>({ children, className, ariaLabel, role, }: TreeContentProps<T>): react.JSX.Element;
 
 interface TreeSearchInputProps {
     className?: string;
     showMatches?: boolean;
 }
-declare function TreeSearchInput({ className, showMatches }: TreeSearchInputProps): react_jsx_runtime.JSX.Element;
+declare function TreeSearchInput({ className, showMatches }: TreeSearchInputProps): react.JSX.Element;
 
 interface TreeEmptyProps {
     children: React.ReactNode;
     className?: string;
 }
-declare function TreeEmpty({ children, className }: TreeEmptyProps): react_jsx_runtime.JSX.Element;
+declare function TreeEmpty({ children, className }: TreeEmptyProps): react.JSX.Element;
 
 interface TreeSkeletonProps {
     rows?: number;
     className?: string;
 }
-declare function TreeSkeleton({ rows, className }: TreeSkeletonProps): react_jsx_runtime.JSX.Element;
+declare function TreeSkeleton({ rows, className }: TreeSkeletonProps): react.JSX.Element;
 
 interface TreeErrorProps {
     children: React.ReactNode;
     className?: string;
 }
-declare function TreeError({ children, className }: TreeErrorProps): react_jsx_runtime.JSX.Element;
+declare function TreeError({ children, className }: TreeErrorProps): react.JSX.Element;
 
 interface TreeIndentGuidesProps {
     level: number;
@@ -938,7 +937,7 @@ interface TreeIndentGuidesProps {
  * 1px column per ancestor level. Decorative — `aria-hidden` and
  * pointer-events disabled. Opacity comes from the tree appearance.
  */
-declare function TreeIndentGuides({ level, indent }: TreeIndentGuidesProps): react_jsx_runtime.JSX.Element;
+declare function TreeIndentGuides({ level, indent }: TreeIndentGuidesProps): react.JSX.Element;
 
 interface TreeRenameInputProps {
     initialValue: string;
@@ -962,7 +961,7 @@ interface TreeRenameInputProps {
  *   - all other keys are stopped from bubbling so Tree's container
  *     hotkeys (↑↓ delete F2 etc.) don't fire while typing.
  */
-declare function TreeRenameInput({ initialValue, isFolder, onCommit, onCancel, className, }: TreeRenameInputProps): react_jsx_runtime.JSX.Element;
+declare function TreeRenameInput({ initialValue, isFolder, onCommit, onCancel, className, }: TreeRenameInputProps): react.JSX.Element;
 
 interface TreeDropIndicatorProps {
     position: TreeMovePosition;
@@ -982,7 +981,7 @@ interface TreeDropIndicatorProps {
  *
  * Positioned absolutely — the parent `TreeRow` provides `position: relative`.
  */
-declare function TreeDropIndicator({ position, indent, invalid, }: TreeDropIndicatorProps): react_jsx_runtime.JSX.Element;
+declare function TreeDropIndicator({ position, indent, invalid, }: TreeDropIndicatorProps): react.JSX.Element;
 
 interface TreeEmptyAreaProps {
     className?: string;
@@ -1000,6 +999,6 @@ interface TreeEmptyAreaProps {
  * `adapter.createFile/Folder` and without a clipboard payload shows
  * no menu at all.
  */
-declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react_jsx_runtime.JSX.Element;
+declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react.JSX.Element;
 
 export { type ChildCache, type ChildEntry, type ChildEntryStatus, DEFAULT_TREE_APPEARANCE, DEFAULT_TREE_LABELS, type DemoNode, FinderTree, FlatRow, type FlattenInput, type PersistedTreeState, type ResolvedAppearance, TREE_DND_MIME, TreeRoot as Tree, type TreeAccentIntensity, type TreeActionsHandle, type TreeActivateOptions, type TreeActivationMode, type TreeAdapter, type TreeAppearance, type TreeBuiltinAction, TreeChevron, type TreeChevronProps, TreeContent, type TreeContentProps, TreeContextMenuActionsResolver, TreeContextMenuItem, TreeContextMenuSlot, type TreeContextValue, type TreeDensity, TreeDropIndicator, type TreeDropIndicatorProps, TreeEmpty, TreeEmptyArea, type TreeEmptyAreaProps, type TreeEmptyProps, TreeError, type TreeErrorProps, TreeIcon, type TreeIconProps, TreeIndentGuides, type TreeIndentGuidesProps, TreeItemId, TreeLabel, type TreeLabelProps, type TreeLabels, type TreeLoadChildren, type TreeMovePosition, TreeNode, TreeProvider, type TreeProviderProps, type TreeRadius, TreeRenameInput, type TreeRenameInputProps, TreeRoot, type TreeRootProps, TreeRow, type TreeRowProps, TreeRowRenderProps, type TreeRowSizing, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, type TreeVariant, type UseTreeFinderHotkeysOptions, type UseTreeKeyboardOptions, type UseTreeTypeAheadOptions, appearanceToStyle, autoSelectRange, clearTreeState, createChildCache, createDemoTree, TreeRoot as default, defaultCanDrop, flattenTree, loadTreeState, resolveAppearance, resolveChildren, resolveDropZone, saveTreeState, splitFileName, useTreeActions, useTreeClipboard, useTreeContext, useTreeDnd, useTreeExpansion, useTreeFinderHotkeys, useTreeFocus, useTreeKeyboard, useTreeLabels, useTreeRename, useTreeRows, useTreeSearch, useTreeSelection, useTreeTypeAhead };

package/dist/tree/index.mjs

@@ -2092,6 +2092,7 @@ function TreeEmpty({ children, className }) {
   return /* @__PURE__ */ jsx(
     "div",
     {
+      role: "status",
       className: cn(
         "flex h-full min-h-32 items-center justify-center px-4 py-6 text-sm text-muted-foreground",
         className
@@ -3025,6 +3026,7 @@ function TreeRootShell({
     [keyboardRef, finderHotkeysRef]
   );
   const focusedId = ctx.focused;
+  const isEmpty = ctx.flatRows.length === 0;
   useEffect(() => {
     if (!focusedId) return;
     const el = containerRef.current?.querySelector(
@@ -3049,11 +3051,11 @@ function TreeRootShell({
     "div",
     {
       ref: setContainerRef,
-      tabIndex: 0,
-      role: "tree",
-      "aria-label": ctx.labels.ariaLabel,
-      "aria-multiselectable": ctx.selectionMode === "multiple" || void 0,
-      "aria-activedescendant": focusedId ? treeRowDomId(focusedId) : void 0,
+      tabIndex: isEmpty ? void 0 : 0,
+      role: isEmpty ? void 0 : "tree",
+      "aria-label": isEmpty ? void 0 : ctx.labels.ariaLabel,
+      "aria-multiselectable": !isEmpty && ctx.selectionMode === "multiple" ? true : void 0,
+      "aria-activedescendant": !isEmpty && focusedId ? treeRowDomId(focusedId) : void 0,
       className: cn(
         "group/tree flex h-full w-full flex-col gap-2 rounded-sm outline-none",
         "focus-visible:ring-1 focus-visible:ring-ring/50",
@@ -3064,7 +3066,7 @@ function TreeRootShell({
       children: [
         enableSearch ? /* @__PURE__ */ jsx(TreeSearchInput, { className: "mx-2 mt-2" }) : null,
         /* @__PURE__ */ jsxs("div", { className: "flex min-h-0 flex-1 flex-col overflow-auto px-1", children: [
-          /* @__PURE__ */ jsx(TreeContent, { role: "group", children: renderRow }),
+          /* @__PURE__ */ jsx(TreeContent, { role: isEmpty ? "presentation" : "group", children: renderRow }),
           /* @__PURE__ */ jsx(TreeEmptyArea, {})
         ] })
       ]