@djangocfg/ui-tools 2.1.416 → 2.1.418

package/dist/tree/index.d.cts

@@ -300,9 +300,23 @@ interface TreeRootProps<T> {
      * adapter for hotkeys / DnD.
      */
     defaultMenuItems?: TreeBuiltinAction[];
+    /**
+     * Imperative handle for outer code. The provided ref receives a
+     * stable handle to `useTreeActions` once Tree mounts. Lets host
+     * components trigger `refresh(id)` / `refreshAll()` from outside
+     * Tree (e.g. after a transport-level mutation completes).
+     */
+    actionsRef?: React.MutableRefObject<TreeActionsHandle | null>;
     className?: string;
     style?: CSSProperties;
 }
+/** Subset of `useTreeActions()` exposed via `<TreeRoot actionsRef={…}>`. */
+interface TreeActionsHandle {
+    refresh: (id: string) => Promise<void>;
+    refreshAll: () => Promise<void>;
+    expandAll: () => void;
+    collapseAll: () => void;
+}
 
 /**
  * High-level entry point. Wraps Provider + (optional) search bar + content.
@@ -958,4 +972,4 @@ interface TreeEmptyAreaProps {
  */
 declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react_jsx_runtime.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 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, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, 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 };
+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, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, 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

@@ -300,9 +300,23 @@ interface TreeRootProps<T> {
      * adapter for hotkeys / DnD.
      */
     defaultMenuItems?: TreeBuiltinAction[];
+    /**
+     * Imperative handle for outer code. The provided ref receives a
+     * stable handle to `useTreeActions` once Tree mounts. Lets host
+     * components trigger `refresh(id)` / `refreshAll()` from outside
+     * Tree (e.g. after a transport-level mutation completes).
+     */
+    actionsRef?: React.MutableRefObject<TreeActionsHandle | null>;
     className?: string;
     style?: CSSProperties;
 }
+/** Subset of `useTreeActions()` exposed via `<TreeRoot actionsRef={…}>`. */
+interface TreeActionsHandle {
+    refresh: (id: string) => Promise<void>;
+    refreshAll: () => Promise<void>;
+    expandAll: () => void;
+    collapseAll: () => void;
+}
 
 /**
  * High-level entry point. Wraps Provider + (optional) search bar + content.
@@ -958,4 +972,4 @@ interface TreeEmptyAreaProps {
  */
 declare function TreeEmptyArea({ className }: TreeEmptyAreaProps): react_jsx_runtime.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 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, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, 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 };
+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, TreeRowSlot, TreeSearchInput, type TreeSearchInputProps, type TreeSelectionMode, TreeSkeleton, type TreeSkeletonProps, 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

@@ -2,10 +2,10 @@ import { __name } from '../chunk-PAWJFY3S.mjs';
 import * as React from 'react';
 import { createContext, memo, useRef, useCallback, useMemo, useEffect, useState, useReducer, Fragment as Fragment$1 } from 'react';
 import { cn } from '@djangocfg/ui-core/lib';
-import { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuSeparator, ContextMenuItem, ContextMenuShortcut } from '@djangocfg/ui-core/components';
 import { getDialog } from '@djangocfg/ui-core/lib/dialog-service';
 import { CornerUpLeft, Pencil, Copy, Scissors, Trash2, FilePlus, FolderPlus, ChevronDown, ChevronRight, FolderOpen, Folder, File, Loader2, Search, X, AlertCircle } from 'lucide-react';
-import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
+import { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuSeparator, ContextMenuItem, ContextMenuShortcut } from '@djangocfg/ui-core/components';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { useSensors, useSensor, PointerSensor, KeyboardSensor, DndContext, useDraggable, useDroppable } from '@dnd-kit/core';
 import { useHotkey } from '@djangocfg/ui-core/hooks';
 
@@ -1048,6 +1048,47 @@ function useResolvedMenu(opts) {
   ]);
 }
 __name(useResolvedMenu, "useResolvedMenu");
