@rol1n/screenshot 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# screenshot
 
-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.
+Insert the file path of the most recently modified Windows/WSL system screenshot into Pi's editor via `/screenshot`.
+
+Searches standard and localized `Pictures/Screenshots` and OneDrive screenshot directories under `USERPROFILE` on Windows or `/mnt/c/Users` on WSL.
+
+
+## Install
+
+```sh
+pi install npm:@rol1n/screenshot
+```
+
+Available as a standalone package (not enabled in `@rol1n/pi-kit` by default).

package/index.ts

@@ -0,0 +1,126 @@
+/**
+ * screenshot — Insert the latest Windows/WSL system screenshot path into Pi's editor.
+ */
+
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { extname, join } from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+const SCREENSHOT_EXTENSIONS = new Set([".png", ".jpg", ".jpeg", ".gif", ".bmp", ".webp"]);
+const SKIP_USER_DIRS = /^(Public|Default|Default User|All Users|desktop\.ini)$/i;
+
+function isExpectedFileSystemError(error: unknown): boolean {
+  return error instanceof Error && "code" in error &&
+    ["ENOENT", "ENOTDIR", "EACCES", "EPERM"].includes(String(error.code));
+}
+
+function isWindows(): boolean {
+  return process.platform === "win32";
+}
+
+function isWSL(): boolean {
+  if (process.platform !== "linux") return false;
+  if (process.env.WSL_DISTRO_NAME || process.env.WSLENV || existsSync("/mnt/c/Users")) return true;
+  try {
+    return /microsoft|wsl/i.test(readFileSync("/proc/version", "utf-8"));
+  } catch (error) {
+    if (isExpectedFileSystemError(error)) return false;
+    throw error;
+  }
+}
+
+export function supportsScreenshots(): boolean {
+  return isWindows() || isWSL();
+}
+
+function findScreenshotDirs(): string[] {
+  const dirs = new Set<string>();
+  const addIfDirectory = (path: string) => {
+    try {
+      if (existsSync(path) && statSync(path).isDirectory()) dirs.add(path);
+    } catch (error) {
+      if (!isExpectedFileSystemError(error)) throw error;
+    }
+  };
+
+  if (isWindows()) {
+    const profile = process.env.USERPROFILE || process.env.HOME;
+    if (profile) {
+      addIfDirectory(join(profile, "Pictures", "Screenshots"));
+      addIfDirectory(join(profile, "Pictures", "屏幕截图"));
+      addIfDirectory(join(profile, "OneDrive", "Pictures", "Screenshots"));
+      addIfDirectory(join(profile, "OneDrive", "图片", "屏幕截图"));
+      addIfDirectory(join(profile, "OneDrive", "Pictures", "屏幕截图"));
+    }
+  }
+
+  if (isWSL()) {
+    const usersRoot = "/mnt/c/Users";
+    try {
+      for (const entry of readdirSync(usersRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory() || SKIP_USER_DIRS.test(entry.name)) continue;
+        const profile = join(usersRoot, entry.name);
+        addIfDirectory(join(profile, "Pictures", "Screenshots"));
+        addIfDirectory(join(profile, "Pictures", "屏幕截图"));
+        addIfDirectory(join(profile, "OneDrive", "Pictures", "Screenshots"));
+        addIfDirectory(join(profile, "OneDrive", "图片", "屏幕截图"));
+      }
+    } catch (error) {
+      if (!isExpectedFileSystemError(error)) throw error;
+    }
+  }
+
+  return [...dirs];
+}
+
+export function findLatestScreenshot(): string | null {
+  let latestPath: string | null = null;
+  let latestMtime = -1;
+
+  for (const dir of findScreenshotDirs()) {
+    let files: string[];
+    try {
+      files = readdirSync(dir);
+    } catch (error) {
+      if (isExpectedFileSystemError(error)) continue;
+      throw error;
+    }
+
+    for (const file of files) {
+      if (!SCREENSHOT_EXTENSIONS.has(extname(file).toLowerCase())) continue;
+      const path = join(dir, file);
+      try {
+        const stat = statSync(path);
+        if (stat.isFile() && stat.mtimeMs > latestMtime) {
+          latestPath = path;
+          latestMtime = stat.mtimeMs;
+        }
+      } catch (error) {
+        if (!isExpectedFileSystemError(error)) throw error;
+      }
+    }
+  }
+
+  return latestPath;
+}
+
+export default function (pi: ExtensionAPI) {
+  pi.registerCommand("screenshot", {
+    description: "Insert the latest Windows/WSL system screenshot path into the editor",
+    handler: async (_args, ctx: ExtensionContext) => {
+      if (!supportsScreenshots()) {
+        ctx.ui.notify("Current environment is not Windows or WSL; cannot locate Windows screenshots.", "warning");
+        return;
+      }
+
+      const path = findLatestScreenshot();
+      if (!path) {
+        ctx.ui.notify("No Windows screenshots found.", "warning");
+        return;
+      }
+
+      ctx.ui.pasteToEditor(`${path} `);
+      ctx.ui.notify(`Referenced screenshot: ${path.split(/[\\/]/).pop()}`, "info");
+    },
+  });
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@rol1n/screenshot",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "screenshot extension from pi-kit",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RolinShmily/pi-kit.git",
+    "directory": "screenshot"
+  },
+  "homepage": "https://github.com/RolinShmily/pi-kit#readme",
+  "bugs": {
+    "url": "https://github.com/RolinShmily/pi-kit/issues"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [],
+    "prompts": [],
+    "themes": []
+  }
+}