@xenosystem/blocks 0.16.0 → 0.17.0

package/dist/edit/index.d.ts

@@ -1199,9 +1199,10 @@ declare function fieldMatches(field: XenoInspectorField, term: string): boolean;
 /**
  * Project a schema into renderable sections.
  *
- * Visibility-by-data: a section is dropped entirely when it has no matching fields AND no
- * `emptyHint` — the panel never renders an empty box the user cannot act on. While a filter is
- * active, `emptyHint`-only sections are also dropped (they are not search results).
+ * Visibility-by-data: a section is dropped entirely when it has no matching fields AND nothing to
+ * act on — no `emptyHint`, no `actions`, no `addMenu` — the panel never renders an empty box the
+ * user cannot act on. (An action-only section — Canvas's align strip — IS something to act on.)
+ * While a filter is active, fieldless sections are dropped regardless (they are not search results).
  */
 declare function projectSections(schema: XenoInspectorSchema, options?: ProjectOptions$1): ProjectedSection[];
 /** Whether a section is collapsed, honoring `defaultCollapsed` for sections the user never touched. */
@@ -6755,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;
@@ -6841,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.
@@ -7360,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

@@ -1970,7 +1970,8 @@ function projectSections(schema, options = {}) {
   for (const section of schema.sections) {
     const fields = filtering ? section.fields.filter((f) => fieldMatches(f, term)) : section.fields;
     const empty = fields.length === 0;
-    if (empty && (filtering || !section.emptyHint)) continue;
+    const actionable = !!section.emptyHint || (section.actions?.length ?? 0) > 0 || (section.addMenu?.length ?? 0) > 0;
+    if (empty && (filtering || !actionable)) continue;
     const collapsed = !filtering && !!section.collapsible && isCollapsed(section, collapsedSet);
     out.push({
       section,
@@ -13113,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;
@@ -13247,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",
@@ -13989,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.0",
+  "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",