@pie-players/pie-tool-tts-inline 0.3.65 → 0.3.67

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -231,6 +231,41 @@ indication — so these defaults do not introduce one. Hosts remain responsible
231
231
  maintaining WCAG AA foreground/background contrast when overriding active trigger
232
232
  colors.
233
233
 
234
+ ### Overlay panel colours
235
+
236
+ The floating and left-aligned panels take their shape from the Knowledge-Check
237
+ design and their colour from the active theme. Each surface resolves a
238
+ component-scoped hook first, then a canonical token, then a literal that only
239
+ applies when no theme is loaded:
240
+
241
+ ```css
242
+ --pie-tts-button-color /* media glyphs, selected speed → --pie-button-color */
243
+ --pie-tts-inline-muted-color /* unselected speed labels → --pie-button-color */
244
+ --pie-tts-selected-bg /* the card → --pie-surface / --pie-white */
245
+ --pie-selected-button-background /* selected speed chip → --pie-button-active-bg */
246
+ --pie-selected-button-border /* selected speed chip border → --pie-button-border */
247
+ --pie-tts-menu-shadow /* card elevation */
248
+ --pie-tts-card-border /* card hairline; `transparent` for shadow-only */
249
+ ```
250
+
251
+ The card carries a hairline mixed from `--pie-text` because its shadow is black
252
+ and disappears once the surface goes dark. It is deliberately not derived from
253
+ `--pie-border`: a host that wants borderless controls sets that to transparent,
254
+ which is the case where the shadow is the only edge. Set
255
+ `--pie-tts-card-border: transparent` for the shadow-only card.
256
+
257
+ A host that sets `--pie-button-border: transparent` also flattens the selected
258
+ speed chip, which defaults through it — set `--pie-selected-button-border` to
259
+ keep the chip outlined.
260
+
261
+ Foregrounds default through `--pie-button-color` (DaisyUI `base-content`) rather
262
+ than `--pie-primary` or `--pie-tertiary`: those are direct mappings of DaisyUI
263
+ slots chosen to pair with their own `-content` colour, so an accent glyph taken
264
+ from either falls under 3:1 against the card in 11 of the 35 shipped themes.
265
+ Selection reads from the chip fill and the bolder weight instead of from hue. A
266
+ host that wants a branded accent sets `--pie-tts-button-color` and owns the
267
+ contrast, as with the active-trigger hooks above.
268
+
234
269
  Ordinary trigger and control button styling also preserves these legacy aliases:
235
270
  `--pie-button-background-color`, `--pie-button-border-color`, and
236
271
  `--pie-button-hover-background-color`. They remain supported for host