import * as react from 'react';

/**
 * Core configuration props for the Pioneer Point Status Widget.
 *
 * The host page (`/widget/pioneer-point-status`) reads its data from the
 * authenticated user's profile, which is populated via the `AUTH_TOKEN`
 * postMessage handshake. It does not currently honor URL-based theming
 * parameters, so this widget exposes only the standard set of props.
 */
interface PioneerPointStatusWidgetProps {
    /** Base URL of the Legion application (required) */
    baseUrl: string;
    /** JWT auth token (sent via postMessage, never via URL) */
    authToken?: string;
    /** Theme preset. Default: "light" */
    theme?: "light" | "dark";
    /** Widget width CSS value. Default: "100%" */
    width?: string;
    /** Widget height CSS value. Default: "180px" */
    height?: string;
    /** Additional CSS class name for the container */
    className?: string;
    /** Additional inline styles for the container */
    style?: React.CSSProperties;
    /** Callback when the widget iframe has loaded */
    onLoad?: (detail: {
        widget: string;
        theme: string;
    }) => void;
    /** Callback when the widget iframe fails to load */
    onError?: (message: string) => void;
}

/**
 * Ref handle exposed by LegionPioneerPointStatus for imperative control.
 */
interface LegionPioneerPointStatusHandle {
    /** Reload the widget iframe */
    refresh: () => void;
}
/**
 * Build the iframe src URL from widget props.
 */
declare function buildPioneerPointStatusWidgetUrl(props: PioneerPointStatusWidgetProps): string;
/**
 * LegionPioneerPointStatus – a React component that embeds the Legion
 * Pioneer Point Status widget via an iframe.
 *
 * @example
 * ```tsx
 * import { LegionPioneerPointStatus } from '@legionhandtech/lht-react-widgets';
 *
 * function App() {
 *   return (
 *     <LegionPioneerPointStatus
 *       baseUrl="https://your-legion-domain.com"
 *       authToken="your-jwt-token"
 *       theme="light"
 *     />
 *   );
 * }
 * ```
 */
declare const LegionPioneerPointStatus: react.ForwardRefExoticComponent<PioneerPointStatusWidgetProps & react.RefAttributes<LegionPioneerPointStatusHandle>>;

export { LegionPioneerPointStatus, type LegionPioneerPointStatusHandle, type PioneerPointStatusWidgetProps, buildPioneerPointStatusWidgetUrl };