@types/telegram-web-app 6.9.3 → 7.0.0

telegram-web-app/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for telegram-web-app (https://telegram.or
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/telegram-web-app.
 
 ### Additional Details
- * Last updated: Tue, 07 Nov 2023 15:11:36 GMT
+ * Last updated: Sun, 04 Feb 2024 10:07:03 GMT
  * Dependencies: none
 
 # Credits

telegram-web-app/index.d.ts

@@ -100,6 +100,11 @@ interface WebApp {
      * bottom of the Web App in the Telegram interface.
      */
     MainButton: MainButton;
+    /**
+     * An object for controlling the Settings item in the context menu of the Mini App
+     * in the Telegram interface.
+     */
+    SettingsButton: SettingsButton;
     /**
      * An object for controlling haptic feedback.
      */
@@ -234,7 +239,7 @@ interface WebApp {
      * popup is closed and the first argument will be a boolean indicating whether the user
      * pressed the 'OK' button.
      */
-    showConfirm(message: string, callback?: (ok?: boolean) => void): void;
+    showConfirm(message: string, callback?: (ok: boolean) => void): void;
     /**
      * A method that shows a native popup for scanning a QR code described by the params argument of the type ScanQrPopupParams.
      * The Web App will receive the event qrTextReceived every time the scanner catches a code with text data.
@@ -302,40 +307,71 @@ interface WebApp {
  */
 interface ThemeParams {
     /**
-     * Background color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-bg-color).
+     * Background color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-bg-color)`.
+     */
+    bg_color?: string;
+    /**
+     * Main text color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-text-color)`.
+     */
+    text_color?: string;
+    /**
+     * Hint text color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-hint-color)`.
+     */
+    hint_color?: string;
+    /**
+     * Link color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-link-color)`.
      */
-    bg_color: string;
+    link_color?: string;
     /**
-     * Main text color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-text-color).
+     * Button color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-button-color)`.
      */
-    text_color: string;
+    button_color?: string;
     /**
-     * Hint text color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-hint-color).
+     * Button text color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-button-text-color)`.
      */
-    hint_color: string;
+    button_text_color?: string;
     /**
-     * Link color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-link-color).
+     * **Bot API 6.1+** Secondary background color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-secondary-bg-color)`.
      */
-    link_color: string;
+    secondary_bg_color?: string;
     /**
-     * Button color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-button-color).
+     * **Bot API 7.0+** Header background color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-header-bg-color)`.
      */
-    button_color: string;
+    header_bg_color?: string;
     /**
-     * Button text color in the #RRGGBB format. Also available as the CSS variable
-     * var(--tg-theme-button-text-color).
+     * **Bot API 7.0+** Accent text color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-accent-text-color)`.
      */
-    button_text_color: string;
+    accent_text_color?: string;
     /**
-     * Optional. Bot API 6.1+ Secondary background color in the #RRGGBB format.
-     * Also available as the CSS variable var(--tg-theme-secondary-bg-color).
+     * **Bot API 7.0+** Background color for the section in the `#RRGGBB` format. It is
+     * recommended to use this in conjunction with *secondary_bg_color*.
+     * Also available as the CSS variable `var(--tg-theme-section-bg-color)`.
      */
-    secondary_bg_color: string;
+    section_bg_color?: string;
+    /**
+     * **Bot API 7.0+** Header text color for the section in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-section-header-text-color)`.
+     */
+    section_header_text_color?: `#${string}`;
+    /**
+     * **Bot API 7.0+** Subtitle text color in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-subtitle-text-color)`.
+     */
+    subtitle_text_color?: string;
+    /**
+     * **Bot API 7.0+** Text color for destructive actions in the `#RRGGBB` format.
+     * Also available as the CSS variable `var(--tg-theme-destructive-text-color)`.
+     */
+    destructive_text_color?: string;
 }
 
 /**
@@ -496,6 +532,37 @@ interface MainButtonParams {
     is_visible?: boolean;
 }
 
+/**
+ * This object controls the Settings item in the context menu of the Mini App in the
+ * Telegram interface.
+ */
+interface SettingsButton {
+    /**
+     * Shows whether the context menu item is visible. Set to false by default.
+     */
+    isVisible: boolean;
+    /**
+     * **Bot API 7.0+** A method that sets the press event handler for the Settings item in
+     * the context menu. An alias for
+     * `Telegram.WebApp.onEvent('settingsButtonClicked', callback)`
+     */
+    onClick(callback: () => void): SettingsButton;
+    /**
+     * **Bot API 7.0+** A method that removes the press event handler from the Settings item
+     * in the context menu. An alias for
+     * `Telegram.WebApp.offEvent('settingsButtonClicked', callback)`
+     */
+    offClick(callback: () => void): SettingsButton;
+    /**
+     * **Bot API 7.0+** A method to make the Settings item in the context menu visible.
+     */
+    show(): SettingsButton;
+    /**
+     * **Bot API 7.0+** A method to hide the Settings item in the context menu.
+     */
+    hide(): SettingsButton;
+}
+
 /**
  *  This object controls haptic feedback.
  */

telegram-web-app/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/telegram-web-app",
-    "version": "6.9.3",
+    "version": "7.0.0",
     "description": "TypeScript definitions for telegram-web-app",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/telegram-web-app",
     "license": "MIT",
@@ -30,7 +30,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "643c9f2e4e2f451051a00f0ba45c9870a1ebe7232849e2e11fe0cc2cd0967824",
-    "typeScriptVersion": "4.5",
-    "nonNpm": true
+    "typesPublisherContentHash": "268c74054d2f36d843d570017d3e167f71be94be3621b7ad5e6ec33c95bd93be",
+    "typeScriptVersion": "4.6"
 }