Interface LaravelUi5\Sdk\Platform\Manifest\Contracts\Ui5ShellContributorInterface

Contributes a single, owned configuration node to the global LaravelUi5 Shell manifest.

This interface is implemented by Shell services that extend the platform-level Shell with additional runtime capabilities such as context resolution, search, help, command palettes, or telemetry.

Unlike Core-level Shell builders, contributors do not define or restructure the Shell itself. Instead, each contributor is the sole owner of exactly one root node within the Shell manifest and is responsible for fully materializing that node at runtime.

Implementations must adhere to the following rules:

• Exactly one top-level key must be returned.
• The returned key represents the contributor's owned Shell node.
• Existing Shell keys must not be overridden or modified.
• The returned structure must be JSON-serializable.

Shell contributors typically resolve dynamic runtime information such as routes, limits, permissions, or feature flags and expose them in a form consumable by the frontend Shell implementation.

The resulting fragment is collected and validated by the Shell resolver and merged into the final Shell manifest without any implicit merging or override semantics.