@justeattakeaway/pie-cookie-banner 1.10.21 → 1.11.0

package/cdn_dist/index.d.ts

@@ -101,6 +101,13 @@ export declare interface CookieBannerProps {
      * When false (default), links open in a new browser tab (`target="_blank"`).
      */
     openLinksInSameTab?: boolean;
+    /**
+     * When true, focus moves to the banner dialog when it is displayed on mount,
+     * so screen readers announce it. Only set this when the banner is opened
+     * in response to a user action; on initial page load focus must remain untouched.
+     * When false (default), the banner does not take focus on mount.
+     */
+    shouldFocusOnOpen?: boolean;
 }
 
 export declare const Country: {
@@ -173,14 +180,22 @@ export declare class PieCookieBanner extends PieElement implements CookieBannerP
     country: string;
     language: string;
     openLinksInSameTab: boolean;
+    shouldFocusOnOpen: boolean;
     _preferencesNodes: NodeListOf<PieSwitch>;
+    private _bannerContainer;
     /**
      * Returns the target attribute value for external links based on the openLinksInSameTab prop.
      * - false (default): returns '_blank' (new tab)
      * - true: returns '_self' (same tab)
      */
     private get _linkTargetAttribute();
+    firstUpdated(): void;
     updated(changedProperties: PropertyValues<this>): Promise<void>;
+    /**
+     * Moves focus to the banner dialog container.
+     * The container uses tabindex="-1", so it is only focusable programmatically.
+     */
+    private _focusBanner;
     private _setLocaleBasedOnCountryAndLanguage;
     /**
      * Gets the locale string for the requested language and country.