a11y(2.4.6): guard DrawerContent against empty <h2> when title is omitted

[rosanusi]

Summary

DrawerContent defaulted title to '' and unconditionally rendered <h2>{title}</h2>. When a consumer omitted the prop (two cloud consumers do), the DOM contained an empty heading — no accessible name, failing WCAG 2.4.6 (Headings and Labels, AA) and 4.1.2 (Name, Role, Value).

Fix: wrap the title-wrapper div in {#if title || $$slots['subtitle']} and the <h2> in {#if title}. The element is only emitted when content exists; the subtitle slot continues to render independently.

What changes

-<div class="title-wrapper {position}">
-  <h2>{title}</h2>
-  {#if $$slots['subtitle']}
-    ...
-  {/if}
-</div>
+{#if title || $$slots['subtitle']}
+  <div class="title-wrapper {position}">
+    {#if title}
+      <h2>{title}</h2>
+    {/if}
+    {#if $$slots['subtitle']}
+      ...
+    {/if}
+  </div>
+{/if}

Impact

• Consumers that pass title= (all 9 existing correct usages): no change in rendered output.
• Consumers that omit title (the two cloud gaps): empty <h2> removed.
• Subtitle-only usage: the wrapper still renders when only a subtitle slot is provided.

Test plan

• Open any drawer that passes a title (Manage Capacity, Bulk Add, Task Queue Fairness, Activity Options, Configure Headers, Keyboard Shortcuts). Confirm <h2> still renders with correct text.
• Open a drawer with only a subtitle slot (if any). Confirm the wrapper renders but no <h2>.
• axe-core: no empty heading violations on any drawer.
• Storybook visual regression: drawer story shows correct layout.

References

• Audit doc: audit-output/issues/2.4.6-cloud-drawer-content-empty-title.md
• Consumer fix: temporalio/cloud-ui PR (wcag/2.4.6-drawer-content-titles)
• WCAG 2.4.6: https://www.w3.org/WAI/WCAG22/Understanding/headings-and-labels

A11y-Audit-Ref: 2.4.6-cloud-drawer-content-empty-title

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
holocene	Ready	Preview, Comment	Jul 6, 2026 4:36pm

[ardiewen]

Follow-ups pushed since the original diff:

• Defensive padding — the empty-<h2> guard also removed .title-wrapper, the sole source of top padding, so a drawer with neither title nor subtitle rendered flush to the top (hits both title-less cloud consumers, connect-drawer + add-replica). Now derives hasHeader and adds pt-6 to .content only when no header renders — titled/subtitled drawers unchanged.
• Storybook — added With Subtitle, Subtitle Only, and No Title or Subtitle stories (previously only title-only was covered).
• Manifest — added the 2.4.6-cloud-drawer-content-empty-title entry so the A11y-Audit-Ref resolves (was a11y:broken-ref).

pnpm check + pnpm lint clean. Ships alongside cloud-ui wcag/2.4.6-drawer-content-titles (adds real titles to those two drawers).