feat(web): group debug settings, add reset-to-defaults and URL param help

[yanziz-nvidia]

The web client's Debug Settings were a flat list of ~16 controls with no categorization, and accepted URL query params were undocumented (visible only in source). This reworks the panel for first-time setup:

• Keep Device Profile as the always-visible basic step; fold the rest under an "Advanced settings" divider into 6 collapsed
  Details

  groups (Video & Streaming, Tracking & Pose, In-XR Controls & Display, Network, Device Workarounds, Developer & Session). All element IDs unchanged.
• Add a "Reset to defaults" button: clears global + per-project localStorage and the countdown, strips form-backed URL params (keeps direct transport/OOB params + teleop hash), then replaceState + reload. localStorage keys are centralized in localStorageBindings() so setup and reset can't drift.
• Add an opt-in description to UrlParam and render a collapsed "URL parameters" help list from URL_PARAMS, so it can never drift from the registry; secrets/transport internals stay out by omitting a description.

Description

Fixes #(issue)

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 change)
• Documentation update

Testing

Checklist

• I have read and understood the contribution guidelines
• I have run the linter and formatter with SKIP=check-copyright-year pre-commit run --all-files
• I have made corresponding changes to the documentation
• I have added tests that prove my fix/feature works (or explained why not)
• I have signed off all my commits (git commit -s) per the DCO

Summary by CodeRabbit

• New Features

  • Added a Reset to defaults button for quickly restoring settings.
  • Added collapsible Setup & Advanced sections and an optional URL parameters help panel.
  • Numeric offset fields now include a ± toggle for reversing values.

• Improvements

  • The app now better detects headset type on first load and applies the right default profile automatically.
  • URL-based settings and saved preferences are now restored more reliably, with advanced section state preserved.

• Bug Fixes

  • Improved browser/device compatibility checks to avoid incorrect warnings on some headset browsers.

[coderabbitai]

Important

Review skipped

Auto incremental reviews are disabled on this repository.

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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 7676ef2a-ee63-4caa-8d0d-763c9e67d35b

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

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main changes: grouped debug settings, a reset-to-defaults action, and URL parameter help.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch yanziz/web-debug-settings-grouping

---

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

[yanziz-nvidia]

/preview-docs

[yanziz-nvidia]

/preview-docs

[github-actions]

❌ No successful Build & deploy docs run found for commit cd722ce9. Wait for the build to finish (or push a commit that touches docs/ to trigger one), then re-comment /preview-docs.

[yanziz-nvidia]

/preview-docs

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@deps/cloudxr/webxr_client/src/CloudXR2DUI.tsx`:
- Around line 221-228: After applying the UA default in CloudXR2DUI
initialization, make sure profile-linked URL seed values are reconciled so the
selected device profile stays in sync with the visible form. Update the startup
flow around applyDefaultDeviceProfileFromUserAgent() and applyUrlSeeds() to
re-run the profile reconciliation logic used by setProfileToCustomIfNeeded(), so
any seeded overrides switch the profile to custom instead of leaving
deviceProfileId pointing at the auto-detected profile.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: e0063144-19a7-49e0-9251-c38de0cc982c

📥 Commits

Reviewing files that changed from the base of the PR and between a9fcf9e and e0e92be.

📒 Files selected for processing (5)

• deps/cloudxr/webxr_client/helpers/BrowserCapabilities.ts
• deps/cloudxr/webxr_client/helpers/DeviceProfiles.ts
• deps/cloudxr/webxr_client/package.json
• deps/cloudxr/webxr_client/src/CloudXR2DUI.tsx
• deps/cloudxr/webxr_client/src/index.html

🚧 Files skipped from review as they are similar to previous changes (1)

• deps/cloudxr/webxr_client/src/index.html

[yanziz-nvidia]

Reviewed by yanziz-reviewer-bot

Summary

Refactors the web client debug settings panel into collapsible accordion groups, adds a "Reset to defaults" button backed by a centralized localStorageBindings() map, introduces UA-based device profile auto-detection, and generates the URL parameter help list from the URL_PARAMS registry.

Legend: 🚫 Blocker · 💡 Suggestion · 🔍 Nit

	Finding
🚫	deps/cloudxr/webxr_client/src/CloudXR2DUI.tsx:349 — applyDefaultDeviceProfileFromUserAgent() silently overwrites user-edited per-field values. Guard fires on deviceProfile == null, but a user who edits individual fields (codec, perEyeWidth, etc.) without touching the Device Profile dropdown never stores that key — so on next load, UA detection fires and overwrites their stored values. Fix: after calling applyDeviceProfileToForm(detected), persist deviceProfile to localStorage so subsequent loads take the early-return path.
💡	deps/cloudxr/webxr_client/src/App.tsx:139 — COUNTDOWN_STORAGE_KEY is module-private; resetToDefaults() duplicates the string literal with a "keep in sync" comment. Lift to module scope, export it, and import in CloudXR2DUI.tsx.
💡	deps/cloudxr/webxr_client/src/CloudXR2DUI.tsx:570 — Per-project reset keys are hardcoded; a future savePerProject caller would silently survive a reset. Mirror the localStorageBindings() pattern: define a perProjectStorageBindings() constant shared by savePerProject callers and resetToDefaults().
🔍	deps/cloudxr/webxr_client/src/CloudXR2DUI.tsx:801 — Sign-flip handler writes '0' to a blanked field and persists it. Guard: if (!Number.isFinite(value)) return;.

Actionables (for bots — copy-paste-ready for AI)

Fix if it makes sense in context — these are agent-generated suggestions, not human-vetted obligations. Skip anything that's wrong, already addressed, or not worth the churn.

• CloudXR2DUI.tsx:349 — After applyDeviceProfileToForm(detected), persist deviceProfile to localStorage so the == null guard fires only on a true first visit.
• App.tsx:139 — Export COUNTDOWN_STORAGE_KEY at module scope; import it in CloudXR2DUI.tsx:573 instead of the duplicate string literal.
• CloudXR2DUI.tsx:570 — Replace hardcoded ['panelHiddenAtStart', 'headless'] with a shared perProjectStorageBindings() constant, mirroring localStorageBindings().
• CloudXR2DUI.tsx:801 — In sign-flip handler: if (!Number.isFinite(value)) return; before negating.

[yanziz-nvidia]

fixed comments from bot.

Persisting deviceProfile alone would actually introduce a bug: on the next load, setupLocalStorage would restore the dropdown to "Quest 3", but the profile-driven fields (resolution, codec, bitrate…) aren't persisted by the auto-detect path, so they'd revert to HTML defaults — dropdown and fields out of sync.