@omrips/viewstl 2.0.0-rc.2 → 2.0.0-rc.4

package/docs/v2-verification.md

@@ -3,6 +3,57 @@
 This file records dated checks. Older sections describe the alpha at the time
 of each check; release-candidate results are recorded separately below.
 
+## Runnable server example 2.0.0-rc.4 — 2026-10-20
+
+The npm README now contains a clearly labeled server-only example, including
+installation, the `analyze.mjs` filename, a three-line script that prints JSON,
+and the command to run it. This is a documentation update.
+
+The exact example was extracted from the packed README and run with a binary
+STL using the installed package on Node.js 24.19.0 on Windows. The resulting
+JSON contains the expected dimensions, surface area, validated volume and mesh
+checks. All 40 packaged files match the local release sources by SHA-256.
+All 31 existing browser/Node runtime, declaration and CAD assets match the
+public `2.0.0-rc.3` package apart from embedded version strings. The legacy
+guard passes for tracked files and all 14 archived files. No runtime logic was
+changed; the broader API verification below still describes the implementation.
+
+Evidence is retained locally in `test-results/npm-2.0.0-rc.4/` (ignored by Git).
+
+## Node.js model analysis 2.0.0-rc.3 — 2026-10-20
+
+The new `@omrips/viewstl/node` export provides `analyzeFile`, `analyzeBuffer`
+and `createAnalyzer`. It reuses the browser's parsers and mesh checks in Node
+worker threads, loading CAD JavaScript/WASM from the installed package.
+
+- All 123 tests pass on Node.js 24.19.0 on Windows. New tests cover real workers,
+  all five model formats, physical and unknown units, validated/invalid volume,
+  malformed input and recovery, buffer offsets and ownership, file/archive/
+  triangle/memory admission limits, bounded queues, cancellation, disposal,
+  whole-job and partial-check deadlines, and progress callback failures.
+- A clean consumer installation of the packed tarball passes on actual Node.js
+  20.20.2 and 24.19.0 on Windows. ESM and CommonJS each analyze STL, OBJ, 3MF,
+  STEP and IGES fixtures through the public export, including local CAD WASM.
+  Buffer input, unknown units and recovery after malformed input also pass.
+- Strict TypeScript consumers pass for both module systems using Node types
+  without the DOM library, including against the installed package. Existing
+  browser TypeScript checks also pass.
+- The package contains 40 files and no runtime dependencies. Installed files
+  match their release sources by SHA-256. The allowlist excludes test fixtures,
+  local test servers, credentials and node_modules.
+- All 26 existing browser runtime/declaration/CAD assets match the public
+  `2.0.0-rc.2` package apart from embedded version strings. Browser behavior was
+  not changed; no new browser or physical-device test coverage is claimed.
+- The legacy guard passes for tracked legacy files and all 14 archived files.
+
+Linux/macOS execution, additional Node versions and large production workloads
+have not been exercised in this release check. Memory budgets are estimates,
+not a hard process RSS cap. STEP/IGES results describe the tessellated mesh,
+not exact CAD solids. Optional FDM estimates are not a printability guarantee.
+
+Reproduction scripts, packed/public-install verification, fixtures and terminal
+evidence are retained locally in `test-results/npm-2.0.0-rc.3/` (ignored by Git).
+
 ## Quick-start documentation update 2.0.0-rc.2 — 2026-10-20
 
 The README and usage guide now begin with the minimum installation step and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omrips/viewstl",
-  "version": "2.0.0-rc.2",
+  "version": "2.0.0-rc.4",
   "description": "Local-first STL, OBJ, 3MF, STEP and IGES viewer with native WebGL2 and transferable worker geometry",
   "type": "module",
   "license": "MIT",
@@ -39,6 +39,18 @@
         "default": "./build/v2/viewstl.cjs"
       }
     },
+    "./node": {
+      "node": {
+        "import": {
+          "types": "./build/v2/node/index.d.ts",
+          "default": "./build/v2/node/index.js"
+        },
+        "require": {
+          "types": "./build/v2/node/index.d.cts",
+          "default": "./build/v2/node/index.cjs"
+        }
+      }
+    },
     "./worker": "./build/v2/viewstl.worker.js",
     "./browser": "./build/v2/stl_viewer.min.js",
     "./assets/*": "./build/v2/*",
@@ -58,10 +70,12 @@
     "test": "node --test tests/v2/*.test.mjs",
     "check:legacy": "node scripts/check-legacy.mjs",
     "check:types": "tsc --noEmit --strict --module NodeNext --moduleResolution NodeNext --target ES2022 --lib ES2022,DOM tests/v2/types.ts",
+    "check:node-types": "tsc --noEmit --strict --module NodeNext --moduleResolution NodeNext --target ES2022 --lib ES2022 --types node tests/v2/node-types.mts tests/v2/node-types.cts",
     "prepack": "node scripts/build-v2.mjs && node scripts/check-legacy.mjs",
     "start": "node scripts/serve-v2.mjs"
   },
   "devDependencies": {
+    "@types/node": "^20.19.43",
     "esbuild": "0.28.2",
     "fflate": "0.8.3",
     "occt-import-js": "0.0.23",