cdd-cli 3.2.0 → 4.0.0

package/dist/hooks/creation/useContainerCreation.js

@@ -1,12 +1,52 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+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 { useState } from "react";
-import { validatePorts } from "../../helpers/validationHelpers.js";
-import { safeCall } from "../../helpers/safeCall.js";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { useReducer, useState, useRef, useEffect } from 'react';
+import { validatePorts, validateEnvVars } from '../../helpers/validationHelpers.js';
+import { IMAGE_PROFILES, resolveImageTag } from '../../helpers/constants.js';
+import { safeCall } from '../../helpers/safeCall.js';
+import { searchDockerHub, formatHubResult } from '../../helpers/dockerHubService.js';
+var MAX_VISIBLE = 6;
+var INITIAL_FORM = {
+  step: 0,
+  imageName: '',
+  containerName: '',
+  portInput: '',
+  envInput: '',
+  message: '',
+  messageColor: 'yellow',
+  suggestions: [],
+  selectedSuggestionIndex: -1,
+  visibleOffset: 0
+};
+function formReducer(state, action) {
+  switch (action.type) {
+    case 'RESET':
+      return _objectSpread({}, INITIAL_FORM);
+    case 'RESET_WIZARD':
+      return _objectSpread(_objectSpread({}, INITIAL_FORM), {}, {
+        message: 'Insert the name of the image to create: ',
+        messageColor: 'yellow'
+      });
+    case 'SET':
+      return _objectSpread(_objectSpread({}, state), action.payload);
+    default:
+      return state;
+  }
+}
 
 /**
  * Custom hook to manage the container creation flow, step by step.
@@ -15,42 +55,328 @@ import { safeCall } from "../../helpers/safeCall.js";
  * @param {Object} params
  * @param {Function} params.onCreate - Callback when creation is confirmed
  * @param {Function} params.onCancel - Callback when creation is cancelled
- * @param {Array<string>} params.dbImages - List of DB image names for env var warning
+ * @param {Array<string>} params.dbImages - List of DB image names for env var warning (legacy)
+ * @param {Object} [params.imageProfiles] - Image profiles map for contextual validation
  * @returns {Object} Creation state, setters, and helpers
  */
 export function useContainerCreation(_ref) {
+  var _imageProfiles$baseNa, _imageProfiles$baseNa2;
   var onCreate = _ref.onCreate,
     onCancel = _ref.onCancel,
     _ref$dbImages = _ref.dbImages,
-    dbImages = _ref$dbImages === void 0 ? [] : _ref$dbImages;
-  var _useState = useState(0),
+    dbImages = _ref$dbImages === void 0 ? [] : _ref$dbImages,
+    _ref$imageProfiles = _ref.imageProfiles,
+    imageProfiles = _ref$imageProfiles === void 0 ? IMAGE_PROFILES : _ref$imageProfiles;
+  var _useReducer = useReducer(formReducer, INITIAL_FORM),
+    _useReducer2 = _slicedToArray(_useReducer, 2),
+    form = _useReducer2[0],
+    dispatch = _useReducer2[1];
+  var step = form.step,
+    imageName = form.imageName,
+    containerName = form.containerName,
+    portInput = form.portInput,
+    envInput = form.envInput,
+    message = form.message,
+    messageColor = form.messageColor,
+    suggestions = form.suggestions,
+    selectedSuggestionIndex = form.selectedSuggestionIndex,
+    visibleOffset = form.visibleOffset;
+
+  // Convenience setters that mirror the old useState API
+  var setStep = function setStep(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        step: v
+      }
+    });
+  };
+  var setImageName = function setImageName(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        imageName: v
+      }
+    });
+  };
+  var setContainerName = function setContainerName(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        containerName: v
+      }
+    });
+  };
+  var setPortInput = function setPortInput(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        portInput: v
+      }
+    });
+  };
+  var setEnvInput = function setEnvInput(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        envInput: typeof v === 'function' ? v(form.envInput) : v
+      }
+    });
+  };
+  var setMessage = function setMessage(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        message: v
+      }
+    });
+  };
+  var setMessageColor = function setMessageColor(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        messageColor: v
+      }
+    });
+  };
+  var setSuggestions = function setSuggestions(v) {
+    return dispatch({
+      type: 'SET',
+      payload: {
+        suggestions: v
+      }
+    });
+  };
+  var setSelectedSuggestionIndex = function setSelectedSuggestionIndex(fn) {
+    // Support both direct value and updater function
+    if (typeof fn === 'function') {
+      dispatch({
+        type: 'SET',
+        payload: {
+          selectedSuggestionIndex: fn(form.selectedSuggestionIndex)
+        }
+      });
+    } else {
+      dispatch({
+        type: 'SET',
+        payload: {
+          selectedSuggestionIndex: fn
+        }
+      });
+    }
+  };
+  var setVisibleOffset = function setVisibleOffset(fn) {
+    if (typeof fn === 'function') {
+      dispatch({
+        type: 'SET',
+        payload: {
+          visibleOffset: fn(form.visibleOffset)
+        }
+      });
+    } else {
+      dispatch({
+        type: 'SET',
+        payload: {
+          visibleOffset: fn
+        }
+      });
+    }
+  };
+
+  // Docker Hub search state (kept as useState because they are independent of form)
+  var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
-    step = _useState2[0],
-    setStep = _useState2[1]; // 0: image, 1: name, 2: ports, 3: env
-  var _useState3 = useState(""),
+    isSearchingHub = _useState2[0],
+    setIsSearchingHub = _useState2[1];
+  var _useState3 = useState(null),
     _useState4 = _slicedToArray(_useState3, 2),
