@meebs/meeb 1.0.0

package/info.js

@@ -0,0 +1,80 @@
+// Fun facts about animals — used by --info flag
+const facts = {
+  penguin: "Emperor penguins can dive over 1,800 feet deep and hold their breath for 20+ minutes.",
+  cat: "Cats spend 70% of their lives sleeping. Living the dream.",
+  dog: "A dog's nose print is as unique as a human fingerprint.",
+  fox: "Arctic foxes can survive temperatures as low as -58°F (-50°C).",
+  bear: "Polar bears have black skin under their white fur to absorb heat.",
+  owl: "Owls can rotate their heads 270° but can't move their eyeballs.",
+  bunny: "Rabbits can't vomit. Once it's eaten, it's committed.",
+  frog: "The golden poison frog has enough toxin to kill 10 grown adults.",
+  panda: "Pandas spend up to 14 hours a day eating bamboo. Relatable.",
+  snake: "Snakes smell with their tongues and can feel vibrations through their jaw bones.",
+  duck: "Ducks have three eyelids and can sleep with one eye open.",
+  mouse: "A mouse's heart beats about 632 times per minute.",
+  whale: "Blue whale hearts are so big a small child could crawl through the arteries.",
+  octopus: "Octopuses have three hearts, blue blood, and can edit their own RNA.",
+  bat: "Bats are the only mammals that can truly fly. Not just glide — fly.",
+  fish: "Goldfish can distinguish between Bach and Stravinsky. Cultured.",
+  turtle: "Some turtles can breathe through their butts. It's called cloacal respiration.",
+  crab: "Japanese spider crabs can have a leg span of 12 feet.",
+  monkey: "Capuchin monkeys wash their hands and feet in their own urine as perfume.",
+  pig: "Pigs can play video games with joysticks. Seriously.",
+  koala: "Koalas sleep 22 hours a day and have fingerprints nearly identical to humans.",
+  lion: "A lion's roar can be heard from 5 miles away.",
+  shark: "Sharks have been around longer than trees. 400 million years.",
+  elephant: "Elephants are the only animals that can't jump. But they can paint.",
+  unicorn: "The national animal of Scotland is the unicorn. Officially.",
+  jellyfish: "The immortal jellyfish (Turritopsis dohrnii) can revert to its juvenile state indefinitely.",
+  sloth: "Sloths can hold their breath longer than dolphins — up to 40 minutes.",
+  wolf: "Wolves can eat up to 20 pounds of meat in a single meal.",
+  parrot: "African grey parrots can learn over 1,000 words and understand context.",
+  hedgehog: "Hedgehogs are immune to many snake venoms and poisons.",
+  giraffe: "Giraffes only need 30 minutes of sleep per day, in 5-minute naps.",
+  flamingo: "Flamingos are born grey/white and turn pink from eating shrimp.",
+  raccoon: "Raccoons can remember solutions to tasks for up to 3 years.",
+  hippo: "Hippos secrete a red oily substance that acts as sunscreen and antibiotic.",
+  deer: "Reindeer eyes change color — from gold in summer to blue in winter.",
+  squid: "Giant squid have the largest eyes in the animal kingdom — the size of dinner plates.",
+  gorilla: "Gorillas share 98.3% of their DNA with humans and can learn sign language.",
+  dragon: "Komodo dragons have venom glands and can detect prey from 6 miles away.",
+  alien: "The Wow! signal was a 72-second radio burst from deep space. Still unexplained.",
+  robot: "The word 'robot' comes from Czech 'robota' meaning forced labor.",
+  ghost: "The fear of ghosts is called phasmophobia. The game knew.",
+  dino: "T-Rex had the strongest bite force of any land animal ever — 12,800 pounds.",
+  zebra: "No two zebras have the same stripe pattern. They're nature's fingerprints.",
+  snail: "Garden snails have about 14,000 teeth, all on their tongue.",
+  bee: "A single bee produces only 1/12th of a teaspoon of honey in its lifetime.",
+  butterfly: "Butterflies taste with their feet and can see ultraviolet light.",
+  scorpion: "Scorpions glow under UV light. Nobody knows why.",
+  crocodile: "Crocodiles have the strongest bite in the animal kingdom — 3,700 PSI.",
+  chameleon: "Chameleons don't change color for camouflage — they do it to communicate mood.",
+  seahorse: "Male seahorses get pregnant and give birth. Progressive kings.",
+  otter: "Sea otters hold hands while sleeping so they don't drift apart.",
+  mantisshrimp: "Mantis shrimp can punch at 50 mph — fast enough to boil the water around their fists.",
+  narwhal: "The narwhal's tusk is actually a giant tooth with 10 million nerve endings.",
+  peacock: "Peacock tail feathers can be 6 feet long — 60% of their total body length.",
+  spider: "Spider silk is 5x stronger than steel by weight.",
+  chick: "Chicks can communicate with each other while still inside their eggs.",
+  ladybug: "A ladybug can eat up to 5,000 aphids in its lifetime. Pest control legends.",
+  capybara: "Capybaras are the world's largest rodent and literally everyone likes them.",
+  axolotl: "Axolotls can regenerate their brain, heart, and limbs. Wolverine of the sea.",
+  hamster: "Hamsters can run up to 5 miles on their wheel in a single night.",
+  swan: "Swans mate for life and can remember people who've been kind — or mean — to them.",
+  eagle: "Bald eagles can see fish from over a mile away.",
+  walrus: "Walruses can slow their heartbeat to withstand frigid Arctic waters.",
+  toucan: "Toucans regulate body temperature through their enormous beaks.",
+  yak: "Yaks can survive at altitudes above 20,000 feet where most animals can't breathe.",
+  firefly: "Firefly light is the most efficient in the world — nearly 100% of the energy becomes light.",
+  cookie: "The chocolate chip cookie was invented by accident in 1938.",
+  starfish: "Starfish don't have blood — they pump filtered sea water through their bodies.",
+  caterpillar: "Caterpillars have 12 eyes but still have terrible vision.",
+  manta: "Manta rays have the largest brain-to-body ratio of any fish.",
+}
+
+function getInfo(animalName) {
+  const key = animalName.toLowerCase().replace(/[^a-z]/g, '')
+  return facts[key] || `No fun fact for ${animalName} yet. Maybe submit one?`
+}
+
+module.exports = { getInfo, facts }

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@meebs/meeb",
+  "version": "1.0.0",
+  "description": "Cute ASCII art animals for your terminal",
+  "bin": {
+    "meeb": "./index.js"
+  },
+  "keywords": [
+    "cli",
+    "ascii-art",
+    "terminal",
+    "animals",
+    "cowsay",
+    "unicode",
+    "pixel-art",
+    "fun"
+  ],
+  "license": "CC-BY-NC-4.0",
+  "author": "meeb",
+  "homepage": "https://meeb.sh",
+  "files": [
+    "index.js",
+    "color.js",
+    "emoji.js",
+    "fortune.js",
+    "gif.js",
+    "png.js",
+    "svg.js",
+    "theme.js",
+    "tui.js",
+    "util.js",
+    "info.js",
+    "animals/",
+    "completions/"
+  ],
+  "engines": {
+    "node": ">=14"
+  }
+}

package/png.js

@@ -0,0 +1,88 @@
+const fs = require('fs')
+const zlib = require('zlib')
+const { artToPixels, applyWhiteBg, correctAspect } = require('./gif')
+
+// CRC32 lookup table
+const crcTable = new Uint32Array(256)
+for (let n = 0; n < 256; n++) {
+  let c = n
+  for (let k = 0; k < 8; k++) {
+    c = (c & 1) ? (0xedb88320 ^ (c >>> 1)) : (c >>> 1)
+  }
+  crcTable[n] = c
+}
+
+function crc32(buf) {
+  let crc = 0xffffffff
+  for (let i = 0; i < buf.length; i++) {
+    crc = crcTable[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8)
+  }
+  return (crc ^ 0xffffffff) >>> 0
+}
+
+function makeChunk(type, data) {
+  const typeBytes = Buffer.from(type)
+  const len = Buffer.alloc(4)
+  len.writeUInt32BE(data.length)
+  const body = Buffer.concat([typeBytes, data])
+  const checksum = Buffer.alloc(4)
+  checksum.writeUInt32BE(crc32(body))
+  return Buffer.concat([len, body, checksum])
+}
+
+function generatePng(art, outPath, bgColor) {
+  const bg = bgColor || [25, 25, 30]
+  let { pixels, w, h } = artToPixels(art, bg)
+  applyWhiteBg(pixels, w, h, bg)
+  const corrected = correctAspect(pixels, w, h)
+  const px = corrected.pixels
+  const pw = corrected.w, ph = corrected.h
+  if (pw === 0 || ph === 0) {
+    console.error('  empty art, cannot generate png')
+    process.exit(1)
+  }
+
+  // PNG signature
+  const sig = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])
+
+  // IHDR
+  const ihdr = Buffer.alloc(13)
+  ihdr.writeUInt32BE(pw, 0)
+  ihdr.writeUInt32BE(ph, 4)
+  ihdr[8] = 8   // bit depth
+  ihdr[9] = 2   // color type: RGB
+  ihdr[10] = 0  // compression
+  ihdr[11] = 0  // filter
+  ihdr[12] = 0  // interlace
+
+  // IDAT - raw pixel data with filter bytes
+  const rawSize = ph * (1 + pw * 3)
+  const raw = Buffer.alloc(rawSize)
+  let offset = 0
+  for (let y = 0; y < ph; y++) {
+    raw[offset++] = 0 // filter: none
+    for (let x = 0; x < pw; x++) {
+      const [r, g, b] = px[y][x]
+      raw[offset++] = r
+      raw[offset++] = g
+      raw[offset++] = b
+    }
+  }
+
+  const compressed = zlib.deflateSync(raw, { level: 6 })
+
+  // IEND
+  const iend = Buffer.alloc(0)
+
+  const png = Buffer.concat([
+    sig,
+    makeChunk('IHDR', ihdr),
+    makeChunk('IDAT', compressed),
+    makeChunk('IEND', iend),
+  ])
+
+  fs.writeFileSync(outPath, png)
+  return outPath
+}
+
+module.exports = { generatePng }