+function renderItemsAsContextMenu(rowProps, items, trigger) {
+  return /* @__PURE__ */ jsxs(ContextMenu, { children: [
+    /* @__PURE__ */ jsx(ContextMenuTrigger, { asChild: true, children: trigger }),
+    /* @__PURE__ */ jsx(ContextMenuContent, { children: items.map((item, idx) => {
+      if (item === "separator") {
+        return /* @__PURE__ */ jsx(ContextMenuSeparator, {}, `sep-${idx}`);
+      }
+      const Icon = item.icon;
+      return /* @__PURE__ */ jsxs(
+        ContextMenuItem,
+        {
+          disabled: item.disabled,
+          variant: item.destructive ? "destructive" : void 0,
+          onSelect: () => item.onSelect(rowProps),
+          children: [
+            Icon ? /* @__PURE__ */ jsx(Icon, {}) : null,
+            item.label,
+            item.shortcut ? /* @__PURE__ */ jsx(ContextMenuShortcut, { children: item.shortcut }) : null
+          ]
+        },
+        item.id
+      );
+    }) })
+  ] });
+}
+__name(renderItemsAsContextMenu, "renderItemsAsContextMenu");
+function tidyMenuItems(items) {
+  const out = [];
+  for (const it of items) {
+    if (it === "separator") {
+      if (out.length === 0) continue;
+      if (out[out.length - 1] === "separator") continue;
+      out.push(it);
+    } else {
+      out.push(it);
+    }
+  }
+  while (out.length > 0 && out[out.length - 1] === "separator") out.pop();
+  return out;
+}
+__name(tidyMenuItems, "tidyMenuItems");
 
 // src/tools/data/Tree/data/dnd.ts
 function resolveDropZone(input) {
@@ -1412,6 +1453,20 @@ function TreeProvider(props) {
     copyToClipboard: clipboard.copyToClipboard,
     pasteFromClipboard: clipboard.pasteFromClipboard
   });
