Merge branch 'main' into feat/explorer-ui-events-result

Resolves the conflicts main brought in with #1530 (audioEventSystem,
avatarEmoteCommand.state) and #1532 (jest 30, node >=24.16, dependency
slimming). Every conflict sat in a generated artifact, so main's side was
taken and the artifacts were regenerated instead of merged by hand.

@dcl/protocol moves off the PR tarball onto the published
1.0.0-31617402096.commit-86c4613, now that decentraland/protocol#455 is
merged. The development-dependency gate therefore no longer applies, and the
AvatarEmoteMask entry the experimental-based tarball dragged into
playground-assets.api.md is gone.

Lockfiles are regenerated with the Node version CI pins (24.16.0), which
drops the "libc" fields an older npm had written.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: popuz

.eslintignore

@@ -49,10 +49,10 @@ The repo is orchestrated via **`make`** (the Makefile is the source of truth —
 The full Jest suite is slow. For faster iteration, scope to a path pattern:
 
 ```bash
-node_modules/.bin/jest --colors --forceExit --testPathPattern='test/sdk-commands'
-node_modules/.bin/jest --colors --forceExit --testPathPattern='test/ecs'
-node_modules/.bin/jest --colors --forceExit --testPathPattern='test/react-ecs'
-node_modules/.bin/jest --colors --forceExit --testPathPattern='test/snapshots'
+node_modules/.bin/jest --colors --forceExit --testPathPatterns='test/sdk-commands'
+node_modules/.bin/jest --colors --forceExit --testPathPatterns='test/ecs'
+node_modules/.bin/jest --colors --forceExit --testPathPatterns='test/react-ecs'
+node_modules/.bin/jest --colors --forceExit --testPathPatterns='test/snapshots'
 ```
 
 ### Per-package typecheck

.eslintrc.json

@@ -110,14 +110,14 @@ Uses esbuild with `platform: 'browser'`, `format: 'cjs'`, `target: 'es2020'`, an
 | `-p, --port <number>` | HTTP port (auto-detected if omitted) |
 | `--dclenv <env>` | Explorer environment: `org` (mainnet production, default), `zone` (staging), `today` |
 | `--realm <name>` | Realm name shown in Explorer (default: `Localhost`) |
-| `--web3` | Enable Web3 wallet integration in the preview |
+| `--web3` | (deprecated) No effect; kept for backwards compatibility |
 | `--skip-build` | Serve pre-built files without rebuilding |
 | `--no-watch` | Disable file watching / hot reload |
 | `--no-browser` | Don't auto-open Explorer |
 | `--ci` | CI mode: disable browser and debug panel |
 | `--debug` | Enable scene debug panel (on by default with `--explorer-alpha`) |
 | `--explorer-alpha` | Use the new Alpha Explorer deeplink (default) |
-| `--web-explorer` | Use legacy web-based Explorer |
+| `--web, --bevy-web` | Open the preview in Bevy Web (`https://decentraland.org/bevy-web/`) instead of the desktop Explorer. Chrome 142+ requires the Local Network Access permission ("Apps on device" in 145+) for the page to reach the localhost preview server; the CLI prints instructions |
 | `--mobile` | Print ASCII QR code for mobile preview |
 | `--position <x,y>` | Initial spawn position (default: from `scene.json`) |
 | `--skip-auth-screen` | Skip Explorer's authentication screen |

AGENTS.md

@@ -0,0 +1,61 @@
+import { FlatCompat } from '@eslint/eslintrc'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+// @dcl/eslint-config still publishes an eslintrc-style config; wrap it for eslint 9.
+const compat = new FlatCompat({ baseDirectory: path.dirname(fileURLToPath(import.meta.url)) })
+
+export default [
+  ...compat.config({
+    extends: '@dcl/eslint-config/sdk',
+    parserOptions: {
+      project: [
+        'packages/@dcl/ecs/tsconfig.json',
+        'packages/@dcl/sdk-commands/tsconfig.json',
+        'packages/@dcl/sdk/tsconfig.json',
+        'packages/@dcl/playground-assets/tsconfig.json',
+        'packages/@dcl/react-ecs/tsconfig.json',
+        'scripts/tsconfig.json',
+        'test/tsconfig.json',
+        'test/ecs/snippets/tsconfig.json'
+      ]
+    }
+  }),
+  {
+    rules: {
+      'no-param-reassign': 'warn',
+      'no-console': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          ignoreRestSiblings: true,
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_|ReactEcs',
+          caughtErrorsIgnorePattern: '^_'
+        }
+      ]
+    }
+  },
+  {
+    files: ['packages/@dcl/ecs/**/*.ts', 'packages/@dcl/sdk/**/*.ts', 'scripts/**/*.ts', 'test/**/*.ts'],
+    rules: { 'no-console': 'off' }
+  },
+  {
+    ignores: [
+      '**/*.gen.ts',
+      '**/dist/**',
+      '**/node_modules/**',
+      '**/*.d.ts',
+      '**/*.js',
+      'packages/@dcl/ecs/dist/**',
+      'packages/@dcl/ecs/src/components/generated',
+      'packages/@dcl/js-runtime',
+      'packages/@dcl/playground-assets/dist',
+      'packages/@dcl/sdk/dist/**',
+      'packages/@dcl/sdk/internal/**',
+      'packages/@dcl/sdk/testing/**',
+      'test/sdk/simple-scene',
+      'tmp'
+    ]
+  }
+]

docs/ai-agent-context.md

@@ -3,9 +3,14 @@ module.exports = {
   moduleFileExtensions: ['ts', 'js', 'tsx', 'jsx'],
   transform: {
     '^.+\\.(js|jsx|ts|tsx)$': [
-      'ts-jest',
+      'babel-jest',
       {
-        tsconfig: 'test/tsconfig.json'
+        presets: [['@babel/preset-typescript', { isTSX: true, allExtensions: true, onlyRemoveTypeImports: true }]],
+        plugins: [
+          '@babel/plugin-transform-modules-commonjs',
+          '@babel/plugin-transform-dynamic-import',
+          ['@babel/plugin-transform-react-jsx', { pragma: 'ReactEcs.createElement' }]
+        ]
       }
     ]
   },