/**
 * @license
 *-------------------------------------------------------------------------------------------
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the package root for more information
 *-------------------------------------------------------------------------------------------
 */
import { PackageMetadata } from '@progress/kendo-licensing';
import { LicenseMessage } from '../validate-package.js';
import * as React from 'react';
/**
 * @hidden
 *
 * Return type for the `usePaidChildrenWatermark` hook.
 */
export interface PaidChildrenWatermarkResult {
    showWatermark: boolean;
    licenseMessage: LicenseMessage | undefined;
}
/**
 * @hidden
 *
 * Detects whether a free wrapper component contains paid children that render
 * a watermark overlay, and derives the licensing state accordingly.
 *
 * The detection works by scanning the container for `[data-kendo-watermark]`
 * elements whose parent is **not** the container itself — this distinguishes
 * watermarks rendered by nested paid components from the wrapper's own
 * watermark (which is a direct child).
 *
 * @param containerRef - Ref to the wrapper component's root DOM element.
 * @param packageMetadata - The package metadata object used for license validation.
 * @param componentName - The display name passed to `validatePackage`.
 *
 * @returns `{ showWatermark, licenseMessage }` — ready to pass to `<WatermarkOverlay />`.
 */
export declare function usePaidChildrenWatermark(containerRef: React.RefObject<HTMLElement | null>, packageMetadata: PackageMetadata, componentName: string): PaidChildrenWatermarkResult;