@spatulox/simplediscordbot 3.0.2 → 3.1.0

package/.env.example

@@ -1,2 +1,2 @@
-DISCORD_BOT_TOKEN=example
+DISCORD_BOT_TOKEN=example
 DISCORD_BOT_DEV # Define this one with anything you want, the value is not important as long as the env var is defined

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 Date format : dd/mm/yyyy
 
+### 21/09/2026 - 3.1.0
+- Add :
+  - `ChartManager` : text based charts for Components V2, since Discord has no chart component. `progressBar()` / `progressBars()` draw unicode gauges (`CPU : ███░░░░░░░ 32.7 %`), `sparkline()` / `sparklines()` draw one line curves (`▁▂▃▅▇█▆▄▃▂▁`). Each method returns a `TextDisplayBuilder` to drop into a `ContainerBuilder`, and the grouped forms render every row in a single one so a dashboard costs 1 component instead of N against the 40 components budget of a message
+    - `sparklines()` takes an opt-in `sharedScale` so stacked curves are scaled against the same bounds and stay comparable, instead of each one filling the whole height
+    - Values are clamped (`value > max`, negative values, `max = 0`), a constant serie renders as a straight line instead of dividing by zero, an empty serie or an empty row list renders `—` (`TextDisplayBuilder.setContent()` rejects an empty string), and non finite points are dropped instead of flattening the whole curve
+
 ### 28/04/2026 - 2.2.1
 - Changes :
   - Add dependency to @spatulox/utils

package/LICENSE.md

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Spatulox
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Spatulox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,65 +1,75 @@
-
-# Simple Discord Bot ![badge-status](https://img.shields.io/badge/status-active-brightgreen)
-
-[![npm version](https://img.shields.io/npm/v/@spatulox/simplediscordbot.svg)](https://npmjs.com/package/@spatulox/simplediscordbot)
-[![downloads](https://img.shields.io/npm/dm/@spatulox/simplediscordbot.svg)](https://npmjs.com/package/@spatulox/simplediscordbot)
-[![license](https://img.shields.io/npm/l/@spatulox/simplediscordbot.svg)](LICENSE)
-
-> **TypeScript Discord.js framework** - Simple, powerful, framework-ready. Built for developers who want clean bot architecture.
-
-## ✨ Features :
-> - Fully compatible with discordjs
-> - Include the [DiscordInterationManager](https://github.com/Spatulox/DiscordInteractionManager) package
-> - Simple Log package
-> - Provides easy Managers to avoid repetitive code everywhere
-> - Simple yet powerful builders (Embeds, Modals, SelectMenus, Components, Buttons) that rely on discord.js for full compatibility
-
-# Don't forget to check the [wiki](https://github.com/spatulox-discord/SimpleDiscordBot/wiki)
-
-## Installation
-```bash
-  npm i @spatulox/simplediscordbot
-```
-
-## Quick Start
-
-Env Variables:
-```
-DISCORD_BOT_TOKEN="" // Your bot Token
-```
-<details>
-    <summary>Note for v2.1.2 and older</summary>
-
-> You also need to set up this env var :
-> ```
-> DISCORD_BOT_CLIENTID="" // You bot ClientID
-> ```
-
-</details>
-
-```typescript
-import {Bot, BotConfig, SimpleColor, Time} from "@spatulox/simplediscordbot";
-import {Client, Events, GatewayIntentBits} from "discord.js";
-
-const client = new Client({
-    intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
-});
-
-const config: BotConfig = {
-    defaultSimpleColor: SimpleColor.blue,
-    botName: "Simple Discord Bot",
-    log: {
-        info: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
-        error: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
-        warn: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
-        debug: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: false},
-    }
-};
-
-const bot = new Bot(client, config);
-
-bot.client.on(Events.ClientReady, async () => {
-    Bot.setRandomActivity(randomActivityList, Time.minute.MIN_10.toMilliseconds());
-    console.log("Bot ready! ✨");
-});
-```
+
+# Simple Discord Bot ![badge-status](https://img.shields.io/badge/status-active-brightgreen)
+
+[![npm version](https://img.shields.io/npm/v/@spatulox/simplediscordbot.svg)](https://npmjs.com/package/@spatulox/simplediscordbot)
+[![downloads](https://img.shields.io/npm/dm/@spatulox/simplediscordbot.svg)](https://npmjs.com/package/@spatulox/simplediscordbot)
+[![license](https://img.shields.io/npm/l/@spatulox/simplediscordbot.svg)](LICENSE)
+
+> **TypeScript Discord.js framework** - Simple, powerful, framework-ready. Built for developers who want clean bot architecture.
+
+## ✨ Features :
+> - Fully compatible with discordjs
+> - Include the [DiscordInterationManager](https://github.com/Spatulox/DiscordInteractionManager) package
+> - Simple Log package
+> - Provides easy Managers to avoid repetitive code everywhere
+> - Simple yet powerful builders (Embeds, Modals, SelectMenus, Components, Buttons) that rely on discord.js for full compatibility
+> - Text based charts (progress bars, sparklines) for Components V2, since Discord has no chart component
+
+# Don't forget to check the [wiki](https://github.com/spatulox-discord/SimpleDiscordBot/wiki)
+
+## 🧩 Starting a new bot ?
+
+> Don't start from an empty folder : the [**DiscordBotTemplate**](https://github.com/Spatulox/DiscordBotTemplate)
+> is a ready-to-use project built on this framework. Login, logging, modules, interaction
+> routing and slash command deployment are already wired, you only fill in your ids.
+>
+> It has [its own wiki](https://github.com/Spatulox/DiscordBotTemplate/wiki) too, and a
+> `feat/multi-bot` branch for several bots living in one repository.
+
+## Installation
+```bash
+  npm i @spatulox/simplediscordbot
+```
+
+## Quick Start
+
+Env Variables:
+```
+DISCORD_BOT_TOKEN="" // Your bot Token
+```
+<details>
+    <summary>Note for v2.1.2 and older</summary>
+
+> You also need to set up this env var :
+> ```
+> DISCORD_BOT_CLIENTID="" // You bot ClientID
+> ```
+
+</details>
+
+```typescript
+import {Bot, BotConfig, SimpleColor, Time} from "@spatulox/simplediscordbot";
+import {Client, Events, GatewayIntentBits} from "discord.js";
+
+const client = new Client({
+    intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]
+});
+
+const config: BotConfig = {
+    defaultSimpleColor: SimpleColor.blue,
+    botName: "Simple Discord Bot",
+    log: {
+        info: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
+        error: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
+        warn: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: true},
+        debug: {channelId: "YOUR_LOG_CHANNEL_ID", console: true, discord: false},
+    }
+};
+
+const bot = new Bot(client, config);
+
+bot.client.on(Events.ClientReady, async () => {
+    Bot.setRandomActivity(randomActivityList, Time.minute.MIN_10.toMilliseconds());
+    console.log("Bot ready! ✨");
+});
+```

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { EmbedBuilder, ContainerBuilder, ActionRowBuilder, MessageActionRowComponentBuilder, Message, TextChannel, DMChannel, ThreadChannel, MessageCreateOptions, User, GuildMember, BaseInteraction, InteractionResponse, Client, ActivityType, InteractionDeferReplyOptions, InteractionReplyOptions, InteractionEditReplyOptions, Snowflake, WebhookMessageCreateOptions, EmojiResolvable, Guild, BanOptions, GuildBasedChannel, GuildChannelCreateOptions, ForumChannel, NewsChannel, StageChannel, StartThreadOptions, VoiceChannel, Invite, Channel, Collection, GuildBan, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, ChannelType, SeparatorSpacingSize, ButtonBuilder, AttachmentBuilder, ButtonStyle } from 'discord.js';
+import { EmbedBuilder, ContainerBuilder, ActionRowBuilder, MessageActionRowComponentBuilder, Message, TextChannel, DMChannel, ThreadChannel, MessageCreateOptions, User, GuildMember, BaseInteraction, InteractionResponse, Client, ActivityType, InteractionDeferReplyOptions, InteractionReplyOptions, InteractionEditReplyOptions, Snowflake, WebhookMessageCreateOptions, EmojiResolvable, Guild, BanOptions, GuildBasedChannel, GuildChannelCreateOptions, ForumChannel, NewsChannel, StageChannel, StartThreadOptions, VoiceChannel, Invite, Channel, Collection, GuildBan, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, ChannelType, SeparatorSpacingSize, ButtonBuilder, AttachmentBuilder, TextDisplayBuilder, ButtonStyle } from 'discord.js';
 import { BaseSelectMenuBuilder } from '@discordjs/builders';
 export { CacheManager, FileManager, Log, SimpleMutex, Time } from '@spatulox/utils';
 
@@ -737,6 +737,100 @@ declare class ComponentManager {
     static toInteractionEdit(container: ContainerBuilder, file?: AttachmentBuilder | AttachmentBuilder[] | null, footer?: boolean): InteractionEditReplyOptions;
 }
 
+interface ProgressBarOptions {
+    /** Number of characters of the bar itself, default 10 */
+    width?: number;
+    /** Character of the filled part, default "█" */
+    filled?: string;
+    /** Character of the empty part, default "░" */
+    empty?: string;
+    /** Append the numeric value after the bar, default true */
+    showValue?: boolean;
+    /** Unit printed after the value, default "%" */
+    unit?: string;
+    /** Decimals of the printed value, default 1 */
+    decimals?: number;
+    /**
+     * Wrap the whole render in a ``` block. Discord renders TextDisplay with a proportional
+     * font, so labels of different widths never line up : only a code block gives a real
+     * monospace alignment. Default false.
+     */
+    codeBlock?: boolean;
+}
+interface SparklineOptions {
+    /** Fixed low bound of the scale, default min(values) */
+    min?: number;
+    /** Fixed high bound of the scale, default max(values) */
+    max?: number;
+    /** Only keep the N most recent points, default 50 */
+    maxPoints?: number;
+    /** Append the last value after the curve, default true */
+    showValue?: boolean;
+    /** Unit printed after the value, default "" */
+    unit?: string;
+    /** Decimals of the printed value, default 1 */
+    decimals?: number;
+    /** See ProgressBarOptions.codeBlock. Default false */
+    codeBlock?: boolean;
+}
+interface ProgressBarRow {
+    label: string;
+    value: number;
+    /** Default 100 */
+    max?: number;
+    /** Overrides the options given to progressBars() for this row only */
+    options?: ProgressBarOptions;
+}
+interface SparklineRow {
+    label: string;
+    values: number[];
+    /** Overrides the options given to sparklines() for this row only */
+    options?: SparklineOptions;
+}
+interface SparklinesOptions extends SparklineOptions {
+    /**
+     * Scale every curve against the same bounds, deduced from all the series at once.
+     * Off by default : each curve then uses its own min/max and fills the whole height,
+     * which reads better alone but makes two stacked curves impossible to compare.
+     */
+    sharedScale?: boolean;
+}
+declare class ChartManager {
+    /**
+     * A single gauge : `CPU : ███░░░░░░░ 32.7 %`
+     */
+    static progressBar(label: string, value: number, max?: number, options?: ProgressBarOptions): TextDisplayBuilder;
+    /**
+     * Several gauges in ONE TextDisplay, so a dashboard of 6 metrics still costs 1 component.
+     * Labels are padded to the longest one so the bars start at the same column.
+     */
+    static progressBars(rows: ProgressBarRow[], options?: ProgressBarOptions): TextDisplayBuilder;
+    /**
+     * A one line curve : `RAM : ▁▂▃▅▇█▆▄▃▂▁ 62 %`. One block character per point, the last
+     * value is printed at the end because a sparkline alone carries no scale.
+     */
+    static sparkline(label: string, values: number[], options?: SparklineOptions): TextDisplayBuilder;
+    /**
+     * Several curves in ONE TextDisplay, the sparkline counterpart of progressBars().
+     * Labels are padded to the longest one so every curve starts at the same column.
+     */
+    static sparklines(rows: SparklineRow[], options?: SparklinesOptions): TextDisplayBuilder;
+    /**
+     * Only fills the bounds that were not given explicitly, and only when asked : a row
+     * setting its own min/max still wins, since row options are spread after these.
+     */
+    private static withSharedScale;
+    private static renderBar;
+    private static renderSpark;
+    private static formatValue;
+    /**
+     * TextDisplayBuilder.setContent() rejects an empty string, so an empty row list must
+     * still render something rather than throw at build time.
+     */
+    private static wrap;
+    private static clamp01;
+}
+
 interface ButtonOptions {
     label?: string;
     emoji?: string;
@@ -839,4 +933,4 @@ declare const SimpleDiscordBotInfo: {
     license: string;
 };
 
-export { Bot, type BotConfig, BotEnv, ButtonManager, type ButtonOptions, ComponentManager, type ComponentManagerCreate, type ComponentManagerField, type ComponentManagerFileInput, DiscordRegex, EmbedManager, GuildManager, type ModalField, ModalFieldType, ModalManager, type RandomBotActivity, ReactionManager, type SelectMenuCreateOption, type SelectMenuList, SelectMenuManager, SimpleColor, SimpleDiscordBotInfo, UserManager, WebhookManager };
+export { Bot, type BotConfig, BotEnv, ButtonManager, type ButtonOptions, ChartManager, ComponentManager, type ComponentManagerCreate, type ComponentManagerField, type ComponentManagerFileInput, DiscordRegex, EmbedManager, GuildManager, type ModalField, ModalFieldType, ModalManager, type ProgressBarOptions, type ProgressBarRow, type RandomBotActivity, ReactionManager, type SelectMenuCreateOption, type SelectMenuList, SelectMenuManager, SimpleColor, SimpleDiscordBotInfo, type SparklineOptions, type SparklineRow, type SparklinesOptions, UserManager, WebhookManager };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { EmbedBuilder, ContainerBuilder, ActionRowBuilder, MessageActionRowComponentBuilder, Message, TextChannel, DMChannel, ThreadChannel, MessageCreateOptions, User, GuildMember, BaseInteraction, InteractionResponse, Client, ActivityType, InteractionDeferReplyOptions, InteractionReplyOptions, InteractionEditReplyOptions, Snowflake, WebhookMessageCreateOptions, EmojiResolvable, Guild, BanOptions, GuildBasedChannel, GuildChannelCreateOptions, ForumChannel, NewsChannel, StageChannel, StartThreadOptions, VoiceChannel, Invite, Channel, Collection, GuildBan, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, ChannelType, SeparatorSpacingSize, ButtonBuilder, AttachmentBuilder, ButtonStyle } from 'discord.js';
+import { EmbedBuilder, ContainerBuilder, ActionRowBuilder, MessageActionRowComponentBuilder, Message, TextChannel, DMChannel, ThreadChannel, MessageCreateOptions, User, GuildMember, BaseInteraction, InteractionResponse, Client, ActivityType, InteractionDeferReplyOptions, InteractionReplyOptions, InteractionEditReplyOptions, Snowflake, WebhookMessageCreateOptions, EmojiResolvable, Guild, BanOptions, GuildBasedChannel, GuildChannelCreateOptions, ForumChannel, NewsChannel, StageChannel, StartThreadOptions, VoiceChannel, Invite, Channel, Collection, GuildBan, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, ChannelType, SeparatorSpacingSize, ButtonBuilder, AttachmentBuilder, TextDisplayBuilder, ButtonStyle } from 'discord.js';
 import { BaseSelectMenuBuilder } from '@discordjs/builders';
 export { CacheManager, FileManager, Log, SimpleMutex, Time } from '@spatulox/utils';
 
@@ -737,6 +737,100 @@ declare class ComponentManager {
     static toInteractionEdit(container: ContainerBuilder, file?: AttachmentBuilder | AttachmentBuilder[] | null, footer?: boolean): InteractionEditReplyOptions;
 }
 
+interface ProgressBarOptions {
+    /** Number of characters of the bar itself, default 10 */
+    width?: number;
+    /** Character of the filled part, default "█" */
+    filled?: string;
+    /** Character of the empty part, default "░" */
+    empty?: string;
+    /** Append the numeric value after the bar, default true */
+    showValue?: boolean;
+    /** Unit printed after the value, default "%" */
+    unit?: string;
+    /** Decimals of the printed value, default 1 */
+    decimals?: number;
+    /**
+     * Wrap the whole render in a ``` block. Discord renders TextDisplay with a proportional
+     * font, so labels of different widths never line up : only a code block gives a real
+     * monospace alignment. Default false.
+     */
+    codeBlock?: boolean;
+}
+interface SparklineOptions {
+    /** Fixed low bound of the scale, default min(values) */
+    min?: number;
+    /** Fixed high bound of the scale, default max(values) */
+    max?: number;
+    /** Only keep the N most recent points, default 50 */
+    maxPoints?: number;
+    /** Append the last value after the curve, default true */
+    showValue?: boolean;
+    /** Unit printed after the value, default "" */
+    unit?: string;
+    /** Decimals of the printed value, default 1 */
+    decimals?: number;
+    /** See ProgressBarOptions.codeBlock. Default false */
+    codeBlock?: boolean;
+}
+interface ProgressBarRow {
+    label: string;
+    value: number;
+    /** Default 100 */
+    max?: number;
+    /** Overrides the options given to progressBars() for this row only */
+    options?: ProgressBarOptions;
+}
+interface SparklineRow {
+    label: string;
+    values: number[];
+    /** Overrides the options given to sparklines() for this row only */
+    options?: SparklineOptions;
+}
+interface SparklinesOptions extends SparklineOptions {
+    /**
+     * Scale every curve against the same bounds, deduced from all the series at once.
+     * Off by default : each curve then uses its own min/max and fills the whole height,
+     * which reads better alone but makes two stacked curves impossible to compare.
+     */
+    sharedScale?: boolean;
+}
+declare class ChartManager {
+    /**
+     * A single gauge : `CPU : ███░░░░░░░ 32.7 %`
+     */
+    static progressBar(label: string, value: number, max?: number, options?: ProgressBarOptions): TextDisplayBuilder;
+    /**
+     * Several gauges in ONE TextDisplay, so a dashboard of 6 metrics still costs 1 component.
+     * Labels are padded to the longest one so the bars start at the same column.
+     */
+    static progressBars(rows: ProgressBarRow[], options?: ProgressBarOptions): TextDisplayBuilder;
+    /**
+     * A one line curve : `RAM : ▁▂▃▅▇█▆▄▃▂▁ 62 %`. One block character per point, the last
+     * value is printed at the end because a sparkline alone carries no scale.
+     */
+    static sparkline(label: string, values: number[], options?: SparklineOptions): TextDisplayBuilder;
+    /**
+     * Several curves in ONE TextDisplay, the sparkline counterpart of progressBars().
+     * Labels are padded to the longest one so every curve starts at the same column.
+     */
+    static sparklines(rows: SparklineRow[], options?: SparklinesOptions): TextDisplayBuilder;
+    /**
+     * Only fills the bounds that were not given explicitly, and only when asked : a row
+     * setting its own min/max still wins, since row options are spread after these.
+     */
+    private static withSharedScale;
+    private static renderBar;
+    private static renderSpark;
+    private static formatValue;
+    /**
+     * TextDisplayBuilder.setContent() rejects an empty string, so an empty row list must
+     * still render something rather than throw at build time.
+     */
+    private static wrap;
+    private static clamp01;
+}
+
 interface ButtonOptions {
     label?: string;
     emoji?: string;
@@ -839,4 +933,4 @@ declare const SimpleDiscordBotInfo: {
     license: string;
 };
 
-export { Bot, type BotConfig, BotEnv, ButtonManager, type ButtonOptions, ComponentManager, type ComponentManagerCreate, type ComponentManagerField, type ComponentManagerFileInput, DiscordRegex, EmbedManager, GuildManager, type ModalField, ModalFieldType, ModalManager, type RandomBotActivity, ReactionManager, type SelectMenuCreateOption, type SelectMenuList, SelectMenuManager, SimpleColor, SimpleDiscordBotInfo, UserManager, WebhookManager };
+export { Bot, type BotConfig, BotEnv, ButtonManager, type ButtonOptions, ChartManager, ComponentManager, type ComponentManagerCreate, type ComponentManagerField, type ComponentManagerFileInput, DiscordRegex, EmbedManager, GuildManager, type ModalField, ModalFieldType, ModalManager, type ProgressBarOptions, type ProgressBarRow, type RandomBotActivity, ReactionManager, type SelectMenuCreateOption, type SelectMenuList, SelectMenuManager, SimpleColor, SimpleDiscordBotInfo, type SparklineOptions, type SparklineRow, type SparklinesOptions, UserManager, WebhookManager };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   BotEnv: () => BotEnv,
   ButtonManager: () => ButtonManager,
   CacheManager: () => import_utils22.CacheManager,
+  ChartManager: () => ChartManager,
   ComponentManager: () => ComponentManager,
   DiscordRegex: () => DiscordRegex,
   EmbedManager: () => EmbedManager,
@@ -763,7 +764,7 @@ var BotInteraction = class {
 // package.json
 var package_default = {
   name: "@spatulox/simplediscordbot",
-  version: "3.0.1",
+  version: "3.0.3",
   author: "Spatulox",
   description: "Simple discord bot framework to set up a bot under 30 secondes",
   exports: {
@@ -2465,30 +2466,135 @@ var ComponentManager = class {
   }
 };
 
-// src/manager/interactible/ButtonManager.ts
+// src/manager/messages/ChartManager.ts
 var import_discord17 = require("discord.js");
+var SPARK_BLOCKS = ["\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+var DEFAULT_MAX_POINTS = 50;
+var EMPTY = "\u2014";
+var ChartManager = class _ChartManager {
+  /**
+   * A single gauge : `CPU : ███░░░░░░░ 32.7 %`
+   */
+  static progressBar(label, value, max = 100, options = {}) {
+    const line = `${label} : ${_ChartManager.renderBar(value, max, options)}`;
+    return new import_discord17.TextDisplayBuilder().setContent(_ChartManager.wrap(line, options.codeBlock));
+  }
+  /**
+   * Several gauges in ONE TextDisplay, so a dashboard of 6 metrics still costs 1 component.
+   * Labels are padded to the longest one so the bars start at the same column.
+   */
+  static progressBars(rows, options = {}) {
+    const width = rows.reduce((longest, row) => Math.max(longest, row.label.length), 0);
+    const lines = rows.map((row) => {
+      const opts = { ...options, ...row.options };
+      return `${row.label.padEnd(width, " ")} : ${_ChartManager.renderBar(row.value, row.max ?? 100, opts)}`;
+    });
+    return new import_discord17.TextDisplayBuilder().setContent(_ChartManager.wrap(lines.join("\n"), options.codeBlock));
+  }
+  /**
+   * A one line curve : `RAM : ▁▂▃▅▇█▆▄▃▂▁ 62 %`. One block character per point, the last
+   * value is printed at the end because a sparkline alone carries no scale.
+   */
+  static sparkline(label, values, options = {}) {
+    const line = `${label} : ${_ChartManager.renderSpark(values, options)}`;
+    return new import_discord17.TextDisplayBuilder().setContent(_ChartManager.wrap(line, options.codeBlock));
+  }
+  /**
+   * Several curves in ONE TextDisplay, the sparkline counterpart of progressBars().
+   * Labels are padded to the longest one so every curve starts at the same column.
+   */
+  static sparklines(rows, options = {}) {
+    const width = rows.reduce((longest, row) => Math.max(longest, row.label.length), 0);
+    const base = _ChartManager.withSharedScale(rows, options);
+    const lines = rows.map((row) => {
+      const opts = { ...base, ...row.options };
+      return `${row.label.padEnd(width, " ")} : ${_ChartManager.renderSpark(row.values, opts)}`;
+    });
+    return new import_discord17.TextDisplayBuilder().setContent(_ChartManager.wrap(lines.join("\n"), options.codeBlock));
+  }
+  /**
+   * Only fills the bounds that were not given explicitly, and only when asked : a row
+   * setting its own min/max still wins, since row options are spread after these.
+   */
+  static withSharedScale(rows, options) {
+    if (!options.sharedScale) return options;
+    if (options.min !== void 0 && options.max !== void 0) return options;
+    const points = rows.flatMap((row) => row.values).filter((v) => Number.isFinite(v));
+    if (points.length === 0) return options;
+    return {
+      ...options,
+      min: options.min ?? Math.min(...points),
+      max: options.max ?? Math.max(...points)
+    };
+  }
+  static renderBar(value, max, options) {
+    const width = Math.max(1, Math.trunc(options.width ?? 10));
+    const filled = options.filled ?? "\u2588";
+    const empty = options.empty ?? "\u2591";
+    const ratio = _ChartManager.clamp01(value / max);
+    const filledCount = Math.round(ratio * width);
+    const bar = filled.repeat(filledCount) + empty.repeat(width - filledCount);
+    return bar + _ChartManager.formatValue(value, options);
+  }
+  static renderSpark(values, options) {
+    const maxPoints = Math.max(1, Math.trunc(options.maxPoints ?? DEFAULT_MAX_POINTS));
+    const points = values.filter((v) => Number.isFinite(v)).slice(-maxPoints);
+    if (points.length === 0) return EMPTY;
+    const lo = options.min ?? Math.min(...points);
+    const hi = options.max ?? Math.max(...points);
+    const middle = SPARK_BLOCKS[Math.floor(SPARK_BLOCKS.length / 2) - 1];
+    const curve = hi === lo ? middle.repeat(points.length) : points.map((v) => {
+      const level = Math.round(_ChartManager.clamp01((v - lo) / (hi - lo)) * (SPARK_BLOCKS.length - 1));
+      return SPARK_BLOCKS[level];
+    }).join("");
+    const last = points[points.length - 1];
+    return curve + _ChartManager.formatValue(last, { ...options, unit: options.unit ?? "" });
+  }
+  static formatValue(value, options) {
+    if (options.showValue === false) return "";
+    const decimals = Math.max(0, Math.trunc(options.decimals ?? 1));
+    const printable = Number.isFinite(value) ? value.toFixed(decimals) : "?";
+    const unit = options.unit ?? "%";
+    return unit ? ` ${printable} ${unit}` : ` ${printable}`;
+  }
+  /**
+   * TextDisplayBuilder.setContent() rejects an empty string, so an empty row list must
+   * still render something rather than throw at build time.
+   */
+  static wrap(content, codeBlock) {
+    const body = content.length > 0 ? content : EMPTY;
+    return codeBlock ? "```\n" + body + "\n```" : body;
+  }
+  static clamp01(ratio) {
+    if (!Number.isFinite(ratio)) return 0;
+    return Math.min(1, Math.max(0, ratio));
+  }
+};
+
+// src/manager/interactible/ButtonManager.ts
+var import_discord18 = require("discord.js");
 var ButtonManager = class _ButtonManager {
   static create(options) {
-    const btn = new import_discord17.ButtonBuilder().setCustomId(options.customId).setLabel(options.label ?? "Button").setStyle(options.style).setDisabled(options.disabled ?? false);
+    const btn = new import_discord18.ButtonBuilder().setCustomId(options.customId).setLabel(options.label ?? "Button").setStyle(options.style).setDisabled(options.disabled ?? false);
     if (options.emoji) {
       btn.setEmoji(options.emoji);
     }
     return btn;
   }
   static primary(options) {
-    return this.create({ ...options, style: import_discord17.ButtonStyle.Primary });
+    return this.create({ ...options, style: import_discord18.ButtonStyle.Primary });
   }
   static success(options) {
-    return this.create({ ...options, style: import_discord17.ButtonStyle.Success });
+    return this.create({ ...options, style: import_discord18.ButtonStyle.Success });
   }
   static secondary(options) {
-    return this.create({ ...options, style: import_discord17.ButtonStyle.Secondary });
+    return this.create({ ...options, style: import_discord18.ButtonStyle.Secondary });
   }
   static danger(options) {
-    return this.create({ ...options, style: import_discord17.ButtonStyle.Danger });
+    return this.create({ ...options, style: import_discord18.ButtonStyle.Danger });
   }
   static link(options) {
-    const btn = new import_discord17.ButtonBuilder().setLabel(options.label).setStyle(import_discord17.ButtonStyle.Link).setURL(options.url);
+    const btn = new import_discord18.ButtonBuilder().setLabel(options.label).setStyle(import_discord18.ButtonStyle.Link).setURL(options.url);
     if (options.emoji) btn.setEmoji(options.emoji);
     return btn;
   }
@@ -2500,7 +2606,7 @@ var ButtonManager = class _ButtonManager {
   }
   static row(but) {
     const buttons = Array.isArray(but) ? but.slice(0, 5) : [but];
-    return new import_discord17.ActionRowBuilder().addComponents(buttons);
+    return new import_discord18.ActionRowBuilder().addComponents(buttons);
   }
   static toMessage(button) {
     return {
@@ -2510,7 +2616,7 @@ var ButtonManager = class _ButtonManager {
   static toInteraction(button, ephemeral = false) {
     return {
       components: this.createRowsToReturn(button),
-      flags: ephemeral ? [import_discord17.MessageFlags.Ephemeral] : []
+      flags: ephemeral ? [import_discord18.MessageFlags.Ephemeral] : []
     };
   }
   static toInteractionEdit(button) {
@@ -2521,10 +2627,10 @@ var ButtonManager = class _ButtonManager {
   static createRowsToReturn(button) {
     if (Array.isArray(button)) {
       return button.map(
-        (btn) => btn instanceof import_discord17.ActionRowBuilder ? btn : _ButtonManager.row(btn)
+        (btn) => btn instanceof import_discord18.ActionRowBuilder ? btn : _ButtonManager.row(btn)
       );
     }
-    return button instanceof import_discord17.ActionRowBuilder ? [button] : [_ButtonManager.row(button)];
+    return button instanceof import_discord18.ActionRowBuilder ? [button] : [_ButtonManager.row(button)];
   }
 };
 
@@ -2538,7 +2644,7 @@ var DiscordRegex = class {
   // Caractères spéciaux
   static SPACE = "\u200B";
   // URLs basiques
-  static URL_REGEX = /(https?:\/\/[^s]+)/;
+  static URL_REGEX = /(https?:\/\/[^\s<>]+)/i;
   /* DISCORD REGEX */
   static USER_REGEX = /<@\d{18}>/;
   static BOT_REGEX = /<@\d{19}>/;
@@ -2652,6 +2758,7 @@ var DiscordRegex = class {
   BotEnv,
   ButtonManager,
   CacheManager,
+  ChartManager,
   ComponentManager,
   DiscordRegex,
   EmbedManager,

package/dist/index.mjs

@@ -743,7 +743,7 @@ var BotInteraction = class {
 // package.json
 var package_default = {
   name: "@spatulox/simplediscordbot",
-  version: "3.0.1",
+  version: "3.0.3",
   author: "Spatulox",
   description: "Simple discord bot framework to set up a bot under 30 secondes",
   exports: {
@@ -2468,6 +2468,111 @@ var ComponentManager = class {
   }
 };
 
+// src/manager/messages/ChartManager.ts
+import { TextDisplayBuilder as TextDisplayBuilder2 } from "discord.js";
+var SPARK_BLOCKS = ["\u2581", "\u2582", "\u2583", "\u2584", "\u2585", "\u2586", "\u2587", "\u2588"];
+var DEFAULT_MAX_POINTS = 50;
+var EMPTY = "\u2014";
+var ChartManager = class _ChartManager {
+  /**
+   * A single gauge : `CPU : ███░░░░░░░ 32.7 %`
+   */
+  static progressBar(label, value, max = 100, options = {}) {
+    const line = `${label} : ${_ChartManager.renderBar(value, max, options)}`;
+    return new TextDisplayBuilder2().setContent(_ChartManager.wrap(line, options.codeBlock));
+  }
+  /**
+   * Several gauges in ONE TextDisplay, so a dashboard of 6 metrics still costs 1 component.
+   * Labels are padded to the longest one so the bars start at the same column.
+   */
+  static progressBars(rows, options = {}) {
+    const width = rows.reduce((longest, row) => Math.max(longest, row.label.length), 0);
+    const lines = rows.map((row) => {
+      const opts = { ...options, ...row.options };
+      return `${row.label.padEnd(width, " ")} : ${_ChartManager.renderBar(row.value, row.max ?? 100, opts)}`;
+    });
+    return new TextDisplayBuilder2().setContent(_ChartManager.wrap(lines.join("\n"), options.codeBlock));
+  }
+  /**
+   * A one line curve : `RAM : ▁▂▃▅▇█▆▄▃▂▁ 62 %`. One block character per point, the last
+   * value is printed at the end because a sparkline alone carries no scale.
+   */
+  static sparkline(label, values, options = {}) {
+    const line = `${label} : ${_ChartManager.renderSpark(values, options)}`;
+    return new TextDisplayBuilder2().setContent(_ChartManager.wrap(line, options.codeBlock));
+  }
+  /**
+   * Several curves in ONE TextDisplay, the sparkline counterpart of progressBars().
+   * Labels are padded to the longest one so every curve starts at the same column.
+   */
+  static sparklines(rows, options = {}) {
+    const width = rows.reduce((longest, row) => Math.max(longest, row.label.length), 0);
+    const base = _ChartManager.withSharedScale(rows, options);
+    const lines = rows.map((row) => {
+      const opts = { ...base, ...row.options };
+      return `${row.label.padEnd(width, " ")} : ${_ChartManager.renderSpark(row.values, opts)}`;
+    });
+    return new TextDisplayBuilder2().setContent(_ChartManager.wrap(lines.join("\n"), options.codeBlock));
+  }
+  /**
+   * Only fills the bounds that were not given explicitly, and only when asked : a row
+   * setting its own min/max still wins, since row options are spread after these.
+   */
+  static withSharedScale(rows, options) {
+    if (!options.sharedScale) return options;
+    if (options.min !== void 0 && options.max !== void 0) return options;
+    const points = rows.flatMap((row) => row.values).filter((v) => Number.isFinite(v));
+    if (points.length === 0) return options;
+    return {
+      ...options,
+      min: options.min ?? Math.min(...points),
+      max: options.max ?? Math.max(...points)
+    };
+  }
+  static renderBar(value, max, options) {
+    const width = Math.max(1, Math.trunc(options.width ?? 10));
+    const filled = options.filled ?? "\u2588";
+    const empty = options.empty ?? "\u2591";
+    const ratio = _ChartManager.clamp01(value / max);
+    const filledCount = Math.round(ratio * width);
+    const bar = filled.repeat(filledCount) + empty.repeat(width - filledCount);
+    return bar + _ChartManager.formatValue(value, options);
+  }
+  static renderSpark(values, options) {
+    const maxPoints = Math.max(1, Math.trunc(options.maxPoints ?? DEFAULT_MAX_POINTS));
+    const points = values.filter((v) => Number.isFinite(v)).slice(-maxPoints);
+    if (points.length === 0) return EMPTY;
+    const lo = options.min ?? Math.min(...points);
+    const hi = options.max ?? Math.max(...points);
+    const middle = SPARK_BLOCKS[Math.floor(SPARK_BLOCKS.length / 2) - 1];
+    const curve = hi === lo ? middle.repeat(points.length) : points.map((v) => {
+      const level = Math.round(_ChartManager.clamp01((v - lo) / (hi - lo)) * (SPARK_BLOCKS.length - 1));
+      return SPARK_BLOCKS[level];
+    }).join("");
+    const last = points[points.length - 1];
+    return curve + _ChartManager.formatValue(last, { ...options, unit: options.unit ?? "" });
+  }
+  static formatValue(value, options) {
+    if (options.showValue === false) return "";
+    const decimals = Math.max(0, Math.trunc(options.decimals ?? 1));
+    const printable = Number.isFinite(value) ? value.toFixed(decimals) : "?";
+    const unit = options.unit ?? "%";
+    return unit ? ` ${printable} ${unit}` : ` ${printable}`;
+  }
+  /**
+   * TextDisplayBuilder.setContent() rejects an empty string, so an empty row list must
+   * still render something rather than throw at build time.
+   */
+  static wrap(content, codeBlock) {
+    const body = content.length > 0 ? content : EMPTY;
+    return codeBlock ? "```\n" + body + "\n```" : body;
+  }
+  static clamp01(ratio) {
+    if (!Number.isFinite(ratio)) return 0;
+    return Math.min(1, Math.max(0, ratio));
+  }
+};
+
 // src/manager/interactible/ButtonManager.ts
 import {
   ButtonBuilder as ButtonBuilder2,
@@ -2546,7 +2651,7 @@ var DiscordRegex = class {
   // Caractères spéciaux
   static SPACE = "\u200B";
   // URLs basiques
-  static URL_REGEX = /(https?:\/\/[^s]+)/;
+  static URL_REGEX = /(https?:\/\/[^\s<>]+)/i;
   /* DISCORD REGEX */
   static USER_REGEX = /<@\d{18}>/;
   static BOT_REGEX = /<@\d{19}>/;
@@ -2659,6 +2764,7 @@ export {
   BotEnv,
   ButtonManager,
   CacheManager,
+  ChartManager,
   ComponentManager,
   DiscordRegex,
   EmbedManager,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spatulox/simplediscordbot",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "author": "Spatulox",
   "description": "Simple discord bot framework to set up a bot under 30 secondes",
   "exports": {

package/prompt-message-for-wiki.txt

@@ -1,18 +1,18 @@
-Rédige une page de wiki au format suivant :
-
-- Utilise le langage Markdown.
-- Commence par un en‑tête `## [NomDeLaClasse / NomDuModule]`.
-- Ajoute un bref paragraphe introductif qui explique en 1–2 phrases ce que cette classe / ce module fait.
-- Ensuite, utilise des sous‑titres courtes (au maximum 6 mots) comme :
-  - `### Core behavior`
-  - `### Main methods`
-  - `### Exemple d’utilisation`
-  - `### Typique usage`
-- Pour chaque section, rédige 2–3 phrases max, claires et concises.
-- Évite les résumés / conclusions à la fin; limite le contenu exactement aux sections utiles.
-- Si la classe est un helper ou un utils, explique aussi comment l’utilisateur doit l’instancier / l’utiliser dans son code.
-- Si la classe fait partie d’un système plus large (ex. module system, manager, interaction router), place un petit paragraphe qui montre où elle s’insère dans l’architecture globale.
-- Ne fais pas de liste de toutes les méthodes une par une; regroupe‑les par rôle ou par type (ex. “methods for reading files”, “methods for sending messages”).
-- Termine par une petite section `### Typical usage` avec 1–2 exemples de code courts et concrets en TypeScript, montrant comment l’utiliser dans un contexte de bot Discord.
-
+Rédige une page de wiki en anglais au format suivant :
+
+- Utilise le langage Markdown.
+- Commence par un en‑tête `## [NomDeLaClasse / NomDuModule]`.
+- Ajoute un bref paragraphe introductif qui explique en 1–2 phrases ce que cette classe / ce module fait.
+- Ensuite, utilise des sous‑titres courtes (au maximum 6 mots) comme :
+  - `### Core behavior`
+  - `### Main methods`
+  - `### Exemple d’utilisation`
+  - `### Typique usage`
+- Pour chaque section, rédige 2–3 phrases max, claires et concises.
+- Évite les résumés / conclusions à la fin; limite le contenu exactement aux sections utiles.
+- Si la classe est un helper ou un utils, explique aussi comment l’utilisateur doit l’instancier / l’utiliser dans son code.
+- Si la classe fait partie d’un système plus large (ex. module system, manager, interaction router), place un petit paragraphe qui montre où elle s’insère dans l’architecture globale.
+- Ne fais pas de liste de toutes les méthodes une par une; regroupe‑les par rôle ou par type (ex. “methods for reading files”, “methods for sending messages”).
+- Termine par une petite section `### Typical usage` avec 1–2 exemples de code courts et concrets en TypeScript, montrant comment l’utiliser dans un contexte de bot Discord.
+
 Tout doit rester lisible, orienté développeur, sans entrer dans des détails implémentatoires trop bas‑niveau.