Skip to content

docs(*): add missing component API links#253

Merged
desmondinho merged 2 commits intoLumexUI:mainfrom
Denny09310:fix/missing-docs-links
Sep 17, 2025
Merged

docs(*): add missing component API links#253
desmondinho merged 2 commits intoLumexUI:mainfrom
Denny09310:fix/missing-docs-links

Conversation

@Denny09310
Copy link
Contributor

@Denny09310 Denny09310 commented Sep 17, 2025

Description

Adds missing documentation API links

What's been done?

  • Added missing documentation API links

Checklist

  • My code follows the project's coding style and guidelines.
  • I have included inline docs for my changes, where applicable.
  • I have added, updated or removed tests according to my changes.
  • All tests are passing.
  • There's an open issue for the PR that I am making.

Additional Notes

No additional notes.

Summary by CodeRabbit

  • Documentation
    • Expanded Components API navigation in the docs to include: LumexAlert, LumexBadge, LumexCode, LumexDataGrid, LumexDropdownTrigger, LumexKbd, LumexRadio, LumexRadioGroup, and LumexTooltip.
    • Added LumexTooltip to the Components list as a new entry.
    • New entries are placed alongside related components for easier discovery; no runtime behavior or public APIs were changed.

@coderabbitai
Copy link

coderabbitai bot commented Sep 17, 2025

Walkthrough

Expanded the docs navigation to add new component entries: LumexAlert, LumexBadge, LumexCode, LumexDataGrid<T>, LumexDropdownTrigger, LumexKbd, LumexRadio<T>, LumexRadioGroup<T>, and LumexTooltip. No logic or control-flow changes.

Changes

Cohort / File(s) Summary
Docs navigation store updates
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs
Added LumexAlert, LumexBadge, LumexCode, LumexDataGrid<T>, LumexDropdownTrigger, LumexKbd, LumexRadio<T>, LumexRadioGroup<T>, and LumexTooltip to the Components API / Components navigation lists at specified positions; no other changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I hop the docs with eager feet,
New items placed in tidy neat.
Alerts, Badges, Codes, and Tooltips bright,
Radios and Grids join the light.
A carrot-coded joy—docs feel right! 🥕🐇

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. You can run @coderabbitai generate docstrings to improve docstring coverage.
✅ Passed checks (2 passed)
Check name Status Explanation
Title Check ✅ Passed The title "fix: added missing API docs links" is concise, follows conventional-commit style, and accurately summarizes the primary change (adding missing API documentation links in the docs/navigation), so it conveys the main intent to reviewers scanning the history.
Description Check ✅ Passed The PR description largely follows the repository template— it includes a Description, "What's been done?" bullets, a Checklist, and Additional Notes and clearly states the change (adding missing documentation API links)—but it omits the template's "Closes #{issue_number}" line and leaves the "There's an open issue for the PR" checklist item unchecked.
✨ Finishing touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.


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

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link

codecov bot commented Sep 17, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.16%. Comparing base (19b89dc) to head (cf32396).
⚠️ Report is 133 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main     #253      +/-   ##
==========================================
- Coverage   96.95%   93.16%   -3.79%     
==========================================
  Files          70      149      +79     
  Lines        1542     2617    +1075     
  Branches      150      392     +242     
==========================================
+ Hits         1495     2438     +943     
- Misses         28       94      +66     
- Partials       19       85      +66     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (1)

73-73: Prefer unbound generics in nameof for resilience.

Using nameof(Type<>) avoids relying on an in-scope T and matches the canonical pattern.

Apply:

-            .Add( new( nameof( LumexDataGrid<T> ) ) )
+            .Add( new( nameof( LumexDataGrid<> ) ) )
@@
-            .Add( new( nameof( LumexRadio<T> ) ) )
-            .Add( new( nameof( LumexRadioGroup<T> ) ) )
+            .Add( new( nameof( LumexRadio<> ) ) )
+            .Add( new( nameof( LumexRadioGroup<> ) ) )

Optionally, align earlier entries (e.g., LumexListbox<T>, LumexNumbox<T>, LumexSelect<T>) to the same style in a follow-up.

Also applies to: 98-98, 99-99

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d9dbf24 and 81a5056.

📒 Files selected for processing (1)
  • docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (3 hunks)
