feat(calm-hub-ui): Deeplinks within CalmHub

[aamanrebello]

Description

Examples:

Even when you refresh the page, the same thing should come back based on the deeplink.

Type of Change

• 🐛 Bug fix (non-breaking change which fixes an issue)
• ✨ New feature (non-breaking change which adds functionality)
• 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
• 📚 Documentation update
• 🎨 Code style/formatting changes
• ♻️ Refactoring (no functional changes)
• ⚡ Performance improvements
• ✅ Test additions or updates
• 🔧 Chore (maintenance, dependencies, CI, etc.)

Affected Components

• CLI (cli/)
• Shared (shared/)
• CALM Widgets (calm-widgets/)
• CALM Hub (calm-hub/)
• CALM Hub UI (calm-hub-ui/)
• Documentation (docs/)
• VS Code Extension (calm-plugins/vscode/)
• Dependencies
• CI/CD

Commit Message Format ✅

Testing

• I have tested my changes locally
• I have added/updated unit tests
• All existing tests pass

Checklist

• My commits follow the conventional commit format
• I have updated documentation if necessary
• I have added tests for my changes (if applicable)
• My changes follow the project's coding standards

[Copilot]

Pull request overview

This PR adds deeplink functionality to CalmHub UI, enabling users to navigate directly to specific resources via URL parameters and maintain their navigation state across page refreshes.

Key Changes:

• Added URL parameter-based routing for namespace, resource type, resource ID, and version
• Refactored TreeNavigation component to initialize state from URL parameters and update the URL on user interactions
• Added comprehensive test coverage for deeplink scenarios

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 8 comments.

File	Description
calm-hub-ui/src/visualizer/contracts/contracts.ts	Defines HubParams type for URL parameter structure
calm-hub-ui/src/App.tsx	Adds parameterized route /artifacts/:namespace?/:type?/:id?/:version? for deeplink support
calm-hub-ui/src/hub/components/tree-navigation/TreeNavigation.tsx	Implements deeplink handling by initializing state from URL params, extracting helper functions for loading resources, and calling navigate() on user interactions
calm-hub-ui/src/hub/components/tree-navigation/TreeNavigation.test.tsx	Adds test cases for deeplink scenarios and wraps tests with MemoryRouter for routing support

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[YoofiTT96]

Currently only concerned with the use of any for the typing. Besides that looks good

[aamanrebello]

Currently only concerned with the use of any for the typing. Besides that looks good

Yes I think I have avoided any now. Please let me know if it's still in there and I will update.

[rocketstack-matt]

@willosborne are we happy this PR would resolve #1243 ?

[aamanrebello]

Action points based on discussion with Aidan:

• Clicking on a non-resource i.e. a sub-title in the side menu should not update the URL (no navigation) - we only want links to resources like pattern/architecture JSONs.
• All parts of the URL path should be mandatory as a result of the above
• No need to have "artifacts" in the path
• No need to capitalize things like "Architectures" in the URL.

[aamanrebello]

Action points based on discussion with Aidan:

• Clicking on a non-resource i.e. a sub-title in the side menu should not update the URL (no navigation) - we only want links to resources like pattern/architecture JSONs.
• All parts of the URL path should be mandatory as a result of the above
• No need to have "artifacts" in the path
• No need to capitalize things like "Architectures" in the URL.

As of 09/03/26, all these points have been resolved.

requested changes have been addressed