-    imageName = _useState4[0],
-    setImageName = _useState4[1];
-  var _useState5 = useState(""),
-    _useState6 = _slicedToArray(_useState5, 2),
-    containerName = _useState6[0],
-    setContainerName = _useState6[1];
-  var _useState7 = useState(""),
-    _useState8 = _slicedToArray(_useState7, 2),
-    portInput = _useState8[0],
-    setPortInput = _useState8[1];
-  var _useState9 = useState(""),
-    _useState0 = _slicedToArray(_useState9, 2),
-    envInput = _useState0[0],
-    setEnvInput = _useState0[1];
-  var _useState1 = useState(""),
-    _useState10 = _slicedToArray(_useState1, 2),
-    message = _useState10[0],
-    setMessage = _useState10[1];
-  var _useState11 = useState("yellow"),
-    _useState12 = _slicedToArray(_useState11, 2),
-    messageColor = _useState12[0],
-    setMessageColor = _useState12[1];
+    hubResults = _useState4[0],
+    setHubResults = _useState4[1];
+  // Tracks active request: { controller: AbortController|null, requestId: number }
+  var activeHubRequestRef = useRef({
+    controller: null,
+    requestId: 0
+  });
+
+  // Timer for auto-clearing messages
+  var messageTimerRef = useRef(null);
+  function setTimedMessage(msg) {
+    var color = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'yellow';
+    var ms = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 4000;
+    clearTimeout(messageTimerRef.current);
+    dispatch({
+      type: 'SET',
+      payload: {
+        message: msg,
+        messageColor: color
+      }
+    });
+    if (msg) {
+      messageTimerRef.current = setTimeout(function () {
+        return dispatch({
+          type: 'SET',
+          payload: {
+            message: ''
+          }
+        });
+      }, ms);
+    }
+  }
+  useEffect(function () {
+    return function () {
+      return clearTimeout(messageTimerRef.current);
+    };
+  }, []);
+
+  /**
+   * Updates the image name input and recalculates autocomplete suggestions.
+   * Resets selectedSuggestionIndex to -1 on every keystroke.
+   * Also aborts any in-flight Hub search and clears Hub results.
+   *
+   * @param {string} value - New raw image name typed by user
+   */
+  function updateImageInput(value) {
+    var _activeHubRequestRef$;
+    // Abort any in-flight Hub search and clear its state
+    (_activeHubRequestRef$ = activeHubRequestRef.current.controller) === null || _activeHubRequestRef$ === void 0 || _activeHubRequestRef$.abort();
+    activeHubRequestRef.current.requestId += 1;
+    setIsSearchingHub(false);
+    setHubResults(null);
+    var lower = value.toLowerCase();
+    var matches = value.trim() ? Object.keys(imageProfiles).filter(function (key) {
+      return key.includes(lower);
+    }) : [];
+    dispatch({
+      type: 'SET',
+      payload: {
+        imageName: value,
+        selectedSuggestionIndex: -1,
+        visibleOffset: 0,
+        suggestions: matches
+      }
+    });
+  }
+
+  /**
+   * Triggers a Docker Hub search for the current imageName.
+   * Guards: imageName must be non-empty; no concurrent search allowed.
+   * Uses AbortController + requestId to handle race conditions.
+   */
+  function triggerHubSearch() {
+    return _triggerHubSearch.apply(this, arguments);
+  }
+  /**
+   * Moves the suggestion selection up (-1) or down (+1).
+   * Clamps index to [-1, suggestions.length - 1].
+   * Adjusts visibleOffset to keep selected item in the visible window.
+   *
+   * @param {number} direction - -1 (up) or 1 (down)
+   */
+  function _triggerHubSearch() {
+    _triggerHubSearch = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+      var _activeHubRequestRef$2;
+      var query, requestId, controller, results, _t;
+      return _regenerator().w(function (_context) {
+        while (1) switch (_context.p = _context.n) {
+          case 0:
+            query = imageName.trim();
+            if (query) {
+              _context.n = 1;
+              break;
+            }
+            return _context.a(2);
+          case 1:
+            if (!isSearchingHub) {
+              _context.n = 2;
+              break;
+            }
+            return _context.a(2);
+          case 2:
+            // Abort previous request (should already be aborted from updateImageInput,
+            // but guard here too)
+            (_activeHubRequestRef$2 = activeHubRequestRef.current.controller) === null || _activeHubRequestRef$2 === void 0 || _activeHubRequestRef$2.abort();
+            requestId = activeHubRequestRef.current.requestId + 1;
+            activeHubRequestRef.current.requestId = requestId;
+            controller = new AbortController();
+            activeHubRequestRef.current.controller = controller;
+            setIsSearchingHub(true);
+            dispatch({
+              type: 'SET',
+              payload: {
+                selectedSuggestionIndex: -1,
+                visibleOffset: 0
+              }
+            });
+            _context.p = 3;
+            _context.n = 4;
+            return searchDockerHub(query, {
+              signal: controller.signal
+            });
+          case 4:
+            results = _context.v;
+            if (!(activeHubRequestRef.current.requestId !== requestId)) {
+              _context.n = 5;
+              break;
+            }
+            return _context.a(2);
+          case 5:
+            setHubResults(results.map(formatHubResult));
+            _context.n = 8;
+            break;
+          case 6:
+            _context.p = 6;
+            _t = _context.v;
+            if (!(activeHubRequestRef.current.requestId !== requestId)) {
+              _context.n = 7;
+              break;
+            }
+            return _context.a(2);
+          case 7:
+            // Silence AbortError; for all other errors fall back to static suggestions
+            setHubResults(null);
+          case 8:
+            _context.p = 8;
+            if (activeHubRequestRef.current.requestId === requestId) {
+              setIsSearchingHub(false);
+            }
+            return _context.f(8);
+          case 9:
+            return _context.a(2);
+        }
+      }, _callee, null, [[3, 6, 8, 9]]);
+    }));
+    return _triggerHubSearch.apply(this, arguments);
+  }
+  function moveSuggestionSelection(direction) {
+    var next = Math.max(-1, Math.min(suggestions.length - 1, selectedSuggestionIndex + direction));
+    var newOffset = visibleOffset;
+    if (next < visibleOffset) newOffset = Math.max(0, next);else if (next >= visibleOffset + MAX_VISIBLE) newOffset = next - MAX_VISIBLE + 1;
+    dispatch({
+      type: 'SET',
+      payload: {
+        selectedSuggestionIndex: next,
+        visibleOffset: newOffset
+      }
+    });
+  }
+
+  /**
+   * Applies the currently focused suggestion to imageName.
+   * Does NOT advance the step. Clears suggestions after applying.
+   */
+  function applyFocusedSuggestion() {
+    if (selectedSuggestionIndex < 0 || selectedSuggestionIndex >= suggestions.length) return;
+    var chosen = suggestions[selectedSuggestionIndex];
+    dispatch({
+      type: 'SET',
+      payload: {
+        imageName: resolveImageTag(chosen, imageProfiles),
+        suggestions: [],
+        selectedSuggestionIndex: -1,
+        visibleOffset: 0
+      }
+    });
+  }
 
   /**
    * Advances to the next step, with validation and feedback.
@@ -58,42 +384,67 @@ export function useContainerCreation(_ref) {
   function nextStep() {
     if (step === 0) {
       if (!imageName.trim()) {
-        setMessage("Image name cannot be empty.");
-        setMessageColor("red");
+        setTimedMessage('Image name cannot be empty.', 'red');
         return;
       }
-      setStep(1);
-      setMessage("Optional: Enter container name or leave empty and press Enter");
-      setMessageColor("yellow");
+      var resolved = resolveImageTag(imageName, imageProfiles);
+      dispatch({
+        type: 'SET',
+        payload: {
+          imageName: resolved,
+          step: 1
+        }
+      });
+      setTimedMessage('Optional: Enter container name or leave empty and press Enter', 'yellow');
       return;
     }
     if (step === 1) {
-      setStep(2);
-      setMessage("Optional: Enter ports (format 8080:80,443:443) or leave empty and press Enter");
-      setMessageColor("yellow");
+      dispatch({
+        type: 'SET',
+        payload: {
+          step: 2
+        }
+      });
+      setTimedMessage('Optional: Enter ports (format 8080:80,443:443) or leave empty and press Enter', 'yellow');
       return;
     }
     if (step === 2) {
       // Ports are now optional - only validate if provided
       if (portInput.trim() && !validatePorts(portInput)) {
-        setMessage("Port format must be host:container and both must be numbers (e.g. 8080:80)");
-        setMessageColor("red");
+        setTimedMessage('Port format must be host:container and both must be numbers (e.g. 8080:80)', 'red');
         return;
       }
-      setStep(3);
+      dispatch({
+        type: 'SET',
+        payload: {
+          step: 3
+        }
+      });
       var isDb = dbImages.some(function (db) {
         return imageName.trim().toLowerCase().includes(db);
       });
-      if (isDb) {
-        setMessage("Warning: This image usually requires environment variables (e.g. MYSQL_ROOT_PASSWORD=my-secret-pw for MySQL, POSTGRES_PASSWORD=yourpassword for Postgres). Enter them as VAR=val,VAR2=val2 or leave empty and press Enter.");
-        setMessageColor("yellow");
+      // Check if the image has a profile with required env vars
+      var _baseName = imageName.trim().toLowerCase().split(':')[0].split('/').pop();
+      var profile = imageProfiles[_baseName];
+      if (profile && profile.requiredEnv && profile.requiredEnv.length) {
+        var suggestedPart = profile.suggestedEnv && profile.suggestedEnv.length ? " | Suggested: ".concat(profile.suggestedEnv.join(', ')) : '';
+        setTimedMessage("Required env vars for ".concat(_baseName, ": ").concat(profile.requiredEnv.join(', '), ". Enter as VAR=val,VAR2=val2").concat(suggestedPart), 'yellow');
+      } else if (profile && profile.suggestedEnv && profile.suggestedEnv.length) {
+        setTimedMessage("Suggested env vars for ".concat(_baseName, ": ").concat(profile.suggestedEnv.join(', '), ". Enter as VAR=val,VAR2=val2 or leave empty."), 'yellow');
+      } else if (isDb) {
+        setTimedMessage('Warning: This image usually requires environment variables (e.g. MYSQL_ROOT_PASSWORD=my-secret-pw for MySQL, POSTGRES_PASSWORD=yourpassword for Postgres). Enter them as VAR=val,VAR2=val2 or leave empty and press Enter.', 'yellow');
       } else {
-        setMessage("Optional: Enter environment variables (format VAR1=val1,VAR2=val2) or leave empty and press Enter");
-        setMessageColor("yellow");
+        setTimedMessage('Optional: Enter environment variables (format VAR1=val1,VAR2=val2) or leave empty and press Enter', 'yellow');
       }
       return;
     }
     if (step === 3) {
+      // Contextual env validation using image profiles
+      var result = validateEnvVars(envInput, imageName, imageProfiles);
+      if (!result.valid) {
+        setTimedMessage(result.errors.join(' | '), 'red');
+        return;
+      }
       // Final step: call onCreate with all data (safely)
       safeCall(onCreate, {
         imageName: imageName,
@@ -108,13 +459,9 @@ export function useContainerCreation(_ref) {
    * Cancels the creation process and resets state.
    */
   function cancelCreation() {
-    setStep(0);
-    setImageName("");
-    setContainerName("");
-    setPortInput("");
-    setEnvInput("");
-    setMessage("");
-    setMessageColor("yellow");
+    dispatch({
+      type: 'RESET'
+    });
     safeCall(onCancel);
   }
 
