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

package/docs/v2-usage.md

@@ -1,14 +1,14 @@
 # ViewSTL 2 — native WebGL2 plugin
 
-Version: `2.0.0-rc.3` (ViewSTL v2.00 release candidate). The npm package is
-`@omrips/viewstl`; install the candidate with `npm install @omrips/viewstl@2.0.0-rc.3`.
-The legacy plugin remains at its original repository paths and on the production
-website. The v2 website is available at https://preview.viewstl.com/.
+Version: `2.0.0-rc.5` (ViewSTL v2.00 release candidate, GitHub and npm).
+On `main`, the new plugin is in `src/` and `build/`; the legacy tree is in
+`legacy/v1/`. The unchanged `master` branch retains original legacy paths.
+The v2 website is available at https://preview.viewstl.com/.
 
 ## Quick start
 
-Install with `npm install @omrips/viewstl@2.0.0-rc.3`, then copy the complete
-`node_modules/@omrips/viewstl/build/v2/` folder to `/viewstl-v2/` on your website.
+Download the plugin ZIP from the [GitHub release](https://github.com/omrips/viewstl/releases/tag/v2.0.0-rc.5),
+then copy its complete `build/` folder to `/viewstl-v2/` on your website.
 Paste these three lines into your page's `<body>`:
 
 ```html
@@ -23,7 +23,7 @@ required so the viewer can find its worker and optional format assets.
 
 ## Browser script
 
-Copy the complete `build/v2/` directory to your server, including the
+Copy the complete `build/` directory to your server, including the
 worker, its `chunks/` and `cad/` directories and third-party notices. Then:
 
 ```html
@@ -58,11 +58,13 @@ The package contains ESM, CommonJS and TypeScript entry points. Importing
 the package is safe during server-side rendering; constructing a viewer
 requires a browser DOM and WebGL2.
 
-The package name is `@omrips/viewstl`, under the verified `omrips` npm account.
-Release candidates use the `next` dist-tag. Pin the version above for a
-repeatable installation; installing a local release tarball is also supported.
+Install with `npm install viewstl`. No version suffix is required: the `latest`
+tag selects the current release candidate. The established `@omrips/viewstl`
+package is also updated with the same plugin; `npm install @omrips/viewstl`
+works without a version suffix. Use either package name consistently in imports
+and asset-copy paths; there is no need to install both.
 
-With a bundler, copy the complete `node_modules/@omrips/viewstl/build/v2/`
+With a bundler, copy the complete `node_modules/viewstl/build/`
 directory to your app's public assets (for example `public/viewstl-v2/`), keeping
 the worker, `chunks/`, `cad/` and notices together. Set `worker_url` to its served
 URL, or provide your bundler's worker factory.
@@ -70,7 +72,7 @@ Do not assume a bundler copies a module worker's dynamic chunks merely
 because it sees a URL string.
 
 ```js
-import StlViewer from '@omrips/viewstl';
+import StlViewer from 'viewstl';
 
 const viewer = new StlViewer(container, {
   worker_url: '/viewstl-v2/viewstl.worker.js'
@@ -80,7 +82,7 @@ const viewer = new StlViewer(container, {
 For Vite, the optional factory form is:
 
 ```js
-import ViewerWorker from '@omrips/viewstl/worker?worker';
+import ViewerWorker from 'viewstl/worker?worker';
 const viewer = new StlViewer(container, {
   worker_factory: () => new ViewerWorker()
 });
@@ -96,17 +98,17 @@ The CommonJS entry point also requires
 
 ## Node.js model analysis
 
-Install `npm install @omrips/viewstl@2.0.0-rc.3`. Node.js 20+ resolves the analysis
+Run `npm install viewstl`. Node.js 20+ resolves the analysis
 worker and optional CAD WASM directly inside the package; there is no asset-copy
 step for server use.
 
 ```js
-import { analyzeFile } from '@omrips/viewstl/node';
+import { analyzeFile } from 'viewstl/node';
 const report = await analyzeFile('part.stl', { units: 'mm' });
 console.log(report.dimensions_mm, report.surface_area_mm2, report.volume_mm3);
 ```
 
-CommonJS is supported with `const { analyzeFile } = require('@omrips/viewstl/node')`.
+CommonJS is supported with `const { analyzeFile } = require('viewstl/node')`.
 The `/node` entry point is separate from the browser viewer and has no DOM,
 WebGL or Three.js dependency. It supports STL, OBJ, 3MF, STEP/STP and IGES/IGS.
 STEP/IGES measurements describe the tessellated mesh, not exact CAD surfaces.
@@ -119,7 +121,7 @@ object. `analyzeBuffer(data, options)` accepts a Node Buffer, Uint8Array or
 ArrayBuffer, and requires `filename` or `format` to identify the format:
 
 ```js
-import { analyzeBuffer } from '@omrips/viewstl/node';
+import { analyzeBuffer } from 'viewstl/node';
 const report = await analyzeBuffer(uploadBuffer, { filename: 'part.stl', units: 'mm' });
 ```
 
@@ -151,7 +153,7 @@ The convenience functions share an analyzer with two active workers, up to
 Create an independent analyzer when the host needs different concurrency:
 
 ```js
-import { createAnalyzer } from '@omrips/viewstl/node';
+import { createAnalyzer } from 'viewstl/node';
 const analyzer = createAnalyzer({ concurrency: 1, max_queue: 4 });
 try {
   const reports = await Promise.all(paths.map(path => analyzer.analyzeFile(path, {
@@ -220,7 +222,7 @@ app.dispose(); // cancels work and releases listeners, workers and WebGL
 
 This controller binds the preview's HTML control layout; the host supplies
 markup and CSS. The reference layout is `Viewstl/site/index.html` in the sibling
-website workspace. `requiredControls` in `src/v2/app.js` validates the control
+website workspace. `requiredControls` in `src/app.js` validates the control
 IDs before registering handlers. Missing controls and duplicate mounts produce
 a descriptive error. Custom integrations without that layout use `StlViewer`.
 Branding, page metadata, advertisements and static help/privacy text belong
@@ -269,7 +271,7 @@ internal geometry or retain its buffers.
   Use self-contained exports: external part files are not fetched, and native
   SolidWorks/Solid Edge formats, feature history, PMI and curve-only files are
   unsupported. Incomplete external-reference assemblies may lack parts.
-- Deploy the entire `build/v2/cad/` directory alongside `chunks/` and the worker.
+- Deploy the entire `build/cad/` directory alongside `chunks/` and the worker.
   CAD code/WASM is loaded only for CAD files; local input bytes are never uploaded.
   Each job's worker is terminated on completion, cancellation, error or timeout.
   CAD admission estimates 128 MiB plus 40 times the input size. The WASM heap
@@ -304,6 +306,109 @@ Transparency uses model-level back-to-front sorting; intersecting transparent
 surfaces can still have ordering artifacts. STL export stores face color,
 so a 3MF triangle's per-vertex gradient cannot survive STL/VSB export exactly.
 
+## Model animation
+
+Animation is included in `2.0.0-rc.5` on GitHub and in both npm packages.
+Playback remains inside the native WebGL2 plugin.
+
+After a model has loaded, one call starts continuous rotation:
+
+```js
+await viewer.when_idle();
+viewer.animate_model(0, {
+  delta: { rotationz: 2 * Math.PI, msec: 5000, loop: true },
+});
+```
+
+The legacy `animation` model option also works. `delta` adds a change to the
+starting pose; `exact` interpolates toward an absolute target. They can operate
+together on different properties and finish independently:
+
+```js
+viewer.animate_model(0, {
+  delta: { rotationx: 1, rotationy: 1.1, rotationz: 1.2, msec: 1000, loop: true },
+  exact: { x: 1000, y: 150, z: 200, scale: 5, msec: 3000 },
+});
+
+viewer.pause_model_animation(0);  // Keep the pose and elapsed time.
+viewer.resume_model_animation(0);
+console.log(viewer.get_model_animation_state(0));
+viewer.animate_model(0, null);    // Stop at the current pose; discard playback.
+```
+
+Supported properties are `x/y/z`, `rotationx/y/z` in radians and
+`scale` or `scalex/scaley/scalez`. Durations are positive milliseconds, defaulting
+to 300. Scale deltas are additive, as in the legacy API; all resulting scales
+must stay positive. Only delta tracks repeat, accumulating their change each
+cycle. A negative looping scale delta is rejected. Delta and exact may not claim
+the same property. Inputs must be finite and within JavaScript's safe numeric
+range. Invalid replacements leave the current animation intact.
+
+Starting a new animation replaces the old one from the current pose. Manual
+position, rotation, scale and unit setters stop that model's playback first.
+Camera interaction, color and viewing-mode changes remain usable. Completed
+tracks no longer write their properties. Removal, `clean()` and `dispose()`
+release playback; paused/completed models do not keep the render loop running.
+
+Timing follows elapsed frame timestamps, not frame count. Hidden documents and
+lost WebGL contexts suspend playback without including that gap on resumption.
+User pause is independent of this automatic suspension. State queries return
+`status`, `elapsed_ms`, `suspended` and active `tracks`; unknown IDs return null.
+
+Set callbacks in the viewer options:
+
+```js
+const viewer = new StlViewer(container, {
+  animation_state_callback(id, state, reason) {
+    console.log(id, state.status, reason);
+  },
+  animation_complete_callback(id, state) {
+    console.log('Finished', id, state.elapsed_ms);
+  },
+});
+```
+
+Callbacks describe transitions, not every frame, and are deferred until the
+current operation finishes. Completion fires once when every track finishes;
+an animation with a looping track does not complete. Call playback controls on
+loaded models, for example after `when_idle()`.
+
+VSB/VSJ preserve the animation definition, original pose, elapsed phase, rotation
+pivot and pause flag. Both scene-loading APIs start incoming animations together
+after all incoming models load. VSJ still needs its referenced model files.
+Animated VSB entries retain unscaled mesh data and explicit scale metadata;
+static entries retain the previous scale-baked convention. This prevents scale
+being applied twice. Older viewers may read the pose but cannot restore the new
+playback-state extension exactly.
+
+PNG and modern `export_models()` capture the current pose without stopping
+playback. Legacy `get_stl_bin()` keeps its documented scale/centering-only export
+convention. Regular model files do not store animation. Print checks should run
+while the affected models are paused; subsequent motion makes the report stale.
+
+A self-contained example is in `examples/v2/animation.html` in the source
+checkout (serve with `pnpm start`). It includes Play, Pause, Resume, Stop and Reset.
+
+The app controller also supports an optional `animation-*` group (see the new
+site's HTML template): `animation-details`, `animation-fields`, `animation-axis`,
+`animation-seconds`, `animation-direction`, `animation-play`, `animation-pause`,
+`animation-stop`, `animation-status` and `animation-error`. Supply the whole group
+or omit it. It exposes selected-model spin around the mesh center, duration
+(0.1–3,600 seconds per turn), direction and playback buttons. Other models keep
+playing when selection changes. Manual tools capture the current animated pose.
+Readouts update at most four times per second; geometry and GPU buffers are reused.
+
+`mountViewstlApp` composes `animation_state_callback` and
+`animation_complete_callback` options with its own UI behavior. `app.getState()`
+includes each model's current transform and `animation` state. Ordinary files
+never auto-spin. Imported running animations are paused when the browser reports
+`prefers-reduced-motion: reduce`; explicit user playback remains available.
+
+App print checks pause running target models. Optional `print-resume` and
+`print-animation-note` elements expose resumption; closing the panel does not
+silently restart motion. Resuming clears stale results and keeps the panel open.
+Scene saving includes playback; PNG and regular model saving capture a pose.
+
 ## Existing API and intentional differences
 
 The existing constructor, model options and documented method names are
@@ -609,6 +714,7 @@ pnpm install --frozen-lockfile
 pnpm build
 pnpm test
 pnpm check:types
+pnpm check:node-types
 pnpm check:legacy
 pnpm start
 pnpm pack
@@ -745,7 +851,8 @@ scene with many remote references can hit the relay's rate limit.
 Imports append models with new IDs and restore camera, background/grid, transforms,
 colors/opacity, view modes, smoothing and sections. Saved centering is converted
 to equivalent model positions without changing existing models' centering. Embed
-canvas size, resize/mouse controls and per-model animation are not imported.
+canvas size and resize/mouse controls are not imported. The development animation
+update also restores per-model animation and preserves its original pivot.
 Scene reading and mesh parsing use workers and the existing memory/triangle/archive
 limits. Models become visible together after all have loaded. Errors, cancellation,
 or a throwing progress callback remove the incoming models and retain the existing

package/docs/v2-verification.md

@@ -3,6 +3,164 @@
 This file records dated checks. Older sections describe the alpha at the time
 of each check; release-candidate results are recorded separately below.
 
+## GitHub root-layout release 2.0.0-rc.5 — 2026-11-07
+
+The release worktree places the v2 sources/distribution in `src/` and `build/`.
+The complete pre-v2 GitHub tree is archived under `legacy/v1/`; its 23 original
+Git blobs and the 14-file local v1.14 snapshot pass SHA-256/size verification.
+Historical sections below retain the paths and versions used at the time.
+
+All **136 unit tests** pass, along with strict browser and Node TypeScript
+consumers. Actual desktop Chrome 156, without device emulation, passes **46
+browser checks**: 15 compatibility, 11 animation, 11 scene and 9 export checks.
+These exercise the relocated classic/ESM entries, module workers, legacy mesh
+bridge, STL/OBJ/3MF/STEP/IGES export/reimport, scene playback, cancellation,
+context restoration and a responsive million-triangle STL export.
+
+The packed `@omrips/viewstl@2.0.0-rc.5` tarball installs into a clean consumer
+project. Browser ESM/CommonJS exports, version reporting, worker/CAD asset paths,
+and server analysis of STL, OBJ, 3MF, STEP and IGES pass. Node analysis also
+passes through the CommonJS entry. Archive contents exclude development fixtures,
+legacy runtime copies and site/server files; license notices and lazy assets are included.
+
+The layout update also corrects old harness references to the legacy parser and
+worker directory. The compatibility animation assertion now waits for the public
+completion callback and checks the public completed state, rather than assuming
+the old private animation representation or a fixed wall-clock delay.
+
+Evidence is retained locally in the original plugin checkout under
+`test-results/github-v2-20261107/`. Physical mobile, Safari and Firefox validation
+remain pending. This release does not update the preview website or npm registry.
+
+## Live animation save/open verification — 2026-11-02
+
+Verified the existing `20261102-f04f34e66b7c` release through the actual Save and
+Open controls on `https://preview.viewstl.com/`, in desktop in-app Chromium.
+No runtime changes or redeployment were needed. Two binary STL fixtures have
+offset geometry centers: one runs reverse X rotation at 3 seconds per turn and
+is paused; the other runs forward Z rotation at 7 seconds per turn.
+
+Both VSB and VSJ were downloaded, the page was freshly reloaded, and the downloaded
+files were opened and saved again. **40 checks pass** against the resulting files
+and visible controls: two models, camera, position/scale/appearance, animation
+definition, pivot/origin, pause state, exact paused time and pose, advancing running
+time and a pose consistent with that time. VSB mesh coordinates match both their
+original files and the re-saved archive. VSJ file references remain intact. The
+paused model's elapsed time stayed exactly `7400.434000000001` ms in both formats;
+the running model continued from each saved time instead of restarting.
+
+A second pair of files was saved with both models paused. PNGs downloaded before
+saving and after independently reopening each format are **byte-for-byte equal**.
+VSB opens alone; VSJ was opened together with its two referenced STL files. Paused
+models expose Resume with the restored axis, duration and direction. There were
+no console errors on the final restored page. This is desktop-browser evidence,
+not physical mobile or other-browser coverage.
+
+The website workspace retains actual downloads, UI-state records, PNGs and
+`verification.json` in `results/animation-roundtrip-20261102/`. Recheck those
+artifacts with `node site/qa/verify-animation-downloads.mjs --images`; regenerate
+the offset STL fixtures with `node site/qa/make-animation-fixtures.mjs`.
+
+## Preview-site animation integration — 2026-11-02
+
+Deployed to preview as `20261102-f04f34e66b7c`. The optional animation app binding
+is bundled inside viewstl.js; the site's initializer is unchanged. The site adds
+static controls under Models → Animation: axis, seconds per turn, direction and
+Play/Pause/Resume/Stop. Off-center models spin about their center without moving
+their visible pose. Editing uses current transforms, and adding/selecting files
+preserves other models' animation. Print checks pause their targets and offer
+explicit Resume while keeping the results panel open. Reduced-motion preference
+pauses restored playback. Stopped animations also retain an equivalent static
+VSJ pose with the original referenced mesh.
+
+All **136 unit tests**, both strict type checks and the legacy guard pass.
+Actual desktop Chromium 156 passes **25 new integration checks** and **96 existing
+site checks**. New coverage includes invalid speed, concurrent models, live-pose
+manual editing, drag entry, print pause/resume, VSB phase/pause restoration,
+stopped off-center VSJ reopening with an identical PNG, callback composition,
+clear/dispose/remount and simulated reduced motion. Keyboard Enter playback was
+also exercised. 320px and 390px viewport checks show no horizontal overflow and
+44px-high playback buttons; these are emulated widths, not physical touch tests.
+
+All 29 public HTTPS files match the local SHA-256 manifest. Live browser smoke
+checks cover loading, keyboard playback and print-check interaction. Nginx, relay
+and Certbot remain active; configuration/service/binary hashes match the previous
+release and SELinux remains enforcing. Initial gzip total is 57,897 bytes; the
+viewer entry is 42,150 bytes. No new million-triangle or total-memory benchmark
+was performed for the app controls; the earlier plugin measurement remains below.
+Physical mobile, Safari/Firefox and actual hidden-tab behavior remain unverified.
+
+Evidence: the site workspace's `results/animation-integration/` and
+`results/deploy-20261102-f04f34e66b7c/`. Reproduce the browser checks through the
+local-only `site/qa/animation.html` and `site/qa/index.html` pages. The QA harness
+is excluded from deployment. npm is unchanged (`2.0.0-rc.4`); no GitHub push.
+
+## Model animation — unreleased development update, 2026-11-02
+
+The local plugin now has validated legacy delta/exact playback, per-model
+pause/resume/state queries and transition/completion callbacks. Animation uses
+elapsed frame time, retires finished tracks independently, stops on manual
+transform edits and suspends on document hiding or context loss. VSJ and both
+VSB APIs preserve animation phase, pause state, units and rotation pivot; animated
+VSB meshes retain scale in metadata to avoid applying it twice on reopening.
+The native WebGL2 renderer and existing worker architecture remain in use.
+
+- All **132 Node tests pass** on Node.js 24.19.0, Windows. Nine new tests cover
+  mixed durations, frame cadence, pause/resume/suspension, manual changes,
+  replacement and copied state, scale/statistics invalidation, invalid numeric
+  inputs and overflow, scene validation, VSJ/VSB restoration and export snapshots.
+- Browser and server-only strict TypeScript checks pass. The legacy guard passes
+  for tracked legacy files and all 14 archived files.
+- **11 animation browser checks pass** in actual desktop Chromium 156 on Windows,
+  using workers and WebGL2. These cover constructor playback, concurrent models,
+  idle behavior, pause/resume/stop, modern and legacy scene restoration, group
+  starts, bad-scene rollback, print-check staleness, mesh/PNG snapshots, forced
+  context loss/restoration and resource cleanup. Context loss is deliberately
+  triggered with `WEBGL_lose_context`, not a hardware failure.
+- Existing browser compatibility (**15**) and scene/rendering (**11**) checks
+  also pass: **37 passing browser checks** in total.
+- A generated **1,000,000-triangle** model animated over 120 measured frame
+  intervals: median **16.7 ms**, p95 **16.8 ms**, maximum **16.9 ms**. Geometry
+  objects and GPU resources retained identity, with two GPU buffers and
+  72,375,000 bytes of resident geometry typed arrays. These are frame intervals
+  on one desktop, not GPU timings, allocation profiling or total process memory.
+- The interactive example at `examples/v2/animation.html` runs locally and exposes
+  Play, Pause, Resume, Stop and Reset. No models or external assets are fetched.
+
+Actual hidden-tab behavior remains unverified: automation tab changes in the
+in-app browser and Chrome did not produce a document `visibilitychange` event.
+The suspension/resumption code is covered by unit tests and the real WebGL
+context-loss check. Firefox, Safari, physical phones/tablets, touch, reduced-motion
+site integration and a total-memory profile have not been tested in this update.
+
+Reproduce with `pnpm build`, `pnpm test`, `pnpm check:types`,
+`pnpm check:node-types`, `pnpm check:legacy`, then `pnpm start`. Open
+`tests/v2/animation-browser.html`, `tests/v2/browser.html` and
+`tests/v2/scene-browser.html` and run their checks. The million-triangle and
+background-tab checks have separate buttons on the animation page.
+
+Evidence is retained locally in ignored `test-results/animation-*` files. The
+package version is still `2.0.0-rc.4`; this development update has **not** been
+published to npm or deployed. The proposed site work is described in
+[the preview integration plan](v2-animation-site-plan.md).
+
+## 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`

package/legacy/README.md

@@ -1,20 +1,26 @@
 # Preserved legacy versions
 
-The existing `src/`, top-level `build/` files, and `dependencies/` remain
-the GitHub legacy implementation. Keep their existing download paths.
-New v2 output belongs under `build/v2/`.
+On the v2 `main` branch, [`v1/`](v1/) contains the complete legacy GitHub
+tree, including its original README, source, build, dependencies and license.
+Its manifest records the original bytes and SHA-256 hashes of all 23 files.
+
+The existing [`master` branch](https://github.com/omrips/viewstl/tree/master)
+remains unchanged at the baseline below, preserving explicit master download
+URLs. Existing tags are retained. New v2 source and output live at the root
+under `src/` and `build/` on `main`; callers following the default branch
+receive v2 and should review its migration notes.
 
 ## GitHub baseline
 
 - Repository: https://github.com/omrips/viewstl
-- Original default branch: `master`
+- Legacy branch: `master` (the default before v2)
 - Baseline commit: `fbb7f5c3894862778c3a6c5d2630573e2496d01f`
-- Local preservation tag: `legacy-before-v2-2026-09-30`
-- Latest published release when inspected: `v1.13`
+- Preservation tag: `legacy-before-v2-2026-09-30`
+- Latest legacy version tag: `v1.13`
 
 The baseline commit includes changes after the `v1.13` tag. Do not treat the
-release tag and the current legacy branch as identical. The preservation
-tag and development branch are local until explicitly pushed to GitHub.
+release tag and the legacy branch as identical. The v2 release preserves
+both that branch and the existing version tags.
 
 ## Local website snapshot
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omrips/viewstl",
-  "version": "2.0.0-rc.3",
+  "version": "2.0.0-rc.5",
   "description": "Local-first STL, OBJ, 3MF, STEP and IGES viewer with native WebGL2 and transferable worker geometry",
   "type": "module",
   "license": "MIT",
@@ -18,71 +18,54 @@
   ],
   "publishConfig": {
     "access": "public",
-    "tag": "next",
+    "tag": "latest",
     "registry": "https://registry.npmjs.org/"
   },
   "repository": {
     "type": "git",
     "url": "https://github.com/omrips/viewstl.git"
   },
-  "main": "./build/v2/viewstl.cjs",
-  "module": "./build/v2/viewstl.js",
-  "types": "./build/v2/viewstl.d.ts",
+  "main": "./build/viewstl.cjs",
+  "module": "./build/viewstl.js",
+  "types": "./build/viewstl.d.ts",
   "exports": {
     ".": {
       "import": {
-        "types": "./build/v2/viewstl.d.ts",
-        "default": "./build/v2/viewstl.js"
+        "types": "./build/viewstl.d.ts",
+        "default": "./build/viewstl.js"
       },
       "require": {
-        "types": "./build/v2/viewstl.d.cts",
-        "default": "./build/v2/viewstl.cjs"
+        "types": "./build/viewstl.d.cts",
+        "default": "./build/viewstl.cjs"
       }
     },
     "./node": {
       "node": {
         "import": {
-          "types": "./build/v2/node/index.d.ts",
-          "default": "./build/v2/node/index.js"
+          "types": "./build/node/index.d.ts",
+          "default": "./build/node/index.js"
         },
         "require": {
-          "types": "./build/v2/node/index.d.cts",
-          "default": "./build/v2/node/index.cjs"
+          "types": "./build/node/index.d.cts",
+          "default": "./build/node/index.cjs"
         }
       }
     },
-    "./worker": "./build/v2/viewstl.worker.js",
-    "./browser": "./build/v2/stl_viewer.min.js",
-    "./assets/*": "./build/v2/*",
+    "./worker": "./build/viewstl.worker.js",
+    "./browser": "./build/stl_viewer.min.js",
+    "./assets/*": "./build/*",
     "./package.json": "./package.json"
   },
   "files": [
-    "build/v2",
+    "build",
     "LICENSE",
     "docs/v2-usage.md",
     "docs/v2-compatibility.md",
     "docs/v2-verification.md",
+    "docs/releases/2.0.0-rc.5.md",
     "legacy/README.md",
     "THIRD-PARTY-NOTICES.txt"
   ],
-  "scripts": {
-    "build": "node scripts/build-v2.mjs",
-    "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",
-    "prettier": "3.9.9",
-    "saxes": "6.0.0",
-    "typescript": "5.9.3"
-  },
   "engines": {
     "node": ">=20"
   }

package/build/v2/README.md

@@ -1,15 +0,0 @@
-# Native WebGL2 build
-
-Generated ViewSTL v2.00 release-candidate artifacts. `stl_viewer.min.js` and `viewstl.min.js` are
-classic scripts exposing `StlViewer`. `viewstl.js` is the ES module;
-`viewstl.cjs` is the CommonJS entry. Keep the module worker, `chunks/` and `cad/`
-directories and license notices beside these files when deploying. See [usage](../../docs/v2-usage.md).
-
-The existing `../stl_viewer.min.js` and its companion files remain the
-legacy distribution. A v2 build must never overwrite those files.
-
-See [the compatibility requirements](../../docs/v2-compatibility.md).
-
-`node/` contains the separate server analysis entry points and worker, exported
-as `@omrips/viewstl/node`. These resolve `cad/` inside the npm package; Node users
-do not need to copy assets to a website.

package/build/v2/chunks/archive-VGS4J4Z7.js

@@ -1 +0,0 @@
-import{a,b,c,d}from"./chunk-R3HNTB5A.js";import"./chunk-ZSV4PTIA.js";import"./chunk-JH3H3JWA.js";import"./chunk-JS56KC3I.js";import"./chunk-U33KANV7.js";export{d as parse3MF,a as safePath,b as unzipChecked,c as zipScene};

package/build/v2/chunks/scene-reader-APUJOPUR.js

@@ -1 +0,0 @@
-import{b as p}from"./chunk-R3HNTB5A.js";import"./chunk-ZSV4PTIA.js";import{b as d}from"./chunk-JH3H3JWA.js";import"./chunk-JS56KC3I.js";import"./chunk-U33KANV7.js";var w=["flat","smooth","wireframe","edges","mesh","xray","studio","orientation"];function h(e,a){if(!w.includes(e))throw new Error("Invalid display mode");if(typeof a!="boolean")throw new Error("smooth_shading must be a boolean");return{display:e,smooth_shading:e==="smooth"||a}}function g(e){if(e==null)return null;if(!["x","y","z"].includes(e.axis))throw new Error("Section axis must be x, y or z");if(!Number.isFinite(e.position)||e.position<0||e.position>1)throw new Error("Section position must be between 0 and 1");if(e.flip!==void 0&&typeof e.flip!="boolean")throw new Error("Section flip must be a boolean");return{axis:e.axis,position:e.position,flip:e.flip??!1}}var c=["x","y","z"],l=(e,a,n=!1)=>{if(typeof e!="number"||!Number.isFinite(e)||n&&e<=0)throw new Error(`Invalid scene ${a}`);return e},u=e=>String(e||"").match(/\.(vsb|vsj)(?:[?#]|$)/i)?.[1].toLowerCase()||"";function m(e,a){if(!e||!Array.isArray(e.models)||!e.models.length||e.models.length>a.max_archive_entries)throw new Error("Invalid, empty or oversized scene manifest");let n={models:[]};for(let o of["center_models","auto_rotate","grid"])if(e[o]!==void 0){if(typeof e[o]!="boolean")throw new Error(`Invalid scene ${o}`);n[o]=e[o]}if(e.bg_color!==void 0&&(e.bg_color!=="transparent"&&d(e.bg_color),n.bg_color=e.bg_color),e.infinite_grid&&(n.infinite_grid={spacing:l(e.infinite_grid.spacing,"grid spacing",!0),height:l(e.infinite_grid.height,"grid height")}),e.camera_state){let o={};for(let r of["position","target","up"])o[r]=Object.fromEntries(c.map(s=>[s,l(e.camera_state[r]?.[s],"camera")]));let t=c.map(r=>o.position[r]-o.target[r]),i=c.map(r=>o.up[r]);if(!Math.hypot(...t)||!Math.hypot(...i)||!Math.hypot(t[1]*i[2]-t[2]*i[1],t[2]*i[0]-t[0]*i[2],t[0]*i[1]-t[1]*i[0]))throw new Error("Invalid scene camera");n.camera_state=o}for(let o of e.models){if(!o||typeof o.filename!="string"||!o.filename||o.filename.length>8192||/[\x00-\x1f\x7f]/.test(o.filename))throw new Error("Scene model filename is missing or invalid");if(u(o.filename))throw new Error("Nested scene references are not supported");let t={filename:o.filename};typeof o.orig_filename=="string"&&(t.orig_filename=o.orig_filename.slice(0,200));for(let i of c)for(let r of["","rotation","scale"]){let s=r+i;o[s]!==void 0&&(t[s]=l(o[s],s,r==="scale"))}if(o.scale!==void 0&&(t.scale=l(o.scale,"scale",!0)),o.opacity!==void 0&&(t.opacity=l(o.opacity,"opacity"),t.opacity<0||t.opacity>1))throw new Error("Invalid scene opacity");if(o.color!=null&&(o.color!=="transparent"&&d(o.color),t.color=o.color),t.units=o.units??"mm",!["mm","inch"].includes(t.units))throw new Error("Invalid scene units");if(Object.assign(t,h(o.display??"flat",o.smooth_shading??o.display==="smooth")),t.section=g(o.section),o.view_edges!==void 0&&typeof o.view_edges!="boolean")throw new Error("Invalid scene edges");t.view_edges=!!o.view_edges,n.models.push(t)}return n}function S(e,a,n){let o=Object.create(null),t=e;if(a==="vsb"){let i=p(e,n);if(t=i.get("json_data.vsj"),!t)throw new Error("VSB manifest json_data.vsj is missing");let r=m(JSON.parse(new TextDecoder("utf-8",{fatal:!0}).decode(t)),n);for(let s of r.models){let f=i.get(s.filename);if(!f)throw new Error("VSB model file is missing: "+s.filename);o[s.filename]=f.buffer.slice(f.byteOffset,f.byteOffset+f.byteLength)}return{scene:r,files:o}}return{scene:m(JSON.parse(new TextDecoder("utf-8",{fatal:!0}).decode(t)),n),files:null}}export{S as readSceneDocument};