create-playcanvas 0.13.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-playcanvas",
-    "version": "0.13.0",
+    "version": "0.14.0",
     "description": "Scaffold a PlayCanvas project",
     "keywords": [
         "playcanvas",
@@ -52,7 +52,7 @@
         "prettier": "^3.9.10",
         "unbuild": "^3.6.1",
         "vite": "^8.3.5",
-        "vitest": "^5.0.5"
+        "vitest": "^5.1.0"
     },
     "engines": {
         "node": ">=22.23.2"

package/skills/add-effects/SKILL.md

@@ -8,7 +8,8 @@ description: Use when adding visual effects to a PlayCanvas app, to choose betwe
 Pick the Engine building block first, then adapt its closest official example with
 `find-examples`:
 
-- Particle systems: the `particlesystem` component (`graphics/particles-*` examples).
+- Particle systems: the `particlesystem` component (`particles/*` examples; `graphics/particles-*`
+  before 2.24).
 - Custom shading on existing surfaces: `StandardMaterial` chunk overrides
   (`override-shader-chunks`), or a `ShaderMaterial` when the effect needs its own shader pair.
 - Procedural or per-frame geometry: a runtime-updated `Mesh` on a `render` component

package/skills/find-examples/SKILL.md

@@ -15,17 +15,18 @@ it locally. The npm package omits `examples/`, so otherwise fetch from the insta
 
 ```sh
 TAG="v$(node -p "JSON.parse(require('fs').readFileSync('node_modules/playcanvas/package.json')).version")" || exit 1
-gh api "repos/playcanvas/engine/git/trees/$TAG?recursive=1" | grep -o '"examples/src/examples/[^"]*\.example\.mjs"'
-gh api "repos/playcanvas/engine/contents/examples/src/examples/<category>/<name>.example.mjs?ref=$TAG" \
-  --jq .content | base64 --decode
+gh api "repos/playcanvas/engine/git/trees/$TAG?recursive=1" | grep -o '"examples/src/examples/[^"]*example\.mjs"'
+gh api "repos/playcanvas/engine/contents/<listed path>?ref=$TAG" --jq .content | base64 --decode
 ```
 
 Read the resolved package, not the dependency list; `playcanvas` is often transitive. An empty list
-means an invalid tag: stop rather than guess. Use `main` only when the version has no tag.
+means an invalid tag: stop rather than guess. Use `main` only when the version has no tag. From
+2.24, each Engine example is a folder with the shaders and other files it imports; earlier tags use
+`<name>.example.mjs` with sibling `<name>.*` files.
 
 | Surface | Repository | Ref | Example paths |
 | --- | --- | --- | --- |
-| direct Engine | `playcanvas/engine` | `v<version>` | `examples/src/examples/<category>/<name>.example.mjs` |
+| direct Engine | `playcanvas/engine` | `v<version>` | `examples/src/examples/<category>/<name>/example.mjs` |
 | Web Components | `playcanvas/web-components` | `v<version>` | `examples/<name>.html` |
 | React | `playcanvas/developer-site` | `main` | `docs/user-manual/react/examples/<name>.mdx` |
 

package/skills/inspect-glb/SKILL.md

@@ -37,4 +37,5 @@ transforms:
 npx --yes @gltf-transform/cli@4.4.2 copy in.glb scratch.glb
 ```
 
-The Engine cannot load `EXT_meshopt_compression`; see `load-assets` before shipping such files.
+The Engine loads Meshopt files only from 2.24, with a decoder; see `load-assets` before shipping
+them.

package/skills/inspect-runtime/SKILL.md

@@ -16,10 +16,8 @@ From Engine 2.23, every app announces itself to a hook at
 - Page code then reads `globalThis.__playcanvasApps`, a `Map` from each live app to
   `{ version, revision, protocol }`. `app.init()` adds the entry and `app.destroy()` removes it.
 - The script chains a hook defined before it, such as a devtools extension's.
-- No entry means the Engine predates 2.23, the hook loaded late, or the app set
-  `devtools: false`. The Engine swallows errors thrown by the hook.
-- In 2.23.0 only the debug build (`playcanvas/debug`, `build/playcanvas.dbg.*`) announces apps; the
-  default import never calls the hook. Later 2.23 patches fix every build.
+- No entry means the Engine predates 2.23, is a non-debug 2.23.0 build, the hook loaded late, or
+  the app set `devtools: false`. The Engine swallows hook errors.
 
 ## Read state
 
@@ -34,8 +32,11 @@ From Engine 2.23, every app announces itself to a hook at
 
 ## Inspector panel
 
-`@playcanvas/inspector` adds a panel for people: `new Inspector(app)` shows the hierarchy, assets,
-materials, shaders, textures, render targets, frame graph, and physics. It must import the app's
-own `playcanvas` package, so add it only to development builds. It draws over the canvas and
-applies view overrides, so destroy it before `verify-pixels` captures. Stepping through draws
-needs the debug build.
+`@playcanvas/inspector` is a debug panel: `new Inspector(app)` shows the hierarchy, assets, GPU
+resources, frame graph, physics, and frame timings; `record: true` records from creation. It must
+import the app's own `playcanvas` package, so add it only to development builds. It draws over the
+canvas and applies view overrides, so destroy it before `verify-pixels` captures. Stepping through
+draws needs the debug build.
+
+With `mcp: true` (0.5.0+), `await inspector.executeTool(name, args)` runs the tools `getTools()`
+lists: find entities, get objects by `$id`, record frames, take screenshots, and read logs.

package/skills/load-assets/SKILL.md

@@ -15,8 +15,9 @@ and `EXT_mesh_gpu_instancing`; do not rebuild these by hand. Preload asset sets
 
 ## Compress for size
 
-- Geometry: Draco (`KHR_draco_mesh_compression`). Meshopt is not supported, so decode such files
-  before shipping.
+- Geometry: Draco (`KHR_draco_mesh_compression`), or from Engine 2.24 Meshopt
+  (`EXT_meshopt_compression`, `KHR_meshopt_compression`). Older Engines cannot load Meshopt, so
+  decode such files before shipping.
 - Textures: KTX2 with Basis (`KHR_texture_basisu`) transcodes to a GPU format, cutting both
   download size and VRAM. ETC1S is smallest and lossy. UASTC is larger and keeps
   detail, which matters most for normal maps. Weigh size against visible detail.
@@ -42,6 +43,10 @@ basisInitialize({
 });
 ```
 
+From 2.24, also copy `meshopt/` and call
+`meshoptInitialize({ url: '/wasm/meshopt/meshopt_decoder.mjs' })` before loading Meshopt files;
+without it they fail unless they carry uncompressed fallback buffers.
+
 In Web Components, a `<pc-wasm name="DracoDecoderModule">` element under `<pc-app>` sets the Draco
 config with `glue`, `wasm`, and `fallback` attributes.
 

package/skills/override-shader-chunks/SKILL.md

@@ -8,7 +8,7 @@ description: Use when a PlayCanvas StandardMaterial needs custom shading its pro
 Overriding a `StandardMaterial` chunk keeps fog, tone mapping, shadows, skinning, and instancing
 intact. Use a `ShaderMaterial` only when the look needs its own vertex and fragment pair.
 
-- Set `material.shaderChunksVersion` to the installed major.minor, such as `'2.23'`. Chunk names
+- Set `material.shaderChunksVersion` to the installed major.minor, such as `'2.24'`. Chunk names
   and contracts change between versions, so read the installed chunk source, not memory.
 - Set chunks with `material.getShaderChunks(SHADERLANGUAGE_GLSL).set(name, source)` and the WGSL
   equivalent, then call `material.update()`. For every material on a device, use

package/templates/engine/base/package.json

@@ -15,11 +15,11 @@
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
-        "playcanvas": "^2.23.3"
+        "playcanvas": "^2.24.0"
     },
     "devDependencies": {
         "@playcanvas/eslint-config": "3.0.0",
-        "@playcanvas/inspector": "^0.4.0",
+        "@playcanvas/inspector": "^0.5.0",
         "eslint": "^9.39.5",
         "prettier": "^3.9.10",
         "typescript": "~6.0.3",

package/templates/react/base/package.json

@@ -16,16 +16,16 @@
     },
     "dependencies": {
         "@playcanvas/react": "^0.11.7",
-        "playcanvas": "^2.23.3",
+        "playcanvas": "^2.24.0",
         "react": "^19.3.1",
         "react-dom": "^19.3.1"
     },
     "devDependencies": {
         "@playcanvas/eslint-config": "3.0.0",
-        "@playcanvas/inspector": "^0.4.0",
+        "@playcanvas/inspector": "^0.5.0",
         "@types/react": "^19.3.0",
         "@types/react-dom": "^19.3.0",
-        "@vitejs/plugin-react": "^6.1.2",
+        "@vitejs/plugin-react": "^6.2.1",
         "eslint": "^9.39.5",
         "prettier": "^3.9.10",
         "typescript": "~6.0.3",

package/templates/web-components/base/package.json

@@ -15,12 +15,12 @@
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
-        "@playcanvas/web-components": "^0.28.1",
-        "playcanvas": "^2.23.3"
+        "@playcanvas/web-components": "^0.29.0",
+        "playcanvas": "^2.24.0"
     },
     "devDependencies": {
         "@playcanvas/eslint-config": "3.0.0",
-        "@playcanvas/inspector": "^0.4.0",
+        "@playcanvas/inspector": "^0.5.0",
         "eslint": "^9.39.5",
         "prettier": "^3.9.10",
         "typescript": "~6.0.3",