@primer/react-brand 0.78.0-rc.bcc08c15 → 0.78.0-rc.c01d8371

package/docs/components/SubNav/index.md

@@ -45,6 +45,37 @@ import {SubNav} from '@primer/react-brand'
 </div>
 ```
 
+### Localized menu controls
+
+Internal `SubNav` labels such as the "More" link are rendered in `en` by default. Use `menuLabels` to customize these to different locales.
+
+```jsx
+<div style={{position: 'relative', height: 360, width: '100%'}}>
+  <SubNav
+    menuLabels={{
+      menuLabel: 'Menú de navegación',
+      closeLabel: 'Cerrar menú de navegación',
+      activeLabel: 'Menú de navegación. Página actual:',
+      closeActiveLabel: 'Cerrar menú de navegación. Página actual:',
+      overflowMenuLabel: 'Más',
+    }}
+  >
+    <SubNav.Heading href="#">AI</SubNav.Heading>
+    <SubNav.SubHeading href="#">GitHub Copilot</SubNav.SubHeading>
+    <SubNav.Link href="#">Aplicación de escritorio</SubNav.Link>
+    <SubNav.Link href="#" aria-current="page">
+      Copilot en VS Code
+    </SubNav.Link>
+    <SubNav.Link href="#">Agentes en GitHub</SubNav.Link>
+    <SubNav.Link href="#">Copilot CLI</SubNav.Link>
+    <SubNav.Link href="#">Revisión de código de Copilot</SubNav.Link>
+    <SubNav.Link href="#">Para empresas</SubNav.Link>
+    <SubNav.Link href="#">Tutoriales</SubNav.Link>
+    <SubNav.Link href="#">Planes y precios</SubNav.Link>
+  </SubNav>
+</div>
+```
+
 ### Optional CTA
 
 ```jsx
@@ -72,7 +103,7 @@ Submenus appear as a dropdown by default.
     <SubNav.Heading href="#">Features</SubNav.Heading>
     <SubNav.Link href="#" aria-current="page">
       Actions
-      <SubNav.SubMenu>
+      <SubNav.SubMenu aria-label="Actions submenu">
         <SubNav.Link href="#">Actions feature one</SubNav.Link>
         <SubNav.Link href="#">Actions feature two</SubNav.Link>
         <SubNav.Link href="#">Actions feature three</SubNav.Link>
@@ -116,9 +147,22 @@ Ensure that the text of each `SubNav.Link` within the anchor-based submenu fits
 
 ### SubNav `Required`
 
-| name        | type      | default | required | description                                                                   |
-| ----------- | --------- | ------- | -------- | ----------------------------------------------------------------------------- |
-| `fullWidth` | `boolean` | `false` | `false`  | Allows the SubNav to be used at full width, removing default internal padding |
+| name         | type                        | default        | required | description                                                                   |
+| ------------ | --------------------------- | -------------- | -------- | ----------------------------------------------------------------------------- |
+| `fullWidth`  | `boolean`                   | `false`        | `false`  | Allows the SubNav to be used at full width, removing default internal padding |
+| `menuLabels` | `Partial<SubNavMenuLabels>` | English labels | `false`  | Customizes the menu's accessible labels                                       |
+
+`SubNavMenuLabels` is exported from `@primer/react-brand`.
+
+#### Menu labels
+
+| Field               | Type     | English default                        | Purpose                                                                       |
+| ------------------- | -------- | -------------------------------------- | ----------------------------------------------------------------------------- |
+| `menuLabel`         | `string` | `Navigation menu`                      | Accessible label while the narrow menu is closed                              |
+| `closeLabel`        | `string` | `Close navigation menu`                | Accessible label while the narrow menu is open                                |
+| `activeLabel`       | `string` | `Navigation menu. Current page:`       | Complete prefix while the narrow menu is closed and a current page is present |
+| `closeActiveLabel`  | `string` | `Close navigation menu. Current page:` | Complete prefix while the narrow menu is open and a current page is present   |
+| `overflowMenuLabel` | `string` | `More`                                 | Visible and accessible label for the desktop overflow menu                    |
 
 ### SubNav.Heading `Required`
 
@@ -150,7 +194,8 @@ Ensure that the text of each `SubNav.Link` within the anchor-based submenu fits
 
 ### SubNav.SubMenu
 
-| name       | type                    | default     | required | description                           |
-| ---------- | ----------------------- | ----------- | -------- | ------------------------------------- |
-| `children` | `SubNav.Link`           |             | `false`  | Container for submenu links           |
-| `variant`  | `SubNavSubMenuVariants` | `'default'` | `false`  | Alternative presentation for submenus |
+| name         | type                    | default                      | required | description                                                                                                       |
+| ------------ | ----------------------- | ---------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
+| `children`   | `SubNav.Link`           |                              | `false`  | Container for submenu links                                                                                       |
+| `variant`    | `SubNavSubMenuVariants` | `'default'`                  | `false`  | Alternative presentation for submenus                                                                             |
+| `aria-label` | `string`                | `'Sub navigation'` (content) | `false`  | Complete accessible name for the submenu toggle and content; names the navigation landmark for the anchor variant |

