@kevinweber/pi-copy-prompt 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Weber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @kevinweber/pi-copy-prompt
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Copy your current Pi draft to the clipboard with **⌘Y** on macOS (`super+y`). Collapsed pasted text is copied in full, and the editor briefly shows `prompt copied`.
+
+## Install
+
+```bash
+pi install npm:@kevinweber/pi-copy-prompt@1.0.0
+```
+
+## Behavior
+
+- Copies draft text without submitting it, preserving whitespace and expanding collapsed pastes.
+- Does not copy system instructions, conversation history or attachments.
+- Leaves the clipboard unchanged when the draft is empty or whitespace-only.
+- Reports clipboard errors.
+
+## Compatibility and privacy
+
+Requires Node.js >=22.19.0 and Pi with custom-editor and expanded-paste support.
+
+Your terminal must support the Super/Command modifier, typically through the Kitty keyboard protocol, and pass the shortcut through to Pi. `ctrl+y` keeps its usual yank behavior.
+
+Do not combine this package with another custom-editor extension or a local copy of this extension. Pi supports only one custom editor at a time.
+
+Remote clipboard copying requires terminal support for OSC 52; the confirmation cannot guarantee that the terminal accepted it. Copied text may be saved in clipboard history or synced to other devices.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/kevinweber/pi-copy-prompt/blob/main/CONTRIBUTING.md) for development checks.
+
+## License
+
+MIT © Kevin Weber

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@kevinweber/pi-copy-prompt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Copy the full expanded Pi editor draft to the clipboard with super+y",
+  "keywords": ["pi-package", "pi", "pi-extension", "pi-coding-agent", "clipboard", "copy-prompt", "editor"],
+  "author": "Kevin Weber",
+  "license": "MIT",
+  "type": "module",
+  "engines": { "node": ">=22.19.0" },
+  "files": ["src/index.ts", "README.md", "LICENSE"],
+  "repository": { "type": "git", "url": "git+https://github.com/kevinweber/pi-copy-prompt.git" },
+  "homepage": "https://github.com/kevinweber/pi-copy-prompt#readme",
+  "bugs": { "url": "https://github.com/kevinweber/pi-copy-prompt/issues" },
+  "pi": { "extensions": ["./src/index.ts"] },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "1.4.0",
+    "@earendil-works/pi-tui": "1.4.0",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "check": "node --check src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "node --experimental-strip-types --test src/index.test.mjs",
+    "prepublishOnly": "npm run ci",
+    "ci": "npm run check && npm run typecheck && npm run test"
+  }
+}

package/src/index.ts

@@ -0,0 +1,148 @@
+/** Copy the expanded editor draft with super+y and show brief border feedback. */
+import {
+  CustomEditor,
+  copyToClipboard,
+  type ExtensionAPI,
+  type KeybindingsManager,
+  type Theme,
+} from "@earendil-works/pi-coding-agent";
+import {
+  Key,
+  truncateToWidth,
+  visibleWidth,
+  type EditorTheme,
+  type TUI,
+} from "@earendil-works/pi-tui";
+
+export function fitBorder(
+  left: string,
+  right: string,
+  width: number,
+  border: (text: string) => string,
+  fill: (text: string) => string = border,
+): string {
+  if (width <= 0) return "";
+  if (width === 1) return border("─");
+
+  let leftText = left;
+  let rightText = right;
+  const fixedWidth = 2;
+  const minimumGap = 3;
+
+  while (
+    fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minimumGap > width &&
+    visibleWidth(rightText) > 0
+  ) {
+    rightText = truncateToWidth(rightText, Math.max(0, visibleWidth(rightText) - 1), "");
+  }
+  while (
+    fixedWidth + visibleWidth(leftText) + visibleWidth(rightText) + minimumGap > width &&
+    visibleWidth(leftText) > 0
+  ) {
+    leftText = truncateToWidth(leftText, Math.max(0, visibleWidth(leftText) - 1), "");
+  }
+
+  const gapWidth = Math.max(0, width - fixedWidth - visibleWidth(leftText) - visibleWidth(rightText));
+  return `${border("─")}${leftText}${fill("─".repeat(gapWidth))}${rightText}${border("─")}`;
+}
+
+class CopyPromptEditor extends CustomEditor {
+  private readonly _tui: TUI;
+  private readonly _getTheme: () => Theme;
+  private _copied = false;
+  private _resetTimer: ReturnType<typeof setTimeout> | undefined;
+  disposed = false;
+
+  constructor(tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, getTheme: () => Theme) {
+    super(tui, theme, keybindings);
+    this._tui = tui;
+    this._getTheme = getTheme;
+  }
+
+  showCopied(): void {
+    if (this.disposed) return;
+    this._copied = true;
+    if (this._resetTimer !== undefined) clearTimeout(this._resetTimer);
+    this._resetTimer = setTimeout(() => {
+      this._resetTimer = undefined;
+      this._copied = false;
+      this._tui.requestRender();
+    }, 2000);
+    this._tui.requestRender();
+  }
+
+  clearCopied(): void {
+    if (this._resetTimer !== undefined) {
+      clearTimeout(this._resetTimer);
+      this._resetTimer = undefined;
+    }
+    if (!this._copied) return;
+    this._copied = false;
+    if (!this.disposed) this._tui.requestRender();
+  }
+
+  dispose(): void {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.clearCopied();
+  }
+
+  protected renderBottomBorder(width: number): string {
+    const theme = this._getTheme();
+    const label = this._copied
+      ? theme.fg("accent", " prompt copied ")
+      : theme.fg("muted", " ⌘Y (copy prompt) ");
+    return fitBorder("", label, width, (text) => this.borderColor(text));
+  }
+
+  handleInput(data: string): void { super.handleInput(data); this.clearCopied(); }
+  setText(text: string): void { super.setText(text); this.clearCopied(); }
+  insertTextAtCursor(text: string): void { super.insertTextAtCursor(text); this.clearCopied(); }
+}
+
+export default function (pi: ExtensionAPI) {
+  let editorRef: CopyPromptEditor | undefined;
+
+  pi.on("session_start", (_event, ctx) => {
+    editorRef?.dispose();
+    editorRef = undefined;
+    if (ctx.mode !== "tui") return;
+
+    ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+      editorRef?.dispose();
+      const editor = new CopyPromptEditor(tui, theme, keybindings, () => ctx.ui.theme);
+      editorRef = editor;
+      return editor;
+    });
+  });
+
+  pi.on("session_shutdown", () => {
+    editorRef?.dispose();
+    editorRef = undefined;
+  });
+
+  pi.registerShortcut(Key.super("y"), {
+    description: "Copy current prompt to clipboard",
+    handler: async (ctx) => {
+      if (ctx.mode !== "tui") return;
+      const editor = editorRef;
+      if (!editor || editor.disposed) return;
+      const text = editor.getExpandedText();
+      editor.clearCopied();
+      if (!text.trim()) {
+        ctx.ui.notify("Nothing to copy — editor is empty", "info");
+        return;
+      }
+      try {
+        await copyToClipboard(text);
+      } catch {
+        if (editorRef === editor && !editor.disposed) {
+          ctx.ui.notify("Could not copy prompt to clipboard", "error");
+        }
+        return;
+      }
+      // A clipboard operation can finish after shutdown or editor/session replacement.
+      if (editorRef === editor && !editor.disposed) editor.showCopied();
+    },
+  });
+}