+  const finalRenderContextMenu = useMemo(
+    () => {
+      if (renderContextMenu) return renderContextMenu;
+      const resolve = resolvedContextMenuActions;
+      if (!resolve) return void 0;
+      return (rowProps, trigger) => {
+        const items = resolve(rowProps);
+        const cleaned = items ? tidyMenuItems(items) : null;
+        if (!cleaned || cleaned.length === 0) return trigger;
+        return renderItemsAsContextMenu(rowProps, cleaned, trigger);
+      };
+    },
+    [renderContextMenu, resolvedContextMenuActions]
+  );
   const value = useMemo(
     () => ({
       // state
@@ -1453,7 +1508,7 @@ function TreeProvider(props) {
       renderIcon,
       renderLabel,
       renderActions,
-      renderContextMenu,
+      renderContextMenu: finalRenderContextMenu,
       adapter,
       resolvedContextMenuActions,
       getNodeById: /* @__PURE__ */ __name((id) => nodeById.get(id), "getNodeById"),
@@ -1490,7 +1545,7 @@ function TreeProvider(props) {
       renderIcon,
       renderLabel,
       renderActions,
-      renderContextMenu,
+      finalRenderContextMenu,
       adapter,
       resolvedContextMenuActions,
       nodeById,
@@ -2766,47 +2821,6 @@ function useTreeFinderHotkeys(opts) {
   return { ref };
 }
 __name(useTreeFinderHotkeys, "useTreeFinderHotkeys");
-function renderItemsAsContextMenu(rowProps, items, trigger) {
-  return /* @__PURE__ */ jsxs(ContextMenu, { children: [
-    /* @__PURE__ */ jsx(ContextMenuTrigger, { asChild: true, children: trigger }),
-    /* @__PURE__ */ jsx(ContextMenuContent, { children: items.map((item, idx) => {
-      if (item === "separator") {
-        return /* @__PURE__ */ jsx(ContextMenuSeparator, {}, `sep-${idx}`);
-      }
-      const Icon = item.icon;
-      return /* @__PURE__ */ jsxs(
-        ContextMenuItem,
-        {
-          disabled: item.disabled,
-          variant: item.destructive ? "destructive" : void 0,
-          onSelect: () => item.onSelect(rowProps),
-          children: [
-            Icon ? /* @__PURE__ */ jsx(Icon, {}) : null,
-            item.label,
-            item.shortcut ? /* @__PURE__ */ jsx(ContextMenuShortcut, { children: item.shortcut }) : null
-          ]
-        },
-        item.id
-      );
-    }) })
-  ] });
-}
-__name(renderItemsAsContextMenu, "renderItemsAsContextMenu");
-function tidyMenuItems(items) {
-  const out = [];
-  for (const it of items) {
-    if (it === "separator") {
-      if (out.length === 0) continue;
-      if (out[out.length - 1] === "separator") continue;
-      out.push(it);
-    } else {
-      out.push(it);
-    }
-  }
-  while (out.length > 0 && out[out.length - 1] === "separator") out.pop();
-  return out;
-}
-__name(tidyMenuItems, "tidyMenuItems");
 function TreeRoot(props) {
   const {
     data,
@@ -2840,6 +2854,7 @@ function TreeRoot(props) {
     persistSelection = false,
     adapter,
     defaultMenuItems,
+    actionsRef,
     className,
     style
   } = props;
@@ -2882,7 +2897,8 @@ function TreeRoot(props) {
           enableSearch,
           enableTypeAhead,
           enableFinderHotkeys,
-          renderRow
+          renderRow,
+          actionsRef
         }
       )
     }
@@ -2895,10 +2911,29 @@ function TreeRootShell({
   enableSearch,
   enableTypeAhead,
   enableFinderHotkeys,
-  renderRow
+  renderRow,
+  actionsRef
 }) {
   const containerRef = useRef(null);
   const ctx = useTreeContext();
+  useEffect(() => {
+    if (!actionsRef) return;
+    actionsRef.current = {
+      refresh: ctx.refresh,
+      refreshAll: ctx.refreshAll,
+      expandAll: ctx.expandAll,
+      collapseAll: ctx.collapseAll
+    };
+    return () => {
+      if (actionsRef.current) actionsRef.current = null;
+    };
+  }, [
+    actionsRef,
+    ctx.refresh,
+    ctx.refreshAll,
+    ctx.expandAll,
+    ctx.collapseAll
+  ]);
   const isMulti = ctx.selectionMode === "multiple";
   const { ref: keyboardRef } = useTreeKeyboard({
     rows: ctx.flatRows,
@@ -2975,21 +3010,6 @@ function TreeRootShell({
     onMatch: onTypeAheadMatch,
     enabled: enableTypeAhead
   });
-  const finalRenderContextMenu = useMemo(() => {
-    if (ctx.renderContextMenu) return ctx.renderContextMenu;
-    const resolve = ctx.resolvedContextMenuActions;
-    if (!resolve) return void 0;
-    return (rowProps, trigger) => {
-      const items = resolve(rowProps);
-      const cleaned = items ? tidyMenuItems(items) : null;
-      if (!cleaned || cleaned.length === 0) return trigger;
-      return renderItemsAsContextMenu(rowProps, cleaned, trigger);
-    };
-  }, [ctx.renderContextMenu, ctx.resolvedContextMenuActions]);
-  const childCtx = useMemo(
-    () => ({ ...ctx, renderContextMenu: finalRenderContextMenu }),
-    [ctx, finalRenderContextMenu]
-  );
   const treeBody = /* @__PURE__ */ jsxs(
     "div",
     {
@@ -3015,8 +3035,7 @@ function TreeRootShell({
       ]
     }
   );
-  const body = finalRenderContextMenu === ctx.renderContextMenu ? treeBody : /* @__PURE__ */ jsx(TreeContext.Provider, { value: childCtx, children: treeBody });
-  return /* @__PURE__ */ jsx(TreeDndProvider, { children: body });
+  return /* @__PURE__ */ jsx(TreeDndProvider, { children: treeBody });
 }
 __name(TreeRootShell, "TreeRootShell");
 var TreeRoot_default = TreeRoot;