@deadragdoll/reactnu 0.1.49 → 0.1.52

package/docs/API_REFERENCE.md

@@ -21,6 +21,10 @@ See: [Slot Customization](./SLOT_CUSTOMIZATION.md)
 
 - `NuThemeProvider`
   docs: [NuThemeProvider](./NuThemeProvider.md)
+- `NuDragDropProvider`
+  coordinates application-owned transfers among `NuIconGrid`, `ListBox`, and
+  `TreeListView`
+  docs: [NuDragDropProvider](./NuDragDropProvider.md)
 - `NuDesktop`
   docs: [Desktop](./Desktop.md)
 - `Dashboard`
@@ -41,6 +45,9 @@ See: [Slot Customization](./SLOT_CUSTOMIZATION.md)
   also exposes `showMessageBox(...)` and `showInputBox(...)`
 - `useNuIconManager()`
   manages icons inside a `NuIconProvider`
+- `useNuDragDrop()`
+  internal integration hook for custom shared drag sources and targets; most
+  applications should use component props from [Shared Drag and Drop](./NuDragDropProvider.md)
 - `usePopupMenu()`
   anchor/open helper for `PopupMenu`
 - `useWindowMenu()`
@@ -91,6 +98,8 @@ See: [Slot Customization](./SLOT_CUSTOMIZATION.md)
   docs: [TreeView](./TreeView.md)
 - `TreeListView`
   docs: [TreeListView](./TreeListView.md)
+- Shared drag-and-drop contract
+  docs: [NuDragDropProvider](./NuDragDropProvider.md)
 
 ## Layout And Surfaces
 

package/docs/COMPONENT_INDEX.md

@@ -8,6 +8,7 @@
 - [Contributor Guide](./CONTRIBUTOR_GUIDE.md)
 - [Slot Customization](./SLOT_CUSTOMIZATION.md)
 - [Storybook](./STORYBOOK.md)
+- [Shared Drag and Drop](./NuDragDropProvider.md)
 
 ## Core Components
 
@@ -57,6 +58,7 @@
 
 ## Providers
 
+- [NuDragDropProvider](./NuDragDropProvider.md)
 - [NuThemeProvider](./NuThemeProvider.md)
 - [NuAppHostProvider](./NuAppHostProvider.md)
 

package/docs/GETTING_STARTED.md

