Merge branch 'playcanvas:main' into main

Author: AlexAPPi

.github/dependabot.yml

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "packageRules": [
+    {
+      "matchManagers": [
+        "npm"
+      ],
+      "groupName": "all npm dependencies",
+      "schedule": [
+        "on monday at 10:00am"
+      ]
+    },
+    {
+      "matchDepTypes": ["devDependencies"],
+      "rangeStrategy": "pin"
+    },
+    {
+      "matchDepTypes": ["dependencies"],
+      "rangeStrategy": "widen"
+    }
+  ],
+  "ignorePaths": [".nvmrc"]
+}

.github/renovate.json

@@ -26,7 +26,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies
@@ -49,7 +49,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies
@@ -69,7 +69,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies
@@ -95,7 +95,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies
@@ -107,8 +107,8 @@ jobs:
     - name: Compile TypeScript declarations
       run: npm run test:types
 
-  unit-test-node:
-    name: Unit Test (Node)
+  unit-test:
+    name: Unit Test
     runs-on: ubuntu-latest
     timeout-minutes: 10
     steps:
@@ -118,7 +118,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies
@@ -127,32 +127,6 @@ jobs:
     - name: Run unit tests
       run: npm test
 
-  unit-test-karma:
-    name: Unit Test (Karma)
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-
-    - name: Setup Node.js 18.x
-      uses: actions/setup-node@v4
-      with:
-        node-version: 18.x
-        cache: 'npm'
-
-    - name: Install dependencies
-      run: npm clean-install --progress=false --no-fund
-
-    - name: Build PlayCanvas (UMD-only)
-      run: npm run build:umd
-
-    - name: Install X virtual framebuffer
-      run: sudo apt-get install xvfb
-
-    - name: Run unit tests
-      run: xvfb-run --auto-servernum npm run test:karma
-
   build-examples:
     name: Build Examples Browser
     runs-on: ubuntu-latest
@@ -164,7 +138,7 @@ jobs:
     - name: Setup Node.js 18.x
       uses: actions/setup-node@v4
       with:
-        node-version: 18.x
+        node-version: 22.x
         cache: 'npm'
 
     - name: Install dependencies

.github/workflows/ci.yml

@@ -4,33 +4,28 @@ on:
   push:
     tags:
       - 'v[0-9]+.[0-9]+.[0-9]+'
-      - 'v[0-9]+.[0-9]+.[0-9]+-alpha.[0-9]+'
+      - 'v[0-9]+.[0-9]+.[0-9]+-preview.[0-9]+'
 
 jobs:
   publish-npm:
     runs-on: ubuntu-latest
+    if: github.repository == 'playcanvas/engine'
     steps:
       - name: Check out code
         uses: actions/checkout@v4
 
       - name: Set up Node.js 18.x
         uses: actions/setup-node@v4
         with:
-          node-version: 18.x
+          node-version: 22.x
           cache: 'npm'
           registry-url: 'https://registry.npmjs.org/'
 
