@omrips/viewstl 2.0.0-rc.1 → 2.0.0-rc.3

package/docs/v2-verification.md

@@ -3,6 +3,54 @@
 This file records dated checks. Older sections describe the alpha at the time
 of each check; release-candidate results are recorded separately below.
 
+## 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
+a three-line HTML example. The example was extracted unchanged from the README,
+served with the complete distribution directory and a binary STL, and verified
+in the desktop Codex Chromium browser: the model rendered, the worker and model
+requests succeeded, and keyboard rotation responded without console errors.
+
+All 112 unit tests and the legacy preservation check passed. Every runtime asset
+was compared with the installed public `2.0.0-rc.1` package; only the embedded
+version string changed. This update does not add browser/device coverage beyond
+the release-candidate verification below. Evidence is in the ignored local
+`test-results/npm-2.0.0-rc.2/` folder.
+
 ## npm release candidate 2.0.0-rc.1 — 2026-10-19
 
 Prepared the first public npm package as `@omrips/viewstl`, with the release

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omrips/viewstl",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.3",
   "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",