Merge branch 'master' into 1285-fix-resetCameraScreenSpace

Author: aerogt3

.github/workflows/build-test.yml

@@ -35,7 +35,7 @@ jobs:
           npx tsc -p tsconfig.esm-check.json
           npx tsc -p tsconfig.umd-check.json
       - name: Chrome and Firefox tests
-        run: xvfb-run --auto-servernum npm run test -- --browsers Chrome,Firefox
+        run: xvfb-run --auto-servernum npm run test -- --browsers ChromeSwiftShader,Firefox
       - name: Archive test results
         if: github.event_name != 'merge_group' && (success() || failure())
         uses: actions/upload-artifact@v4

.github/workflows/pr-checks.yml

@@ -24,4 +24,4 @@ jobs:
       - name: Tests must not use test.only
         run: bash .github/workflows/test-only-check.sh
       - name: API docs should generate without error
-        run: npm run doc:generate-api
+        run: npm run docs:generate-api

.github/workflows/publish.yml

@@ -26,7 +26,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Setup node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: 22
       - name: Install dependencies
@@ -42,7 +42,7 @@ jobs:
           npx tsc -p tsconfig.esm-check.json
           npx tsc -p tsconfig.umd-check.json
       - name: Chrome and Firefox tests
-        run: xvfb-run --auto-servernum npm run test -- --browsers Chrome,Firefox
+        run: xvfb-run --auto-servernum npm run test -- --browsers ChromeSwiftShader,Firefox
       - name: Archive test results
         if: always()
         uses: actions/upload-artifact@v4
@@ -53,7 +53,8 @@ jobs:
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          # No need to set NPM_TOKEN because of OIDC
+          NPM_CONFIG_PROVENANCE: true
         run: |
           git config --global user.name "Github Actions"
           git config --global user.email "sebastien.jourdain@kitware.com"
@@ -80,13 +81,21 @@ jobs:
         run: npm ci
       - name: Build
         run: npm run build:release
-      - name: Build API docs
-        run: npm run doc:generate-api
+      - name: Generate API docs
+        run: npm run docs:generate-api
+      - name: Generate docs examples
+        run: npm run docs:generate-examples
+      - name: Generate docs sidebar
+        run: npm run docs:generate-sidebar
+      - name: Generate docs gallery
+        run: npm run docs:generate-gallery
       - name: Build docs
-        run: npm run doc:minified
+        run: npm run docs:build
+      - name: Build docs examples
+        run: npm run docs:build-examples
       - name: Upload docs as a Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: ./Documentation/build-tmp/public/
+          path: ./Documentation/.vitepress/dist/
       - name: Deploy docs
         uses: actions/deploy-pages@v4

.gitignore

@@ -10,3 +10,8 @@ coverage/
 .env
 Utilities/TestResults
 .idea
+Documentation/.vitepress/cache/
+Documentation/.vitepress/dist/
+Documentation/build-tmp/
+Documentation/content/
+Documentation/Examples/

BREAKING_CHANGES.md

@@ -1,3 +1,8 @@
+## From 34.x to 35
+
+- **vtkMapper**: mappers should overwrite `computeBounds()` instead of `getBounds` that now calls `computeBounds()` before returning a copy of the mapper bounds.
+
+
 ## From 33.x to 34
 
 - **vtkMapper**: many properties have moved to `vtkVolumeProperty`. The full list of changed methods is: `getAnisotropy`, `getComputeNormalFromOpacity`, `getFilterMode`, `getFilterModeAsString`, `getGlobalIlluminationReach`, `getIpScalarRange`, `getIpScalarRangeByReference`, `getLAOKernelRadius`, `getLAOKernelSize`, `getLocalAmbientOcclusion`, `getPreferSizeOverAccuracy`, `getVolumetricScatteringBlending`, `setAnisotropy`, `setAverageIPScalarRange`, `setComputeNormalFromOpacity`, `setFilterMode`, `setFilterModeToNormalized`, `setFilterModeToOff`, `setFilterModeToRaw`, `setGlobalIlluminationReach`, `setIpScalarRange`, `setIpScalarRangeFrom`, `setLAOKernelRadius`, `setLAOKernelSize`, `setLocalAmbientOcclusion`, `setPreferSizeOverAccuracy`, `setVolumetricScatteringBlending`.

CONTRIBUTING.md

