shell-logo 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-logo",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Render colorful ASCII art logos in the terminal from a config file",
   "license": "MIT",

package/src/config.js

@@ -13,6 +13,7 @@ import { readFileSync } from 'node:fs';
 import chalk from 'chalk';
 import { configPath, legacyConfigPath } from './paths.js';
 import { writeConfig } from './generate.js';
+import { SHAPE_NAMES } from './shapes.js';
 
 export const DEFAULTS = {
   colors: ['#ff6b6b', '#feca57', '#48dbfb'],
@@ -21,7 +22,11 @@ export const DEFAULTS = {
 
 /**
  * Parse a JSON string and validate it as a shell-logo config.
- * Requires a non-empty `text` field. Colors must be an array of 2+ if present.
+ *
+ * Supports two modes:
+ *   - "text" (default): requires non-empty `text`, optional `colors`/`font`
+ *   - "shape": requires valid `shape` name, optional `colors`, no `text`/`font` needed
+ *
  * Returns a normalized config object, or null if invalid.
  */
 function parseAndValidate(raw) {
@@ -32,17 +37,32 @@ function parseAndValidate(raw) {
     return null;
   }
 
-  if (!config.text || typeof config.text !== 'string' || config.text.trim() === '') {
-    return null;
-  }
-
   if (config.colors !== undefined) {
     if (!Array.isArray(config.colors) || config.colors.length < 2) {
       return null;
     }
   }
 
+  const mode = config.mode ?? 'text';
+
+  if (mode === 'shape') {
+    if (!config.shape || !SHAPE_NAMES.includes(config.shape)) {
+      return null;
+    }
+    return {
+      mode: 'shape',
+      shape: config.shape,
+      colors: config.colors ?? DEFAULTS.colors,
+    };
+  }
+
+  // mode === 'text' (or absent for backward compatibility)
+  if (!config.text || typeof config.text !== 'string' || config.text.trim() === '') {
+    return null;
+  }
+
   return {
+    mode: 'text',
     text: config.text.trim(),
     colors: config.colors ?? DEFAULTS.colors,
     font: config.font ?? DEFAULTS.font,

package/src/index.js

@@ -13,6 +13,7 @@ import { writeConfig } from './generate.js';
 import { render } from './renderer.js';
 import { getTerminalSize, clearScreen, hideCursor, showCursor, centerContent } from './terminal.js';
 import { THEMES, FONTS } from './themes.js';
+import { SHAPES } from './shapes.js';
 import chalk from 'chalk';
 import * as p from '@clack/prompts';
 
@@ -38,6 +39,8 @@ startRenderLoop(config, persistent);
 function startRenderLoop(config, persistent) {
   let resizeTimer;
 
+  const isShapeMode = config.mode === 'shape';
+
   // Find the current theme index by matching colors
   let themeIndex = THEMES.findIndex(
     (t) => JSON.stringify(t.colors) === JSON.stringify(config.colors)
@@ -47,6 +50,11 @@ function startRenderLoop(config, persistent) {
   let fontIndex = FONTS.indexOf(config.font);
   if (fontIndex === -1) fontIndex = 0;
 
+  let shapeIndex = isShapeMode
+    ? SHAPES.findIndex((s) => s.name === config.shape)
+    : 0;
+  if (shapeIndex === -1) shapeIndex = 0;
+
   let showStatus = false;
   let statusTimer;
 
@@ -56,7 +64,10 @@ function startRenderLoop(config, persistent) {
     clearScreen();
     process.stdout.write(centerContent(art, columns, rows));
     if (showStatus) {
-      const status = `  ${THEMES[themeIndex].name}  ·  ${FONTS[fontIndex]}  ·  ↑↓ theme  ←→ font  q quit`;
+      const lrLabel = isShapeMode
+        ? `${SHAPES[shapeIndex].name}  ·  ←→ shape`
+        : `${FONTS[fontIndex]}  ·  ←→ font`;
+      const status = `  ${THEMES[themeIndex].name}  ·  ${lrLabel}  ·  ↑↓ theme  q quit`;
       process.stdout.write(`\x1B[${rows};1H` + chalk.dim(status));
     }
   }
@@ -109,12 +120,22 @@ function startRenderLoop(config, persistent) {
       } else if (key[2] === 66) { // Arrow Down — next theme
         themeIndex = (themeIndex + 1) % THEMES.length;
         config.colors = THEMES[themeIndex].colors;
-      } else if (key[2] === 67) { // Arrow Right — next font
-        fontIndex = (fontIndex + 1) % FONTS.length;
-        config.font = FONTS[fontIndex];
-      } else if (key[2] === 68) { // Arrow Left — prev font
-        fontIndex = (fontIndex - 1 + FONTS.length) % FONTS.length;
-        config.font = FONTS[fontIndex];
+      } else if (key[2] === 67) { // Arrow Right — next font/shape
+        if (isShapeMode) {
+          shapeIndex = (shapeIndex + 1) % SHAPES.length;
+          config.shape = SHAPES[shapeIndex].name;
+        } else {
+          fontIndex = (fontIndex + 1) % FONTS.length;
+          config.font = FONTS[fontIndex];
+        }
+      } else if (key[2] === 68) { // Arrow Left — prev font/shape
+        if (isShapeMode) {
+          shapeIndex = (shapeIndex - 1 + SHAPES.length) % SHAPES.length;
+          config.shape = SHAPES[shapeIndex].name;
+        } else {
+          fontIndex = (fontIndex - 1 + FONTS.length) % FONTS.length;
+          config.font = FONTS[fontIndex];
+        }
       } else {
         return;
       }

package/src/renderer.js

@@ -1,6 +1,7 @@
 import figlet from 'figlet';
 import gradient from 'gradient-string';
 import { scaleArt } from './scaling.js';
+import { SHAPES } from './shapes.js';
 
 function figletSync(text, font) {
   try {
@@ -11,6 +12,18 @@ function figletSync(text, font) {
 }
 
 export function render(config, columns, rows) {
+  if (config.mode === 'shape') {
+    const shape = SHAPES.find((s) => s.name === config.shape);
+    if (!shape) {
+      const grad = gradient(config.colors);
+      return grad(config.shape);
+    }
+    const trimmed = shape.art.trim();
+    const scaled = scaleArt(trimmed, columns, rows - 2);
+    const grad = gradient(config.colors);
+    return grad.multiline(scaled);
+  }
+
   const art = figletSync(config.text, config.font);
   if (!art) {
     const grad = gradient(config.colors);

package/src/shapes.js

@@ -0,0 +1,239 @@
+export const SHAPES = [
+  {
+    name: 'Pixel',
+    art: `
+   ▄█▄       ▄█▄
+  █████ ▄▄▄ █████
+  ████████████████
+  ██ ▀ █████ ▀ ██
+  ████████████████
+  █████ ▀▀▀ █████
+   ██████████████
+    ████████████
+    ██ █████ ██
+    ▀▀       ▀▀
+    `,
+  },
+  {
+    name: 'Bloop',
+    art: `
+    ▄████████▄
+  ██████████████
+ ████████████████
+ ███▀██████▀█████
+ ████████████████
+ █████ ▀▀▀▀ █████
+ ████████████████
+  ██████████████
+   ▀██████████▀
+     ▀▀    ▀▀
+    `,
+  },
+  {
+    name: 'Octo',
+    art: `
+    ▄████████▄
+  ██████████████
+ ████████████████
+ ███▀██████▀█████
+ ████████████████
+  ██████████████
+ ▐█▌▐█▌ ██ ▐█▌▐█▌
+ ▐█▌▐█▌ ██ ▐█▌▐█▌
+  ▀  ▀  ▀▀  ▀  ▀
+    `,
+  },
+  {
+    name: 'Ghosty',
+    art: `
+    ▄████████▄
+  ██████████████
+ ████████████████
+ ████▀████▀██████
+ ████████████████
+ ████████████████
+ ████████████████
+ ████████████████
+ █▀█ █▀██ █▀█ █▀
+    `,
+  },
+  {
+    name: 'Foxie',
+    art: `
+▄██▄            ▄██▄
+████▄          ▄████
+██████▄▄▄▄▄▄▄▄██████
+████ ▀████████▀ ████
+█████ ▀██████▀ █████
+████████████████████
+ ██████████████████
+  ████████████████
+   ██████████████
+    ▀██████████▀
+    `,
+  },
+  {
+    name: 'Ducky',
+    art: `
+     ▄████▄
+    ████████▄
+   ██▀████████▄
+  ██████████████
+ ████████████████
+ █████████████▀
+  ▀██████████
+   ▀████████▀
+▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+    `,
+  },
+  {
+    name: 'Robo',
+    art: `
+      ▄█▄
+    ▄█████▄
+   ██████████
+   ███▀██▀███
+   ██████████
+   ███▄▀▀▄███
+   ██████████
+  ▐██████████▌
+   ███ ████ ██
+   ██        ██
+   ▀▀        ▀▀
+    `,
+  },
+  {
+    name: 'Cactus',
+    art: `
+       ▄██▄
+       ████
+  ▄██▄ ████
+  ████ ████ ▄██▄
+  ████ ████ ████
+  ▀███▄████▄███▀
+       ████
+       ████
+      ██████
+    ▄████████▄
+    ██████████
+    `,
+  },
+  {
+    name: 'Rocket',
+    art: `
+       ▄▄
+      ████
+     ██████
+     ██████
+    ████████
+    ██ ██ ██
+    ████████
+   ██████████
+  ▄██████████▄
+  ██▀██████▀██
+     ██████
+    ▐██████▌
+   ▄██▀  ▀██▄
+   ▀▀      ▀▀
+    `,
+  },
+  {
+    name: 'Skull',
+    art: `
+    ▄██████▄
+  ████████████
+ ██████████████
+ ███▀██████▀███
+ ██████████████
+  █████▄▄█████
+   ████████████
+   █▀█ ▀▀ █▀█
+   █ █ ██ █ █
+    ▀  ▀▀  ▀
+    `,
+  },
+  {
+    name: 'Penguin',
+    art: `
+     ▄████▄
+   ████████████
+  ██████████████
+  ████▀████▀████
+  █████▀▀▀▀█████
+  ██▌ ▄████▄ ▐██
+  ██▌ ██████ ▐██
+  ██▌ ██████ ▐██
+   ▀▌ ██████ ▐▀
+      ██████
+     ▄██  ██▄
+     ▀▀▀  ▀▀▀
+    `,
+  },
+  {
+    name: 'Mushroom',
+    art: `
+     ▄████▄
+   ▄████████▄
+  ██ ▀████▀ ██
+  ██████████████
+  ██ ▀████▀ ██
+  ██████████████
+   ▀██████████▀
+      ██████
+      ██████
+      ██████
+     ████████
+     ▀▀▀▀▀▀▀▀
+    `,
+  },
+  {
+    name: 'Alien',
+    art: `
+   ▄██████████▄
+  ██████████████
+ ██ ▄████████▄ ██
+ ██ █▀██████▀█ ██
+ ██ ██████████ ██
+  ████ ▀▀▀▀ ████
+   ▀██████████▀
+     ████████
+      ██████
+       ████
+       ████
+    `,
+  },
+  {
+    name: 'Coffee',
+    art: `
+   ▐█▌  ▐█▌  ▐█▌
+    ▐█▌  ▐█▌  ▐█▌
+   ▐█▌  ▐█▌  ▐█▌
+  ████████████████
+  ████████████████▄
+  █████████████████
+  █████████████████
+  ████████████████▀
+  ████████████████
+   ▀████████████▀
+  ████████████████
+    `,
+  },
+  {
+    name: 'Diamond',
+    art: `
+       ▄██▄
+      ██████
+     ████████
+    ██████████
+   ████████████
+  ██████████████
+   ████████████
+    ██████████
+     ████████
+      ██████
+       ▀██▀
+    `,
+  },
+];
+
+export const SHAPE_NAMES = SHAPES.map((s) => s.name);

package/src/themes.js

@@ -1,23 +1,68 @@
+/**
+ * Font and gradient theme definitions for shell-logo.
+ *
+ * FONTS  — Figlet font names available for text-mode logos.
+ *          The render loop in index.js cycles through these with arrow keys.
+ *          Indices 0–14 are the original set; new entries are appended so
+ *          saved configs that store a font name keep working.
+ *
+ * THEMES — Named gradient color palettes (3 hex stops each).
+ *          Used by gradient-string to colorize the rendered ASCII art.
+ */
+
+// ── Fonts ──────────────────────────────────────────────────────────────────
+
 export const FONTS = [
+  // Classic / general-purpose
   'Standard', 'Big', 'ANSI Shadow', 'Slant', 'Small',
   'ANSI Regular', 'Bloody', 'DOS Rebel', 'Graffiti', 'Larry 3D',
   'Star Wars', 'Doh', 'Ghost', 'Fraktur', 'Fire Font-k',
+
+  // Block / pixel style — use filled Unicode characters (▄█▀) instead of
+  // typical ASCII slashes and pipes, giving a "painted pixels" look.
+  'Block', 'Blocks', 'Shaded Blocky', 'Small Block',
+  'Dot Matrix', 'Tiles', 'Rectangles',
+
+  // Popular classic figlet fonts
+  'Doom', 'Banner3-D', 'Colossal', 'Epic',
+  'Calvin S', 'Speed', '3D-ASCII', 'Isometric1',
 ];
 
+// ── Gradient themes ────────────────────────────────────────────────────────
+
 export const THEMES = [
-  { name: 'Sunset',     colors: ['#ff6b6b', '#ff9f43', '#feca57'] },
-  { name: 'Ocean',      colors: ['#0abde3', '#48dbfb', '#54a0ff'] },
-  { name: 'Forest',     colors: ['#1dd1a1', '#2ed573', '#26de81'] },
-  { name: 'Neon',       colors: ['#c56cf0', '#fd79a8', '#ff6b6b'] },
-  { name: 'Twilight',   colors: ['#5f27cd', '#c56cf0', '#48dbfb'] },
-  { name: 'Fire',       colors: ['#ff4757', '#ff6348', '#ffdd59'] },
-  { name: 'Pastel',     colors: ['#fd79a8', '#feca57', '#48dbfb'] },
-  { name: 'Monochrome', colors: ['#ffffff', '#54a0ff', '#5f27cd'] },
-  { name: 'Aurora',     colors: ['#00d2ff', '#3a7bd5', '#7b2ff7'] },
-  { name: 'Cherry',     colors: ['#eb3349', '#f45c43', '#ff8a80'] },
-  { name: 'Cyberpunk',  colors: ['#f72585', '#7209b7', '#4cc9f0'] },
-  { name: 'Arctic',     colors: ['#e0eafc', '#cfdef3', '#74b9ff'] },
-  { name: 'Emerald',    colors: ['#11998e', '#38ef7d', '#b8ff96'] },
-  { name: 'Midnight',   colors: ['#0f0c29', '#302b63', '#24c6dc'] },
-  { name: 'Rose Gold',  colors: ['#f4c4f3', '#fc5c7d', '#fda085'] },
+  // Warm
+  { name: 'Sunset',          colors: ['#ff6b6b', '#ff9f43', '#feca57'] },
+  { name: 'Fire',            colors: ['#ff4757', '#ff6348', '#ffdd59'] },
+  { name: 'Cherry',          colors: ['#eb3349', '#f45c43', '#ff8a80'] },
+  { name: 'Rose Gold',       colors: ['#f4c4f3', '#fc5c7d', '#fda085'] },
+  { name: 'Magma',           colors: ['#f83600', '#f9d423', '#fe8c00'] },
+  { name: 'Sunrise',         colors: ['#ff512f', '#f09819', '#ffed4a'] },
+  { name: 'Copper',          colors: ['#b87333', '#da9855', '#f0c27f'] },
+
+  // Cool
+  { name: 'Ocean',           colors: ['#0abde3', '#48dbfb', '#54a0ff'] },
+  { name: 'Arctic',          colors: ['#e0eafc', '#cfdef3', '#74b9ff'] },
+  { name: 'Frost',           colors: ['#e8f0ff', '#b8d4f0', '#88b8e0'] },
+  { name: 'Electric',        colors: ['#00f2fe', '#4facfe', '#667eea'] },
+
+  // Green
+  { name: 'Forest',          colors: ['#1dd1a1', '#2ed573', '#26de81'] },
+  { name: 'Emerald',         colors: ['#11998e', '#38ef7d', '#b8ff96'] },
+  { name: 'Toxic',           colors: ['#a8ff78', '#78ffd6', '#00e676'] },
+  { name: 'Matrix',          colors: ['#00ff41', '#008f11', '#003b00'] },
+
+  // Purple / pink
+  { name: 'Neon',            colors: ['#c56cf0', '#fd79a8', '#ff6b6b'] },
+  { name: 'Twilight',        colors: ['#5f27cd', '#c56cf0', '#48dbfb'] },
+  { name: 'Cyberpunk',       colors: ['#f72585', '#7209b7', '#4cc9f0'] },
+  { name: 'Grape',           colors: ['#6a0572', '#ab83a1', '#e0aaff'] },
+  { name: 'Lavender Dream',  colors: ['#a18cd1', '#fbc2eb', '#f6d5f7'] },
+  { name: 'Bubblegum',       colors: ['#ff77ab', '#ff99cc', '#ffbbdd'] },
+
+  // Multi / neutral
+  { name: 'Pastel',          colors: ['#fd79a8', '#feca57', '#48dbfb'] },
+  { name: 'Monochrome',      colors: ['#ffffff', '#54a0ff', '#5f27cd'] },
+  { name: 'Aurora',          colors: ['#00d2ff', '#3a7bd5', '#7b2ff7'] },
+  { name: 'Midnight',        colors: ['#0f0c29', '#302b63', '#24c6dc'] },
 ];

package/src/ui.js

@@ -15,6 +15,8 @@
 import * as p from '@clack/prompts';
 import chalk from 'chalk';
 import { tryLoadConfig } from './config.js';
+import { SHAPES } from './shapes.js';
+import { FONTS } from './themes.js';
 
 const COLOR_PALETTE = [
   { value: '#ff6b6b', label: `${chalk.bgHex('#ff6b6b')('   ')} Coral` },
@@ -35,23 +37,7 @@ const COLOR_PALETTE = [
   { value: '#ffffff', label: `${chalk.bgHex('#ffffff')('   ')} White` },
 ];
 
-const FONT_OPTIONS = [
-  { value: 'Standard', label: 'Standard' },
-  { value: 'Big', label: 'Big' },
-  { value: 'ANSI Shadow', label: 'ANSI Shadow' },
-  { value: 'Slant', label: 'Slant' },
-  { value: 'Small', label: 'Small' },
-  { value: 'ANSI Regular', label: 'ANSI Regular' },
-  { value: 'Bloody', label: 'Bloody' },
-  { value: 'DOS Rebel', label: 'DOS Rebel' },
-  { value: 'Graffiti', label: 'Graffiti' },
-  { value: 'Larry 3D', label: 'Larry 3D' },
-  { value: 'Star Wars', label: 'Star Wars' },
-  { value: 'Doh', label: 'Doh' },
-  { value: 'Ghost', label: 'Ghost' },
-  { value: 'Fraktur', label: 'Fraktur' },
-  { value: 'Fire Font-k', label: 'Fire Font-k' },
-];
+const FONT_OPTIONS = FONTS.map(f => ({ value: f, label: f }));
 
 /** Exit gracefully if the user presses Ctrl+C / Escape during a prompt. */
 function handleCancel(value) {
@@ -62,19 +48,8 @@ function handleCancel(value) {
   return value;
 }
 
-/** Walk the user through the Generate wizard: text, colors, font. */
-async function promptGenerate() {
-  const text = handleCancel(
-    await p.text({
-      message: 'What text should the logo display?',
-      placeholder: 'HELLO',
-      validate: (val) => {
-        if (!val || val.trim() === '') return 'Text is required.';
-      },
-    })
-  );
-
-  // Pick 3 random unique colors as defaults
+/** Prompt for gradient colors (shared by text and shape modes). */
+async function promptColors() {
   const shuffled = [...COLOR_PALETTE].sort(() => Math.random() - 0.5);
   const initialColors = shuffled.slice(0, 3).map(c => c.value);
 
@@ -92,6 +67,40 @@ async function promptGenerate() {
     if (colors.length >= 2) break;
     p.log.warning('Please select at least 2 colors.');
   }
+  return colors;
+}
+
+/** Walk the user through the Shape wizard: shape picker, colors. */
+async function promptShapeGenerate() {
+  const shape = handleCancel(
+    await p.select({
+      message: 'Pick a mascot:',
+      options: SHAPES.map((s) => ({ value: s.name, label: s.name })),
+    })
+  );
+
+  const colors = await promptColors();
+
+  return {
+    action: 'generate',
+    config: { mode: 'shape', shape, colors },
+    persistent: true,
+  };
+}
+
+/** Walk the user through the Text wizard: text, colors, font. */
+async function promptTextGenerate() {
+  const text = handleCancel(
+    await p.text({
+      message: 'What text should the logo display?',
+      placeholder: 'HELLO',
+      validate: (val) => {
+        if (!val || val.trim() === '') return 'Text is required.';
+      },
+    })
+  );
+
+  const colors = await promptColors();
 
   const font = handleCancel(
     await p.select({
@@ -102,11 +111,27 @@ async function promptGenerate() {
 
   return {
     action: 'generate',
-    config: { text: text.trim(), colors, font },
+    config: { mode: 'text', text: text.trim(), colors, font },
     persistent: true,
   };
 }
 
+/** Walk the user through the Generate wizard: mode selection, then mode-specific prompts. */
+async function promptGenerate() {
+  const mode = handleCancel(
+    await p.select({
+      message: 'What kind of logo?',
+      options: [
+        { value: 'text', label: 'Text', hint: 'type your own text' },
+        { value: 'shape', label: 'Shape', hint: 'pick a mascot/pet' },
+      ],
+    })
+  );
+
+  if (mode === 'shape') return promptShapeGenerate();
+  return promptTextGenerate();
+}
+
 /**
  * Main entry point for the interactive CLI.
  * Returns { action: 'generate'|'run', config, persistent }.