-      - name: Determine pre-release tag
-        id: release-tag
+      - name: Parse tag name
         run: |
           TAG_NAME=${GITHUB_REF#refs/tags/}
-          echo "Detected tag: $TAG_NAME"
-          if [[ "$TAG_NAME" == *-alpha.* ]]; then
-            echo "tag=alpha" >> $GITHUB_ENV
-            npm version --no-git-tag-version $TAG_NAME
-          else
-            echo "tag=latest" >> $GITHUB_ENV
-          fi
+          echo "TAG=${TAG_NAME}" >> $GITHUB_ENV
+          echo "VERSION=${TAG_NAME/v/}" >> $GITHUB_ENV
 
       - name: Install Dependencies
         run: npm install
@@ -42,6 +37,20 @@ jobs:
         run: npm run publint
 
       - name: Publish to npm
-        run: npm publish --tag ${{ env.tag }}
+        run: |
+          if [[ "${{ env.TAG }}" =~ "preview" ]]; then
+            tag=preview
+          else
+            tag=latest
+          fi
+          npm publish --tag $tag
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to code.playcanvas.com
+        run: |
+          if ! curl -sS -X POST -H "Content-Type: application/json" \
+            -d '{ "engineVersion": "${{ env.VERSION }}" }' ${{ secrets.PUBLISH_ENDPOINT }}; then
+            echo "Failed to publish to code.playcanvas.com"
+            exit 1
+          fi

.github/workflows/publish.yaml

@@ -2,7 +2,7 @@
 .idea/
 .vscode/
 build
-tree*.html
+tree*.*.html
 coverage
 docs
 examples/dist

.gitignore

@@ -4,7 +4,7 @@
 
 # PlayCanvas WebGL Game Engine
 
-[API Reference](https://api.playcanvas.com/modules/Engine.html) | [User Manual](https://developer.playcanvas.com) | [Examples](https://playcanvas.github.io) | [Forum](https://forum.playcanvas.com) | [Blog](https://blog.playcanvas.com)
+[API Reference](https://api.playcanvas.com/engine/) | [User Manual](https://developer.playcanvas.com) | [Examples](https://playcanvas.github.io) | [Forum](https://forum.playcanvas.com) | [Blog](https://blog.playcanvas.com)
 
 PlayCanvas is an open-source game engine. It uses HTML5 and WebGL to run games and other interactive 3D content in any mobile or desktop browser.
 

README.md

@@ -9,9 +9,10 @@
  *     - bundleState (unbundled, bundled)
  * Example: target:esm:release:bundled
  *
- * treemap - Enable treemap build visualization.
- * treenet - Enable treenet build visualization.
- * treesun - Enable treesun build visualization.
+ * treemap - Enable treemap build visualization (release only).
+ * treenet - Enable treenet build visualization (release only).
+ * treesun - Enable treesun build visualization (release only).
+ * treeflame - Enable treeflame build visualization (release only).
  */
 
 import { execSync } from 'child_process';
@@ -22,7 +23,8 @@ const ENV_START_MATCHES = [
     'target',
     'treemap',
     'treenet',
-    'treesun'
+    'treesun',
+    'treeflame'
 ];
 
 const env = [];

build.mjs

@@ -1,18 +1,19 @@
 import playcanvasConfig from '@playcanvas/eslint-config';
-import babelParser from '@babel/eslint-parser';
 import globals from 'globals';
 
+// Extract or preserve existing JSDoc tags
+const jsdocRule = playcanvasConfig.find(
+    config => config.rules && config.rules['jsdoc/check-tag-names']
+);
+const existingTags = jsdocRule?.rules['jsdoc/check-tag-names'][1]?.definedTags || [];
+
 export default [
     ...playcanvasConfig,
     {
         files: ['**/*.js', '**/*.mjs'],
         languageOptions: {
             ecmaVersion: 2022,
             sourceType: 'module',
-            parser: babelParser,
-            parserOptions: {
-                requireConfigFile: false
-            },
             globals: {
                 ...globals.browser,
                 ...globals.mocha,
@@ -27,7 +28,14 @@ export default [
             }
         },
         rules: {
-            'import/order': 'off'
+            'import/order': 'off',
+            'jsdoc/check-tag-names': [
+                'error',
+                {
+                    // custom mjs script tags to not error on, add them to those from parent config
+                    definedTags: [...new Set([...existingTags, 'range', 'step', 'precision'])]
+                }
+            ]
         }
     },
     {
@@ -36,16 +44,23 @@ export default [
             'no-var': 'off'
         }
     },
+    {
+        files: ['scripts/**/*.mjs'],
+        rules: {
+            'jsdoc/no-defaults': 'off', // Attributes use default values
+            'import/no-unresolved': 'off' // PlayCanvas is not installed for scripts
+        }
+    },
     {
         files: ['test/**/*.mjs'],
         rules: {
+            'import/order': 'error',
             'no-unused-expressions': 'off',
             'prefer-arrow-callback': 'off' // Mocha uses function callbacks
         }
     },
     {
         ignores: [
-            'tests/**/*',
             'examples/lib/*',
             'scripts/textmesh/*.min.js',
             'src/polyfill/*',