Mirror PageView allowImplicitScrolling and Text textScaleFactor

Document in the README which Flutter parameters are represented
elsewhere or cannot be JSON.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A67XoQYsLVvoMtiKcXXUxY

Author: claude

CHANGELOG.md

@@ -43,7 +43,8 @@
   - `MaterialLoadingIndicatorProperties.strokeAlign`, `trackGap`
   - `ExpansionTileProperties.showTrailingIcon`, `shape`, `collapsedShape`,
     `cornerRadius`
-  - `TextMixin.softWrap`
+  - `TextMixin.softWrap`, `textScaleFactor`
+  - `PageViewProperties.allowImplicitScrolling`
 - Document the Flutter replacements for deprecated `cacheExtent`
   (`scrollCacheExtent`) and `Radio.groupValue` (`RadioGroup`).
 - New nodes use Material 3 defaults: switches use Material 3, buttons are

README.md

@@ -116,6 +116,23 @@ or image texture.
   opacity (`opacity`), among others. Depending on the type of paint, it might have properties like color (`color`),
   gradient transform (`gradientTransform`), gradient stops (`gradientStops`), or image transform (`imageTransform`).
 
+### Flutter parity
+
+Models track the Flutter release this version supports (3.47). A Flutter
+parameter is left out when it cannot be data or is already expressed
+elsewhere:
+
+| Flutter parameter | Represented by |
+|---|---|
+| Size and padding parameters such as `ButtonStyle.minimumSize`/`fixedSize`, `InputDecoration.contentPadding` and `TabBar.padding` | The node's own box and `padding` |
+| `ScrollView.clipBehavior` and similar clip parameters | `ClipMixin.clipsContent` |
+| Callbacks and widgets, such as `itemExtentBuilder` and `prototypeItem` | Not representable as JSON; use `itemExtent` |
+| `Icon.fill`/`weight`/`grade`/`opticalSize` | Pending Material Symbols support in the SDK, which renders icons as SVGs |
+
+Defaults follow Material 3. Where a default changed from an earlier
+version, the old value still applies to JSON that omits the key (see
+`JsonLegacyDefault`), so saved designs keep their look.
+
 ## Contributing
 
 Contributions are welcome! Please open an issue to start a discussion.

lib/src/api/nodes/page_view_node.dart

@@ -137,6 +137,10 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
   /// The fraction of the viewport that each page should occupy.
   double viewportFraction;
 
+  /// Whether to lay out the pages next to the visible one, so accessibility
+  /// focus can move to them. Mirrors `PageView.allowImplicitScrolling`.
+  bool allowImplicitScrolling;
+
   /// Creates a [PageViewProperties].
   PageViewProperties({
     this.itemCount,
@@ -145,6 +149,7 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
     this.keepPage = true,
     this.initialPage = 0,
     this.viewportFraction = 1,
+    this.allowImplicitScrolling = false,
   });
 
   /// Creates a [PageViewProperties] from a JSON object.
@@ -155,6 +160,7 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
     bool? keepPage,
     int? initialPage,
     double? viewportFraction,
+    bool? allowImplicitScrolling,
   }) {
     return PageViewProperties(
       itemCount: itemCount ?? this.itemCount,
@@ -163,6 +169,8 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
       keepPage: keepPage ?? this.keepPage,
       initialPage: initialPage ?? this.initialPage,
       viewportFraction: viewportFraction ?? this.viewportFraction,
+      allowImplicitScrolling:
+          allowImplicitScrolling ?? this.allowImplicitScrolling,
     );
   }
 
@@ -195,6 +203,12 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
       (value) => viewportFraction = value,
       requiresLayout: true,
     ),
+    'allowImplicitScrolling': BoolFieldAccess(
+      'Allow Implicit Scrolling',
+      'Whether to lay out the pages next to the visible one.',
+      () => allowImplicitScrolling,
+      (value) => allowImplicitScrolling = value,
+    ),
   };
 
   @override
@@ -205,6 +219,7 @@ class PageViewProperties extends CustomProperties with FieldsHolder {
     keepPage,
     initialPage,
     viewportFraction,
+    allowImplicitScrolling,
   ];
 
   @override

lib/src/api/nodes/page_view_node.g.dart

@@ -112,6 +112,7 @@ class TextNode extends SceneNode with BlendMixin, TextMixin, FontMixin {
     int? maxLines,
     TextOverflowC overflow = TextOverflowC.clip,
     bool softWrap = true,
+    double? textScaleFactor,
     // [BlendMixin] properties.
     double opacity = 1.0,
     bool isMask = false,
@@ -131,6 +132,7 @@ class TextNode extends SceneNode with BlendMixin, TextMixin, FontMixin {
       maxLines: maxLines,
       overflow: overflow,
       softWrap: softWrap,
+      textScaleFactor: textScaleFactor,
     );
 
     setBlendMixin(
@@ -196,6 +198,10 @@ mixin TextMixin {
   /// as if there were unlimited horizontal space. Mirrors `Text.softWrap`.
   late bool softWrap;
 
+  /// Factor by which to scale the font size, on top of the platform's text
+  /// scaling. Mirrors `Text.textScaler` as `TextScaler.linear`.
+  late double? textScaleFactor;
+
   /// Set text properties.
   void setTextMixin({
     required String characters,
@@ -207,6 +213,7 @@ mixin TextMixin {
     required TextOverflowC overflow,
     int? maxLines,
     bool softWrap = true,
+    double? textScaleFactor,
   }) {
     this.characters = characters;
     this.textMixedProps = textMixedProps;
@@ -217,6 +224,7 @@ mixin TextMixin {
     this.maxLines = maxLines;
     this.overflow = overflow;
     this.softWrap = softWrap;
+    this.textScaleFactor = textScaleFactor;
   }
 }
 

lib/src/api/nodes/text_node.dart

@@ -248,6 +248,17 @@ void main() {
       expect(TextNode.fromJson(text(false).toJson()).softWrap, isFalse);
     });
 
+    test('PageViewProperties.allowImplicitScrolling', () {
+      expect(
+        PageViewProperties().toJson(),
+        isNot(contains('allowImplicitScrolling')),
+      );
+      final copy = PageViewProperties.fromJson(
+        PageViewProperties(allowImplicitScrolling: true).toJson(),
+      );
+      expect(copy.allowImplicitScrolling, isTrue);
+    });
+
     test('4.4.0 nodes keep their Material 2 look', () {
       final fab = FloatingActionButtonProperties.fromJson({});
       expect(fab.shape, CShapeBorder.circle);