@westpac/ui 1.10.0 → 1.11.0

package/dist/components/heading/heading.component.d.ts

@@ -1,2 +1,8 @@
-import { type HeadingProps } from './heading.types.js';
-export declare function Heading({ className, tag, brandHeading, size, children, uppercase, ...props }: HeadingProps): import("react/jsx-runtime").JSX.Element;
+import React from 'react';
+export declare const Heading: React.ForwardRefExoticComponent<{
+    brandHeading?: import("../../types/responsive-variants.types.js").ResponsiveVariants<boolean | undefined>;
+    children?: React.ReactNode;
+    size: import("../../types/responsive-variants.types.js").ResponsiveVariants<2 | 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | undefined>;
+    tag?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    uppercase?: boolean;
+} & React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLHeadingElement>>;

package/dist/components/heading/heading.component.js

@@ -1,9 +1,9 @@
 'use client';
-import React from 'react';
+import React, { forwardRef } from 'react';
 import { useBreakpoint } from '../../hook/breakpoints.hook.js';
 import { resolveResponsiveVariant } from '../../utils/breakpoint.util.js';
 import { styles } from './heading.styles.js';
-export function Heading({ className, tag, brandHeading, size, children, uppercase, ...props }) {
+function BaseHeading({ className, tag, brandHeading, size, children, uppercase, ...props }, ref) {
     const sizeToTag = {
         1: 'h1',
         2: 'h2',
@@ -25,6 +25,8 @@ export function Heading({ className, tag, brandHeading, size, children, uppercas
             size: resolveResponsiveVariant(size, breakpoint),
             uppercase
         }),
+        ref: ref,
         ...props
     }, children);
 }
+export const Heading = forwardRef(BaseHeading);

package/dist/components/heading/heading.types.d.ts

@@ -3,6 +3,7 @@ import { type VariantProps } from 'tailwind-variants';
 import { ResponsiveVariants } from '../../types/responsive-variants.types.js';
 import { styles } from './heading.styles.js';
 type Variants = VariantProps<typeof styles>;
+export type HeadingRef = HTMLHeadingElement;
 export type HeadingProps = {
     /**
      * Whether it should be a brand heading

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@westpac/ui",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "license": "MIT",
   "sideEffects": false,
   "type": "module",
@@ -254,9 +254,9 @@
     "vite": "^7.3.5",
     "vitest": "^3.2.6",
     "@westpac/eslint-config": "~1.1.0",
-    "@westpac/test-config": "~0.0.0",
     "@westpac/style-config": "~1.0.2",
-    "@westpac/ts-config": "~0.0.0"
+    "@westpac/ts-config": "~0.0.0",
+    "@westpac/test-config": "~0.0.0"
   },
   "dependencies": {
     "@internationalized/date": "~3.10.0",

package/src/components/heading/heading.component.tsx

@@ -1,14 +1,17 @@
 'use client';
 
-import React from 'react';
+import React, { forwardRef, Ref } from 'react';
 
 import { useBreakpoint } from '../../hook/breakpoints.hook.js';
 import { resolveResponsiveVariant } from '../../utils/breakpoint.util.js';
 
 import { styles } from './heading.styles.js';
-import { type HeadingProps } from './heading.types.js';
+import { HeadingRef, type HeadingProps } from './heading.types.js';
 
-export function Heading({ className, tag, brandHeading, size, children, uppercase, ...props }: HeadingProps) {
+function BaseHeading(
+  { className, tag, brandHeading, size, children, uppercase, ...props }: HeadingProps,
+  ref: Ref<HeadingRef>,
+) {
   const sizeToTag = {
     1: 'h1',
     2: 'h2',
@@ -32,9 +35,12 @@ export function Heading({ className, tag, brandHeading, size, children, uppercas
         size: resolveResponsiveVariant(size, breakpoint),
         uppercase,
       })}
+      ref={ref}
       {...props}
     >
       {children}
     </Tag>
   );
 }
+
+export const Heading = forwardRef(BaseHeading);

package/src/components/heading/heading.types.ts

@@ -6,6 +6,7 @@ import { ResponsiveVariants } from '../../types/responsive-variants.types.js';
 import { styles } from './heading.styles.js';
 
 type Variants = VariantProps<typeof styles>;
+export type HeadingRef = HTMLHeadingElement;
 
 export type HeadingProps = {
   /**