feat(extensions): nativescript.commands map — per-command lazy loading for extensions

[edusperoni]

Stacked on #6101 (feat/define-command), which stacks on #6099.

PR Checklist

• The PR title follows our guidelines: https://github.com/NativeScript/NativeScript/blob/master/tools/notes/CONTRIBUTING.md#commit-messages.
• There is an issue for the bug/feature this PR is for. To avoid wasting your time, it's best to open a suggestion issue first and wait for approval before working on it.
• You have signed the CLA.
• All existing tests are passing: https://github.com/NativeScript/nativescript-cli/blob/master/CONTRIBUTING.md#contribute-to-the-code-base
• Tests for the changes are included.

What is the current behavior?

Every installed extension is eagerly require()d on every CLI invocation, before the command is even known — the extension's whole module tree loads so its top-level side effects can register commands against global.$injector. nativescript.commands in an extension's package.json is a string[] used only to suggest installs for unknown commands. Two extensions claiming the same command name crash at startup.

What is the new behavior?

nativescript.commands also accepts a map of command name → module path, which becomes authoritative:

"nativescript": {
	"commands": {
		"widget|add": "./dist/commands/widget-add.js"
	}
}

• Per-command lazy loading: the CLI registers each entry as a deferred require; nothing from the extension loads until one of its commands actually executes. The extension main is never required, and map-manifest extensions are no longer flagged by the deprecation tracer (the legacy array/eager path keeps working verbatim, tracer included).
• A command module may self-register on load (legacy shape) or simply export a defineCommand definition — the deferred loader adapts and registers the export under the manifest key, including the subtle hierarchical case where dispatch resolves the parent dispatcher before any child module has loaded.
• Conflicts warn instead of crash, naming both the losing and the owning extension; malformed manifest entries warn and are skipped; a broken extension still never aborts startup (settlePromises isolation preserved).
• Install suggestions for unknown commands now understand both manifest shapes, keeping the |* default-command short-form behavior.
• IExtensionData gains commands?: string[].
• New authoring guide: extensions.md; dependency-injection.md now cross-links all three API guides.

12 new tests (lazy registration, eager-path preservation, malformed/conflict handling, both suggestion shapes, pure-definition modules incl. the parent-first case). Full stacked suite: 111 files, 1628 passed / 38 skipped; yok oracle, public-API test, and compat fixtures untouched.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: b1ab3f63-73ca-4d4c-bbf0-4f5b62a61fed

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}