@pie-players/pie-tool-tts-inline 0.3.51 → 0.3.53

package/README.md

@@ -165,6 +165,7 @@ When used with the section player, this tool benefits from extracted catalogs
 when a host/import pipeline runs `SSMLExtractor` before render:
 
 **Author embeds SSML in content:**
+
 ```html
 <div>
   <speak>Solve <prosody rate="slow">x squared plus two</prosody>.</speak>
@@ -173,11 +174,13 @@ when a host/import pipeline runs `SSMLExtractor` before render:
 ```
 
 **Preprocessing extracts SSML:**
+
 - Generates catalog with ID like `auto-prompt-q1-0`
 - Adds `data-catalog-idref="auto-prompt-q1-0"` to visual content
 - Provides `config.extractedCatalogs` for runtime catalog registration
 
 **Tool uses extracted catalog:**
+
 - User clicks TTS button in header
 - Tool calls `ttsService.speak(text, { catalogId: 'auto-prompt-q1-0' })`
 - TTSService finds SSML in extracted catalogs
@@ -194,6 +197,28 @@ The component uses scoped styles and doesn't require external CSS. Styling uses
 - **Speed state**: Active speed button receives distinct token-driven styling
 - **Disabled**: Reduced opacity, no pointer
 
+Hosts that need to theme the trigger's active/open state should prefer these
+component-scoped variables instead of overriding broad semantic tokens such as
+`--pie-primary`:
+
+```css
+--pie-tool-trigger-active-background: Active/open trigger background
+--pie-tool-trigger-active-color: Active/open trigger foreground
+--pie-tool-trigger-active-border-color: Active/open trigger border
+```
+
+If unset, the trigger keeps the existing defaults: active background and border
+derive from `--pie-primary`, while foreground continues through
+`--pie-button-color` / `--pie-text`. Hosts remain responsible for maintaining
+WCAG AA foreground/background contrast when overriding active trigger colors.
+
+Ordinary trigger and control button styling also preserves these legacy aliases:
+`--pie-button-background-color`, `--pie-button-border-color`, and
+`--pie-button-hover-background-color`. They remain supported for host
+compatibility, but fall back through the canonical `--pie-button-bg`,
+`--pie-button-border`, and `--pie-button-hover-bg` tokens before broad surface
+tokens.
+
 ## Architecture
 
 This tool follows the PIE Assessment Toolkit tool pattern: