@spatulox/simplediscordbot 3.0.3 → 3.1.1

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 Date format : dd/mm/yyyy
 
+### 21/09/2026 - 3.1.1
+- Add :
+    - `ComponentManager.chart(container, chart, separator?)` : adds one chart or an array of charts to a container, like `field()` / `mediaGallery()` / `selectMenu()` do, instead of calling `container.addTextDisplayComponents()` by hand. No separator by default
+
+### 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/README.md

@@ -13,6 +13,7 @@
 > - 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)
 

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, TextDisplayBuilder, AttachmentBuilder, ButtonStyle } from 'discord.js';
 import { BaseSelectMenuBuilder } from '@discordjs/builders';
 export { CacheManager, FileManager, Log, SimpleMutex, Time } from '@spatulox/utils';
 
@@ -701,6 +701,14 @@ declare class ComponentManager {
      * Multiple fields
      */
     static fields(container: ContainerBuilder, fields: ComponentManagerField[]): ContainerBuilder;
+    /**
+     * Add chart(s) built by the ChartManager, so a dashboard reads like the other helpers :
+     * `ComponentManager.chart(container, ChartManager.progressBars([...]))` instead of
+     * `container.addTextDisplayComponents(...)`.
+     * No separator by default : stacked charts are meant to be read as one block
+     */
+    static chart(container: ContainerBuilder, chart: TextDisplayBuilder[], separator?: SeparatorSpacingSize | false): ContainerBuilder;
+    static chart(container: ContainerBuilder, chart: TextDisplayBuilder, separator?: SeparatorSpacingSize | false): ContainerBuilder;
     /**
      * Add a media gallery (links)
      */
@@ -737,6 +745,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 +941,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, TextDisplayBuilder, AttachmentBuilder, ButtonStyle } from 'discord.js';
 import { BaseSelectMenuBuilder } from '@discordjs/builders';
 export { CacheManager, FileManager, Log, SimpleMutex, Time } from '@spatulox/utils';
 
@@ -701,6 +701,14 @@ declare class ComponentManager {
      * Multiple fields
      */
     static fields(container: ContainerBuilder, fields: ComponentManagerField[]): ContainerBuilder;
+    /**
+     * Add chart(s) built by the ChartManager, so a dashboard reads like the other helpers :
+     * `ComponentManager.chart(container, ChartManager.progressBars([...]))` instead of
+     * `container.addTextDisplayComponents(...)`.
+     * No separator by default : stacked charts are meant to be read as one block
+     */
+    static chart(container: ContainerBuilder, chart: TextDisplayBuilder[], separator?: SeparatorSpacingSize | false): ContainerBuilder;
+    static chart(container: ContainerBuilder, chart: TextDisplayBuilder, separator?: SeparatorSpacingSize | false): ContainerBuilder;
     /**
      * Add a media gallery (links)
      */
@@ -737,6 +745,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 +941,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.2",
+  version: "3.1.0",
   author: "Spatulox",
   description: "Simple discord bot framework to set up a bot under 30 secondes",
   exports: {
@@ -2370,6 +2371,16 @@ var ComponentManager = class {
     });
     return container;
   }
+  static chart(container, chart, separator = false) {
+    const charts = Array.isArray(chart) ? chart : [chart];
+    charts.forEach((c) => {
+      container.addTextDisplayComponents(c);
+      if (separator !== false) {
+        container.addSeparatorComponents(this.separator(separator));
+      }
+    });
+    return container;
+  }
   /**
    * Add a media gallery (links)
    */
@@ -2465,30 +2476,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 +2616,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 +2626,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 +2637,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)];
   }
 };
 
@@ -2652,6 +2768,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.2",
+  version: "3.1.0",
   author: "Spatulox",
   description: "Simple discord bot framework to set up a bot under 30 secondes",
   exports: {
@@ -2373,6 +2373,16 @@ var ComponentManager = class {
     });
     return container;
   }
+  static chart(container, chart, separator = false) {
+    const charts = Array.isArray(chart) ? chart : [chart];
+    charts.forEach((c) => {
+      container.addTextDisplayComponents(c);
+      if (separator !== false) {
+        container.addSeparatorComponents(this.separator(separator));
+      }
+    });
+    return container;
+  }
   /**
    * Add a media gallery (links)
    */
@@ -2468,6 +2478,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,
@@ -2659,6 +2774,7 @@ export {
   BotEnv,
   ButtonManager,
   CacheManager,
+  ChartManager,
   ComponentManager,
   DiscordRegex,
   EmbedManager,

package/package.json

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