package/docs/index.md

@@ -1,6 +1,6 @@
-# Primer Brand docs (v0.78.0-rc.bcc08c15)
+# Primer Brand docs (v0.78.0-rc.c01d8371)
 
-These docs are bundled with `@primer/react-brand@0.78.0-rc.bcc08c15` and match your installed version.
+These docs are bundled with `@primer/react-brand@0.78.0-rc.c01d8371` and match your installed version.
 
 New here? Start with [Getting started](getting-started/index.md) for installation, global
 stylesheet and font setup. Component directories are named after their import (e.g.

package/esm/SubNav/SubNav.d.ts

@@ -12,6 +12,13 @@ type SubNavContextType = {
     portalRef: RefObject<HTMLDivElement | null>;
 };
 export declare const useSubNavContext: () => SubNavContextType;
+export type SubNavMenuLabels = {
+    menuLabel: string;
+    closeLabel: string;
+    activeLabel: string;
+    closeActiveLabel: string;
+    overflowMenuLabel: string;
+};
 export type SubNavProps = {
     /**
      * @deprecated The hasShadow prop is deprecated and will be removed in a future release.
@@ -22,6 +29,10 @@ export type SubNavProps = {
      * removing any internal padding and guttering.
      */
     fullWidth?: boolean;
+    /**
+     * Customizable accessible labels
+     */
+    menuLabels?: Partial<SubNavMenuLabels>;
     'data-testid'?: string;
 } & PropsWithChildren<BaseProps<HTMLDivElement>>;
 type HeadingBaseProps = {
@@ -37,11 +48,16 @@ type LinkBaseProps = {
     'data-testid'?: string;
     variant?: TextProps['variant'];
     _subMenuVariant?: SubMenuVariants;
+    _isOverflowed?: boolean;
+    _isOverflowMenu?: boolean;
+    _onOverflowLinkActivate?: () => void;
 } & PropsWithChildren<React.HTMLProps<HTMLAnchorElement>> & BaseProps<HTMLAnchorElement>;
 type SubMenuProps = {
     variant?: SubMenuVariants;
+    _isOverflowMenu?: boolean;
+    _onOverflowLinkActivate?: () => void;
 } & React.HTMLAttributes<HTMLUListElement> & BaseProps<HTMLUListElement>;
-declare function SubMenuBase({ children, className, variant, ...props }: SubMenuProps): React.JSX.Element;
+declare function SubMenuBase({ children, className, 'aria-label': ariaLabel, variant, _isOverflowMenu, _onOverflowLinkActivate, ...props }: SubMenuProps): React.JSX.Element;
 type SubNavActionProps = {
     /**
      * Required path or location for the action button to link to.
@@ -75,6 +91,8 @@ export declare const SubNav: React.NamedExoticComponent<Omit<SubNavProps, "ref">
         readonly heading: string;
         readonly action: string;
         readonly subMenu: string;
+        readonly overflowButton: string;
+        readonly overflowMenu: string;
     };
 };
 export {};

package/esm/SubNav/SubNav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SubNav.d.ts","sourceRoot":"","sources":["../../src/SubNav/SubNav.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAYZ,KAAK,iBAAiB,EAEtB,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AACd,OAAO,EAAS,WAAW,EAAE,cAAc,EAAQ,SAAS,EAA+B,MAAM,IAAI,CAAA;AAWrG,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAA;AAEnD;;GAEG;AACH,OAAO,8FAA8F,CAAA;AACrG,OAAO,2GAA2G,CAAA;AA4BlH,eAAO,MAAM,qBAAqB,iCAAkC,CAAA;AACpE,KAAK,eAAe,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7D,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;CAC5C,CAAA;AAID,eAAO,MAAM,gBAAgB,yBAM5B,CAAA;AA6CD,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,iBAAiB,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;AA+PhD,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,GACvD,SAAS,CAAC,iBAAiB,CAAC,CAAA;AAe9B,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,GACvD,SAAS,CAAC,iBAAiB,CAAC,CAAA;AAe9B,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,GACvD,SAAS,CAAC,iBAAiB,CAAC,CAAA;AA6J9B,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B,GAAG,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GACxC,SAAS,CAAC,gBAAgB,CAAC,CAAA;AAE7B,iBAAS,WAAW,CAAC,EAAC,QAAQ,EAAE,SAAS,EAAE,OAAoB,EAAE,GAAG,KAAK,EAAC,EAAE,YAAY,qBAgEvF;AAED,KAAK,iBAAiB,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;IACnC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;CAC1C,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAA;AAE/D,iBAAS,UAAU,CAAC,EAAC,QAAQ,EAAE,IAAI,EAAE,OAAmB,EAAE,IAAc,EAAE,GAAG,IAAI,EAAC,EAAE,iBAAiB,qBAcpG;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;8EA7SgE,gBAAgB;iFAmBb,mBAAmB;;;;;;;;;;;;;CAiSvG,CAAA"}
+{"version":3,"file":"SubNav.d.ts","sourceRoot":"","sources":["../../src/SubNav/SubNav.tsx"],"names":[],"mappings":"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"}