geometryview 0.3.0 → 0.4.0

package/README.md

@@ -1,9 +1,9 @@
 # GeometryView
 
-**See inside your CAD models, fast.** Open STEP and STL files in your browser, and let your AI apps
-open, inspect and picture them.
+**See inside your CAD models, and a whole folder of them at once.** STEP and STL, in your browser,
+on a Mac, on your phone, and from your AI apps.
 
-<img src="https://raw.githubusercontent.com/atharvaaalok/geometryview/main/Docs/media/styles.jpg" alt="A drive cut open, in six drawing styles" width="600">
+<img src="https://raw.githubusercontent.com/atharvaaalok/geometryview/v0.4.0/Docs/media/fig1-light.webp" width="680" alt="A turbofan cut along its axis, six stages numbered, in a drafting frame">
 
 ## View a model
 
@@ -13,28 +13,35 @@ npx geometryview               # the viewer, with your folders and recent files
 ```
 
 The viewer is served from your computer only (127.0.0.1), and your files never leave it. It needs a
-browser with WebGPU: Chrome or Edge, or Safari 26 or later. Or use the hosted copy, with sample
-models: [atharvaaalok.github.io/geometryview](https://atharvaaalok.github.io/geometryview/).
+browser with WebGPU: Chrome or Edge, or Safari 26 or later; on Linux it opens a Chrome window of its
+own, with Vulkan on. Or use the hosted copy:
+[atharvaaalok.github.io/geometryview](https://atharvaaalok.github.io/geometryview/).
 
-## Use it from your AI app
+Connect a folder and every part in it is drawn to scale, five ways: Plates, Sheet, Ladders, Atlas and
+Catalogue.
 
-`geometryview --mcp` is a tool server (MCP) with five tools:
+<img src="https://raw.githubusercontent.com/atharvaaalok/geometryview/v0.4.0/Docs/media/plates-light.webp" width="680" alt="A folder of 124 parts as a poster, fifteen families each at its own scale">
 
-- `open_model` opens a file and sums it up.
-- `get_structure` lists its assemblies and parts.
-- `render_view` returns a picture: any view, any of six styles, sections, parts alone.
-- `view_folder` pictures a whole folder on one contact sheet, with a numbered index of sizes and
-  parts. It needs the native engine (a Mac with Apple silicon and macOS 26).
-- `open_in_viewer` shows it to you, live.
+## Use it from your AI app
 
 ```sh
 claude mcp add geometryview -- npx -y geometryview --mcp     # Claude Code
 codex mcp add geometryview -- npx -y geometryview --mcp      # Codex
 ```
 
-Other apps take the same command, `npx -y geometryview --mcp`, in their MCP settings. Claude
-Desktop can also install it in one click from the `.mcpb` in the
+Other apps take the same command, `npx -y geometryview --mcp`, in their MCP settings. Claude Desktop
+installs it in one click from the `.mcpb` in the
 [latest release](https://github.com/atharvaaalok/geometryview/releases/latest).
 
-More, including the Mac app and the iPhone: [github.com/atharvaaalok/geometryview](https://github.com/atharvaaalok/geometryview).
-MIT licensed.
+- `open_model` opens a file and sums it up.
+- `get_structure` lists its assemblies and parts.
+- `render_view` returns a picture: any view, any of six styles, sections, parts alone.
+- `open_in_viewer` shows it to you, live.
+- `view_folder` pictures a whole folder on one contact sheet. It needs the native engine: the Claude
+  Desktop extension for Mac, or a build from source.
+
+Your files stay on your computer. The pictures, part names and structure the tools return go to
+your AI app, and from it to its provider.
+
+More, including the Mac app and the iPhone:
+[github.com/atharvaaalok/geometryview](https://github.com/atharvaaalok/geometryview). MIT licensed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "geometryview",
-  "version": "0.3.0",
-  "description": "View STEP and STL models in your browser, and let AI apps open, inspect and picture them (MCP).",
+  "version": "0.4.0",
+  "description": "See inside STEP and STL models, and whole folders of them, in your browser; and let AI apps open, inspect and picture them (MCP).",
   "keywords": [
     "step",
     "stl",
@@ -14,7 +14,7 @@
     "mcp",
     "model-context-protocol"
   ],
-  "homepage": "https://github.com/atharvaaalok/geometryview#readme",
+  "homepage": "https://atharvaaalok.github.io/geometryview/",
   "bugs": {
     "url": "https://github.com/atharvaaalok/geometryview/issues"
   },
@@ -39,6 +39,7 @@
   },
   "scripts": {
     "test": "node --test test/*.test.mjs",
-    "prepack": "node scripts/web.mjs"
+    "prepack": "node scripts/web.mjs",
+    "prepublishOnly": "node scripts/readme.mjs --check"
   }
 }

package/src/mcp.mjs

@@ -4,7 +4,7 @@
 
 import { createInterface } from "node:readline";
 
-const SERVER = { name: "geometryview", version: "0.3.0" };
+const SERVER = { name: "geometryview", version: "0.4.0" };
 const LATEST_PROTOCOL = "2025-06-18";
 
 /// Serves `tools` until standard input closes. Each tool is { name, description, inputSchema,

package/web/NOTICES.md

@@ -3,6 +3,9 @@
 GeometryView is MIT licensed (see [LICENSE](LICENSE)). It builds on the work below, each under its
 own license. Versions are pinned in [ThirdParty/manifest.toml](ThirdParty/manifest.toml).
 
+The showcase models ([`Tools/showcase`](Tools/showcase), and the folder and sample files made from
+them) and the README's pictures are GeometryView's own, under the same MIT license.
+
 ## Shipped in the app, the browser viewer and the launcher
 
 | Project | License | How it is used |
@@ -47,3 +50,4 @@ SOFTWARE.
 |---|---|
 | [doctest](https://github.com/doctest/doctest) 2.4.12 | MIT; vendored with its [license](ThirdParty/doctest/LICENSE.txt) |
 | [Dawn](https://dawn.googlesource.com/dawn) (native) | BSD-3-Clause; the WebGPU test harness on the Mac |
+| [build123d](https://github.com/gumyr/build123d) 0.13 and [OCP](https://github.com/CadQuery/OCP) 8.0.1 | Apache-2.0; they write the showcase models' STEP files |

package/web/viewer.js

@@ -1698,9 +1698,14 @@ async function galleryMotionChecks(g, root, subfolders, measure, settle) {
   out.sticky = { ...stuck, aligned: measure() };
   clip.scrollTop = 0;
   // A search: what it did not find painted at 22%.
-  const probe = g.core.path(g.core.wanted()[0]?.file ?? 0).split("/").pop().slice(0, 3);
+  const probe = params.get("search") ?? g.core.path(g.core.wanted()[0]?.file ?? 0).split("/").pop().slice(0, 3);
   g.setSearch(probe);
   await new Promise(requestAnimationFrame);
+  if (params.has("shots")) {
+    await settle();
+    await fetch(`/shot?name=${encodeURIComponent(`${params.get("label") ?? "web"}-gallery-search`)}`);
+    await sleep(1500);
+  }
   const faded = [...g.view.element.querySelectorAll(".gallery-content > :not([hidden])")].filter((n) => n.style.opacity === "0.22").length;
   out.search = { query: probe, found: g.core.matches, fadedNodes: faded, aligned: measure() };
   g.setSearch("");