🎨 XDCanvas

> The ultimate canvas library for Discord bots.
> Fast, Modular, and Easy to use.

!License
!Version
!TypeScript

XDCanvas is a powerful graphics library designed specifically for Discord.js bots. It simplifies the creation of welcome cards, profile cards, rank cards, and custom images with a fluent, chainable API.

---

🚀 Features

$3

- CanvasBuilder: Fluent API to build images layer by layer.
- Universal Styles: Set opacity, blend modes, rotation, and shadows on ANY layer.
- Text Engine: Auto-fit text, multi-line wrapping, emoji support, stroke, and shadows.
- Shapes & Gradients: Easy-to-use gradient painter and shape renderer.

$3

- Modular Architecture: 30+ new functions in ColorUtils.
- Manipulation: Lighten, Darken, Saturate, Mix, Tint, Shade, Warm, Cold.
- Analysis: Luminance, Contrast Ratio, Readability, Temperature.
- Generators: Random, Pastel, Neon, Gradients, Harmonies, Noise.
- Accessibility: Color Blindness Simulation (Protanopia, Deuteranopia, etc.).

$3

- Basic: Clamp, Map, Round, IsBetween, Normalize, Factorial, Percent.
- Interpolation: Lerp, SmoothStep, Sigmoid, Easing (Quad, Cubic, Expo).
- Random: Int, Float, Weighted, Choice, Gaussian (Normal Distribution).
- Geometry: Distance, Angle, Hypotenuse, PolarToCartesian, Collision Check.
- Statistics: Moving Average, Linear Regression.

$3

- Text Enhancements: Auto Fit, Advanced Wrap.
- Filters: Grayscale, Sepia, Duotone, Tint, Hue Rotate, Blur, Pixelate, Noise.
- Patterns: Grid, Stripes, Polka Dots, Repeated Image.
- Effects: Drop Shadow, Inner Shadow, Glow, Neon, Masks (Circular, Radial).
- Layout: Auto Resize, Auto Center, Smart Crop, Borders.

$3

- Case: Capitalize, Title Case, Camel/Pascal/Snake/Kebab.
- Sanitize: Remove Accents, Safe Filename, Strip Emojis.
- Analyze: Word Count, Extract Numbers/Tags, Is Emoji.
- Manipulate: Slugify, Limit Words, Reverse, Abbreviate.

$3

- Canvas Effects: Gradient, Neon, Glitch, Outlined Text.
- Formatters: Duration, Relative Time, Bytes, Compact Numbers.
- Composition: Grid Layouts, Mirror Reflections.

$3

- DiscordHelper: Fetch User Avatars, Banners, and Guild Icons directly from Discord CDN.
- Rate Limit Handling: Built-in backoff and retry logic for 429 errors.
- Smart Fallbacks: Automatically generates fallbacks if a banner or icon is missing.

$3

- Smart Resize: cover, contain, and scale-down modes.
- Filters: Rounded corners, circular cropping, borders, grayscale, invert.
- Optimization: Efficient buffer management.

$3

- WelcomeCard: Beautiful welcome banners out of the box.
- ProfileCard: Display user stats, level, and XP.
- RankCard: Leaderboard style cards.

---

📦 Installation

``bash
npm install xdcanvas
`

> Note: Requires Node.js 18+ and @napi-rs/canvas.

---

🛠️ Quick Start

$3

`javascript
const { CanvasBuilder, AttachmentBuilder } = require('xdcanvas');
const fs = require('fs');

async function create() {
const builder = new CanvasBuilder(800, 300)
.setBackground('#2b2b2b')
.addLayer({
render: (ctx) => {
ctx.fillStyle = '#ffffff';
ctx.font = '50px Arial';
ctx.fillText('Hello XDCanvas!', 50, 150);
}
});

const buffer = await builder.build();
fs.writeFileSync('hello.png', buffer);
}

create();
`

$3

`typescript
import { Client, Events, AttachmentBuilder } from 'discord.js';
import { CanvasBuilder, DiscordHelper, ImageLayer } from 'xdcanvas';

client.on(Events.MessageCreate, async (message) => {
if (message.content === '!profile') {
const user = message.author;

// Fetch Avatar & Banner
const avatar = await DiscordHelper.getUserAvatar(user.id, user.avatar);
const banner = await DiscordHelper.getUserBanner(user.id, user.banner);

// Build Canvas
const buffer = await new CanvasBuilder(800, 400)
.addLayer(new ImageLayer(banner, 0, 0, 800, 400).fit('cover').opacity(0.5))
.addLayer(new ImageLayer(avatar, 50, 50, 150, 150).setCircular(true).shadow({ blur: 20, color: 'black' }))
.build();

message.reply({ files: [new AttachmentBuilder(buffer, { name: 'profile.png' })] });
}
});
``

---

📚 Documentation

Check out the full documentation for detailed guides:

- 📖 GUIDE.md - Complete tutorial from zero to hero.
- 📝 CHANGELOG.md - See what's new.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---