cdd-cli 3.1.7 → 3.1.9

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,29 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## [Unreleased]
 - Nothing yet.
 
+## [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'
   ]
 };

package/dist/components/ContainerRow.js

@@ -1,19 +1,8 @@
-function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
-function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
-function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
-function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
-function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
-function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
-function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-import React, { useState, useEffect } from "react";
+import React from "react";
 import { Box, Text } from "ink";
-import { getStats } from "../helpers/dockerService/serviceComponents/containerStats.js";
-import { REFRESH_INTERVALS } from "../helpers/constants.js";
 import StatsBar from "./StatsBar.js";
 import PropTypes from 'prop-types';
+import { useContainerStats } from '../hooks/useContainerStats.js';
 var stateText = function stateText(state) {
   if (state === "running") return {
     text: "🟢 RUNNING",
@@ -48,17 +37,9 @@ export default function ContainerRow(_ref) {
     name = container.name,
     image = container.image,
     state = container.state;
-  var _useState = useState({
-      cpuPercent: 0,
-      memPercent: 0,
-      netIO: {
-        rx: 0,
-        tx: 0
-      }
-    }),
-    _useState2 = _slicedToArray(_useState, 2),
-    stats = _useState2[0],
-    setStats = _useState2[1];
+  var _useContainerStats = useContainerStats(id, state),
+    stats = _useContainerStats.stats,
+    statsError = _useContainerStats.statsError;
 
   // Format ports for display (no leading space to avoid layout shifts)
   var formatPorts = function formatPorts(ports) {
@@ -77,60 +58,6 @@ export default function ContainerRow(_ref) {
     if (!s) return "";
     return s.length > max ? s.slice(0, max - 1) + "…" : s;
   };
-  var _useState3 = useState(""),
-    _useState4 = _slicedToArray(_useState3, 2),
-    statsError = _useState4[0],
-    setStatsError = _useState4[1];
-  useEffect(function () {
-    if (state !== "running") return;
-    var isMounted = true;
-    var fetchStats = /*#__PURE__*/function () {
-      var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
-        var s, _t;
-        return _regenerator().w(function (_context) {
-          while (1) switch (_context.p = _context.n) {
-            case 0:
-              _context.p = 0;
-              _context.n = 1;
-              return getStats(id);
-            case 1:
-              s = _context.v;
-              if (isMounted) {
-                setStats(s);
-                setStatsError("");
-              }
-              _context.n = 3;
-              break;
-            case 2:
-              _context.p = 2;
-              _t = _context.v;
-              if (isMounted) {
-                setStats({
-                  cpuPercent: 0,
-                  memPercent: 0,
-                  netIO: {
-                    rx: 0,
-                    tx: 0
-                  }
-                });
-                setStatsError("Error fetching stats");
-              }
-            case 3:
-              return _context.a(2);
-          }
-        }, _callee, null, [[0, 2]]);
-      }));
-      return function fetchStats() {
-        return _ref2.apply(this, arguments);
-      };
-    }();
-    fetchStats();
-    var timer = setInterval(fetchStats, REFRESH_INTERVALS.CONTAINER_STATS);
-    return function () {
-      isMounted = false;
-      clearInterval(timer);
-    };
-  }, [id, state]);
   var stateInfo = stateText(state);
   return /*#__PURE__*/React.createElement(Box, {
     flexDirection: "column",

package/dist/components/LogViewer.js

@@ -1,10 +1,10 @@
 import React from "react";
-import { Text, useInput } from "ink";
-import { safeCall } from "../helpers/safeCall.js";
+import { Text } from "ink";
 import PropTypes from 'prop-types';
 
 /**
- * Log viewer overlay component. Shows the most recent lines and closes on ESC.
+ * Log viewer overlay component. Shows the most recent lines.
+ * Purely presentational — keyboard handling is centralized in useControls.
  *
  * @param {Object} props
  * @param {Array<string>} props.logs - Array of log lines
@@ -15,13 +15,8 @@ import PropTypes from 'prop-types';
 export default function LogViewer(_ref) {
   var _container$name;
   var logs = _ref.logs,
-    onExit = _ref.onExit,
+    _onExit = _ref.onExit,
     container = _ref.container;
-  useInput(function (input, key) {
-    if (key.escape) {
-      safeCall(onExit);
-    }
-  });
   var visibleLogs = logs.slice(-15);
   return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Text, {
     color: "green"

package/dist/helpers/containerOptionsBuilder.js

@@ -0,0 +1,58 @@
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+/**
+ * Builds Docker container creation options from raw user inputs.
+ *
+ * This is a pure function — it has no side effects and calls no services.
+ * It mirrors exactly the option-building logic in useControls.js onCreate callback.
+ *
+ * @param {object} params
+ * @param {string} params.imageName          - Docker image name (e.g. "nginx:alpine")
+ * @param {string} [params.containerName]    - Optional container name
+ * @param {string} [params.portInput]        - Comma-separated host:container port pairs
+ *                                            (e.g. "8080:80,3000:3000")
+ * @param {string} [params.envInput]         - Comma-separated KEY=VALUE pairs
+ *                                            (e.g. "NODE_ENV=production,PORT=3000")
+ * @returns {object} Docker container options ready to pass to createContainer
+ */
+export function buildContainerOptions(_ref) {
+  var _imageName = _ref.imageName,
+    containerName = _ref.containerName,
+    portInput = _ref.portInput,
+    envInput = _ref.envInput;
+  var env = (envInput || "").split(",").map(function (s) {
+    return s.trim();
+  }).filter(Boolean);
+  var ports = (portInput || "").split(",").map(function (s) {
+    return s.trim();
+  }).filter(Boolean);
+  var ExposedPorts = {};
+  var PortBindings = {};
+  ports.forEach(function (pair) {
+    var _pair$split = pair.split(":"),
+      _pair$split2 = _slicedToArray(_pair$split, 2),
+      host = _pair$split2[0],
+      cont = _pair$split2[1];
+    if (!host || !cont) return;
+    var key = "".concat(cont, "/tcp");
+    ExposedPorts[key] = {};
+    PortBindings[key] = PortBindings[key] || [];
+    PortBindings[key].push({
+      HostPort: "".concat(host)
+    });
+  });
+  var options = {
+    Tty: true
+  };
+  if (Object.keys(ExposedPorts).length) options.ExposedPorts = ExposedPorts;
+  if (Object.keys(PortBindings).length) options.HostConfig = {
+    PortBindings: PortBindings
+  };
+  if (env.length) options.Env = env;
+  if (containerName) options.name = containerName;
+  return options;
+}

package/dist/hooks/creation/useContainerCreation.js

@@ -117,6 +117,20 @@ export function useContainerCreation(_ref) {
     setMessageColor("yellow");
     safeCall(onCancel);
   }
+
+  /**
+   * Resets all creation state to initial values without triggering onCancel.
+   * Used by the command router when the user presses 'c' to open the creation wizard.
+   */
+  function resetCreation() {
+    setStep(0);
+    setImageName("");
+    setContainerName("");
+    setPortInput("");
+    setEnvInput("");
+    setMessage("Insert the name of the image to create: ");
+    setMessageColor("yellow");
+  }
   return {
     step: step,
     setStep: setStep,
@@ -133,6 +147,7 @@ export function useContainerCreation(_ref) {
     messageColor: messageColor,
     setMessageColor: setMessageColor,
     nextStep: nextStep,
-    cancelCreation: cancelCreation
+    cancelCreation: cancelCreation,
+    resetCreation: resetCreation
   };
 }

package/dist/hooks/debug/useDebugLogs.js

@@ -0,0 +1,46 @@
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+import { useState, useEffect } from 'react';
+import { logger } from '../../helpers/logger.js';
+export function useDebugLogs() {
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    showDebugLogs = _useState2[0],
+    setShowDebugLogs = _useState2[1];
+  var _useState3 = useState([]),
+    _useState4 = _slicedToArray(_useState3, 2),
+    debugLogs = _useState4[0],
+    setDebugLogs = _useState4[1];
+  useEffect(function () {
+    var unsubscribe = logger.subscribe(function (entry) {
+      setDebugLogs(function (prev) {
+        var extras = (entry.args || []).map(function (arg) {
+          if (typeof arg === "string") return arg;
+          if (typeof arg === "number" || typeof arg === "boolean") return String(arg);
+          try {
+            return JSON.stringify(arg);
+          } catch (err) {
+            return "[unserializable]";
+          }
+        }).filter(Boolean);
+        var line = extras.length ? "".concat(entry.formatted, " ").concat(extras.join(" ")) : entry.formatted;
+        var next = [].concat(_toConsumableArray(prev), [line]);
+        return next.slice(-200);
+      });
+    });
+    return unsubscribe;
+  }, []);
+  return {
+    showDebugLogs: showDebugLogs,
+    setShowDebugLogs: setShowDebugLogs,
+    debugLogs: debugLogs
+  };
+}