Skip to content

feat(showcase): nav separator + badge specimens; correct the §3 item-8 verdict (#1878) - #3694

Merged
os-zhuang merged 1 commit into
mainfrom
chore/showcase-nav-badge-separator-specimen
Jul 27, 2026
Merged

feat(showcase): nav separator + badge specimens; correct the §3 item-8 verdict (#1878)#3694
os-zhuang merged 1 commit into
mainfrom
chore/showcase-nav-badge-separator-specimen

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Follow-up to #3677. This PR retracts a claim that PR and its merged doc made — and adds the specimen that settles it.

The correction

#3677's recheck said app badge/badgeVariant + nav separator were unconsumed by the console sidebar, and recommended porting three render branches into UnifiedSidebar. That was wrong. The keys are live:

  • NavigationRenderer implements them (:906 separator, :983-985 badge)
  • UnifiedSidebar delegates the whole app-navigation tree to itUnifiedSidebar.tsx:437, passing processedNavigation, which only re-orders/pins and spreads every other key through

Browser-verified against an unmodified objectui checkout: with the specimen below, the divider draws and the NEW pill renders. The port this PR was originally scoped to do would have duplicated existing capability.

Changes

  • showcase: nav_sep_reports (separator) + badge: 'NEW' / badgeVariant: 'secondary' on Hours by Status, in the Analytics group. Same rationale as the report-chart and showcase_archive_task specimens: a live key with no first-party usage rots invisibly.
  • 2026-07-naming-drift-recheck.md: item 8 → ALIGNED; disposition rewritten; plus a methodology note on how the item was got wrong twice.
  • audits/README.md §3 annotation corrected accordingly.

How it was got wrong (recorded in the doc)

Round Search Read as Reality
1 git grep -rln NavigationRenderer | head -3 → 3 CHANGELOG hits "the component was deleted" head -3 truncated the source hit
2 git grep -n NavigationRenderer -- 'packages/*/src' → empty "orphan, nobody imports it" the glob never matched the nested packages/app-shell/src/layout/…
3 author a specimen, boot the stack, look settled: it renders

Both bad rounds share one shape: a strong negative claim resting on a search whose result set was silently truncated or filtered. A grep can only prove presence; absence needs an exhaustive search you have verified is exhaustive — or, decisively, a runtime observation. For liveness questions specifically, authoring the key and looking is usually cheaper and sound.

Showcase suite 58/58 green.

Refs #1878, #3677, #3685, #3686.

🤖 Generated with Claude Code

…8 verdict (#1878)

Adds the two nav-affordance specimens to the showcase Analytics group
(`nav_sep_reports` separator + `badge: 'NEW'`/`badgeVariant: 'secondary'` on
Hours by Status) and corrects the naming-drift recheck, which twice published
a wrong verdict for this item.

The keys are LIVE. UnifiedSidebar delegates the whole app-navigation tree to
NavigationRenderer (UnifiedSidebar.tsx:437), which implements separator
(:906) and badge/badgeVariant (:983-985); processedNavigation only reorders
and pins, spreading every other key through. Browser-verified against an
UNMODIFIED objectui checkout: the divider draws and the NEW pill renders. No
objectui change was needed -- the port this PR was originally going to make
would have duplicated existing capability.

Both wrong rounds shared one shape: a strong negative claim ("the component
was deleted", "nobody imports it") resting on a search whose results were
silently truncated (head -3) or filtered (a pathspec glob that never matched
the nested path). The doc now carries a methodology note: a grep can only
prove presence; for "does authoring this key do anything", author it and look.

Showcase suite 58/58 green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectstack Ignored Ignored Jul 27, 2026 2:41pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation tooling size/s labels Jul 27, 2026
@os-zhuang
os-zhuang merged commit 671611e into main Jul 27, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the chore/showcase-nav-badge-separator-specimen branch July 27, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant