par-term-emu-core-rust 0.28.0__tar.gz → 0.30.0__tar.gz

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.30.0] - 2026-02-04
+
+### Added
+- **modifyOtherKeys Protocol**: XTerm extension for enhanced keyboard input reporting
+  - State tracking for modifyOtherKeys mode (0=disabled, 1=special keys, 2=all keys)
+  - CSI sequence parsing: `CSI > 4 ; mode m` to set mode
+  - Query support: `CSI ? 4 m` returns `CSI > 4 ; mode m` response
+  - New methods: `modify_other_keys_mode()` getter, `set_modify_other_keys_mode()` setter
+  - Mode resets on terminal reset and alternate screen exit
+  - 9 new tests for modifyOtherKeys functionality
+- **Faint Text Alpha**: Configurable alpha multiplier for SGR 2 (dim/faint) text
+  - New `faint_text_alpha` field in Terminal (default: 0.5 for 50% dimming)
+  - New methods: `faint_text_alpha()` getter, `set_faint_text_alpha(alpha)` setter
+  - Values clamped to 0.0-1.0 range
+  - Propagated to screenshot renderer for consistent rendering
+  - Python bindings for both Terminal and PtyTerminal classes
+
+## [0.29.0] - 2026-02-04
+
+### Added
+- **OSC 7 Enhancements**: Percent-decoding, username/hostname parsing, port stripping, query/fragment removal, and path validation for `file://` URLs
+- **Session Variable Sync**: OSC 7 now updates badge/session variables (`path`, `hostname`, `username`) so badge formats immediately reflect directory changes
+- **CWD History Context**: CWD change log now records hostname and username; Python `CwdChange` exposes these fields
+- **CWD Change Events**: New `TerminalEvent::CwdChanged` (and Python `cwd_changed` poll_events entry) fires on OSC 7 or manual `record_cwd_change`
+- **Username Handling**: Shell integration stores optional username from `user@host` OSC 7 payloads
+
+### Changed
+- **API**: `record_cwd_change` now accepts optional `hostname` and `username` (defaults preserved); badge/session variables cleared when hostname/username unset
+- **Dependencies**: Added `percent-encoding` and `url` crates for robust OSC 7 parsing
+
+### Fixed
+- **Badge Accuracy**: Badge variables `\(path)` and `\(hostname)` now stay in sync when updated via OSC 7
+- **UTF-8 Paths**: Paths with spaces or Unicode characters from OSC 7 are correctly percent-decoded
+
 ## [0.28.0] - 2026-02-03
 
 ### Added

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/Cargo.lock

@@ -1767,7 +1767,7 @@ checksum = "7c87def4c32ab89d880effc9e097653c8da5d6ef28e6b539d313baaacfbafcbe"
 
 [[package]]
 name = "par-term-emu-core-rust"
