dnd-block-tree 1.1.0 → 1.3.0

package/dist/index.d.mts

@@ -765,6 +765,44 @@ declare function generateId(): string;
  */
 declare function triggerHaptic(durationMs?: number): void;
 
+interface DevToolsEventEntry {
+    id: number;
+    timestamp: number;
+    type: 'dragStart' | 'dragEnd' | 'blockMove' | 'expandChange' | 'hoverChange';
+    summary: string;
+}
+interface DevToolsCallbacks<T extends BaseBlock = BaseBlock> {
+    onDragStart: NonNullable<BlockTreeCallbacks<T>['onDragStart']>;
+    onDragEnd: NonNullable<BlockTreeCallbacks<T>['onDragEnd']>;
+    onBlockMove: NonNullable<BlockTreeCallbacks<T>['onBlockMove']>;
+    onExpandChange: NonNullable<BlockTreeCallbacks<T>['onExpandChange']>;
+    onHoverChange: NonNullable<BlockTreeCallbacks<T>['onHoverChange']>;
+}
+interface BlockTreeDevToolsProps<T extends BaseBlock = BaseBlock> {
+    blocks: T[];
+    containerTypes?: readonly string[];
+    events: DevToolsEventEntry[];
+    onClearEvents: () => void;
+    /** Label function for diff view (default: block.type) */
+    getLabel?: (block: T) => string;
+    /** Initial open state (default: false) */
+    initialOpen?: boolean;
+    /** Position of the trigger button (default: 'bottom-left') */
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Custom inline styles for the trigger button */
+    buttonStyle?: React.CSSProperties;
+    /** Custom inline styles for the card panel */
+    panelStyle?: React.CSSProperties;
+    /** Force mount in production (default: false). DevTools renders nothing in production unless this is true. */
+    forceMount?: boolean;
+}
+declare function useDevToolsCallbacks<T extends BaseBlock = BaseBlock>(): {
+    callbacks: DevToolsCallbacks<T>;
+    events: DevToolsEventEntry[];
+    clearEvents: () => void;
+};
+declare function BlockTreeDevTools<T extends BaseBlock = BaseBlock>({ blocks, containerTypes, events, onClearEvents, getLabel, initialOpen, position, buttonStyle, panelStyle, forceMount, }: BlockTreeDevToolsProps<T>): react_jsx_runtime.JSX.Element | null;
+
 /**
  * A nested/tree representation of a block.
  * Omits `parentId` and `order` since they are reconstructed during flattening.
@@ -833,4 +871,4 @@ declare function initFractionalOrder<T extends {
     order: number | string;
 }>(blocks: T[]): T[];
 
-export { type AnimationConfig, type AutoExpandConfig, type BaseBlock, type BlockAction, type BlockAddEvent, type BlockDeleteEvent, type BlockIndex, type BlockMoveEvent, type BlockPosition, type BlockRendererProps, type BlockRenderers, type BlockStateContextValue, type BlockStateProviderProps, BlockTree, type BlockTreeCallbacks, type BlockTreeConfig, type BlockTreeCustomization, type BlockTreeProps, BlockTreeSSR, type BlockTreeSSRProps, type CanDragFn, type CanDropFn, type ContainerRendererProps, type DragEndEvent, type DragMoveEvent, DragOverlay, type DragOverlayProps$1 as DragOverlayProps, type DragStartEvent, DropZone, type DropZoneConfig, type DropZoneProps, type DropZoneType, type ExpandChangeEvent, type HoverChangeEvent, type IdGeneratorFn, type InternalRenderers, type MoveOperation, type NestedBlock, type OrderingStrategy, type RendererPropsFor, type SensorConfig, type SnapshotRectsRef, TreeRenderer, type TreeRendererProps, type TreeStateContextValue, type TreeStateProviderProps, type TreeValidationResult, type UseBlockHistoryOptions, type UseBlockHistoryResult, type UseLayoutAnimationOptions, type UseVirtualTreeOptions, type UseVirtualTreeResult, buildOrderedBlocks, cloneMap, cloneParentMap, closestCenterCollision, compareFractionalKeys, computeNormalizedIndex, createBlockState, createStickyCollision, createTreeState, debounce, deleteBlockAndDescendants, extractBlockId, extractUUID, flatToNested, generateId, generateInitialKeys, generateKeyBetween, generateNKeysBetween, getBlockDepth, getDescendantIds, getDropZoneType, getSensorConfig, getSubtreeDepth, initFractionalOrder, nestedToFlat, reparentBlockIndex, reparentMultipleBlocks, triggerHaptic, useBlockHistory, useConfiguredSensors, useLayoutAnimation, useVirtualTree, validateBlockTree, weightedVerticalCollision };
+export { type AnimationConfig, type AutoExpandConfig, type BaseBlock, type BlockAction, type BlockAddEvent, type BlockDeleteEvent, type BlockIndex, type BlockMoveEvent, type BlockPosition, type BlockRendererProps, type BlockRenderers, type BlockStateContextValue, type BlockStateProviderProps, BlockTree, type BlockTreeCallbacks, type BlockTreeConfig, type BlockTreeCustomization, BlockTreeDevTools, type BlockTreeDevToolsProps, type BlockTreeProps, BlockTreeSSR, type BlockTreeSSRProps, type CanDragFn, type CanDropFn, type ContainerRendererProps, type DevToolsCallbacks, type DevToolsEventEntry, type DragEndEvent, type DragMoveEvent, DragOverlay, type DragOverlayProps$1 as DragOverlayProps, type DragStartEvent, DropZone, type DropZoneConfig, type DropZoneProps, type DropZoneType, type ExpandChangeEvent, type HoverChangeEvent, type IdGeneratorFn, type InternalRenderers, type MoveOperation, type NestedBlock, type OrderingStrategy, type RendererPropsFor, type SensorConfig, type SnapshotRectsRef, TreeRenderer, type TreeRendererProps, type TreeStateContextValue, type TreeStateProviderProps, type TreeValidationResult, type UseBlockHistoryOptions, type UseBlockHistoryResult, type UseLayoutAnimationOptions, type UseVirtualTreeOptions, type UseVirtualTreeResult, buildOrderedBlocks, cloneMap, cloneParentMap, closestCenterCollision, compareFractionalKeys, computeNormalizedIndex, createBlockState, createStickyCollision, createTreeState, debounce, deleteBlockAndDescendants, extractBlockId, extractUUID, flatToNested, generateId, generateInitialKeys, generateKeyBetween, generateNKeysBetween, getBlockDepth, getDescendantIds, getDropZoneType, getSensorConfig, getSubtreeDepth, initFractionalOrder, nestedToFlat, reparentBlockIndex, reparentMultipleBlocks, triggerHaptic, useBlockHistory, useConfiguredSensors, useDevToolsCallbacks, useLayoutAnimation, useVirtualTree, validateBlockTree, weightedVerticalCollision };

package/dist/index.d.ts

@@ -765,6 +765,44 @@ declare function generateId(): string;
  */
 declare function triggerHaptic(durationMs?: number): void;
 
