Add support for Trilist, CrComLib, WebXpanel, and Zoom integration

[andrew-welker]

This pull request introduces significant improvements to the integration and reliability of the Mobile Control React app core library, focusing on error handling, WebXPanel/Zoom Room Controller (ZRC) support, and developer documentation. The most important changes are summarized below.

WebXPanel and Zoom Room Controller (ZRC) Support:

• Added a comprehensive webXPanel service (src/lib/services/webXPanel/webXPanel.ts) that automatically initializes a WebXPanel/CIP connection when the app is loaded as a Zoom Room Controller (?zoomRoom=true in the URL). The service reads configuration from URL query parameters, handles Zoom websocket token handshakes, and mirrors connection status/errors into Redux for diagnostics.
• Exported the new webXPanel service from the main services index for easy access throughout the app. [1] [2]

Error Handling and Initialization:

• Improved the useInitialize function to provide user-friendly error messages for failed HTTP requests (such as SSL certificate issues or unreachable servers), and to surface these errors in the UI via Redux. [1] [2]

Documentation and Developer Experience:

• Extended the README.md with a new section detailing how to integrate the library into an existing React app, including installation steps, configuration, router setup, context providers, and use of interface hooks. Also documented automatic WebXPanel/ZRC support.

Dependency Updates:

• Updated and added several dependencies and devDependencies in package.json for improved compatibility and security, including new versions of lodash, typescript, vite, and others; added @crestron/ch5-webxpanel and @pepperdash/ch5-crcomlib-lite as regular dependencies. [1] [2]

These changes together make the library more robust, easier to integrate, and better suited to environments requiring WebXPanel/Zoom Room Controller support.

[Copilot]

Pull request overview

This PR extends the core library with Zoom Room Controller (ZRC) / WebXPanel support and Trilist (CrComLib join) integration, while improving connection diagnostics and startup error reporting surfaced through Redux/UI.

Changes:

• Added a webXPanel service + Redux slice/selectors/hooks to initialize and monitor WebXPanel/ZRC connection status and errors.
• Enhanced startup/connect flow with ConnectionStage and more descriptive HTTP/network error messages.
• Added an auto-applied Trilist Redux plugin to subscribe to control system joins (online/IP/mcAppUrl/reload), plus updated docs and dependencies.

Reviewed changes

Copilot reviewed 24 out of 27 changed files in this pull request and generated 10 comments.

Show a summary per file

File	Description
tsconfig.json	Removes typeRoots config and keeps baseUrl setting.
src/lib/types/classes/app-config.ts	Formatting updates and type literal normalization for config-related types.
src/lib/store/webXPanel/webXPanel.slice.ts	New WebXPanel Redux slice for connection state and last error.
src/lib/store/webXPanel/webXPanel.selectors.ts	New selectors for WebXPanel slice state.
src/lib/store/webXPanel/webXPanel.hooks.ts	New hooks wrapping WebXPanel selectors.
src/lib/store/ui/ui.slice.ts	Adds ConnectionStage and stores current stage in UI slice.
src/lib/store/ui/ui.selectors.ts	Adds selector for connectionStage.
src/lib/store/ui/ui.hooks.ts	Adds hook for connectionStage.
src/lib/store/touchPanel/touchPanel.slice.ts	New touch panel slice for online state and join-derived URL/IP values.
src/lib/store/touchPanel/touchPanel.selectors.ts	New selectors for touch panel slice state.
src/lib/store/store.ts	Wires new reducers and auto-applies Redux plugins on store creation.
src/lib/store/plugins/trilist.ts	New Trilist plugin subscribing to CrComLib joins and reload pulse logic.
src/lib/store/plugins/index.ts	Adds applyReduxPlugins() wrapper to attach plugins to a store.
src/lib/store/middleware/websocketMiddleware.ts	Adds Zoom Room token sourcing from join 1 + improved staged error reporting and reconnection behavior.
src/lib/store/index.ts	Re-exports new selectors/hooks/actions/types and plugin entrypoint.
src/lib/store/appConfig/appConfig.slice.ts	Formatting/cleanup and minor typing alignment.
src/lib/shared/MobileControlProvider/MobileControlProvider.tsx	Initializes WebXPanel at module-load and normalizes imports/formatting.
src/lib/shared/disconnectedMessage/DisconnectedMessage.tsx	Shows connection stage + elapsed time and WebXPanel diagnostics on the connecting/disconnected screen.
src/lib/services/webXPanel/zoom.ts	New Zoom postMessage handshake to retrieve the WebXPanel websocket token.
src/lib/services/webXPanel/webXPanel.ts	New WebXPanel initializer reading query params, doing Zoom handshake, and mirroring status into Redux.
src/lib/services/webXPanel/index.ts	Barrel export for the WebXPanel service.
src/lib/services/useInitialize.ts	Improves request error messages and starts surfacing them into Redux UI state.
src/lib/services/index.ts	Exports the new WebXPanel service.
src/lib/global.d.ts	Adds window.CrComLib / window.WebXPanel typing.
README.md	Adds “Using this Library in an Existing Application” integration guidance incl. ZRC/WebXPanel note.
package.json	Adds WebXPanel/CrComLib deps and updates build tool versions.

Comments suppressed due to low confidence (2)

src/lib/store/webXPanel/webXPanel.slice.ts:55

• Avoid console.log side effects inside Redux reducers; reducers should be pure and this will execute on every dispatch. Prefer logging where the events originate (e.g., the WebXPanel service) or behind a debug flag.

    setWebXPanelBuildDate: (
      state: IWebXPanel,
      action: PayloadAction<string>
    ) => {
      state.buildDate = action.payload;

src/lib/store/webXPanel/webXPanel.slice.ts:69

• Avoid console.log side effects inside Redux reducers; reducers should be pure and this will execute on every dispatch. Prefer logging where the events originate (e.g., the WebXPanel service) or behind a debug flag.

    setWebXPanelWsConnected: (
      state: IWebXPanel,
      action: PayloadAction<boolean>
    ) => {
      state.wsConnected = action.payload;

[github-actions]

🎉 This PR is included in version 1.25.0-add-zoom.1 🎉

The release is available on:

• npm package (@add-zoom dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 1.25.0-add-zoom.2 🎉

The release is available on:

• npm package (@add-zoom dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 1.25.0-add-zoom.3 🎉

The release is available on:

• npm package (@add-zoom dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[github-actions]

🎉 This PR is included in version 1.25.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