@nathievzm/lumi 1.0.1 → 1.1.1

package/.oxfmtrc.json

@@ -1,39 +1,39 @@
-{
-    "$schema": "./node_modules/oxfmt/configuration_schema.json",
-    "arrowParens": "avoid",
-    "bracketSameLine": true,
-    "bracketSpacing": true,
-    "embeddedLanguageFormatting": "auto",
-    "endOfLine": "lf",
-    "insertFinalNewline": true,
-    "jsdoc": {
-        "bracketSpacing": true,
-        "lineWrappingStyle": "balance",
-        "separateReturnsFromParam": true,
-        "capitalizeDescriptions": true,
-        "descriptionWithDot": false,
-        "commentLineStrategy": "multiline"
-    },
-    "objectWrap": "preserve",
-    "printWidth": 120,
-    "proseWrap": "always",
-    "quoteProps": "consistent",
-    "semi": false,
-    "singleQuote": true,
-    "sortImports": {
-        "newlinesBetween": true
-    },
-    "sortPackageJson": {
-        "sortScripts": true
-    },
-    "tabWidth": 4,
-    "trailingComma": "none",
-    "overrides": [
-        {
-            "files": ["*.yml", "*.yaml"],
-            "options": {
-                "tabWidth": 2
-            }
-        }
-    ]
-}
+{
+    "$schema": "./node_modules/oxfmt/configuration_schema.json",
+    "arrowParens": "avoid",
+    "bracketSameLine": true,
+    "bracketSpacing": true,
+    "embeddedLanguageFormatting": "auto",
+    "endOfLine": "lf",
+    "insertFinalNewline": true,
+    "jsdoc": {
+        "bracketSpacing": true,
+        "lineWrappingStyle": "balance",
+        "separateReturnsFromParam": true,
+        "capitalizeDescriptions": true,
+        "descriptionWithDot": false,
+        "commentLineStrategy": "multiline"
+    },
+    "objectWrap": "preserve",
+    "printWidth": 120,
+    "proseWrap": "always",
+    "quoteProps": "consistent",
+    "semi": false,
+    "singleQuote": true,
+    "sortImports": {
+        "newlinesBetween": true
+    },
+    "sortPackageJson": {
+        "sortScripts": true
+    },
+    "tabWidth": 4,
+    "trailingComma": "none",
+    "overrides": [
+        {
+            "files": ["*.yml", "*.yaml"],
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

package/.oxlintrc.json

@@ -1,35 +1,36 @@
-{
-    "$schema": "./node_modules/oxlint/configuration_schema.json",
-    "plugins": ["typescript", "unicorn", "oxc", "eslint", "import", "jsdoc", "node", "promise"],
-    "categories": {
-        "correctness": "error",
-        "suspicious": "error",
-        "pedantic": "warn",
-        "perf": "warn",
-        "style": "warn",
-        "restriction": "off",
-        "nursery": "off"
-    },
-    "rules": {
-        "no-nodejs-modules": "off",
-        "no-magic-numbers": "off",
-        "no-ternary": "off",
-        "sort-imports": ["warn", { "ignoreDeclarationSort": true }],
-        "consistent-type-specifier-style": ["warn", "prefer-inline"],
-        "prefer-default-export": "off",
-        "no-named-export": "off",
-        "prefer-readonly-parameter-types": ["warn", { "ignoreInferredTypes": true }],
-        "group-exports": "off",
-        "unicorn/no-useless-undefined": "off",
-        "no-continue": "off",
-        "require-param-type": "off",
-        "require-returns-type": "off"
-    },
-    "env": {
-        "builtin": true
-    },
-    "options": {
-        "typeAware": true,
-        "typeCheck": true
-    }
-}
+{
+    "$schema": "./node_modules/oxlint/configuration_schema.json",
+    "plugins": ["typescript", "unicorn", "oxc", "eslint", "import", "jsdoc", "node", "promise"],
+    "categories": {
+        "correctness": "error",
+        "suspicious": "error",
+        "pedantic": "warn",
+        "perf": "warn",
+        "style": "warn",
+        "restriction": "off",
+        "nursery": "off"
+    },
+    "rules": {
+        "no-nodejs-modules": "off",
+        "no-magic-numbers": "off",
+        "no-ternary": "off",
+        "sort-imports": ["warn", { "ignoreDeclarationSort": true }],
+        "consistent-type-specifier-style": ["warn", "prefer-inline"],
+        "prefer-default-export": "off",
+        "no-named-export": "off",
+        "prefer-readonly-parameter-types": ["warn", { "ignoreInferredTypes": true }],
+        "group-exports": "off",
+        "unicorn/no-useless-undefined": "off",
+        "no-continue": "off",
+        "require-param-type": "off",
+        "require-returns-type": "off",
+        "max-dependencies": ["warn", { "max": 12 }]
+    },
+    "env": {
+        "builtin": true
+    },
+    "options": {
+        "typeAware": true,
+        "typeCheck": true
+    }
+}

package/.vscode/launch.json

@@ -1,36 +1,36 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "bun",
-            "internalConsoleOptions": "neverOpen",
-            "request": "launch",
-            "name": "Debug File",
-            "program": "${file}",
-            "cwd": "${workspaceFolder}",
-            "stopOnEntry": false,
-            "watchMode": false
-        },
-        {
-            "type": "bun",
-            "internalConsoleOptions": "neverOpen",
-            "request": "launch",
-            "name": "Run File",
-            "program": "${file}",
-            "cwd": "${workspaceFolder}",
-            "noDebug": true,
-            "watchMode": false
-        },
-        {
-            "type": "bun",
-            "internalConsoleOptions": "neverOpen",
-            "request": "attach",
-            "name": "Attach Bun",
-            "url": "ws://localhost:6499/",
-            "stopOnEntry": false
-        }
-    ]
-}
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "bun",
+            "internalConsoleOptions": "neverOpen",
+            "request": "launch",
+            "name": "Debug File",
+            "program": "${file}",
+            "cwd": "${workspaceFolder}",
+            "stopOnEntry": false,
+            "watchMode": false
+        },
+        {
+            "type": "bun",
+            "internalConsoleOptions": "neverOpen",
+            "request": "launch",
+            "name": "Run File",
+            "program": "${file}",
+            "cwd": "${workspaceFolder}",
+            "noDebug": true,
+            "watchMode": false
+        },
+        {
+            "type": "bun",
+            "internalConsoleOptions": "neverOpen",
+            "request": "attach",
+            "name": "Attach Bun",
+            "url": "ws://localhost:6499/",
+            "stopOnEntry": false
+        }
+    ]
+}

package/CHANGELOG.md

@@ -1,3 +1,33 @@
+## [1.1.1](https://github.com/nathievzm/lumi/compare/v1.1.0...v1.1.1) (2026-05-12)
+
+### Bug Fixes
+
+- intro banner and use lightning emoji in outro message
+  ([a3d4f33](https://github.com/nathievzm/lumi/commit/a3d4f3362d847fd8415027c9a73f6fc486dcd770))
+
+# [1.1.0](https://github.com/nathievzm/lumi/compare/v1.0.1...v1.1.0) (2026-05-12)
+
+### Features
+
+- add colors to logs ([#44](https://github.com/nathievzm/lumi/issues/44))
+  ([2dcca2e](https://github.com/nathievzm/lumi/commit/2dcca2e3df40ac577ca5fdaeddbaedecd67d3256))
+- add recursive arg to toggle the recursiveness when reading the input folder
+  ([#25](https://github.com/nathievzm/lumi/issues/25))
+  ([3644d34](https://github.com/nathievzm/lumi/commit/3644d346569aa40a2d6b7007ece64be6b787dc42))
+- clear console on start and add a cute banner at the beginning
+  ([1ad4ade](https://github.com/nathievzm/lumi/commit/1ad4adef1090224915b724374f0e537f371a93a7))
+- **image, index:** make getImages function pure by removing any side effect
+  ([addea55](https://github.com/nathievzm/lumi/commit/addea5542f6b923c36d093797d0b9387c199cfc3))
+- **index:** replace spinnies with clack spinner for cleaner cli ([#42](https://github.com/nathievzm/lumi/issues/42))
+  ([6c59c5a](https://github.com/nathievzm/lumi/commit/6c59c5a62af9d3ac13c94997f063842591f9a799))
+- show the seconds that took to process the files in the result log ([#43](https://github.com/nathievzm/lumi/issues/43))
+  ([439482e](https://github.com/nathievzm/lumi/commit/439482e075af4aaba70da2967743250456b35b20))
+
+### Performance Improvements
+
+- optimize path parsing by using extname and basename instead of parse
+  ([962299f](https://github.com/nathievzm/lumi/commit/962299ffc519826d1c023275290525d92b7d4db2))
+
 ## [1.0.1](https://github.com/nathievzm/lumi/compare/v1.0.0...v1.0.1) (2026-05-10)
 
 ### Bug Fixes

package/README.md

@@ -7,6 +7,7 @@ A fast, interactive CLI tool for batch image processing. Resize, convert, and op
 
 - **Batch Processing:** Process hundreds of images in seconds with high concurrency.
 - **Interactive UI:** User-friendly prompts for missing configurations using `@clack/prompts`.
+- **Recursive Processing:** Automatically finds all images in the input folder and its subdirectories.
 - **Progress Tracking:** Real-time feedback with `spinnies` progress indicators.
 - **Smart Resizing:** Automatically fits images while maintaining aspect ratio (`contain` fit).
 - **Multi-Format Support:** Convert between all formats supported by Sharp (WebP, PNG, JPEG, GIF, AVIF, etc.).
@@ -38,9 +39,14 @@ lumi [options]
 
 ### Interactive Mode
 
-If you run **lumi** without providing required flags (like input/output folders or dimensions), it will guide you
-through the configuration using cute, interactive prompts. You can even choose specific output formats for each unique
-extension found!
+If you run **lumi** without providing required flags (like dimensions or output formats), it will guide you through the
+configuration using cute, interactive prompts.
+
+- **Dimensions:** You can enter a single number for square images (e.g., `1080`) or two numbers for custom dimensions
+  (e.g., `1920 1080`).
+- **Formats:** Choose specific output formats for each unique extension found in your input!
+- **Folders:** By default, **lumi** uses your current directory as the input and creates an `output` folder for the
+  results.
 
 ### CLI Options
 
@@ -50,15 +56,15 @@ You can bypass the prompts by providing the flags directly:
 bunx @nathievzm/lumi -i ./my-vacation-pics -s 1080 -f .webp
 ```
 
-| Flag       | Shortcut | Description                   | Default             |
-| :--------- | :------- | :---------------------------- | :------------------ |
-| `--input`  | `-i`     | Input directory path          | `INPUT_FOLDER` env  |
-| `--output` | `-o`     | Output directory path         | `OUTPUT_FOLDER` env |
-| `--width`  | `-w`     | Target width in pixels        | `WIDTH` env         |
-| `--height` | `-h`     | Target height in pixels       | `HEIGHT` env        |
-| `--size`   | `-s`     | Sets both width and height    | -                   |
-| `--format` | `-f`     | Output format (e.g., `.webp`) | `FORMAT` env        |
-| `--limit`  | `-l`     | Max concurrent operations     | `LIMIT` env         |
+| Flag       | Shortcut | Description                   | Default / Env                |
+| :--------- | :------- | :---------------------------- | :--------------------------- |
+| `--input`  | `-i`     | Input directory path          | `.` / `INPUT_FOLDER`         |
+| `--output` | `-o`     | Output directory path         | `./output` / `OUTPUT_FOLDER` |
+| `--width`  | `-w`     | Target width in pixels        | Prompt / `WIDTH`             |
+| `--height` | `-h`     | Target height in pixels       | Prompt / `HEIGHT`            |
+| `--size`   | `-s`     | Sets both width and height    | -                            |
+| `--format` | `-f`     | Output format (e.g., `.webp`) | Prompt / `FORMAT`            |
+| `--limit`  | `-l`     | Max concurrent operations     | `10` / `LIMIT`               |
 
 ### 🌍 Environment Variables
 
@@ -97,11 +103,12 @@ bun install
 
 - `bun start`: Run the application.
 - `bun dev`: Start with hot reloading.
-- `bun lint`: Check for code quality issues.
+- `bun lint`: Check for code quality issues using `oxlint`.
 - `bun lint:fix`: Fix linting issues automatically.
-- `bun fmt`: Format the codebase.
+- `bun fmt`: Format the codebase using `oxfmt`.
 - `bun fmt:check`: Check for formatting issues.
-- `bun prepare`: Setup husky hooks.
+- `bun changelog`: Update the changelog.
+- `bun release`: Release a new version with `bumpp` and update the changelog.
 
 ## 📄 License
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nathievzm/lumi",
-    "version": "1.0.1",
+    "version": "1.1.1",
     "description": "a concurrent cli tool to resize and convert images using bun and sharp",
     "keywords": [
         "bun",
@@ -51,21 +51,21 @@
     },
     "dependencies": {
         "@clack/prompts": "^1.3.0",
+        "@js-temporal/polyfill": "^0.5.1",
         "image-extensions": "^1.1.0",
         "p-limit": "^7.3.0",
-        "sharp": "^0.34.5",
-        "spinnies": "^0.5.1"
+        "picocolors": "^1.1.1",
+        "sharp": "^0.34.5"
     },
     "devDependencies": {
         "@commitlint/cli": "^20.5.3",
         "@commitlint/config-conventional": "^20.5.3",
         "@types/bun": "latest",
-        "@types/spinnies": "^0.5.3",
         "bumpp": "^11.1.0",
         "conventional-changelog-cli": "^5.0.0",
         "lefthook": "^2.1.6",
         "oxfmt": "^0.47.0",
-        "oxlint": "^1.62.0",
+        "oxlint": "^1.64.0",
         "oxlint-tsgolint": "^0.22.1",
         "typescript": "^6.0.3"
     }

package/src/env.d.ts

@@ -1,28 +1,32 @@
-declare module 'bun' {
-    interface Env {
-        /**
-         * Default target width for resized images.
-         */
-        WIDTH?: string
-        /**
-         * Default target height for resized images.
-         */
-        HEIGHT?: string
-        /**
-         * Default path to the input folder containing images.
-         */
-        INPUT_FOLDER?: string
-        /**
-         * Default path where processed images will be saved.
-         */
-        OUTPUT_FOLDER?: string
-        /**
-         * Default global output format (e.g., '.webp', '.png').
-         */
-        FORMAT?: string
-        /**
-         * Default concurrent processing limit.
-         */
-        LIMIT?: string
-    }
-}
+declare module 'bun' {
+    interface Env {
+        /**
+         * Default target width for resized images.
+         */
+        WIDTH?: string
+        /**
+         * Default target height for resized images.
+         */
+        HEIGHT?: string
+        /**
+         * Default path to the input folder containing images.
+         */
+        INPUT_FOLDER?: string
+        /**
+         * Default path where processed images will be saved.
+         */
+        OUTPUT_FOLDER?: string
+        /**
+         * Default global output format (e.g., '.webp', '.png').
+         */
+        FORMAT?: string
+        /**
+         * Default concurrent processing limit.
+         */
+        LIMIT?: string
+        /**
+         * Whether to process the input directory recursively by default.
+         */
+        RECURSIVE?: string
+    }
+}

package/src/index.ts

@@ -1,73 +1,92 @@
-#!/usr/bin/env bun
-
-import { parse } from 'node:path'
-import { exit } from 'node:process'
-
-import { intro, log, note, outro } from '@clack/prompts'
-import pLimit from 'p-limit'
-import Spinnies from 'spinnies'
-
-import { cli } from '@/args'
-import { getMessage } from '@/error'
-import { ensureOutputExists, getInputPath, getOutputPath } from '@/folder'
-import { getExtensions, getValidImages, getWidthAndHeight, resize } from '@/image'
-
-intro('✨ welcome to lumi ✨')
-
-const input = getInputPath(cli.input)
-const images = await getValidImages(input)
-
-if (images.length === 0) {
-    log.error('yikes! no valid images found in the input folder 😭')
-    outro('please add some images to the input folder and try again 👋')
-    exit(1)
-}
-
-note(`found ${images.length} images to process! 🚀`)
-
-const output = getOutputPath(cli.output)
-await ensureOutputExists(output)
-
-const { width, height } = await getWidthAndHeight(cli.width, cli.height)
-
-const spinnies = new Spinnies({
-    failColor: 'red',
-    spinnerColor: 'magenta',
-    succeedColor: 'green'
-})
-
-const extensions = await getExtensions(images, cli.format)
-const limit = pLimit({ concurrency: cli.limit || 10, rejectOnClear: true })
-
-const promises = images.map(image =>
-    limit(async () => {
-        spinnies.add(image, { text: `processing: ${image}` })
-
-        const { name, ext } = parse(image)
-        const extension = extensions['default'] ?? extensions[ext] ?? '.png'
-
-        try {
-            const result = await resize({ extension, height, image, input, name, output, width })
-            spinnies.succeed(image, { text: result })
-        } catch (error: unknown) {
-            const message = getMessage(error)
-            spinnies.fail(image, { text: message })
-            throw error
-        }
-    })
-)
-
-log.message()
-
-const result = await Promise.allSettled(promises)
-let outroMessage = ''
-
-if (result.some(pr => pr.status === 'rejected')) {
-    log.error('yikes, some images failed to process! 😢')
-    outroMessage = 'please check the error messages above and try again 🛠️'
-} else {
-    log.success('yay! all images processed and saved successfully! 💖')
-    outroMessage = 'bye 👋'
-}
-
-outro(outroMessage)
+#!/usr/bin/env bun
+
+import { readdir } from 'node:fs/promises'
+import { basename, extname } from 'node:path'
+import { exit } from 'node:process'
+
+import { intro, log, note, outro, spinner } from '@clack/prompts'
+import { Temporal } from '@js-temporal/polyfill'
+import pLimit from 'p-limit'
+import color from 'picocolors'
+
+import { cli } from '@/args'
+import { ensureOutputExists, getInputPath, getOutputPath } from '@/folder'
+import { getExtensions, getImages, getWidthAndHeight, resize } from '@/image'
+
+import pkg from '../package.json'
+
+console.clear()
+
+const banner = color.magenta(`
+╭──────────────────────────────╮
+│                              │
+│          🩷 lumi 🩷          │
+│                              │
+╰──────────────────────────────╯
+    `)
+
+console.log(banner)
+
+intro(color.magenta(`welcome to lumi v${pkg.version} 🩷`))
+
+const input = getInputPath(cli.input)
+
+const allFiles = await readdir(input, { recursive: cli.recursive })
+const images = getImages(allFiles)
+
+if (images.length === 0) {
+    log.error('yikes! no valid images found in the input folder 😭')
+    outro('please add some images to the input folder and try again 👋')
+    exit(1)
+}
+
+note(`found ${color.magenta(images.length)} images to process! 🚀`)
+
+const output = getOutputPath(cli.output)
+await ensureOutputExists(output)
+
+const { width, height } = await getWidthAndHeight(cli.width, cli.height)
+
+const extensions = await getExtensions(images, cli.format)
+const limit = pLimit({ concurrency: cli.limit || 10, rejectOnClear: true })
+
+const spin = spinner()
+spin.start(`processing: ${color.magenta(0)}/${color.magenta(images.length)} images 🔃`)
+
+let processed = 0
+
+const startTime = Temporal.Now.instant()
+
+const promises = images.map(image =>
+    limit(async () => {
+        const ext = extname(image)
+        const name = basename(image, ext)
+        const extension = extensions['default'] ?? extensions[ext] ?? '.png'
+
+        await resize({ extension, height, image, input, name, output, width })
+
+        processed++
+        spin.message(`processing: ${color.green(processed)}/${color.magenta(images.length)} images 🔃`)
+    })
+)
+
+log.message()
+
+const result = await Promise.allSettled(promises)
+
+const endTime = Temporal.Now.instant()
+const duration = startTime.until(endTime).total('seconds').toFixed(2)
+
+let outroMessage = ''
+
+if (result.some(pr => pr.status === 'rejected')) {
+    spin.error(
+        `yikes! finished with errors. processed ${color.red(processed)}/${color.red(images.length)} images in ${color.yellow(duration)} seconds 😢`
+    )
+    outroMessage = 'please check your input files and try again 🛠️'
+} else {
+    spin.stop(`yay! ${color.green(images.length)} images processed in ${color.green(duration)} seconds! \u26A1\uFE0F`)
+    outroMessage = 'bye 👋'
+}
+
+outro(color.magenta(outroMessage))