@@ -53,10 +53,10 @@ Please follow the coding style:
     $ git push origin new_feature
     ```
 
-7. Visit your fork in Github, browse to the "**Pull Requests**" link on the left, and use the 
+10. Visit your fork in Github, browse to the "**Pull Requests**" link on the left, and use the
    "**New Pull Request**" button in the upper right to create a Pull Request.
 
-    For more information see: 
+    For more information see:
     [Create a Pull Request](https://help.github.com/articles/creating-a-pull-request/)
 
 If committing changes to `vtk.js@next` or `vtk.js@next-major`, then set your base branch to be `next`
@@ -99,7 +99,7 @@ you are satisfied with the staging branch changes, you can then merge into eithe
 ## Notice
 
 - Don't modify the version number in `package.json`.
-- Your pull request will only get merged when tests passed. Don't forget to run tests before 
+- Your pull request will only get merged when tests passed. Don't forget to run tests before
   submission.
 
     ```
@@ -116,18 +116,18 @@ To create and debug a test:
 
 ## Updating Documentation
 
-The vtk.js documentation is part of the code repository and is entirely written in 
+The vtk.js documentation is part of the code repository and is entirely written in
 [markdown](https://daringfireball.net/projects/markdown/).
 
 If you create an example, please list it in the [examples landing page](Documentation/content/examples/index.md).
 
-Images and GIF videos added to the [gallery](Documentation/content/docs/gallery) must be compressed as much as possible (e.g. 432px by 300px with 50% JPEG compression). You may want to use [ezgif.com](https://ezgif.com/).
+Images and GIF videos added to the [gallery](Documentation/public/gallery) must be compressed as much as possible (e.g. 500px by 280px with 50% JPEG compression). You may want to use [ezgif.com](https://ezgif.com/).
 
 ## Reporting Issues
 
 If you encounter problems using vtk.js you may be able to find the solutions in the
-[troubleshooting docs](https://kitware.github.io/vtk-js/docs/misc_troubleshooting.html), in an 
-existing [GitHub issue](https://github.com/kitware/vtk-js/issues), or via the 
+[troubleshooting docs](https://kitware.github.io/vtk-js/docs/misc_troubleshooting.html), in an
+existing [GitHub issue](https://github.com/kitware/vtk-js/issues), or via the
 [mailing list](http://www.vtk.org/VTK/help/mailing.html).
-If you can't find the answer, please 
+If you can't find the answer, please
 [report a new issue on GitHub](https://github.com/Kitware/vtk-js/issues/new).

Data/stl/spherewithholes.stl

@@ -0,0 +1,51 @@
+import { defineConfig } from 'vitepress';
+import llmstxt from 'vitepress-plugin-llms';
+import { copyOrDownloadAsMarkdownButtons } from 'vitepress-plugin-llms';
+
+import { sidebar } from './sidebar';
+import { BASE_URL, withBase } from './utils';
+
+// https://vitepress.dev/reference/site-config
+export default defineConfig({
+  base: BASE_URL,
+  lang: 'en-US',
+  title: 'VTK.js ',
+  description: 'VTK.js a Visualization Toolkit for the Web',
+  lastUpdated: true,
+  ignoreDeadLinks: true,
+  srcExclude: ['**/scripts/**',],
+  vite: {
+    plugins: [
+      llmstxt({
+        ignoreFiles: ['examples/*', 'coverage/*', 'scripts/*'],
+      }),
+    ],
+  },
+  themeConfig: {
+    // https://vitepress.dev/reference/default-theme-config
+    logo: '/logo-wide.svg',
+    siteTitle: '',
+    nav: [
+      { text: 'Docs', link: '/docs/' },
+      { text: 'API', link: '/api/' },
+      { text: 'Examples', link: '/examples/' },
+      { text: 'Datasets', link: 'https://kitware.github.io/vtk-js-datasets/' },
+    ],
+    sidebar: sidebar,
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/Kitware/vtk-js' },
+    ],
+    outline: 'deep',
+    search: {
+      provider: 'local',
+    },
+    footer: {
+      copyright: `© ${new Date().getFullYear()} <a href="https://www.kitware.com/" target="_blank">Kitware Inc</a>.`,
+    },
+  },
+  markdown: {
+    config(md) {
+      md.use(copyOrDownloadAsMarkdownButtons);
+    },
+  },
+});