emoji-banner-generator 1.0.0

package/dist/cli.js

@@ -0,0 +1,174 @@
+/**
+ * CLI module
+ * Handles command line argument parsing
+ */
+import { Command } from 'commander';
+import fs from 'fs/promises';
+import { DEFAULT_FONT_NAME } from './fonts.js';
+/**
+ * Valid emoji modes
+ */
+const VALID_MODES = [
+    'random',
+    'row',
+    'column',
+    'row-gradient',
+    'column-gradient',
+];
+/**
+ * Valid output formats
+ */
+const VALID_FORMATS = ['text', 'slack'];
+/**
+ * Valid themes
+ */
+const VALID_THEMES = ['default', 'github'];
+/**
+ * Create and configure the CLI program
+ */
+export function createCLI() {
+    const program = new Command();
+    program
+        .name('emoji-banner')
+        .description('Convert text to emoji banner art for CLI display\n\n' +
+        'Examples:\n' +
+        '  $ emoji-banner "Hello" -e 🔥\n' +
+        '  $ emoji-banner "World" -e fire\n' +
+        '  $ emoji-banner "Test" -e "🔥,⭐,💎" -m row-gradient\n' +
+        '  $ emoji-banner "GitHub" --theme github\n' +
+        '  $ emoji-banner "Slack" -e 🎉 --format slack')
+        .version('1.0.0')
+        .argument('[text]', 'Text to convert to emoji banner')
+        .option('-e, --emoji <emoji>', 'Emoji to use (can be emoji or alias, comma-separated for multiple)', '🔥')
+        .option('-b, --background <emoji>', 'Background emoji (default: space)')
+        .option('-f, --file <path>', 'Read text from file instead of argument')
+        .option('-c, --copy', 'Copy result to clipboard')
+        .option('--format <format>', 'Output format (text, slack)', 'text')
+        .option('--theme <theme>', 'Theme to use (default, github)', 'default')
+        .option('-m, --mode <mode>', 'Emoji selection mode when multiple emojis provided (random, row, column, row-gradient, column-gradient)', 'random')
+        .option('--font <font>', 'Pixel font to use', DEFAULT_FONT_NAME)
+        .option('--border [emoji]', 'Add an outer border. Emoji optional; defaults to the background emoji when omitted.')
+        .addHelpText('after', `
+Emoji Input:
+  You can specify emojis in several ways:
+  - Direct emoji: 🔥, ⭐, 💎
+  - Alias with colons: :fire:, :star:
+  - Alias without colons: fire, star
+  - Multiple emojis (comma-separated): 🔥,⭐,💎 or fire,star,gem
+
+Emoji Modes (when multiple emojis provided):
+  - random: Random emoji for each dot
+  - row: Different emoji per row
+  - column: Different emoji per column  
+  - row-gradient: Gradient across rows
+  - column-gradient: Gradient across columns
+
+Themes:
+  - default: Uses the specified emoji(s)
+  - github: GitHub contribution graph style with green squares
+
+Output Formats:
+  - text: Plain text (default)
+  - slack: Slack Block Kit JSON format
+`);
+    return program;
+}
+/**
+ * Parse and validate CLI options
+ */
+export async function parseCLIOptions(program) {
+    const opts = program.opts();
+    const args = program.args;
+    // Get text from argument or file
+    let text = args[0];
+    if (opts.file) {
+        // Read from file
+        text = await readTextFromFile(opts.file);
+    }
+    // Validate mode
+    const mode = opts.mode;
+    if (!VALID_MODES.includes(mode)) {
+        throw new Error(`Invalid mode: ${mode}. Valid modes are: ${VALID_MODES.join(', ')}`);
+    }
+    // Validate format
+    const format = opts.format;
+    if (!VALID_FORMATS.includes(format)) {
+        throw new Error(`Invalid format: ${format}. Valid formats are: ${VALID_FORMATS.join(', ')}`);
+    }
+    // Validate theme
+    const theme = opts.theme;
+    if (!VALID_THEMES.includes(theme)) {
+        throw new Error(`Invalid theme: ${theme}. Valid themes are: ${VALID_THEMES.join(', ')}`);
+    }
+    return {
+        text,
+        file: opts.file,
+        emoji: opts.emoji,
+        background: opts.background,
+        copy: opts.copy || false,
+        format,
+        theme,
+        mode,
+        font: opts.font,
+        border: opts.border,
+    };
+}
+/**
+ * Read text from file with validation
+ */
+async function readTextFromFile(filePath) {
+    // Validate file path
+    if (!filePath || typeof filePath !== 'string') {
+        throw new Error('Invalid file path');
+    }
+    // Check for path traversal attempts
+    if (filePath.includes('..')) {
+        throw new Error('Path traversal not allowed');
+    }
+    try {
+        // Check file exists and is readable
+        await fs.access(filePath, fs.constants.R_OK);
+        // Get file stats
+        const stats = await fs.stat(filePath);
+        // Limit file size (1MB max)
+        const maxSize = 1024 * 1024;
+        if (stats.size > maxSize) {
+            throw new Error(`File too large. Maximum size is ${maxSize} bytes`);
+        }
+        // Read file content
+        const content = await fs.readFile(filePath, 'utf-8');
+        // Return trimmed content
+        return content.trim();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.message.includes('ENOENT')) {
+                throw new Error(`File not found: ${filePath}`);
+            }
+            if (error.message.includes('EACCES')) {
+                throw new Error(`Permission denied: ${filePath}`);
+            }
+            throw error;
+        }
+        throw new Error(`Failed to read file: ${filePath}`);
+    }
+}
+/**
+ * Validate that required options are provided
+ */
+export function validateOptions(options) {
+    if (!options.text && !options.file) {
+        throw new Error('Text is required. Provide text as an argument or use --file option.\n' +
+            'Run with --help for usage information.');
+    }
+    if (!options.emoji) {
+        throw new Error('Emoji is required. Use --emoji option.');
+    }
+    if (options.border) {
+        const backgroundProvided = Boolean(options.background) || options.theme === 'github';
+        if (!backgroundProvided) {
+            throw new Error('Border requires a background emoji. Specify --background <emoji>.');
+        }
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/clipboard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Clipboard module
+ * Handles copying text to system clipboard
+ */
+/**
+ * Copy text to clipboard
+ */
+export declare function copyToClipboard(text: string): Promise<void>;
+/**
+ * Read from clipboard (for testing purposes)
+ */
+export declare function readFromClipboard(): Promise<string>;
+/**
+ * Check if clipboard is available
+ */
+export declare function isClipboardAvailable(): Promise<boolean>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAOzD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ7D"}

package/dist/clipboard.js

@@ -0,0 +1,47 @@
+/**
+ * Clipboard module
+ * Handles copying text to system clipboard
+ */
+import clipboardy from 'clipboardy';
+/**
+ * Copy text to clipboard
+ */
+export async function copyToClipboard(text) {
+    if (!text || typeof text !== 'string') {
+        throw new Error('Invalid text for clipboard');
+    }
+    try {
+        await clipboardy.write(text);
+    }
+    catch (error) {
+        // Handle clipboard access errors gracefully
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to copy to clipboard: ${errorMessage}`);
+    }
+}
+/**
+ * Read from clipboard (for testing purposes)
+ */
+export async function readFromClipboard() {
+    try {
+        return await clipboardy.read();
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        throw new Error(`Failed to read from clipboard: ${errorMessage}`);
+    }
+}
+/**
+ * Check if clipboard is available
+ */
+export async function isClipboardAvailable() {
+    try {
+        // Try to read clipboard - this will fail if not available
+        await clipboardy.read();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4CAA4C;QAC5C,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC;QACH,0DAA0D;QAC1D,MAAM,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/emoji.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Emoji handling module
+ * Resolves emoji aliases and handles direct emoji input
+ */
+/**
+ * Resolve an emoji input to an actual emoji character
+ * Supports:
+ * - Direct emoji: 🔥
+ * - Alias with colons: :fire:
+ * - Alias without colons: fire
+ */
+export declare function resolveEmoji(input: string): string;
+/**
+ * Parse comma-separated emoji input into array of resolved emojis
+ */
+export declare function parseEmojis(input: string): string[];
+/**
+ * Get a default background emoji (empty space with proper width)
+ */
+export declare function getBackgroundEmoji(): string;
+/**
+ * Validate that the resolved emoji is valid
+ */
+export declare function validateEmoji(emoji: string): boolean;
+//# sourceMappingURL=emoji.d.ts.map

package/dist/emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji.d.ts","sourceRoot":"","sources":["../src/emoji.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6GH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6ClD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAYnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/emoji.js

@@ -0,0 +1,180 @@
+/**
+ * Emoji handling module
+ * Resolves emoji aliases and handles direct emoji input
+ */
+import * as nodeEmoji from 'node-emoji';
+// Common emoji aliases mapping (subset for fallback)
+const CUSTOM_ALIASES = {
+    // Colored squares for themes
+    'green_square': '🟩',
+    'white_square': '⬜',
+    'black_square': '⬛',
+    'red_square': '🟥',
+    'blue_square': '🟦',
+    'yellow_square': '🟨',
+    'orange_square': '🟧',
+    'purple_square': '🟪',
+    'brown_square': '🟫',
+    // Common emojis
+    'star': '⭐',
+    'fire': '🔥',
+    'heart': '❤️',
+    'smile': '😊',
+    'rocket': '🚀',
+    'check': '✅',
+    'x': '❌',
+    'warning': '⚠️',
+    'sparkles': '✨',
+    'thumbsup': '👍',
+    'thumbs_up': '👍',
+    'clap': '👏',
+    'wave': '👋',
+    'eyes': '👀',
+    'thinking': '🤔',
+    'party': '🎉',
+    'tada': '🎉',
+    'sun': '☀️',
+    'moon': '🌙',
+    'cloud': '☁️',
+    'rain': '🌧️',
+    'snow': '❄️',
+    'tree': '🌳',
+    'flower': '🌸',
+    'muscle': '💪',
+    'coffee': '☕',
+    'beer': '🍺',
+    'pizza': '🍕',
+    'apple': '🍎',
+    'banana': '🍌',
+    'cat': '🐱',
+    'dog': '🐶',
+    'bird': '🐦',
+    'fish': '🐟',
+    'bug': '🐛',
+    'ghost': '👻',
+    'alien': '👽',
+    'robot': '🤖',
+    'skull': '💀',
+    'poop': '💩',
+    '100': '💯',
+    'money': '💰',
+    'gem': '💎',
+    'crown': '👑',
+    'trophy': '🏆',
+    'medal': '🏅',
+    'flag': '🚩',
+    'pin': '📌',
+    'bell': '🔔',
+    'key': '🔑',
+    'lock': '🔒',
+    'bulb': '💡',
+    'book': '📚',
+    'pencil': '✏️',
+    'scissors': '✂️',
+    'hammer': '🔨',
+    'wrench': '🔧',
+    'gear': '⚙️',
+    'link': '🔗',
+    'bomb': '💣',
+    'zap': '⚡',
+    'dizzy': '💫',
+    'boom': '💥',
+    'droplet': '💧',
+    'leaves': '🍃',
+    'cactus': '🌵',
+    'palm': '🌴',
+    'maple': '🍁',
+    'cherry_blossom': '🌸',
+    'rose': '🌹',
+    'tulip': '🌷',
+    'sunflower': '🌻',
+};
+/**
+ * Check if a string is an emoji (contains emoji characters)
+ */
+function isEmoji(str) {
+    // Emoji regex pattern - covers most common emoji ranges
+    const emojiRegex = /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]|[\u{1F600}-\u{1F64F}]|[\u{1F680}-\u{1F6FF}]|[\u{1F1E0}-\u{1F1FF}]|[\u{2300}-\u{23FF}]|[\u{2B50}]|[\u{2934}-\u{2935}]|[\u{25AA}-\u{25AB}]|[\u{25B6}]|[\u{25C0}]|[\u{25FB}-\u{25FE}]|[\u{2614}-\u{2615}]|[\u{2648}-\u{2653}]|[\u{267F}]|[\u{2693}]|[\u{26A1}]|[\u{26AA}-\u{26AB}]|[\u{26BD}-\u{26BE}]|[\u{26C4}-\u{26C5}]|[\u{26CE}]|[\u{26D4}]|[\u{26EA}]|[\u{26F2}-\u{26F3}]|[\u{26F5}]|[\u{26FA}]|[\u{26FD}]|[\u{2702}]|[\u{2705}]|[\u{2708}-\u{270D}]|[\u{270F}]|[\u{2712}]|[\u{2714}]|[\u{2716}]|[\u{271D}]|[\u{2721}]|[\u{2728}]|[\u{2733}-\u{2734}]|[\u{2744}]|[\u{2747}]|[\u{274C}]|[\u{274E}]|[\u{2753}-\u{2755}]|[\u{2757}]|[\u{2763}-\u{2764}]|[\u{2795}-\u{2797}]|[\u{27A1}]|[\u{27B0}]|[\u{27BF}]|[\u{2B05}-\u{2B07}]|[\u{2B1B}-\u{2B1C}]|[\u{2B55}]|[\u{3030}]|[\u{303D}]|[\u{3297}]|[\u{3299}]|[\u{FE00}-\u{FE0F}]|[\u{200D}]/u;
+    return emojiRegex.test(str);
+}
+/**
+ * Remove colons from alias if present
+ * :fire: -> fire
+ * fire -> fire
+ */
+function normalizeAlias(alias) {
+    return alias.replace(/^:/, '').replace(/:$/, '').trim();
+}
+/**
+ * Resolve an emoji input to an actual emoji character
+ * Supports:
+ * - Direct emoji: 🔥
+ * - Alias with colons: :fire:
+ * - Alias without colons: fire
+ */
+export function resolveEmoji(input) {
+    const trimmed = input.trim();
+    // If it's already an emoji, return as is
+    if (isEmoji(trimmed)) {
+        return trimmed;
+    }
+    // Normalize the alias (remove colons if present)
+    const alias = normalizeAlias(trimmed);
+    // Try node-emoji first
+    const resolved = nodeEmoji.get(alias);
+    if (resolved && resolved !== `:${alias}:`) {
+        return resolved;
+    }
+    // Try custom aliases
+    if (CUSTOM_ALIASES[alias]) {
+        return CUSTOM_ALIASES[alias];
+    }
+    // Try with underscores replaced by different variations
+    const variations = [
+        alias,
+        alias.replace(/-/g, '_'),
+        alias.replace(/_/g, '-'),
+        alias.toLowerCase(),
+        alias.toUpperCase(),
+    ];
+    for (const variant of variations) {
+        const result = nodeEmoji.get(variant);
+        if (result && result !== `:${variant}:`) {
+            return result;
+        }
+        if (CUSTOM_ALIASES[variant]) {
+            return CUSTOM_ALIASES[variant];
+        }
+    }
+    // If nothing found, return the input (it might be a custom character)
+    // But warn the user
+    console.warn(`Warning: Could not resolve emoji "${input}", using as-is`);
+    return trimmed;
+}
+/**
+ * Parse comma-separated emoji input into array of resolved emojis
+ */
+export function parseEmojis(input) {
+    if (!input || typeof input !== 'string') {
+        throw new Error('Emoji input is required');
+    }
+    const parts = input.split(',').map((s) => s.trim()).filter(Boolean);
+    if (parts.length === 0) {
+        throw new Error('At least one emoji is required');
+    }
+    return parts.map(resolveEmoji);
+}
+/**
+ * Get a default background emoji (empty space with proper width)
+ */
+export function getBackgroundEmoji() {
+    // Use a full-width space to keep alignment when no background is provided
+    return '　';
+}
+/**
+ * Validate that the resolved emoji is valid
+ */
+export function validateEmoji(emoji) {
+    return emoji.length > 0;
+}
+//# sourceMappingURL=emoji.js.map

package/dist/emoji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji.js","sourceRoot":"","sources":["../src/emoji.ts"],"names":[],"mappings":"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"}

package/dist/fonts.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pixel font definitions for rendering text into bitmaps.
+ * Each character is represented by a 2D pattern using # for filled pixels.
+ */
+export interface PixelFont {
+    /** Font name */
+    name: string;
+    /** Number of rows in each character */
+    height: number;
+    /** Spaces between characters */
+    letterSpacing: number;
+    /** Spaces between lines */
+    lineSpacing: number;
+    /** Character bitmap patterns */
+    map: Record<string, string[]>;
+}
+export declare const DEFAULT_FONT_NAME = "block";
+/**
+ * Retrieve a font by name. Falls back to default if not found.
+ */
+export declare function getFont(name?: string): PixelFont;
+/**
+ * List available font names.
+ */
+export declare function getAvailableFonts(): string[];
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/B;AAED,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAyhBzC;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,MAA0B,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C"}