@guardian/commercial-core 7.0.0 → 27.0.0

package/dist/cjs/types.d.ts

@@ -1,87 +1,423 @@
-import type { VendorName } from '@guardian/consent-management-platform/dist/types';
-export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'mixed' | 'none' | 'other' | 'unknown' | 'wifi';
-export interface NetworkInformation extends EventTarget {
+import type { AdSize, SizeMapping } from './ad-sizes';
+import type { PageTargeting } from './targeting/build-page-targeting';
+type HeaderBiddingSize = AdSize;
+interface Advert {
+    id: string;
+    node: HTMLElement;
+    prebidAdUnit: string;
+    sizes: SizeMapping;
+    headerBiddingSizes: HeaderBiddingSize[] | null;
+    size: AdSize | 'fluid' | null;
+    slot: googletag.Slot;
+    isEmpty: boolean | null;
+    isRendered: boolean;
+    shouldRefresh: boolean;
+    whenSlotReady: Promise<void>;
+    extraNodeClasses: string[];
+    hasPrebidSize: boolean;
+    headerBiddingBidRequest: Promise<unknown> | null;
+    lineItemId: number | null;
+    creativeId: number | null;
+    creativeTemplateId: number | null;
+    testgroup: string | undefined;
+    finishedRendering(isRendered: boolean): void;
+    updateExtraSlotClasses(...newClasses: string[]): Promise<void>;
+    generateSizeMapping(additionalSizeMapping: SizeMapping): SizeMapping;
+    updateSizeMapping(additionalSizeMapping: SizeMapping): void;
+}
+interface DfpEnv {
+    renderStartTime: number;
+    adSlotSelector: string;
+    lazyLoadEnabled: boolean;
+    lazyLoadObserve: boolean;
+    advertsToLoad: Advert[];
+    adverts: Map<Advert['id'], Advert>;
+    shouldLazyLoad: () => boolean;
+}
+type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'mixed' | 'none' | 'other' | 'unknown' | 'wifi';
+interface NetworkInformation extends EventTarget {
     readonly type?: ConnectionType;
     readonly downlink?: number;
     readonly effectiveType?: string;
 }
-export type TagAttribute = {
-    name: string;
-    value: string;
+type OphanRecordFunction = (event: Record<string, unknown> & {
+    /**
+     * the experiences key will override previously set values.
+     * Use `recordExperiences` instead.
+     */
+    experiences?: never;
+}, callback?: () => void) => void;
+/**
+ * Generates a type which represents possible indices of this array
+ *
+ * Example usage:
+ * const list = ['foo', 'bar', 'baz'] as const;
+ * type Test = Indices<typeof list>
+ */
+type Indices<T extends readonly unknown[]> = Exclude<Partial<T>['length'], T['length']>;
+type Edition = 'UK' | 'AU' | 'US';
+type AdsConfigDisabled = {
+    disableAds: true;
+};
+type AdsConfigBasic = {
+    adTagParameters: {
+        iu: string;
+        cust_params: string;
+    };
+};
+type AdsConfigUSNATorAus = AdsConfigBasic & {
+    restrictedDataProcessor: boolean;
 };
-export type ThirdPartyTag = {
-    async?: boolean;
-    attrs?: TagAttribute[];
-    beforeLoad?: () => void;
-    insertSnippet?: () => void;
-    loaded?: boolean;
-    onLoad?: () => void;
-    shouldRun: boolean;
-    name?: VendorName;
-    url?: string;
-    useImage?: boolean;
+type AdsConfigTCFV2 = AdsConfigBasic & {
+    adTagParameters: {
+        cmpGdpr: number;
+        cmpVcd: string;
+        cmpGvcd: string;
+    };
+    nonPersonalizedAd: boolean;
 };
-export type GetThirdPartyTag = (arg0: {
-    shouldRun: boolean;
-}) => ThirdPartyTag;
-export type GuardianAnalyticsConfig = {
-    trackers: Record<string, string>;
+interface Ophan {
+    trackComponentAttention: (name: string, el: Element, visiblityThreshold: number) => void;
+    record: OphanRecordFunction;
+    viewId: string;
+    pageViewId: string;
+}
+type PrebidBreakpoint = 'D' | 'T' | 'M';
+type PrebidIndexSite = {
+    bp: PrebidBreakpoint;
+    id: number;
 };
-export type Edition = 'UK' | 'AU' | 'US';
-export type GuardianWindowConfig = {
-    googleAnalytics?: GuardianAnalyticsConfig;
+interface CommercialPageConfig {
+    pbIndexSites: PrebidIndexSite[];
+    adUnit: string;
+    appNexusPageTargeting?: string;
+    sharedAdTargeting?: Record<string, string | string[]>;
+    shouldHideAdverts: boolean;
+    pageAdTargeting?: PageTargeting;
+    dfpAccountId: string;
+    ipsosTag?: string;
+    a9PublisherId: string;
+    libs?: {
+        googletag?: string;
+    };
+}
+interface PageConfig extends CommercialPageConfig {
+    ajaxUrl?: string;
+    assetsPath: string;
+    author: string;
+    authorIds: string;
+    blogIds: string;
+    commentable: boolean;
+    contentType: string;
+    dcrCouldRender: boolean;
+    edition: Edition;
+    frontendAssetsFullURL?: string;
+    hasPageSkin: boolean;
+    hasShowcaseMainElement: boolean;
+    hasYouTubeAtom: boolean;
+    headline: string;
+    host: string;
+    idApiUrl?: string;
+    idUrl?: string;
+    isbn?: string;
+    isDev: boolean;
+    isFront: boolean;
+    isHosted: boolean;
+    isImmersive?: boolean;
+    isLiveBlog?: boolean;
+    isPaidContent: boolean;
+    isPreview: boolean;
+    isProd: boolean;
+    isSensitive: boolean;
+    isMinuteArticle: boolean;
+    keywordIds: string;
+    keywords: string;
+    lightboxImages?: {
+        images: Array<{
+            src: string;
+        }>;
+    };
+    pageId: string;
+    publication: string;
+    revisionNumber: string;
+    section: string;
+    sectionName: string;
+    sentryHost: string;
+    sentryPublicApiKey: string;
+    series: string;
+    seriesId: string;
+    sharedAdTargeting?: Record<string, string | string[]>;
+    shouldHideReaderRevenue?: boolean;
+    showNewRecipeDesign?: boolean;
+    showRelatedContent?: boolean;
+    source: string;
+    sponsorshipType: string;
+    toneIds: string;
+    tones: string;
+    videoDuration: number;
+    webPublicationDate: number;
+    userAttributesApiUrl?: string;
+}
+type Stage = 'DEV' | 'CODE' | 'PROD';
+interface UserConfig {
+    accountCreatedDate: number;
+    displayName: string;
+    emailVerified: boolean;
+    id: string;
+    rawResponse: string;
+}
+interface Config {
+    commercialMetricsInitialised?: boolean;
+    frontendAssetsFullURL?: string;
     isDotcomRendering: boolean;
     ophan: {
         browserId?: string;
         pageViewId: string;
     };
-    page: {
-        dcrCouldRender: boolean;
-        edition: Edition;
-        isPreview: boolean;
-        isSensitive: boolean;
-        pageId: string;
-        section: string;
-        sharedAdTargeting?: Record<string, string | string[]>;
-        videoDuration: number;
-        webPublicationDate: number;
-    };
+    page: PageConfig;
+    shouldSendCommercialMetrics?: boolean;
+    stage: Stage;
+    switches: Record<string, boolean | undefined>;
     tests?: {
         [key: `${string}Control`]: 'control';
         [key: `${string}Variant`]: 'variant';
     };
+    user?: UserConfig;
+}
+type AdBlockers = {
+    active: boolean | undefined;
+    onDetect: Array<(value: boolean | PromiseLike<boolean>) => void>;
 };
-export type GoogleTagParams = unknown;
-export type GoogleTrackConversionObject = {
-    google_conversion_id: number;
-    google_custom_params: GoogleTagParams;
-    google_remarketing_only: boolean;
+type TagCounts = Record<string, number>;
+type WeeklyArticleLog = {
+    week: number;
+    count: number;
+    tags?: TagCounts;
 };
-export type MaybeArray<T> = T | T[];
-export type CustomParams = Record<string, MaybeArray<string | number | boolean>>;
-export type AdsConfigDisabled = {
-    disableAds: true;
+type WeeklyArticleHistory = WeeklyArticleLog[];
+interface DailyArticleCount {
+    day: number;
+    count: number;
+}
+type DailyArticleHistory = DailyArticleCount[];
+interface ArticleCounts {
+    weeklyArticleHistory: WeeklyArticleHistory;
+    dailyArticleHistory: DailyArticleHistory;
+}
+type FetchBidSizes = {
+    adSizes: `${number}x${number}`;
 };
-export type AdsConfigBasic = {
-    adTagParameters: {
-        iu: string;
-        cust_params: string;
+type FetchBidResponse = {
+    amznbid: string;
+    amzniid: string;
+    amznp: string;
+    amznsz: FetchBidSizes;
+    size: FetchBidSizes;
+    slotID: string;
+};
+interface HeaderNotification {
+    id: string;
+    target: string;
+    message: string;
+    ophanLabel: string;
+    logImpression: () => void;
+}
+interface OptOutInitializeOptions {
+    publisher: number;
+    onlyNoConsent?: 0 | 1;
+    alwaysNoConsent?: 0 | 1;
+    consentTimeOutMS?: 5000;
+    noLogging?: 0 | 1;
+    lazyLoading?: {
+        fractionInView?: number;
+        viewPortMargin?: string;
     };
+    noRequestsOnPageLoad?: 0 | 1;
+    frequencyScript?: string;
+    timeoutFrequencyCappingMS?: number;
+    debug_forceCap?: number;
+}
+interface OptOutResponse {
+    adSlot: string;
+    width: number;
+    height: number;
+    ad: string;
+    creativeId: string;
+    meta: {
+        networkId: string;
+        networkName: string;
+        agencyId: string;
+        agencyName: string;
+        advertiserId: string;
+        advertiserName: string;
+        advertiserDomains: string[];
+    };
+    optOutExt: {
+        noSafeFrame: boolean;
+        tags: string[];
+    };
+}
+type OptOutFilledCallback = (adSlot: OptOutAdSlot, response: OptOutResponse) => void;
+interface OptOutAdSlot {
+    adSlot: string;
+    targetId: string;
+    id: string;
+    filledCallback?: OptOutFilledCallback;
+    emptyCallback?: (adSlot: OptOutAdSlot) => void;
+    adShownCallback?: (adSlot: OptOutAdSlot, response: OptOutResponse) => void;
+}
+interface ImpressionsDfpObject {
+    s: string;
+    ad: string;
+    c: string;
+    I: string;
+    o: string;
+    A: string;
+    y: string;
+    co: string;
+}
+declare enum BlockingType {
+    Manual = 1,// Deprecated
+    Creative = 2,// Creative-based detection
+    ProviderSecurity = 3,// Domain-based detection for unsafe domains
+    BannedDomain = 4,// Domain-based detection for banned domains
+    ProviderIbv = 5,// Domain-based detection for in-banner-video
+    UnsafeJS = 6,// JavaScript-based detection for unsafe ads
+    Hrap = 7
+}
+type ConfiantCallback = (blockingType: BlockingType, blockingId: string, isBlocked: boolean, wrapperId: string, tagId: string, impressionsData?: {
+    prebid?: {
+        adId?: string | null;
+        cpm?: number | null;
+        s?: string;
+    };
+    dfp?: ImpressionsDfpObject;
+}) => void;
+interface Confiant extends Record<string, unknown> {
+    settings: {
+        callback: ConfiantCallback;
+        [key: string]: unknown;
+    };
+}
+interface Permutive {
+    config?: {
+        projectId?: string;
+        apiKey?: string;
+        environment?: string;
+    };
+    q?: Array<{
+        functionName: string;
+        arguments: unknown[];
+    }>;
+    addon?: (name: string, props: Record<string, unknown>) => void;
+    identify?: (user: Array<{
+        id: string;
+        tag: string;
+    }>) => void;
+    track?: (name: string, props: Record<string, unknown>) => void;
+}
+type ApstagInitConfig = {
+    pubID: string;
+    adServer?: string;
+    bidTimeout?: number;
+    blockedBidders?: string[];
 };
-export type AdsConfigCCPAorAus = AdsConfigBasic & {
-    restrictedDataProcessor: boolean;
+interface A9AdUnitInterface {
+    slotID: string;
+    slotName?: string;
+    sizes: number[][];
+}
+type FetchBidsBidConfig = {
+    slots: A9AdUnitInterface[];
 };
-export type AdsConfigTCFV2 = AdsConfigBasic & {
-    adTagParameters: {
-        cmpGdpr: number;
-        cmpVcd: string;
-        cmpGvcd: string;
+type Apstag = {
+    init: (arg0: ApstagInitConfig) => void;
+    fetchBids: (arg0: FetchBidsBidConfig, callback: (res: FetchBidResponse[]) => void) => void;
+    setDisplayBids: () => void;
+};
+type ComscoreGlobals = {
+    c1: string;
+    c2: string;
+    cs_ucfr: string;
+    comscorekw?: string;
+    options?: {
+        enableFirstPartyCookie?: boolean;
     };
-    nonPersonalizedAd: boolean;
 };
-export type AdsConfigEnabled = AdsConfigBasic | AdsConfigCCPAorAus | AdsConfigTCFV2;
-export type AdsConfig = AdsConfigEnabled | AdsConfigDisabled;
-export type AdTargetingBuilder = () => Promise<AdsConfig>;
-export type True = 't';
-export type False = 'f';
-export type NotApplicable = 'na';
+interface IasPETSlot {
+    adSlotId: string;
+    size: Array<[number, number]>;
+    adUnitPath: string;
+}
+interface IasPET {
+    queue?: Array<{
+        adSlots: IasPETSlot[];
+        dataHandler: (targetingJSON: string) => void;
+    }>;
+    pubId?: string;
+}
+interface TeadsAnalytics {
+    analytics_tag_id?: string;
+    share?: () => void;
+    shared_data?: unknown[];
+}
+/**
+ * Types for the IAB Safeframe API
+ *
+ * Note this type definition is incomplete.
+ * These types can be refined as/when they are required
+ */
+interface SafeFrameAPI {
+    ver: string;
+    specVersion: string;
+    lib: {
+        lang: Record<string, unknown>;
+        dom: {
+            iframes: Record<string, unknown>;
+            msghost: Record<string, unknown>;
+        };
+        logger: Record<string, unknown>;
+    };
+    env: {
+        isIE: boolean;
+        ua: Record<string, unknown>;
+    };
+    info: {
+        errs: unknown[];
+        list: unknown[];
+    };
+    host: {
+        Config: {
+            new (o: {
+                renderFile: string;
+                positions: Record<string, unknown>;
+            }): unknown;
+        };
+    };
+}
+/**
+ * Types for IMR Worldwide
+ */
+interface NSdkInstance {
+    ggPM: (type: string, dcrStaticMetadata: {
+        type: string;
+        assetid: unknown;
+        section: string;
+    }) => void;
+    ggInitialize: (nolggGlobalParams: {
+        sfcode: string;
+        apid: string;
+        apn: string;
+    }) => void;
+}
+interface Trac {
+    record: () => this;
+    post: () => this;
+}
+type GoogleTagParams = unknown;
+type GoogleTrackConversionObject = {
+    google_conversion_id: number;
+    google_custom_params: GoogleTagParams;
+    google_remarketing_only: boolean;
+};
+export type { Advert, DfpEnv, ConnectionType, NetworkInformation, OphanRecordFunction, Indices, Edition, AdsConfigDisabled, AdsConfigBasic, AdsConfigUSNATorAus, AdsConfigTCFV2, Ophan, Config, AdBlockers, ArticleCounts, FetchBidResponse, HeaderNotification, OptOutInitializeOptions, OptOutAdSlot, Confiant, Permutive, Apstag, ComscoreGlobals, IasPET, TeadsAnalytics, SafeFrameAPI, NSdkInstance, Trac, GoogleTagParams, GoogleTrackConversionObject, };

package/dist/cjs/types.js

@@ -1,2 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+var BlockingType;
+(function (BlockingType) {
+    BlockingType[BlockingType["Manual"] = 1] = "Manual";
+    BlockingType[BlockingType["Creative"] = 2] = "Creative";
+    BlockingType[BlockingType["ProviderSecurity"] = 3] = "ProviderSecurity";
+    BlockingType[BlockingType["BannedDomain"] = 4] = "BannedDomain";
+    BlockingType[BlockingType["ProviderIbv"] = 5] = "ProviderIbv";
+    BlockingType[BlockingType["UnsafeJS"] = 6] = "UnsafeJS";
+    BlockingType[BlockingType["Hrap"] = 7] = "Hrap";
+})(BlockingType || (BlockingType = {}));

package/dist/esm/ad-sizes.d.ts

@@ -1,4 +1,4 @@
-import type { Breakpoint } from './lib/breakpoint';
+import type { Breakpoint } from './breakpoint';
 type AdSizeString = 'fluid' | `${number},${number}`;
 /**
  * Store ad sizes in a way that is compatible with google-tag but also accessible via
@@ -27,9 +27,9 @@ declare class AdSize extends Array<number> {
     get width(): number;
     get height(): number;
 }
-type SizeKeys = '160x600' | '300x1050' | '300x250' | '300x600' | '728x90' | '970x250' | 'billboard' | 'cascade' | 'empty' | 'fabric' | 'fluid' | 'googleCard' | 'halfPage' | 'inlineMerchandising' | 'leaderboard' | 'merchandising' | 'merchandisingHigh' | 'merchandisingHighAdFeature' | 'mobilesticky' | 'mpu' | 'outOfPage' | 'outstreamDesktop' | 'outstreamGoogleDesktop' | 'outstreamMobile' | 'portrait' | 'portraitInterstitial' | 'skyscraper';
-type SlotName = 'carrot' | 'comments' | 'comments-expanded' | 'crossword-banner' | 'epic' | 'exclusion' | 'im' | 'inline' | 'merchandising-high-lucky' | 'merchandising-high' | 'merchandising' | 'mobile-sticky' | 'mostpop' | 'right' | 'survey' | 'top-above-nav';
-type SizeMapping = Partial<Record<Breakpoint, AdSize[]>>;
+type SizeKeys = '160x600' | '300x1050' | '300x250' | '300x600' | '728x90' | '970x250' | 'billboard' | 'cascade' | 'empty' | 'fabric' | 'fluid' | 'googleCard' | 'halfPage' | 'leaderboard' | 'merchandising' | 'merchandisingHigh' | 'merchandisingHighAdFeature' | 'mobilesticky' | 'mpu' | 'outOfPage' | 'outstreamDesktop' | 'outstreamGoogleDesktop' | 'outstreamMobile' | 'portrait' | 'portraitInterstitial' | 'pubmaticInterscroller' | 'skyscraper' | 'sponsorLogo';
+type SlotName = 'article-end' | 'carrot' | 'comments-expanded' | 'comments' | 'crossword-banner-mobile' | 'exclusion' | 'external' | 'fronts-banner' | 'inline' | 'liveblog-top' | 'merchandising-high' | 'merchandising' | 'mobile-sticky' | 'football-right' | 'mostpop' | 'right' | 'sponsor-logo' | 'survey' | 'top-above-nav' | 'interactive';
+type SizeMapping = Partial<Record<Breakpoint, readonly AdSize[]>>;
 type SlotSizeMappings = Record<SlotName, SizeMapping>;
 declare const createAdSize: (width: number, height: number) => AdSize;
 declare const standardAdSizes: {
@@ -45,16 +45,158 @@ declare const outstreamSizes: {
     outstreamGoogleDesktop: AdSize;
     outstreamMobile: AdSize;
 };
-declare const adSizes: Record<SizeKeys, AdSize>;
+declare const adSizes: {
+    readonly empty: AdSize;
+    readonly fabric: AdSize;
+    readonly merchandising: AdSize;
+    readonly merchandisingHigh: AdSize;
+    readonly merchandisingHighAdFeature: AdSize;
+    readonly sponsorLogo: AdSize;
+    readonly fluid: AdSize;
+    readonly googleCard: AdSize;
+    readonly outOfPage: AdSize;
+    readonly pubmaticInterscroller: AdSize;
+    readonly outstreamDesktop: AdSize;
+    readonly outstreamGoogleDesktop: AdSize;
+    readonly outstreamMobile: AdSize;
+    readonly '970x250': AdSize;
+    readonly '300x600': AdSize;
+    readonly '728x90': AdSize;
+    readonly '300x250': AdSize;
+    readonly '300x1050': AdSize;
+    readonly '160x600': AdSize;
+    readonly billboard: AdSize;
+    readonly halfPage: AdSize;
+    readonly leaderboard: AdSize;
+    readonly mobilesticky: AdSize;
+    readonly mpu: AdSize;
+    readonly portrait: AdSize;
+    readonly skyscraper: AdSize;
+    readonly cascade: AdSize;
+    readonly portraitInterstitial: AdSize;
+};
 /**
  * mark: 432b3a46-90c1-4573-90d3-2400b51af8d0
  * Some of these may or may not need to be synced for with the sizes in ./create-ad-slot.ts
  * these were originally from DCR, create-ad-slot.ts ones were in frontend.
+ *
+ * Note:
+ * If a breakpoint is not defined in a size mapping for a slot, that breakpoint will use the sizes
+ * of the next breakpoint down that has a size mapping. For example, if only "mobile" and "phablet" sizes
+ * are defined for a slot, all breakpoints larger than "phablet" will use the mapping for "phablet".
+ *
+ * In another example, if a slot has only "tablet" as a size mapping defined,
+ * then "desktop" will use the size mapping for "tablet". "mobile" and "phablet"
+ * will have no size mapping. This type of example may be used in cases where
+ * we only want the slot to appear on the "tablet" size or greater.
  **/
-declare const slotSizeMappings: SlotSizeMappings;
+declare const slotSizeMappings: {
+    readonly inline: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly right: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly comments: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'comments-expanded': {
+        readonly mobile: readonly [AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'top-above-nav': {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly tablet: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'fronts-banner': {
+        readonly tablet: readonly [AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly mostpop: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly phablet: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly tablet: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'liveblog-top': {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize];
+        readonly tablet: readonly [];
+        readonly desktop: readonly [];
+    };
+    readonly 'merchandising-high': {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly tablet: readonly [AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly merchandising: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+        readonly tablet: readonly [AdSize, AdSize, AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly survey: {
+        readonly desktop: readonly [AdSize];
+    };
+    readonly carrot: {
+        readonly mobile: readonly [AdSize];
+    };
+    readonly 'mobile-sticky': {
+        readonly mobile: readonly [AdSize, AdSize, AdSize];
+    };
+    readonly 'crossword-banner-mobile': {
+        readonly mobile: readonly [AdSize];
+    };
+    readonly 'football-right': {
+        readonly desktop: readonly [AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'article-end': {
+        readonly mobile: readonly [];
+    };
+    readonly exclusion: {
+        readonly mobile: readonly [AdSize];
+    };
+    /**
+     * @deprecated Use `slotSizeMappings['sponsor-logo']` instead
+     */
+    readonly external: {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly 'sponsor-logo': {
+        readonly mobile: readonly [AdSize, AdSize, AdSize, AdSize];
+    };
+    readonly interactive: {
+        readonly mobile: readonly [AdSize, AdSize];
+        readonly tablet: readonly [AdSize, AdSize];
+        readonly desktop: readonly [AdSize, AdSize];
+    };
+};
 declare const getAdSize: (size: SizeKeys) => AdSize;
+/**
+ * Finds the ad sizes that will be used for a breakpoint given a size mapping
+ *
+ * If ad sizes are defined in the size mapping for the specified breakpoint, we use that.
+ * If no sizes are defined for the breakpoint, use the next smallest breakpoint with defined ad sizes.
+ * If no smaller breakpoints have defined ad sizes, return an empty array
+ *
+ * Example:
+ * For the following slotSizeMappings:
+ *     inline: {
+ *         phablet: [adSizes.mpu],
+ *         desktop: [adSizes.billboard]
+ *     }
+ * the applied sizes for each breakpoint for the "inline" slot will be:
+ *     mobile: []
+ *     phablet: [adSizes.mpu]
+ *     tablet: [adSizes.mpu]
+ *     desktop: [adSizes.billboard]
+ *
+ * See ad-sizes.test.ts for more examples
+ */
+declare const findAppliedSizesForBreakpoint: (sizeMappings: SizeMapping, breakpoint: Breakpoint) => readonly AdSize[];
 export declare const _: {
     createAdSize: (width: number, height: number) => AdSize;
 };
-export type { AdSizeString, AdSize, SizeKeys, SizeMapping, SlotSizeMappings, SlotName, };
-export { adSizes, standardAdSizes, outstreamSizes, getAdSize, slotSizeMappings, createAdSize, };
+export type { AdSizeString, SizeKeys, SizeMapping, SlotSizeMappings, SlotName };
+export { AdSize, adSizes, standardAdSizes, outstreamSizes, getAdSize, slotSizeMappings, createAdSize, findAppliedSizesForBreakpoint, };