feat: Add card picker suggestion for camera entities (#2517)

Selecting a camera entity in the dashboard card picker now suggests
Advanced Camera Card under the Community section, so you can add it in
one click without searching for it manually.

Requires Home Assistant 2026.6 or later.

Docs:
https://developers.home-assistant.io/docs/frontend/custom-ui/custom-card#suggesting-your-card-for-an-entity

---------

Co-authored-by: dermotduffy <dermot.duffy@gmail.com>

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

@@ -11,7 +11,13 @@ import type { Automation } from '../../../src/config/schema/automations';
 import type { Trigger } from '../../../src/config/schema/condition-trigger/triggers/types';
 import { advancedCameraCardConfigSchema } from '../../../src/config/schema/types';
 import { createGeneralAction } from '../../../src/utils/action';
-import { createCardAPI, createConfig, flushPromises } from '../../test-utils';
+import {
+  createCardAPI,
+  createConfig,
+  createHASS,
+  createStateEntity,
+  flushPromises,
+} from '../../test-utils';
 
 /**
  * Create a ConfigManager test setup with real AutomationsManager and ConditionStateManager.
@@ -75,6 +81,44 @@ describe('ConfigManager', () => {
     vi.restoreAllMocks();
   });
 
+  describe('getEntitySuggestion', () => {
+    it('should suggest the card for a camera entity', () => {
+      const hass = createHASS({ 'camera.office': createStateEntity() });
+      expect(ConfigManager.getEntitySuggestion(hass, 'camera.office')).toEqual({
+        config: {
+          type: 'custom:advanced-camera-card',
+          cameras: [{ camera_entity: 'camera.office' }],
+        },
+      });
+    });
+
+    it('should not suggest the card for a non-camera entity', () => {
+      const hass = createHASS({ 'binary_sensor.motion': createStateEntity() });
+      expect(ConfigManager.getEntitySuggestion(hass, 'binary_sensor.motion')).toBeNull();
+    });
+
+    it('should not suggest the card for an unknown entity', () => {
+      const hass = createHASS({});
+      expect(ConfigManager.getEntitySuggestion(hass, 'camera.office')).toBeNull();
+    });
+  });
+
+  describe('getStubConfig', () => {
+    it('should handle with camera entities', () => {
+      expect(
+        ConfigManager.getStubConfig(['camera.office', 'binary_sensor.motion']),
+      ).toEqual({
+        cameras: [{ camera_entity: 'camera.office' }],
+      });
+    });
+
+    it('should handle without camera entities', () => {
+      expect(ConfigManager.getStubConfig(['binary_sensor.motion'])).toEqual({
+        cameras: [{ camera_entity: 'camera.demo' }],
+      });
+    });
+  });
+
   describe('should handle error when', () => {
     it('should handle no input', () => {
       const manager = new ConfigManager(createCardAPI());

tests/card-controller/controller.test.ts

@@ -302,22 +302,6 @@ describe('CardController', () => {
       );
     });
 
-    describe('getStubConfig', () => {
-      it('should handle with camera entities', () => {
-        expect(
-          CardController.getStubConfig(['camera.office', 'binary_sensor.motion']),
-        ).toEqual({
-          cameras: [{ camera_entity: 'camera.office' }],
-        });
-      });
-
-      it('should handle without camera entities', () => {
-        expect(CardController.getStubConfig(['binary_sensor.motion'])).toEqual({
-          cameras: [{ camera_entity: 'camera.demo' }],
-        });
-      });
-    });
-
     it('should return getQueryStringManager', () => {
       expect(createController().getQueryStringManager()).toBe(
         vi.mocked(QueryStringManager).mock.instances[0],