[a11y]: Coachmark: closeIconDescription effectively hardcoded to English

[wkeese]

Package

@carbon/ibm-products

Browser

Chrome

Operating System

MacOS

Package version

2.56.0

React version

18

Automated testing tool and ruleset

manual inspection

Assistive technology

No response

Description

CoachmarkDragbar has a closeIconDescription with a default value of 'Close':

export let CoachmarkDragbar = React.forwardRef<
  HTMLElement,
  CoachmarkDragbarProps
>(
  (
    {
      a11yKeyboardHandler,
      closeIconDescription = defaults.closeIconDescription,
...

However, CoachmarkDragbar is specifically listed as an internal component:

/**
 * DO NOT USE. This component is for the exclusive use
 * of other Onboarding components.
 */

When CoachmarkDragbar is instantiated from CoachmarkOverlay, there's no way to set the closeIconDescription:

<CoachmarkDragbar
  a11yKeyboardHandler={handleKeyPress}
  onBlur={() => setA11yDragMode(false)}
  onDrag={handleDrag}
  theme={theme}
  onClose={onClose}
/>

Likewise when CoachmarkOverlay is created from Coachmark itself.

---

CoachmarkHeader has the same problem, it's an internal component with a closeIconDescription:

/**
 * DO NOT USE. This component is for the exclusive use
 * of other Onboarding components.
 */
export let CoachmarkHeader = React.forwardRef<
  HTMLElement,
  CoachmarkHeaderProps
>(
  (
    {
      closeIconDescription = defaults.closeIconDescription,

... but there's no way to set closeIconDescription when instantiating CoachmarkOverlay etc.

---

And finally, same issue with CoachmarkTagline:

/**
 * DO NOT USE. This component is for the exclusive use
 * of other Onboarding components.
 */
export let CoachmarkTagline = React.forwardRef<
  HTMLDivElement,
  CoachmarkTaglineProps
>(
  (
    {
      closeIconDescription = defaults.closeIconDescription,

WCAG 2.1 Violation

No response

Reproduction/example

N/A

Steps to reproduce

N/A

Code of Conduct

• I agree to follow this project's Code of Conduct
• I checked the current issues for duplicate problems

[amal-k-joy]

introduce a new prop closeIconDescription and
introduce another new prop closeIconDescriptionForTagline for coachmarkFixed only ?

[elycheea]

See #6591 #6593