@xynogen/pix-edit 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,25 @@
+# pix-edit
+
+Pi tool — precise text replacement edit with diff rendering.
+
+## What it does
+
+Replaces Pi's default `edit` tool with an enhanced version that renders a side-by-side split diff after every edit. The diff is syntax-highlighted with gutter markers, line numbers, and a change summary produced by `pix-pretty`'s diff engine. Batched edits (multiple `{oldText, newText}` pairs in one call) each render their own diff block. Call labels show the target file path and the number of edits being applied. Depends on `@xynogen/pix-pretty`, installed automatically as a dependency.
+
+## Install
+
+```bash
+pi install npm:@xynogen/pix-edit
+```
+
+## Full distro
+
+To install the complete pix suite (all packages + Pi itself):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-edit",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Pi tool — precise text replacement edit with diff rendering",
 	"type": "module",
 	"main": "src/index.ts",

package/src/extension.ts

@@ -9,42 +9,44 @@ import type {
 	TextComponentCtor,
 } from "@xynogen/pix-pretty/types";
 import { shortPath } from "@xynogen/pix-pretty/utils";
-
 import { registerEditTool } from "./edit.js";
+import { once } from "./once.ts";
 
 export default function pixEditExtension(pi: PiPrettyApi): void {
-	let sdk: PiPrettySdk;
-	try {
-		sdk = require("@earendil-works/pi-coding-agent");
-	} catch {
-		return;
-	}
+	once("pix-edit", () => {
+		let sdk: PiPrettySdk;
+		try {
+			sdk = require("@earendil-works/pi-coding-agent");
+		} catch {
+			return;
+		}
 
-	const createEditTool = sdk.createEditToolDefinition ?? sdk.createEditTool;
-	if (!createEditTool) return;
+		const createEditTool = sdk.createEditToolDefinition ?? sdk.createEditTool;
+		if (!createEditTool) return;
 
-	let TextComponent: TextComponentCtor;
-	try {
-		TextComponent = require("@earendil-works/pi-tui").Text;
-	} catch {
-		return;
-	}
+		let TextComponent: TextComponentCtor;
+		try {
+			TextComponent = require("@earendil-works/pi-tui").Text;
+		} catch {
+			return;
+		}
 
-	const cwd = process.cwd();
-	const home = process.env.HOME ?? "";
+		const cwd = process.cwd();
+		const home = process.env.HOME ?? "";
 
-	attachResizeListener();
+		attachResizeListener();
 
-	registerEditTool(
-		pi,
-		createEditTool,
-		{
-			cwd,
-			sp: (p: string) => shortPath(cwd, home, p),
-			TextComponent,
-			fffState,
-			cursorStore: new CursorStore(),
-		},
-		trackInvalidator,
-	);
+		registerEditTool(
+			pi,
+			createEditTool,
+			{
+				cwd,
+				sp: (p: string) => shortPath(cwd, home, p),
+				TextComponent,
+				fffState,
+				cursorStore: new CursorStore(),
+			},
+			trackInvalidator,
+		);
+	});
 }

package/src/once.ts

@@ -0,0 +1,16 @@
+/**
+ * Idempotency guard for extension activation.
+ *
+ * pix-core (the meta-package) invokes this package's factory in addition to a
+ * possible direct install. Pi's loader uses jiti with `moduleCache: false`, so
+ * each load pass re-evaluates modules — a plain module-level flag would not be
+ * shared. The dedupe key therefore lives on `globalThis`, which persists for
+ * the lifetime of the process across all load passes.
+ */
+export function once(key: string, fn: () => void): void {
+	const g = globalThis as { __pixLoaded?: Set<string> };
+	const loaded = (g.__pixLoaded ??= new Set<string>());
+	if (loaded.has(key)) return;
+	loaded.add(key);
+	fn();
+}