chore(assets-controllers): add isDeprecated to TokenDetectionController

[Prithpal-Sooriya]

Explanation

As part of the assets-unify-state rollout, AssetsController supersedes legacy per-chain controllers. TokenDetectionController needs the same opt-out mechanism already added to TokenListController, TokensController, TokenBalancesController, and related controllers.

This PR adds an optional isDeprecated constructor callback to TokenDetectionController. When it returns true, the controller stops polling, blocks network activity, and becomes a no-op at every entry point (start, detectTokens, _executePoll, addDetectedTokensViaWs, and addDetectedTokensViaPolling). The callback is re-evaluated on each entry point so hosts can toggle deprecation at runtime without reconstructing the controller.

References

• ASSETS-3337
• Extension consumer PR: fix: delete token list metamask-extension#43108
• Related core pattern: feat: disable token list #8945

Manual testing steps

N/A — behavior-preserving when isDeprecated is omitted (defaults to false).

Screenshots/Recordings

N/A

Changed files

File	Change	Verification
packages/assets-controllers/src/TokenDetectionController.ts	Added isDeprecated option and #enforceDisabledState() guards on all detection entry points	yarn eslint on changed files
packages/assets-controllers/src/TokenDetectionController.test.ts	Added isDeprecated test suite (9 cases)	yarn workspace @metamask/assets-controllers run jest --no-coverage packages/assets-controllers/src/TokenDetectionController.test.ts -t "isDeprecated"
packages/assets-controllers/CHANGELOG.md	Documented new isDeprecated option under Unreleased	Pending PR number for link

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them