@xenosystem/blocks 0.16.1 → 0.17.0

package/dist/edit/index.d.ts

@@ -6756,6 +6756,11 @@ interface XenoTreeGlyph {
  * and another names lucide icons. A single `icon: string` field forces every consumer to guess
  * which it is holding, and guessing renders `'📄'` as a missing-icon box.
  */
+/** What a node carries when dragged out of the panel (see `XenoTreeNode.dragOut`). */
+interface XenoTreeDragOut {
+    kind: string;
+    payload?: unknown;
+}
 type XenoTreeIcon = {
     kind: 'lucide';
     name: string;
@@ -6842,6 +6847,15 @@ interface XenoTreeNode {
     columns?: Record<string, string>;
     /** Hover actions. */
     actions?: XenoTreeAction[];
+    /**
+     * The node may be dragged OUT of the panel and dropped on the host's own surface — a library
+     * component onto a canvas, a clip onto a timeline. `kind` is the host's vocabulary word
+     * (`'component'`, `'clip'`); `payload` is carried back verbatim on the `dragOut` output. The drag
+     * itself is the panel's pointer drag: when it is released outside the panel's rows, the panel
+     * emits `dragOut` with the release point and the host decides what a drop there means. A node
+     * without this is only reorderable inside the tree.
+     */
+    dragOut?: XenoTreeDragOut;
     /**
      * A stable identity for the *thing* this node points at — a resolved real path, an inode, a
      * document id.
@@ -7361,14 +7375,19 @@ declare class TreeController {
     /** Update the hovered drop target. */
     dragOver(targetId: string, offsetY: number): DropPosition;
     /**
-     * Complete the drag, emitting a `move` intent when the drop is legal.
+     * Complete the drag, emitting a `move` intent when the drop is legal — or, when the release was
+     * OUTSIDE the panel (`outside` given) and every dragged node declares `dragOut` of one kind, a
+     * `dragOut` event carrying the release point for the host to hit-test.
      *
      * A refused drop emits **nothing** — and the refusal that matters most is the descendant one,
      * which lives in `@xenosystem/tree-core` because two shipping apps delete a whole subtree without it.
      *
      * @returns `true` if a move intent was emitted.
      */
-    endDrag(): boolean;
+    endDrag(outside?: {
+        clientX: number;
+        clientY: number;
+    }): boolean;
     /** Abandon the drag. */
     cancelDrag(): void;
     /** Descendants of a node, through the shared recursive walk. */

package/dist/edit/index.js

@@ -13114,16 +13114,29 @@ var TreeController = class {
     return result.position;
   }
   /**
-   * Complete the drag, emitting a `move` intent when the drop is legal.
+   * Complete the drag, emitting a `move` intent when the drop is legal — or, when the release was
+   * OUTSIDE the panel (`outside` given) and every dragged node declares `dragOut` of one kind, a
+   * `dragOut` event carrying the release point for the host to hit-test.
    *
    * A refused drop emits **nothing** — and the refusal that matters most is the descendant one,
    * which lives in `@xenosystem/tree-core` because two shipping apps delete a whole subtree without it.
    *
    * @returns `true` if a move intent was emitted.
    */
-  endDrag() {
+  endDrag(outside) {
     const drag = this.drag;
     this.drag = null;
+    if (drag && outside) {
+      const nodes = drag.ids.map((id) => this.source?.nodes[id]).filter((n) => !!n);
+      const outs = nodes.map((n) => n.dragOut).filter((d) => !!d);
+      if (nodes.length > 0 && outs.length === nodes.length && outs.every((d) => d.kind === outs[0].kind)) {
+        this.host.emit("dragOut", { ids: nodes.map((n) => n.id), kind: outs[0].kind, payloads: outs.map((d) => d.payload), clientX: outside.clientX, clientY: outside.clientY });
+        this.notify();
+        return true;
+      }
+      this.notify();
+      return false;
+    }
     if (!drag || !drag.targetId || !drag.position) {
       this.notify();
       return false;
@@ -13248,6 +13261,12 @@ var treeManifest = {
       schema: WELL_KNOWN_PORT_SCHEMAS8.TREE_OP,
       description: "Everything the panel asks for \u2014 select, open, setExpanded, loadChildren, move, rename, create, delete, setProp, action. INTENTS ONLY: the host performs, pins ids, and pushes one undo entry."
     },
+    {
+      id: "dragOut",
+      name: "Dragged Out",
+      type: "object",
+      description: "{ ids, kind, payloads, clientX, clientY } \u2014 a pointer drag of nodes that declare `dragOut` was released OUTSIDE the panel. The host hit-tests its own surface at the point and performs the drop (place an instance, insert a clip); the panel places nothing. Nodes without `dragOut` never emit this."
+    },
     {
       id: "selection",
       name: "Selection",
@@ -13990,7 +14009,10 @@ function TreeScroller({ controller, children }) {
         e.currentTarget.releasePointerCapture(e.pointerId);
       } catch {
       }
-      if (press?.dragging) controller.endDrag();
+      if (!press?.dragging) return;
+      const r = scrollRef.current?.getBoundingClientRect();
+      const inside = !!r && e.clientX >= r.left && e.clientX <= r.right && e.clientY >= r.top && e.clientY <= r.bottom;
+      controller.endDrag(inside ? void 0 : { clientX: e.clientX, clientY: e.clientY });
     },
     [controller]
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xenosystem/blocks",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "XENO Blocks — rung 3 of the front ladder: components composed into a contract-bearing unit (manifest: ports, intents, commands, agent surface), rendered by @xenosystem/workbench. ONE package, one subpath per family (/auth, /edit, /data, /time, /ops, /trust, /agent), one named export per block — XENO PACKAGE NAMING - STANDARD.md.",
   "license": "UNLICENSED",
   "type": "module",