react-reason-editor-sidebar 0.1.0 → 0.1.2

package/dist/SidebarToolbar.d.ts

@@ -44,6 +44,12 @@ interface SidebarToolbarProps {
     allExpanded: boolean;
     /** Tooltip label describing what the expand-all toggle will do next (cycles by folder level). */
     expandToggleLabel: string;
+    /**
+     * Disables the expand-all toggle when there is no file tree behind it —
+     * the Files panel is turned off for this sidebar or lives in the other
+     * one — so the button doesn't advertise a cycle it cannot run.
+     */
+    expandToggleDisabled?: boolean;
     /** Whether all outline entries are currently expanded. */
     outlineExpanded: boolean;
     /** Steps the tree to its next expansion level (wraps to fully collapsed). */
@@ -85,5 +91,5 @@ interface SidebarToolbarProps {
  * file-source, search, file-manager, new-file/folder, and collapse-all
  * buttons; the outline panel additionally shows an expand/collapse toggle.
  */
-export declare const SidebarToolbar: ({ leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, activeId, onAdd, onSearchFocus, onFileManagerOpen, sources, activeSource, activeFileSourceId, onFileSourceChange, onSourceSelect, allExpanded, expandToggleLabel, outlineExpanded, onToggleAllExpanded, onToggleOutlineExpanded, treeRef, outlineRef, deletedDocs, onRestore, showDynamicIsland, onToggleDynamicIsland, onSettingsClick, isMobile, openTabs, activeTab, onTabChange, onTabClose, documents, tabItems, }: SidebarToolbarProps) => import("react").JSX.Element;
+export declare const SidebarToolbar: ({ leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, activeId, onAdd, onSearchFocus, onFileManagerOpen, sources, activeSource, activeFileSourceId, onFileSourceChange, onSourceSelect, allExpanded, expandToggleLabel, expandToggleDisabled, outlineExpanded, onToggleAllExpanded, onToggleOutlineExpanded, treeRef, outlineRef, deletedDocs, onRestore, showDynamicIsland, onToggleDynamicIsland, onSettingsClick, isMobile, openTabs, activeTab, onTabChange, onTabClose, documents, tabItems, }: SidebarToolbarProps) => import("react").JSX.Element;
 export {};

package/dist/file-tree/index.d.ts

@@ -7,3 +7,5 @@ export { FileTreeContextMenu } from "./FileTreeContextMenu";
 export { useFileTreeOperations } from "./useFileTreeOperations";
 export * from "./expandLevels";
 export * from "./documentUtils";
+export { useExpandCycle } from "./useExpandCycle";
+export type { ExpandCycle, ExpandState } from "./useExpandCycle";

package/dist/file-tree/useExpandCycle.d.ts

@@ -0,0 +1,30 @@
+import type { RefObject } from 'react';
+import type { DocumentTreeHandle } from './filetree';
+/** Expansion depth of a file tree: `level` of `maxLevel` folder levels shown. */
+export interface ExpandState {
+    level: number;
+    maxLevel: number;
+}
+export interface ExpandCycle {
+    /** True while there is a mounted tree with at least one folder to cycle. */
+    canCycle: boolean;
+    /** True once every folder level is showing, so the next click collapses. */
+    isFullyExpanded: boolean;
+    /** Describes the action the next click performs, for tooltip and label. */
+    label: string;
+    /** Hand this to the tree's `onExpandStateChange`. */
+    onExpandStateChange: (next: ExpandState) => void;
+    /** The depth the tree last reported. */
+    state: ExpandState;
+    /** Steps one folder level deeper, wrapping back to fully collapsed. */
+    toggle: () => void;
+}
+/**
+ * Drives the expand/collapse cycle of the tree behind `treeRef`.
+ *
+ * @param treeRef - Ref to the file tree being cycled. May be empty; the
+ *   returned `canCycle` is false until a tree with folders reports in.
+ * @param onStateChange - Optional passthrough, so a host that renders the
+ *   control somewhere else (the sidebar toolbar) can mirror the same depth.
+ */
+export declare function useExpandCycle(treeRef: RefObject<DocumentTreeHandle | null>, onStateChange?: (next: ExpandState) => void): ExpandCycle;