auto-submit · Oct 3, 2026 · Apr 16, 2026 · Jul 9, 2026 · Jul 9, 2026 · Jul 10, 2026
diff --git a/engine/src/flutter/lib/ui/text.dart b/engine/src/flutter/lib/ui/text.dart
@@ -1327,6 +1327,20 @@ enum TextAlign {
   end,
 }
 
+/// The behavior of soft hyphens (U+00AD) at a line break.
+///
+/// This does not change where lines break, since Flutter always treats U+00AD
+/// as a line-break opportunity.
+enum Hyphens {
+  /// A hyphen glyph is rendered at the end of a line that breaks on a soft
+  /// hyphen (U+00AD). Soft hyphens elsewhere remain invisible.
+  manual,
+
+  /// No hyphen glyph is rendered for soft hyphens. The line still breaks at
+  /// U+00AD; only the glyph is suppressed.
+  hidden,
+}
+
 /// A horizontal line used for aligning text.
 enum TextBaseline {
   /// The horizontal line used to align the bottom of glyphs for alphabetic characters.
@@ -1937,6 +1951,8 @@ class TextStyle {
 //
 //  - Element 6: The encoded value of |textHeightBehavior|, except its leading
 //    distribution.
+//
+//  - Element 7: The enum index of the |hyphens|.
 Int32List _encodeParagraphStyle(
   TextAlign? textAlign,
   TextDirection? textDirection,
@@ -1950,8 +1966,9 @@ Int32List _encodeParagraphStyle(
   StrutStyle? strutStyle,
   String? ellipsis,
   Locale? locale,
+  Hyphens? hyphens,
 ) {
-  final result = Int32List(7); // also update paragraph_builder.cc
+  final result = Int32List(8); // also update paragraph_builder.cc
   if (textAlign != null) {
     result[0] |= 1 << 1;
     result[1] = textAlign.index;
@@ -2002,6 +2019,10 @@ Int32List _encodeParagraphStyle(
     result[0] |= 1 << 12;
     // Passed separately to native.
   }
+  if (hyphens != null) {
+    result[0] |= 1 << 13;
+    result[7] = hyphens.index;
+  }
   return result;
 }
 
@@ -2068,6 +2089,9 @@ class ParagraphStyle {
   ///   considered equivalent and turn off this behavior.
   ///
   /// * `locale`: The locale used to select region-specific glyphs.
+  ///
+  /// * `hyphens`: Whether to render a hyphen glyph for soft hyphens (U+00AD)
+  ///   that fall at a line break. Defaults to [Hyphens.manual].
   ParagraphStyle({
     TextAlign? textAlign,
     TextDirection? textDirection,
@@ -2081,6 +2105,7 @@ class ParagraphStyle {
     StrutStyle? strutStyle,
     String? ellipsis,
     Locale? locale,
+    Hyphens? hyphens,
   }) : _encoded = _encodeParagraphStyle(
          textAlign,
          textDirection,
@@ -2094,6 +2119,7 @@ class ParagraphStyle {
          strutStyle,
          ellipsis,
          locale,
+         hyphens,
        ),
        _fontFamily = fontFamily,
        _fontSize = fontSize,
@@ -2157,7 +2183,8 @@ class ParagraphStyle {
         'height: ${_encoded[0] & 0x200 == 0x200 ? "${_height}x" : "unspecified"}, '
         'strutStyle: ${_encoded[0] & 0x400 == 0x400 ? _strutStyle : "unspecified"}, '
         'ellipsis: ${_encoded[0] & 0x800 == 0x800 ? '"$_ellipsis"' : "unspecified"}, '
-        'locale: ${_encoded[0] & 0x1000 == 0x1000 ? _locale : "unspecified"}'
+        'locale: ${_encoded[0] & 0x1000 == 0x1000 ? _locale : "unspecified"}, '
+        'hyphens: ${_encoded[0] & 0x2000 == 0x2000 ? Hyphens.values[_encoded[7]] : "unspecified"}'
         ')';
   }
 }

diff --git a/engine/src/flutter/lib/ui/text/paragraph_builder.cc b/engine/src/flutter/lib/ui/text/paragraph_builder.cc
@@ -90,6 +90,11 @@ const int kPSHeightIndex = 9;
 const int kPSStrutStyleIndex = 10;
 const int kPSEllipsisIndex = 11;
 const int kPSLocaleIndex = 12;
+// render_soft_hyphens is the first field whose mask bit and encode slot differ:
+// it claims the next free mask bit (13), but stores its value in the next free
+// encode slot (7), since slots 7-12 are reused only as mask-bit positions.
+const int kPSRenderSoftHyphensIndex = 13;
+const int kPSRenderSoftHyphensEncodeIndex = 7;
 
 const int kPSTextAlignMask = 1 << kPSTextAlignIndex;
 const int kPSTextDirectionMask = 1 << kPSTextDirectionIndex;
@@ -103,6 +108,7 @@ const int kPSTextHeightBehaviorMask = 1 << kPSTextHeightBehaviorIndex;
 const int kPSStrutStyleMask = 1 << kPSStrutStyleIndex;
 const int kPSEllipsisMask = 1 << kPSEllipsisIndex;
 const int kPSLocaleMask = 1 << kPSLocaleIndex;
+const int kPSRenderSoftHyphensMask = 1 << kPSRenderSoftHyphensIndex;
 
 // TextShadows decoding
 
@@ -273,6 +279,12 @@ ParagraphBuilder::ParagraphBuilder(
     if (mask & kPSMaxLinesMask) {
       style.max_lines = encoded[kPSMaxLinesIndex];
     }
+
+    if (mask & kPSRenderSoftHyphensMask) {
+      // Hyphens.manual (0) renders the soft hyphen glyph; Hyphens.hidden (1)
+      // suppresses it.
+      style.render_soft_hyphens = encoded[kPSRenderSoftHyphensEncodeIndex] == 0;
+    }
   }
 
   if (mask & kPSStrutStyleMask) {

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/canvaskit/renderer.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/canvaskit/renderer.dart
@@ -412,6 +412,7 @@ class CanvasKitRenderer extends Renderer {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   }) => isWebParagraphEnabled
       ? WebParagraphStyle(
           textAlign: textAlign,
@@ -426,6 +427,7 @@ class CanvasKitRenderer extends Renderer {
           strutStyle: strutStyle as WebStrutStyle?,
           ellipsis: ellipsis,
           locale: locale,
+          hyphens: hyphens,
         )
       : CkParagraphStyle(
           textAlign: textAlign,
@@ -440,6 +442,7 @@ class CanvasKitRenderer extends Renderer {
           strutStyle: strutStyle,
           ellipsis: ellipsis,
           locale: locale,
+          hyphens: hyphens,
         );
 
   @override

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/canvaskit/text.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/canvaskit/text.dart
@@ -33,6 +33,7 @@ class CkParagraphStyle implements ui.ParagraphStyle {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   }) : skParagraphStyle = toSkParagraphStyle(
          textAlign,
          textDirection,
@@ -59,7 +60,8 @@ class CkParagraphStyle implements ui.ParagraphStyle {
        _textHeightBehavior = textHeightBehavior,
        _strutStyle = strutStyle,
        _ellipsis = ellipsis,
-       _locale = locale;
+       _locale = locale,
+       _hyphens = hyphens;
 
   final SkParagraphStyle skParagraphStyle;
 
@@ -76,6 +78,14 @@ class CkParagraphStyle implements ui.ParagraphStyle {
   final ui.StrutStyle? _strutStyle;
   final String? _ellipsis;
   final ui.Locale? _locale;
+  // TODO(dbebawy): hyphens is accepted and stored but not honored here yet.
+  // Neither Hyphens.manual nor Hyphens.hidden takes effect on CanvasKit until a
+  // renderSoftHyphens setter is exposed on the CanvasKit ParagraphStyle binding
+  // (the native engine wires this via SkParagraph::setRenderSoftHyphens).
+  // https://github.com/flutter/flutter/issues/193506
+  // Customizing the hyphen string is separate future work:
+  // https://github.com/flutter/flutter/issues/189617
+  final ui.Hyphens? _hyphens;
 
   static SkTextStyleProperties toSkTextStyleProperties(
     String? fontFamily,
@@ -263,7 +273,8 @@ class CkParagraphStyle implements ui.ParagraphStyle {
         other._textHeightBehavior == _textHeightBehavior &&
         other._strutStyle == _strutStyle &&
         other._ellipsis == _ellipsis &&
-        other._locale == _locale;
+        other._locale == _locale &&
+        other._hyphens == _hyphens;
   }
 
   @override
@@ -282,6 +293,7 @@ class CkParagraphStyle implements ui.ParagraphStyle {
       _strutStyle,
       _ellipsis,
       _locale,
+      _hyphens,
     );
   }
 
@@ -304,7 +316,8 @@ class CkParagraphStyle implements ui.ParagraphStyle {
           'height: ${height != null ? "${height.toStringAsFixed(1)}x" : "unspecified"}, '
           'strutStyle: ${_strutStyle ?? "unspecified"}, '
           'ellipsis: ${_ellipsis != null ? '"$_ellipsis"' : "unspecified"}, '
-          'locale: ${_locale ?? "unspecified"}'
+          'locale: ${_locale ?? "unspecified"}, '
+          'hyphens: ${_hyphens ?? "unspecified"}'
           ')';
       return true;
     }());

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/renderer.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/renderer.dart
@@ -389,6 +389,7 @@ abstract class Renderer {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   });
 
   ui.StrutStyle createStrutStyle({

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_impl/paragraph.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_impl/paragraph.dart
@@ -726,6 +726,7 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   }) : _textAlign = textAlign,
        _textDirection = textDirection,
        _maxLines = maxLines,
@@ -737,7 +738,8 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
        _fontStyle = fontStyle,
        _strutStyle = strutStyle,
        _ellipsis = ellipsis,
-       _locale = locale;
+       _locale = locale,
+       _hyphens = hyphens;
 
   (ParagraphStyleHandle, SkwasmNativeTextStyle) createNative() {
     final ParagraphStyleHandle handle = paragraphStyleCreate();
@@ -835,6 +837,14 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
   final ui.StrutStyle? _strutStyle;
   final String? _ellipsis;
   final ui.Locale? _locale;
+  // TODO(dbebawy): hyphens is accepted and stored but not honored here yet.
+  // Neither Hyphens.manual nor Hyphens.hidden takes effect on Skwasm until a
+  // renderSoftHyphens setter is exposed on the Skwasm ParagraphStyle binding
+  // (the native engine wires this via SkParagraph::setRenderSoftHyphens).
+  // https://github.com/flutter/flutter/issues/193506
+  // Customizing the hyphen string is separate future work:
+  // https://github.com/flutter/flutter/issues/189617
+  final ui.Hyphens? _hyphens;
 
   @override
   bool operator ==(Object other) {
@@ -856,7 +866,8 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
         other._textHeightBehavior == _textHeightBehavior &&
         other._strutStyle == _strutStyle &&
         other._ellipsis == _ellipsis &&
-        other._locale == _locale;
+        other._locale == _locale &&
+        other._hyphens == _hyphens;
   }
 
   @override
@@ -874,6 +885,7 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
       _strutStyle,
       _ellipsis,
       _locale,
+      _hyphens,
     );
   }
 
@@ -896,7 +908,8 @@ class SkwasmParagraphStyle implements ui.ParagraphStyle {
           'height: ${height != null ? "${height.toStringAsFixed(1)}x" : "unspecified"}, '
           'strutStyle: ${_strutStyle ?? "unspecified"}, '
           'ellipsis: ${_ellipsis != null ? '"$_ellipsis"' : "unspecified"}, '
-          'locale: ${_locale ?? "unspecified"}'
+          'locale: ${_locale ?? "unspecified"}, '
+          'hyphens: ${_hyphens ?? "unspecified"}'
           ')';
       return true;
     }());

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_impl/renderer.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_impl/renderer.dart
@@ -178,6 +178,7 @@ class SkwasmRenderer extends Renderer {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   }) => SkwasmParagraphStyle(
     textAlign: textAlign,
     textDirection: textDirection,
@@ -191,6 +192,7 @@ class SkwasmRenderer extends Renderer {
     strutStyle: strutStyle,
     ellipsis: ellipsis,
     locale: locale,
+    hyphens: hyphens,
   );
 
   @override

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_stub/renderer.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/skwasm/skwasm_stub/renderer.dart
@@ -162,6 +162,7 @@ class SkwasmRenderer extends Renderer {
     ui.StrutStyle? strutStyle,
     String? ellipsis,
     ui.Locale? locale,
+    ui.Hyphens? hyphens,
   }) {
     throw UnimplementedError('Skwasm not implemented on this platform.');
   }

diff --git a/engine/src/flutter/lib/web_ui/lib/src/engine/web_paragraph/paragraph.dart b/engine/src/flutter/lib/web_ui/lib/src/engine/web_paragraph/paragraph.dart
@@ -36,6 +36,7 @@ class WebParagraphStyle implements ui.ParagraphStyle {
     ui.Color? color,
     ui.StrutStyle? strutStyle,
     this.textHeightBehavior,
+    this.hyphens,
   }) : _strutStyle = strutStyle as WebStrutStyle?,
        _textStyle = WebTextStyle(
          fontFamily: fontFamily,
@@ -60,6 +61,11 @@ class WebParagraphStyle implements ui.ParagraphStyle {
 
   final ui.TextHeightBehavior? textHeightBehavior;
 
+  // TODO(dbebawy): honor hyphens in the pure-Dart line-breaker/painter (no
+  // soft-hyphen glyph emitted at a break yet). Accepted and stored for now.
+  // https://github.com/flutter/flutter/issues/193506
+  final ui.Hyphens? hyphens;
+
   WebStrutStyle? get strutStyle => _strutStyle;
   final WebStrutStyle? _strutStyle;
 
@@ -78,7 +84,8 @@ class WebParagraphStyle implements ui.ParagraphStyle {
         ellipsis == other.ellipsis &&
         textHeightBehavior == other.textHeightBehavior &&
         _strutStyle == other._strutStyle &&
-        _textStyle == other._textStyle;
+        _textStyle == other._textStyle &&
+        hyphens == other.hyphens;
   }
 
   @override
@@ -91,6 +98,7 @@ class WebParagraphStyle implements ui.ParagraphStyle {
       textHeightBehavior,
       _strutStyle,
       _textStyle,
+      hyphens,
     );
   }
 
@@ -105,6 +113,7 @@ class WebParagraphStyle implements ui.ParagraphStyle {
           'maxLines: $maxLines, '
           'ellipsis: $ellipsis, '
           'textHeightBehavior: $textHeightBehavior, '
+          'hyphens: $hyphens, '
           'strutStyle: $_strutStyle, '
           'textAlign: $textAlign'
           'textStyle: $_textStyle'

diff --git a/engine/src/flutter/lib/web_ui/lib/text.dart b/engine/src/flutter/lib/web_ui/lib/text.dart
@@ -381,6 +381,7 @@ abstract class ParagraphStyle {
     StrutStyle? strutStyle,
     String? ellipsis,
     Locale? locale,
+    Hyphens? hyphens,
   }) => engine.renderer.createParagraphStyle(
     textAlign: textAlign,
     textDirection: textDirection,
@@ -394,6 +395,7 @@ abstract class ParagraphStyle {
     strutStyle: strutStyle,
     ellipsis: ellipsis,
     locale: locale,
+    hyphens: hyphens,
   );
 }
 
@@ -459,6 +461,9 @@ abstract class StrutStyle {
 // The order of this enum must match the order of the values in TextDirection.h's TextDirection.
 enum TextDirection { rtl, ltr }
 
+/// The behavior of soft hyphens (U+00AD) at a line break.
+enum Hyphens { manual, hidden }
+
 class TextBox {
   const TextBox.fromLTRBD(this.left, this.top, this.right, this.bottom, this.direction);
   final double left;