feat: Implement basic general folder support (#2051)

- Related: #1748

src/config/schema/actions/custom/folder.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import { advancedCameraCardCustomActionsBaseSchema } from './base';
+
+export const folderActionConfigSchema = advancedCameraCardCustomActionsBaseSchema.extend(
+  {
+    advanced_camera_card_action: z.literal('folder'),
+    folder: z.string().optional(),
+  },
+);
+export type FolderActionConfig = z.infer<typeof folderActionConfigSchema>;

src/config/schema/actions/custom/ptz.ts

@@ -7,8 +7,7 @@ const PTZ_BASE_ACTIONS = [...PTZ_PAN_TILT_ACTIONS, ...PTZ_ZOOM_ACTIONS] as const
 export type PTZBaseAction = (typeof PTZ_BASE_ACTIONS)[number];
 
 // PTZ actions as used by the PTZ control (includes a 'home' button).
-const PTZ_CONTROL_ACTIONS = [...PTZ_BASE_ACTIONS, 'home'] as const;
-export type PTZControlAction = (typeof PTZ_CONTROL_ACTIONS)[number];
+export type PTZControlAction = PTZBaseAction | 'home';
 
 // PTZ actions as used by the camera manager (includes generic presets).
 export const PTZ_ACTIONS = [...PTZ_BASE_ACTIONS, 'preset'] as const;

src/config/schema/actions/custom/view.ts

@@ -1,8 +1,23 @@
 import { z } from 'zod';
-import { VIEWS_USER_SPECIFIED } from '../../common/const';
+import {
+  AdvancedCameraCardUserSpecifiedView,
+  VIEWS_USER_SPECIFIED,
+} from '../../common/const';
 import { advancedCameraCardCustomActionsBaseSchema } from './base';
 
+type AdvancedCameraCardUserSpecifiedViewWithoutFolder = Exclude<
+  AdvancedCameraCardUserSpecifiedView,
+  'folder'
+>;
+
 export const viewActionConfigSchema = advancedCameraCardCustomActionsBaseSchema.extend({
-  advanced_camera_card_action: z.enum(VIEWS_USER_SPECIFIED),
+  advanced_camera_card_action: z.enum(
+    // The folder view is handled by the `folder` action since it accepts an
+    // optional folder ID.
+    VIEWS_USER_SPECIFIED.filter((view) => view !== 'folder') as [
+      AdvancedCameraCardUserSpecifiedViewWithoutFolder,
+      ...AdvancedCameraCardUserSpecifiedViewWithoutFolder[],
+    ],
+  ),
 });
 export type ViewActionConfig = z.infer<typeof viewActionConfigSchema>;

src/config/schema/actions/types.ts

@@ -3,6 +3,7 @@ import { statusBarItemBaseSchema } from '../common/status-bar';
 import { advancedCameraCardCustomActionsBaseSchema } from './custom/base';
 import { cameraSelectActionConfigSchema } from './custom/camera-select';
 import { viewDisplayModeActionConfigSchema } from './custom/display-mode';
+import { folderActionConfigSchema } from './custom/folder';
 import { generalActionConfigSchema } from './custom/general';
 import { internalCallbackActionConfigSchema } from './custom/internal';
 import { logActionConfigSchema } from './custom/log';
@@ -41,6 +42,7 @@ export const statusBarActionConfigSchema: z.ZodSchema<
 
 const advancedCameraCardCustomActionSchema = z.union([
   cameraSelectActionConfigSchema,
+  folderActionConfigSchema,
   generalActionConfigSchema,
   internalCallbackActionConfigSchema,
   logActionConfigSchema,