artscii 0.3.1 → 0.3.2

package/dist/banner.d.ts

@@ -0,0 +1,7 @@
+export declare const BANNER_FONTS: readonly ["Standard", "Small", "Slant", "Big", "Mini"];
+export type BannerFont = (typeof BANNER_FONTS)[number];
+export declare function renderBanner(text: string, font?: BannerFont): string;
+export declare function listBannerFonts(): {
+    name: BannerFont;
+    description: string;
+}[];

package/dist/banner.js

@@ -0,0 +1,14 @@
+import figlet from 'figlet';
+export const BANNER_FONTS = ['Standard', 'Small', 'Slant', 'Big', 'Mini'];
+export function renderBanner(text, font = 'Standard') {
+    return figlet.textSync(text, { font });
+}
+export function listBannerFonts() {
+    return [
+        { name: 'Standard', description: 'Default balanced font' },
+        { name: 'Small', description: 'Compact, saves tokens' },
+        { name: 'Slant', description: 'Italic style' },
+        { name: 'Big', description: 'Bold emphasis' },
+        { name: 'Mini', description: 'Minimal 3-line font' },
+    ];
+}

package/dist/index.js

@@ -7,6 +7,7 @@ import { MAX_NAME_LENGTH, MAX_TAG_LENGTH, MAX_TAGS, MAX_DESCRIPTION_LENGTH, CONV
 import { resolveImageInput, ConvertInputError } from './resolve.js';
 import { convertImage } from './converter.js';
 import { createRateLimiter } from './rate-limit.js';
+import { renderBanner, listBannerFonts, BANNER_FONTS } from './banner.js';
 const app = new Hono();
 app.use('*', cors());
 const checkRateLimit = createRateLimiter(RATE_LIMIT_PER_MIN);
@@ -26,6 +27,8 @@ app.get('/', (c) => c.json({
         category: 'GET /categories/:name',
         list: 'GET /list',
         convert: 'POST /convert { url?, base64?, size?, invert?, contrast?, gamma?, save? }',
+        banner: 'GET /banner?text={text}&font=Standard|Small|Slant|Big|Mini',
+        bannerFonts: 'GET /banner/fonts',
         kaomoji: 'GET /kaomoji?q={query}',
         kaomojiRandom: 'GET /kaomoji/random',
         kaomojiCategories: 'GET /kaomoji/categories',
@@ -144,6 +147,23 @@ app.delete('/art/:id', async (c) => {
         return c.json({ error: e.message ?? 'Unknown error' }, (e.status ?? 500));
     }
 });
+// --- Banner endpoints ---
+app.get('/banner', (c) => {
+    const text = c.req.query('text');
+    if (!text)
+        return c.json({ error: 'query parameter "text" is required' }, 400);
+    if (text.length > 50)
+        return c.json({ error: '"text" must be 50 chars or less' }, 400);
+    const fontParam = c.req.query('font') ?? 'Standard';
+    if (!BANNER_FONTS.includes(fontParam)) {
+        return c.json({ error: `Invalid font. Available: ${BANNER_FONTS.join(', ')}` }, 400);
+    }
+    const banner = renderBanner(text, fontParam);
+    return c.text(banner);
+});
+app.get('/banner/fonts', (c) => {
+    return c.json(listBannerFonts());
+});
 // --- Kaomoji endpoints ---
 app.get('/kaomoji', (c) => {
     const q = c.req.query('q');

package/dist/mcp.js

@@ -7,6 +7,7 @@ import { loadKaomoji, searchKaomoji, getRandomKaomoji, listKaomojiCategories, ge
 import { MAX_NAME_LENGTH, MAX_TAG_LENGTH, MAX_TAGS, MAX_DESCRIPTION_LENGTH, SIZE_LIMITS, DEFAULT_SIZE } from './constants.js';
 import { resolveImageInput } from './resolve.js';
 import { convertImage } from './converter.js';
+import { renderBanner, BANNER_FONTS } from './banner.js';
 const server = new McpServer({
     name: 'artscii',
     version: '0.3.0',
@@ -61,6 +62,13 @@ server.tool('categories', 'List all categories.', {}, async () => {
     const cats = listCategories();
     return { content: [{ type: 'text', text: cats.join(', ') }] };
 });
+server.tool('banner', 'Render text as a large ASCII banner using FIGlet fonts. Great for CLI headers, welcome messages, and titles.', {
+    text: z.string().max(50).describe('Text to render (max 50 chars)'),
+    font: z.enum(BANNER_FONTS).default('Standard').describe('Font: Standard (default), Small (compact), Slant (italic), Big (bold), Mini (minimal)'),
+}, async ({ text, font }) => {
+    const banner = renderBanner(text, font);
+    return { content: [{ type: 'text', text: banner }] };
+});
 server.tool('kaomoji', 'Get a kaomoji (Japanese text emoticon) by emotion or keyword. Perfect for inline text expressions.', {
     query: z.string().optional().describe('Emotion or keyword (e.g. "happy", "sad", "cat", "shrug"). Omit for random.'),
     category: z.string().optional().describe('Filter by category (e.g. "happy", "animals", "table-flip")'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "artscii",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "ASCII art & kaomoji search MCP server for AI agents",
   "mcpName": "io.github.rxolve/artscii",
   "type": "module",
@@ -39,11 +39,13 @@
   "dependencies": {
     "@hono/node-server": "^1.19.12",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "figlet": "^1.11.0",
     "hono": "^4.12.9",
     "sharp": "^0.34.5",
     "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@types/figlet": "^1.7.0",
     "@types/node": "^25.5.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2"