Files
SubMiner/backlog/tasks/task-300 - Fix-transparent-subtitle-hover-background-config.md

2.1 KiB

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority
id title status assignee created_date updated_date labels dependencies priority
TASK-300 Fix transparent subtitle hover background config Done
2026-04-26 03:23 2026-04-26 03:26
bug
overlay
config
medium

Description

User reports setting subtitleStyle.hoverTokenBackgroundColor to transparent still renders default hover background in overlay subtitles.

Acceptance Criteria

  • #1 Transparent hoverTokenBackgroundColor is accepted by config resolution.
  • #2 Renderer applies transparent hover token background instead of falling back to default.

Implementation Plan

  1. Reproduce config alias behavior with a failing config test.
  2. Map subtitleStyle.hoverBackground to hoverTokenBackgroundColor in config resolution while keeping canonical key precedence.
  3. Add renderer regression for transparent hover token background CSS variable.
  4. Update docs and changelog fragment; run focused verification.

Implementation Notes

Local user config used subtitleStyle.hoverBackground, which was ignored because only subtitleStyle.hoverTokenBackgroundColor was recognized. Canonical key still takes precedence when both are present.

Verification passed: bun run test:config:src; bun test src/renderer/subtitle-render.test.ts; bun run changelog:lint; bun run docs:test; bun run docs:build.

Final Summary

Implemented config compatibility for transparent hover token backgrounds. subtitleStyle.hoverBackground now maps to the canonical subtitleStyle.hoverTokenBackgroundColor during resolution, preserving canonical key precedence. Added regression coverage for the alias and renderer handling of transparent, documented the alias, and added a changelog fragment.

Verification: bun run test:config:src; bun test src/renderer/subtitle-render.test.ts; bun run changelog:lint; bun run docs:test; bun run docs:build.