ftui-extras 0.4.0

Feature-gated extras for FrankenTUI (markdown, charts, clipboard, themes).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

//! Optional feature-gated extensions for FrankenTUI.
//!
//! Each module is behind a Cargo feature flag and can be enabled independently.
//! These modules provide higher-level functionality built on top of the core
//! ftui crates (render, style, text, widgets).
//!
//! # Role in FrankenTUI
//! `ftui-extras` collects optional, higher-level utilities that are useful
//! across apps but not required by the core runtime or render kernel. It is
//! feature-gated to keep the base dependency graph lean.
//!
//! # How it fits in the system
//! Extras build on `ftui-render`, `ftui-style`, `ftui-text`, and `ftui-widgets`.
//! You can enable only the pieces you need without pulling in everything else.
//!
//! # Available Features
//!
//! | Feature | Module | Description |
//! |---------|--------|-------------|
//! | `canvas` | [`canvas`] | Pixel-level drawing primitives |
//! | `charts` | [`charts`] | Chart widgets (depends on canvas) |
//! | `clipboard` | [`clipboard`] | OSC 52 clipboard integration |
//! | `diagram` | [`diagram`] | ASCII diagram detection and correction |
//! | `console` | [`console`] | ANSI-aware console text processing |
//! | `export` | [`export`] | Buffer export to HTML/SVG/text |
//! | `filesize` | [`filesize`] | Human-readable file size formatting |
//! | `filepicker` | [`filepicker`] | File picker state utilities |
//! | `forms` | [`forms`] | Form layout and input widgets |
//! | `validation` | [`validation`] | Form validation framework with composable validators |
//! | `image` | [`image`] | Terminal image protocols (iTerm2/Kitty) |
//! | `live` | [`live`] | Live-updating display (depends on console) |
//! | `logging` | [`logging`] | Tracing subscriber for TUI logging |
//! | `markdown` | [`markdown`] | Markdown to styled text rendering |
//! | `pty-capture` | [`pty_capture`] | PTY session capture |
//! | `stopwatch` | [`stopwatch`] | Stopwatch timing utility |
//! | `syntax` | [`syntax`] | Syntax highlighting spans |
//! | `timer` | [`timer`] | Countdown timer utility |
//! | `traceback` | [`traceback`] | Error/stacktrace display |
//! | `theme` | [`theme`] | Color themes + palette tokens |
//! | `terminal` | [`terminal`] | ANSI escape sequence parser for terminal emulation |
//! | `text-effects` | [`text_effects`] | Animated text effects (gradients, fades, ASCII art) |
//! | `visual-fx` | [`visual_fx`] | Feature-gated visual FX primitives (backdrops, CPU/GPU adapters) |
//! | `fx-gpu` | `visual_fx::gpu` | Optional GPU acceleration for metaballs (silent CPU fallback) |
//! | `help` | [`help`] | Contextual help system with tooltips |

#![forbid(unsafe_code)]

#[cfg(test)]
use stats_alloc::{INSTRUMENTED_SYSTEM, StatsAlloc};
#[cfg(test)]
use std::alloc::System;

#[cfg(test)]
#[global_allocator]
static GLOBAL: &StatsAlloc<System> = &INSTRUMENTED_SYSTEM;

#[cfg(feature = "canvas")]
pub mod canvas;

#[cfg(feature = "console")]
pub mod console;

#[cfg(feature = "charts")]
pub mod charts;

#[cfg(feature = "clipboard")]
pub mod clipboard;

#[cfg(feature = "diagram")]
pub mod diagram;

#[cfg(feature = "diagram")]
pub mod mermaid;

#[cfg(feature = "diagram")]
pub mod mermaid_layout;

#[cfg(feature = "diagram")]
pub mod diagram_layout;

#[cfg(feature = "diagram")]
pub mod mermaid_render;

#[cfg(all(feature = "diagram", feature = "canvas"))]
pub mod mermaid_minimap;

#[cfg(feature = "diagram")]
pub mod mermaid_diff;

#[cfg(feature = "diagram")]
pub mod dot_parser;
#[cfg(feature = "export")]
pub mod export;

#[cfg(feature = "filesize")]
pub mod filesize;

#[cfg(feature = "forms")]
pub mod forms;

#[cfg(feature = "validation")]
pub mod validation;

#[cfg(feature = "image")]
pub mod image;

#[cfg(feature = "live")]
pub mod live;

#[cfg(feature = "logging")]
pub mod logging;

#[cfg(feature = "markdown")]
pub mod markdown;

#[cfg(feature = "pty-capture")]
pub mod pty_capture;

#[cfg(feature = "syntax")]
pub mod syntax;

#[cfg(feature = "filepicker")]
pub mod filepicker;

#[cfg(feature = "traceback")]
pub mod traceback;

#[cfg(feature = "stopwatch")]
pub mod stopwatch;

#[cfg(feature = "timer")]
pub mod timer;

#[cfg(feature = "theme")]
pub mod theme;

#[cfg(feature = "terminal")]
pub mod terminal;

#[cfg(feature = "text-effects")]
pub mod glowing_text;

#[cfg(feature = "text-effects")]
pub mod text_effects;

#[cfg(feature = "visual-fx")]
pub mod visual_fx;

#[cfg(feature = "help")]
pub mod help;

#[cfg(feature = "doom")]
pub mod doom;

#[cfg(feature = "quake")]
pub mod quake;

#[cfg(feature = "sinkhorn-morph")]
pub mod sinkhorn_morph;