cdd-cli 3.1.3 → 3.1.5

package/.eslintrc.json

@@ -0,0 +1,30 @@
+{
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2021": true,
+    "jest": true
+  },
+  "extends": ["eslint:recommended", "plugin:react/recommended"],
+  "parserOptions": {
+    "ecmaVersion": 2021,
+    "sourceType": "module",
+    "ecmaFeatures": { "jsx": true }
+  },
+  "rules": {
+    "no-unsafe-optional-chaining": "error",
+    "react/react-in-jsx-scope": "off",
+    "no-console": "off",
+    "react/prop-types": "off",
+    "no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^(?:_|React)$"
+      }
+    ]
+  },
+  "settings": {
+    "react": { "version": "detect" }
+  }
+}

package/.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: Build and deploy docs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build docs
+        run: npm run docs
+
+      - name: Deploy to GitHub Pages (push to gh-pages)
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./docs

package/CHANGELOG.md

@@ -4,6 +4,50 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [Unreleased]
+- Nothing yet.
+
+## [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._
+
+### Added
+
+- `safeCall` utility to safely invoke optional callbacks and avoid uncaught errors from consumer callbacks.
+- PropTypes added to core React components for runtime prop validation (ContainerRow, ContainerList, LogViewer, StatsBar, ContainerCreationPrompt, PromptField, MessageFeedback, Header, ContainerSection).
+
+### Changed
+
+- Container creation now inspects image `EXPOSE` declarations and auto-binds ports when the user leaves the ports step empty, reusing the next free host port to avoid conflicts (e.g. second `nginx` gets `81:80`).
+- CLI clears the terminal when starting and again after exiting with `q` for a cleaner shell experience.
+- Replaced direct optional callback invocations and stream destruction calls with `safeCall` in several modules (`containerLogs`, `useLogsStream`, `useLogsViewer`, `useContainerCreation`, `useContainerActions`, `LogViewer`).
+- ESLint config updated to include `jest` env and allow keeping `import React` for build compatibility.
+- Extracted common magic numbers into `src/helpers/constants.js` and replaced hardcoded values across the codebase:
+	- `REFRESH_INTERVALS.CONTAINER_LIST` (3000)
+	- `REFRESH_INTERVALS.CONTAINER_STATS` (1500)
+	- `MESSAGE_TIMEOUTS.SHORT` (2000) and `MESSAGE_TIMEOUTS.DEFAULT` (3000)
+	- `EXIT_DELAY` (500)
+	- `TIMEOUTS.CONTAINER_OP` (30000) and `TIMEOUTS.PULL_IMAGE` (300000)
+- Files updated to use constants: `useContainers`, `ContainerRow`, `actionHelpers`, `useControls`, `exitWithMessage`, `containerActions`.
+
+### Fixed
+
+- Added unit tests for `safeCall` and adjusted several components to silence lint warnings (unused variables).
+- Clamp `StatsBar` CPU/memory percentages to avoid negative repeat errors when streaming container stats (also refreshed component JSDoc to note the clamping).
+
+### Testing
+
+- Added additional unit tests for Docker service functions and hooks. All tests pass locally (5 suites, 26 tests).
+- Removed generated `dist/` artifacts and deleted obsolete test files that referenced incompatible test helpers.
+
+Incoming fixes and smaller tests / docs updates
+
+## [3.1.4] - 2025-10-17
+
+### Changed
+
+- Documentation cleanup: translate `FIXES_APPLIED.md` to English, remove Spanish duplicate and references to internal audit doc.
+- No functional code changes.
+
 ## [3.1.3] - 2025-10-17
 
 ### Fixed
@@ -44,10 +88,6 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - Various runtime & build issues after modularization (import fixes, exposing container action functions, creation flow wiring).
 
-## [Unreleased]
-
-- Incoming fixes and smaller tests / docs updates
-
 ## [3.1.1] - 2025-10-16
 
 ### Fixed