package/svg.js

@@ -0,0 +1,43 @@
+const fs = require('fs')
+const { artToPixels, applyWhiteBg, correctAspect, CELL_W, CELL_H } = require('./gif')
+
+function generateSvg(art, outPath, bgColor) {
+  const bg = bgColor || [25, 25, 30]
+  let { pixels, w, h } = artToPixels(art, bg)
+  applyWhiteBg(pixels, w, h, bg)
+  const corrected = correctAspect(pixels, w, h)
+  const px = corrected.pixels
+  const pw = corrected.w, ph = corrected.h
+  if (pw === 0 || ph === 0) {
+    console.error('  empty art, cannot generate svg')
+    process.exit(1)
+  }
+
+  const lines = []
+  lines.push(`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${pw} ${ph}" width="${pw}" height="${ph}" shape-rendering="crispEdges">`)
+  lines.push(`<rect width="${pw}" height="${ph}" fill="rgb(${bg[0]},${bg[1]},${bg[2]})"/>`)
+
+  for (let y = 0; y < ph; y++) {
+    let x = 0
+    while (x < pw) {
+      const [r, g, b] = px[y][x]
+      if (r === bg[0] && g === bg[1] && b === bg[2]) { x++; continue }
+      let runEnd = x + 1
+      while (runEnd < pw) {
+        const [nr, ng, nb] = px[y][runEnd]
+        if (nr !== r || ng !== g || nb !== b) break
+        runEnd++
+      }
+      lines.push(`<rect x="${x}" y="${y}" width="${runEnd - x}" height="1" fill="rgb(${r},${g},${b})"/>`)
+      x = runEnd
+    }
+  }
+
+  lines.push('</svg>')
+
+  const svg = lines.join('\n')
+  fs.writeFileSync(outPath, svg)
+  return outPath
+}
+
+module.exports = { generateSvg }

package/theme.js

