libghostty

Added

• Color utilities: parseColor, parsePaletteEntry,
  parseX11ColorName, x11ColorNames, palette generation, and luminance
  helpers expose Ghostty's runtime color behavior.
• Unicode width utilities: unicodeCodepointWidth and
  unicodeGraphemeWidth expose Ghostty's terminal cell-width rules.
• Color-scheme reports: ColorScheme.encode() encodes terminal
  color-scheme reporting responses.
• Kitty graphics cache stamps: KittyGraphics.generation and
  KittyImage.generation let renderers detect placement and image cache
  invalidation without comparing image bytes.
• Absolute viewport scrolling: Terminal.scrollToRow() restores viewport
  positions using the same row space as Scrollbar.offset.

Changed

• Kitty graphics pixel data: stored image payloads are exposed as decoded,
  decompressed pixels, including PNG and zlib-compressed transmissions.
• Scrollbar metadata: scrollbar reads use Ghostty's cached offset and
  incrementally maintained total, reducing repeated scrollback traversal.

Breaking

• Position coordinates: cursor and grid lookup APIs use Position
  values. GridRef.positionIn() replaces pointIn(), and GridRef
  no longer needs dispose().

Added

• Selection APIs: Selection, SelectionGesture, active terminal
  selection, and selection formatting expose libghostty selection behavior.
• Tracked grid references: TrackedGridRef follows a cell across
  terminal mutations until the referenced cell is discarded.
• Terminal APIs: working-directory changes, device attributes queries,
  default cursor blink, and Glyph Protocol toggling are exposed.
• Render selection metadata: RowIterator.selection and
  CellIterator.isSelected
  expose row-local selection state for render snapshots.

Added

• Back-arrow key mode: TerminalMode.backArrowKeyMode() and
  KeyEncoder.setBackArrowKeyMode() expose DEC mode 67, letting legacy
  Backspace encoding switch between DEL and BS.
• APC buffer limits: Terminal.setApcBufferLimit() and
  Terminal.setKittyApcBufferLimit() configure general and Kitty-specific
  APC payload limits.

Fixed

• Resize callbacks: ghostty_terminal_resize is no longer bound as a
  leaf FFI call, preventing callback crashes when resize emits in-band size
  reports through onWritePty.

Breaking

• Standalone companions: rendering, grid lookups, formatting, and
  encoding moved off Terminal. RenderState with RowIterator /
  CellIterator, GridRef.at, Formatter, KittyGraphics.of, and
  standalone KeyEncoder / MouseEncoder replace their Terminal
  method and getter equivalents.

Added

• Kitty graphics: image and placement lookup with resolved render
  geometry, plus a process-global PNG decoder hook.
• Log callback: process-global sink for the native library's
  internal log output.
• Formatter selection: restrict output to a coordinate region,
  including block selections.
• Terminal data: cursorStyle, isMouseTracking, and Kitty image
  configuration accessors.
• Grid references: hyperlinkUri and pointIn() for OSC 8 lookup
  and coordinate round-tripping.

Fixed

• Linux prebuilts: the prebuilt Linux binaries failed to load on glibc systems with invalid ELF header. They now ship as libghostty-x86_64-linux-gnu.so and libghostty-aarch64-linux-gnu.so, properly linked against glibc.

Added

• ARGB color accessors: Cell.backgroundArgb and Cell.foregroundArgb return resolved colors as packed 32-bit ARGB ints, or null if unset. Callers handle the default themselves.
• RgbColor.toArgb32: convert an RgbColor to a packed 32-bit ARGB int with full opacity.
• Cell.graphemeLength: number of codepoints in the cell's grapheme cluster (0 for empty cells).

Changed

• Cell hot path: codepoint and wide are cached during row iteration to eliminate per-access FFI calls in the renderer hot loop.
• Row hot path: the raw row pointer is cached and invalidated when the iterator advances to a new row.

Fixed

• VS16 emoji width: multi-codepoint graphemes are no longer misclassified as narrow based on their first codepoint. The wide-cell fast path now only applies to single-codepoint cells, so an emoji base followed by VS16 is correctly marked wide.
• Wide-codepoint heuristic: replaced the hand-rolled Unicode range table in the wide-cell fast path with a single >= U+1100 check. The old table could mark some wide CJK codepoints as narrow without consulting the FFI width query.

Added

• Clipboard writes: TerminalController.onClipboardWrite forwards atomic,
  binary-safe OSC 52 and iTerm2 clipboard requests so applications can apply
  their own platform and security policies. If the callback throws, the
  initiating write finishes terminal processing before rethrowing the error.
• Idle scrollback compression: attached terminal views schedule bounded
  compression after terminal and viewport activity settles, reducing retained
  scrollback memory without competing with rendering.

Changed

• Kitty graphics caching: unchanged placement snapshots are reused across
  frames, while image generations invalidate cached images and stale pending
  decodes. This avoids repeated traversal, sorting, and eviction work without
  displaying stale image data.
