cdd-cli 3.2.0 → 4.0.0

package/test/ContainerCreationPrompt.dom.test.js

@@ -0,0 +1,313 @@
+/**
+ * @jest-environment jsdom
+ */
+import React from 'react';
+import { render } from '@testing-library/react';
+import { ContainerCreationPrompt } from '../src/components/ContainerCreationPrompt.jsx';
+
+describe('ContainerCreationPrompt — SuggestionPanel wiring', () => {
+  test('does NOT render SuggestionPanel when step > 0', () => {
+    const { queryByText } = render(
+      <ContainerCreationPrompt
+        step={1}
+        imageName="nginx"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx', 'node']}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    // On step 1, the imageName field is not active — no suggestion panel
+    expect(queryByText(/^nginx$/)).toBeNull();
+  });
+
+  test('does NOT render SuggestionPanel on step 0 when suggestions is empty', () => {
+    const { queryByTestId } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    // No suggestion panel should render when suggestions array is empty
+    expect(queryByTestId('suggestion-panel')).toBeNull();
+  });
+
+  test('renders SuggestionPanel items on step 0 when suggestions exist', () => {
+    const { getAllByText, getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx', 'golang']}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    // golang is not in any label — appears only in suggestion panel
+    expect(getByText(/golang/)).toBeTruthy();
+    // nginx appears in suggestion panel (may also appear in label text, but it does appear)
+    const nginxEls = getAllByText(/nginx/);
+    expect(nginxEls.length).toBeGreaterThan(0);
+  });
+
+  // FR8 — hubResults wiring
+  test('when hubResults is provided, activeItems = hubResults (replaces suggestions)', () => {
+    const { getByText, queryByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx', 'golang']}
+        hubResults={['hub-nginx', 'hub-node']}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText(/hub-nginx/)).toBeTruthy();
+    expect(queryByText(/golang/)).toBeNull();
+  });
+
+  test('when hubResults is null, falls back to suggestions', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx', 'golang']}
+        hubResults={null}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText(/golang/)).toBeTruthy();
+  });
+
+  test('when step===0 and isSearchingHub=true, SuggestionPanel is shown even if activeItems is empty', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        hubResults={null}
+        isSearchingHub={true}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText(/searching Docker Hub/)).toBeTruthy();
+  });
+
+  test('when step===0 and isSearchingHub=false and activeItems is empty, SuggestionPanel is NOT shown', () => {
+    const { queryByTestId } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        hubResults={null}
+        isSearchingHub={false}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(queryByTestId('suggestion-panel')).toBeNull();
+  });
+
+  test('isLoading prop is passed down to SuggestionPanel when isSearchingHub=true', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx']}
+        hubResults={null}
+        isSearchingHub={true}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText(/searching Docker Hub/)).toBeTruthy();
+  });
+});
+
+describe('ContainerCreationPrompt — ControlsHUD wiring', () => {
+  test('step=0, no suggestions: renders ControlsHUD with [Tab] and Search Hub', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName=""
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        hubResults={null}
+        isSearchingHub={false}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText('[Tab]')).toBeTruthy();
+    expect(getByText(/Search Hub/)).toBeTruthy();
+  });
+
+  test('does NOT render old static text "Press Enter to continue, Escape to cancel"', () => {
+    const { queryByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName=""
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        hubResults={null}
+        isSearchingHub={false}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(queryByText(/Press Enter to continue, Escape to cancel/)).toBeNull();
+  });
+
+  test('step=0, hasSuggestions=true: renders [↑↓] not [Tab]', () => {
+    const { getByText, queryByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={['nginx', 'golang']}
+        hubResults={null}
+        isSearchingHub={false}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText('[↑↓]')).toBeTruthy();
+    expect(queryByText('[Tab]')).toBeNull();
+  });
+
+  test('step=0, isSearchingHub=true, no suggestions: ControlsHUD does NOT render [Tab] or Navigate, DOES render [Enter] and [Esc]', () => {
+    const { queryByText, getByText } = render(
+      <ContainerCreationPrompt
+        step={0}
+        imageName="ng"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        hubResults={null}
+        isSearchingHub={true}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(queryByText('[Tab]')).toBeNull();
+    expect(queryByText(/Navigate/)).toBeNull();
+    expect(getByText('[Enter]')).toBeTruthy();
+    expect(getByText('[Esc]')).toBeTruthy();
+  });
+
+  test('step=1: renders [Enter] and [Esc]', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={1}
+        imageName="nginx"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+      />
+    );
+    expect(getByText('[Enter]')).toBeTruthy();
+    expect(getByText('[Esc]')).toBeTruthy();
+  });
+
+  test('step=3, hasSuggestedEnv=true: renders [Tab] in HUD', () => {
+    const { getByText } = render(
+      <ContainerCreationPrompt
+        step={3}
+        imageName="postgres:17-alpine"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+        hasSuggestedEnv={true}
+      />
+    );
+    expect(getByText('[Tab]')).toBeTruthy();
+    expect(getByText(/Insert next env/)).toBeTruthy();
+  });
+
+  test('step=3, hasSuggestedEnv=false: does NOT render [Tab] in HUD', () => {
+    const { queryByText } = render(
+      <ContainerCreationPrompt
+        step={3}
+        imageName="nginx:1.27-alpine"
+        containerName=""
+        portInput=""
+        envInput=""
+        message=""
+        messageColor="yellow"
+        suggestions={[]}
+        selectedSuggestionIndex={-1}
+        visibleOffset={0}
+        hasSuggestedEnv={false}
+      />
+    );
+    expect(queryByText('[Tab]')).toBeNull();
+  });
+});

