@mtkruto/node 0.0.957 → 0.0.960

package/script/types/0_login_url.d.ts

@@ -2,10 +2,10 @@
 export interface LoginUrl {
     /** An HTTPS URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data). */
     url: string;
-    /** Optional. New text of the button in forwarded messages. */
+    /** New text of the button in forwarded messages. */
     forwardText?: string;
-    /** Optional. Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details. */
+    /** Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details. */
     botUsername?: string;
-    /** Optional. Pass True to request the permission for your bot to send messages to the user. */
+    /** Pass True to request the permission for your bot to send messages to the user. */
     requestWriteAccess?: boolean;
 }

package/script/types/0_mask_position.d.ts

@@ -1,8 +1,13 @@
 import * as types from "../tl/2_types.js";
+/** This object describes the position on faces where a mask should be placed by default. */
 export interface MaskPosition {
+    /** The part of the face relative to which the mask should be placed. One of "forehead", "eyes", "mouth", or "chin". */
     point: "forehead" | "eyes" | "mouth" | "chin";
+    /** Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position. */
     xShift: number;
+    /** Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position. */
     yShift: number;
+    /** Mask scaling coefficient. For example, 2.0 means double size. */
     scale: number;
 }
 export declare function constructMaskPosition({ n, x, y, zoom }: types.MaskCoords): MaskPosition;

package/script/types/0_message_entity.d.ts

@@ -50,7 +50,7 @@ export declare namespace MessageEntity {
     }
     interface Pre extends Base {
         type: MessageEntityType.Pre;
-        /** Optional. For “pre” only, the programming language of the entity text */
+        /** For “pre” only, the programming language of the entity text */
         language: string;
     }
     interface Code extends Base {
@@ -58,12 +58,12 @@ export declare namespace MessageEntity {
     }
     interface TextURL extends Base {
         type: MessageEntityType.TextURL;
-        /** Optional. For “text_link” only, URL that will be opened after user taps on the text */
+        /** For “text_link” only, URL that will be opened after user taps on the text */
         url: string;
     }
     interface MentionName extends Base {
         type: MessageEntityType.MentionName;
-        /** Optional. For “text_mention” only, the ID of the mentioned user */
+        /** For “text_mention” only, the ID of the mentioned user */
         userId: number;
     }
     interface Cashtag extends Base {
@@ -89,7 +89,7 @@ export declare namespace MessageEntity {
     }
     interface CustomEmoji extends Base {
         type: MessageEntityType.CustomEmoji;
-        /** Optional. For “custom_emoji” only, unique identifier of the custom emoji */
+        /** For “custom_emoji” only, unique identifier of the custom emoji */
         customEmojiId: string;
     }
 }

package/script/types/0_reply_keyboard_remove.d.ts

@@ -3,7 +3,7 @@ import * as types from "../tl/2_types.js";
 export interface ReplyKeyboardRemove {
     /** Requests clients to remove the custom keyboard (user will not be able to summon this keyboard; if you want to hide the keyboard from sight but keep it accessible, use _one_time_keyboard_ in `ReplyKeyboardMarkup`) */
     removeKeyboard: true;
-    /** Optional. Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has _reply_to_message_id_), sender of the original message. */
+    /** Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has _reply_to_message_id_), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardRemove(replyMarkup_: types.ReplyKeyboardHide): ReplyKeyboardRemove;

package/script/types/0_thumbnail.d.ts

@@ -1,4 +1,5 @@
 import * as types from "../tl/2_types.js";
+/** This object represents thumbnail of a file or a sticker. */
 export interface Thumbnail {
     /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
@@ -8,7 +9,7 @@ export interface Thumbnail {
     width: number;
     /** Photo height */
     height: number;
-    /** Optional. File size in bytes */
+    /** File size in bytes */
     fileSize: number;
 }
 export declare function constructThumbnail(size: types.PhotoSize, file: types.Document | types.Photo): Thumbnail;

package/script/types/0_venue.d.ts

@@ -1,10 +1,16 @@
 import * as types from "../tl/2_types.js";
 import { Location } from "./0_location.js";
+/**  */
 export interface Venue {
+    /** Venue location. Can't be a live location */
     location: Location;
+    /** Name of the venue */
     title: string;
+    /** Address of the venue */
     address: string;
+    /** Foursquare identifier of the venue */
     foursquareId?: string;
+    /** Foursquare type of the venue. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
     foursquareType?: string;
 }
 export declare function constructVenue(media_: types.MessageMediaVenue): Venue;

package/script/types/0_voice.d.ts

@@ -1,9 +1,15 @@
 import * as types from "../tl/2_types.js";
+/** This object represents a voice note. */
 export interface Voice {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Duration of the audio in seconds as defined by sender */
     duration: number;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructVoice(document: types.Document, audioAttributes: types.DocumentAttributeAudio, fileId: string, fileUniqueId: string): Voice;

package/script/types/1_animation.d.ts

@@ -1,14 +1,24 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound). */
 export interface Animation {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Video width as defined by sender */
     width: number;
+    /** Video height as defined by sender */
     height: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Animation thumbnail as defined by sender */
     thumbnails: Thumbnail[];
+    /** Original animation filename as defined by sender */
     fileName?: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructAnimation(document: types.Document, videoAttribute: types.DocumentAttributeVideo | undefined, fileAttribute: types.DocumentAttributeFilename | undefined, fileId: string, fileUniqueId: string): Animation;

package/script/types/1_chat.d.ts

@@ -13,22 +13,22 @@ export declare namespace Chat {
         /** Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier. */
         id: number;
         idColor: string;
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto;
     }
     interface Private extends Base {
         type: ChatType.Private;
         /** True, if this user is a bot */
         isBot?: boolean;
-        /** Optional. First name of the other party in a private chat */
+        /** First name of the other party in a private chat */
         firstName: string;
-        /** Optional. Last name of the other party in a private chat */
+        /** Last name of the other party in a private chat */
         lastName?: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.User;
         /** True, if the user is a scam user */
         isScam: boolean;
@@ -40,26 +40,26 @@ export declare namespace Chat {
         isVerified: boolean;
         /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted?: boolean;
-        /** Optional. Contains the reason why access to the user must be restricted. */
+        /** Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Group extends Base {
         type: ChatType.Group;
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.Chat;
         /** True, if the user is creator of the chat */
         isCreator: boolean;
     }
     interface ChannelBase extends Base {
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
-        /** Optional. Chat photo. */
+        /** Chat photo. */
         photo?: ChatPhoto.Chat;
         /** True, if the user is a scam user */
         isScam: boolean;
@@ -69,21 +69,21 @@ export declare namespace Chat {
         isVerified: boolean;
         /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted: boolean;
-        /** Optional. Contains the reason why access to the user must be restricted. */
+        /** Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Channel extends ChannelBase {
         type: ChatType.Channel;
-        /** Optional. Title, for supergroups, channels and group chats */
+        /** Title, for supergroups, channels and group chats */
         title: string;
-        /** Optional. Username, for private chats, supergroups and channels if available */
+        /** Username, for private chats, supergroups and channels if available */
         username?: string;
-        /** Optional. Additional usernames */
+        /** Additional usernames */
         also?: string[];
     }
     interface Supergroup extends ChannelBase {
         type: ChatType.Supergroup;
-        /** Optional. True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
+        /** True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
         isForum: boolean;
     }
 }

package/script/types/1_document.d.ts

@@ -1,11 +1,18 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a general file (as opposed to [photos](https://corefork.telegram.org/bots/api#photosize), [voice messages](https://corefork.telegram.org/bots/api#voice) and [audio files](https://corefork.telegram.org/bots/api#audio)). */
 export interface Document {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Document thumbnail as defined by sender */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructDocument(document: types.Document, fileNameAttribute: types.DocumentAttributeFilename, fileId: string, fileUniqueId: string): Document;

package/script/types/1_inline_keyboard_button.d.ts

@@ -8,34 +8,34 @@ export declare namespace InlineKeyboardButton {
         text: string;
     }
     interface URL extends Base {
-        /** Optional. HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
+        /** HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
         url: string;
     }
     interface Callback extends Base {
-        /** Optional. Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
+        /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
         callbackData: string;
     }
     interface WebApp extends Base {
-        /** Optional. Description of the [Web App](https://core.telegram.org/bots/webapps) that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
+        /** Description of the [Web App](https://core.telegram.org/bots/webapps) that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
         webApp: WebAppInfo;
     }
     interface Login extends Base {
-        /** Optional. An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
+        /** An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
         loginUrl: LoginUrl;
     }
     interface SwitchInline extends Base {
-        /** Optional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
+        /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
         switchInlineQuery: string;
     }
     interface SwitchInlineCurrent extends Base {
-        /** Optional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
+        /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
         switchInlineQueryCurrentChat: string;
     }
     interface Game extends Base {
         callbackGame: Record<never, never>;
     }
     interface Pay extends Base {
-        /** Optional. Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
+        /** Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
         pay: boolean;
     }
 }

package/script/types/1_keyboard_button.d.ts

@@ -9,52 +9,52 @@ export declare namespace KeyboardButton {
     }
     /** This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. [More about requesting users](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestUser extends Text {
-        /** Optional. If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a “user_shared” service message. Available in private chats only. */
+        /** If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a “user_shared” service message. Available in private chats only. */
         requestUser: {
             /** Signed 32-bit identifier of the request, which will be received back in the [UserShared](https://core.telegram.org/bots/api#usershared) object. Must be unique within the message */
             requestId: number;
-            /** Optional. Pass True to request a bot, pass False to request a regular user. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a bot, pass False to request a regular user. If not specified, no additional restrictions are applied. */
             userIsBot?: boolean;
-            /** Optional. Pass True to request a premium user, pass False to request a non-premium user. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a premium user, pass False to request a non-premium user. If not specified, no additional restrictions are applied. */
             userIsPremium?: boolean;
         };
     }
     /** This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed. [More about requesting chats](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestChat extends Text {
-        /** Optional. If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. */
+        /** If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. */
         requestChat: {
             /** Signed 32-bit identifier of the request, which will be received back in the [ChatShared](https://core.telegram.org/bots/api#chatshared) object. Must be unique within the message */
             requestId: number;
             /** Pass True to request a channel chat, pass False to request a group or a supergroup chat. */
             chatIsChannel: boolean;
-            /** Optional. Pass True to request a forum supergroup, pass False to request a non-forum chat. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a forum supergroup, pass False to request a non-forum chat. If not specified, no additional restrictions are applied. */
             chatIsForum?: boolean;
-            /** Optional. Pass True to request a supergroup or a channel with a username, pass False to request a chat without a username. If not specified, no additional restrictions are applied. */
+            /** Pass True to request a supergroup or a channel with a username, pass False to request a chat without a username. If not specified, no additional restrictions are applied. */
             chatHasUsername?: boolean;
-            /** Optional. Pass True to request a chat owned by the user. Otherwise, no additional restrictions are applied. */
+            /** Pass True to request a chat owned by the user. Otherwise, no additional restrictions are applied. */
             chatIsCreated?: boolean;
-            /** Optional. A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of _bot_administrator_rights_. If not specified, no additional restrictions are applied. */
+            /** A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of _bot_administrator_rights_. If not specified, no additional restrictions are applied. */
             userAdministratorRights?: ChatAdministratorRights;
-            /** Optional. A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of _user_administrator_rights_. If not specified, no additional restrictions are applied. */
+            /** A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of _user_administrator_rights_. If not specified, no additional restrictions are applied. */
             botAdministratorRights?: ChatAdministratorRights;
-            /** Optional. Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
+            /** Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
             botIsMember?: boolean;
         };
     }
     interface RequestContact extends Text {
-        /** Optional. If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
+        /** If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
         requestContact: true;
     }
     interface RequestLocation extends Text {
-        /** Optional. If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
+        /** If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
         requestLocation: true;
     }
     interface RequestPoll extends Text {
-        /** Optional. If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only. */
+        /** If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only. */
         requestPoll: KeyboardButtonPollType;
     }
     interface WebApp extends Text {
-        /** Optional. If specified, the described [Web App](https://core.telegram.org/bots/webapps) will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
+        /** If specified, the described [Web App](https://core.telegram.org/bots/webapps) will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
         webApp: WebAppInfo;
     }
 }

package/script/types/1_photo.d.ts

@@ -1,5 +1,6 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a photo. */
 export interface Photo {
     /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
@@ -9,7 +10,7 @@ export interface Photo {
     width: number;
     /** Photo height */
     height: number;
-    /** Optional. File size in bytes */
+    /** File size in bytes */
     fileSize: number;
     thumbnails: Thumbnail[];
 }

package/script/types/1_sticker.d.ts

@@ -2,21 +2,37 @@ import * as types from "../tl/2_types.js";
 import { MaybePromise } from "../utilities/0_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
 import { MaskPosition } from "./0_mask_position.js";
+/** This object represents a sticker. */
 export interface Sticker {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Type of the sticker, currently one of "regular", "mask", "custom_emoji". The type of the sticker is independent from its format, which is determined by the fields is_animated and is_video. */
     type: "regular" | "mask" | "custom_emoji";
+    /** Sticker width */
     width: number;
+    /** Sticker height */
     height: number;
+    /** True, if the sticker is [animated](https://telegram.org/blog/animated-stickers) */
     isAnimated: boolean;
+    /** True, if the sticker is a [video sticker](https://telegram.org/blog/video-stickers-better-reactions) */
     isVideo: boolean;
+    /** Sticker thumbnail in the .WEBP or .JPG format */
     thumbnails: Thumbnail[];
+    /** Emoji associated with the sticker */
     emoji?: string;
+    /** Name of the sticker set to which the sticker belongs */
     setName?: string;
+    /** For premium regular stickers, premium animation for the sticker */
     premiumAnimation?: File;
+    /** For mask stickers, the position where the mask should be placed */
     maskPosition?: MaskPosition;
+    /** For custom emoji stickers, unique identifier of the custom emoji */
     customEmojiId?: string;
+    /** True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places */
     needsRepainting?: boolean;
+    /** File size in bytes */
     fileSize?: number;
 }
 export type StickerSetNameGetter = (inputStickerSet: types.InputStickerSetID) => MaybePromise<string>;

package/script/types/1_user.d.ts

@@ -9,27 +9,27 @@ export interface User {
     isBot: boolean;
     /** User's or bot's first name */
     firstName: string;
-    /** Optional. User's or bot's last name */
+    /** User's or bot's last name */
     lastName?: string;
-    /** Optional. User's or bot's username */
+    /** User's or bot's username */
     username?: string;
-    /** Optional. Additional usernames */
+    /** Additional usernames */
     also?: string[];
-    /** Optional. Chat photo */
+    /** Chat photo */
     photo?: ChatPhoto.User;
-    /** Optional. [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language */
+    /** [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language */
     languageCode?: string;
     /** True, if the user is a scam user */
     isScam: boolean;
     /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
     isFake: boolean;
-    /** Optional. True, if this user is a Telegram Premium user */
+    /** True, if this user is a Telegram Premium user */
     isPremium: boolean;
     /** True, if the user is verified */
     isVerified: boolean;
     /** True, if the user is an official support user */
     isSupport: boolean;
-    /** Optional. True, if this user added the bot to the attachment menu */
+    /** True, if this user added the bot to the attachment menu */
     addedToAttachmentMenu: boolean;
 }
 export declare function constructUser(user_: types.User): User;

package/script/types/1_video.d.ts

@@ -1,14 +1,24 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a video file. */
 export interface Video {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Video width as defined by sender */
     width: number;
+    /** Video height as defined by sender */
     height: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Video thumbnail */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName?: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value. */
     fileSize: number;
 }
 export declare function constructVideo(document: types.Document, videoAttribute: types.DocumentAttributeVideo, fileName: string | undefined, fileId: string, fileUniqueId: string): Video;

package/script/types/1_video_note.d.ts

@@ -1,12 +1,20 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a video message (available in Telegram apps as of v.4.0). */
 export interface VideoNote {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Video width and height (diameter of the video message) as defined by sender */
     length: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Video thumbnail */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName?: string;
+    /** File size in bytes */
     fileSize: number;
 }
 export declare function constructVideoNote(document: types.Document, videoAttribute: types.DocumentAttributeVideo, fileId: string, fileUniqueId: string): VideoNote;

package/script/types/2_game.d.ts

@@ -2,12 +2,19 @@ import * as types from "../tl/2_types.js";
 import { MessageEntity } from "./0_message_entity.js";
 import { Animation } from "./1_animation.js";
 import { Photo } from "./1_photo.js";
+/** This object represents a game. Use BotFather to create and edit games, their short names will act as unique identifiers. */
 export interface Game {
+    /** Title of the game */
     title: string;
+    /** Description of the game */
     description: string;
+    /** Photo that will be displayed in the game message in chats. */
     photo: Photo;
+    /** Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls [setGameScore](https://corefork.telegram.org/bots/api#setgamescore), or manually edited using [editMessageText](https://corefork.telegram.org/bots/api#editmessagetext). 0-4096 characters. */
     text?: string;
+    /** Special entities that appear in text, such as usernames, URLs, bot commands, etc. */
     textEntities?: MessageEntity[];
+    /** Animation that will be displayed in the game message in chats. Upload via [BotFather](https://t.me/botfather) */
     animation?: Animation;
 }
 export declare function constructGame(media_: types.MessageMediaGame): Game;

package/script/types/2_reply_keyboard_markup.d.ts

@@ -4,15 +4,15 @@ import { KeyboardButton } from "./1_keyboard_button.js";
 export interface ReplyKeyboardMarkup {
     /** Array of button rows, each represented by an Array of `KeyboardButton` objects */
     keyboard: KeyboardButton[][];
-    /** Optional. Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon. */
+    /** Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon. */
     isPersistent?: boolean;
-    /** Optional. Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard. */
+    /** Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard. */
     resizeKeyboard?: boolean;
-    /** Optional. Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false. */
+    /** Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false. */
     oneTimeKeyboard?: boolean;
-    /** Optional. The placeholder to be shown in the input field when the keyboard is active; 1-64 characters */
+    /** The placeholder to be shown in the input field when the keyboard is active; 1-64 characters */
     inputFieldPlaceholder?: string;
-    /** Optional. Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
+    /** Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardMarkup(keyboard_: types.ReplyKeyboardMarkup): ReplyKeyboardMarkup;