Relocate deprecated API shims so the ESM engine tree-shakes

[willeastcott]

Description

Any import from the ESM package currently retains most of the engine: deprecated.js is the one module listed in sideEffects, and its module-scope prototype patches statically import AppBase, StandardMaterial, ForwardRenderer, RigidBodyComponentSystem and more — so bundlers must keep that entire graph even for import { Vec3 } from 'playcanvas'.

This PR moves every prototype-patch shim onto the class it patches, as a regular member with @ignore/@deprecated JSDoc (the existing Entity#getGuid idiom). Each shim now ships only when its class does and behaves identically at runtime. deprecated.js keeps only side-effect-free aliases and helper functions, and package.json now declares "sideEffects": false.

Measured with esbuild (minified), same tree before/after:

Bundle	Before	After
import { Vec3 } only	882 KB raw / 229 KB gzip (559 modules)	3.2 KB / 1.1 KB (3 modules)
Minimal engine-only cube app	1129 KB / 297 KB gzip	1056 KB / 279 KB gzip
Full namespace (everything used)	2391 KB	2391 KB — unchanged

@playcanvas/react and web-components inherit the win automatically. UMD builds are unaffected (all exports retained, shims applied identically).

Notes for reviewers:

• Shims with runtime-computed names can't be class members and remain module-scope helper loops (StandardMaterial vertex-color/tint aliases, StandardMaterialOptions litOptions forwarding). These are invisible to tsc, so they don't affect the d.ts.
• ForwardRenderer#renderComposition is patched from app-base.js because it needs getApplication and scene code must not import from framework.
• The anisotropy entry is removed from the rollup-types-fixup synthesis list — the real accessor now provides the typing. This also fixes its d.ts doc text, which was previously mis-sliced from anisotropyIntensity's @property doc.
• Three StandardMaterial setters assign their target properties via Object.assign because tsc declaration emit synthesizes duplicate member declarations from literal this.x = ... assignments to fixup-managed dynamic props.
• Deprecated members now appear in the d.ts typed and @deprecated-tagged (previously invisible to TypeScript users); @ignore keeps them out of the API docs, as with Entity#getGuid.
• New canary test in test/bundles/treeshake.test.mjs bundles import { Vec3 } against the built ESM tree and fails above 10 KB, so a future module-scope side effect can't silently regress tree-shaking.

Verified: full unit suite (2337 passing, failures identical to main baseline), all 61 bundle tests (exports parity across all 11 targets, smoke, canary), build:types + test:types, lint, publint, plus a runtime check that all 27 shim behaviors and deprecated exports are unchanged.

Checklist

• I have read the contributing guidelines
• My code follows the project's coding standards
• This PR focuses on a single change

🤖 Generated with Claude Code

[github-actions]

Build size report

This PR changes the size of the minified bundles.

Bundle	Minified	Gzip	Brotli
playcanvas.min.js	2390.9 KB (−0.8 KB, −0.03%)	614.8 KB (−0.2 KB, −0.04%)	477.0 KB (−0.1 KB, −0.02%)
playcanvas.min.mjs	2388.2 KB (−0.8 KB, −0.03%)	613.5 KB (−0.3 KB, −0.05%)	476.5 KB (−0.1 KB, −0.02%)

[Copilot]

Pull request overview

Relocates deprecated API shims to their owning modules, enabling effective ESM tree-shaking while preserving compatibility.

Changes:

• Moves deprecated prototype shims into class modules.
• Marks the package side-effect-free and simplifies deprecated.js.
• Adds a bundle-size regression canary and updates type synthesis.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
package.json	Declares all modules side-effect-free.
src/deprecated/deprecated.js	Removes prototype patches and heavy imports.
src/framework/app-base.js	Hosts legacy app and renderer methods.
src/framework/asset/asset-registry.js	Adds the deprecated asset lookup method.
src/framework/components/model/component.js	Adds the deprecated visibility method.
src/framework/components/rigid-body/component.js	Adds legacy rigid-body members.
src/framework/components/rigid-body/system.js	Adds the deprecated gravity method.
src/framework/input/element-input.js	Adds the legacy wheel accessor.
src/framework/xr/xr-input-source.js	Adds deprecated XR accessors.
src/platform/input/mouse-event.js	Adds the legacy wheel accessor.
src/scene/materials/material.js	Adds deprecated material accessors.
src/scene/materials/standard-material-options.js	Relocates legacy option forwarding.
src/scene/materials/standard-material.js	Relocates material aliases and accessors.
test/bundles/treeshake.test.mjs	Adds the bundle-size canary.
utils/plugins/rollup-types-fixup.mjs	Removes redundant anisotropy synthesis.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.