@core-ease/telegram-kit 3.0.1

package/dist/sdk/index.d.mts

@@ -0,0 +1,322 @@
+import { b as WebAppKernel, c as SafeAreaInset, P as PopupParams, d as ScanQrPopupParams, e as HomeScreenStatus, D as DownloadFileParams, S as ShareToStoryParams, I as InitParams, O as OpenLinkOptions, f as OpenTelegramLinkOptions, g as TelegramWebView, a as WebApp } from '../webapp-B-3_74nK.mjs';
+export { A as Accelerometer, h as AnyRecord, B as BackButton, i as BiometricAuthenticateParams, j as BiometricManager, k as BiometricRequestAccessParams, l as BiometricType, m as BottomButton, n as BottomButtonParams, o as BottomButtonPosition, p as CloseOptions, q as CloudStorage, C as ColorScheme, r as DebugBottomBar, s as DefaultColors, t as DeviceOrientation, u as DeviceOrientationStartParams, v as DeviceStorage, E as ErrCallback, w as EventHandler, G as Gyroscope, H as HapticFeedback, x as HapticImpactStyle, y as HapticNotificationType, z as ItemsCallback, L as LocationData, F as LocationManager, M as MotionSensorStartParams, J as PopupButton, K as PopupButtonType, N as SecureStorage, Q as SettingsButton, R as ShareToStoryWidgetLink, U as ThemeManager, T as ThemeParams, V as Utils, X as VoidCallback, Y as WebAppChat, Z as WebAppInitDataUnsafe, W as WebAppUser } from '../webapp-B-3_74nK.mjs';
+
+/**
+ * The original SDK throws plain `Error('SomeName')` objects. We keep the
+ * exact same string names (so existing error-handling code that matches on
+ * `error.message` keeps working) but expose them as a typed enum plus a
+ * small helper so call sites read better than magic strings.
+ */
+declare enum WebAppErrorName {
+    MethodUnsupported = "WebAppMethodUnsupported",
+    DataInvalid = "WebAppDataInvalid",
+    InlineModeDisabled = "WebAppInlineModeDisabled",
+    InlineQueryInvalid = "WebAppInlineQueryInvalid",
+    InlineChooseChatTypesInvalid = "WebAppInlineChooseChatTypesInvalid",
+    InlineChooseChatTypeInvalid = "WebAppInlineChooseChatTypeInvalid",
+    TgUrlInvalid = "WebAppTgUrlInvalid",
+    InvoiceUrlInvalid = "WebAppInvoiceUrlInvalid",
+    InvoiceOpened = "WebAppInvoiceOpened",
+    PopupOpened = "WebAppPopupOpened",
+    PopupParamInvalid = "WebAppPopupParamInvalid",
+    ScanQrPopupOpened = "WebAppScanQrPopupOpened",
+    ScanQrPopupParamInvalid = "WebAppScanQrPopupParamInvalid",
+    WriteAccessRequested = "WebAppWriteAccessRequested",
+    ContactRequested = "WebAppContactRequested",
+    DownloadFilePopupOpened = "WebAppDownloadFilePopupOpened",
+    DownloadFileParamInvalid = "WebAppDownloadFileParamInvalid",
+    MediaUrlInvalid = "WebAppMediaUrlInvalid",
+    ShareToStoryParamInvalid = "WebAppShareToStoryParamInvalid",
+    ShareMessageOpened = "WebAppShareMessageOpened",
+    RequestChatOpened = "WebAppRequestChatOpened",
+    EmojiStatusRequested = "WebAppEmojiStatusRequested",
+    EmojiStatusAccessRequested = "WebAppEmojiStatusAccessRequested",
+    HeaderColorInvalid = "WebAppHeaderColorInvalid",
+    HeaderColorKeyInvalid = "WebAppHeaderColorKeyInvalid",
+    BackgroundColorInvalid = "WebAppBackgroundColorInvalid",
+    BottomBarColorInvalid = "WebAppBottomBarColorInvalid",
+    BottomButtonParamInvalid = "WebAppBottomButtonParamInvalid",
+    HapticImpactStyleInvalid = "WebAppHapticImpactStyleInvalid",
+    HapticNotificationTypeInvalid = "WebAppHapticNotificationTypeInvalid",
+    HapticFeedbackTypeInvalid = "WebAppHapticFeedbackTypeInvalid",
+    BiometricManagerNotInited = "WebAppBiometricManagerNotInited",
+    BiometricManagerBiometricsNotAvailable = "WebAppBiometricManagerBiometricsNotAvailable",
+    BiometricManagerAccessRequested = "WebAppBiometricManagerAccessRequested",
+    BiometricManagerBiometricAccessNotGranted = "WebAppBiometricManagerBiometricAccessNotGranted",
+    BiometricManagerAuthenticationRequested = "WebAppBiometricManagerAuthenticationRequested",
+    BiometricManagerTokenInvalid = "WebAppBiometricManagerTokenInvalid",
+    BiometricManagerTokenUpdateRequested = "WebAppBiometricManagerTokenUpdateRequested",
+    BiometricManagerBiometricsAccessNotRequested = "WebAppBiometricManagerBiometricsAccessNotRequested",
+    BiometricRequestAccessParamInvalid = "WebAppBiometricRequestAccessParamInvalid",
+    LocationManagerNotInited = "WebAppLocationManagerNotInited",
+    LocationManagerLocationNotAvailable = "WebAppLocationManagerLocationNotAvailable",
+    LocationManagerLocationAccessNotRequested = "WebAppLocationManagerLocationAccessNotRequested",
+    CallbackIdGenerateFailed = "WebAppCallbackIdGenerateFailed"
+}
+declare class WebAppError extends Error {
+    constructor(name: WebAppErrorName);
+}
+
+/**
+ * Viewport & window-chrome manager.
+ *
+ * Covers everything related to the app's visible area and window behavior:
+ * viewport height/expansion, safe-area insets, fullscreen state,
+ * orientation lock, the closing confirmation dialog and vertical swipe
+ * toggling. All of it was interleaved with theme code in the original
+ * single closure; split out here since it is a clearly separate concern.
+ */
+
+declare class ViewportManager {
+    private readonly kernel;
+    private viewportHeightPx;
+    private viewportStableHeightPx;
+    private _isExpanded;
+    private _safeAreaInset;
+    private _contentSafeAreaInset;
+    private _isFullscreen;
+    private _isOrientationLocked;
+    private _isClosingConfirmationEnabled;
+    private _isVerticalSwipesEnabled;
+    private lastWindowHeight;
+    constructor(kernel: WebAppKernel);
+    get isExpanded(): boolean;
+    get viewportHeight(): number;
+    get viewportStableHeight(): number;
+    get safeAreaInset(): SafeAreaInset;
+    get contentSafeAreaInset(): SafeAreaInset;
+    get isFullscreen(): boolean;
+    get isOrientationLocked(): boolean;
+    get isClosingConfirmationEnabled(): boolean;
+    get isVerticalSwipesEnabled(): boolean;
+    /** Re-applies the current viewport CSS vars; call after bottom-bar height changes too. */
+    setViewportHeight(data?: {
+        height: number;
+        is_expanded?: boolean;
+        is_state_stable?: boolean;
+    }): void;
+    handleViewportChanged: (_eventType: string, eventData: any) => void;
+    onWindowResize(): void;
+    setSafeAreaInset(data?: Partial<SafeAreaInset>): void;
+    handleSafeAreaChanged: (_eventType: string, eventData: any) => void;
+    setContentSafeAreaInset(data?: Partial<SafeAreaInset>): void;
+    handleContentSafeAreaChanged: (_eventType: string, eventData: any) => void;
+    setClosingConfirmation(needConfirmation: boolean): void;
+    toggleVerticalSwipes(enableSwipes: boolean): void;
+    private setFullscreen;
+    handleFullscreenChanged: (_eventType: string, eventData: any) => void;
+    handleFullscreenFailed: (_eventType: string, eventData: any) => void;
+    requestFullscreen(): void;
+    exitFullscreen(): void;
+    private setOrientationLock;
+    toggleOrientationLock(locked: boolean): void;
+}
+
+/**
+ * `WebApp.showPopup` / `showAlert` / `showConfirm`.
+ */
+
+type PopupCallback = (buttonId: string | null) => void;
+type AlertCallback = () => void;
+type ConfirmCallback = (ok: boolean) => void;
+declare class PopupManager {
+    private readonly kernel;
+    private pending;
+    constructor(kernel: WebAppKernel);
+    private handlePopupClosed;
+    showPopup(params: PopupParams, callback?: PopupCallback): void;
+    showAlert(message: string, callback?: AlertCallback): void;
+    showConfirm(message: string, callback?: ConfirmCallback): void;
+}
+
+/**
+ * `WebApp.showScanQrPopup` / `closeScanQrPopup`.
+ */
+
+/** Return `true` from the callback to close the popup automatically. */
+type ScanQrCallback = (data: string | null) => boolean | void;
+declare class ScanQrManager {
+    private readonly kernel;
+    private pending;
+    constructor(kernel: WebAppKernel);
+    private handleQrTextReceived;
+    private handleScanQrPopupClosed;
+    showScanQrPopup(params: ScanQrPopupParams, callback?: ScanQrCallback): void;
+    closeScanQrPopup(): void;
+}
+
+/**
+ * `WebApp.openInvoice`.
+ */
+
+type InvoiceStatus = 'paid' | 'cancelled' | 'failed' | 'pending';
+type InvoiceCallback = (status: InvoiceStatus) => void;
+declare class InvoiceManager {
+    private readonly kernel;
+    private openInvoices;
+    constructor(kernel: WebAppKernel);
+    private handleInvoiceClosed;
+    openInvoice(url: string, callback?: InvoiceCallback): void;
+}
+
+/**
+ * `WebApp.readTextFromClipboard`.
+ */
+
+type ClipboardCallback = (data: string | null) => void;
+declare class ClipboardManager {
+    private readonly kernel;
+    constructor(kernel: WebAppKernel);
+    private handleClipboardTextReceived;
+    readTextFromClipboard(callback?: ClipboardCallback): void;
+}
+
+/**
+ * `WebApp.requestWriteAccess` / `WebApp.requestContact`.
+ */
+
+type WriteAccessCallback = (granted: boolean) => void;
+type ContactCallback = (sent: boolean, eventPayload: Record<string, any>) => void;
+declare class ContactManager {
+    private readonly kernel;
+    private writeAccessRequested;
+    private contactRequested;
+    constructor(kernel: WebAppKernel);
+    private handleWriteAccessRequested;
+    private handlePhoneRequested;
+    requestWriteAccess(callback?: WriteAccessCallback): void;
+    requestContact(callback?: ContactCallback): void;
+}
+
+/**
+ * `WebApp.addToHomeScreen` / `WebApp.checkHomeScreenStatus`.
+ */
+
+type StatusCallback = (status: HomeScreenStatus) => void;
+declare class HomeScreenManager {
+    private readonly kernel;
+    private statusCallbacks;
+    constructor(kernel: WebAppKernel);
+    private handleAdded;
+    private handleChecked;
+    addToHomeScreen(): void;
+    checkHomeScreenStatus(callback?: StatusCallback): void;
+}
+
+/**
+ * `WebApp.downloadFile`.
+ */
+
+type DownloadCallback = (isDownloading: boolean) => void;
+declare class DownloadFileManager {
+    private readonly kernel;
+    private requested;
+    constructor(kernel: WebAppKernel);
+    private handleFileDownloadRequested;
+    downloadFile(params: DownloadFileParams, callback?: DownloadCallback): void;
+}
+
+/**
+ * Sharing-related surface: `shareToStory`, `shareMessage`, `requestChat`,
+ * `switchInlineQuery`.
+ */
+
+type SentCallback = (sent: boolean) => void;
+declare class SharingManager {
+    private readonly kernel;
+    private shareMessageOpened;
+    private requestChatOpened;
+    constructor(kernel: WebAppKernel);
+    private handlePreparedMessageSent;
+    private handlePreparedMessageFailed;
+    private handleRequestedChatSent;
+    private handleRequestedChatFailed;
+    shareToStory(mediaUrl: string, params?: ShareToStoryParams): void;
+    shareMessage(msgId: string, callback?: SentCallback): void;
+    requestChat(reqId: string, callback?: SentCallback): void;
+    switchInlineQuery(query: string, chooseChatTypes: string[] | undefined, initParams: InitParams): void;
+}
+
+/**
+ * `WebApp.setEmojiStatus` / `WebApp.requestEmojiStatusAccess`.
+ */
+
+type SetStatusCallback = (applied: boolean) => void;
+type AccessCallback = (granted: boolean) => void;
+declare class EmojiStatusManager {
+    private readonly kernel;
+    private setRequested;
+    private accessRequested;
+    constructor(kernel: WebAppKernel);
+    private handleSet;
+    private handleFailed;
+    private handleAccessRequested;
+    setEmojiStatus(customEmojiId: string, params?: {
+        duration?: number;
+    }, callback?: SetStatusCallback): void;
+    requestEmojiStatusAccess(callback?: AccessCallback): void;
+}
+
+/**
+ * `WebApp.openLink` / `WebApp.openTelegramLink` + the iframe `<a href="t.me/...">`
+ * click interception (`linkHandler` in the original script).
+ */
+
+declare class LinkManager {
+    private readonly kernel;
+    constructor(kernel: WebAppKernel);
+    openLink(url: string, options?: OpenLinkOptions): void;
+    openTelegramLink(url: string, options?: OpenTelegramLinkOptions): void;
+    /**
+     * Intercepts clicks on in-page `t.me` links while running inside an
+     * iframe (web.telegram.org) and routes them through `openTelegramLink`
+     * instead of letting the browser navigate directly.
+     */
+    handleDocumentClick: (e: MouseEvent) => void;
+}
+
+/**
+ * `@core-ease/telegram-kit/sdk` - public entry point of the bundled Mini
+ * Apps SDK.
+ *
+ * Everything that actually implements the protocol lives under
+ * `./_internal/` (transport, kernel, theme, ui, features, sensors) and is
+ * considered an implementation detail - import from here, not from
+ * `./_internal/*` directly.
+ *
+ * Calling {@link bootstrapTelegramWebApp} reproduces exactly what the
+ * original `telegram-web-app.js` did when loaded as a `<script>` tag:
+ *   1. Set up `window.Telegram.WebView` (transport + event bus) and
+ *      `window.Telegram.Utils`.
+ *   2. Set up `window.Telegram.WebApp` (the full public API).
+ *
+ * Unlike the very first version of this SDK, bootstrapping is **lazy**
+ * (it does not run automatically just from importing this module). This
+ * lets `core/dev.ts` seed fake init data into session storage *before* the
+ * bridge is constructed, so local/dev-mode "just works" through the exact
+ * same code path as running inside real Telegram - no parallel mock
+ * implementation needed. In practice you never have to think about this:
+ * `getWebApp()` in `core/index.ts` calls {@link bootstrapTelegramWebApp}
+ * for you on first use.
+ */
+
+declare const SDK_NAME = "@core-ease/telegram-kit";
+/**
+ * Runs the SDK bootstrap exactly once (idempotent) and exposes
+ * `window.Telegram.{WebView,Utils,WebApp}`. Safe to call in non-browser
+ * contexts (returns nothing useful but never throws), so it's safe to wire
+ * into SSR code paths.
+ *
+ * This is normally called for you by `getWebApp()` in `core/index.ts` the
+ * first time any @core-ease/telegram-kit function is used - you only need to call it
+ * yourself if you want direct, typed access to the `WebApp`/`TelegramWebView`
+ * instances instead of going through the `core`/`hooks` convenience layer.
+ */
+declare function bootstrapTelegramWebApp(): {
+    webView: TelegramWebView;
+    webApp: WebApp;
+};
+/** True once {@link bootstrapTelegramWebApp} has run at least once. */
+declare function isBootstrapped(): boolean;
+
+export { ClipboardManager, ContactManager, DownloadFileManager, DownloadFileParams, EmojiStatusManager, HomeScreenManager, HomeScreenStatus, InitParams, InvoiceManager, LinkManager, OpenLinkOptions, OpenTelegramLinkOptions, PopupManager, PopupParams, SDK_NAME, SafeAreaInset, ScanQrManager, ScanQrPopupParams, ShareToStoryParams, SharingManager, TelegramWebView, ViewportManager, WebApp, WebAppError, WebAppErrorName, WebAppKernel, bootstrapTelegramWebApp, isBootstrapped };

