From 3df5d4d6a2cebcaa79f4e4c64b060e05a19361ab Mon Sep 17 00:00:00 2001
From: sudacode <suda@sudacode.com>
Date: Sat, 21 Mar 2026 19:43:49 -0700
Subject: [PATCH] fix(ci): export asCssColor and subtitle sidebar autoOpen
 typing

---
 src/config/definitions/defaults-subtitle.ts |  1 +
 src/config/definitions/options-subtitle.ts  |  6 ++++
 src/config/resolve/shared.ts                | 40 +++++++++++++++++++++
 src/core/services/ipc.test.ts               |  1 +
 src/types.ts                                |  1 +
 5 files changed, 49 insertions(+)

diff --git a/src/config/definitions/defaults-subtitle.ts b/src/config/definitions/defaults-subtitle.ts
index 717f1a9..25bbd0f 100644
--- a/src/config/definitions/defaults-subtitle.ts
+++ b/src/config/definitions/defaults-subtitle.ts
@@ -59,6 +59,7 @@ export const SUBTITLE_DEFAULT_CONFIG: Pick<ResolvedConfig, 'subtitleStyle' | 'su
   },
   subtitleSidebar: {
     enabled: false,
+    autoOpen: false,
     layout: 'overlay',
     toggleKey: 'Backslash',
     pauseVideoOnHover: false,
diff --git a/src/config/definitions/options-subtitle.ts b/src/config/definitions/options-subtitle.ts
index e5774c8..98db3a4 100644
--- a/src/config/definitions/options-subtitle.ts
+++ b/src/config/definitions/options-subtitle.ts
@@ -116,6 +116,12 @@ export function buildSubtitleConfigOptionRegistry(
       defaultValue: defaultConfig.subtitleSidebar.enabled,
       description: 'Enable the subtitle sidebar feature for parsed subtitle sources.',
     },
+    {
+      path: 'subtitleSidebar.autoOpen',
+      kind: 'boolean',
+      defaultValue: defaultConfig.subtitleSidebar.autoOpen,
+      description: 'Automatically open the subtitle sidebar once during overlay startup.',
+    },
     {
       path: 'subtitleSidebar.layout',
       kind: 'string',
diff --git a/src/config/resolve/shared.ts b/src/config/resolve/shared.ts
index 2490f91..4981eeb 100644
--- a/src/config/resolve/shared.ts
+++ b/src/config/resolve/shared.ts
@@ -15,6 +15,22 @@ export function asBoolean(value: unknown): boolean | undefined {
 }
 
 const hexColorPattern = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const cssColorKeywords = new Set([
+  'transparent',
+  'currentcolor',
+  'inherit',
+  'initial',
+  'unset',
+  'revert',
+  'revert-layer',
+]);
+const cssColorFunctionPattern = /^(?:rgba?|hsla?)\(\s*[^()]+?\s*\)$/i;
+
+function supportsCssColor(text: string): boolean {
+  const css = (globalThis as { CSS?: { supports?: (property: string, value: string) => boolean } })
+    .CSS;
+  return css?.supports?.('color', text) ?? false;
+}
 
 export function asColor(value: unknown): string | undefined {
   if (typeof value !== 'string') return undefined;
@@ -22,6 +38,30 @@ export function asColor(value: unknown): string | undefined {
   return hexColorPattern.test(text) ? text : undefined;
 }
 
+export function asCssColor(value: unknown): string | undefined {
+  if (typeof value !== 'string') return undefined;
+
+  const text = value.trim();
+  if (text.length === 0) {
+    return undefined;
+  }
+
+  if (supportsCssColor(text)) {
+    return text;
+  }
+
+  const normalized = text.toLowerCase();
+  if (
+    hexColorPattern.test(text) ||
+    cssColorKeywords.has(normalized) ||
+    cssColorFunctionPattern.test(text)
+  ) {
+    return text;
+  }
+
+  return undefined;
+}
+
 export function asFrequencyBandedColors(
   value: unknown,
 ): [string, string, string, string, string] | undefined {
diff --git a/src/core/services/ipc.test.ts b/src/core/services/ipc.test.ts
index 65e5da5..de8595f 100644
--- a/src/core/services/ipc.test.ts
+++ b/src/core/services/ipc.test.ts
@@ -84,6 +84,7 @@ function createSubtitleSidebarSnapshotFixture(): SubtitleSidebarSnapshot {
     currentSubtitle: { text: '', startTime: null, endTime: null },
     config: {
       enabled: false,
+      autoOpen: false,
       layout: 'overlay',
       toggleKey: 'Backslash',
       pauseVideoOnHover: false,
diff --git a/src/types.ts b/src/types.ts
index cdde099..355f7f6 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -374,6 +374,7 @@ export type SubtitleSidebarLayout = 'overlay' | 'embedded';
 
 export interface SubtitleSidebarConfig {
   enabled?: boolean;
+  autoOpen?: boolean;
   layout?: SubtitleSidebarLayout;
   toggleKey?: string;
   pauseVideoOnHover?: boolean;