fix(docs): resolve broken links for strict mkdocs build (#346)

* Initial plan

* Add Calendar component implementation with basic structure

Co-authored-by: csharpfritz <78577+csharpfritz@users.noreply.github.com>

* Add unit tests for Calendar component - all 19 tests passing

Co-authored-by: csharpfritz <78577+csharpfritz@users.noreply.github.com>

* Add Calendar sample page and documentation

Co-authored-by: csharpfritz <78577+csharpfritz@users.noreply.github.com>

* Add Calendar sample page and documentation

* Fix code review issues: safe substring and synchronous event handling

Co-authored-by: csharpfritz <78577+csharpfritz@users.noreply.github.com>

* fix: refactor Calendar to use CalendarSelectionMode enum (#333)

- Create CalendarSelectionMode enum (None, Day, DayWeek, DayWeekMonth)
- Refactor Calendar.SelectionMode from string to CalendarSelectionMode enum
- Remove .GetAwaiter().GetResult() blocking call in CreateDayRenderArgs
- Add Caption, CaptionAlign, UseAccessibleHeader properties
- Update tests and samples to use enum values

* samples: add demo pages for Calendar, FileUpload, ImageMap

- Calendar: date selection, selection modes, styling, day/title formats, events

- FileUpload: basic upload, file type filtering, multiple files, disabled, styled

- ImageMap: navigate/postback/mixed hot spot modes, rectangle/circle/polygon shapes

- Updated NavMenu and ComponentList with links to all three new components

* docs: add documentation for Calendar, FileUpload, ImageMap, PageService

* fix: restore .ai-team agent history and decisions lost in PR #338 merge

The FileUpload PR (#338) inadvertently reverted Sprint 1 gate review
entries from agent histories (beast, cyclops, forge, jubilee, rogue)
and downgraded the FileUpload InputFile decision in decisions.md.

Restored from commit f85aa42 (docs(ai-team): Sprint 1 gate review results).

* feat: add Copilot custom agent definitions in .github/agents/

Creates .agent.md files for all 6 team agents (Beast, Cyclops, Forge,
Jubilee, Rogue, Scribe) so they appear in GitHub Copilot's agent picker.
Content sourced from existing .ai-team/agents/*/charter.md files.

* fix: replace individual agent files with Squad coordinator agent

Squad is the single Copilot agent that delegates to the specialized
agents defined in .ai-team/agents/. Individual agent files were
incorrectly created  the correct pattern is one coordinator agent
(squad.agent.md) that routes work to Forge, Cyclops, Beast, Jubilee,
Rogue, and Scribe based on task type.

* docs(ai-team): log Sprint 2 completion

Session: 2026-02-10-sprint2-complete
Requested by: Jeffrey T. Fritz

Changes:
- Logged Sprint 2 session (4 components shipped with docs, samples, tests)
- Merged Sprint 2 design review decision from inbox
- Removed duplicate FileUpload InputFile decision from inbox (already consolidated)
- Appended Sprint 2 completion decision to decisions.md
- Propagated cross-agent updates to all 5 agent histories

* Updated the squad

* docs(ai-team): Sprint 3 planning session

Session: 2026-02-11-sprint3-planning
Requested by: Jeffrey T. Fritz

Changes:
- Logged session to .ai-team/log/2026-02-11-sprint3-planning.md
- Merged 3 decisions from inbox into decisions.md
- Updated status.md to reflect 48/53 components complete
- Sprint 3 scope: DetailsView + PasswordRecovery
- Propagated cross-agent updates to all agent history files

* docs(ai-team): Sprint 3 execution complete

Session: 2026-02-12-sprint3-execution
Requested by: Jeffrey T. Fritz

Changes:
- Logged Sprint 3 execution session
- Merged 7 decisions from inbox into decisions.md
- Sprint 3 gate review: DetailsView + PasswordRecovery APPROVED
- Propagated cross-agent updates to Beast, Colossus, Cyclops, Rogue, Jubilee
- status.md updated to 50/53 (94%)

* docs(ai-team): Milestone 4 planning - Chart component

Session: 2026-02-12-milestone4-planning
Requested by: Jeffrey T. Fritz

Changes:
- Logged session to .ai-team/log/2026-02-12-milestone4-planning.md
- Merged decisions from inbox (Chart.js evaluation, milestone plan, milestones directive)
- Propagated milestone 4 updates to 5 agent history files

* docs(ai-team): Summarize Forge history (13.2KB -> 4.3KB)

Session: 2026-02-12-milestone4-planning
Requested by: Scribe (automatic)

Changes:
- Summarized Forge history.md (exceeded ~12KB threshold)
- Preserved all team updates and key patterns

* feat: Milestone 6 — Feature Gap Closure (54 work items, ~345 gaps closed)

Closes the highest-impact feature gaps from the 53-control audit.

P0 — Base class fixes (~180 gaps): AccessKey, ToolTip on all controls;
DataBoundComponent inherits BaseStyledComponent; ValidatorDisplay + SetFocusOnError;
Image/Label base class upgrades.

P1 — Control improvements (~120 gaps): GridView paging/sorting/row editing;
Calendar style sub-components + enums; FormView header/footer/empty data;
HyperLink NavigateUrl rename; ValidationSummary HeaderText/ShowSummary/ValidationGroup.

P2 — Nice-to-have (~45 gaps): DataTextFormatString + AppendDataBoundItems on
BaseListControl; CausesValidation on CheckBox/RadioButton/TextBox; Menu Orientation;
Label AssociatedControlID; Login controls base class upgrade.

168 files changed, +5,712 / -1,775 lines
1,065 tests passing, 0 failures

* fix: Menu JS interop crash, Calendar attribute rendering, Menu auto-ID generation

- Add null safety and try/catch in Menu.js to prevent circuit crash
- Fix Calendar.razor attribute rendering issue
- Auto-generate Menu ID when not explicitly provided

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: update Cyclops history and decision inbox for M8 bug fixes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: formally defer Substitution/Xml, polish documentation

- Mark Substitution and Xml as Deferred in status.md
- Create DeferredControls.md with migration guidance
- Fix mkdocs.yml nav issues
- Update README component stats
- Remove Chart hedging language

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* feat: add shared PagerSettings sub-component for GridView/FormView/DetailsView

- Add PagerButtons and PagerPosition enums
- Add PagerSettings class with Web Forms-compatible properties
- Add IPagerSettingsContainer interface
- Add UiPagerSettings base component
- Wire PagerSettings into GridView, FormView, and DetailsView
- Follow existing style sub-component CascadingParameter pattern

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs(ai-team): M8 session log and decision merge

Session: 2026-02-24-m8-release-readiness
Requested by: Jeffrey T. Fritz

Changes:
- Logged M8 session to .ai-team/log/2026-02-24-m8-release-readiness.md
- Merged 18 decisions from inbox (Menu auto-ID, Substitution/Xml deferral, M8 scope, PagerSettings, M7 plan, integration tests, TreeView, GridView, DataGrid, ListView, FormView, DetailsView, validators, Menu improvements, Playwright patterns, rendermode fix)
- Propagated team updates to all 6 agent histories
- Deduplicated decisions.md (0 exact heading duplicates found)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore: bump version to 0.14 for Milestone 8 release

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix(docs): resolve broken links in ImageMap.md and Custom-Controls.md

- Remove broken link to non-existent HyperLink.md in ImageMap See Also
- Change Analyzer README link from relative path to GitHub URL (mkdocs
  strict mode can't resolve paths outside docs directory)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: csharpfritz <78577+csharpfritz@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: 3 people

docs/EditorControls/ImageMap.md

@@ -327,4 +327,4 @@ new RectangleHotSpot
 
 - [Image](Image.md) - Display static images
 - [ImageButton](ImageButton.md) - Clickable image that acts as a button
-- [HyperLink](HyperLink.md) - Text or image hyperlinks
+- HyperLink - Text or image hyperlinks (not yet implemented)

docs/Migration/Custom-Controls.md

@@ -15,7 +15,7 @@ Install the analyzer:
 dotnet add package BlazorWebFormsComponents.Analyzers
 ```
 
-The analyzer automatically highlights migration issues in your IDE and offers quick fixes. See the [Analyzer README](../../src/BlazorWebFormsComponents.Analyzers/README.md) for details.
+The analyzer automatically highlights migration issues in your IDE and offers quick fixes. See the [Analyzer README](https://github.com/FritzAndFriends/BlazorWebFormsComponents/tree/dev/src/BlazorWebFormsComponents.Analyzers/README.md) for details.
 
 ## Overview