[Ayman Bagabas (aymanbagabas)]

Summary

This draft builds on #274, above #271 and #272.

• Expose typed rendering settings through JavaScript, Python, and Go.
• Support constructor defaults and per-call replacement for fonts, colors, padding, window controls, borders, shadows, and cursor animation.
• Preserve omitted defaults, explicit false and zero, caller settings, and resolved styles after restart.
• Add native cursor, mode, and color assertions, plus dedicated mode and color getters.
• Regenerate the shared C header and binding declarations. Advance the native ABI from 6 to 7.
• Add integration coverage and runnable examples in all three languages.

Cursor settings control permission to blink and the duration of each phase. They do not force a steady application cursor to blink.
Screenshots remain deterministic. Rendering settings do not change terminal colors or locator assertions.

Demonstration

The JavaScript example creates these GIFs through the native renderer.
Both use a 24-pixel font, custom padding, no title bar, and no shadow.
The application requests a blinking bar cursor.

Blink disabled

The constructor style disables animation. The GIF contains one frame and preserves 1.10 seconds of active time.

Per-call override: 250 ms phases

A per-call style enables animation. The GIF contains five phases over 1.10 seconds.
The first four encoded phases last 270, 240, 260, and 240 ms, within the 30 FPS sampling interval.
The original constructor settings remain unchanged.

Examples:

• bindings/js/examples/rendering.mjs
• bindings/python/examples/rendering.py
• bindings/go/examples/rendering/main.go

Remaining parity gaps

This draft does not claim complete Rust API parity.
The binding locator transport still lacks TextSelector.scope anchors and the whole-match LocatorQuery.style filter.
Intersection with getByStyle() is not equivalent: it can return a styled substring instead of rejecting the full text match.
These gaps remain outside this implementation.

Validation

Local macOS ARM64 checks:

• 12 generator tests and 17 FFI tests.
• Generated declaration consistency, Rust formatting, and Clippy.
• TypeScript build, 70 JavaScript boundary/helper tests, and targeted integration tests.
• The new integration test under both Node and Bun.
• All 168 Python tests and all Go packages.
• Compiler ABI layout checks, Go vet, and all three examples.
• Decoded example GIFs: one frame with blinking disabled in each language; five phases with the JavaScript override.

The broader JavaScript run passed 102 of 103 tests. The existing echo roundtrip test timed out in waitReady.
The unchanged CLI also reproduced that zsh readiness failure after a command.
No shell integration code changes are included.
Native Windows and Deno validation remain pending.