feat: Implement basic general folder support (#2051)

- Related: #1748

tests/card-controller/actions/actions-manager.test.ts

@@ -80,7 +80,7 @@ describe('ActionsManager', () => {
       expect(manager.getMergedActions()).toEqual({});
     });
 
-    describe('should get merged actions with live view', () => {
+    describe('should get merged actions with view', () => {
       it.each([
         [
           'live' as const,
@@ -100,6 +100,16 @@ describe('ActionsManager', () => {
             },
           },
         ],
+        [
+          'folder' as const,
+          {
+            tap_action: {
+              action: 'navigate',
+              // Folder also uses the media gallery.
+              navigation_path: '3',
+            },
+          },
+        ],
         [
           'clip' as const,
           {
@@ -313,6 +323,7 @@ describe('ActionsManager', () => {
 
     describe('should forward haptics', () => {
       afterEach(() => {
+        vi.restoreAllMocks();
         vi.unstubAllGlobals();
       });
 
@@ -329,6 +340,8 @@ describe('ActionsManager', () => {
       });
 
       it('should forward warning haptic', async () => {
+        vi.spyOn(global.console, 'warn').mockReturnValue(undefined);
+
         const handler = vi.fn();
         window.addEventListener('haptic', handler);
 

tests/card-controller/actions/actions/download.test.ts

@@ -1,9 +1,17 @@
-import { expect, it } from 'vitest';
+import { expect, it, vi } from 'vitest';
 import { DownloadAction } from '../../../../src/card-controller/actions/actions/download';
-import { createCardAPI } from '../../../test-utils';
+import { QueryResults } from '../../../../src/view/query-results';
+import { createCardAPI, createView, TestViewMedia } from '../../../test-utils';
 
-it('should handle download action', async () => {
+it('should handle download action with selected media', async () => {
   const api = createCardAPI();
+  const selectedMedia = new TestViewMedia();
+  vi.mocked(api.getViewManager().getView).mockReturnValue(
+    createView({
+      queryResults: new QueryResults({ results: [selectedMedia], selectedIndex: 0 }),
+    }),
+  );
+
   const action = new DownloadAction(
     {},
     {
@@ -14,5 +22,22 @@ it('should handle download action', async () => {
 
   await action.execute(api);
 
-  expect(api.getDownloadManager().downloadViewerMedia).toBeCalled();
+  expect(api.getViewItemManager().download).toBeCalledWith(selectedMedia);
+});
+
+it('should handle download action without selected media', async () => {
+  const api = createCardAPI();
+  vi.mocked(api.getViewManager().getView).mockReturnValue(createView());
+
+  const action = new DownloadAction(
+    {},
+    {
+      action: 'fire-dom-event',
+      advanced_camera_card_action: 'download',
+    },
+  );
+
+  await action.execute(api);
+
+  expect(api.getViewItemManager().download).not.toBeCalled();
 });

tests/card-controller/actions/actions/folder.test.ts

@@ -0,0 +1,86 @@
+import { describe, expect, it, vi } from 'vitest';
+import { FolderAction } from '../../../../src/card-controller/actions/actions/folder';
+import { FolderQuery } from '../../../../src/card-controller/folders/types';
+import { FolderViewQuery } from '../../../../src/view/query';
+import { createCardAPI, createFolder } from '../../../test-utils';
+
+describe('should handle folder action', async () => {
+  it('should handle folder action successfully', async () => {
+    const api = createCardAPI();
+    const action = new FolderAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'folder',
+      },
+    );
+
+    const folder = createFolder();
+    vi.mocked(api.getFoldersManager().getFolder).mockReturnValue(folder);
+
+    const query: FolderQuery = {
+      folder,
+      path: ['path'],
+    };
+    vi.mocked(api.getFoldersManager().generateDefaultFolderQuery).mockReturnValue(query);
+
+    await action.execute(api);
+
+    expect(
+      api.getViewManager().setViewByParametersWithExistingQuery,
+    ).toHaveBeenCalledWith({
+      params: {
+        view: 'folder',
+        query: expect.any(FolderViewQuery),
+      },
+    });
+
+    expect(
+      vi
+        .mocked(api.getViewManager().setViewByParametersWithExistingQuery)
+        .mock.calls[0][0]?.params?.query?.getQuery(),
+    ).toBe(query);
+  });
+
+  it('should do nothing with non-existent folder', async () => {
+    const api = createCardAPI();
+    const action = new FolderAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'folder',
+        folder: 'NON-EXISTENT-FOLDER',
+      },
+    );
+
+    vi.mocked(api.getFoldersManager().getFolder).mockReturnValue(null);
+
+    await action.execute(api);
+
+    expect(
+      api.getViewManager().setViewByParametersWithExistingQuery,
+    ).not.toHaveBeenCalled();
+  });
+
+  it('should do nothing with non-existent default query', async () => {
+    const api = createCardAPI();
+    const action = new FolderAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'folder',
+      },
+    );
+
+    const folder = createFolder();
+    vi.mocked(api.getFoldersManager().getFolder).mockReturnValue(folder);
+
+    vi.mocked(api.getFoldersManager().generateDefaultFolderQuery).mockReturnValue(null);
+
+    await action.execute(api);
+
+    expect(
+      api.getViewManager().setViewByParametersWithExistingQuery,
+    ).not.toHaveBeenCalled();
+  });
+});

tests/card-controller/actions/actions/screenshot.test.ts

@@ -1,18 +1,62 @@
-import { expect, it } from 'vitest';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { mock } from 'vitest-mock-extended';
 import { ScreenshotAction } from '../../../../src/card-controller/actions/actions/screenshot';
-import { createCardAPI } from '../../../test-utils';
+import { MediaPlayerController } from '../../../../src/types';
+import { downloadURL } from '../../../../src/utils/download';
+import { createCardAPI, createMediaLoadedInfo } from '../../../test-utils';
 
-it('should handle screenshot action', async () => {
-  const api = createCardAPI();
-  const action = new ScreenshotAction(
-    {},
-    {
-      action: 'fire-dom-event',
-      advanced_camera_card_action: 'screenshot',
-    },
-  );
+vi.mock('../../../../src/utils/download');
 
-  await action.execute(api);
+describe('should handle screenshot action', async () => {
+  afterEach(() => {
+    vi.clearAllMocks();
+  });
 
-  expect(api.getDownloadManager().downloadScreenshot).toBeCalled();
+  it('should handle screenshot action with screenshot URL', async () => {
+    const api = createCardAPI();
+    const action = new ScreenshotAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'screenshot',
+      },
+    );
+
+    const mediaPlayerController = mock<MediaPlayerController>();
+    mediaPlayerController.getScreenshotURL.mockResolvedValue('screenshot-url');
+
+    vi.mocked(api.getMediaLoadedInfoManager().get).mockReturnValue(
+      createMediaLoadedInfo({
+        mediaPlayerController,
+      }),
+    );
+
+    await action.execute(api);
+
+    expect(downloadURL).toBeCalledWith('screenshot-url', 'screenshot.jpg');
+  });
+
+  it('should handle screenshot action without screenshot URL', async () => {
+    const api = createCardAPI();
+    const action = new ScreenshotAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'screenshot',
+      },
+    );
+
+    const mediaPlayerController = mock<MediaPlayerController>();
+    mediaPlayerController.getScreenshotURL.mockResolvedValue(null);
+
+    vi.mocked(api.getMediaLoadedInfoManager().get).mockReturnValue(
+      createMediaLoadedInfo({
+        mediaPlayerController,
+      }),
+    );
+
+    await action.execute(api);
+
+    expect(downloadURL).not.toBeCalled();
+  });
 });

tests/card-controller/actions/actions/sleep.test.ts

@@ -1,13 +1,9 @@
-import { afterAll, expect, it, vi } from 'vitest';
-import { createCardAPI } from '../../../test-utils';
+import { expect, it, vi } from 'vitest';
 import { SleepAction } from '../../../../src/card-controller/actions/actions/sleep';
-import { sleep } from '../../../../src/utils/basic';
+import { sleep } from '../../../../src/utils/sleep';
+import { createCardAPI } from '../../../test-utils';
 
-vi.mock('../../../../src/utils/basic');
-
-afterAll(() => {
-  vi.restoreAllMocks();
-});
+vi.mock('../../../../src/utils/sleep');
 
 it('should handle sleep action', async () => {
   const api = createCardAPI();

tests/card-controller/actions/factory.test.ts

@@ -7,6 +7,7 @@ import { DefaultAction } from '../../../src/card-controller/actions/actions/defa
 import { DisplayModeSelectAction } from '../../../src/card-controller/actions/actions/display-mode-select';
 import { DownloadAction } from '../../../src/card-controller/actions/actions/download';
 import { ExpandAction } from '../../../src/card-controller/actions/actions/expand';
+import { FolderAction } from '../../../src/card-controller/actions/actions/folder';
 import { FullscreenAction } from '../../../src/card-controller/actions/actions/fullscreen';
 import { InternalCallbackAction } from '../../../src/card-controller/actions/actions/internal-callback';
 import { LogAction } from '../../../src/card-controller/actions/actions/log';
@@ -184,6 +185,7 @@ describe('ActionFactory', () => {
         },
         InternalCallbackAction,
       ],
+      [{ advanced_camera_card_action: 'folder' as const }, FolderAction],
     ])(
       'advanced_camera_card_action: $advanced_camera_card_action',
       (action: Partial<ActionConfig>, classObject: object) => {