package/dist/sdk/index.d.ts

@@ -0,0 +1,322 @@
+import { b as WebAppKernel, c as SafeAreaInset, P as PopupParams, d as ScanQrPopupParams, e as HomeScreenStatus, D as DownloadFileParams, S as ShareToStoryParams, I as InitParams, O as OpenLinkOptions, f as OpenTelegramLinkOptions, g as TelegramWebView, a as WebApp } from '../webapp-B-3_74nK.js';
+export { A as Accelerometer, h as AnyRecord, B as BackButton, i as BiometricAuthenticateParams, j as BiometricManager, k as BiometricRequestAccessParams, l as BiometricType, m as BottomButton, n as BottomButtonParams, o as BottomButtonPosition, p as CloseOptions, q as CloudStorage, C as ColorScheme, r as DebugBottomBar, s as DefaultColors, t as DeviceOrientation, u as DeviceOrientationStartParams, v as DeviceStorage, E as ErrCallback, w as EventHandler, G as Gyroscope, H as HapticFeedback, x as HapticImpactStyle, y as HapticNotificationType, z as ItemsCallback, L as LocationData, F as LocationManager, M as MotionSensorStartParams, J as PopupButton, K as PopupButtonType, N as SecureStorage, Q as SettingsButton, R as ShareToStoryWidgetLink, U as ThemeManager, T as ThemeParams, V as Utils, X as VoidCallback, Y as WebAppChat, Z as WebAppInitDataUnsafe, W as WebAppUser } from '../webapp-B-3_74nK.js';
+
+/**
+ * The original SDK throws plain `Error('SomeName')` objects. We keep the
+ * exact same string names (so existing error-handling code that matches on
+ * `error.message` keeps working) but expose them as a typed enum plus a
+ * small helper so call sites read better than magic strings.
+ */
+declare enum WebAppErrorName {
+    MethodUnsupported = "WebAppMethodUnsupported",
+    DataInvalid = "WebAppDataInvalid",
+    InlineModeDisabled = "WebAppInlineModeDisabled",
+    InlineQueryInvalid = "WebAppInlineQueryInvalid",
+    InlineChooseChatTypesInvalid = "WebAppInlineChooseChatTypesInvalid",
+    InlineChooseChatTypeInvalid = "WebAppInlineChooseChatTypeInvalid",
+    TgUrlInvalid = "WebAppTgUrlInvalid",
+    InvoiceUrlInvalid = "WebAppInvoiceUrlInvalid",
+    InvoiceOpened = "WebAppInvoiceOpened",
+    PopupOpened = "WebAppPopupOpened",
+    PopupParamInvalid = "WebAppPopupParamInvalid",
+    ScanQrPopupOpened = "WebAppScanQrPopupOpened",
+    ScanQrPopupParamInvalid = "WebAppScanQrPopupParamInvalid",
+    WriteAccessRequested = "WebAppWriteAccessRequested",
+    ContactRequested = "WebAppContactRequested",
+    DownloadFilePopupOpened = "WebAppDownloadFilePopupOpened",
+    DownloadFileParamInvalid = "WebAppDownloadFileParamInvalid",
+    MediaUrlInvalid = "WebAppMediaUrlInvalid",
+    ShareToStoryParamInvalid = "WebAppShareToStoryParamInvalid",
+    ShareMessageOpened = "WebAppShareMessageOpened",
+    RequestChatOpened = "WebAppRequestChatOpened",
+    EmojiStatusRequested = "WebAppEmojiStatusRequested",
+    EmojiStatusAccessRequested = "WebAppEmojiStatusAccessRequested",
+    HeaderColorInvalid = "WebAppHeaderColorInvalid",
+    HeaderColorKeyInvalid = "WebAppHeaderColorKeyInvalid",
+    BackgroundColorInvalid = "WebAppBackgroundColorInvalid",
+    BottomBarColorInvalid = "WebAppBottomBarColorInvalid",
+    BottomButtonParamInvalid = "WebAppBottomButtonParamInvalid",
+    HapticImpactStyleInvalid = "WebAppHapticImpactStyleInvalid",
+    HapticNotificationTypeInvalid = "WebAppHapticNotificationTypeInvalid",
+    HapticFeedbackTypeInvalid = "WebAppHapticFeedbackTypeInvalid",
+    BiometricManagerNotInited = "WebAppBiometricManagerNotInited",
+    BiometricManagerBiometricsNotAvailable = "WebAppBiometricManagerBiometricsNotAvailable",
+    BiometricManagerAccessRequested = "WebAppBiometricManagerAccessRequested",
+    BiometricManagerBiometricAccessNotGranted = "WebAppBiometricManagerBiometricAccessNotGranted",
+    BiometricManagerAuthenticationRequested = "WebAppBiometricManagerAuthenticationRequested",
+    BiometricManagerTokenInvalid = "WebAppBiometricManagerTokenInvalid",
+    BiometricManagerTokenUpdateRequested = "WebAppBiometricManagerTokenUpdateRequested",
+    BiometricManagerBiometricsAccessNotRequested = "WebAppBiometricManagerBiometricsAccessNotRequested",
+    BiometricRequestAccessParamInvalid = "WebAppBiometricRequestAccessParamInvalid",
+    LocationManagerNotInited = "WebAppLocationManagerNotInited",
+    LocationManagerLocationNotAvailable = "WebAppLocationManagerLocationNotAvailable",
+    LocationManagerLocationAccessNotRequested = "WebAppLocationManagerLocationAccessNotRequested",
+    CallbackIdGenerateFailed = "WebAppCallbackIdGenerateFailed"
+}
+declare class WebAppError extends Error {
+    constructor(name: WebAppErrorName);
+}
+
+/**
+ * Viewport & window-chrome manager.
+ *
+ * Covers everything related to the app's visible area and window behavior:
+ * viewport height/expansion, safe-area insets, fullscreen state,
+ * orientation lock, the closing confirmation dialog and vertical swipe
+ * toggling. All of it was interleaved with theme code in the original
+ * single closure; split out here since it is a clearly separate concern.
+ */
+
+declare class ViewportManager {
+    private readonly kernel;
+    private viewportHeightPx;
+    private viewportStableHeightPx;
+    private _isExpanded;
+    private _safeAreaInset;
+    private _contentSafeAreaInset;
+    private _isFullscreen;
+    private _isOrientationLocked;
+    private _isClosingConfirmationEnabled;
+    private _isVerticalSwipesEnabled;
+    private lastWindowHeight;
+    constructor(kernel: WebAppKernel);
+    get isExpanded(): boolean;
+    get viewportHeight(): number;
+    get viewportStableHeight(): number;
+    get safeAreaInset(): SafeAreaInset;
+    get contentSafeAreaInset(): SafeAreaInset;
+    get isFullscreen(): boolean;
+    get isOrientationLocked(): boolean;
+    get isClosingConfirmationEnabled(): boolean;
+    get isVerticalSwipesEnabled(): boolean;
+    /** Re-applies the current viewport CSS vars; call after bottom-bar height changes too. */
+    setViewportHeight(data?: {
+        height: number;
+        is_expanded?: boolean;
+        is_state_stable?: boolean;
+    }): void;
+    handleViewportChanged: (_eventType: string, eventData: any) => void;
+    onWindowResize(): void;
+    setSafeAreaInset(data?: Partial<SafeAreaInset>): void;
+    handleSafeAreaChanged: (_eventType: string, eventData: any) => void;
+    setContentSafeAreaInset(data?: Partial<SafeAreaInset>): void;
+    handleContentSafeAreaChanged: (_eventType: string, eventData: any) => void;
+    setClosingConfirmation(needConfirmation: boolean): void;
+    toggleVerticalSwipes(enableSwipes: boolean): void;
+    private setFullscreen;
+    handleFullscreenChanged: (_eventType: string, eventData: any) => void;
+    handleFullscreenFailed: (_eventType: string, eventData: any) => void;
+    requestFullscreen(): void;
+    exitFullscreen(): void;
+    private setOrientationLock;
+    toggleOrientationLock(locked: boolean): void;
+}
+
+/**
+ * `WebApp.showPopup` / `showAlert` / `showConfirm`.
+ */
+
+type PopupCallback = (buttonId: string | null) => void;
+type AlertCallback = () => void;
+type ConfirmCallback = (ok: boolean) => void;
+declare class PopupManager {
+    private readonly kernel;
+    private pending;
+    constructor(kernel: WebAppKernel);
+    private handlePopupClosed;
+    showPopup(params: PopupParams, callback?: PopupCallback): void;
+    showAlert(message: string, callback?: AlertCallback): void;
+    showConfirm(message: string, callback?: ConfirmCallback): void;
+}
+
+/**
+ * `WebApp.showScanQrPopup` / `closeScanQrPopup`.
+ */
+
+/** Return `true` from the callback to close the popup automatically. */
+type ScanQrCallback = (data: string | null) => boolean | void;
+declare class ScanQrManager {
+    private readonly kernel;
+    private pending;
+    constructor(kernel: WebAppKernel);
+    private handleQrTextReceived;
+    private handleScanQrPopupClosed;
+    showScanQrPopup(params: ScanQrPopupParams, callback?: ScanQrCallback): void;
+    closeScanQrPopup(): void;
+}
+
+/**
+ * `WebApp.openInvoice`.
+ */
+
+type InvoiceStatus = 'paid' | 'cancelled' | 'failed' | 'pending';
+type InvoiceCallback = (status: InvoiceStatus) => void;
+declare class InvoiceManager {
+    private readonly kernel;
+    private openInvoices;
+    constructor(kernel: WebAppKernel);
+    private handleInvoiceClosed;
+    openInvoice(url: string, callback?: InvoiceCallback): void;
+}
+
+/**
+ * `WebApp.readTextFromClipboard`.
+ */
+
+type ClipboardCallback = (data: string | null) => void;
+declare class ClipboardManager {
+    private readonly kernel;
+    constructor(kernel: WebAppKernel);
+    private handleClipboardTextReceived;
+    readTextFromClipboard(callback?: ClipboardCallback): void;
+}
+
+/**
+ * `WebApp.requestWriteAccess` / `WebApp.requestContact`.
+ */
+
+type WriteAccessCallback = (granted: boolean) => void;
+type ContactCallback = (sent: boolean, eventPayload: Record<string, any>) => void;
+declare class ContactManager {
+    private readonly kernel;
+    private writeAccessRequested;
+    private contactRequested;
+    constructor(kernel: WebAppKernel);
+    private handleWriteAccessRequested;
+    private handlePhoneRequested;
+    requestWriteAccess(callback?: WriteAccessCallback): void;
+    requestContact(callback?: ContactCallback): void;
+}
+
+/**
+ * `WebApp.addToHomeScreen` / `WebApp.checkHomeScreenStatus`.
+ */
+
+type StatusCallback = (status: HomeScreenStatus) => void;
+declare class HomeScreenManager {
+    private readonly kernel;
+    private statusCallbacks;
+    constructor(kernel: WebAppKernel);
+    private handleAdded;
+    private handleChecked;
+    addToHomeScreen(): void;
+    checkHomeScreenStatus(callback?: StatusCallback): void;
+}
+
+/**
+ * `WebApp.downloadFile`.
+ */
+
+type DownloadCallback = (isDownloading: boolean) => void;
+declare class DownloadFileManager {
+    private readonly kernel;
+    private requested;
+    constructor(kernel: WebAppKernel);
+    private handleFileDownloadRequested;
+    downloadFile(params: DownloadFileParams, callback?: DownloadCallback): void;
+}
+
+/**
+ * Sharing-related surface: `shareToStory`, `shareMessage`, `requestChat`,
+ * `switchInlineQuery`.
+ */
+
+type SentCallback = (sent: boolean) => void;
+declare class SharingManager {
+    private readonly kernel;
+    private shareMessageOpened;
+    private requestChatOpened;
+    constructor(kernel: WebAppKernel);
+    private handlePreparedMessageSent;
+    private handlePreparedMessageFailed;
+    private handleRequestedChatSent;
+    private handleRequestedChatFailed;
+    shareToStory(mediaUrl: string, params?: ShareToStoryParams): void;
+    shareMessage(msgId: string, callback?: SentCallback): void;
+    requestChat(reqId: string, callback?: SentCallback): void;
+    switchInlineQuery(query: string, chooseChatTypes: string[] | undefined, initParams: InitParams): void;
+}
+
+/**
+ * `WebApp.setEmojiStatus` / `WebApp.requestEmojiStatusAccess`.
+ */
+
+type SetStatusCallback = (applied: boolean) => void;
+type AccessCallback = (granted: boolean) => void;
+declare class EmojiStatusManager {
+    private readonly kernel;
+    private setRequested;
+    private accessRequested;
+    constructor(kernel: WebAppKernel);
+    private handleSet;
+    private handleFailed;
+    private handleAccessRequested;
+    setEmojiStatus(customEmojiId: string, params?: {
+        duration?: number;
+    }, callback?: SetStatusCallback): void;
+    requestEmojiStatusAccess(callback?: AccessCallback): void;
+}
+
+/**
+ * `WebApp.openLink` / `WebApp.openTelegramLink` + the iframe `<a href="t.me/...">`
+ * click interception (`linkHandler` in the original script).
+ */
+
+declare class LinkManager {
+    private readonly kernel;
+    constructor(kernel: WebAppKernel);
+    openLink(url: string, options?: OpenLinkOptions): void;
+    openTelegramLink(url: string, options?: OpenTelegramLinkOptions): void;
+    /**
+     * Intercepts clicks on in-page `t.me` links while running inside an
+     * iframe (web.telegram.org) and routes them through `openTelegramLink`
+     * instead of letting the browser navigate directly.
+     */
+    handleDocumentClick: (e: MouseEvent) => void;
+}
+
+/**
+ * `@core-ease/telegram-kit/sdk` - public entry point of the bundled Mini
+ * Apps SDK.
+ *
+ * Everything that actually implements the protocol lives under
+ * `./_internal/` (transport, kernel, theme, ui, features, sensors) and is
+ * considered an implementation detail - import from here, not from
+ * `./_internal/*` directly.
+ *
+ * Calling {@link bootstrapTelegramWebApp} reproduces exactly what the
+ * original `telegram-web-app.js` did when loaded as a `<script>` tag:
+ *   1. Set up `window.Telegram.WebView` (transport + event bus) and
+ *      `window.Telegram.Utils`.
+ *   2. Set up `window.Telegram.WebApp` (the full public API).
+ *
+ * Unlike the very first version of this SDK, bootstrapping is **lazy**
+ * (it does not run automatically just from importing this module). This
+ * lets `core/dev.ts` seed fake init data into session storage *before* the
+ * bridge is constructed, so local/dev-mode "just works" through the exact
+ * same code path as running inside real Telegram - no parallel mock
+ * implementation needed. In practice you never have to think about this:
+ * `getWebApp()` in `core/index.ts` calls {@link bootstrapTelegramWebApp}
+ * for you on first use.
+ */
+
+declare const SDK_NAME = "@core-ease/telegram-kit";
+/**
+ * Runs the SDK bootstrap exactly once (idempotent) and exposes
+ * `window.Telegram.{WebView,Utils,WebApp}`. Safe to call in non-browser
+ * contexts (returns nothing useful but never throws), so it's safe to wire
+ * into SSR code paths.
+ *
+ * This is normally called for you by `getWebApp()` in `core/index.ts` the
+ * first time any @core-ease/telegram-kit function is used - you only need to call it
+ * yourself if you want direct, typed access to the `WebApp`/`TelegramWebView`
+ * instances instead of going through the `core`/`hooks` convenience layer.
+ */
+declare function bootstrapTelegramWebApp(): {
+    webView: TelegramWebView;
+    webApp: WebApp;
+};
+/** True once {@link bootstrapTelegramWebApp} has run at least once. */
+declare function isBootstrapped(): boolean;
+
+export { ClipboardManager, ContactManager, DownloadFileManager, DownloadFileParams, EmojiStatusManager, HomeScreenManager, HomeScreenStatus, InitParams, InvoiceManager, LinkManager, OpenLinkOptions, OpenTelegramLinkOptions, PopupManager, PopupParams, SDK_NAME, SafeAreaInset, ScanQrManager, ScanQrPopupParams, ShareToStoryParams, SharingManager, TelegramWebView, ViewportManager, WebApp, WebAppError, WebAppErrorName, WebAppKernel, bootstrapTelegramWebApp, isBootstrapped };