@uob-web-and-digital/component-library 2.20.18 → 2.20.20

package/dist/components/organisms/Timeline/Timeline.stories.d.ts

@@ -22,3 +22,4 @@ export declare const Default: Story;
 export declare const DarkBackground: Story;
 export declare const WithoutComponentHeading: Story;
 export declare const FewPoints: Story;
+export declare const OptionalLabelAndDescription: Story;

package/dist/components/organisms/Timeline/TimelineItem.d.ts

@@ -9,17 +9,17 @@ export interface TimelinePointLink {
 }
 export interface TimelinePoint {
     /**
-     * Date or short label shown in the gold badge (required, max 20 characters)
+     * Optional date or short label shown in the gold badge (max 20 characters)
      */
-    label: string;
+    label?: string;
     /**
      * Optional point heading (max 30 characters)
      */
     heading?: string;
     /**
-     * Description text (required, max 100 characters)
+     * Optional description text (max 100 characters)
      */
-    description: string;
+    description?: string;
     /**
      * Optional link rendered with a trailing arrow (max 25 characters)
      */

package/dist/components/organisms/Timeline/useTimelineEmbla.d.ts

@@ -1,3 +1,4 @@
+import { RefObject } from 'react';
 import { TimelinePoint } from './TimelineItem';
 import { TimelinePage } from './timelineLayout';
 export interface TimelineEmbla {
@@ -22,5 +23,9 @@ export interface TimelineEmbla {
  * staggered, paged, no-partials packing Embla cannot express). Each page is one Embla
  * slide, so Embla snaps page-by-page on desktop and point-by-point on mobile. Pages are
  * recomputed from the live viewport width, and Embla is re-initialised when they change.
+ *
+ * The prev/next button refs are needed for end-of-track focus handling: when activating a
+ * button scrolls to an end it becomes disabled, and a disabled element cannot keep focus,
+ * so focus is moved to the opposite (still-enabled) button - the standard carousel pattern.
  */
-export declare function useTimelineEmbla(points: TimelinePoint[]): TimelineEmbla;
+export declare function useTimelineEmbla(points: TimelinePoint[], prevButtonRef: RefObject<HTMLButtonElement>, nextButtonRef: RefObject<HTMLButtonElement>): TimelineEmbla;