Skip to content

docs: update breadcrumbs JSDoc, add missing styling section#11820

Merged
web-padawan merged 2 commits into
mainfrom
breadcrumbs-step12
May 25, 2026
Merged

docs: update breadcrumbs JSDoc, add missing styling section#11820
web-padawan merged 2 commits into
mainfrom
breadcrumbs-step12

Conversation

@web-padawan

Copy link
Copy Markdown
Member

Closes out the Breadcrumbs SDD pipeline at 12/12. Brings the class-level JSDoc on the four public entries up to the standard set by <vaadin-side-nav> and <vaadin-card> — no behavior changes, no new exports.

Changes

  • vaadin-breadcrumbs.js / .d.ts — HTML usage example, parts table (including the overlay and overlay-content parts re-exported from the internal overlay), state-attributes table, custom CSS properties list (single-bullet).
  • vaadin-breadcrumbs-item.js / .d.ts — HTML usage example, parts table, state-attributes table for current, disabled, focus-ring, focused, has-prefix (framework-neutral wording — no DisabledMixin / FocusMixin mentions in the public docs).
  • implementation-notes.md — Task 12 log entry.

What's intentionally absent

  • No @fires lines. grep -rn dispatchEvent packages/breadcrumbs/src/ is empty — the component dispatches no public events. The regenerated custom-elements.json confirms events: [] for both elements.
  • No JSDoc on vaadin-breadcrumbs-overlay.js. It's @private — not part of the public surface.

Verification

  • yarn lint — clean
  • yarn lint:types — clean
  • yarn test --group breadcrumbs — 59 unit + 21 snapshot tests pass
  • yarn release:cem — regenerates packages/breadcrumbs/custom-elements.json cleanly; events arrays stay empty for both elements

🤖 Generated with Claude Code

@web-padawan web-padawan force-pushed the breadcrumbs-step12 branch 3 times, most recently from cfaf9b5 to 01f1e06 Compare May 25, 2026 12:22
@web-padawan web-padawan force-pushed the breadcrumbs-step12 branch from 01f1e06 to e4ebcd5 Compare May 25, 2026 12:25
@web-padawan web-padawan changed the title docs(breadcrumbs): task 12 — documentation pass docs: update breadcrumbs JSDoc, add missing styling section May 25, 2026
@web-padawan web-padawan requested a review from vursen May 25, 2026 12:25
@sonarqubecloud

Copy link
Copy Markdown

@web-padawan web-padawan merged commit 728fd67 into main May 25, 2026
10 checks passed
@web-padawan web-padawan deleted the breadcrumbs-step12 branch May 25, 2026 13:14
@vaadin-bot

Copy link
Copy Markdown
Collaborator

This ticket/PR has been released with Vaadin 25.2.0-beta2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants