Skip to content

Commit

Permalink
Update chatterino.d.ts to match plugin-meta.lua (#5792)
Browse files Browse the repository at this point in the history
  • Loading branch information
Mm2PL authored Jan 19, 2025
1 parent 1ec1377 commit a2ad19d
Show file tree
Hide file tree
Showing 4 changed files with 141 additions and 135 deletions.
3 changes: 3 additions & 0 deletions .prettierrc
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
trailingComma: es5
endOfLine: auto
overrides:
- files: "*.ts"
options:
tabWidth: 4
- files: "*.md"
options:
proseWrap: preserve
257 changes: 128 additions & 129 deletions docs/chatterino.d.ts
Original file line number Diff line number Diff line change
@@ -1,133 +1,132 @@
/** @noSelfInFile */

declare module c2 {
enum LogLevel {
Debug,
Info,
Warning,
Critical,
}
class CommandContext {
words: String[];
channel: Channel;
}

enum Platform {
Twitch,
}
enum ChannelType {
None,
Direct,
Twitch,
TwitchWhispers,
TwitchWatching,
TwitchMentions,
TwitchLive,
TwitchAutomod,
Irc,
Misc,
}

interface IWeakResource {
is_valid(): boolean;
}

interface ISharedResource {}

class RoomModes {
unique_chat: boolean;
subscriber_only: boolean;
emotes_only: boolean;
follower_only: null | number;
slow_mode: null | number;
}
class StreamStatus {
live: boolean;
viewer_count: number;
uptime: number;
title: string;
game_name: string;
game_id: string;
}

class Channel implements IWeakResource {
is_valid(): boolean;
get_name(): string;
get_type(): ChannelType;
get_display_name(): string;
send_message(message: string, execute_commands: boolean): void;
add_system_message(message: string): void;

is_twitch_channel(): boolean;

get_room_modes(): RoomModes;
get_stream_status(): StreamStatus;
get_twitch_id(): string;
is_broadcaster(): boolean;
is_mod(): boolean;
is_vip(): boolean;

static by_name(name: string, platform: Platform): null | Channel;
static by_twitch_id(id: string): null | Channel;
}

enum HTTPMethod {
Get,
Post,
Put,
Delete,
Patch,
}

class HTTPResponse implements ISharedResource {
data(): string;
status(): number | null;
error(): string;
}

type HTTPCallback = (res: HTTPResponse) => void;
class HTTPRequest implements ISharedResource {
on_success(callback: HTTPCallback): void;
on_error(callback: HTTPCallback): void;
finally(callback: () => void): void;

set_timeout(millis: number): void;
set_payload(data: string): void;
set_header(name: string, value: string): void;

execute(): void;

// might error
static create(method: HTTPMethod, url: string): HTTPRequest;
}

function log(level: LogLevel, ...data: any[]): void;
function register_command(
name: String,
handler: (ctx: CommandContext) => void
): boolean;

class CompletionEvent {
query: string;
full_text_content: string;
cursor_position: number;
is_first_word: boolean;
}

class CompletionList {
values: String[];
hide_others: boolean;
}

enum EventType {
CompletionRequested = "CompletionRequested",
}

type CbFuncCompletionsRequested = (ev: CompletionEvent) => CompletionList;
type CbFunc<T> = T extends EventType.CompletionRequested
? CbFuncCompletionsRequested
: never;

function register_callback<T>(type: T, func: CbFunc<T>): void;
function later(callback: () => void, msec: number): void;
enum LogLevel {
Debug,
Info,
Warning,
Critical,
}
class CommandContext {
words: string[];
channel: Channel;
}

enum ChannelType {
None,
Direct,
Twitch,
TwitchWhispers,
TwitchWatching,
TwitchMentions,
TwitchLive,
TwitchAutomod,
Misc,
}

interface IWeakResource {
is_valid(): boolean;
}

interface ISharedResource {}

class RoomModes {
unique_chat: boolean;
subscriber_only: boolean;
emotes_only: boolean;
follower_only: null | number;
slow_mode: null | number;
}
class StreamStatus {
live: boolean;
viewer_count: number;
uptime: number;
title: string;
game_name: string;
game_id: string;
}

class Channel implements IWeakResource {
is_valid(): boolean;
get_name(): string;
get_type(): ChannelType;
get_display_name(): string;

send_message(message: string, execute_commands: boolean): void;
send_message(message: string): void;

add_system_message(message: string): void;

is_twitch_channel(): boolean;

get_room_modes(): RoomModes;
get_stream_status(): StreamStatus;
get_twitch_id(): string;
is_broadcaster(): boolean;
is_mod(): boolean;
is_vip(): boolean;

static by_name(name: string): null | Channel;
static by_twitch_id(id: string): null | Channel;
}

enum HTTPMethod {
Get,
Post,
Put,
Delete,
Patch,
}

class HTTPResponse implements ISharedResource {
data(): string;
status(): number | null;
error(): string;
}

type HTTPCallback = (res: HTTPResponse) => void;
class HTTPRequest implements ISharedResource {
on_success(callback: HTTPCallback): void;
on_error(callback: HTTPCallback): void;
finally(callback: () => void): void;

set_timeout(millis: number): void;
set_payload(data: string): void;
set_header(name: string, value: string): void;

execute(): void;

// might error
static create(method: HTTPMethod, url: string): HTTPRequest;
}

function log(level: LogLevel, ...data: any[]): void;
function register_command(
name: string,
handler: (ctx: CommandContext) => void
): boolean;

class CompletionEvent {
query: string;
full_text_content: string;
cursor_position: number;
is_first_word: boolean;
}

class CompletionList {
values: string[];
hide_others: boolean;
}

enum EventType {
CompletionRequested = "CompletionRequested",
}

type CbFuncCompletionsRequested = (ev: CompletionEvent) => CompletionList;
type CbFunc<T> = T extends EventType.CompletionRequested
? CbFuncCompletionsRequested
: never;

function register_callback<T>(type: T, func: CbFunc<T>): void;
function later(callback: () => void, msec: number): void;
}
2 changes: 2 additions & 0 deletions docs/plugin-meta.lua
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,8 @@ c2.ChannelType = {
---@field subscriber_only boolean
---@field unique_chat boolean You might know this as r9kbeta or robot9000.
---@field emotes_only boolean Whether or not text is allowed in messages. Note that "emotes" here only means Twitch emotes, not Unicode emoji, nor 3rd party text-based emotes
---@field follower_only number? Time in minutes you need to follow to chat or nil.
---@field slow_mode number? Time in seconds you need to wait before sending messages or nil.

-- End src/providers/twitch/TwitchChannel.hpp

Expand Down
14 changes: 8 additions & 6 deletions src/providers/twitch/TwitchChannel.hpp
Original file line number Diff line number Diff line change
Expand Up @@ -115,24 +115,26 @@ class TwitchChannel final : public Channel, public ChannelChatters
*/
bool emoteOnly = false;

/**
* @lua@field follower_only number? Time in minutes you need to follow to chat or nil.
*/
/**
* @brief Number of minutes required for users to be followed before typing in chat
*
* Special cases:
* -1 = follower mode off
* 0 = follower mode on, no time requirement
*
* @lua@field follower_only number? Time in minutes you need to follow to chat or nil.
**/
*/
int followerOnly = -1;

/**
* @lua@field slow_mode number? Time in seconds you need to wait before sending messages or nil.
*/
/**
* @brief Number of seconds required to wait before typing emotes
*
* 0 = slow mode off
*
* @lua@field slow_mode number? Time in seconds you need to wait before sending messages or nil.
**/
*/
int slowMode = 0;
};

Expand Down

0 comments on commit a2ad19d

Please sign in to comment.