@vincemakes/kiso-tui 0.15.6 → 0.15.7

package/dist/editor.d.ts

@@ -68,6 +68,10 @@ export declare class Editor {
      *  over while the run is told to stop. Mirrors onEscape (a list, so
      *  listeners can coexist); the line arrives already gone from the
      *  composer, exactly as a submit's does. */
+    /** REL-0152-D11: what to do when a paste arrives empty. See
+     *  #onEmptyPaste — the CLI owns the platform, the editor owns the
+     *  moment. */
+    onEmptyPaste(cb: () => string | null): void;
     onRedirect(cb: (line: string) => void): void;
     /** W22: bind the pending-turn queue — the CLI's live slots. The ↑
      *  pop walks them (each pop leaves the queue, cancelling the turn);

package/dist/editor.js

@@ -153,6 +153,23 @@ export class Editor {
      * reads, and this is a field, not a local.
      */
     #pasteRun = null;
+    /**
+     * REL-0152-D11 — what an EMPTY paste means.
+     *
+     * Pasting an image sends nothing: a terminal has no way to put binary
+     * into a byte stream, so the bracketed paste arrives with no content.
+     * That emptiness is the signal — the user pressed paste and the
+     * terminal had nothing to hand over — and whatever they meant has to
+     * be fetched from the clipboard instead.
+     *
+     * The editor does not know what a clipboard is and must not: this
+     * package renders and reads keys, and reaching into the operating
+     * system from it would put a platform dependency under every gate in
+     * the suite. The CLI supplies the hook; the editor supplies the
+     * moment. It returns the text to insert (a path, for the CLI's
+     * attachment scan to pick up) or null when there was nothing.
+     */
+    #onEmptyPaste = null;
     /** TUI2-R3v2 ①: one-shot — a panel that just closed swallows the
      *  habitual trailing enter rather than submitting the restored draft. */
     #swallowEnter = false;
@@ -282,6 +299,12 @@ export class Editor {
      *  over while the run is told to stop. Mirrors onEscape (a list, so
      *  listeners can coexist); the line arrives already gone from the
      *  composer, exactly as a submit's does. */
+    /** REL-0152-D11: what to do when a paste arrives empty. See
+     *  #onEmptyPaste — the CLI owns the platform, the editor owns the
+     *  moment. */
+    onEmptyPaste(cb) {
+        this.#onEmptyPaste = cb;
+    }
     onRedirect(cb) {
         this.#redirectCbs.push(cb);
     }
@@ -1902,12 +1925,19 @@ export class Editor {
      * operation in this file works on it without knowing it exists.
      */
     #commitPaste() {
-        const run = this.#pasteRun ?? [];
+        let run = this.#pasteRun ?? [];
         const start = this.#pasteAt ?? this.#cursor;
         this.#pasteRun = null;
         this.#pasteAt = null;
-        if (run.length === 0)
-            return;
+        if (run.length === 0) {
+            // REL-0152-D11: an empty paste is the image case — see
+            // #onEmptyPaste. Anything it returns is ordinary text from here
+            // on and takes the same route as if it had been typed.
+            const substitute = this.#onEmptyPaste?.() ?? null;
+            if (substitute === null || substitute === "")
+                return;
+            run = [...substitute].map((ch) => ch.codePointAt(0));
+        }
         if (this.#historyIdx !== null)
             this.#historyIdx = null;
         this.#queuePopMode = false;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.15.6",
+	"version": "0.15.7",
 	"description": "kiso tui \u2014 the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.15.6"
+		"@vincemakes/kiso-tui-cells": "0.15.7"
 	}
 }