package/test/ControlsHUD.dom.test.js

@@ -0,0 +1,125 @@
+/**
+ * @jest-environment jsdom
+ */
+import React from 'react';
+import { render } from '@testing-library/react';
+import { getHints, ControlsHUD } from '../src/components/ControlsHUD.jsx';
+
+describe('getHints — pure function', () => {
+  test('step=0, no suggestions, not searching: includes Tab=Search Hub', () => {
+    const hints = getHints(0, false, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Tab');
+    const tabHint = hints.find(h => h.key === 'Tab');
+    expect(tabHint.label).toBe('Search Hub');
+  });
+
+  test('step=0, hasSuggestions=true: includes ↑↓ Navigate, does NOT include Tab', () => {
+    const hints = getHints(0, true, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('↑↓');
+    expect(keys).not.toContain('Tab');
+    const navHint = hints.find(h => h.key === '↑↓');
+    expect(navHint.label).toBe('Navigate');
+  });
+
+  test('step=0, isSearchingHub=true: does NOT include Tab, includes Enter and Esc', () => {
+    const hints = getHints(0, false, true);
+    const keys = hints.map(h => h.key);
+    expect(keys).not.toContain('Tab');
+    expect(keys).toContain('Enter');
+    expect(keys).toContain('Esc');
+  });
+
+  test('step=1: includes Enter=Continue and Esc=Cancel, no Tab, no ↑↓', () => {
+    const hints = getHints(1, false, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Enter');
+    expect(keys).toContain('Esc');
+    expect(keys).not.toContain('Tab');
+    expect(keys).not.toContain('↑↓');
+    const enterHint = hints.find(h => h.key === 'Enter');
+    expect(enterHint.label).toBe('Continue');
+  });
+
+  test('step=2: same as step=1', () => {
+    const hints = getHints(2, false, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Enter');
+    expect(keys).toContain('Esc');
+    expect(keys).not.toContain('Tab');
+    expect(keys).not.toContain('↑↓');
+  });
+
+  test('step=3: same as step=1', () => {
+    const hints = getHints(3, false, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Enter');
+    expect(keys).toContain('Esc');
+    expect(keys).not.toContain('Tab');
+    expect(keys).not.toContain('↑↓');
+  });
+
+  test('getHints(3, false, false, true) includes Tab=Insert next env', () => {
+    const hints = getHints(3, false, false, true);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Tab');
+    const tabHint = hints.find(h => h.key === 'Tab');
+    expect(tabHint.label).toBe('Insert next env');
+  });
+
+  test('getHints(3, false, false, false) does NOT include Tab hint', () => {
+    const hints = getHints(3, false, false, false);
+    const keys = hints.map(h => h.key);
+    expect(keys).not.toContain('Tab');
+  });
+
+  test('getHints(3, false, false, true) also includes Enter and Esc', () => {
+    const hints = getHints(3, false, false, true);
+    const keys = hints.map(h => h.key);
+    expect(keys).toContain('Enter');
+    expect(keys).toContain('Esc');
+  });
+});
+
+describe('ControlsHUD — component rendering', () => {
+  test('step=0, no suggestions: renders [Tab] and "Search Hub" text', () => {
+    const { getByText } = render(
+      <ControlsHUD step={0} hasSuggestions={false} isSearchingHub={false} />
+    );
+    expect(getByText('[Tab]')).toBeTruthy();
+    expect(getByText(/Search Hub/)).toBeTruthy();
+  });
+
+  test('step=0, hasSuggestions=true: renders [↑↓], does NOT render [Tab]', () => {
+    const { getByText, queryByText } = render(
+      <ControlsHUD step={0} hasSuggestions={true} isSearchingHub={false} />
+    );
+    expect(getByText('[↑↓]')).toBeTruthy();
+    expect(queryByText('[Tab]')).toBeNull();
+  });
+
+  test('step=1: renders [Enter] and [Esc], does NOT render [Tab]', () => {
+    const { getByText, queryByText } = render(
+      <ControlsHUD step={1} hasSuggestions={false} isSearchingHub={false} />
+    );
+    expect(getByText('[Enter]')).toBeTruthy();
+    expect(getByText('[Esc]')).toBeTruthy();
+    expect(queryByText('[Tab]')).toBeNull();
+  });
+
+  test('step=3, hasSuggestedEnv=true: renders [Tab] and "Insert next env"', () => {
+    const { getByText } = render(
+      <ControlsHUD step={3} hasSuggestions={false} isSearchingHub={false} hasSuggestedEnv={true} />
+    );
+    expect(getByText('[Tab]')).toBeTruthy();
+    expect(getByText(/Insert next env/)).toBeTruthy();
+  });
+
+  test('step=3, hasSuggestedEnv=false: does NOT render [Tab]', () => {
+    const { queryByText } = render(
+      <ControlsHUD step={3} hasSuggestions={false} isSearchingHub={false} hasSuggestedEnv={false} />
+    );
+    expect(queryByText('[Tab]')).toBeNull();
+  });
+});

package/test/SuggestionPanel.dom.test.js

@@ -0,0 +1,83 @@
+/**
+ * @jest-environment jsdom
+ */
+import React from 'react';
+import { render } from '@testing-library/react';
+import { SuggestionPanel } from '../src/components/SuggestionPanel.jsx';
+
+describe('SuggestionPanel', () => {
+  const items = ['caddy', 'elasticsearch', 'golang', 'httpd', 'kafka', 'mariadb', 'memcached', 'minio'];
+
+  test('renders nothing when items is empty', () => {
+    const { container } = render(
+      <SuggestionPanel items={[]} selectedIndex={-1} visibleOffset={0} maxVisible={5} />
+    );
+    expect(container.firstChild).toBeNull();
+  });
+
+  test('renders only maxVisible items from visibleOffset', () => {
+    const { getByText, queryByText } = render(
+      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={0} maxVisible={5} />
+    );
+    expect(getByText(/caddy/)).toBeTruthy();
+    expect(getByText(/elasticsearch/)).toBeTruthy();
+    expect(getByText(/kafka/)).toBeTruthy();
+    expect(queryByText(/mariadb/)).toBeNull();
+  });
+
+  test('respects visibleOffset by skipping early items', () => {
+    const { queryByText, getByText } = render(
+      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={2} maxVisible={3} />
+    );
+    expect(getByText(/golang/)).toBeTruthy();
+    expect(getByText(/httpd/)).toBeTruthy();
+    expect(getByText(/kafka/)).toBeTruthy();
+    expect(queryByText(/caddy/)).toBeNull();
+  });
+
+  test('focused row has › prefix marker', () => {
+    const { getByText } = render(
+      <SuggestionPanel items={items} selectedIndex={1} visibleOffset={0} maxVisible={5} />
+    );
+    const el = getByText(/› elasticsearch/);
+    expect(el).toBeTruthy();
+  });
+
+  test('non-focused rows do NOT have › prefix', () => {
+    const { getByText } = render(
+      <SuggestionPanel items={items} selectedIndex={1} visibleOffset={0} maxVisible={5} />
+    );
+    const el = getByText(/caddy/);
+    expect(el.textContent).not.toMatch(/›/);
+  });
+
+  // FR8 — isLoading prop
+  test('renders [searching Docker Hub...] row when isLoading=true', () => {
+    const { getByText } = render(
+      <SuggestionPanel items={[]} selectedIndex={-1} visibleOffset={0} isLoading={true} />
+    );
+    expect(getByText(/searching Docker Hub/)).toBeTruthy();
+  });
+
+  test('loading row is NOT selectable — no › prefix on loading row', () => {
+    const { getByText } = render(
+      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={0} maxVisible={5} isLoading={true} />
+    );
+    const loadingEl = getByText(/searching Docker Hub/);
+    expect(loadingEl.textContent).not.toMatch(/›/);
+  });
+
+  test('does NOT render loading row when isLoading=false', () => {
+    const { queryByText } = render(
+      <SuggestionPanel items={items} selectedIndex={-1} visibleOffset={0} maxVisible={5} isLoading={false} />
+    );
+    expect(queryByText(/searching Docker Hub/)).toBeNull();
+  });
+
+  test('renders panel even when items is empty but isLoading=true', () => {
+    const { getByText } = render(
+      <SuggestionPanel items={[]} selectedIndex={-1} visibleOffset={0} isLoading={true} />
+    );
+    expect(getByText(/searching Docker Hub/)).toBeTruthy();
+  });
+});

package/test/constants.test.js

@@ -0,0 +1,41 @@
+/**
+ * @jest-environment node
+ */
+import { IMAGE_PROFILES } from '../src/helpers/constants.js';
+
+describe('IMAGE_PROFILES', () => {
+  test('has ~20 entries', () => {
+    const count = Object.keys(IMAGE_PROFILES).length;
+    expect(count).toBeGreaterThanOrEqual(20);
+  });
+
+  test('every entry has requiredEnv (array), defaultPort (string), and suggestedEnv (array)', () => {
+    for (const [key, profile] of Object.entries(IMAGE_PROFILES)) {
+      expect(Array.isArray(profile.requiredEnv)).toBe(true);
+      expect(typeof profile.defaultPort).toBe('string');
+      expect(Array.isArray(profile.suggestedEnv)).toBe(true);
+    }
+  });
+
+  test('postgres has POSTGRES_PASSWORD in requiredEnv and suggestedEnv hints', () => {
+    expect(IMAGE_PROFILES.postgres.requiredEnv).toContain('POSTGRES_PASSWORD');
+    expect(IMAGE_PROFILES.postgres.suggestedEnv.length).toBeGreaterThan(0);
+  });
+
+  test('nginx has empty requiredEnv, defaultPort 80, and empty suggestedEnv', () => {
+    expect(IMAGE_PROFILES.nginx.requiredEnv).toEqual([]);
+    expect(IMAGE_PROFILES.nginx.defaultPort).toBe('80');
+    expect(IMAGE_PROFILES.nginx.suggestedEnv).toEqual([]);
+  });
+
+  test('node has suggestedEnv with NODE_ENV hint', () => {
+    expect(IMAGE_PROFILES.node.suggestedEnv).toContain('NODE_ENV=production');
+  });
+
+  test('every entry has defaultTag as a non-empty string', () => {
+    for (const [key, profile] of Object.entries(IMAGE_PROFILES)) {
+      expect(typeof profile.defaultTag).toBe('string');
+      expect(profile.defaultTag.length).toBeGreaterThan(0);
+    }
+  });
+});