🧰 Additional context used
🧬 Code graph analysis (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (4)
src/LumexUI/Components/Code/LumexCode.razor.cs (2)
  • LumexCode (17-84)
  • LumexCode (53-56)
src/LumexUI/Components/DataGrid/LumexDataGrid.razor.cs (1)
  • LumexDataGrid (220-244)
src/LumexUI/Components/Dropdown/LumexDropdown.razor.cs (2)
  • LumexDropdown (15-44)
  • LumexDropdown (24-29)
src/LumexUI/Components/Kbd/LumexKbd.razor.cs (2)
  • LumexKbd (17-67)
  • LumexKbd (39-42)
🔇 Additional comments (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (1)

57-57: LGTM: Added missing Components API entries.

The new links for Alert, Badge, Code, DataGrid, DropdownTrigger, Kbd, Radio, and RadioGroup are consistent with existing component names and placement. No behavior risks.

Also applies to: 61-61, 70-70, 73-73, 80-80, 83-83, 98-98, 99-99

new NavigationCategory( "Components API" )
.Add( new( nameof( LumexAccordion ) ) )
.Add( new( nameof( LumexAccordionItem ) ) )
.Add( new( nameof( LumexAlert ) ) )
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

🧩 Analysis chain

Quick sanity check: components exist and nav isn’t duplicating entries.

Please verify the component types exist and each appears once in the nav.

Also applies to: 61-61, 70-70, 73-73, 80-80, 83-83, 98-98, 99-99


🏁 Script executed:

#!/bin/bash
set -euo pipefail

echo "Check component type definitions exist:"
rg -nP --type=cs -C0 $'\\b(partial\\s+)?class\\s+Lumex(Alert|Badge|Code|Kbd)\\b|\\bclass\\s+Lumex(DataGrid|Radio|RadioGroup)\\s*<' src || true
rg -nP --type=cs -C0 $'\\bclass\\s+LumexDropdownTrigger\\b' src || true

echo
echo "Ensure single nav entry per component:"
targets=(
  'LumexAlert' 'LumexBadge' 'LumexCode' 'LumexDataGrid' 'LumexDropdownTrigger'
  'LumexKbd' 'LumexRadio' 'LumexRadioGroup'
)
for t in "${targets[@]}"; do
  echo -n "$t: "
  rg -n "nameof\\(\\s*${t}(<[^>]*>)?\\s*\\)" docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs | wc -l
done

Length of output: 1251


Duplicate navigation entries in NavigationStore.cs — remove duplicates

Components exist, but docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs contains duplicate nav entries: LumexAlert (2), LumexBadge (2), LumexCode (2), LumexDataGrid (2), LumexKbd (2), LumexRadioGroup (2); LumexDropdownTrigger and LumexRadio appear once. Remove the duplicated Add(new(nameof(...))) calls or dedupe when building the nav (inspect lines ~57, 61, 70, 73, 80, 83, 98, 99).

🤖 Prompt for AI Agents
In docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs around lines
57, 61, 70, 73, 80, 83, 98–99, the navigation list contains duplicated
Add(new(nameof(...))) entries (LumexAlert, LumexBadge, LumexCode, LumexDataGrid,
LumexKbd, LumexRadioGroup); remove the duplicate Add(...) calls so each
component is added only once or implement a simple dedupe step when building the
nav (e.g., use a HashSet of names before adding or filter the list for distinct
names) to ensure LumexDropdownTrigger and LumexRadio remain single entries and
no duplicates persist.

Copy link
Contributor

@desmondinho desmondinho left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Tooltip is missing

@desmondinho desmondinho changed the title fix: added missing API docs links docs(*): add missing component API links Sep 17, 2025
@desmondinho desmondinho merged commit 3e9a23d into LumexUI:main Sep 17, 2025
3 of 4 checks passed
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (1)

53-110: Optional guardrail: make nav additions idempotent

To prevent future duplicate entries creeping back in, make NavigationCategory.Add skip if Name already present (HashSet or DistinctBy on Name when finalizing the list).

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 81a5056 and cf32396.

📒 Files selected for processing (1)
  • docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (4 hunks)
🧰 Additional context used
🧬 Code graph analysis (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (4)
src/LumexUI/Components/Code/LumexCode.razor.cs (2)
  • LumexCode (17-84)
  • LumexCode (53-56)
src/LumexUI/Components/DataGrid/LumexDataGrid.razor.cs (1)
  • LumexDataGrid (220-244)
src/LumexUI/Components/Dropdown/LumexDropdown.razor.cs (2)
  • LumexDropdown (15-44)
  • LumexDropdown (24-29)
src/LumexUI/Components/Kbd/LumexKbd.razor.cs (2)
  • LumexKbd (17-67)
  • LumexKbd (39-42)
🔇 Additional comments (1)
docs/LumexUI.Docs.Client/Common/Navigation/NavigationStore.cs (1)

57-57: Approve: Added missing Components API links — verification passed

No duplicate nameof(...) entries found; matching component classes exist under src/LumexUI/Components.

@coderabbitai coderabbitai bot mentioned this pull request Sep 17, 2025
5 tasks
@desmondinho
Copy link
Contributor

Thank you very much for your contribution! <3

P.S. Sorry, I just realized I forgot to thank you..

@coderabbitai coderabbitai bot mentioned this pull request Feb 23, 2026
5 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants