cdd-cli 3.1.7 → 3.2.0

package/.eslintrc.json

@@ -15,7 +15,7 @@
     "no-unsafe-optional-chaining": "error",
     "react/react-in-jsx-scope": "off",
     "no-console": "off",
-    "react/prop-types": "off",
+    "react/prop-types": "warn",
     "no-unused-vars": [
       "warn",
       {

package/.github/workflows/ci.yml

@@ -22,6 +22,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Lint
+        run: npm run lint
+
       - name: Run tests
         run: npm test
 

package/.github/workflows/docs.yml

@@ -1,12 +1,16 @@
 name: Build and deploy docs
 
 on:
-  push:
+  workflow_run:
+    workflows: ["CI"]
+    types:
+      - completed
     branches:
       - main
 
 jobs:
   build-and-deploy:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -28,6 +32,9 @@ jobs:
       - name: Build docs
         run: npm run docs
 
+      - name: Ensure .nojekyll
+        run: mkdir -p docs && touch docs/.nojekyll
+
       - name: Deploy to GitHub Pages (push to gh-pages)
         uses: peaceiris/actions-gh-pages@v3
         with:

package/CHANGELOG.md

@@ -7,6 +7,46 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## [Unreleased]
 - Nothing yet.
 
+## [3.2.0] - 2026-04-25
+
+### Added
+
+- `IMAGE_PROFILES` map in `src/helpers/constants.js` — defines `requiredEnv` and `defaultPort` per image type (mysql, mariadb, postgres, mongo, mssql, redis).
+- `DB_IMAGES` constant exported from `src/helpers/constants.js`.
+- Contextual validation in wizard: if image matches a known profile, required env vars are enforced before creation.
+- Auto-assigned port feedback: after successful container creation, the success message shows which ports were mapped (e.g. `Ports: 3306→3306/tcp`).
+- Image name normalization: tags and registry prefixes are stripped before profile lookup (`mysql:8`, `docker.io/library/postgres:16` → `mysql`, `postgres`).
+- New test files: `test/containerOptionsBuilder.test.js`, `test/useControls.dom.test.js`.
+
+### Fixed
+
+- `validateEnvVars()` was never called in the container creation wizard step 3 — now connected and blocks on invalid input.
+- Env var parsing split on all `=` characters — fixed to split only on the first `=`, preserving values like `JWT=abc=def`.
+- `dbImages` was hardcoded in `useControls.js` — now imports `DB_IMAGES` from constants.
+
+## [3.1.9] - 2026-04-11
+
+### Changed
+
+- CI: added lint step to the test-and-build job; docs deploy now waits for CI to pass successfully via `workflow_run` trigger.
+
+## [3.1.8] - 2026-04-11
+
+### Refactored
+
+- Removed dead code: `actionHelpers`, `useLogsStream`, and esbuild-related artifacts that were no longer in use.
+- Consolidated Babel configuration into a single env-aware file, eliminating duplicate/split config files.
+- Decomposed `useControls` god hook into focused single-responsibility hooks, each owning one concern.
+- Extracted `useContainerStats` hook from `ContainerRow` to separate data-fetching from rendering.
+- Set Jest default environment to `node`; `jsdom` is now opt-in per test file, reducing unnecessary DOM overhead.
+
+### Changed
+
+- Removed generated JSDoc output from the repository; added the generated docs directory to `.gitignore`.
+- Enabled `react/prop-types` ESLint rule project-wide and resolved all resulting warnings.
+- Rewrote `README.md` and `CONTRIBUTING.md`: consolidated overlapping content, removed duplication, and updated both for accuracy.
+- Various `docs(style)` and `docs` commits between v3.1.5 and the refactor wave: dark theme, sticky nav, landing page rewrite, CSS consolidation, and English translation for the JSDoc home (GitHub Pages site).
+
 ## [3.1.5] - 2025-10-18
 _Note: I'm sorry about the issues you've run into; this is a brand-new app and I'm still learning, but I'm moving as quickly as I can to deliver a quality experience._
 

package/CONTRIBUTING.md

@@ -1,22 +1,35 @@
-# Contributing
+# Contributing to CDD-CLI
 
-Thanks for your interest in contributing! Please follow these guidelines:
+Thanks for your interest in contributing! Here are the guidelines to make collaboration smooth.
 
-- Fork the repository and create a feature branch.
-- Keep changes small and focused.
-- Add or update tests for new behaviors.
-- Run `npm test` and `npm run build` before opening a PR.
-- Use conventional commits where possible.
+## Getting started
 
-For any design or large changes, open an issue first to discuss.
-## Contributing to CDD-CLI
+1. Fork the repo and create a branch for your feature or fix:
 
-Thanks for your interest in contributing! A few guidelines to make collaboration smooth:
+```bash
+git checkout -b feat/my-feature
+```
 
-- Fork the repo and create a branch for your feature/fix: `git checkout -b feat/my-feature`.
-- Write tests for any new behavior and ensure existing tests pass: `npm test`.
-- Follow the existing code style and run `npm run build` before opening a PR.
-- Keep PRs focused and describe motivation and changes.
-- Tag reviewers and link related issues.
+2. Install dependencies and verify everything works before making changes:
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+## Guidelines
+
+- Keep changes small and focused — one concern per PR.
+- Write tests for any new behavior and ensure existing tests pass (`npm test`).
+- Run `npm run build` and verify the CLI starts (`node dist/index.js`) before opening a PR.
+- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages.
+- For large or design-changing contributions, open an issue first to discuss the approach.
+
+## Opening a Pull Request
+
+- Describe the motivation and what changed.
+- Link any related issues.
+- Tag reviewers if applicable.
 
 We appreciate clear, well-tested contributions.

package/README.md

@@ -6,34 +6,47 @@
   <a href="https://github.com/caertos/cdd/actions/workflows/ci.yml">
     <img src="https://github.com/caertos/cdd/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI status" />
   </a>
-  <!-- Documentation published to GitHub Pages -->
   <a href="https://caertos.github.io/cdd/">
     <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue" alt="Docs" />
   </a>
+  <a href="https://deepwiki.com/Caertos/cdd"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
-Short, bilingual README with quickstart, development and tests.
+A terminal dashboard for monitoring and managing Docker containers in real time. Shows live CPU/memory stats, supports keyboard-driven actions, and requires no GUI.
 
 ---
 
-## Quick start (local)
+## Features
+
+- 🐳 Clear, compact view of all Docker containers
+- 🔄 Auto-refresh every few seconds
+- ⌨️ Keyboard shortcuts for fast actions (navigate, start, stop, logs, quit)
+- 📊 Live CPU and memory stats for running containers
+- 🪵 Real-time log streaming for selected containers
+- 🎨 Color-coded states and visual feedback
 
-1. Clone the repo and install dependencies:
+---
+
+## Install globally
 
 ```bash
-git clone https://github.com/caertos/cdd.git
-cd cdd
-npm install
+npm install -g cdd-cli
+cdd
 ```
 
-2. Build and run locally:
+---
+
+## Quick start (local)
 
 ```bash
+git clone https://github.com/caertos/cdd.git
+cd cdd
+npm install
 npm run build
 node dist/index.js
 ```
 
-3. To test the CLI as a globally available command during development:
+To use it as a global command during development:
 
 ```bash
 npm link
@@ -42,96 +55,65 @@ cdd
 
 ---
 
-## Usage (interactive)
+## Usage
 
-- Use ↑/↓ to navigate containers.
-- I: start selected container
-- P: stop selected container
-- R: restart selected container
-- C: create container (interactive prompt)
-- L: view logs for selected container
-- D: toggle the on-screen debug log panel
-- E: erase (remove) selected container (confirmation required)
-- Q: quit
+Use ↑/↓ to navigate containers. Available keyboard shortcuts:
 
-The dashboard auto-refreshes container list every few seconds.
+| Key | Action |
+|-----|--------|
+| `I` | Start selected container |
+| `P` | Stop selected container |
+| `R` | Restart selected container |
+| `C` | Create container (interactive prompt) |
+| `L` | View logs for selected container |
+| `E` | Erase (remove) selected container — confirmation required |
+| `D` | Toggle live debug log panel |
+| `Q` | Quit |
 
 ---
 
-## Install globally
-
-To install the CLI globally so you can run `cdd` from any terminal, use:
-
-```bash
-npm install -g cdd-cli
-```
-
-After installing globally, run the CLI with:
+## Requirements
 
-```bash
-cdd
-```
+- Node.js >= 18
+- Docker installed and running (CLI connects to the local Docker socket)
 
 ---
 
 ## Development
 
-- Node.js >= 18 is recommended.
-- To run the app from source during development:
-
 ```bash
 npm install
-npm run build
-node dist/index.js
+npm run build        # compile src/ → dist/
+node dist/index.js   # run from compiled output
 ```
 
-If you change source files, re-run `npm run build` before running the CLI.
+Re-run `npm run build` after any source changes.
 
 ---
 
 ## Tests
 
-We use Jest for unit tests. Run:
-
 ```bash
 npm test
 ```
 
-Tests are located in `test/` and cover utility helpers.
-
----
-
-## Contributing
-
-1. Fork the repo and create a feature branch.
-2. Add tests for new behavior.
-3. Ensure `npm test` and `npm run build` pass.
-4. Open a Pull Request with a clear description.
-
----
-
-## Troubleshooting
-
-- If you don't see containers, ensure Docker is running and that your user has access to the Docker socket.
-- If Docker permissions are required, run the CLI with `sudo` (Linux/macOS) or as Administrator (Windows).
-- The project generates `dist/` — keep it out of version control (it's in .gitignore).
+Tests are in `test/` and cover helpers, services, and hooks.
 
 ---
 
 ## Logging
 
-- The CLI logs high-level `info`, `warn`, and `error` messages by default so you see meaningful feedback without noise.
-- When you need deeper diagnostics (for example, to troubleshoot why stats or logs are not updating), start the CLI with debug logging enabled:
+By default the CLI shows `info`, `warn`, and `error` messages. For deeper diagnostics:
 
 ```bash
-CDD_LOG_LEVEL=debug cdd          # if you installed globally
+CDD_LOG_LEVEL=debug cdd
 # or
 CDD_LOG_LEVEL=debug node dist/index.js
 ```
 
-- The same effect can be achieved with `LOG_LEVEL=debug`. Set `LOG_LEVEL=warn` if you only want to see warnings and errors.
-- Inside the CLI, press `D` to toggle the live debug log panel; press `D` again or `Esc` to hide it.
-- Redirect output to a file when users report issues so they can share the log easily:
+Press `D` inside the CLI to toggle the live debug panel. Press `D` again or `Esc` to hide it.
+
+To capture logs to a file:
 
 ```bash
 CDD_LOG_LEVEL=debug cdd > cdd-debug.log 2>&1
@@ -139,34 +121,20 @@ CDD_LOG_LEVEL=debug cdd > cdd-debug.log 2>&1
 
 ---
 
-## License
-
-This project is MIT/ISC licensed (see `LICENSE`).
+## Troubleshooting
 
-   ```
+- If you don't see containers, ensure Docker is running and your user has access to the Docker socket.
+- On Linux/macOS, try `sudo cdd` if you have permission issues. On Windows, run as Administrator.
+- `dist/` is generated by the build — it's in `.gitignore` and should not be committed.
 
-## Usage
-- When you run `cdd`, you'll see a table with all your Docker containers.
-- Running containers show live CPU and memory stats.
-- Use `Ctrl+C` to exit.
-
-## Main features
-- 🐳 Clear, compact visualization of all containers.
-- 🔄 Automatic data refresh (every 2 seconds).
-- ⌨️ Keyboard shortcuts for fast actions (navigate, start, stop, logs, quit).
-- 📊 Live resource usage stats for running containers.
-- 🪵 Real-time log streaming for selected containers.
-- 🎨 Visual interface with colors and emojis for states.
-- 👤 Author: Carlos Cochero (2025)
+---
 
-## Requirements
-- Node.js >= 18
-- Docker installed and running (CLI connects to local Docker socket)
+## Contributing
 
-## Troubleshooting
-- If you don't see containers, make sure Docker is running and your user has permission to access the Docker socket.
-- If you have issues with global install, try with `sudo` (Linux/macOS) or run terminal as administrator (Windows).
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ---
 
-¡Disfruta monitoreando tus contenedores Docker desde la terminal con estilo! / Enjoy monitoring your Docker containers from the terminal in style!
+## License
+
+MIT/ISC — see [`LICENSE`](LICENSE).

package/babel.config.cjs

@@ -1,6 +1,23 @@
 module.exports = {
+  env: {
+    test: {
+      // Jest necesita CJS (transpila módulos) + React
+      presets: [
+        ['@babel/preset-env', { targets: { node: 'current' } }],
+        '@babel/preset-react'
+      ]
+    },
+    // build (NODE_ENV != 'test') → mantiene ESM para el output final
+    production: {
+      presets: [
+        ['@babel/preset-env', { modules: false }],
+        '@babel/preset-react'
+      ]
+    }
+  },
+  // Fallback para cualquier otro entorno (desarrollo local, etc.)
   presets: [
-    ['@babel/preset-env', { targets: { node: 'current' } }],
+    ['@babel/preset-env', { modules: false }],
     '@babel/preset-react'
   ]
 };