react-zeugma 6.4.0 → 6.4.2

package/dist/{types-B9LrYapR.d.cts → types-BN5W7EvY.d.cts}

@@ -1,4 +1,4 @@
-import { ReactNode, RefObject, Dispatch, SetStateAction } from 'react';
+import { Dispatch, SetStateAction, ReactNode } from 'react';
 
 type SplitDirection = 'row' | 'column';
 interface SplitNode {
@@ -90,20 +90,6 @@ interface ZeugmaQueries {
 }
 interface ZeugmaController extends ZeugmaState, ZeugmaStateSetters, ZeugmaActions, ZeugmaQueries {
 }
-/** @internal Internal controller containing transient drag-and-drop orchestration state. */
-interface ZeugmaControllerInternal extends ZeugmaController {
-    _internalSetLayout: Dispatch<SetStateAction<TreeNode | null>>;
-    activeId: string | null;
-    setActiveId: Dispatch<SetStateAction<string | null>>;
-    activeType: 'pane' | 'tab' | null;
-    setActiveType: Dispatch<SetStateAction<'pane' | 'tab' | null>>;
-    dismissIntentId: string | null;
-    setDismissIntentId: Dispatch<SetStateAction<string | null>>;
-    containerRef: RefObject<HTMLElement | null>;
-    setContainerRef: (element: HTMLElement | null) => void;
-    layoutBeforeDrag: TreeNode | null;
-    setLayoutBeforeDrag: Dispatch<SetStateAction<TreeNode | null>>;
-}
 interface ZeugmaClassNames {
     /** CSS class applied to the root dashboard container. */
     dashboard?: string;
@@ -157,13 +143,13 @@ interface DragOverlayActiveItem {
 }
 interface ZeugmaProps {
     /** The Zeugma Controller returned by useZeugma() */
-    controller: ZeugmaController;
+    controller?: ZeugmaController;
     /** Custom overlay renderer function used to customize the cursor-following drag preview for an active pane or tab. */
     renderDragOverlay?: (active: DragOverlayActiveItem) => ReactNode;
     /** Optional CSS class name mapping overrides for custom styles of components like panes, drop previews, overlays, etc. */
     classNames?: ZeugmaClassNames;
     /** Render function mapping unique pane nodes to React elements. Usually renders a <Pane> wrapper. */
-    renderPane: (paneId: string) => ReactNode;
+    renderPane?: (paneId: string) => ReactNode;
     /** Size/thickness of the split handle resizer bars in pixels. */
     resizerSize?: number;
     /** Minimum pixel distance that a user must drag a pane handle before dragging triggers. Defaults to 8. */
@@ -197,59 +183,11 @@ interface ZeugmaProps {
     /** Callback triggered when the drag-out/dismiss intent changes. */
     onDismissIntentChange?: (paneId: string | null) => void;
 }
-/**
- * State context — holds reactive values that change during runtime.
- * All consumers of this context will re-render when any of these values change.
- */
-/**
- * State context — holds reactive values that change during runtime.
- * All consumers of this context will re-render when any of these values change.
- */
-interface ZeugmaStateValue extends ZeugmaState, ZeugmaQueries {
-    /** Callback to update the layout tree. */
-    setLayout: Dispatch<SetStateAction<TreeNode | null>>;
-    /** Programmatically updates the global locked status. */
-    setLocked: Dispatch<SetStateAction<boolean>>;
-    /** Normalized or overridden CSS classes for custom layout styling. */
-    classNames: ZeugmaClassNames;
-    /** Render function mapping unique pane nodes to React elements. */
-    renderPane: (paneId: string) => ReactNode;
-    /** The ID of the active dragged item (pane or tab). */
-    activeId: string | null;
-    /** The type of the active dragged item ('pane' | 'tab'). */
-    activeType: 'pane' | 'tab' | null;
-    /** The ID of the item with active dismiss intent, or null. */
-    dismissIntentId: string | null;
-    setContainerRef: (element: HTMLElement | null) => void;
-    onRemove?: (paneId: string) => void;
-    onFullscreenChange?: (paneId: string | null) => void;
-    snapThreshold?: number;
-    onResizeStart?: (currentNode: SplitNode) => void;
-    onResize?: (currentNode: SplitNode, percentage: number) => void;
-    onResizeEnd?: (currentNode: SplitNode, percentage: number) => void;
-    minSplitPercentage?: number;
-    maxSplitPercentage?: number;
-}
-interface ZeugmaDragStateValue {
-    /** The ID of the tab currently hovered over during a tab drag, or null. */
-    overTabId: string | null;
-    /** The position of the tab drop preview relative to the hovered tab ('before' | 'after'). */
-    overTabPosition: 'before' | 'after' | null;
-}
-/**
- * Actions context — holds stable dispatch functions with permanent identity.
- * Consumers of only this context will never re-render from layout/drag state changes.
- */
-interface ZeugmaActionsValue extends ZeugmaActions {
-    /** Programmatically sets the fullscreen pane ID. */
-    setFullscreenPaneId: (paneId: string | null) => void;
-    /** Programmatically updates the global locked status. */
-    setLocked: Dispatch<SetStateAction<boolean>>;
-}
-interface PortalRegistryValue {
-    registerPortalTarget: (tabId: string, el: HTMLDivElement | null) => void;
-    registerRenderCallback: (tabId: string, render: (tab: TabDetails) => ReactNode) => void;
-    renderCallbacksRef: RefObject<Record<string, (tab: TabDetails) => ReactNode>>;
+interface ZeugmaProviderProps extends Omit<ZeugmaProps, 'controller'> {
+    /** The Zeugma Controller returned by useZeugma() */
+    controller: ZeugmaController;
+    /** Children components that will have access to the Zeugma context */
+    children: ReactNode;
 }
 
-export type { DragOverlayActiveItem as D, PortalRegistryValue as P, SplitDirection as S, TreeNode as T, UseZeugmaOptions as U, ZeugmaActionsValue as Z, ZeugmaDragStateValue as a, ZeugmaStateValue as b, ZeugmaController as c, ZeugmaProps as d, SplitNode as e, TabDetails as f, PaneNode as g, ZeugmaActions as h, ZeugmaClassNames as i, ZeugmaControllerInternal as j, ZeugmaQueries as k, ZeugmaState as l, ZeugmaStateSetters as m };
+export type { DragOverlayActiveItem as D, PaneNode as P, SplitDirection as S, TreeNode as T, UseZeugmaOptions as U, ZeugmaController as Z, ZeugmaProps as a, ZeugmaProviderProps as b, SplitNode as c, TabDetails as d, ZeugmaClassNames as e };

package/dist/{types-B9LrYapR.d.ts → types-BN5W7EvY.d.ts}

@@ -1,4 +1,4 @@
-import { ReactNode, RefObject, Dispatch, SetStateAction } from 'react';
+import { Dispatch, SetStateAction, ReactNode } from 'react';
 
 type SplitDirection = 'row' | 'column';
 interface SplitNode {
@@ -90,20 +90,6 @@ interface ZeugmaQueries {
 }
 interface ZeugmaController extends ZeugmaState, ZeugmaStateSetters, ZeugmaActions, ZeugmaQueries {
 }
-/** @internal Internal controller containing transient drag-and-drop orchestration state. */
-interface ZeugmaControllerInternal extends ZeugmaController {
-    _internalSetLayout: Dispatch<SetStateAction<TreeNode | null>>;
-    activeId: string | null;
-    setActiveId: Dispatch<SetStateAction<string | null>>;
-    activeType: 'pane' | 'tab' | null;
-    setActiveType: Dispatch<SetStateAction<'pane' | 'tab' | null>>;
-    dismissIntentId: string | null;
-    setDismissIntentId: Dispatch<SetStateAction<string | null>>;
-    containerRef: RefObject<HTMLElement | null>;
-    setContainerRef: (element: HTMLElement | null) => void;
-    layoutBeforeDrag: TreeNode | null;
-    setLayoutBeforeDrag: Dispatch<SetStateAction<TreeNode | null>>;
-}
 interface ZeugmaClassNames {
     /** CSS class applied to the root dashboard container. */
     dashboard?: string;
@@ -157,13 +143,13 @@ interface DragOverlayActiveItem {
 }
 interface ZeugmaProps {
     /** The Zeugma Controller returned by useZeugma() */
-    controller: ZeugmaController;
+    controller?: ZeugmaController;
     /** Custom overlay renderer function used to customize the cursor-following drag preview for an active pane or tab. */
     renderDragOverlay?: (active: DragOverlayActiveItem) => ReactNode;
     /** Optional CSS class name mapping overrides for custom styles of components like panes, drop previews, overlays, etc. */
     classNames?: ZeugmaClassNames;
     /** Render function mapping unique pane nodes to React elements. Usually renders a <Pane> wrapper. */
-    renderPane: (paneId: string) => ReactNode;
+    renderPane?: (paneId: string) => ReactNode;
     /** Size/thickness of the split handle resizer bars in pixels. */
     resizerSize?: number;
     /** Minimum pixel distance that a user must drag a pane handle before dragging triggers. Defaults to 8. */
@@ -197,59 +183,11 @@ interface ZeugmaProps {
     /** Callback triggered when the drag-out/dismiss intent changes. */
     onDismissIntentChange?: (paneId: string | null) => void;
 }
-/**
- * State context — holds reactive values that change during runtime.
- * All consumers of this context will re-render when any of these values change.
- */
-/**
- * State context — holds reactive values that change during runtime.
- * All consumers of this context will re-render when any of these values change.
- */
-interface ZeugmaStateValue extends ZeugmaState, ZeugmaQueries {
-    /** Callback to update the layout tree. */
-    setLayout: Dispatch<SetStateAction<TreeNode | null>>;
-    /** Programmatically updates the global locked status. */
-    setLocked: Dispatch<SetStateAction<boolean>>;
-    /** Normalized or overridden CSS classes for custom layout styling. */
-    classNames: ZeugmaClassNames;
-    /** Render function mapping unique pane nodes to React elements. */
-    renderPane: (paneId: string) => ReactNode;
-    /** The ID of the active dragged item (pane or tab). */
-    activeId: string | null;
-    /** The type of the active dragged item ('pane' | 'tab'). */
-    activeType: 'pane' | 'tab' | null;
-    /** The ID of the item with active dismiss intent, or null. */
-    dismissIntentId: string | null;
-    setContainerRef: (element: HTMLElement | null) => void;
-    onRemove?: (paneId: string) => void;
-    onFullscreenChange?: (paneId: string | null) => void;
-    snapThreshold?: number;
-    onResizeStart?: (currentNode: SplitNode) => void;
-    onResize?: (currentNode: SplitNode, percentage: number) => void;
-    onResizeEnd?: (currentNode: SplitNode, percentage: number) => void;
-    minSplitPercentage?: number;
-    maxSplitPercentage?: number;
-}
-interface ZeugmaDragStateValue {
-    /** The ID of the tab currently hovered over during a tab drag, or null. */
-    overTabId: string | null;
-    /** The position of the tab drop preview relative to the hovered tab ('before' | 'after'). */
-    overTabPosition: 'before' | 'after' | null;
-}
-/**
- * Actions context — holds stable dispatch functions with permanent identity.
- * Consumers of only this context will never re-render from layout/drag state changes.
- */
-interface ZeugmaActionsValue extends ZeugmaActions {
-    /** Programmatically sets the fullscreen pane ID. */
-    setFullscreenPaneId: (paneId: string | null) => void;
-    /** Programmatically updates the global locked status. */
-    setLocked: Dispatch<SetStateAction<boolean>>;
-}
-interface PortalRegistryValue {
-    registerPortalTarget: (tabId: string, el: HTMLDivElement | null) => void;
-    registerRenderCallback: (tabId: string, render: (tab: TabDetails) => ReactNode) => void;
-    renderCallbacksRef: RefObject<Record<string, (tab: TabDetails) => ReactNode>>;
+interface ZeugmaProviderProps extends Omit<ZeugmaProps, 'controller'> {
+    /** The Zeugma Controller returned by useZeugma() */
+    controller: ZeugmaController;
+    /** Children components that will have access to the Zeugma context */
+    children: ReactNode;
 }
 
-export type { DragOverlayActiveItem as D, PortalRegistryValue as P, SplitDirection as S, TreeNode as T, UseZeugmaOptions as U, ZeugmaActionsValue as Z, ZeugmaDragStateValue as a, ZeugmaStateValue as b, ZeugmaController as c, ZeugmaProps as d, SplitNode as e, TabDetails as f, PaneNode as g, ZeugmaActions as h, ZeugmaClassNames as i, ZeugmaControllerInternal as j, ZeugmaQueries as k, ZeugmaState as l, ZeugmaStateSetters as m };
+export type { DragOverlayActiveItem as D, PaneNode as P, SplitDirection as S, TreeNode as T, UseZeugmaOptions as U, ZeugmaController as Z, ZeugmaProps as a, ZeugmaProviderProps as b, SplitNode as c, TabDetails as d, ZeugmaClassNames as e };

package/dist/utils.d.cts

@@ -1,4 +1,4 @@
-import { g as PaneNode, e as SplitNode, S as SplitDirection, T as TreeNode, f as TabDetails } from './types-B9LrYapR.cjs';
+import { P as PaneNode, c as SplitNode, S as SplitDirection, T as TreeNode, d as TabDetails } from './types-BN5W7EvY.cjs';
 import 'react';
 
 declare function generateUniqueId(): string;

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import { g as PaneNode, e as SplitNode, S as SplitDirection, T as TreeNode, f as TabDetails } from './types-B9LrYapR.js';
+import { P as PaneNode, c as SplitNode, S as SplitDirection, T as TreeNode, d as TabDetails } from './types-BN5W7EvY.js';
 import 'react';
 
 declare function generateUniqueId(): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-zeugma",
-  "version": "6.4.0",
+  "version": "6.4.2",
   "description": "Recursive drag-and-drop dashboard layout engine for React — combining the tree-based splitting of react-mosaic with the declarative API of react-grid-layout.",
   "type": "module",
   "sideEffects": false,