@@ -123,14 +470,46 @@ export function useContainerCreation(_ref) {
    * 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");
+    dispatch({
+      type: 'RESET_WIZARD'
+    });
+  }
+
+  /**
+   * Inserts the next pending suggested env var into envInput.
+   * Derives "next" by comparing keys already in envInput against suggestedEnv.
+   * When all suggestions are already present, sets a feedback message.
+   */
+  function insertNextSuggestedEnv() {
+    var _profile$suggestedEnv;
+    var baseName = imageName.trim().toLowerCase().split(':')[0].split('/').pop();
+    var profile = imageProfiles[baseName];
+    var suggested = (_profile$suggestedEnv = profile === null || profile === void 0 ? void 0 : profile.suggestedEnv) !== null && _profile$suggestedEnv !== void 0 ? _profile$suggestedEnv : [];
+    if (!suggested.length) return;
+    var addedKeys = envInput.split(',').map(function (s) {
+      return s.split('=')[0].trim();
+    }).filter(Boolean);
+    var next = suggested.find(function (s) {
+      return !addedKeys.includes(s.split('=')[0]);
+    });
+    if (!next) {
+      setTimedMessage('All suggested env vars added', 'yellow');
+      return;
+    }
+    var newEnvInput = envInput ? "".concat(envInput, ",").concat(next) : next;
+    dispatch({
+      type: 'SET',
+      payload: {
+        envInput: newEnvInput
+      }
+    });
   }
