@qontinui/ui-bridge-wrapper 0.10.0 → 0.11.0

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
@@ -214,6 +214,30 @@ arriving (under `--throttle`, its slow-network load) while the override still
214
214
  confirms decode before it answers. In `--capture-matrix` a relative `dir` lands
215
215
  in each cell's directory.
216
216
 
217
+ ### Text hidden for one frame: text over images on real pixels
218
+
219
+ The injected runtime also serves the `textVisibility` dev control, which makes
220
+ every glyph on the page transparent for one frame and then restores the page
221
+ exactly. Frame A (normal) and frame B (text hidden) against one snapshot differ,
222
+ inside each text element's box, exactly where its glyphs paint, and frame B
223
+ shows what they sit on:
224
+
225
+ ```bash
226
+ ui-bridge-inject --url http://127.0.0.1:3000/ --screenshot './frames/frame-{n}.png' \
227
+ --exec 'getControlSnapshot {}' \
228
+ --exec 'textVisibility {"hidden":true}' --exec 'getControlSnapshot {}' \
229
+ --exec 'textVisibility {"hidden":false}'
230
+ ```
231
+
232
+ Hiding writes inline `!important` values on every element: `color`,
233
+ `-webkit-text-fill-color` and SVG text `fill` go transparent, `text-shadow`
234
+ goes `none` and transitions are switched off, so frame B is never caught
235
+ mid-fade. Paint that only followed the text colour (a `currentColor` border or
236
+ icon) is pinned to the colour it had, so only glyphs change. `{"hidden":false}`
237
+ writes every `style` attribute back byte for byte (`restore.verified: true`),
238
+ without the text fading back in; a TTL (`ttlMs`, default 30000) restores the
239
+ page by itself if the run dies.
240
+
217
241
  #### Sourcing credentials from SSM (qontinui operators)
218
242
 
219
243
  The bins read credentials from env / flags only — they intentionally do **not**
@@ -1511,6 +1511,19 @@ Exec (Variant A \u2014 one-shot; presence of any --exec/--exec-stdin selects thi
1511
1511
  mediaOverrideList {}
1512
1512
  What is still overridden \u2014 the proof the page ended restored.
1513
1513
 
1514
+ Hiding text for one frame (dev control, served by the injected runtime):
1515
+
1516
+ textVisibility {"hidden":true,"ttlMs":30000}
1517
+ Make every glyph on the page transparent (colour, text fill, SVG text
1518
+ fill, text-shadow), with transitions off so the frame is not caught
1519
+ mid-fade; nothing moves, and currentColor borders and icons keep their
1520
+ colour. Capture frame A before and frame B after: inside a text
1521
+ element's box the two differ exactly where its glyphs paint. A TTL
1522
+ (default 30000 ms) restores the page if the run dies.
1523
+ textVisibility {"hidden":false}
1524
+ Restore exactly (the style attributes read back byte for byte);
1525
+ "restore":{"verified":true} is a clean restore.
1526
+
1514
1527
  Exec output & exit code:
1515
1528
  One JSON line per action, in order, on stdout \u2014 ALWAYS one line per action,
1516
1529
  including failures. An action that succeeded prints {"action":..,"result":..}.