@@ -49,7 +49,8 @@ export function App() {
 ## Recommended Order
 
 1. `NuThemeProvider`
-2. `NuDesktop`
+2. `NuDragDropProvider` when ListBox, TreeListView, or IconGrid need to exchange items
+3. `NuDesktop`
 3. host-driven `appBar`
 4. workspace content
 5. open windows through `useNuWindowManager()`

package/docs/IconGrid.md

@@ -71,6 +71,11 @@ function Applications() {
   the target first and may return `false` to reject the transfer;
   `onIconMoveOut(icon, context)` runs on the source after a successful transfer.
   `context` exposes both managers, grids, and the target `position`.
+- Within `NuDragDropProvider`, use `acceptsDrop(item)` and `onDrop(item,
+  context)` to accept application-defined items from `ListBox` or
+  `TreeListView`. `onDragOut(item)` runs when an icon is accepted by one of
+  those non-icon targets. The existing `accepts(icon)` API remains specific to
+  icon-to-icon transfers.
 
 `useNuIconManager()`
 

package/docs/ListBox.md

@@ -21,6 +21,10 @@
 - `onItemCheckChange?: (item, group, checked) => void`
 - `onItemDoubleClick?: (item, group) => void`
 - `onPopupMenu?: (event, item, group) => void`
+- `getDragItem?: (item, group) => NuDragDropItem | false`
+- `onItemDragOut?: (item, group) => void`
+- `acceptsDrop?: (item) => boolean`
+- `onDrop?: (item, context) => boolean | void`
 - `rightCheckBox?: boolean`
 - `emptyText?: string`
 
@@ -37,3 +41,6 @@
 - Right-clicking an enabled item activates it, prevents the browser context menu,
   and calls `onPopupMenu`. Use the event coordinates to open an application-owned
   `PopupMenu` or another contextual action surface.
+- Inside `NuDragDropProvider`, `getDragItem` makes rows draggable. The
+  application decides accepted data in `acceptsDrop` and updates its collection
+  in `onDrop` / `onItemDragOut`.

package/docs/NuDragDropProvider.md

@@ -0,0 +1,43 @@
+# NuDragDropProvider
+
+`NuDragDropProvider` coordinates pointer drag-and-drop between `NuIconGrid`,
+`ListBox`, and `TreeListView`. It carries an application-defined item; it does
+not mutate the host application's list or tree data.
+
+```tsx
+<NuDragDropProvider>
+  <ListBox
+    data={receivers}
+    getDragItem={(item, group) => ({
+      type: "receiver",
+      id: String(item.id),
+      data: { group: group.category?.text ?? "ungrouped", receiver: item }
+    })}
+    onItemDragOut={(item) => removeReceiver(String(item.id))}
+  />
+  <TreeListView
+    acceptsDrop={(drag) => drag.type === "receiver"}
+    columns={columns}
+    data={groups}
+    onDrop={(drag) => {
+      assignReceiverToSelectedGroup(drag.data);
+    }}
+  />
+</NuDragDropProvider>
+```
+
+## Contract
+
+- A source uses `getDragItem` to opt a displayed item into dragging. Return a
+  stable `type`, an ID, and any host payload in `data`.
+- A target uses `acceptsDrop(item)` to filter drag item types and `onDrop` to
+  perform its own state update. Returning `false` rejects the transfer.
+- `onItemDragOut` / `onDragOut` run only after a target accepted the item;
+  remove or update the source data there.
+- `NuIconGrid` keeps `accepts(icon)`, `onIconDrop`, and `onIconMoveOut` for
+  its existing icon-to-icon transfer. Its `acceptsDrop` and `onDrop` receive
+  non-icon shared drag items.
+
+Wrap every source and target that should interact in the same provider. A
+fallback coordinator preserves existing unwrapped IconGrid transfers, but a
+provider gives the application an explicit DnD scope.

package/docs/NuThemeProvider.md

@@ -63,7 +63,7 @@ Supported props:
 
 - Built-in themes are `classic` (default), `amber`, `phosphor`, `midnight`, and
   `grayscale`.
-- `midnight` is a restrained dark blue-gray palette with pale chrome and yellow focus accents.
+- `midnight` is a dark slate-blue palette with blue chrome and a burnt-orange focus accent.
 - `grayscale` is a high-contrast monochrome monitor palette. Semantic button variants use brightness rather than hue.
 - Theme tokens drive desktop, windowing, controls, selection, and inactive overlays.
 - Provider typography affects preview content, managed windows, dialogs, menus, and popup portals rendered inside the theme scope.

package/docs/TreeListView.md

@@ -55,6 +55,10 @@ const columns: TreeListColumn<Node>[] = [
 - `onItemSelect`
 - `onItemDoubleClick`
 - `onPopupMenu`
+- `getDragItem`
+- `onItemDragOut`
+- `acceptsDrop`
+- `onDrop`
 - `onItemCheckChange`
 - `onExpandedIdsChange`
 - `onActiveItemChange`
@@ -87,3 +91,6 @@ const columns: TreeListColumn<Node>[] = [
   `onPopupMenu(event, item, context)`. `context` has the same `depth`, `isLeaf`,
   `item`, and `rowIndex` fields as `getCellContent`; the host owns rendering the
   resulting menu.
+- Inside `NuDragDropProvider`, rows may produce shared drag items through
+  `getDragItem`; the host filters and applies incoming items with
+  `acceptsDrop` and `onDrop`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deadragdoll/reactnu",
-  "version": "0.1.49",
+  "version": "0.1.52",
   "private": false,
   "description": "React components with a precise DOS-era utility interface.",
   "license": "MIT",