This release has an MSRV of 1.83.

Highlights

#448 by @taj-p and #449 by @nicoburns collectively fix a significant performance bug that occurred when laying out large paragraphs of text. Previously the time to perform layout was non-linear with respect to the input size and laying out paragraphs of text with more than ~1k characters was very slow.

The new TextWrapMode style implements the semantics of the text-wrap-mode CSS property and allows text-wrapping to be disabled completely for a span of text.

Migration

Some modules have been moved:

• parley::editor and parley::layout::editor are now parley::editing.
• parley::layout::cursor is now parley::cursor.

Fontique no longer sets the dlopen feature of yeslogic-fontconfig-sys by default. If you wish to run Fontique on a Linux system without fontconfig installed then you will need to enable the new fontconfig-dlopen feature of the fontique crate. If you wish to compile Fontique on a Linux system without the fontconfig-dlopen enabled then you will need the fontconfig dev package (e.g. libfontconfig1-dev on Ubuntu) installed.

Added

Parley

• Add TextWrapMode style. This allow line wrapping to be disabled completely for a span of text (excluding explicit line breaks). (#367 by @nicoburns)
• Add Cluster::from_point_exact method for hit-testing spans of text. This is useful for implementing "hover" or "click" functionality. (#447 by @nicoburns)

Changed

Parley

• Split off various modules into "editing" folder. (#440 by @PoignardAzur)
• Split contents of layout/mod.rs file. (#444 by @PoignardAzur)

Fontique

• Make the yeslogic-fontconfig-sys/dlopen feature optional. #467 by @ogoffart)

Fixed

Parley

• Running line height calculation. (#448 by @taj-p)
• Optimise line height computation. (#449 by @nicoburns)
• Add word and letter spacing to text layout based on style properties. (#468 by @dolsup)
• Hang trailing whitespace preceding explicit newline. (#276 by @wfdewith)

Fontique

• Fix build on platforms without 64bit atomics. (#451 by @nicoburns)

New Contributors

• @dolsup made their first contribution in #468
• @ogoffart made their first contribution in #467
• @PoignardAzur made their first contribution in #440

Full Changelog: v0.6.0...v0.7.0

This release has an MSRV of 1.82.

Highlights

Parley now uses HarfRust rather than Swash. This means that Parley now has production-quality shaping for all scripts and can be recommended for general usage.

Migration

As Parley now uses it's own parley::BoundingBox in place of kurbo::Rect, you may need to convert the type if you were previously passing one of these values into a function that expects kurbo::Rect. The following function may be used to perform this conversion:

fn bounding_box_to_rect(bb: parley::BoundingBox) -> kurbo::Rect { kurbo::Rect::new(bb.x0, bb.y0, bb.x1, bb.y1) }

Added

Parley

• Shift-click support through Selection::shift_click_extension and PlainEditorDriver::shift_click_extension. (#385 by @kekelp)
• Add some benchmarks using Tango. (#405 by @taj-p)

Fontique

• Cache character mapping metadata for each font to improve performance of font selection. (#413 by @dfrg)
• Upgrade icu4x dependencies to v2.x. (#418 by @nicoburns)
• Added an unregister_font method to remove a font from a collection. (#395 by @taj-p)

Changed

Parley

• Breaking change: Alignment variants have been renamed to better match CSS. Alignment::Justified is now Alignment::Justify and Alignment::Middle is now Alignment::Center. (#389 by @waywardmonkeys)
• In the PlainEditor, triple-click now selects paragraphs rather than words (#381 by @DJMcNab)
• Updated to accesskit 0.21. (#390 by @mwcampbell)
• Uses HarfRust for text shaping. (#400 by @taj-p)
• Parley no longer depends on peniko or kurbo. (#414 by @nicoburns):
  • Breaking change: The use of peniko::Font has been replaced with linebender_resource_handle::FontData, as such parley::Font is now called Parley::FontData.
    Note that this is the same type as in previous releases, and so is fully backwards-compatible, just with a different name.
  • Breaking change: The use of kurbo::Rect has been replaced with a new parley::BoundingBox type.

Fontique

• The fontconfig backend, used to enumerate system fonts on Linux, has been rewritten to call into the system's fontconfig library instead of parsing fontconfig's configuration files itself. This should significantly improve the behavior of system fonts and generic families on Linux. (#378 by @valadaptive)
• Fontique no longer depends on peniko. The use of peniko::Blob has been replaced with linebender_resource_handle::Blob. This is unlikely to affect users of the crate. (#414 by @nicoburns)

Fixed

Parley

• Selection extension moves the focus to the side being extended. (#385 by @kekelp)
• Ranged builder default style not respecting scale. (#368 by @xStrom)
• Cluster source character not correct. (#402 by @taj-p)
• Don't justify the last line of a paragraph. (#410 by @taj-p)

Fontique

• Font family name aliases (secondary names for font families, often in another language) not being registered. (#380 by @valadaptive)

New Contributors

• @kekelp made their first contribution in #385
• @taj-p made their first contribution in #395

Full Changelog: v0.5.0...v0.6.0

This release has an MSRV of 1.82.

Added

Parley

• Editor features required by Android IME. (#334 by @mwcampbell)

Changed

Parley

• Breaking change: Layout::min_content_width, Layout::max_content_width, and Layout::content_widths have been replaced with Layout::calculate_content_widths, which does not internally cache the widths. This means that Layout is now Sync again, but callers will have to cache the min and max content widths themselves. (#353 by @valadaptive)
• Breaking change: the line height style property (StyleProperty::LineHeight and the line_height field on TextStyle) is now a LineHeight enum that allows you to specify absolute, font-size-relative, and font-metrics-relative line heights.
  Previously, it was always font-size-relative. (#362 by @valadaptive)
  • The default line height was previously LineHeight::FontSizeRelative(1.0) if you used RangedStyleBuilder, or LineHeight::FontSizeRelative(1.2) if you used TreeStyleBuilder.
    It is now LineHeight::MetricsRelative(1.0) in both cases.
    This will affect layout if you don't specify your own line height.
• Breaking change: {RangedBuilder, TreeBuilder}::{build_into, build} methods now consume self. (#369 by @dhardy)

New Contributors

• @dhardy made their first contribution in #361

Full Changelog: v0.4.0...v0.5.0

This release has an MSRV of 1.82.

Migration

Quantization of vertical layout metrics is now optional.
For an easy upgrade we recommend enabling it by setting quantize to true when calling LayoutContext::ranged_builder or LayoutContext::tree_builder.

Added

Parley

• Option to skip quantization of vertical layout metrics for advanced rendering use cases. (#297 by @valadaptive, #344 by @xStrom)
• The WordBreak and OverflowWrap style properties for controlling line wrapping. (#315 by @valadaptive)
• PlainEditor methods raw_selection and raw_text. (#316, #317 by @mwcampbell)
• PlainEditor::selection_geometry_with, the equivalent of Selection::geometry_with method. (#318 by @valadaptive)
• BreakLines::is_done method to check if all the text has been placed into lines. (#319 by @valadaptive)

Changed

Parley

• Breaking change: Selection::geometry, Selection::geometry_with, and PlainEditor::selection_geometry now include the line indices that the selection rectangles belong to. (#318 by @valadaptive)
• Updated to accesskit 0.19. (#294 by @waywardmonkeys, #348 by @xStrom)
• Now displaying selected newlines as whitespace in the selection highlight. (#296 by @valadaptive)
• Made BreakReason public. (#300 by @valadaptive)

Fontique

• Breaking change: Collection::register_fonts now takes a Blob<u8> instead of a Vec<u8>. (#306 by @valadaptive)
• Breaking change: Collection::register_fonts now takes an optional second parameter which allows overriding the metadata used for matching the font. (#312 by @valadaptive)

Fixed

Parley

• Text editing for layouts which contain inline boxes. (#299 by @valadaptive)
• Cursor navigation in RTL text sometimes getting stuck within a line. (#331 by @valadaptive)
• Using Layout::align on an aligned layout without breaking lines again. (#342 by @xStrom)
• Selection box height going below ascent + descent with small line heights. (#344 by @xStrom)
• Rounding error accumulation of vertical layout metrics. (#344 by @xStrom)

Fontique

• Panic on macOS when running in debug mode. (#335 by @NoahR02)

New Contributors

• @valadaptive made their first contribution in #300
• @NoahR02 made their first contribution in #335

Full Changelog: v0.3.0...v0.4.0

The time has come to release v0.3.0 of Parley along with v0.3.0 of Fontique.

AccessKit integration, Cursor redesign, and significant changes to PlainEditor are some of the highlights.

This release has an MSRV of 1.82.

For more details check out the changelog.

With growing community effort, we have reached v0.2.0 of Parley!

This release also conincides with the release of v0.2.0 of Fontique.

This release has an MSRV of 1.75.

This remains alpha-quality software. There are plenty of issues, known and unknown, and we look forward to further development.

Added

Parley

• Example using tiny-skia which renders into a png (#55 by @nicoburns)
  • Breaking change: There is now a blanket implementation for Brush.
• A swash example which renders into a png (#54 by @nicoburns)
• An example with Vello on Winit which shows a basic text editor (#106 by @dfrg)
• PlainEditor, a basic action-based text editor based on Parley Selection and Cursor (#126 by @xorgy)
• Tree style builder (#76 by @nicoburns)
• Conversions for FontFamily, FontStack, and StyleProperty to make styling more ergonomic (#129 by @xorgy)

Changed

General

• Repository layout updated to match Linebender standard (#59 by @waywardmonkeys)

Parley

• Emoji clusters now get an Emoji family added by default (#56 by @dfrg)
• Style builders now accept Into<StyleProperty<'a, B: Brush>> so you can push a GenericFamily or FontStack directly. (#129 by @xorgy)

Fontique

• Removed unsafe code from fontconfig cache (#78 by @waywardmonkeys)
• Switched to windows-rs for dwrite backend (#85 by @dfrg)

Fixed

Fontique

• Search correct paths for fonts on Apple platforms (#71 by @waywardmonkeys)

Removed

Fontique

• Breaking change: removed conversion to/from icu_properties::Script for fontique::Script (#72 by @waywardmonkeys)
  • This can be restored by using the icu_properties feature of fontique.

Full Changelog: v0.1.0...v0.2.0

We are proud to announce that after years of development we have released v0.1.0 of Parley!

This release also conincides with the release of v0.1.0 of Fontique.

These are alpha-quality software. There are plenty of known and unknown issues, and we expect to continue very active development.