moodlet 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Winalda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# moodlet
+
+A tiny, dependency-free CLI that prints **ASCII moods** in your terminal.
+
+No dependencies.  
+No configuration.  
+Just moods.
+
+---
+
+## Install
+
+### Run instantly (no install)
+
+```bash
+npx moodlet happy
+```
+
+Install globally
+
+```bash
+npm install -g moodlet
+mm happy
+```
+
+---
+
+## Usage
+
+```bash
+mm <mood>
+mm --list | -l
+mm --random | -r
+mm --help | -h
+```
+
+Examples
+
+```bash
+mm happy
+mm sad
+mm tired
+mm sleepy     # alias -> tired
+mm ok         # alias -> chill
+mm --list
+mm --random
+```
+
+---
+
+## Output
+
+`mm happy`
+
+```code
+╔════════════════╗
+║   ◕        ◕   ║
+║        ▿        ║
+║    \______/    ║
+╚════════════════╝
+```
+
+`mm sad`
+
+```code
+╔════════════════╗
+║   ╥        ╥   ║
+║        ▄▄▄        ║
+║     ▄████▄      ║
+╚════════════════╝
+```
+
+`mm love`
+
+```code
+╔════════════════╗
+║   ♥        ♥   ║
+║        ▿        ║
+║     \\______/   ║
+╚════════════════╝
+```
+
+---
+
+## Available moods
+
+Run:
+
+```bash
+mm --list
+```
+
+Example moods:
+
+- happy
+- sad
+- tired
+- angry
+- love
+- confused
+- excited
+- chill
+- stressed
+
+---
+
+## Aliases
+
+Some inputs are mapped automatically to a mood:
+
+| Input  | Mapped to |
+| ------ | --------- |
+| ok     | chill     |
+| cool   | chill     |
+| relax  | chill     |
+| sleepy | tired     |
+| mad    | angry     |
+| rage   | angry     |
+| yay    | excited   |
+| wtf    | confused  |
+| hmm    | confused  |
+| panic  | stressed  |
+
+---
+
+## Why moodlet?
+
+- Big multiline ASCII (easy to read)
+- Terminal-native
+- Zero dependencies
+- Fast and fun
+
+---
+
+## Development
+
+Requirements
+
+- Node.js 18+
+
+## Setup
+
+```bash
+git clone https://github.com/<your-username>/moodlet.git
+cd moodlet
+npm install
+```
+
+> This project has no runtime dependencies. `npm install` is only for local workflows.
+
+### Run locally
+
+```bash
+node bin/moodlet.js happy
+```
+
+Or link it globally while developing:
+
+```bash
+npm link
+mm happy
+```
+
+Unlink when done:
+
+```bash
+npm unlink -g moodlet
+```
+
+---
+
+## Tests
+
+Uses Node’s built-in test runner:
+
+```bash
+node --test
+```
+
+---
+
+Project structure
+
+```txt
+moodlet/
+  bin/
+    mm.js
+  src/
+    cli.js
+    engine.js
+    moods.js
+  test/
+    engine.test.js
+  package.json
+  README.md
+  LICENSE
+```
+
+---
+
+## License
+
+MIT

package/bin/moodlet.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from "../src/cli.js";
+
+runCli(process.argv.slice(2));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "moodlet",
+  "version": "0.1.0",
+  "description": "A CLI that prints ASCII moods",
+  "bin": {
+    "mm": "bin/moodlet.js"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davidwinalda/moodlet.git"
+  },
+  "keywords": [
+    "cli",
+    "ascii",
+    "mood",
+    "fun",
+    "terminal"
+  ],
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "author": "David Winalda",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/cli.js

@@ -0,0 +1,108 @@
+/**
+ * Supports:
+ *   - mm happy
+ *   - mm --list
+ *   - mm --random
+ *   - mm --help
+ */
+
+import { getMoodArt, listMoods } from "./engine.js";
+
+/**
+ * Map short flags to long flags
+ */
+const FLAG_ALIASES = {
+  "-h": "--help",
+  "-l": "--list",
+  "-r": "--random",
+};
+
+/**
+ * Normalize flags so CLI logic only deals with long flags
+ */
+function normalizeFlags(flags) {
+  const normalized = new Set();
+  for (const f of flags) {
+    normalized.add(FLAG_ALIASES[f] ?? f);
+  }
+  return normalized;
+}
+
+function printHelp() {
+  console.log(
+    `
+mm — print an ASCII mood
+
+Usage:
+  mm <mood>
+  mm --random | -r
+  mm --list | -l
+  mm --help | -h
+
+Examples:
+  mm happy
+  mm sleepy
+  mm --random
+  mm -r
+  mm --list
+  mm -l
+  mm --help
+  mm -h
+`.trim(),
+  );
+}
+
+function parseArgs(argv) {
+  const flags = new Set();
+  const positional = [];
+
+  for (const arg of argv) {
+    if (arg.startsWith("-")) flags.add(arg);
+    else positional.push(arg);
+  }
+
+  return { flags, positional };
+}
+
+export function runCli(argv) {
+  let { flags, positional } = parseArgs(argv);
+
+  flags = normalizeFlags(flags);
+
+  // Help
+  if (flags.has("--help")) {
+    printHelp();
+    process.exit(0);
+  }
+
+  // List moods
+  if (flags.has("--list")) {
+    console.log(listMoods().join("\n"));
+    process.exit(0);
+  }
+
+  // Random mood
+  if (flags.has("--random")) {
+    const moods = listMoods();
+    const mood = moods[Math.floor(Math.random() * moods.length)];
+    const res = getMoodArt(mood);
+    console.log(res.art);
+    process.exit(0);
+  }
+
+  // Mood from positional argument
+  const moodInput = positional.join(" ");
+
+  if (!moodInput) {
+    console.error("Error: No mood specified. Use --help for usage.");
+    process.exit(1);
+  }
+
+  const res = getMoodArt(moodInput);
+  if (!res.ok) {
+    console.error(`Error: ${res.error}`);
+    process.exit(1);
+  }
+
+  console.log(res.art);
+}

package/src/engine.js

@@ -0,0 +1,69 @@
+import { MOODS, ALIASES } from "./moods.js";
+
+/**
+ * Normalize user input
+ */
+export function normalizeInput(input) {
+  return String(input ?? "")
+    .trim()
+    .toLowerCase()
+    .replace(/\s+/g, " ");
+}
+
+/**
+ * Resolve a mood key from user input
+ * - Direct mood: "happy" -> "happy"
+ * - Alias mood: "ok" -> "chill" or "sleepy" -> "tired"
+ */
+export function resolveMoodKey(input) {
+  const key = normalizeInput(input);
+  if (!key) return null;
+
+  if (MOODS[key]) return key;
+  if (ALIASES[key] && MOODS[ALIASES[key]]) {
+    return ALIASES[key];
+  }
+  return null;
+}
+
+/**
+ * Pick deterministic item using a number of seed (for tests),
+ * Otherwise pick random item.
+ */
+export function pickOne(list, seed = null) {
+  if (!Array.isArray(list) || list.length === 0) return null;
+
+  if (typeof seed === "number" && Number.isFinite(seed)) {
+    const idx = Math.abs(Math.floor(seed)) % list.length;
+    return list[idx];
+  }
+
+  return list[Math.floor(Math.random() * list.length)];
+}
+
+/**
+ * Get an ASCII mood output for a given mood input.
+ * Returns:
+ *  - { ok: true, moodKey, art }
+ *  - { ok: false, error }
+ */
+export function getMoodArt(input, { seed = null } = {}) {
+  const moodKey = resolveMoodKey(input);
+
+  if (!moodKey) {
+    return {
+      ok: false,
+      error: `Unknown mood "${normalizeInput(input)}". Use --list to see available moods.`,
+    };
+  }
+
+  const art = pickOne(MOODS[moodKey], seed);
+  return { ok: true, moodKey, art };
+}
+
+/**
+ * List the available moods as an array of keys.
+ */
+export function listMoods() {
+  return Object.keys(MOODS).sort();
+}

package/src/moods.js

@@ -0,0 +1,105 @@
+export const MOODS = {
+  happy: [
+    `
+  ╔════════════════╗
+  ║   ◕        ◕   ║
+  ║        ▿        ║
+  ║    \\______/    ║
+  ╚════════════════╝
+    `,
+  ],
+
+  sad: [
+    `
+  ╔════════════════╗
+  ║   ╥        ╥   ║
+  ║        ▄▄▄        ║
+  ║     ▄████▄      ║
+  ╚════════════════╝
+    `,
+  ],
+
+  tired: [
+    `
+  ╔════════════════╗
+  ║   -        -   ║
+  ║        ___        ║
+  ║     z   Z   z   ║
+  ╚════════════════╝
+    `,
+  ],
+
+  angry: [
+    `
+  ╔════════════════╗
+  ║   >        <   ║
+  ║     █████████   ║
+  ║        ███        ║
+  ╚════════════════╝
+    `,
+  ],
+
+  love: [
+    `
+  ╔════════════════╗
+  ║   ♥        ♥   ║
+  ║        ▿        ║
+  ║     \\______/   ║
+  ╚════════════════╝
+    `,
+  ],
+
+  confused: [
+    `
+  ╔════════════════╗
+  ║   ⊙        ⊙   ║
+  ║        ___        ║
+  ║      (   ?   )  ║
+  ╚════════════════╝
+    `,
+  ],
+
+  excited: [
+    `
+  ╔════════════════╗
+  ║   ★        ★   ║
+  ║        ▿        ║
+  ║     \\______/   ║
+  ╚════════════════╝
+    `,
+  ],
+
+  chill: [
+    `
+  ╔════════════════╗
+  ║   ■        ■   ║
+  ║        ───        ║
+  ║      (____)     ║
+  ╚════════════════╝
+    `,
+  ],
+
+  stressed: [
+    `
+  ╔════════════════╗
+  ║   @        @   ║
+  ║        ███        ║
+  ║     ▄████▄      ║
+  ╚════════════════╝
+    `,
+  ],
+};
+
+// Aliases stay exactly the same
+export const ALIASES = {
+  ok: "chill",
+  cool: "chill",
+  relax: "chill",
+  sleepy: "tired",
+  mad: "angry",
+  rage: "angry",
+  yay: "excited",
+  wtf: "confused",
+  hmm: "confused",
+  panic: "stressed",
+};