+interface DevToolsEventEntry {
+    id: number;
+    timestamp: number;
+    type: 'dragStart' | 'dragEnd' | 'blockMove' | 'expandChange' | 'hoverChange';
+    summary: string;
+}
+interface DevToolsCallbacks<T extends BaseBlock = BaseBlock> {
+    onDragStart: NonNullable<BlockTreeCallbacks<T>['onDragStart']>;
+    onDragEnd: NonNullable<BlockTreeCallbacks<T>['onDragEnd']>;
+    onBlockMove: NonNullable<BlockTreeCallbacks<T>['onBlockMove']>;
+    onExpandChange: NonNullable<BlockTreeCallbacks<T>['onExpandChange']>;
+    onHoverChange: NonNullable<BlockTreeCallbacks<T>['onHoverChange']>;
+}
+interface BlockTreeDevToolsProps<T extends BaseBlock = BaseBlock> {
+    blocks: T[];
+    containerTypes?: readonly string[];
+    events: DevToolsEventEntry[];
+    onClearEvents: () => void;
+    /** Label function for diff view (default: block.type) */
+    getLabel?: (block: T) => string;
+    /** Initial open state (default: false) */
+    initialOpen?: boolean;
+    /** Position of the trigger button (default: 'bottom-left') */
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Custom inline styles for the trigger button */
+    buttonStyle?: React.CSSProperties;
+    /** Custom inline styles for the card panel */
+    panelStyle?: React.CSSProperties;
+    /** Force mount in production (default: false). DevTools renders nothing in production unless this is true. */
+    forceMount?: boolean;
+}
+declare function useDevToolsCallbacks<T extends BaseBlock = BaseBlock>(): {
+    callbacks: DevToolsCallbacks<T>;
+    events: DevToolsEventEntry[];
+    clearEvents: () => void;
+};
+declare function BlockTreeDevTools<T extends BaseBlock = BaseBlock>({ blocks, containerTypes, events, onClearEvents, getLabel, initialOpen, position, buttonStyle, panelStyle, forceMount, }: BlockTreeDevToolsProps<T>): react_jsx_runtime.JSX.Element | null;
+
 /**
  * A nested/tree representation of a block.
  * Omits `parentId` and `order` since they are reconstructed during flattening.
@@ -833,4 +871,4 @@ declare function initFractionalOrder<T extends {
     order: number | string;
 }>(blocks: T[]): T[];
 
-export { type AnimationConfig, type AutoExpandConfig, type BaseBlock, type BlockAction, type BlockAddEvent, type BlockDeleteEvent, type BlockIndex, type BlockMoveEvent, type BlockPosition, type BlockRendererProps, type BlockRenderers, type BlockStateContextValue, type BlockStateProviderProps, BlockTree, type BlockTreeCallbacks, type BlockTreeConfig, type BlockTreeCustomization, type BlockTreeProps, BlockTreeSSR, type BlockTreeSSRProps, type CanDragFn, type CanDropFn, type ContainerRendererProps, type DragEndEvent, type DragMoveEvent, DragOverlay, type DragOverlayProps$1 as DragOverlayProps, type DragStartEvent, DropZone, type DropZoneConfig, type DropZoneProps, type DropZoneType, type ExpandChangeEvent, type HoverChangeEvent, type IdGeneratorFn, type InternalRenderers, type MoveOperation, type NestedBlock, type OrderingStrategy, type RendererPropsFor, type SensorConfig, type SnapshotRectsRef, TreeRenderer, type TreeRendererProps, type TreeStateContextValue, type TreeStateProviderProps, type TreeValidationResult, type UseBlockHistoryOptions, type UseBlockHistoryResult, type UseLayoutAnimationOptions, type UseVirtualTreeOptions, type UseVirtualTreeResult, buildOrderedBlocks, cloneMap, cloneParentMap, closestCenterCollision, compareFractionalKeys, computeNormalizedIndex, createBlockState, createStickyCollision, createTreeState, debounce, deleteBlockAndDescendants, extractBlockId, extractUUID, flatToNested, generateId, generateInitialKeys, generateKeyBetween, generateNKeysBetween, getBlockDepth, getDescendantIds, getDropZoneType, getSensorConfig, getSubtreeDepth, initFractionalOrder, nestedToFlat, reparentBlockIndex, reparentMultipleBlocks, triggerHaptic, useBlockHistory, useConfiguredSensors, useLayoutAnimation, useVirtualTree, validateBlockTree, weightedVerticalCollision };
+export { type AnimationConfig, type AutoExpandConfig, type BaseBlock, type BlockAction, type BlockAddEvent, type BlockDeleteEvent, type BlockIndex, type BlockMoveEvent, type BlockPosition, type BlockRendererProps, type BlockRenderers, type BlockStateContextValue, type BlockStateProviderProps, BlockTree, type BlockTreeCallbacks, type BlockTreeConfig, type BlockTreeCustomization, BlockTreeDevTools, type BlockTreeDevToolsProps, type BlockTreeProps, BlockTreeSSR, type BlockTreeSSRProps, type CanDragFn, type CanDropFn, type ContainerRendererProps, type DevToolsCallbacks, type DevToolsEventEntry, type DragEndEvent, type DragMoveEvent, DragOverlay, type DragOverlayProps$1 as DragOverlayProps, type DragStartEvent, DropZone, type DropZoneConfig, type DropZoneProps, type DropZoneType, type ExpandChangeEvent, type HoverChangeEvent, type IdGeneratorFn, type InternalRenderers, type MoveOperation, type NestedBlock, type OrderingStrategy, type RendererPropsFor, type SensorConfig, type SnapshotRectsRef, TreeRenderer, type TreeRendererProps, type TreeStateContextValue, type TreeStateProviderProps, type TreeValidationResult, type UseBlockHistoryOptions, type UseBlockHistoryResult, type UseLayoutAnimationOptions, type UseVirtualTreeOptions, type UseVirtualTreeResult, buildOrderedBlocks, cloneMap, cloneParentMap, closestCenterCollision, compareFractionalKeys, computeNormalizedIndex, createBlockState, createStickyCollision, createTreeState, debounce, deleteBlockAndDescendants, extractBlockId, extractUUID, flatToNested, generateId, generateInitialKeys, generateKeyBetween, generateNKeysBetween, getBlockDepth, getDescendantIds, getDropZoneType, getSensorConfig, getSubtreeDepth, initFractionalOrder, nestedToFlat, reparentBlockIndex, reparentMultipleBlocks, triggerHaptic, useBlockHistory, useConfiguredSensors, useDevToolsCallbacks, useLayoutAnimation, useVirtualTree, validateBlockTree, weightedVerticalCollision };