-version = "0.28.0"
+version = "0.30.0"
 dependencies = [
  "anyhow",
  "axum",
@@ -1782,6 +1782,7 @@ dependencies = [
  "image",
  "libc",
  "parking_lot",
+ "percent-encoding",
  "portable-pty",
  "proptest",
  "prost",
@@ -1806,6 +1807,7 @@ dependencies = [
  "tracing-subscriber",
  "unicode-segmentation",
  "unicode-width",
+ "url",
  "uuid",
  "vte",
 ]

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "par-term-emu-core-rust"
-version = "0.28.0"
+version = "0.30.0"
 edition = "2021"
 rust-version = "1.75"
 authors = ["Paul Robello <probello@gmail.com>"]
@@ -57,6 +57,8 @@ regex = "1.12.2"
 serde = { version = "1.0.228", features = ["derive"] }
 serde_json = "1.0.149"
 serde_yaml = "0.9.34"
+percent-encoding = "2.3.2"
+url = "2.5.8"
 
 # Streaming server dependencies
 tokio = { version = "1.49", features = ["full"], optional = true }

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: par-term-emu-core-rust
-Version: 0.28.0
+Version: 0.30.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Environment :: Console
 Classifier: Development Status :: 4 - Beta
@@ -50,6 +50,73 @@ A comprehensive terminal emulator library written in Rust with Python bindings f
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/probello3)
 
+## What's New in 0.30.0
+
+### ⌨️ modifyOtherKeys Protocol Support
+
+XTerm extension for enhanced keyboard input reporting, enabling applications to receive modifier keys with regular characters:
+
+```python
+from par_term_emu_core_rust import Terminal
+
+term = Terminal(80, 24)
+
+# Enable modifyOtherKeys mode via escape sequence
+term.process(b"\x1b[>4;2m")  # Mode 2: report all keys with modifiers
+print(f"Mode: {term.modify_other_keys_mode()}")  # Output: 2
+
+# Or set directly
+term.set_modify_other_keys_mode(1)  # Mode 1: special keys only
+
+# Query mode (response in drain_responses())
+term.process(b"\x1b[?4m")
+response = term.drain_responses()  # Returns b"\x1b[>4;1m"
+```
+
+**Modes:**
+- `0` - Disabled (default)
+- `1` - Report modifiers for special keys only
+- `2` - Report modifiers for all keys
+
+**New Methods:**
+- `modify_other_keys_mode()` - Get current mode
+- `set_modify_other_keys_mode(mode)` - Set mode directly (values > 2 clamped to 2)
+
+**Sequences:**
+- `CSI > 4 ; mode m` - Set mode
+- `CSI ? 4 m` - Query mode (response: `CSI > 4 ; mode m`)
+
+**Note:** Mode resets to 0 on terminal reset and when exiting alternate screen.
+
+### 🎨 Faint Text Alpha Control
+
+Configurable alpha multiplier for SGR 2 (dim/faint) text, allowing fine-grained control over how dim text is rendered:
+
+```python
+from par_term_emu_core_rust import Terminal
+
+term = Terminal(80, 24)
+
+# Get current faint text alpha (default: 0.5 = 50% dimming)
+print(f"Alpha: {term.faint_text_alpha()}")  # Output: 0.5
+
+# Set faint text to be more transparent (more dimmed)
+term.set_faint_text_alpha(0.3)  # 30% opacity
+
+# Set faint text to be less transparent (less dimmed)
+term.set_faint_text_alpha(0.7)  # 70% opacity
+
+# Values are clamped to 0.0-1.0 range
+term.set_faint_text_alpha(1.5)  # Clamped to 1.0
+term.set_faint_text_alpha(-0.5)  # Clamped to 0.0
+```
+
+**New Methods:**
+- `faint_text_alpha()` - Get current alpha multiplier (0.0-1.0)
+- `set_faint_text_alpha(alpha)` - Set alpha multiplier (clamped to valid range)
+
+**Usage:** This setting is used by the screenshot renderer and can be queried by frontends for consistent rendering of dim text (SGR 2).
+
 ## What's New in 0.28.0
 
 ### 🏷️ Badge Format Support (OSC 1337 SetBadgeFormat)
@@ -576,6 +643,7 @@ make streamer-build-release
   - Mouse encoding control: `mouse_encoding()`, `set_mouse_encoding()`
   - Mode setters: `set_focus_tracking()`, `set_bracketed_paste()`, `set_title()`
   - Bold brightening control: `bold_brightening()`, `set_bold_brightening()`
+  - Faint text alpha control: `faint_text_alpha()`, `set_faint_text_alpha()`
   - Color getters for all theme colors (link, bold, cursor guide, badge, match, selection)
 
 ## What's New in 0.12.0

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/README.md

@@ -13,6 +13,73 @@ A comprehensive terminal emulator library written in Rust with Python bindings f
 
 [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/probello3)
 
+## What's New in 0.30.0
+
+### ⌨️ modifyOtherKeys Protocol Support
+
+XTerm extension for enhanced keyboard input reporting, enabling applications to receive modifier keys with regular characters:
+
+```python
+from par_term_emu_core_rust import Terminal
+
+term = Terminal(80, 24)
+
+# Enable modifyOtherKeys mode via escape sequence
+term.process(b"\x1b[>4;2m")  # Mode 2: report all keys with modifiers
+print(f"Mode: {term.modify_other_keys_mode()}")  # Output: 2
+
+# Or set directly
+term.set_modify_other_keys_mode(1)  # Mode 1: special keys only
+
+# Query mode (response in drain_responses())
+term.process(b"\x1b[?4m")
+response = term.drain_responses()  # Returns b"\x1b[>4;1m"
+```
+
+**Modes:**
+- `0` - Disabled (default)
+- `1` - Report modifiers for special keys only
+- `2` - Report modifiers for all keys
+
+**New Methods:**
+- `modify_other_keys_mode()` - Get current mode
+- `set_modify_other_keys_mode(mode)` - Set mode directly (values > 2 clamped to 2)
+
+**Sequences:**
+- `CSI > 4 ; mode m` - Set mode
+- `CSI ? 4 m` - Query mode (response: `CSI > 4 ; mode m`)
+
+**Note:** Mode resets to 0 on terminal reset and when exiting alternate screen.
+
+### 🎨 Faint Text Alpha Control
+
+Configurable alpha multiplier for SGR 2 (dim/faint) text, allowing fine-grained control over how dim text is rendered:
+
+```python
+from par_term_emu_core_rust import Terminal
+
+term = Terminal(80, 24)
+
+# Get current faint text alpha (default: 0.5 = 50% dimming)
+print(f"Alpha: {term.faint_text_alpha()}")  # Output: 0.5
+
+# Set faint text to be more transparent (more dimmed)
+term.set_faint_text_alpha(0.3)  # 30% opacity
+
+# Set faint text to be less transparent (less dimmed)
+term.set_faint_text_alpha(0.7)  # 70% opacity
+
+# Values are clamped to 0.0-1.0 range
+term.set_faint_text_alpha(1.5)  # Clamped to 1.0
+term.set_faint_text_alpha(-0.5)  # Clamped to 0.0
+```
+
+**New Methods:**
+- `faint_text_alpha()` - Get current alpha multiplier (0.0-1.0)
+- `set_faint_text_alpha(alpha)` - Set alpha multiplier (clamped to valid range)
+
+**Usage:** This setting is used by the screenshot renderer and can be queried by frontends for consistent rendering of dim text (SGR 2).
+
 ## What's New in 0.28.0
 
 ### 🏷️ Badge Format Support (OSC 1337 SetBadgeFormat)
@@ -539,6 +606,7 @@ make streamer-build-release
   - Mouse encoding control: `mouse_encoding()`, `set_mouse_encoding()`
   - Mode setters: `set_focus_tracking()`, `set_bracketed_paste()`, `set_title()`
   - Bold brightening control: `bold_brightening()`, `set_bold_brightening()`
+  - Faint text alpha control: `faint_text_alpha()`, `set_faint_text_alpha()`
   - Color getters for all theme colors (link, bold, cursor guide, badge, match, selection)
 
 ## What's New in 0.12.0

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/docs/ADVANCED_FEATURES.md

@@ -155,6 +155,42 @@ term.process_str("\x1b[1;31mThis appears regular red (bold)\x1b[0m\n")
 
 **Note**: Bold brightening only affects ANSI colors 0-7, not 256-color or RGB colors. When creating snapshots with `create_snapshot()` or taking screenshots with `screenshot()` / `screenshot_to_file()`, the bold brightening setting is automatically applied to the captured colors.
 
+## Faint/Dim Text Alpha (SGR 2)
+
+The faint text alpha controls how dim SGR 2 (faint/dim) text appears. This is the alpha multiplier applied to dim text during rendering.
+
+### Overview
+
+- **Range**: 0.0-1.0 where 0.0 = fully transparent, 1.0 = fully opaque
+- **Default**: 0.5 (50% opacity - text is blended with background)
+- **SGR Code**: Applied when text has the SGR 2 (dim/faint) attribute
+
+### Usage
+
+```python
+from par_term_emu_core_rust import Terminal
+
+term = Terminal(80, 24)
+
+# Check current faint text alpha (default 0.5)
+print(f"Alpha: {term.faint_text_alpha()}")  # Output: 0.5
+
+# Make dim text more transparent (more dimmed)
+term.set_faint_text_alpha(0.3)
+
+# Process text with dim attribute (SGR 2)
+term.process_str("\x1b[2mThis text is dimmed\x1b[0m\n")
+
+# Make dim text less transparent (less dimmed)
+term.set_faint_text_alpha(0.7)
+
+# Values are clamped to 0.0-1.0 range
+term.set_faint_text_alpha(1.5)  # Becomes 1.0
+term.set_faint_text_alpha(-0.5)  # Becomes 0.0
+```
+
+**Note**: The faint text alpha is automatically applied when taking screenshots with `screenshot()` / `screenshot_to_file()`. Frontends can query this value via `faint_text_alpha()` to apply consistent dimming during real-time rendering.
+
 ## Minimum Contrast Adjustment (iTerm2-Compatible)
 
 The minimum contrast feature automatically adjusts text colors to ensure readability against backgrounds, using the same algorithm as iTerm2.

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/docs/API_REFERENCE.md

@@ -177,6 +177,16 @@ badge = term.evaluate_badge()  # "alice@server1"
 
 **Note:** Flags are maintained separately for main and alternate screen buffers with independent stacks. Automatically reset when exiting alternate screen.
 
+#### modifyOtherKeys (XTerm Extension)
+- `modify_other_keys_mode() -> int`: Get current mode (0=disabled, 1=special keys, 2=all keys)
+- `set_modify_other_keys_mode(mode: int)`: Set mode directly (values > 2 clamped to 2)
+
+**Sequences:**
+- `CSI > 4 ; mode m` - Set mode via escape sequence
+- `CSI ? 4 m` - Query mode (response: `CSI > 4 ; mode m` in drain_responses())
+
+**Note:** Mode resets to 0 on terminal reset and when exiting alternate screen.
+
 #### Clipboard Operations (OSC 52)
 - `clipboard() -> str | None`: Get clipboard content
 - `set_clipboard(content: str | None)`: Set clipboard content programmatically
@@ -275,12 +285,15 @@ badge = term.evaluate_badge()  # "alice@server1"
 - `set_use_underline_color(use_underline: bool)`: Enable/disable custom underline color
 - `bold_brightening() -> bool`: Check if bold text with colors 0-7 is brightened to 8-15
 - `set_bold_brightening(enabled: bool)`: Enable/disable bold brightening (legacy behavior)
+- `faint_text_alpha() -> float`: Get alpha multiplier for SGR 2 (dim/faint) text (0.0-1.0, default 0.5)
+- `set_faint_text_alpha(alpha: float)`: Set alpha multiplier for dim text (clamped to 0.0-1.0)
 
 #### Shell Integration (OSC 133 & OSC 7)
 - `current_directory() -> str | None`: Get current working directory (OSC 7)
 - `accept_osc7() -> bool`: Check if OSC 7 (CWD) is accepted
 - `set_accept_osc7(accept: bool)`: Set whether to accept OSC 7 sequences
 - `shell_integration_state() -> ShellIntegration`: Get shell integration state
+- `record_cwd_change(new_cwd: str, hostname: str | None = None, username: str | None = None)`: Manually record a CWD change (updates history + session variables)
 - `disable_insecure_sequences() -> bool`: Check if insecure sequences are disabled
 - `set_disable_insecure_sequences(disable: bool)`: Disable insecure/dangerous sequences
 - `answerback_string() -> str | None`: Get the configured ENQ answerback payload (None if disabled)
@@ -409,10 +422,11 @@ Extended shell integration features beyond basic OSC 133:
 - `end_command_execution(exit_code: int)`: Mark end of command with exit code
 - `get_current_command() -> CommandExecution | None`: Get currently executing command
 - `get_shell_integration_stats() -> ShellIntegrationStats`: Get shell integration statistics
-- `get_cwd_changes() -> list[CwdChange]`: Get working directory change history
+- `get_cwd_changes() -> list[CwdChange]`: Get working directory change history (includes hostname/username)
 - `clear_cwd_history()`: Clear CWD history
 - `set_max_cwd_history(max: int)`: Set CWD history limit
-- `record_cwd_change(cwd: str)`: Record working directory change
+- `record_cwd_change(cwd: str, hostname: str | None = None, username: str | None = None)`: Record working directory change
+- `poll_events()`: Now also returns `cwd_changed` events with `old_cwd`, `new_cwd`, `hostname`, `username`, `timestamp`
 
 ### Clipboard Extended
 
@@ -529,6 +543,10 @@ VT compliance testing:
 - `use_alt_screen()`: Switch to alternate screen buffer (programmatic, not via escape codes)
 - `use_primary_screen()`: Switch to primary screen buffer (programmatic)
 - `poll_events() -> list[str]`: Poll for pending terminal events
+- `set_event_subscription(kinds: list[str] | None)`: Filter which terminal events are returned by `poll_subscribed_events()` (None clears filter)
+- `clear_event_subscription()`: Clear event filter (all events are returned)
+- `poll_subscribed_events() -> list[dict]`: Drain events that match subscription filter
+- `poll_cwd_events() -> list[dict]`: Drain only CWD change events (fields: new_cwd, old_cwd?, hostname?, username?, timestamp)
 - `update_animations()`: Update animation frames (for blinking cursor, text, etc.)
 - `debug_info() -> str`: Get debug information string
 - `detect_urls(text: str) -> list[DetectedItem]`: Detect URLs in text
@@ -624,6 +642,8 @@ PtyTerminal(cols: int, rows: int, scrollback: int = 10000)
 
 #### Appearance Settings (PTY-Specific)
 - `set_bold_brightening(enabled: bool)`: Enable/disable bold brightening (ANSI colors 0-7 → 8-15)
+- `faint_text_alpha() -> float`: Get alpha multiplier for SGR 2 (dim/faint) text (0.0-1.0, default 0.5)
+- `set_faint_text_alpha(alpha: float)`: Set alpha multiplier for dim text (clamped to 0.0-1.0)
 
 **Note:** PtyTerminal inherits all Terminal methods, so you can also use all Terminal appearance settings like `set_default_fg()`, `set_default_bg()`, etc.
 
@@ -897,7 +917,10 @@ Working directory change event.
 
 **Properties:**
 - `cwd: str`: New working directory path
-- `timestamp: int`: Change timestamp (Unix timestamp in seconds)
+- `old_cwd: str | None`: Previous working directory (if any)
+- `hostname: str | None`: Hostname associated with the new path (None for localhost)
+- `username: str | None`: Username from `user@host` portion of OSC 7 (if provided)
+- `timestamp: int`: Change timestamp (Unix timestamp in milliseconds)
 
 ### DamageRegion
 

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/docs/CONFIG_REFERENCE.md

@@ -256,9 +256,11 @@ These settings control potentially sensitive or insecure terminal features at th
 - Use in untrusted/sandboxed environments
 
 **OSC 7 Directory Tracking:**
-- Generally safe to keep enabled
-- Used for shell integration and smart directory tracking
-- Disable if you don't need this feature
+- Parses `file://[user@]host[:port]/path` URLs from shells (e.g., PROMPT_COMMAND)
+- Percent-decodes paths/usernames and strips query/fragment
+- Updates shell integration + badge/session variables (`\(path)`, `\(hostname)`, `\(username)`)
+- Records CWD history with timestamps and host/user context
+- Generally safe to keep enabled; disable if you don't need this feature
 
 ---
 

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/docs/VT_SEQUENCES.md

@@ -296,7 +296,7 @@ Operating System Command sequences for advanced features (format: `OSC Ps ; Pt S
 - `OSC 2;title ST` - Set window title only
 - `OSC 21;title ST` - Push title to stack (or `OSC 21 ST` to push current title)
 - `OSC 22 ST` / `OSC 23 ST` - Pop window/icon title from stack
-- `OSC 7;file://host/path ST` - Set current working directory (URL-encoded)
+- `OSC 7;file://[user@]host[:port]/path ST` - Set current working directory (percent-decoded; strips query/fragment; `localhost` is treated as None)
 
 ### Hyperlinks and Clipboard
 

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/docs/VT_TECHNICAL_REFERENCE.md

@@ -741,7 +741,7 @@ where `ST` is either `ESC \` or `BEL` (`\x07`)
 
 | Sequence | Operation | Notes |
 |----------|-----------|-------|
-| `OSC 7 ; file://host/cwd ST` | Set working directory | Can be disabled via `accept_osc7` |
+| `OSC 7 ; file://[user@]host[:port]/cwd ST` | Set working directory | Percent-decodes path/username, strips query/fragment, ignores `localhost`, records hostname & username in session variables, can be disabled via `accept_osc7` |
 
 **Format:** `file://hostname/path` (URL-encoded path)
 
@@ -1338,7 +1338,7 @@ The terminal provides comprehensive support for complex Unicode grapheme cluster
 | OSC 8 Hyperlinks | ✅ Full | `src/terminal/sequences/osc.rs` | With deduplication |
 | OSC 52 Clipboard | ✅ Full | `src/terminal/sequences/osc.rs` | Read/write with security controls |
 | OSC 133 Shell Integration | ✅ Full | `src/terminal/sequences/osc.rs` | Prompt/command/output markers |
-| OSC 7 Directory Tracking | ✅ Full | `src/terminal/sequences/osc.rs` | URL-encoded paths |
+| OSC 7 Directory Tracking | ✅ Full | `src/terminal/sequences/osc.rs` | Percent-decoded paths, username, hostname, session variable sync, CWD history |
 | OSC 9;4 Progress Bar | ✅ Full | `src/terminal/sequences/osc.rs`, `src/terminal/progress.rs` | ConEmu/Windows Terminal style progress |
 | Underline styles | ✅ Full | `src/terminal/sequences/csi.rs` | 6 different styles |
 

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "maturin"
 
 [project]
 name = "par-term-emu-core-rust"
-version = "0.28.0"
+version = "0.30.0"
 description = "A comprehensive terminal emulator library in Rust with Python bindings - supports true color, alt screen, mouse reporting, bracketed paste, and full Unicode"
 readme = "README.md"
 requires-python = ">=3.12"

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/python/par_term_emu_core_rust/__init__.py

@@ -84,7 +84,7 @@ except ImportError:
     encode_client_message = None
     decode_client_message = None
 
-__version__ = "0.28.0"
+__version__ = "0.30.0"
 __all__ = [
     "AmbiguousWidth",
     "Attributes",

{par_term_emu_core_rust-0.28.0 → par_term_emu_core_rust-0.30.0}/src/python_bindings/pty.rs

@@ -1423,6 +1423,39 @@ impl PyPtyTerminal {
         Ok(())
     }
 
+    /// Get faint/dim text alpha multiplier
+    ///
+    /// This value is applied to SGR 2 (dim/faint) text during rendering.
+    /// A value of 0.5 means 50% opacity (the default).
+    ///
+    /// Returns:
+    ///     Alpha multiplier between 0.0 and 1.0
+    fn faint_text_alpha(&self) -> PyResult<f32> {
+        let terminal = self.inner.terminal();
+        if let Ok(term) = Ok::<_, ()>(terminal.lock()) {
+            return Ok(term.faint_text_alpha());
+        }
+        Ok(0.5) // Default if lock fails
+    }
+
+    /// Set faint/dim text alpha multiplier
+    ///
+    /// This value is applied to SGR 2 (dim/faint) text during rendering.
+    /// Values are clamped to the range 0.0-1.0.
+    ///
+    /// Args:
+    ///     alpha: Alpha multiplier (0.0 = fully transparent, 1.0 = fully opaque)
+    ///
+    /// Example:
+    ///     >>> pty.set_faint_text_alpha(0.3)  # 30% opacity for dim text
+    fn set_faint_text_alpha(&mut self, alpha: f32) -> PyResult<()> {
+        let terminal = self.inner.terminal();
+        if let Ok(mut term) = Ok::<_, ()>(terminal.lock()) {
+            term.set_faint_text_alpha(alpha);
+        }
+        Ok(())
+    }
+
     /// Enable/disable custom underline color
     ///
     /// When enabled, underlined text uses a custom underline color.