+
+  /**
+   * True when the current image profile has at least one suggestedEnv entry.
+   */
+  var baseName = imageName.trim().toLowerCase().split(':')[0].split('/').pop();
+  var hasSuggestedEnv = ((_imageProfiles$baseNa = (_imageProfiles$baseNa2 = imageProfiles[baseName]) === null || _imageProfiles$baseNa2 === void 0 || (_imageProfiles$baseNa2 = _imageProfiles$baseNa2.suggestedEnv) === null || _imageProfiles$baseNa2 === void 0 ? void 0 : _imageProfiles$baseNa2.length) !== null && _imageProfiles$baseNa !== void 0 ? _imageProfiles$baseNa : 0) > 0;
   return {
     step: step,
     setStep: setStep,
@@ -146,8 +525,19 @@ export function useContainerCreation(_ref) {
     setMessage: setMessage,
     messageColor: messageColor,
     setMessageColor: setMessageColor,
+    suggestions: suggestions,
+    selectedSuggestionIndex: selectedSuggestionIndex,
+    visibleOffset: visibleOffset,
+    isSearchingHub: isSearchingHub,
+    hubResults: hubResults,
+    updateImageInput: updateImageInput,
+    triggerHubSearch: triggerHubSearch,
+    moveSuggestionSelection: moveSuggestionSelection,
+    applyFocusedSuggestion: applyFocusedSuggestion,
     nextStep: nextStep,
     cancelCreation: cancelCreation,
-    resetCreation: resetCreation
+    resetCreation: resetCreation,
+    insertNextSuggestedEnv: insertNextSuggestedEnv,
+    hasSuggestedEnv: hasSuggestedEnv
   };
 }

package/dist/hooks/creation/useLogsViewer.js

@@ -4,8 +4,8 @@ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r)
 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, useRef } from "react";
-import { safeCall } from "../../helpers/safeCall.js";
+import { useState, useRef } from 'react';
+import { safeCall } from '../../helpers/safeCall.js';
 
 /**
  * Custom hook to manage the logs viewer state and stream reference.

package/dist/hooks/debug/useDebugLogs.js

@@ -23,15 +23,15 @@ export function useDebugLogs() {
     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);
+          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]";
+            return '[unserializable]';
           }
         }).filter(Boolean);
-        var line = extras.length ? "".concat(entry.formatted, " ").concat(extras.join(" ")) : entry.formatted;
+        var line = extras.length ? "".concat(entry.formatted, " ").concat(extras.join(' ')) : entry.formatted;
         var next = [].concat(_toConsumableArray(prev), [line]);
         return next.slice(-200);
       });