• Color behavior: ColorPalette.generated() uses libghostty palette
  generation, and terminal color-scheme reports use perceived background
  luminance.
• Published package contents: tests, benchmark tooling, generated API
  documentation, build outputs, and coverage data are excluded.

Fixed

• IME preedit layout: ZWJ emoji, skin-tone emoji sequences, combining
  marks, and variation selectors are measured as grapheme clusters using
  libghostty's terminal width rules.
• Viewport scrolling: scroll-controller pixel offsets map to absolute
  terminal rows regardless of the current viewport position.
• Windows text input: platform text input binds to the TerminalView's
  owning Flutter view and reconnects when that view changes.

Breaking

• Selection APIs: selection is backed by libghostty. TerminalSelection
  and TerminalSelectionMode are removed, TerminalConfig.wordPattern
  moves to TerminalGestureSettings.wordBoundaries, and gesture toggles
  are explicit settings.

Added

• Terminal links: TerminalView.linkSettings detects OSC 8 links,
  text URLs, file paths, and custom regex links.
• Controller APIs: selectRange, hasSelection, pwd, and
  onPwdChanged expose selection and working-directory state.
• Glyph Protocol: TerminalConfig.glyphProtocol toggles Glyph Protocol
  APC handling.

Changed

• Rendering pipeline: selection, cursor viewport state, and cell metadata
  use refreshed libghostty render snapshots.

Breaking

• Flutter SDK floor: requires Dart 3.12 and Flutter 3.44.

Added

• IME composition: composing text appears at the terminal cursor
  and works with platform text input.
• Sprite glyph rendering: box drawing, block elements, Braille,
  Powerline, geometric shapes, and legacy computing glyphs render
  with built-in glyphs.
• Shared render caches: TerminalScope lets multiple terminal
  views share compatible rendering resources.
• APC buffer limits: TerminalConfig.apcBufferLimit controls how
  much APC payload data the terminal accepts.

Changed

• Rendering pipeline: terminal frames share rendering caches and do
  less repeated work between frames.

Fixed

• Keyboard input: shifted printable keys and IME editing produce
  the expected terminal text.
• Rendering accuracy: erased backgrounds, cursor shape, cell
  metrics, and sprite glyphs render more consistently.

Breaking

• Theme colors move into ColorPalette: TerminalTheme no longer
  takes background, foreground, and ansiColors directly. Build a
  ColorPalette once and pass it in, so palettes are something you
  can share, swap, or copyWith on their own.
• Cursor and selection colors can adapt to the cell under them: the
  color fields take DynamicColor? now. Use
  DynamicColor.cellForeground() / .cellBackground() to follow the
  cell, or DynamicColor.fixed(c) for the old static behavior.
• selectedText is a method: call controller.selectedText() for
  plain text, or pass a FormatterFormat to get VT or HTML for
  rich-clipboard copy.
• Bold no longer switches to the bright palette by default: expect
  slightly different bold colors; set boldIsBright: true to restore
  the old behavior.

Added

• Kitty graphics: programs that emit images (previewers, image
  viewers, some editors) render inside the widget. Cap the cache via
  TerminalConfig.kittyImageStorageLimit; zero disables.
• Transparent background: TerminalTheme.backgroundOpacity makes
  the default background translucent so the terminal can compose over
  a translucent window or other widgets. backgroundOpacityCells
  extends it to cells with their own bg color.
• More theme knobs: CursorTheme.text (glyph color under a block
  cursor), TerminalTheme.boldColor (forced bold color), and
  SelectionTheme.foreground (selected-glyph tint).
• ColorPalette.generated(): derives indices 16–255 from your base
  16 plus background and foreground so the extended palette blends
  instead of clashing with the fixed xterm cube.

Changed

• Dirty-row rendering: frames rebuild only rows that changed, so
  idle terminals cost much less CPU.

Initial Release

• TerminalView: Flutter widget that renders a terminal and adapts input to the host. Mouse and keyboard on desktop, touch and soft keyboard on mobile, both on web.
• TerminalController: owns the terminal and bridges it with the view. Connects to a backend (PTY, SSH, socket) via onOutput, onResize, onBell, and onTitleChanged. Exposes I/O, selection, focus, scrolling, paste, clear, and mode toggling.
• Themes: ANSI 16, 256-color, and truecolor palettes; cursor shape, color, and blink; hyperlink style; font family, size, and fallback; minimum contrast. Immutable and lerp-able.
• Wide characters: CJK, color emoji, VS16, and combining marks render correctly; selection snaps to whole cells.
• Mouse selection: drag, double-click word, triple-click line, and Alt+drag block.
• Shortcuts: built-in copy, paste, select all, and clear with platform-aware defaults.
• OSC 8 hyperlinks: idle and highlighted styles with click hit-testing.
• Cross-platform: Android, iOS, Linux, macOS, Web (WASM), Windows.

• Fix release artifact filenames and download URLs

• Add release automation with build and release workflows
• Add download_asset_hashes.dart script for preparing releases

• Initial pre-release