@@ -0,0 +1,80 @@
+// Color themes for --theme flag
+// Each theme is a function that transforms rgb values
+
+const themes = {
+  neon: (r, g, b) => {
+    // boost saturation and brightness, shift toward vivid neon
+    const max = Math.max(r, g, b)
+    const min = Math.min(r, g, b)
+    if (max - min < 30) return [r, g, b] // leave grays alone
+    // amplify the dominant channel
+    const nr = r === max ? Math.min(255, r + 80) : Math.max(0, r - 40)
+    const ng = g === max ? Math.min(255, g + 80) : Math.max(0, g - 40)
+    const nb = b === max ? Math.min(255, b + 80) : Math.max(0, b - 40)
+    return [nr, ng, nb]
+  },
+
+  pastel: (r, g, b) => {
+    // blend toward white for soft pastel look
+    return [
+      Math.round(r * 0.5 + 200 * 0.5),
+      Math.round(g * 0.5 + 200 * 0.5),
+      Math.round(b * 0.5 + 200 * 0.5),
+    ]
+  },
+
+  retro: (r, g, b) => {
+    // warm sepia-like tones
+    const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b)
+    return [
+      Math.min(255, Math.round(gray * 1.2 + 20)),
+      Math.min(255, Math.round(gray * 0.9 + 10)),
+      Math.round(gray * 0.6),
+    ]
+  },
+
+  mono: (r, g, b) => {
+    // grayscale
+    const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b)
+    return [gray, gray, gray]
+  },
+
+  matrix: (r, g, b) => {
+    // green terminal look
+    const lum = Math.round(0.299 * r + 0.587 * g + 0.114 * b)
+    return [0, Math.min(255, lum + 30), 0]
+  },
+}
+
+const themeNames = Object.keys(themes)
+
+// Apply a theme to an ANSI art string by transforming color codes
+function applyTheme(art, themeName) {
+  const transform = themes[themeName]
+  if (!transform) return art
+
+  return art.replace(/\x1b\[([0-9;]*)m/g, (match, codes) => {
+    const parts = codes.split(';').map(Number)
+    const newParts = []
+    let i = 0
+    while (i < parts.length) {
+      if (parts[i] === 38 && parts[i + 1] === 2 && i + 4 < parts.length) {
+        // foreground color
+        const [nr, ng, nb] = transform(parts[i + 2], parts[i + 3], parts[i + 4])
+        newParts.push(38, 2, nr, ng, nb)
+        i += 5
+      } else if (parts[i] === 48 && parts[i + 1] === 2 && i + 4 < parts.length) {
+        // background color
+        const [nr, ng, nb] = transform(parts[i + 2], parts[i + 3], parts[i + 4])
+        newParts.push(48, 2, nr, ng, nb)
+        i += 5
+      } else {
+        newParts.push(parts[i])
+        i++
+      }
+    }
+    return `\x1b[${newParts.join(';')}m`
+  })
+}
+
+module.exports = { applyTheme, themeNames }

package/tui.js

@@ -0,0 +1,76 @@
+const { rgb } = require('./color')
+
+function browse(animals) {
+  const keys = Object.keys(animals)
+  let idx = 0
+  const stdin = process.stdin
+  const stdout = process.stdout
+
+  if (!stdin.isTTY) {
+    console.error('  --browse requires an interactive terminal')
+    process.exit(1)
+  }
+  stdin.setRawMode(true)
+  stdin.resume()
+  stdin.setEncoding('utf8')
+
+  const hide = '\x1b[?25l'
+  const show = '\x1b[?25h'
+  const clear = '\x1b[2J\x1b[H'
+
+  function render() {
+    const animal = animals[keys[idx]]
+    const art = animal.render()
+    const lines = []
+    lines.push('')
+    lines.push(rgb(215, 119, 87, `  ── ${animal.name} ──`) + rgb(120, 120, 120, `  (${idx + 1}/${keys.length})`))
+    lines.push(art)
+    lines.push('')
+    lines.push(rgb(120, 120, 120, '  ← → navigate   q quit   r random'))
+    lines.push('')
+    stdout.write(clear + hide + lines.join('\n'))
+  }
+
+  function cleanup() {
+    stdout.write(show + clear)
+    stdin.setRawMode(false)
+    stdin.pause()
+  }
+
+  render()
+
+  stdin.on('data', (key) => {
+    if (key === 'q' || key === '\x03') {
+      // q or ctrl-c
+      cleanup()
+      process.exit(0)
+    } else if (key === '\x1b[C' || key === 'l' || key === ' ') {
+      // right arrow, l, space
+      idx = (idx + 1) % keys.length
+      render()
+    } else if (key === '\x1b[D' || key === 'h') {
+      // left arrow, h
+      idx = (idx - 1 + keys.length) % keys.length
+      render()
+    } else if (key === '\x1b[A' || key === 'k') {
+      // up arrow, k — jump back 10
+      idx = (idx - 10 + keys.length) % keys.length
+      render()
+    } else if (key === '\x1b[B' || key === 'j') {
+      // down arrow, j — jump forward 10
+      idx = (idx + 10) % keys.length
+      render()
+    } else if (key === 'r') {
+      idx = Math.floor(Math.random() * keys.length)
+      render()
+    } else if (key === 'g') {
+      idx = 0
+      render()
+    } else if (key === 'G') {
+      idx = keys.length - 1
+      render()
+    }
+  })
+}
+
+module.exports = { browse }