gridity 0.1.0 → 0.2.0

package/README.md

@@ -6,12 +6,13 @@ sized so an LLM can understand many pages or moments from a single image.
 ```sh
 gridity probe report.pdf                          # pages, sizes, sheet estimates, text size
 gridity probe report.pdf --per-page               # which pages need to be seen
-gridity text report.pdf                           # visible text of each page
 gridity render report.pdf                         # prints absolute paths of the sheets
 gridity render report.pdf --pages 3-8 --json      # manifest with cell coordinates
 gridity render report.pdf --pages 7 --crop 0,0.5,1,0.5   # close-up of the bottom half
 gridity render talk.mp4 --start 1:00 --end 2:30 --every 10s
 gridity render screenshots/ --cols 3
+gridity render report.pdf --pages 7 --ruler       # read --crop values off the sheet
+gridity export report.pdf --pages 7 --crop 0.1,0.55,0.8,0.3 -o fig.png   # one file per item
 gridity guide                                     # documentation for agents
 ```
 
@@ -23,6 +24,7 @@ evenly across sheets when they do not fit on one.
 
 ```sh
 npx gridity --help             # prebuilt: macOS and Linux (x64, arm64), Windows (x64)
+cargo binstall gridity         # same prebuilt binaries, installed like cargo install
 cargo install gridity          # build from crates.io with Rust
 cargo install --path .         # build this checkout
 ```
@@ -32,7 +34,7 @@ Video input needs `ffmpeg` and `ffprobe` on `PATH` (`brew install ffmpeg`), or
 
 ## MCP server
 
-`gridity mcp` exposes `render`, `probe`, `text` and `guide` as Model Context Protocol
+`gridity mcp` exposes `render`, `probe` and `guide` as Model Context Protocol
 tools; `render` returns the sheets as images.
 
 ```sh
@@ -45,7 +47,7 @@ See `gridity guide mcp` for other clients, parameters and limits.
 ## Documentation
 
 `gridity guide [topic]` prints the bundled guide (`docs/guide/*.md`):
-`recipes`, `pdf`, `text`, `video`, `images`, `layout`, `output`, `mcp`. JSON Schemas of
+`recipes`, `pdf`, `pages`, `video`, `images`, `layout`, `output`, `mcp`. JSON Schemas of
 every JSON output are in [`docs/schema/`](docs/schema/).
 
 ## License

package/bin/gridity.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+// src/gridity.ts
+const platform = `${process.platform}-${process.arch}`;
+const name = process.platform === "win32" ? "gridity.exe" : "gridity";
+const binary = fileURLToPath(new URL(`../vendor/${platform}/${name}`, import.meta.url));
+if (!existsSync(binary)) {
+	console.error(`error: gridity has no prebuilt binary for ${platform}\nhint: install it with \`cargo install gridity\``);
+	process.exit(4);
+}
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+	console.error(`error: cannot run ${binary}: ${result.error.message}`);
+	process.exit(1);
+}
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gridity",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Arrange PDF pages, video frames and images into labeled grid sheets for LLM vision",
   "license": "MIT OR Apache-2.0",
   "repository": {
@@ -16,8 +16,9 @@
     "contact-sheet",
     "mcp"
   ],
+  "type": "module",
   "bin": {
-    "gridity": "bin/gridity.js"
+    "gridity": "bin/gridity.mjs"
   },
   "files": [
     "bin",

package/bin/gridity.js

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-// Runs the prebuilt gridity binary for this platform with the same arguments, stdio and
-// exit code, so `npx gridity mcp` works as an MCP server.
-"use strict";
-
-const { spawnSync } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const platform = `${process.platform}-${process.arch}`;
-const name = process.platform === "win32" ? "gridity.exe" : "gridity";
-const binary = path.join(__dirname, "..", "vendor", platform, name);
-
-if (!fs.existsSync(binary)) {
-  console.error(
-    `error: gridity has no prebuilt binary for ${platform}\n` +
-      "hint: install it with `cargo install gridity`",
-  );
-  process.exit(4);
-}
-
-const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
-if (result.error) {
-  console.error(`error: cannot run ${binary}: ${result.error.message}`);
-  process.exit(1);
-}
-if (result.signal) {
-  process.kill(process.pid, result.signal);
-}
-process.exit(result.status ?? 1);