feat: Implement support for gesture-based PTZ control (#2378)

- Closes: #1839
2026-02-28 20:36:53 -08:00
parent 40ad3b4460
commit ea86ad0016
32 changed files with 1714 additions and 126 deletions
@@ -1,21 +1,106 @@
-import { expect, it } from 'vitest';
-import { createCardAPI } from '../../../test-utils';
+import { describe, expect, it, vi } from 'vitest';
+import { mock } from 'vitest-mock-extended';
 import { PTZControlsAction } from '../../../../src/card-controller/actions/actions/ptz-controls';
+import { View } from '../../../../src/view/view';
+import { createCardAPI } from '../../../test-utils';

-it('should handle ptz_controls action', async () => {
-  const api = createCardAPI();
-  const action = new PTZControlsAction(
-    {},
-    {
-      action: 'fire-dom-event',
-      advanced_camera_card_action: 'ptz_controls',
-      enabled: true,
-    },
-  );
+describe('PTZControlsAction', () => {
+  it('should set enabled explicitly', async () => {
+    const api = createCardAPI();
+    const action = new PTZControlsAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'ptz_controls',
+        enabled: true,
+        type: 'buttons',
+      },
+    );

-  await action.execute(api);
+    await action.execute(api);

-  expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith(
-    expect.objectContaining({ ptzControls: { enabled: true } }),
-  );
+    expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith({
+      ptzControls: { enabled: true, type: 'buttons' },
+    });
+  });
+
+  it('should toggle enabled when not specified', async () => {
+    const api = createCardAPI();
+    const view = mock<View>();
+    view.context = { ptzControls: { enabled: true } };
+    vi.mocked(api.getViewManager().getView).mockReturnValue(view);
+
+    const action = new PTZControlsAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'ptz_controls',
+      },
+    );
+
+    await action.execute(api);
+
+    expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith({
+      ptzControls: { enabled: false },
+    });
+  });
+
+  it('should not set enabled when currently undefined and not specified', async () => {
+    const api = createCardAPI();
+
+    const action = new PTZControlsAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'ptz_controls',
+      },
+    );
+
+    await action.execute(api);
+
+    expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith({
+      ptzControls: {},
+    });
+  });
+
+  it('should set type without affecting enabled when not specified', async () => {
+    const api = createCardAPI();
+
+    const action = new PTZControlsAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'ptz_controls',
+        type: 'gestures',
+      },
+    );
+
+    await action.execute(api);
+
+    expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith({
+      ptzControls: { type: 'gestures' },
+    });
+  });
+
+  it('should set type only leaving enabled unchanged', async () => {
+    const api = createCardAPI();
+    const view = mock<View>();
+    view.context = { ptzControls: { enabled: true } };
+    vi.mocked(api.getViewManager().getView).mockReturnValue(view);
+
+    const action = new PTZControlsAction(
+      {},
+      {
+        action: 'fire-dom-event',
+        advanced_camera_card_action: 'ptz_controls',
+        type: 'buttons',
+      },
+    );
+
+    await action.execute(api);
+
+    expect(api.getViewManager().setViewWithMergedContext).toBeCalledWith({
+      ptzControls: { type: 'buttons' },
+    });
+  });
 });