.
diff --git a/README.md b/README.md
index c0381c4..ed67ed6 100644
--- a/README.md
+++ b/README.md
@@ -354,6 +354,34 @@ This project is licensed under the [LICENSE](LICENSE) file in the repository.
+ |
+ Rujin Devkota
+
+ 
+
+
+
+ 
+
+
+ 
+
+
+ |
+
+ Adhavan K
+
+ 
+
+
+
+
+
+
+
+
+
+ |
diff --git a/SDUI_Flutter_Integration_Guide.txt b/SDUI_Flutter_Integration_Guide.txt
deleted file mode 100644
index 0519ecb..0000000
--- a/SDUI_Flutter_Integration_Guide.txt
+++ /dev/null
@@ -1 +0,0 @@
-
\ No newline at end of file
diff --git a/docs/doc.md b/doc/doc.md
similarity index 100%
rename from docs/doc.md
rename to doc/doc.md
diff --git a/example/grpc_example.dart b/example/grpc_example.dart
index f0b699d..740f2eb 100644
--- a/example/grpc_example.dart
+++ b/example/grpc_example.dart
@@ -1,10 +1,18 @@
import 'package:flutter/material.dart';
import 'package:flutter_sdui/flutter_sdui.dart';
+/// Example application demonstrating Flutter SDUI with gRPC.
+///
+/// This example shows how to:
+/// * Connect to a gRPC server
+/// * Fetch server-driven UI definitions
+/// * Render dynamic UI content
+/// * Handle different screen types
void main() {
runApp(const MyApp());
}
+/// Root application widget that sets up the Material theme and routing.
class MyApp extends StatelessWidget {
const MyApp({super.key});
@@ -21,6 +29,13 @@ class MyApp extends StatelessWidget {
}
}
+/// Demo widget that showcases the gRPC renderer functionality.
+///
+/// This widget demonstrates how to:
+/// * Initialize a gRPC client connection
+/// * Switch between different screen definitions
+/// * Handle loading and error states
+/// * Properly dispose of resources
class GrpcRendererDemo extends StatefulWidget {
const GrpcRendererDemo({super.key});
@@ -35,16 +50,16 @@ class _GrpcRendererDemoState extends State {
@override
void initState() {
super.initState();
- // Connect to your gRPC server
+ // Initialize gRPC client with server connection details
_grpcClient = SduiGrpcClient(
- host: 'localhost', // Replace with your server address
- port: 50051, // Replace with your server port
+ host: 'localhost',
+ port: 50051,
);
}
@override
void dispose() {
- // Close the gRPC connection when done
+ // Clean up gRPC connection
_grpcClient.dispose();
super.dispose();
}
@@ -57,7 +72,7 @@ class _GrpcRendererDemoState extends State {
),
body: Column(
children: [
- // Screen selector
+ // Screen selection controls
Padding(
padding: const EdgeInsets.all(8.0),
child: Row(
@@ -84,7 +99,7 @@ class _GrpcRendererDemoState extends State {
),
),
- // SDUI Renderer that fetches UI from gRPC server
+ // Server-driven UI renderer
Expanded(
child: SduiGrpcRenderer(
client: _grpcClient,
diff --git a/example/grpc_server_example_dart.dart b/example/grpc_server_example_dart.dart
index 4cec6f4..2cf54a3 100644
--- a/example/grpc_server_example_dart.dart
+++ b/example/grpc_server_example_dart.dart
@@ -1,9 +1,28 @@
-// Server implementation example (Dart)
-// Note: This is a standalone Dart server, not a Flutter application
-// Run with: dart run example/grpc_server_example.dart
+/// Example gRPC server implementation for Flutter SDUI.
+///
+/// This is a standalone Dart server that provides server-driven UI definitions
+/// through gRPC. It demonstrates how to:
+/// * Set up a gRPC server with SDUI service
+/// * Handle different screen requests
+/// * Create widget definitions using protobuf
+/// * Return complex UI structures
+///
+/// To run this server:
+/// ```bash
+/// dart run example/grpc_server_example_dart.dart
+/// ```
+///
+/// The server listens on port 50051 by default.
+library;
+import 'dart:developer';
+
import 'package:grpc/grpc.dart';
import 'package:flutter_sdui/src/generated/sdui.pbgrpc.dart';
+/// Entry point for the gRPC server.
+///
+/// Initializes the server with the SDUI service implementation
+/// and starts listening for client connections.
Future main() async {
final server = Server.create(
services: [
@@ -11,19 +30,22 @@ Future main() async {
],
);
- final port = 50051;
+ const port = 50051;
await server.serve(port: port);
- print('Server listening on port $port...');
- print('Press Ctrl+C to stop');
+ log('Server listening on port $port...');
+ log('Press Ctrl+C to stop');
}
-// Implementation of the SDUI service
+/// Implementation of the SDUI gRPC service.
+///
+/// This class handles incoming requests for UI definitions and returns
+/// appropriate widget data based on the requested screen ID.
class SduiServiceImpl extends SduiServiceBase {
@override
Future getSduiWidget(
ServiceCall call, SduiRequest request) async {
- // Based on the requested screen, return different UI definitions
- print('Received request for screen: ${request.screenId}');
+ log('Received request for screen: ${request.screenId}');
+
switch (request.screenId) {
case 'home':
return _createHomeScreen();
@@ -32,13 +54,14 @@ class SduiServiceImpl extends SduiServiceBase {
case 'settings':
return _createSettingsScreen();
default:
- // Default or error screen
- print('Warning: Unknown screen ID requested: ${request.screenId}');
+ log('Warning: Unknown screen ID requested: ${request.screenId}');
return _createErrorScreen();
}
}
- // Sample screen definitions
+ /// Creates the home screen UI definition.
+ ///
+ /// Returns a scaffold with an app bar and a column of welcome content.
SduiWidgetData _createHomeScreen() {
final homeScreen = SduiWidgetData()
..type = WidgetType.SCAFFOLD
diff --git a/lib/flutter_sdui.dart b/lib/flutter_sdui.dart
index a7e5442..5376a46 100644
--- a/lib/flutter_sdui.dart
+++ b/lib/flutter_sdui.dart
@@ -1,13 +1,34 @@
-/// Flutter SDUI Package
+/// Flutter Server-Driven UI Package
///
-/// A Flutter package to render server driven UI.
+/// A Flutter package that enables server-driven UI development by parsing
+/// protobuf-based widget definitions from a gRPC server and rendering them
+/// as native Flutter widgets.
+///
+/// This package provides:
+/// * Protobuf-based widget parsing and rendering
+/// * gRPC client for server communication
+/// * A comprehensive set of SDUI widgets that mirror Flutter's core widgets
+/// * Type-safe widget definitions through generated protobuf models
+///
+/// ## Usage
+///
+/// ```dart
+/// // Create a gRPC client
+/// final client = SduiGrpcClient(host: 'localhost', port: 50051);
+///
+/// // Render server-driven UI
+/// SduiGrpcRenderer(
+/// client: client,
+/// screenId: 'home',
+/// )
+/// ```
library;
-// Export the core parser and widget base
-export 'src/parser/sdui_proto_parser.dart'; // New proto parser
+// Core parsing and widget foundation
+export 'src/parser/sdui_proto_parser.dart';
export 'src/widgets/sdui_widget.dart';
-// Export individual widget models
+// SDUI widget implementations
export 'src/widgets/sdui_column.dart';
export 'src/widgets/sdui_row.dart';
export 'src/widgets/sdui_text.dart';
@@ -18,11 +39,11 @@ export 'src/widgets/sdui_scaffold.dart';
export 'src/widgets/sdui_spacer.dart';
export 'src/widgets/sdui_icon.dart';
-// Export gRPC client and renderer
+// Network communication
export 'src/service/sdui_grpc_client.dart';
export 'src/renderer/sdui_grpc_renderer.dart';
-// Export generated Protobuf models for public use
+// Generated protobuf models
export 'src/generated/sdui.pb.dart';
export 'src/generated/sdui.pbgrpc.dart';
export 'src/generated/sdui.pbenum.dart';
diff --git a/lib/src/parser/flutter_to_sdui.dart b/lib/src/parser/flutter_to_sdui.dart
index b3c23d2..8ed0903 100644
--- a/lib/src/parser/flutter_to_sdui.dart
+++ b/lib/src/parser/flutter_to_sdui.dart
@@ -50,7 +50,9 @@ SduiWidget flutterToSdui(Widget widget) {
width: widget.width,
height: widget.height,
fit: widget.fit,
- alignment: widget.alignment is Alignment ? widget.alignment as Alignment : null,
+ alignment: widget.alignment is Alignment
+ ? widget.alignment as Alignment
+ : null,
repeat: widget.repeat,
color: widget.color,
colorBlendMode: widget.colorBlendMode,
@@ -75,27 +77,40 @@ SduiWidget flutterToSdui(Widget widget) {
} else if (widget is Container) {
return SduiContainer(
child: widget.child != null ? flutterToSdui(widget.child!) : null,
- padding: widget.padding is EdgeInsets ? widget.padding as EdgeInsets : null,
+ padding:
+ widget.padding is EdgeInsets ? widget.padding as EdgeInsets : null,
margin: widget.margin is EdgeInsets ? widget.margin as EdgeInsets : null,
- decoration: widget.decoration is BoxDecoration ? widget.decoration as BoxDecoration : null,
+ decoration: widget.decoration is BoxDecoration
+ ? widget.decoration as BoxDecoration
+ : null,
width: null, // Container does not expose width directly
height: null, // Container does not expose height directly
color: widget.color,
- alignment: widget.alignment is Alignment ? widget.alignment as Alignment : null,
+ alignment:
+ widget.alignment is Alignment ? widget.alignment as Alignment : null,
constraints: widget.constraints,
transform: widget.transform,
- transformAlignment: widget.transformAlignment is AlignmentGeometry ? widget.transformAlignment as AlignmentGeometry : null,
+ transformAlignment: widget.transformAlignment is AlignmentGeometry
+ ? widget.transformAlignment as AlignmentGeometry
+ : null,
clipBehavior: widget.clipBehavior,
);
} else if (widget is Scaffold) {
return SduiScaffold(
appBar: widget.appBar != null ? flutterToSdui(widget.appBar!) : null,
body: widget.body != null ? flutterToSdui(widget.body!) : null,
- floatingActionButton: widget.floatingActionButton != null ? flutterToSdui(widget.floatingActionButton!) : null,
- bottomNavigationBar: widget.bottomNavigationBar != null ? flutterToSdui(widget.bottomNavigationBar!) : null,
+ floatingActionButton: widget.floatingActionButton != null
+ ? flutterToSdui(widget.floatingActionButton!)
+ : null,
+ bottomNavigationBar: widget.bottomNavigationBar != null
+ ? flutterToSdui(widget.bottomNavigationBar!)
+ : null,
drawer: widget.drawer != null ? flutterToSdui(widget.drawer!) : null,
- endDrawer: widget.endDrawer != null ? flutterToSdui(widget.endDrawer!) : null,
- bottomSheet: widget.bottomSheet != null ? flutterToSdui(widget.bottomSheet!) : null,
+ endDrawer:
+ widget.endDrawer != null ? flutterToSdui(widget.endDrawer!) : null,
+ bottomSheet: widget.bottomSheet != null
+ ? flutterToSdui(widget.bottomSheet!)
+ : null,
backgroundColor: widget.backgroundColor,
resizeToAvoidBottomInset: widget.resizeToAvoidBottomInset,
primary: widget.primary,
@@ -121,5 +136,6 @@ SduiWidget flutterToSdui(Widget widget) {
shadows: widget.shadows,
);
}
- throw UnimplementedError('Conversion for [38;5;9m${widget.runtimeType}[0m is not implemented');
-}
\ No newline at end of file
+ throw UnimplementedError(
+ 'Conversion for [38;5;9m${widget.runtimeType}[0m is not implemented');
+}
diff --git a/lib/src/parser/sdui_proto_parser.dart b/lib/src/parser/sdui_proto_parser.dart
index 64bbd10..ed34f5b 100644
--- a/lib/src/parser/sdui_proto_parser.dart
+++ b/lib/src/parser/sdui_proto_parser.dart
@@ -14,9 +14,26 @@ import 'package:flutter_sdui/src/widgets/sdui_spacer.dart';
import 'package:flutter_sdui/src/widgets/sdui_text.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-// Parser for Protobuf definitions for SDUI
+/// Parser for converting server-side widget definitions to SDUI widgets.
+///
+/// This class handles the conversion of protobuf-based widget definitions
+/// received from the server into corresponding SDUI widget instances that
+/// can be rendered in the Flutter application.
+///
+/// The parser supports various widget types and their properties, maintaining
+/// type safety through protobuf definitions while providing flexibility
+/// for server-driven UI updates.
class SduiParser {
- // Parse method for JSON data
+ /// Parses JSON data into SDUI widgets.
+ ///
+ /// This method is currently not implemented and will throw an
+ /// [UnimplementedError]. Future versions may support JSON-based
+ /// widget definitions as an alternative to protobuf.
+ ///
+ /// [data] - The JSON map containing widget definition
+ ///
+ /// Returns a parsed [SduiWidget] instance.
+ /// Throws [UnimplementedError] - JSON parsing is not yet supported.
static SduiWidget parseJSON(Map data) {
final String? type = data['type']?.toString().toLowerCase();
switch (type) {
@@ -43,7 +60,17 @@ class SduiParser {
}
}
- // Parse from Protobuf data model
+ /// Parses protobuf widget data into SDUI widgets.
+ ///
+ /// This is the main parsing method that converts server-provided protobuf
+ /// widget definitions into their corresponding SDUI widget instances.
+ /// The method uses a switch statement to determine the widget type and
+ /// delegates to specific parsing methods for each widget type.
+ ///
+ /// [data] - The protobuf widget data received from the server
+ ///
+ /// Returns a parsed [SduiWidget] instance, or [SduiContainer] if the
+ /// widget type is unsupported.
static SduiWidget parseProto(SduiWidgetData data) {
switch (data.type) {
case WidgetType.COLUMN:
@@ -70,9 +97,12 @@ class SduiParser {
}
}
- // Helper methods to parse specific widget types from protobuf
+ /// Parses protobuf data into a [SduiColumn] widget.
+ ///
+ /// Extracts all column-specific properties from the protobuf data
+ /// and recursively parses child widgets.
static SduiColumn _parseProtoColumn(SduiWidgetData data) {
- List children =
+ final List children =
data.children.map((child) => SduiParser.parseProto(child)).toList();
return SduiColumn(
@@ -87,8 +117,12 @@ class SduiParser {
);
}
+ /// Parses protobuf data into a [SduiRow] widget.
+ ///
+ /// Extracts all row-specific properties from the protobuf data
+ /// and recursively parses child widgets.
static SduiRow _parseProtoRow(SduiWidgetData data) {
- List children =
+ final List children =
data.children.map((child) => SduiParser.parseProto(child)).toList();
return SduiRow(
@@ -103,36 +137,52 @@ class SduiParser {
);
}
+ /// Parses protobuf data into a [SduiText] widget.
+ ///
+ /// Extracts text content and all styling properties from the protobuf data.
+ /// Text content is retrieved from the stringAttributes map, while styling
+ /// properties are parsed from individual fields.
static SduiText _parseProtoText(SduiWidgetData data) {
- String text = data.stringAttributes['text'] ?? '';
- TextStyle? style =
+ final String text = data.stringAttributes['text'] ?? '';
+ final TextStyle? style =
data.hasTextStyle() ? _parseProtoTextStyle(data.textStyle) : null;
- // Parse additional text properties
- TextAlign? textAlign = _parseProtoTextAlign(data.textAlign);
- TextOverflow? overflow = _parseProtoTextOverflow(data.overflow);
- int? maxLines = data.hasMaxLines() ? data.maxLines : null;
- bool? softWrap = data.hasSoftWrap() ? data.softWrap : null;
+ final TextAlign? textAlign = _parseProtoTextAlign(data.textAlign);
+ final TextOverflow? overflow = _parseProtoTextOverflow(data.overflow);
+ final int? maxLines = data.hasMaxLines() ? data.maxLines : null;
+ final bool? softWrap = data.hasSoftWrap() ? data.softWrap : null;
double? letterSpacing = data.hasLetterSpacing() ? data.letterSpacing : null;
double? wordSpacing = data.hasWordSpacing() ? data.wordSpacing : null;
double? height = data.hasHeight() ? data.height : null;
String? fontFamily = data.hasFontFamily() ? data.fontFamily : null;
- TextDirection? textDirection = _parseProtoTextDirection(data.textDirection);
+ final TextDirection? textDirection =
+ _parseProtoTextDirection(data.textDirection);
- // Extract from style if present
double? fontSize = style?.fontSize;
FontWeight? fontWeight = style?.fontWeight;
Color? color = style?.color;
TextDecoration? decoration = style?.decoration;
if (data.hasTextStyle()) {
if (data.textStyle.hasFontSize()) fontSize = data.textStyle.fontSize;
- if (data.textStyle.hasFontWeight()) fontWeight = _parseProtoFontWeight(data.textStyle.fontWeight);
- if (data.textStyle.hasColor()) color = _parseProtoColor(data.textStyle.color);
- if (data.textStyle.hasDecoration()) decoration = _parseProtoTextDecoration(data.textStyle.decoration);
- if (data.textStyle.hasLetterSpacing()) letterSpacing = data.textStyle.letterSpacing;
- if (data.textStyle.hasWordSpacing()) wordSpacing = data.textStyle.wordSpacing;
+ if (data.textStyle.hasFontWeight()) {
+ fontWeight = _parseProtoFontWeight(data.textStyle.fontWeight);
+ }
+ if (data.textStyle.hasColor()) {
+ color = _parseProtoColor(data.textStyle.color);
+ }
+ if (data.textStyle.hasDecoration()) {
+ decoration = _parseProtoTextDecoration(data.textStyle.decoration);
+ }
+ if (data.textStyle.hasLetterSpacing()) {
+ letterSpacing = data.textStyle.letterSpacing;
+ }
+ if (data.textStyle.hasWordSpacing()) {
+ wordSpacing = data.textStyle.wordSpacing;
+ }
if (data.textStyle.hasHeight()) height = data.textStyle.height;
- if (data.textStyle.hasFontFamily()) fontFamily = data.textStyle.fontFamily;
+ if (data.textStyle.hasFontFamily()) {
+ fontFamily = data.textStyle.fontFamily;
+ }
}
return SduiText(
@@ -154,34 +204,38 @@ class SduiParser {
);
}
+ /// Parses protobuf data into a [SduiImage] widget.
+ ///
+ /// Extracts image source URL and all display properties including sizing,
+ /// alignment, color blending, and caching options.
static SduiImage _parseProtoImage(SduiWidgetData data) {
- String src = data.stringAttributes['src'] ?? '';
- double? width = data.doubleAttributes['width'];
- double? height = data.doubleAttributes['height'];
- BoxFit? fit = _parseProtoBoxFit(data.stringAttributes['fit']);
-
- // Parse additional image properties
- Alignment? alignment = _parseProtoAlignment(data.alignment);
- ImageRepeat? repeat = _parseProtoImageRepeat(data.repeat);
- Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
- BlendMode? colorBlendMode = _parseProtoBlendMode(data.colorBlendMode);
- Rect? centerSlice =
+ final String src = data.stringAttributes['src'] ?? '';
+ final double? width = data.doubleAttributes['width'];
+ final double? height = data.doubleAttributes['height'];
+ final BoxFit? fit = _parseProtoBoxFit(data.stringAttributes['fit']);
+
+ final Alignment? alignment = _parseProtoAlignment(data.alignment);
+ final ImageRepeat? repeat = _parseProtoImageRepeat(data.repeat);
+ final Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
+ final BlendMode? colorBlendMode = _parseProtoBlendMode(data.colorBlendMode);
+ final Rect? centerSlice =
data.hasCenterSlice() ? _parseProtoRect(data.centerSlice) : null;
- bool? matchTextDirection =
+ final bool? matchTextDirection =
data.hasMatchTextDirection() ? data.matchTextDirection : null;
- bool? gaplessPlayback =
+ final bool? gaplessPlayback =
data.hasGaplessPlayback() ? data.gaplessPlayback : null;
- FilterQuality? filterQuality = _parseProtoFilterQuality(data.filterQuality);
- int? cacheWidth = data.hasCacheWidth() ? data.cacheWidth : null;
- int? cacheHeight = data.hasCacheHeight() ? data.cacheHeight : null;
- double? scale = data.hasScale() ? data.scale : null;
- String? semanticLabel = data.hasSemanticLabel() ? data.semanticLabel : null;
-
- // Parse error and loading widgets
- Widget? errorWidget = data.hasErrorWidget()
+ final FilterQuality? filterQuality =
+ _parseProtoFilterQuality(data.filterQuality);
+ final int? cacheWidth = data.hasCacheWidth() ? data.cacheWidth : null;
+ final int? cacheHeight = data.hasCacheHeight() ? data.cacheHeight : null;
+ final double? scale = data.hasScale() ? data.scale : null;
+ final String? semanticLabel =
+ data.hasSemanticLabel() ? data.semanticLabel : null;
+
+ final Widget? errorWidget = data.hasErrorWidget()
? SduiParser.parseProto(data.errorWidget).toFlutterWidget()
: null;
- Widget? loadingWidget = data.hasLoadingWidget()
+ final Widget? loadingWidget = data.hasLoadingWidget()
? SduiParser.parseProto(data.loadingWidget).toFlutterWidget()
: null;
@@ -229,7 +283,6 @@ class SduiParser {
double? height = data.doubleAttributes['height'];
Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
- // Parse additional container properties
Alignment? alignment = _parseProtoAlignment(data.alignment);
BoxConstraints? constraints = data.hasConstraints()
? _parseProtoBoxConstraints(data.constraints)
@@ -268,7 +321,6 @@ class SduiParser {
? _parseProtoColor(data.backgroundColor)
: null;
- // Parse additional scaffold properties
SduiWidget? bottomNavigationBar = data.hasBottomNavigationBar()
? SduiParser.parseProto(data.bottomNavigationBar)
: null;
@@ -334,7 +386,6 @@ class SduiParser {
Color? color =
data.icon.hasColor() ? _parseProtoColor(data.icon.color) : null;
- // Parse additional icon properties
String? semanticLabel = data.hasSemanticLabel() ? data.semanticLabel : null;
TextDirection? textDirection = _parseProtoTextDirection(data.textDirection);
double? opacity = data.hasOpacity() ? data.opacity : null;
@@ -356,8 +407,12 @@ class SduiParser {
);
}
- // Helper methods for parsing protobuf attribute types
+ /// Helper methods for parsing protobuf attribute types into Flutter types.
+ /// Parses a string value into a [BoxFit] enum.
+ ///
+ /// Supports common box fit values like 'fill', 'contain', 'cover', etc.
+ /// Returns null if the value is null or unrecognized.
static BoxFit? _parseProtoBoxFit(String? value) {
if (value == null) return null;
switch (value.toLowerCase()) {
@@ -380,16 +435,22 @@ class SduiParser {
}
}
+ /// Parses protobuf text style data into a Flutter [TextStyle].
+ ///
+ /// Converts all text styling properties from protobuf format
+ /// to their corresponding Flutter TextStyle properties.
static TextStyle? _parseProtoTextStyle(TextStyleData data) {
- Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
- double? fontSize = data.fontSize;
- FontWeight? fontWeight = _parseProtoFontWeight(data.fontWeight);
- TextDecoration? decoration = _parseProtoTextDecoration(data.decoration);
- double? letterSpacing = data.hasLetterSpacing() ? data.letterSpacing : null;
- double? wordSpacing = data.hasWordSpacing() ? data.wordSpacing : null;
- double? height = data.hasHeight() ? data.height : null;
- String? fontFamily = data.hasFontFamily() ? data.fontFamily : null;
- FontStyle? fontStyle = _parseProtoFontStyle(data.fontStyle);
+ final Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
+ final double fontSize = data.fontSize;
+ final FontWeight? fontWeight = _parseProtoFontWeight(data.fontWeight);
+ final TextDecoration? decoration =
+ _parseProtoTextDecoration(data.decoration);
+ final double? letterSpacing =
+ data.hasLetterSpacing() ? data.letterSpacing : null;
+ final double? wordSpacing = data.hasWordSpacing() ? data.wordSpacing : null;
+ final double? height = data.hasHeight() ? data.height : null;
+ final String? fontFamily = data.hasFontFamily() ? data.fontFamily : null;
+ final FontStyle? fontStyle = _parseProtoFontStyle(data.fontStyle);
return TextStyle(
color: color,
@@ -404,6 +465,10 @@ class SduiParser {
);
}
+ /// Parses a string value into a [FontWeight] enum.
+ ///
+ /// Supports both named weights ('bold', 'normal') and numeric weights
+ /// ('w100' through 'w900'). Returns null for unrecognized values.
static FontWeight? _parseProtoFontWeight(String? value) {
if (value == null) return null;
switch (value.toLowerCase()) {
@@ -434,6 +499,10 @@ class SduiParser {
}
}
+ /// Parses protobuf edge insets data into Flutter [EdgeInsets].
+ ///
+ /// Supports both uniform insets (all sides equal) and individual
+ /// side specifications (left, top, right, bottom).
static EdgeInsets? _parseProtoEdgeInsets(EdgeInsetsData data) {
if (data.hasAll()) {
return EdgeInsets.all(data.all);
@@ -447,6 +516,10 @@ class SduiParser {
);
}
+ /// Parses protobuf color data into a Flutter [Color].
+ ///
+ /// Creates a Color from ARGB values provided in the protobuf data.
+ /// Alpha, red, green, and blue values should be in the range 0-255.
static Color? _parseProtoColor(ColorData data) {
return Color.fromARGB(
data.alpha,
@@ -527,7 +600,7 @@ class SduiParser {
);
}
- return BorderRadius.circular(8.0); // Example default value
+ return BorderRadius.circular(8.0);
}
// New helper methods for parsing new property types
@@ -873,7 +946,8 @@ class SduiParser {
return SduiColumn(
children: children,
mainAxisAlignment: _parseJsonMainAxisAlignment(data['mainAxisAlignment']),
- crossAxisAlignment: _parseJsonCrossAxisAlignment(data['crossAxisAlignment']),
+ crossAxisAlignment:
+ _parseJsonCrossAxisAlignment(data['crossAxisAlignment']),
mainAxisSize: _parseJsonMainAxisSize(data['mainAxisSize']),
textDirection: _parseJsonTextDirection(data['textDirection']),
verticalDirection: _parseJsonVerticalDirection(data['verticalDirection']),
@@ -977,7 +1051,8 @@ class SduiParser {
return SduiRow(
children: children,
mainAxisAlignment: _parseJsonMainAxisAlignment(data['mainAxisAlignment']),
- crossAxisAlignment: _parseJsonCrossAxisAlignment(data['crossAxisAlignment']),
+ crossAxisAlignment:
+ _parseJsonCrossAxisAlignment(data['crossAxisAlignment']),
mainAxisSize: _parseJsonMainAxisSize(data['mainAxisSize']),
textDirection: _parseJsonTextDirection(data['textDirection']),
verticalDirection: _parseJsonVerticalDirection(data['verticalDirection']),
@@ -991,91 +1066,145 @@ class SduiParser {
style: _parseJsonTextStyle(data['style']),
textAlign: _parseJsonTextAlign(data['textAlign']),
overflow: _parseJsonTextOverflow(data['overflow']),
- maxLines: data['maxLines'] is int ? data['maxLines'] : int.tryParse(data['maxLines']?.toString() ?? ''),
+ maxLines: data['maxLines'] is int
+ ? data['maxLines']
+ : int.tryParse(data['maxLines']?.toString() ?? ''),
softWrap: data['softWrap'] is bool ? data['softWrap'] : null,
- letterSpacing: (data['letterSpacing'] is num) ? (data['letterSpacing'] as num).toDouble() : null,
- wordSpacing: (data['wordSpacing'] is num) ? (data['wordSpacing'] as num).toDouble() : null,
- height: (data['height'] is num) ? (data['height'] as num).toDouble() : null,
+ letterSpacing: (data['letterSpacing'] is num)
+ ? (data['letterSpacing'] as num).toDouble()
+ : null,
+ wordSpacing: (data['wordSpacing'] is num)
+ ? (data['wordSpacing'] as num).toDouble()
+ : null,
+ height:
+ (data['height'] is num) ? (data['height'] as num).toDouble() : null,
fontFamily: data['fontFamily']?.toString(),
textDirection: _parseJsonTextDirection(data['textDirection']),
);
}
static SduiImage _parseJsonImage(Map data) {
- SduiWidget? errorSduiWidget = data['errorWidget'] is Map ? parseJSON(data['errorWidget']) : null;
- SduiWidget? loadingSduiWidget = data['loadingWidget'] is Map ? parseJSON(data['loadingWidget']) : null;
+ SduiWidget? errorSduiWidget = data['errorWidget'] is Map
+ ? parseJSON(data['errorWidget'])
+ : null;
+ SduiWidget? loadingSduiWidget =
+ data['loadingWidget'] is Map
+ ? parseJSON(data['loadingWidget'])
+ : null;
return SduiImage(
data['src']?.toString() ?? '',
width: (data['width'] is num) ? (data['width'] as num).toDouble() : null,
- height: (data['height'] is num) ? (data['height'] as num).toDouble() : null,
+ height:
+ (data['height'] is num) ? (data['height'] as num).toDouble() : null,
fit: _parseJsonBoxFit(data['fit']),
alignment: _parseJsonAlignment(data['alignment']),
repeat: _parseJsonImageRepeat(data['repeat']),
color: _parseJsonColor(data['color']),
colorBlendMode: _parseJsonBlendMode(data['colorBlendMode']),
centerSlice: _parseJsonRect(data['centerSlice']),
- matchTextDirection: data['matchTextDirection'] is bool ? data['matchTextDirection'] : null,
- gaplessPlayback: data['gaplessPlayback'] is bool ? data['gaplessPlayback'] : null,
+ matchTextDirection: data['matchTextDirection'] is bool
+ ? data['matchTextDirection']
+ : null,
+ gaplessPlayback:
+ data['gaplessPlayback'] is bool ? data['gaplessPlayback'] : null,
filterQuality: _parseJsonFilterQuality(data['filterQuality']),
- cacheWidth: data['cacheWidth'] is int ? data['cacheWidth'] : int.tryParse(data['cacheWidth']?.toString() ?? ''),
- cacheHeight: data['cacheHeight'] is int ? data['cacheHeight'] : int.tryParse(data['cacheHeight']?.toString() ?? ''),
+ cacheWidth: data['cacheWidth'] is int
+ ? data['cacheWidth']
+ : int.tryParse(data['cacheWidth']?.toString() ?? ''),
+ cacheHeight: data['cacheHeight'] is int
+ ? data['cacheHeight']
+ : int.tryParse(data['cacheHeight']?.toString() ?? ''),
scale: (data['scale'] is num) ? (data['scale'] as num).toDouble() : null,
semanticLabel: data['semanticLabel']?.toString(),
- errorWidget: errorSduiWidget != null ? errorSduiWidget.toFlutterWidget() : null,
- loadingWidget: loadingSduiWidget != null ? loadingSduiWidget.toFlutterWidget() : null,
+ errorWidget: errorSduiWidget?.toFlutterWidget(),
+ loadingWidget: loadingSduiWidget?.toFlutterWidget(),
);
}
static SduiSizedBox _parseJsonSizedBox(Map data) {
return SduiSizedBox(
width: (data['width'] is num) ? (data['width'] as num).toDouble() : null,
- height: (data['height'] is num) ? (data['height'] as num).toDouble() : null,
- child: data['child'] is Map ? parseJSON(data['child']) : null,
+ height:
+ (data['height'] is num) ? (data['height'] as num).toDouble() : null,
+ child: data['child'] is Map
+ ? parseJSON(data['child'])
+ : null,
);
}
static SduiContainer _parseJsonContainer(Map data) {
return SduiContainer(
- child: data['child'] is Map ? parseJSON(data['child']) : null,
+ child: data['child'] is Map
+ ? parseJSON(data['child'])
+ : null,
padding: _parseJsonEdgeInsets(data['padding']),
margin: _parseJsonEdgeInsets(data['margin']),
decoration: _parseJsonBoxDecoration(data['decoration']),
width: (data['width'] is num) ? (data['width'] as num).toDouble() : null,
- height: (data['height'] is num) ? (data['height'] as num).toDouble() : null,
+ height:
+ (data['height'] is num) ? (data['height'] as num).toDouble() : null,
color: _parseJsonColor(data['color']),
alignment: _parseJsonAlignment(data['alignment']),
constraints: _parseJsonBoxConstraints(data['constraints']),
transform: _parseJsonTransform(data['transform']),
- transformAlignment: _parseJsonAlignmentGeometry(data['transformAlignment']),
+ transformAlignment:
+ _parseJsonAlignmentGeometry(data['transformAlignment']),
clipBehavior: _parseJsonClip(data['clipBehavior']),
);
}
static SduiScaffold _parseJsonScaffold(Map data) {
return SduiScaffold(
- appBar: data['appBar'] is Map ? parseJSON(data['appBar']) : null,
- body: data['body'] is Map ? parseJSON(data['body']) : null,
- floatingActionButton: data['floatingActionButton'] is Map ? parseJSON(data['floatingActionButton']) : null,
- bottomNavigationBar: data['bottomNavigationBar'] is Map ? parseJSON(data['bottomNavigationBar']) : null,
- drawer: data['drawer'] is Map ? parseJSON(data['drawer']) : null,
- endDrawer: data['endDrawer'] is Map ? parseJSON(data['endDrawer']) : null,
- bottomSheet: data['bottomSheet'] is Map ? parseJSON(data['bottomSheet']) : null,
+ appBar: data['appBar'] is Map
+ ? parseJSON(data['appBar'])
+ : null,
+ body:
+ data['body'] is Map ? parseJSON(data['body']) : null,
+ floatingActionButton: data['floatingActionButton'] is Map
+ ? parseJSON(data['floatingActionButton'])
+ : null,
+ bottomNavigationBar: data['bottomNavigationBar'] is Map
+ ? parseJSON(data['bottomNavigationBar'])
+ : null,
+ drawer: data['drawer'] is Map
+ ? parseJSON(data['drawer'])
+ : null,
+ endDrawer: data['endDrawer'] is Map
+ ? parseJSON(data['endDrawer'])
+ : null,
+ bottomSheet: data['bottomSheet'] is Map
+ ? parseJSON(data['bottomSheet'])
+ : null,
backgroundColor: _parseJsonColor(data['backgroundColor']),
- resizeToAvoidBottomInset: data['resizeToAvoidBottomInset'] is bool ? data['resizeToAvoidBottomInset'] : null,
+ resizeToAvoidBottomInset: data['resizeToAvoidBottomInset'] is bool
+ ? data['resizeToAvoidBottomInset']
+ : null,
primary: data['primary'] is bool ? data['primary'] : null,
- floatingActionButtonLocation: _parseJsonFabLocation(data['floatingActionButtonLocation']),
+ floatingActionButtonLocation:
+ _parseJsonFabLocation(data['floatingActionButtonLocation']),
extendBody: data['extendBody'] is bool ? data['extendBody'] : null,
- extendBodyBehindAppBar: data['extendBodyBehindAppBar'] is bool ? data['extendBodyBehindAppBar'] : null,
+ extendBodyBehindAppBar: data['extendBodyBehindAppBar'] is bool
+ ? data['extendBodyBehindAppBar']
+ : null,
drawerScrimColor: _parseJsonColor(data['drawerScrimColor']),
- drawerEdgeDragWidth: (data['drawerEdgeDragWidth'] is num) ? (data['drawerEdgeDragWidth'] as num).toDouble() : null,
- drawerEnableOpenDragGesture: data['drawerEnableOpenDragGesture'] is bool ? data['drawerEnableOpenDragGesture'] : null,
- endDrawerEnableOpenDragGesture: data['endDrawerEnableOpenDragGesture'] is bool ? data['endDrawerEnableOpenDragGesture'] : null,
+ drawerEdgeDragWidth: (data['drawerEdgeDragWidth'] is num)
+ ? (data['drawerEdgeDragWidth'] as num).toDouble()
+ : null,
+ drawerEnableOpenDragGesture: data['drawerEnableOpenDragGesture'] is bool
+ ? data['drawerEnableOpenDragGesture']
+ : null,
+ endDrawerEnableOpenDragGesture:
+ data['endDrawerEnableOpenDragGesture'] is bool
+ ? data['endDrawerEnableOpenDragGesture']
+ : null,
);
}
static SduiSpacer _parseJsonSpacer(Map data) {
return SduiSpacer(
- flex: data['flex'] is int ? data['flex'] : int.tryParse(data['flex']?.toString() ?? '') ?? 1,
+ flex: data['flex'] is int
+ ? data['flex']
+ : int.tryParse(data['flex']?.toString() ?? '') ?? 1,
);
}
@@ -1086,8 +1215,10 @@ class SduiParser {
color: _parseJsonColor(data['color']),
semanticLabel: data['semanticLabel']?.toString(),
textDirection: _parseJsonTextDirection(data['textDirection']),
- opacity: (data['opacity'] is num) ? (data['opacity'] as num).toDouble() : null,
- applyTextScaling: data['applyTextScaling'] is bool ? data['applyTextScaling'] : null,
+ opacity:
+ (data['opacity'] is num) ? (data['opacity'] as num).toDouble() : null,
+ applyTextScaling:
+ data['applyTextScaling'] is bool ? data['applyTextScaling'] : null,
shadows: _parseJsonShadows(data['shadows']),
);
}
@@ -1097,12 +1228,19 @@ class SduiParser {
if (value is! Map) return null;
return TextStyle(
color: _parseJsonColor(value['color']),
- fontSize: (value['fontSize'] is num) ? (value['fontSize'] as num).toDouble() : null,
+ fontSize: (value['fontSize'] is num)
+ ? (value['fontSize'] as num).toDouble()
+ : null,
fontWeight: _parseJsonFontWeight(value['fontWeight']),
decoration: _parseJsonTextDecoration(value['decoration']),
- letterSpacing: (value['letterSpacing'] is num) ? (value['letterSpacing'] as num).toDouble() : null,
- wordSpacing: (value['wordSpacing'] is num) ? (value['wordSpacing'] as num).toDouble() : null,
- height: (value['height'] is num) ? (value['height'] as num).toDouble() : null,
+ letterSpacing: (value['letterSpacing'] is num)
+ ? (value['letterSpacing'] as num).toDouble()
+ : null,
+ wordSpacing: (value['wordSpacing'] is num)
+ ? (value['wordSpacing'] as num).toDouble()
+ : null,
+ height:
+ (value['height'] is num) ? (value['height'] as num).toDouble() : null,
fontFamily: value['fontFamily']?.toString(),
fontStyle: _parseJsonFontStyle(value['fontStyle']),
);
@@ -1315,48 +1453,78 @@ class SduiParser {
static BlendMode? _parseJsonBlendMode(dynamic value) {
if (value == null) return null;
switch (value.toString().toLowerCase()) {
- case 'clear': return BlendMode.clear;
- case 'src': return BlendMode.src;
- case 'dst': return BlendMode.dst;
+ case 'clear':
+ return BlendMode.clear;
+ case 'src':
+ return BlendMode.src;
+ case 'dst':
+ return BlendMode.dst;
case 'srcover':
- case 'src_over': return BlendMode.srcOver;
+ case 'src_over':
+ return BlendMode.srcOver;
case 'dstover':
- case 'dst_over': return BlendMode.dstOver;
+ case 'dst_over':
+ return BlendMode.dstOver;
case 'srcin':
- case 'src_in': return BlendMode.srcIn;
+ case 'src_in':
+ return BlendMode.srcIn;
case 'dstin':
- case 'dst_in': return BlendMode.dstIn;
+ case 'dst_in':
+ return BlendMode.dstIn;
case 'srcout':
- case 'src_out': return BlendMode.srcOut;
+ case 'src_out':
+ return BlendMode.srcOut;
case 'dstout':
- case 'dst_out': return BlendMode.dstOut;
+ case 'dst_out':
+ return BlendMode.dstOut;
case 'srcatop':
- case 'src_atop': return BlendMode.srcATop;
+ case 'src_atop':
+ return BlendMode.srcATop;
case 'dstatop':
- case 'dst_atop': return BlendMode.dstATop;
- case 'xor': return BlendMode.xor;
- case 'plus': return BlendMode.plus;
- case 'modulate': return BlendMode.modulate;
- case 'screen': return BlendMode.screen;
- case 'overlay': return BlendMode.overlay;
- case 'darken': return BlendMode.darken;
- case 'lighten': return BlendMode.lighten;
+ case 'dst_atop':
+ return BlendMode.dstATop;
+ case 'xor':
+ return BlendMode.xor;
+ case 'plus':
+ return BlendMode.plus;
+ case 'modulate':
+ return BlendMode.modulate;
+ case 'screen':
+ return BlendMode.screen;
+ case 'overlay':
+ return BlendMode.overlay;
+ case 'darken':
+ return BlendMode.darken;
+ case 'lighten':
+ return BlendMode.lighten;
case 'colordodge':
- case 'color_dodge': return BlendMode.colorDodge;
+ case 'color_dodge':
+ return BlendMode.colorDodge;
case 'colorburn':
- case 'color_burn': return BlendMode.colorBurn;
+ case 'color_burn':
+ return BlendMode.colorBurn;
case 'hardlight':
- case 'hard_light': return BlendMode.hardLight;
+ case 'hard_light':
+ return BlendMode.hardLight;
case 'softlight':
- case 'soft_light': return BlendMode.softLight;
- case 'difference': return BlendMode.difference;
- case 'exclusion': return BlendMode.exclusion;
- case 'multiply': return BlendMode.multiply;
- case 'hue': return BlendMode.hue;
- case 'saturation': return BlendMode.saturation;
- case 'color': return BlendMode.color;
- case 'luminosity': return BlendMode.luminosity;
- default: return null;
+ case 'soft_light':
+ return BlendMode.softLight;
+ case 'difference':
+ return BlendMode.difference;
+ case 'exclusion':
+ return BlendMode.exclusion;
+ case 'multiply':
+ return BlendMode.multiply;
+ case 'hue':
+ return BlendMode.hue;
+ case 'saturation':
+ return BlendMode.saturation;
+ case 'color':
+ return BlendMode.color;
+ case 'luminosity':
+ return BlendMode.luminosity;
+ default:
+ return null;
}
}
@@ -1375,11 +1543,16 @@ class SduiParser {
static FilterQuality? _parseJsonFilterQuality(dynamic value) {
if (value == null) return null;
switch (value.toString().toLowerCase()) {
- case 'none': return FilterQuality.none;
- case 'low': return FilterQuality.low;
- case 'medium': return FilterQuality.medium;
- case 'high': return FilterQuality.high;
- default: return null;
+ case 'none':
+ return FilterQuality.none;
+ case 'low':
+ return FilterQuality.low;
+ case 'medium':
+ return FilterQuality.medium;
+ case 'high':
+ return FilterQuality.high;
+ default:
+ return null;
}
}
@@ -1391,8 +1564,11 @@ class SduiParser {
return EdgeInsets.only(
left: (value['left'] is num) ? (value['left'] as num).toDouble() : 0.0,
top: (value['top'] is num) ? (value['top'] as num).toDouble() : 0.0,
- right: (value['right'] is num) ? (value['right'] as num).toDouble() : 0.0,
- bottom: (value['bottom'] is num) ? (value['bottom'] as num).toDouble() : 0.0,
+ right:
+ (value['right'] is num) ? (value['right'] as num).toDouble() : 0.0,
+ bottom: (value['bottom'] is num)
+ ? (value['bottom'] as num).toDouble()
+ : 0.0,
);
}
return null;
@@ -1410,13 +1586,22 @@ class SduiParser {
static BorderRadius? _parseJsonBorderRadius(dynamic value) {
if (value is Map) {
if (value.containsKey('all')) {
- return BorderRadius.all(Radius.circular((value['all'] as num).toDouble()));
+ return BorderRadius.all(
+ Radius.circular((value['all'] as num).toDouble()));
}
return BorderRadius.only(
- topLeft: value['topLeft'] != null ? Radius.circular((value['topLeft'] as num).toDouble()) : Radius.zero,
- topRight: value['topRight'] != null ? Radius.circular((value['topRight'] as num).toDouble()) : Radius.zero,
- bottomLeft: value['bottomLeft'] != null ? Radius.circular((value['bottomLeft'] as num).toDouble()) : Radius.zero,
- bottomRight: value['bottomRight'] != null ? Radius.circular((value['bottomRight'] as num).toDouble()) : Radius.zero,
+ topLeft: value['topLeft'] != null
+ ? Radius.circular((value['topLeft'] as num).toDouble())
+ : Radius.zero,
+ topRight: value['topRight'] != null
+ ? Radius.circular((value['topRight'] as num).toDouble())
+ : Radius.zero,
+ bottomLeft: value['bottomLeft'] != null
+ ? Radius.circular((value['bottomLeft'] as num).toDouble())
+ : Radius.zero,
+ bottomRight: value['bottomRight'] != null
+ ? Radius.circular((value['bottomRight'] as num).toDouble())
+ : Radius.zero,
);
}
return null;
@@ -1425,10 +1610,18 @@ class SduiParser {
static BoxConstraints? _parseJsonBoxConstraints(dynamic value) {
if (value is Map) {
return BoxConstraints(
- minWidth: (value['minWidth'] is num) ? (value['minWidth'] as num).toDouble() : 0.0,
- maxWidth: (value['maxWidth'] is num) ? (value['maxWidth'] as num).toDouble() : double.infinity,
- minHeight: (value['minHeight'] is num) ? (value['minHeight'] as num).toDouble() : 0.0,
- maxHeight: (value['maxHeight'] is num) ? (value['maxHeight'] as num).toDouble() : double.infinity,
+ minWidth: (value['minWidth'] is num)
+ ? (value['minWidth'] as num).toDouble()
+ : 0.0,
+ maxWidth: (value['maxWidth'] is num)
+ ? (value['maxWidth'] as num).toDouble()
+ : double.infinity,
+ minHeight: (value['minHeight'] is num)
+ ? (value['minHeight'] as num).toDouble()
+ : 0.0,
+ maxHeight: (value['maxHeight'] is num)
+ ? (value['maxHeight'] as num).toDouble()
+ : double.infinity,
);
}
return null;
@@ -1440,10 +1633,22 @@ class SduiParser {
final vals = value['matrixValues'] as List;
if (vals.length == 16) {
return Matrix4(
- (vals[0] as num).toDouble(), (vals[1] as num).toDouble(), (vals[2] as num).toDouble(), (vals[3] as num).toDouble(),
- (vals[4] as num).toDouble(), (vals[5] as num).toDouble(), (vals[6] as num).toDouble(), (vals[7] as num).toDouble(),
- (vals[8] as num).toDouble(), (vals[9] as num).toDouble(), (vals[10] as num).toDouble(), (vals[11] as num).toDouble(),
- (vals[12] as num).toDouble(), (vals[13] as num).toDouble(), (vals[14] as num).toDouble(), (vals[15] as num).toDouble(),
+ (vals[0] as num).toDouble(),
+ (vals[1] as num).toDouble(),
+ (vals[2] as num).toDouble(),
+ (vals[3] as num).toDouble(),
+ (vals[4] as num).toDouble(),
+ (vals[5] as num).toDouble(),
+ (vals[6] as num).toDouble(),
+ (vals[7] as num).toDouble(),
+ (vals[8] as num).toDouble(),
+ (vals[9] as num).toDouble(),
+ (vals[10] as num).toDouble(),
+ (vals[11] as num).toDouble(),
+ (vals[12] as num).toDouble(),
+ (vals[13] as num).toDouble(),
+ (vals[14] as num).toDouble(),
+ (vals[15] as num).toDouble(),
);
}
} else if (value['type'] == 'translate') {
@@ -1472,13 +1677,18 @@ class SduiParser {
static Clip? _parseJsonClip(dynamic value) {
if (value == null) return null;
switch (value.toString().toLowerCase()) {
- case 'none': return Clip.none;
+ case 'none':
+ return Clip.none;
case 'hardedge':
- case 'hard_edge': return Clip.hardEdge;
- case 'antialias': return Clip.antiAlias;
+ case 'hard_edge':
+ return Clip.hardEdge;
+ case 'antialias':
+ return Clip.antiAlias;
case 'antialiaswithsavelayer':
- case 'antialias_with_save_layer': return Clip.antiAliasWithSaveLayer;
- default: return null;
+ case 'antialias_with_save_layer':
+ return Clip.antiAliasWithSaveLayer;
+ default:
+ return null;
}
}
@@ -1486,33 +1696,46 @@ class SduiParser {
if (value == null) return null;
switch (value.toString().toLowerCase()) {
case 'starttop':
- case 'start_top': return FloatingActionButtonLocation.startTop;
+ case 'start_top':
+ return FloatingActionButtonLocation.startTop;
case 'start':
case 'startfloat':
- case 'start_float': return FloatingActionButtonLocation.startFloat;
+ case 'start_float':
+ return FloatingActionButtonLocation.startFloat;
case 'centertop':
- case 'center_top': return FloatingActionButtonLocation.centerTop;
+ case 'center_top':
+ return FloatingActionButtonLocation.centerTop;
case 'center':
case 'centerfloat':
- case 'center_float': return FloatingActionButtonLocation.centerFloat;
+ case 'center_float':
+ return FloatingActionButtonLocation.centerFloat;
case 'endtop':
- case 'end_top': return FloatingActionButtonLocation.endTop;
+ case 'end_top':
+ return FloatingActionButtonLocation.endTop;
case 'end':
case 'endfloat':
- case 'end_float': return FloatingActionButtonLocation.endFloat;
+ case 'end_float':
+ return FloatingActionButtonLocation.endFloat;
case 'minicentertop':
- case 'mini_center_top': return FloatingActionButtonLocation.miniCenterTop;
+ case 'mini_center_top':
+ return FloatingActionButtonLocation.miniCenterTop;
case 'minicenterfloat':
- case 'mini_center_float': return FloatingActionButtonLocation.miniCenterFloat;
+ case 'mini_center_float':
+ return FloatingActionButtonLocation.miniCenterFloat;
case 'ministarttop':
- case 'mini_start_top': return FloatingActionButtonLocation.miniStartTop;
+ case 'mini_start_top':
+ return FloatingActionButtonLocation.miniStartTop;
case 'ministartfloat':
- case 'mini_start_float': return FloatingActionButtonLocation.miniStartFloat;
+ case 'mini_start_float':
+ return FloatingActionButtonLocation.miniStartFloat;
case 'miniendtop':
- case 'mini_end_top': return FloatingActionButtonLocation.miniEndTop;
+ case 'mini_end_top':
+ return FloatingActionButtonLocation.miniEndTop;
case 'miniendfloat':
- case 'mini_end_float': return FloatingActionButtonLocation.miniEndFloat;
- default: return null;
+ case 'mini_end_float':
+ return FloatingActionButtonLocation.miniEndFloat;
+ default:
+ return null;
}
}
@@ -1520,27 +1743,41 @@ class SduiParser {
if (value == null) return null;
if (value is String) {
switch (value.toLowerCase()) {
- case 'settings': return Icons.settings;
- case 'home': return Icons.home;
- case 'search': return Icons.search;
- case 'add': return Icons.add;
- case 'edit': return Icons.edit;
- default: break;
+ case 'settings':
+ return Icons.settings;
+ case 'home':
+ return Icons.home;
+ case 'search':
+ return Icons.search;
+ case 'add':
+ return Icons.add;
+ case 'edit':
+ return Icons.edit;
+ default:
+ break;
}
} else if (value is Map) {
if (value['name'] != null) {
switch (value['name'].toString().toLowerCase()) {
- case 'settings': return Icons.settings;
- case 'home': return Icons.home;
- case 'search': return Icons.search;
- case 'add': return Icons.add;
- case 'edit': return Icons.edit;
- default: break;
+ case 'settings':
+ return Icons.settings;
+ case 'home':
+ return Icons.home;
+ case 'search':
+ return Icons.search;
+ case 'add':
+ return Icons.add;
+ case 'edit':
+ return Icons.edit;
+ default:
+ break;
}
}
if (value['codePoint'] != null) {
return IconData(
- value['codePoint'] is int ? value['codePoint'] : int.tryParse(value['codePoint'].toString()) ?? 0,
+ value['codePoint'] is int
+ ? value['codePoint']
+ : int.tryParse(value['codePoint'].toString()) ?? 0,
fontFamily: value['fontFamily']?.toString() ?? 'MaterialIcons',
);
}
@@ -1558,7 +1795,9 @@ class SduiParser {
(v['offsetX'] is num) ? (v['offsetX'] as num).toDouble() : 0.0,
(v['offsetY'] is num) ? (v['offsetY'] as num).toDouble() : 0.0,
),
- blurRadius: (v['blurRadius'] is num) ? (v['blurRadius'] as num).toDouble() : 0.0,
+ blurRadius: (v['blurRadius'] is num)
+ ? (v['blurRadius'] as num).toDouble()
+ : 0.0,
);
}
return const Shadow();
@@ -1593,12 +1832,21 @@ class SduiParser {
static Map _toJsonColumn(SduiColumn widget) {
return {
'type': 'column',
- if (widget.mainAxisAlignment != null) 'mainAxisAlignment': widget.mainAxisAlignment.toString().split('.').last,
- if (widget.crossAxisAlignment != null) 'crossAxisAlignment': widget.crossAxisAlignment.toString().split('.').last,
- if (widget.mainAxisSize != null) 'mainAxisSize': widget.mainAxisSize.toString().split('.').last,
- if (widget.textDirection != null) 'textDirection': widget.textDirection.toString().split('.').last,
- if (widget.verticalDirection != null) 'verticalDirection': widget.verticalDirection.toString().split('.').last,
- if (widget.textBaseline != null) 'textBaseline': widget.textBaseline.toString().split('.').last,
+ if (widget.mainAxisAlignment != null)
+ 'mainAxisAlignment':
+ widget.mainAxisAlignment.toString().split('.').last,
+ if (widget.crossAxisAlignment != null)
+ 'crossAxisAlignment':
+ widget.crossAxisAlignment.toString().split('.').last,
+ if (widget.mainAxisSize != null)
+ 'mainAxisSize': widget.mainAxisSize.toString().split('.').last,
+ if (widget.textDirection != null)
+ 'textDirection': widget.textDirection.toString().split('.').last,
+ if (widget.verticalDirection != null)
+ 'verticalDirection':
+ widget.verticalDirection.toString().split('.').last,
+ if (widget.textBaseline != null)
+ 'textBaseline': widget.textBaseline.toString().split('.').last,
'children': widget.children.map(toJson).toList(),
};
}
@@ -1606,12 +1854,21 @@ class SduiParser {
static Map _toJsonRow(SduiRow widget) {
return {
'type': 'row',
- if (widget.mainAxisAlignment != null) 'mainAxisAlignment': widget.mainAxisAlignment.toString().split('.').last,
- if (widget.crossAxisAlignment != null) 'crossAxisAlignment': widget.crossAxisAlignment.toString().split('.').last,
- if (widget.mainAxisSize != null) 'mainAxisSize': widget.mainAxisSize.toString().split('.').last,
- if (widget.textDirection != null) 'textDirection': widget.textDirection.toString().split('.').last,
- if (widget.verticalDirection != null) 'verticalDirection': widget.verticalDirection.toString().split('.').last,
- if (widget.textBaseline != null) 'textBaseline': widget.textBaseline.toString().split('.').last,
+ if (widget.mainAxisAlignment != null)
+ 'mainAxisAlignment':
+ widget.mainAxisAlignment.toString().split('.').last,
+ if (widget.crossAxisAlignment != null)
+ 'crossAxisAlignment':
+ widget.crossAxisAlignment.toString().split('.').last,
+ if (widget.mainAxisSize != null)
+ 'mainAxisSize': widget.mainAxisSize.toString().split('.').last,
+ if (widget.textDirection != null)
+ 'textDirection': widget.textDirection.toString().split('.').last,
+ if (widget.verticalDirection != null)
+ 'verticalDirection':
+ widget.verticalDirection.toString().split('.').last,
+ if (widget.textBaseline != null)
+ 'textBaseline': widget.textBaseline.toString().split('.').last,
'children': widget.children.map(toJson).toList(),
};
}
@@ -1621,29 +1878,36 @@ class SduiParser {
'type': 'text',
'text': widget.text,
if (widget.style != null) 'style': _toJsonTextStyle(widget.style!),
- if (widget.textAlign != null) 'textAlign': widget.textAlign.toString().split('.').last,
- if (widget.overflow != null) 'overflow': widget.overflow.toString().split('.').last,
+ if (widget.textAlign != null)
+ 'textAlign': widget.textAlign.toString().split('.').last,
+ if (widget.overflow != null)
+ 'overflow': widget.overflow.toString().split('.').last,
if (widget.maxLines != null) 'maxLines': widget.maxLines,
if (widget.softWrap != null) 'softWrap': widget.softWrap,
if (widget.letterSpacing != null) 'letterSpacing': widget.letterSpacing,
if (widget.wordSpacing != null) 'wordSpacing': widget.wordSpacing,
if (widget.height != null) 'height': widget.height,
if (widget.fontFamily != null) 'fontFamily': widget.fontFamily,
- if (widget.textDirection != null) 'textDirection': widget.textDirection.toString().split('.').last,
+ if (widget.textDirection != null)
+ 'textDirection': widget.textDirection.toString().split('.').last,
};
}
static Map _toJsonTextStyle(TextStyle style) {
return {
- if (style.color != null) 'color': '#${style.color!.value.toRadixString(16).padLeft(8, '0')}',
+ if (style.color != null)
+ 'color': '#${style.color!.value.toRadixString(16).padLeft(8, '0')}',
if (style.fontSize != null) 'fontSize': style.fontSize,
- if (style.fontWeight != null) 'fontWeight': style.fontWeight.toString().split('.').last,
- if (style.decoration != null) 'decoration': style.decoration.toString().split('.').last,
+ if (style.fontWeight != null)
+ 'fontWeight': style.fontWeight.toString().split('.').last,
+ if (style.decoration != null)
+ 'decoration': style.decoration.toString().split('.').last,
if (style.letterSpacing != null) 'letterSpacing': style.letterSpacing,
if (style.wordSpacing != null) 'wordSpacing': style.wordSpacing,
if (style.height != null) 'height': style.height,
if (style.fontFamily != null) 'fontFamily': style.fontFamily,
- if (style.fontStyle != null) 'fontStyle': style.fontStyle.toString().split('.').last,
+ if (style.fontStyle != null)
+ 'fontStyle': style.fontStyle.toString().split('.').last,
};
}
@@ -1655,13 +1919,20 @@ class SduiParser {
if (widget.height != null) 'height': widget.height,
if (widget.fit != null) 'fit': widget.fit.toString().split('.').last,
if (widget.alignment != null) 'alignment': widget.alignment.toString(),
- if (widget.repeat != null) 'repeat': widget.repeat.toString().split('.').last,
- if (widget.color != null) 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
- if (widget.colorBlendMode != null) 'colorBlendMode': widget.colorBlendMode.toString().split('.').last,
- if (widget.centerSlice != null) 'centerSlice': widget.centerSlice.toString(),
- if (widget.matchTextDirection != null) 'matchTextDirection': widget.matchTextDirection,
- if (widget.gaplessPlayback != null) 'gaplessPlayback': widget.gaplessPlayback,
- if (widget.filterQuality != null) 'filterQuality': widget.filterQuality.toString().split('.').last,
+ if (widget.repeat != null)
+ 'repeat': widget.repeat.toString().split('.').last,
+ if (widget.color != null)
+ 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
+ if (widget.colorBlendMode != null)
+ 'colorBlendMode': widget.colorBlendMode.toString().split('.').last,
+ if (widget.centerSlice != null)
+ 'centerSlice': widget.centerSlice.toString(),
+ if (widget.matchTextDirection != null)
+ 'matchTextDirection': widget.matchTextDirection,
+ if (widget.gaplessPlayback != null)
+ 'gaplessPlayback': widget.gaplessPlayback,
+ if (widget.filterQuality != null)
+ 'filterQuality': widget.filterQuality.toString().split('.').last,
if (widget.cacheWidth != null) 'cacheWidth': widget.cacheWidth,
if (widget.cacheHeight != null) 'cacheHeight': widget.cacheHeight,
if (widget.scale != null) 'scale': widget.scale,
@@ -1684,15 +1955,20 @@ class SduiParser {
if (widget.child != null) 'child': toJson(widget.child!),
if (widget.padding != null) 'padding': _toJsonEdgeInsets(widget.padding!),
if (widget.margin != null) 'margin': _toJsonEdgeInsets(widget.margin!),
- if (widget.decoration != null) 'decoration': _toJsonBoxDecoration(widget.decoration!),
+ if (widget.decoration != null)
+ 'decoration': _toJsonBoxDecoration(widget.decoration!),
if (widget.width != null) 'width': widget.width,
if (widget.height != null) 'height': widget.height,
- if (widget.color != null) 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
+ if (widget.color != null)
+ 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
if (widget.alignment != null) 'alignment': widget.alignment.toString(),
- if (widget.constraints != null) 'constraints': _toJsonBoxConstraints(widget.constraints!),
+ if (widget.constraints != null)
+ 'constraints': _toJsonBoxConstraints(widget.constraints!),
if (widget.transform != null) 'transform': widget.transform.toString(),
- if (widget.transformAlignment != null) 'transformAlignment': widget.transformAlignment.toString(),
- if (widget.clipBehavior != null) 'clipBehavior': widget.clipBehavior.toString().split('.').last,
+ if (widget.transformAlignment != null)
+ 'transformAlignment': widget.transformAlignment.toString(),
+ if (widget.clipBehavior != null)
+ 'clipBehavior': widget.clipBehavior.toString().split('.').last,
};
}
@@ -1701,21 +1977,35 @@ class SduiParser {
'type': 'scaffold',
if (widget.appBar != null) 'appBar': toJson(widget.appBar!),
if (widget.body != null) 'body': toJson(widget.body!),
- if (widget.floatingActionButton != null) 'floatingActionButton': toJson(widget.floatingActionButton!),
- if (widget.bottomNavigationBar != null) 'bottomNavigationBar': toJson(widget.bottomNavigationBar!),
+ if (widget.floatingActionButton != null)
+ 'floatingActionButton': toJson(widget.floatingActionButton!),
+ if (widget.bottomNavigationBar != null)
+ 'bottomNavigationBar': toJson(widget.bottomNavigationBar!),
if (widget.drawer != null) 'drawer': toJson(widget.drawer!),
if (widget.endDrawer != null) 'endDrawer': toJson(widget.endDrawer!),
- if (widget.bottomSheet != null) 'bottomSheet': toJson(widget.bottomSheet!),
- if (widget.backgroundColor != null) 'backgroundColor': '#${widget.backgroundColor!.value.toRadixString(16).padLeft(8, '0')}',
- if (widget.resizeToAvoidBottomInset != null) 'resizeToAvoidBottomInset': widget.resizeToAvoidBottomInset,
+ if (widget.bottomSheet != null)
+ 'bottomSheet': toJson(widget.bottomSheet!),
+ if (widget.backgroundColor != null)
+ 'backgroundColor':
+ '#${widget.backgroundColor!.value.toRadixString(16).padLeft(8, '0')}',
+ if (widget.resizeToAvoidBottomInset != null)
+ 'resizeToAvoidBottomInset': widget.resizeToAvoidBottomInset,
if (widget.primary != null) 'primary': widget.primary,
- if (widget.floatingActionButtonLocation != null) 'floatingActionButtonLocation': widget.floatingActionButtonLocation.toString().split('.').last,
+ if (widget.floatingActionButtonLocation != null)
+ 'floatingActionButtonLocation':
+ widget.floatingActionButtonLocation.toString().split('.').last,
if (widget.extendBody != null) 'extendBody': widget.extendBody,
- if (widget.extendBodyBehindAppBar != null) 'extendBodyBehindAppBar': widget.extendBodyBehindAppBar,
- if (widget.drawerScrimColor != null) 'drawerScrimColor': '#${widget.drawerScrimColor!.value.toRadixString(16).padLeft(8, '0')}',
- if (widget.drawerEdgeDragWidth != null) 'drawerEdgeDragWidth': widget.drawerEdgeDragWidth,
- if (widget.drawerEnableOpenDragGesture != null) 'drawerEnableOpenDragGesture': widget.drawerEnableOpenDragGesture,
- if (widget.endDrawerEnableOpenDragGesture != null) 'endDrawerEnableOpenDragGesture': widget.endDrawerEnableOpenDragGesture,
+ if (widget.extendBodyBehindAppBar != null)
+ 'extendBodyBehindAppBar': widget.extendBodyBehindAppBar,
+ if (widget.drawerScrimColor != null)
+ 'drawerScrimColor':
+ '#${widget.drawerScrimColor!.value.toRadixString(16).padLeft(8, '0')}',
+ if (widget.drawerEdgeDragWidth != null)
+ 'drawerEdgeDragWidth': widget.drawerEdgeDragWidth,
+ if (widget.drawerEnableOpenDragGesture != null)
+ 'drawerEnableOpenDragGesture': widget.drawerEnableOpenDragGesture,
+ if (widget.endDrawerEnableOpenDragGesture != null)
+ 'endDrawerEnableOpenDragGesture': widget.endDrawerEnableOpenDragGesture,
};
}
@@ -1731,17 +2021,23 @@ class SduiParser {
'type': 'icon',
if (widget.icon != null) 'icon': widget.icon!.codePoint,
if (widget.size != null) 'size': widget.size,
- if (widget.color != null) 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
+ if (widget.color != null)
+ 'color': '#${widget.color!.value.toRadixString(16).padLeft(8, '0')}',
if (widget.semanticLabel != null) 'semanticLabel': widget.semanticLabel,
- if (widget.textDirection != null) 'textDirection': widget.textDirection.toString().split('.').last,
+ if (widget.textDirection != null)
+ 'textDirection': widget.textDirection.toString().split('.').last,
if (widget.opacity != null) 'opacity': widget.opacity,
- if (widget.applyTextScaling != null) 'applyTextScaling': widget.applyTextScaling,
- if (widget.shadows != null) 'shadows': widget.shadows!.map((s) => s.toString()).toList(),
+ if (widget.applyTextScaling != null)
+ 'applyTextScaling': widget.applyTextScaling,
+ if (widget.shadows != null)
+ 'shadows': widget.shadows!.map((s) => s.toString()).toList(),
};
}
static Map _toJsonEdgeInsets(EdgeInsets edge) {
- if (edge.left == edge.right && edge.left == edge.top && edge.left == edge.bottom) {
+ if (edge.left == edge.right &&
+ edge.left == edge.top &&
+ edge.left == edge.bottom) {
return {'all': edge.left};
}
return {
@@ -1754,13 +2050,17 @@ class SduiParser {
static Map _toJsonBoxDecoration(BoxDecoration decoration) {
return {
- if (decoration.color != null) 'color': '#${decoration.color!.value.toRadixString(16).padLeft(8, '0')}',
- if (decoration.borderRadius != null) 'borderRadius': decoration.borderRadius.toString(),
+ if (decoration.color != null)
+ 'color':
+ '#${decoration.color!.value.toRadixString(16).padLeft(8, '0')}',
+ if (decoration.borderRadius != null)
+ 'borderRadius': decoration.borderRadius.toString(),
// Add more as needed
};
}
- static Map _toJsonBoxConstraints(BoxConstraints constraints) {
+ static Map _toJsonBoxConstraints(
+ BoxConstraints constraints) {
return {
'minWidth': constraints.minWidth,
'maxWidth': constraints.maxWidth,
@@ -1769,7 +2069,8 @@ class SduiParser {
};
}
- static MainAxisAlignmentProto _mainAxisAlignmentToProto(MainAxisAlignment value) {
+ static MainAxisAlignmentProto _mainAxisAlignmentToProto(
+ MainAxisAlignment value) {
switch (value) {
case MainAxisAlignment.start:
return MainAxisAlignmentProto.MAIN_AXIS_START;
@@ -1783,12 +2084,11 @@ class SduiParser {
return MainAxisAlignmentProto.SPACE_AROUND;
case MainAxisAlignment.spaceEvenly:
return MainAxisAlignmentProto.SPACE_EVENLY;
- default:
- return MainAxisAlignmentProto.MAIN_AXIS_START;
}
}
- static CrossAxisAlignmentProto _crossAxisAlignmentToProto(CrossAxisAlignment value) {
+ static CrossAxisAlignmentProto _crossAxisAlignmentToProto(
+ CrossAxisAlignment value) {
switch (value) {
case CrossAxisAlignment.start:
return CrossAxisAlignmentProto.CROSS_AXIS_START;
@@ -1800,8 +2100,6 @@ class SduiParser {
return CrossAxisAlignmentProto.STRETCH;
case CrossAxisAlignment.baseline:
return CrossAxisAlignmentProto.BASELINE;
- default:
- return CrossAxisAlignmentProto.CROSS_AXIS_CENTER;
}
}
@@ -1811,8 +2109,6 @@ class SduiParser {
return MainAxisSizeProto.MIN;
case MainAxisSize.max:
return MainAxisSizeProto.MAX;
- default:
- return MainAxisSizeProto.MAX;
}
}
@@ -1822,19 +2118,16 @@ class SduiParser {
return TextDirectionProto.LTR;
case TextDirection.rtl:
return TextDirectionProto.RTL;
- default:
- return TextDirectionProto.LTR;
}
}
- static VerticalDirectionProto _verticalDirectionToProto(VerticalDirection value) {
+ static VerticalDirectionProto _verticalDirectionToProto(
+ VerticalDirection value) {
switch (value) {
case VerticalDirection.up:
return VerticalDirectionProto.UP;
case VerticalDirection.down:
return VerticalDirectionProto.DOWN;
- default:
- return VerticalDirectionProto.DOWN;
}
}
@@ -1844,8 +2137,6 @@ class SduiParser {
return TextBaselineProto.ALPHABETIC;
case TextBaseline.ideographic:
return TextBaselineProto.IDEOGRAPHIC;
- default:
- return TextBaselineProto.ALPHABETIC;
}
}
@@ -1918,10 +2209,12 @@ class SduiParser {
final data = SduiWidgetData()..type = WidgetType.COLUMN;
data.children.addAll(col.children.map((c) => SduiParser.toProto(c)));
if (col.mainAxisAlignment != null) {
- data.mainAxisAlignment = _mainAxisAlignmentToProto(col.mainAxisAlignment!);
+ data.mainAxisAlignment =
+ _mainAxisAlignmentToProto(col.mainAxisAlignment!);
}
if (col.crossAxisAlignment != null) {
- data.crossAxisAlignment = _crossAxisAlignmentToProto(col.crossAxisAlignment!);
+ data.crossAxisAlignment =
+ _crossAxisAlignmentToProto(col.crossAxisAlignment!);
}
if (col.mainAxisSize != null) {
data.mainAxisSize = _mainAxisSizeToProto(col.mainAxisSize!);
@@ -1930,7 +2223,8 @@ class SduiParser {
data.textDirection = _textDirectionToProto(col.textDirection!);
}
if (col.verticalDirection != null) {
- data.verticalDirection = _verticalDirectionToProto(col.verticalDirection!);
+ data.verticalDirection =
+ _verticalDirectionToProto(col.verticalDirection!);
}
if (col.textBaseline != null) {
data.textBaseline = _textBaselineToProto(col.textBaseline!);
@@ -1942,7 +2236,8 @@ class SduiParser {
return SduiColumn(
children: data.children.map((c) => SduiParser.parseProto(c)).toList(),
mainAxisAlignment: _parseProtoMainAxisAlignment(data.mainAxisAlignment),
- crossAxisAlignment: _parseProtoCrossAxisAlignment(data.crossAxisAlignment),
+ crossAxisAlignment:
+ _parseProtoCrossAxisAlignment(data.crossAxisAlignment),
mainAxisSize: _parseProtoMainAxisSize(data.mainAxisSize),
textDirection: _parseProtoTextDirection(data.textDirection),
verticalDirection: _parseProtoVerticalDirection(data.verticalDirection),
@@ -1970,7 +2265,8 @@ class SduiParser {
} else if (widget is SduiIcon) {
return iconToProto(widget);
}
- throw UnimplementedError('toProto not implemented for [38;5;9m${widget.runtimeType}[0m');
+ throw UnimplementedError(
+ 'toProto not implemented for [38;5;9m${widget.runtimeType}[0m');
}
static SduiWidget fromProto(SduiWidgetData data) {
@@ -2002,22 +2298,45 @@ class SduiParser {
static SduiWidgetData rowToProto(SduiRow row) {
final data = SduiWidgetData()..type = WidgetType.ROW;
data.children.addAll(row.children.map((c) => SduiParser.toProto(c)));
- if (row.mainAxisAlignment != null) data.mainAxisAlignment = _mainAxisAlignmentToProto(row.mainAxisAlignment!);
- if (row.crossAxisAlignment != null) data.crossAxisAlignment = _crossAxisAlignmentToProto(row.crossAxisAlignment!);
- if (row.mainAxisSize != null) data.mainAxisSize = _mainAxisSizeToProto(row.mainAxisSize!);
- if (row.textDirection != null) data.textDirection = _textDirectionToProto(row.textDirection!);
- if (row.verticalDirection != null) data.verticalDirection = _verticalDirectionToProto(row.verticalDirection!);
- if (row.textBaseline != null) data.textBaseline = _textBaselineToProto(row.textBaseline!);
+ if (row.mainAxisAlignment != null) {
+ data.mainAxisAlignment =
+ _mainAxisAlignmentToProto(row.mainAxisAlignment!);
+ }
+ if (row.crossAxisAlignment != null) {
+ data.crossAxisAlignment =
+ _crossAxisAlignmentToProto(row.crossAxisAlignment!);
+ }
+ if (row.mainAxisSize != null) {
+ data.mainAxisSize = _mainAxisSizeToProto(row.mainAxisSize!);
+ }
+ if (row.textDirection != null) {
+ data.textDirection = _textDirectionToProto(row.textDirection!);
+ }
+ if (row.verticalDirection != null) {
+ data.verticalDirection =
+ _verticalDirectionToProto(row.verticalDirection!);
+ }
+ if (row.textBaseline != null) {
+ data.textBaseline = _textBaselineToProto(row.textBaseline!);
+ }
return data;
}
static SduiRow rowFromProto(SduiWidgetData data) {
- List children = data.children.map((c) => SduiParser.parseProto(c)).toList();
- MainAxisAlignment mainAxisAlignment = _parseProtoMainAxisAlignment(data.mainAxisAlignment) ?? MainAxisAlignment.start;
- CrossAxisAlignment crossAxisAlignment = _parseProtoCrossAxisAlignment(data.crossAxisAlignment) ?? CrossAxisAlignment.center;
- MainAxisSize mainAxisSize = _parseProtoMainAxisSize(data.mainAxisSize) ?? MainAxisSize.max;
+ List children =
+ data.children.map((c) => SduiParser.parseProto(c)).toList();
+ MainAxisAlignment mainAxisAlignment =
+ _parseProtoMainAxisAlignment(data.mainAxisAlignment) ??
+ MainAxisAlignment.start;
+ CrossAxisAlignment crossAxisAlignment =
+ _parseProtoCrossAxisAlignment(data.crossAxisAlignment) ??
+ CrossAxisAlignment.center;
+ MainAxisSize mainAxisSize =
+ _parseProtoMainAxisSize(data.mainAxisSize) ?? MainAxisSize.max;
TextDirection? textDirection = _parseProtoTextDirection(data.textDirection);
- VerticalDirection verticalDirection = _parseProtoVerticalDirection(data.verticalDirection) ?? VerticalDirection.down;
+ VerticalDirection verticalDirection =
+ _parseProtoVerticalDirection(data.verticalDirection) ??
+ VerticalDirection.down;
TextBaseline? textBaseline = _parseProtoTextBaseline(data.textBaseline);
return SduiRow(
children: children,
@@ -2035,26 +2354,37 @@ class SduiParser {
final data = SduiWidgetData()..type = WidgetType.TEXT;
data.stringAttributes['text'] = text.text;
if (text.style != null) data.textStyle = _textStyleToProto(text.style!);
- if (text.textAlign != null) data.textAlign = _textAlignToProto(text.textAlign!);
- if (text.overflow != null) data.overflow = _textOverflowToProto(text.overflow!);
+ if (text.textAlign != null) {
+ data.textAlign = _textAlignToProto(text.textAlign!);
+ }
+ if (text.overflow != null) {
+ data.overflow = _textOverflowToProto(text.overflow!);
+ }
if (text.maxLines != null) data.maxLines = text.maxLines!;
if (text.softWrap != null) data.softWrap = text.softWrap!;
if (text.letterSpacing != null) data.letterSpacing = text.letterSpacing!;
if (text.wordSpacing != null) data.wordSpacing = text.wordSpacing!;
if (text.height != null) data.height = text.height!;
if (text.fontFamily != null) data.fontFamily = text.fontFamily!;
- if (text.textDirection != null) data.textDirection = _textDirectionToProto(text.textDirection!);
+ if (text.textDirection != null) {
+ data.textDirection = _textDirectionToProto(text.textDirection!);
+ }
// Individual style overrides
- if (text.decoration != null) data.textStyle.decoration = _textDecorationToProto(text.decoration!);
+ if (text.decoration != null) {
+ data.textStyle.decoration = _textDecorationToProto(text.decoration!);
+ }
if (text.fontSize != null) data.textStyle.fontSize = text.fontSize!;
- if (text.fontWeight != null) data.textStyle.fontWeight = text.fontWeight.toString().split('.').last;
+ if (text.fontWeight != null) {
+ data.textStyle.fontWeight = text.fontWeight.toString().split('.').last;
+ }
if (text.color != null) data.textStyle.color = _colorToProto(text.color!);
return data;
}
static SduiText textFromProto(SduiWidgetData data) {
String text = data.stringAttributes['text'] ?? '';
- TextStyle? style = data.hasTextStyle() ? _parseProtoTextStyle(data.textStyle) : null;
+ TextStyle? style =
+ data.hasTextStyle() ? _parseProtoTextStyle(data.textStyle) : null;
TextAlign? textAlign = _parseProtoTextAlign(data.textAlign);
TextOverflow? overflow = _parseProtoTextOverflow(data.overflow);
int? maxLines = data.hasMaxLines() ? data.maxLines : null;
@@ -2065,10 +2395,20 @@ class SduiParser {
String? fontFamily = data.hasFontFamily() ? data.fontFamily : null;
TextDirection? textDirection = _parseProtoTextDirection(data.textDirection);
// Individual style overrides
- TextDecoration? decoration = data.hasTextStyle() && data.textStyle.hasDecoration() ? _parseProtoTextDecoration(data.textStyle.decoration) : null;
- double? fontSize = data.hasTextStyle() && data.textStyle.hasFontSize() ? data.textStyle.fontSize : null;
- FontWeight? fontWeight = data.hasTextStyle() && data.textStyle.fontWeight.isNotEmpty ? _parseProtoFontWeight(data.textStyle.fontWeight) : null;
- Color? color = data.hasTextStyle() && data.textStyle.hasColor() ? _parseProtoColor(data.textStyle.color) : null;
+ TextDecoration? decoration =
+ data.hasTextStyle() && data.textStyle.hasDecoration()
+ ? _parseProtoTextDecoration(data.textStyle.decoration)
+ : null;
+ double? fontSize = data.hasTextStyle() && data.textStyle.hasFontSize()
+ ? data.textStyle.fontSize
+ : null;
+ FontWeight? fontWeight =
+ data.hasTextStyle() && data.textStyle.fontWeight.isNotEmpty
+ ? _parseProtoFontWeight(data.textStyle.fontWeight)
+ : null;
+ Color? color = data.hasTextStyle() && data.textStyle.hasColor()
+ ? _parseProtoColor(data.textStyle.color)
+ : null;
return SduiText(
text,
style: style,
@@ -2094,15 +2434,29 @@ class SduiParser {
data.stringAttributes['src'] = image.src;
if (image.width != null) data.doubleAttributes['width'] = image.width!;
if (image.height != null) data.doubleAttributes['height'] = image.height!;
- if (image.fit != null) data.stringAttributes['fit'] = image.fit.toString().split('.').last;
- if (image.alignment != null) data.alignment = _alignmentToProto(image.alignment!);
+ if (image.fit != null) {
+ data.stringAttributes['fit'] = image.fit.toString().split('.').last;
+ }
+ if (image.alignment != null) {
+ data.alignment = _alignmentToProto(image.alignment!);
+ }
if (image.repeat != null) data.repeat = _imageRepeatToProto(image.repeat!);
if (image.color != null) data.color = _colorToProto(image.color!);
- if (image.colorBlendMode != null) data.colorBlendMode = _blendModeToProto(image.colorBlendMode!);
- if (image.centerSlice != null) data.centerSlice = _rectToProto(image.centerSlice!);
- if (image.matchTextDirection != null) data.matchTextDirection = image.matchTextDirection!;
- if (image.gaplessPlayback != null) data.gaplessPlayback = image.gaplessPlayback!;
- if (image.filterQuality != null) data.filterQuality = _filterQualityToProto(image.filterQuality!);
+ if (image.colorBlendMode != null) {
+ data.colorBlendMode = _blendModeToProto(image.colorBlendMode!);
+ }
+ if (image.centerSlice != null) {
+ data.centerSlice = _rectToProto(image.centerSlice!);
+ }
+ if (image.matchTextDirection != null) {
+ data.matchTextDirection = image.matchTextDirection!;
+ }
+ if (image.gaplessPlayback != null) {
+ data.gaplessPlayback = image.gaplessPlayback!;
+ }
+ if (image.filterQuality != null) {
+ data.filterQuality = _filterQualityToProto(image.filterQuality!);
+ }
if (image.cacheWidth != null) data.cacheWidth = image.cacheWidth!;
if (image.cacheHeight != null) data.cacheHeight = image.cacheHeight!;
if (image.scale != null) data.scale = image.scale!;
@@ -2116,14 +2470,20 @@ class SduiParser {
double? width = data.doubleAttributes['width'];
double? height = data.doubleAttributes['height'];
BoxFit? fit = _parseProtoBoxFit(data.stringAttributes['fit']);
- Alignment alignment = _parseProtoAlignment(data.alignment) ?? Alignment.center;
- ImageRepeat repeat = _parseProtoImageRepeat(data.repeat) ?? ImageRepeat.noRepeat;
+ Alignment alignment =
+ _parseProtoAlignment(data.alignment) ?? Alignment.center;
+ ImageRepeat repeat =
+ _parseProtoImageRepeat(data.repeat) ?? ImageRepeat.noRepeat;
Color? color = data.hasColor() ? _parseProtoColor(data.color) : null;
BlendMode? colorBlendMode = _parseProtoBlendMode(data.colorBlendMode);
- Rect? centerSlice = data.hasCenterSlice() ? _parseProtoRect(data.centerSlice) : null;
- bool matchTextDirection = data.hasMatchTextDirection() ? data.matchTextDirection : false;
- bool gaplessPlayback = data.hasGaplessPlayback() ? data.gaplessPlayback : false;
- FilterQuality filterQuality = _parseProtoFilterQuality(data.filterQuality) ?? FilterQuality.low;
+ Rect? centerSlice =
+ data.hasCenterSlice() ? _parseProtoRect(data.centerSlice) : null;
+ bool matchTextDirection =
+ data.hasMatchTextDirection() ? data.matchTextDirection : false;
+ bool gaplessPlayback =
+ data.hasGaplessPlayback() ? data.gaplessPlayback : false;
+ FilterQuality filterQuality =
+ _parseProtoFilterQuality(data.filterQuality) ?? FilterQuality.low;
int? cacheWidth = data.hasCacheWidth() ? data.cacheWidth : null;
int? cacheHeight = data.hasCacheHeight() ? data.cacheHeight : null;
double scale = data.hasScale() ? data.scale : 1.0;
@@ -2259,7 +2619,8 @@ class SduiParser {
static SduiSizedBox sizedBoxFromProto(SduiWidgetData data) {
double? width = data.doubleAttributes['width'];
double? height = data.doubleAttributes['height'];
- SduiWidget? child = data.hasChild() ? SduiParser.parseProto(data.child) : null;
+ SduiWidget? child =
+ data.hasChild() ? SduiParser.parseProto(data.child) : null;
return SduiSizedBox(width: width, height: height, child: child);
}
@@ -2269,33 +2630,57 @@ class SduiParser {
if (c.child != null) data.child = toProto(c.child!);
if (c.padding != null) data.padding = _edgeInsetsToProto(c.padding!);
if (c.margin != null) data.margin = _edgeInsetsToProto(c.margin!);
- if (c.decoration != null) data.boxDecoration = _boxDecorationToProto(c.decoration!);
+ if (c.decoration != null) {
+ data.boxDecoration = _boxDecorationToProto(c.decoration!);
+ }
if (c.width != null) data.doubleAttributes['width'] = c.width!;
if (c.height != null) data.doubleAttributes['height'] = c.height!;
// Only set color if decoration is null
- if (c.decoration == null && c.color != null) data.color = _colorToProto(c.color!);
+ if (c.decoration == null && c.color != null) {
+ data.color = _colorToProto(c.color!);
+ }
if (c.alignment != null) data.alignment = _alignmentToProto(c.alignment!);
- if (c.constraints != null) data.constraints = _boxConstraintsToProto(c.constraints!);
+ if (c.constraints != null) {
+ data.constraints = _boxConstraintsToProto(c.constraints!);
+ }
if (c.transform != null) data.transform = _matrix4ToProto(c.transform!);
- if (c.transformAlignment != null) data.transformAlignment = _alignmentGeometryToProto(c.transformAlignment!);
- if (c.clipBehavior != null && c.clipBehavior != Clip.none) data.clipBehavior = _clipToProto(c.clipBehavior!);
+ if (c.transformAlignment != null) {
+ data.transformAlignment =
+ _alignmentGeometryToProto(c.transformAlignment!);
+ }
+ if (c.clipBehavior != null && c.clipBehavior != Clip.none) {
+ data.clipBehavior = _clipToProto(c.clipBehavior!);
+ }
return data;
}
static SduiContainer containerFromProto(SduiWidgetData data) {
- SduiWidget? child = data.hasChild() ? SduiParser.parseProto(data.child) : null;
- EdgeInsets? padding = data.hasPadding() ? _parseProtoEdgeInsets(data.padding) : null;
- EdgeInsets? margin = data.hasMargin() ? _parseProtoEdgeInsets(data.margin) : null;
- BoxDecoration? decoration = data.hasBoxDecoration() ? _parseProtoBoxDecoration(data.boxDecoration) : null;
+ SduiWidget? child =
+ data.hasChild() ? SduiParser.parseProto(data.child) : null;
+ EdgeInsets? padding =
+ data.hasPadding() ? _parseProtoEdgeInsets(data.padding) : null;
+ EdgeInsets? margin =
+ data.hasMargin() ? _parseProtoEdgeInsets(data.margin) : null;
+ BoxDecoration? decoration = data.hasBoxDecoration()
+ ? _parseProtoBoxDecoration(data.boxDecoration)
+ : null;
double? width = data.doubleAttributes['width'];
double? height = data.doubleAttributes['height'];
// Only use color if decoration is null
- Color? color = (decoration == null && data.hasColor()) ? _parseProtoColor(data.color) : null;
+ Color? color = (decoration == null && data.hasColor())
+ ? _parseProtoColor(data.color)
+ : null;
Alignment? alignment = _parseProtoAlignment(data.alignment);
- BoxConstraints? constraints = data.hasConstraints() ? _parseProtoBoxConstraints(data.constraints) : null;
- Matrix4? transform = data.hasTransform() ? _parseProtoTransform(data.transform) : null;
- AlignmentGeometry? transformAlignment = data.hasTransformAlignment() ? _parseProtoAlignmentGeometry(data.transformAlignment) : null;
- Clip? clipBehavior = data.hasClipBehavior() ? _parseProtoClip(data.clipBehavior) : Clip.none;
+ BoxConstraints? constraints = data.hasConstraints()
+ ? _parseProtoBoxConstraints(data.constraints)
+ : null;
+ Matrix4? transform =
+ data.hasTransform() ? _parseProtoTransform(data.transform) : null;
+ AlignmentGeometry? transformAlignment = data.hasTransformAlignment()
+ ? _parseProtoAlignmentGeometry(data.transformAlignment)
+ : null;
+ Clip? clipBehavior =
+ data.hasClipBehavior() ? _parseProtoClip(data.clipBehavior) : Clip.none;
return SduiContainer(
child: child,
padding: padding,
@@ -2314,7 +2699,9 @@ class SduiParser {
static EdgeInsetsData _edgeInsetsToProto(EdgeInsets edge) {
final data = EdgeInsetsData();
- if (edge.left == edge.right && edge.left == edge.top && edge.left == edge.bottom) {
+ if (edge.left == edge.right &&
+ edge.left == edge.top &&
+ edge.left == edge.bottom) {
data.all = edge.left;
} else {
data.left = edge.left;
@@ -2328,8 +2715,10 @@ class SduiParser {
static BoxDecorationData _boxDecorationToProto(BoxDecoration decoration) {
final data = BoxDecorationData();
if (decoration.color != null) data.color = _colorToProto(decoration.color!);
- if (decoration.borderRadius != null && decoration.borderRadius is BorderRadius) {
- data.borderRadius = _borderRadiusToProto(decoration.borderRadius as BorderRadius);
+ if (decoration.borderRadius != null &&
+ decoration.borderRadius is BorderRadius) {
+ data.borderRadius =
+ _borderRadiusToProto(decoration.borderRadius as BorderRadius);
}
// Add more as needed
return data;
@@ -2379,7 +2768,8 @@ class SduiParser {
return _alignmentToProto(alignment);
}
// Fallback: center
- return AlignmentData()..predefined = AlignmentData_PredefinedAlignment.CENTER_ALIGN;
+ return AlignmentData()
+ ..predefined = AlignmentData_PredefinedAlignment.CENTER_ALIGN;
}
static ClipProto _clipToProto(Clip clip) {
@@ -2400,42 +2790,87 @@ class SduiParser {
final data = SduiWidgetData()..type = WidgetType.SCAFFOLD;
if (s.appBar != null) data.appBar = toProto(s.appBar!);
if (s.body != null) data.body = toProto(s.body!);
- if (s.floatingActionButton != null) data.floatingActionButton = toProto(s.floatingActionButton!);
- if (s.bottomNavigationBar != null) data.bottomNavigationBar = toProto(s.bottomNavigationBar!);
+ if (s.floatingActionButton != null) {
+ data.floatingActionButton = toProto(s.floatingActionButton!);
+ }
+ if (s.bottomNavigationBar != null) {
+ data.bottomNavigationBar = toProto(s.bottomNavigationBar!);
+ }
if (s.drawer != null) data.drawer = toProto(s.drawer!);
if (s.endDrawer != null) data.endDrawer = toProto(s.endDrawer!);
if (s.bottomSheet != null) data.bottomSheet = toProto(s.bottomSheet!);
- if (s.backgroundColor != null) data.backgroundColor = _colorToProto(s.backgroundColor!);
- if (s.resizeToAvoidBottomInset != null) data.resizeToAvoidBottomInset = s.resizeToAvoidBottomInset!;
+ if (s.backgroundColor != null) {
+ data.backgroundColor = _colorToProto(s.backgroundColor!);
+ }
+ if (s.resizeToAvoidBottomInset != null) {
+ data.resizeToAvoidBottomInset = s.resizeToAvoidBottomInset!;
+ }
if (s.primary != null) data.primary = s.primary!;
- if (s.floatingActionButtonLocation != null) data.floatingActionButtonLocation = _fabLocationToProto(s.floatingActionButtonLocation!);
+ if (s.floatingActionButtonLocation != null) {
+ data.floatingActionButtonLocation =
+ _fabLocationToProto(s.floatingActionButtonLocation!);
+ }
if (s.extendBody != null) data.extendBody = s.extendBody!;
- if (s.extendBodyBehindAppBar != null) data.extendBodyBehindAppBar = s.extendBodyBehindAppBar!;
- if (s.drawerScrimColor != null) data.drawerScrimColor = _colorToProto(s.drawerScrimColor!);
- if (s.drawerEdgeDragWidth != null) data.drawerEdgeDragWidth = s.drawerEdgeDragWidth!;
- if (s.drawerEnableOpenDragGesture != null) data.drawerEnableOpenDragGesture = s.drawerEnableOpenDragGesture!;
- if (s.endDrawerEnableOpenDragGesture != null) data.endDrawerEnableOpenDragGesture = s.endDrawerEnableOpenDragGesture!;
+ if (s.extendBodyBehindAppBar != null) {
+ data.extendBodyBehindAppBar = s.extendBodyBehindAppBar!;
+ }
+ if (s.drawerScrimColor != null) {
+ data.drawerScrimColor = _colorToProto(s.drawerScrimColor!);
+ }
+ if (s.drawerEdgeDragWidth != null) {
+ data.drawerEdgeDragWidth = s.drawerEdgeDragWidth!;
+ }
+ if (s.drawerEnableOpenDragGesture != null) {
+ data.drawerEnableOpenDragGesture = s.drawerEnableOpenDragGesture!;
+ }
+ if (s.endDrawerEnableOpenDragGesture != null) {
+ data.endDrawerEnableOpenDragGesture = s.endDrawerEnableOpenDragGesture!;
+ }
return data;
}
static SduiScaffold scaffoldFromProto(SduiWidgetData data) {
- SduiWidget? appBar = data.hasAppBar() ? SduiParser.parseProto(data.appBar) : null;
+ SduiWidget? appBar =
+ data.hasAppBar() ? SduiParser.parseProto(data.appBar) : null;
SduiWidget? body = data.hasBody() ? SduiParser.parseProto(data.body) : null;
- SduiWidget? floatingActionButton = data.hasFloatingActionButton() ? SduiParser.parseProto(data.floatingActionButton) : null;
- SduiWidget? bottomNavigationBar = data.hasBottomNavigationBar() ? SduiParser.parseProto(data.bottomNavigationBar) : null;
- SduiWidget? drawer = data.hasDrawer() ? SduiParser.parseProto(data.drawer) : null;
- SduiWidget? endDrawer = data.hasEndDrawer() ? SduiParser.parseProto(data.endDrawer) : null;
- SduiWidget? bottomSheet = data.hasBottomSheet() ? SduiParser.parseProto(data.bottomSheet) : null;
- Color? backgroundColor = data.hasBackgroundColor() ? _parseProtoColor(data.backgroundColor) : null;
- bool? resizeToAvoidBottomInset = data.hasResizeToAvoidBottomInset() ? data.resizeToAvoidBottomInset : null;
+ SduiWidget? floatingActionButton = data.hasFloatingActionButton()
+ ? SduiParser.parseProto(data.floatingActionButton)
+ : null;
+ SduiWidget? bottomNavigationBar = data.hasBottomNavigationBar()
+ ? SduiParser.parseProto(data.bottomNavigationBar)
+ : null;
+ SduiWidget? drawer =
+ data.hasDrawer() ? SduiParser.parseProto(data.drawer) : null;
+ SduiWidget? endDrawer =
+ data.hasEndDrawer() ? SduiParser.parseProto(data.endDrawer) : null;
+ SduiWidget? bottomSheet =
+ data.hasBottomSheet() ? SduiParser.parseProto(data.bottomSheet) : null;
+ Color? backgroundColor = data.hasBackgroundColor()
+ ? _parseProtoColor(data.backgroundColor)
+ : null;
+ bool? resizeToAvoidBottomInset = data.hasResizeToAvoidBottomInset()
+ ? data.resizeToAvoidBottomInset
+ : null;
bool primary = data.hasPrimary() ? data.primary : true;
- FloatingActionButtonLocation? floatingActionButtonLocation = data.hasFloatingActionButtonLocation() ? _parseProtoFabLocation(data.floatingActionButtonLocation) : null;
+ FloatingActionButtonLocation? floatingActionButtonLocation =
+ data.hasFloatingActionButtonLocation()
+ ? _parseProtoFabLocation(data.floatingActionButtonLocation)
+ : null;
bool extendBody = data.hasExtendBody() ? data.extendBody : false;
- bool extendBodyBehindAppBar = data.hasExtendBodyBehindAppBar() ? data.extendBodyBehindAppBar : false;
- Color? drawerScrimColor = data.hasDrawerScrimColor() ? _parseProtoColor(data.drawerScrimColor) : null;
- double? drawerEdgeDragWidth = data.hasDrawerEdgeDragWidth() ? data.drawerEdgeDragWidth : null;
- bool drawerEnableOpenDragGesture = data.hasDrawerEnableOpenDragGesture() ? data.drawerEnableOpenDragGesture : true;
- bool endDrawerEnableOpenDragGesture = data.hasEndDrawerEnableOpenDragGesture() ? data.endDrawerEnableOpenDragGesture : true;
+ bool extendBodyBehindAppBar =
+ data.hasExtendBodyBehindAppBar() ? data.extendBodyBehindAppBar : false;
+ Color? drawerScrimColor = data.hasDrawerScrimColor()
+ ? _parseProtoColor(data.drawerScrimColor)
+ : null;
+ double? drawerEdgeDragWidth =
+ data.hasDrawerEdgeDragWidth() ? data.drawerEdgeDragWidth : null;
+ bool drawerEnableOpenDragGesture = data.hasDrawerEnableOpenDragGesture()
+ ? data.drawerEnableOpenDragGesture
+ : true;
+ bool endDrawerEnableOpenDragGesture =
+ data.hasEndDrawerEnableOpenDragGesture()
+ ? data.endDrawerEnableOpenDragGesture
+ : true;
return SduiScaffold(
appBar: appBar,
body: body,
@@ -2457,20 +2892,45 @@ class SduiParser {
);
}
- static FloatingActionButtonLocationProto _fabLocationToProto(FloatingActionButtonLocation loc) {
+ static FloatingActionButtonLocationProto _fabLocationToProto(
+ FloatingActionButtonLocation loc) {
// Use the same mapping as _parseProtoFabLocation, but reversed
- if (loc == FloatingActionButtonLocation.startTop) return FloatingActionButtonLocationProto.FAB_START_TOP;
- if (loc == FloatingActionButtonLocation.startFloat) return FloatingActionButtonLocationProto.FAB_START_FLOAT;
- if (loc == FloatingActionButtonLocation.centerTop) return FloatingActionButtonLocationProto.FAB_CENTER_TOP;
- if (loc == FloatingActionButtonLocation.centerFloat) return FloatingActionButtonLocationProto.FAB_CENTER_FLOAT;
- if (loc == FloatingActionButtonLocation.endTop) return FloatingActionButtonLocationProto.FAB_END_TOP;
- if (loc == FloatingActionButtonLocation.endFloat) return FloatingActionButtonLocationProto.FAB_END_FLOAT;
- if (loc == FloatingActionButtonLocation.miniCenterTop) return FloatingActionButtonLocationProto.FAB_MINI_CENTER_TOP;
- if (loc == FloatingActionButtonLocation.miniCenterFloat) return FloatingActionButtonLocationProto.FAB_MINI_CENTER_FLOAT;
- if (loc == FloatingActionButtonLocation.miniStartTop) return FloatingActionButtonLocationProto.FAB_MINI_START_TOP;
- if (loc == FloatingActionButtonLocation.miniStartFloat) return FloatingActionButtonLocationProto.FAB_MINI_START_FLOAT;
- if (loc == FloatingActionButtonLocation.miniEndTop) return FloatingActionButtonLocationProto.FAB_MINI_END_TOP;
- if (loc == FloatingActionButtonLocation.miniEndFloat) return FloatingActionButtonLocationProto.FAB_MINI_END_FLOAT;
+ if (loc == FloatingActionButtonLocation.startTop) {
+ return FloatingActionButtonLocationProto.FAB_START_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.startFloat) {
+ return FloatingActionButtonLocationProto.FAB_START_FLOAT;
+ }
+ if (loc == FloatingActionButtonLocation.centerTop) {
+ return FloatingActionButtonLocationProto.FAB_CENTER_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.centerFloat) {
+ return FloatingActionButtonLocationProto.FAB_CENTER_FLOAT;
+ }
+ if (loc == FloatingActionButtonLocation.endTop) {
+ return FloatingActionButtonLocationProto.FAB_END_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.endFloat) {
+ return FloatingActionButtonLocationProto.FAB_END_FLOAT;
+ }
+ if (loc == FloatingActionButtonLocation.miniCenterTop) {
+ return FloatingActionButtonLocationProto.FAB_MINI_CENTER_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.miniCenterFloat) {
+ return FloatingActionButtonLocationProto.FAB_MINI_CENTER_FLOAT;
+ }
+ if (loc == FloatingActionButtonLocation.miniStartTop) {
+ return FloatingActionButtonLocationProto.FAB_MINI_START_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.miniStartFloat) {
+ return FloatingActionButtonLocationProto.FAB_MINI_START_FLOAT;
+ }
+ if (loc == FloatingActionButtonLocation.miniEndTop) {
+ return FloatingActionButtonLocationProto.FAB_MINI_END_TOP;
+ }
+ if (loc == FloatingActionButtonLocation.miniEndFloat) {
+ return FloatingActionButtonLocationProto.FAB_MINI_END_FLOAT;
+ }
return FloatingActionButtonLocationProto.FAB_CENTER_FLOAT;
}
@@ -2497,22 +2957,32 @@ class SduiParser {
if (icon.size != null) data.icon.size = icon.size!;
if (icon.color != null) data.icon.color = _colorToProto(icon.color!);
if (icon.semanticLabel != null) data.semanticLabel = icon.semanticLabel!;
- if (icon.textDirection != null) data.textDirection = _textDirectionToProto(icon.textDirection!);
+ if (icon.textDirection != null) {
+ data.textDirection = _textDirectionToProto(icon.textDirection!);
+ }
if (icon.opacity != null) data.opacity = icon.opacity!;
- if (icon.applyTextScaling != null) data.applyTextScaling = icon.applyTextScaling!;
- if (icon.shadows != null) data.shadows.addAll(icon.shadows!.map(_shadowToProto));
+ if (icon.applyTextScaling != null) {
+ data.applyTextScaling = icon.applyTextScaling!;
+ }
+ if (icon.shadows != null) {
+ data.shadows.addAll(icon.shadows!.map(_shadowToProto));
+ }
return data;
}
static SduiIcon iconFromProto(SduiWidgetData data) {
IconData? iconData = data.hasIcon() ? _parseProtoIconData(data.icon) : null;
double? size = data.icon.size;
- Color? color = data.icon.hasColor() ? _parseProtoColor(data.icon.color) : null;
+ Color? color =
+ data.icon.hasColor() ? _parseProtoColor(data.icon.color) : null;
String? semanticLabel = data.hasSemanticLabel() ? data.semanticLabel : null;
TextDirection? textDirection = _parseProtoTextDirection(data.textDirection);
double? opacity = data.hasOpacity() ? data.opacity : null;
- bool? applyTextScaling = data.hasApplyTextScaling() ? data.applyTextScaling : null;
- List? shadows = data.shadows.isNotEmpty ? data.shadows.map((s) => _parseProtoShadow(s)).toList() : null;
+ bool? applyTextScaling =
+ data.hasApplyTextScaling() ? data.applyTextScaling : null;
+ List? shadows = data.shadows.isNotEmpty
+ ? data.shadows.map((s) => _parseProtoShadow(s)).toList()
+ : null;
return SduiIcon(
icon: iconData,
size: size,
@@ -2538,13 +3008,19 @@ class SduiParser {
final data = TextStyleData();
if (style.color != null) data.color = _colorToProto(style.color!);
if (style.fontSize != null) data.fontSize = style.fontSize!;
- if (style.fontWeight != null) data.fontWeight = style.fontWeight.toString().split('.').last;
- if (style.decoration != null) data.decoration = _textDecorationToProto(style.decoration!);
+ if (style.fontWeight != null) {
+ data.fontWeight = style.fontWeight.toString().split('.').last;
+ }
+ if (style.decoration != null) {
+ data.decoration = _textDecorationToProto(style.decoration!);
+ }
if (style.letterSpacing != null) data.letterSpacing = style.letterSpacing!;
if (style.wordSpacing != null) data.wordSpacing = style.wordSpacing!;
if (style.height != null) data.height = style.height!;
if (style.fontFamily != null) data.fontFamily = style.fontFamily!;
- if (style.fontStyle != null) data.fontStyle = _fontStyleToProto(style.fontStyle!);
+ if (style.fontStyle != null) {
+ data.fontStyle = _fontStyleToProto(style.fontStyle!);
+ }
return data;
}
@@ -2562,8 +3038,6 @@ class SduiParser {
return TextAlignProto.TEXT_ALIGN_START;
case TextAlign.end:
return TextAlignProto.TEXT_ALIGN_END;
- default:
- return TextAlignProto.LEFT;
}
}
@@ -2577,24 +3051,30 @@ class SduiParser {
return TextOverflowProto.FADE;
case TextOverflow.visible:
return TextOverflowProto.VISIBLE;
- default:
- return TextOverflowProto.CLIP;
}
}
static ColorData _colorToProto(Color color) {
return ColorData()
- ..alpha = color.alpha
- ..red = color.red
- ..green = color.green
- ..blue = color.blue;
+ ..alpha = ((color.a * 255.0).round() & 0xff)
+ ..red = ((color.r * 255.0).round() & 0xff)
+ ..green = ((color.g * 255.0).round() & 0xff)
+ ..blue = ((color.b * 255.0).round() & 0xff);
}
static TextDecorationProto _textDecorationToProto(TextDecoration decoration) {
- if (decoration == TextDecoration.none) return TextDecorationProto.TEXT_DECORATION_NONE;
- if (decoration == TextDecoration.underline) return TextDecorationProto.UNDERLINE;
- if (decoration == TextDecoration.overline) return TextDecorationProto.OVERLINE;
- if (decoration == TextDecoration.lineThrough) return TextDecorationProto.LINE_THROUGH;
+ if (decoration == TextDecoration.none) {
+ return TextDecorationProto.TEXT_DECORATION_NONE;
+ }
+ if (decoration == TextDecoration.underline) {
+ return TextDecorationProto.UNDERLINE;
+ }
+ if (decoration == TextDecoration.overline) {
+ return TextDecorationProto.OVERLINE;
+ }
+ if (decoration == TextDecoration.lineThrough) {
+ return TextDecorationProto.LINE_THROUGH;
+ }
return TextDecorationProto.TEXT_DECORATION_NONE;
}
@@ -2604,8 +3084,6 @@ class SduiParser {
return FontStyleProto.NORMAL;
case FontStyle.italic:
return FontStyleProto.ITALIC;
- default:
- return FontStyleProto.NORMAL;
}
}
}
diff --git a/lib/src/renderer/sdui_grpc_renderer.dart b/lib/src/renderer/sdui_grpc_renderer.dart
index 385a59a..a088c57 100644
--- a/lib/src/renderer/sdui_grpc_renderer.dart
+++ b/lib/src/renderer/sdui_grpc_renderer.dart
@@ -4,21 +4,47 @@ import 'package:flutter_sdui/src/parser/sdui_proto_parser.dart';
import 'package:flutter_sdui/src/service/sdui_grpc_client.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// A widget that renders a UI from a gRPC server.
+/// A Flutter widget that renders server-driven UI from a gRPC server.
+///
+/// This widget acts as the main entry point for rendering server-driven UI.
+/// It fetches widget definitions from a gRPC server, parses them, and renders
+/// the resulting widget tree in the Flutter app.
+///
+/// The renderer handles loading states, error states, and automatic re-fetching
+/// when the screen ID or client changes.
+///
+/// Example usage:
+/// ```dart
+/// SduiGrpcRenderer(
+/// client: sduiClient,
+/// screenId: 'home',
+/// loadingWidget: CustomLoadingSpinner(),
+/// errorBuilder: (context, error) => ErrorWidget(error),
+/// )
+/// ```
class SduiGrpcRenderer extends StatefulWidget {
- /// The gRPC client to use for fetching UI widgets.
+ /// The gRPC client used to fetch widget data from the server.
final SduiGrpcClient client;
- /// The screen ID to fetch from the server.
+ /// The identifier for the screen/UI to fetch from the server.
+ /// This should correspond to a valid screen ID on the server.
final String screenId;
- /// Optional loading widget to display while fetching the UI.
+ /// Optional widget to display while the UI is being fetched.
+ /// If not provided, a default [CircularProgressIndicator] is shown.
final Widget? loadingWidget;
- /// Optional error widget builder to display if an error occurs.
+ /// Optional builder function to create a custom error widget.
+ ///
+ /// The function receives the [BuildContext] and the error [Object].
+ /// If not provided, a default error text widget is displayed.
final Widget Function(BuildContext, Object)? errorBuilder;
- /// Creates a new SduiGrpcRenderer.
+ /// Creates a new [SduiGrpcRenderer].
+ ///
+ /// The [client] and [screenId] parameters are required.
+ /// The [loadingWidget] and [errorBuilder] parameters are optional
+ /// and provide customization for loading and error states.
const SduiGrpcRenderer({
super.key,
required this.client,
@@ -49,6 +75,7 @@ class _SduiGrpcRendererState extends State {
}
}
+ /// Initiates a request to fetch widget data from the server.
void _fetchWidget() {
_widgetFuture = widget.client.getWidget(widget.screenId);
}
@@ -67,8 +94,7 @@ class _SduiGrpcRendererState extends State {
}
return Center(child: Text('Error: ${snapshot.error}'));
} else if (snapshot.hasData) {
- // Convert the protobuf data to a Flutter widget
- // This will use our SduiProtoParser to create the widget tree
+ // Parse the protobuf data and convert to Flutter widget
final SduiWidget sduiWidget = SduiParser.parseProto(snapshot.data!);
return sduiWidget.toFlutterWidget();
} else {
diff --git a/lib/src/service/sdui_grpc_client.dart b/lib/src/service/sdui_grpc_client.dart
index f5e1200..5c0c19d 100644
--- a/lib/src/service/sdui_grpc_client.dart
+++ b/lib/src/service/sdui_grpc_client.dart
@@ -1,12 +1,36 @@
import 'package:grpc/grpc.dart';
import 'package:flutter_sdui/src/generated/sdui.pbgrpc.dart';
-/// A client for the SDUI gRPC service.
+/// A gRPC client for communicating with SDUI servers.
+///
+/// This client handles the network communication between the Flutter app
+/// and the server that provides the UI definitions. It manages the gRPC
+/// connection lifecycle and provides methods to fetch widget data.
+///
+/// Example usage:
+/// ```dart
+/// final client = SduiGrpcClient(
+/// host: 'your-server.com',
+/// port: 50051,
+/// secure: true,
+/// );
+///
+/// final widgetData = await client.getWidget('home_screen');
+/// ```
class SduiGrpcClient {
late final SduiServiceClient _client;
late final ClientChannel _channel;
/// Creates a new SDUI gRPC client.
+ ///
+ /// Parameters:
+ /// * [host] - The hostname or IP address of the gRPC server
+ /// * [port] - The port number the gRPC server is listening on
+ /// * [secure] - Whether to use secure (TLS) connection. Defaults to false
+ ///
+ /// The client will establish a connection to the server immediately upon
+ /// construction. Call [dispose] when the client is no longer needed to
+ /// properly close the connection.
SduiGrpcClient({
required String host,
required int port,
@@ -25,13 +49,24 @@ class SduiGrpcClient {
_client = SduiServiceClient(_channel);
}
- /// Fetches a UI widget from the server.
+ /// Fetches widget data from the server for the specified screen.
+ ///
+ /// [screenId] is a server-defined identifier that specifies which
+ /// UI definition to retrieve. The server should return a complete
+ /// widget tree definition for the requested screen.
+ ///
+ /// Returns a [Future] that completes with the widget data, or throws
+ /// a [GrpcError] if the request fails.
Future getWidget(String screenId) async {
final request = SduiRequest()..screenId = screenId;
return _client.getSduiWidget(request);
}
- /// Closes the connection to the server.
+ /// Closes the connection to the server and releases all resources.
+ ///
+ /// This method should be called when the client is no longer needed
+ /// to properly clean up the gRPC connection. After calling this method,
+ /// the client should not be used for any further operations.
Future dispose() async {
await _channel.shutdown();
}
diff --git a/lib/src/widgets/sdui_column.dart b/lib/src/widgets/sdui_column.dart
index f47b38f..d05bfdc 100644
--- a/lib/src/widgets/sdui_column.dart
+++ b/lib/src/widgets/sdui_column.dart
@@ -1,16 +1,40 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Column widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Column] widget.
+///
+/// This widget displays its children in a vertical array, allowing for
+/// flexible layout configuration through server-defined properties.
+///
+/// The column's layout behavior can be controlled through alignment,
+/// sizing, and direction properties that mirror Flutter's Column widget.
class SduiColumn extends SduiWidget {
+ /// The widgets below this widget in the tree.
final List children;
+
+ /// How the children should be placed along the main axis (vertically).
final MainAxisAlignment? mainAxisAlignment;
+
+ /// How much space should be occupied in the main axis.
final MainAxisSize? mainAxisSize;
+
+ /// How the children should be placed along the cross axis (horizontally).
final CrossAxisAlignment? crossAxisAlignment;
+
+ /// Determines the order to lay children out horizontally.
final TextDirection? textDirection;
+
+ /// Determines the order to lay children out vertically.
final VerticalDirection? verticalDirection;
+
+ /// The baseline to use when aligning text within the column.
final TextBaseline? textBaseline;
+ /// Creates a new [SduiColumn] widget.
+ ///
+ /// The [children] parameter is required and defines the widgets to be
+ /// laid out vertically. All other parameters are optional and control
+ /// the layout behavior.
SduiColumn({
required this.children,
this.mainAxisAlignment,
diff --git a/lib/src/widgets/sdui_container.dart b/lib/src/widgets/sdui_container.dart
index ad2739e..2ed26d0 100644
--- a/lib/src/widgets/sdui_container.dart
+++ b/lib/src/widgets/sdui_container.dart
@@ -1,21 +1,57 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Container widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Container] widget.
+///
+/// This widget combines common painting, positioning, and sizing widgets
+/// into a single convenient widget. It's one of the most versatile widgets
+/// in the SDUI toolkit, supporting decoration, padding, margins, constraints,
+/// and transformations.
+///
+/// Note: The [color] parameter is only applied when [decoration] is null.
+/// If both are specified, [decoration] takes precedence.
class SduiContainer extends SduiWidget {
+ /// The widget below this widget in the tree.
final SduiWidget? child;
+
+ /// Empty space to inscribe inside the decoration. The child is placed inside this padding.
final EdgeInsets? padding;
+
+ /// Empty space to surround the decoration and child.
final EdgeInsets? margin;
- final BoxDecoration? decoration; // Handles color, borderRadius, border, etc.
+
+ /// The decoration to paint behind the child.
+ /// Handles background color, border radius, borders, shadows, and gradients.
+ final BoxDecoration? decoration;
+
+ /// If non-null, requires the child to have exactly this width.
final double? width;
+
+ /// If non-null, requires the child to have exactly this height.
final double? height;
+
+ /// The color to paint behind the child. Only used when [decoration] is null.
final Color? color;
+
+ /// Aligns the child within the container.
final Alignment? alignment;
+
+ /// Additional constraints to apply to the child.
final BoxConstraints? constraints;
+
+ /// The transformation matrix to apply before painting the container.
final Matrix4? transform;
+
+ /// The alignment of the origin for the transformation.
final AlignmentGeometry? transformAlignment;
+
+ /// The clip behavior for the container's contents.
final Clip? clipBehavior;
+ /// Creates a new [SduiContainer] widget.
+ ///
+ /// All parameters are optional. The container's appearance and behavior
+ /// are determined by the combination of properties provided.
SduiContainer({
this.child,
this.padding,
@@ -39,9 +75,8 @@ class SduiContainer extends SduiWidget {
decoration: decoration,
width: width,
height: height,
- color: decoration == null
- ? color
- : null, // Only use color if decoration is null
+ // Only use color if decoration is null to avoid conflicts
+ color: decoration == null ? color : null,
alignment: alignment,
constraints: constraints,
transform: transform,
diff --git a/lib/src/widgets/sdui_icon.dart b/lib/src/widgets/sdui_icon.dart
index a428418..2a4023a 100644
--- a/lib/src/widgets/sdui_icon.dart
+++ b/lib/src/widgets/sdui_icon.dart
@@ -1,18 +1,46 @@
+import 'dart:developer';
+
import 'package:flutter/material.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents an Icon widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Icon] widget.
+///
+/// This widget displays a graphical icon from Flutter's built-in icon sets
+/// or custom icon fonts. It supports comprehensive styling options including
+/// size, color, shadows, and opacity.
+///
+/// The widget can handle missing icon data gracefully by rendering an empty
+/// widget instead of throwing an error.
class SduiIcon extends SduiWidget {
+ /// The icon to display. If null, an empty widget will be rendered.
final IconData? icon;
+
+ /// The size of the icon in logical pixels.
final double? size;
+
+ /// The color to use when drawing the icon.
final Color? color;
+
+ /// Semantic description of the icon for accessibility.
final String? semanticLabel;
+
+ /// The text direction to use for resolving the icon.
final TextDirection? textDirection;
- final double?
- opacity; // Custom property for opacity - will use Opacity widget
+
+ /// The opacity to apply to the icon. Values should be between 0.0 and 1.0.
+ final double? opacity;
+
+ /// Whether to scale the icon based on the text scale factor.
final bool? applyTextScaling;
+
+ /// A list of shadows to cast behind the icon.
final List? shadows;
+ /// Creates a new [SduiIcon] widget.
+ ///
+ /// All parameters are optional. If [icon] is null, an empty widget
+ /// will be rendered. The [opacity] will be applied using an [Opacity]
+ /// widget if the value is less than 1.0.
SduiIcon({
this.icon,
this.size,
@@ -26,7 +54,7 @@ class SduiIcon extends SduiWidget {
String? get iconName {
if (icon == null) return null;
-
+
const codePointToName = {
0xe8b8: 'settings',
0xe88a: 'home',
@@ -36,7 +64,7 @@ class SduiIcon extends SduiWidget {
0xe88e: 'info',
0xe318: 'home',
};
- print(codePointToName);
+ log(codePointToName.toString());
return codePointToName[icon!.codePoint];
}
@@ -56,7 +84,7 @@ class SduiIcon extends SduiWidget {
applyTextScaling: applyTextScaling,
);
- // Apply opacity if provided
+ // Apply opacity wrapper if needed
if (opacity != null && opacity! < 1.0) {
iconWidget = Opacity(
opacity: opacity!,
diff --git a/lib/src/widgets/sdui_image.dart b/lib/src/widgets/sdui_image.dart
index ee7c22d..3b1e66c 100644
--- a/lib/src/widgets/sdui_image.dart
+++ b/lib/src/widgets/sdui_image.dart
@@ -1,27 +1,78 @@
+import 'dart:developer';
+
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents an Image widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Image] widget.
+///
+/// This widget supports displaying images from network URLs with comprehensive
+/// customization options for sizing, alignment, color blending, and caching.
+///
+/// Currently, only network images (URLs starting with 'http') are supported.
+/// Local assets and file system images are not yet implemented.
+///
+/// The widget provides loading and error handling capabilities through
+/// optional custom widgets.
class SduiImage extends SduiWidget {
- final String src; // Network URL
+ /// The network URL of the image to display.
+ final String src;
+
+ /// If non-null, requires the image to have exactly this width.
final double? width;
+
+ /// If non-null, requires the image to have exactly this height.
final double? height;
+
+ /// How the image should be inscribed into the space allocated during layout.
final BoxFit? fit;
+
+ /// How to align the image within its bounds.
final Alignment? alignment;
+
+ /// How the image should be repeated if it doesn't fill its layout bounds.
final ImageRepeat? repeat;
+
+ /// A color to blend with the image.
final Color? color;
+
+ /// The blend mode to use when applying the color.
final BlendMode? colorBlendMode;
+
+ /// The center slice for a nine-patch image.
final Rect? centerSlice;
+
+ /// Whether to paint the image in the direction of the text.
final bool? matchTextDirection;
+
+ /// Whether to continue showing the old image when the new image fails to load.
final bool? gaplessPlayback;
+
+ /// The quality level to use when scaling the image.
final FilterQuality? filterQuality;
+
+ /// The target width for image caching.
final int? cacheWidth;
+
+ /// The target height for image caching.
final int? cacheHeight;
+
+ /// The scale to place in the ImageInfo object of the image.
final double? scale;
+
+ /// A semantic description of the image for accessibility.
final String? semanticLabel;
+
+ /// Widget to display when an error occurs while loading the image.
final Widget? errorWidget;
+
+ /// Widget to display while the image is loading.
final Widget? loadingWidget;
+ /// Creates a new [SduiImage] widget.
+ ///
+ /// The [src] parameter is required and must be a valid network URL.
+ /// All other parameters are optional and provide customization for
+ /// image display and behavior.
SduiImage(
this.src, {
this.width,
@@ -73,9 +124,8 @@ class SduiImage extends SduiWidget {
: null,
);
} else {
- // Optionally, return a placeholder or throw an error for non-network images.
- // For now, returning an empty SizedBox.
- print(
+ // Return empty widget for non-network URLs with warning
+ log(
"Warning: SduiImage currently only supports network images. Provided src: $src");
return const SizedBox.shrink();
}
diff --git a/lib/src/widgets/sdui_row.dart b/lib/src/widgets/sdui_row.dart
index 7962e88..5c13cf2 100644
--- a/lib/src/widgets/sdui_row.dart
+++ b/lib/src/widgets/sdui_row.dart
@@ -1,16 +1,40 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Row widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Row] widget.
+///
+/// This widget displays its children in a horizontal array, allowing for
+/// flexible layout configuration through server-defined properties.
+///
+/// The row's layout behavior can be controlled through alignment,
+/// sizing, and direction properties that mirror Flutter's Row widget.
class SduiRow extends SduiWidget {
+ /// The widgets below this widget in the tree.
final List children;
+
+ /// How the children should be placed along the main axis (horizontally).
final MainAxisAlignment? mainAxisAlignment;
+
+ /// How much space should be occupied in the main axis.
final MainAxisSize? mainAxisSize;
+
+ /// How the children should be placed along the cross axis (vertically).
final CrossAxisAlignment? crossAxisAlignment;
+
+ /// Determines the order to lay children out horizontally.
final TextDirection? textDirection;
+
+ /// Determines the order to lay children out vertically.
final VerticalDirection? verticalDirection;
+
+ /// The baseline to use when aligning text within the row.
final TextBaseline? textBaseline;
+ /// Creates a new [SduiRow] widget.
+ ///
+ /// The [children] parameter is required and defines the widgets to be
+ /// laid out horizontally. All other parameters are optional and control
+ /// the layout behavior.
SduiRow({
required this.children,
this.mainAxisAlignment,
diff --git a/lib/src/widgets/sdui_scaffold.dart b/lib/src/widgets/sdui_scaffold.dart
index 8dfdf1c..79e5128 100644
--- a/lib/src/widgets/sdui_scaffold.dart
+++ b/lib/src/widgets/sdui_scaffold.dart
@@ -1,26 +1,75 @@
-import 'package:flutter/material.dart'; // Scaffold is in material.dart
+import 'dart:developer';
+
+import 'package:flutter/material.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Scaffold widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Scaffold] widget.
+///
+/// This widget implements the basic material design visual layout structure.
+/// It provides slots for the most common components of a screen, such as
+/// app bars, bodies, floating action buttons, and drawers.
+///
+/// The scaffold ensures proper Material Design layout behavior and manages
+/// component positioning and sizing automatically.
+///
+/// Note: The [appBar] widget must resolve to a [PreferredSizeWidget]
+/// (such as an AppBar) to be properly displayed.
class SduiScaffold extends SduiWidget {
+ /// An app bar to display at the top of the scaffold.
final SduiWidget? appBar;
+
+ /// The primary content of the scaffold.
final SduiWidget? body;
+
+ /// A floating action button displayed over the body.
final SduiWidget? floatingActionButton;
+
+ /// A bottom navigation bar to display at the bottom of the scaffold.
final SduiWidget? bottomNavigationBar;
+
+ /// A navigation drawer that slides in from the left side.
final SduiWidget? drawer;
+
+ /// A navigation drawer that slides in from the right side.
final SduiWidget? endDrawer;
+
+ /// A bottom sheet displayed above the scaffold body.
final SduiWidget? bottomSheet;
+
+ /// The color of the scaffold's background.
final Color? backgroundColor;
+
+ /// Whether the body should resize when the keyboard appears.
final bool? resizeToAvoidBottomInset;
+
+ /// Whether this scaffold is being displayed at the top of the screen.
final bool? primary;
+
+ /// The position of the floating action button.
final FloatingActionButtonLocation? floatingActionButtonLocation;
+
+ /// Whether the body should extend behind the app bar.
final bool? extendBody;
+
+ /// Whether the body should extend behind the app bar when fully expanded.
final bool? extendBodyBehindAppBar;
+
+ /// The color to use for the scrim that obscures primary content while a drawer is open.
final Color? drawerScrimColor;
+
+ /// The width of the area within which a horizontal swipe will open the drawer.
final double? drawerEdgeDragWidth;
+
+ /// Whether the drawer can be opened with a drag gesture.
final bool? drawerEnableOpenDragGesture;
+
+ /// Whether the end drawer can be opened with a drag gesture.
final bool? endDrawerEnableOpenDragGesture;
+ /// Creates a new [SduiScaffold] widget.
+ ///
+ /// All parameters are optional. The scaffold will display only the
+ /// components that are provided.
SduiScaffold({
this.appBar,
this.body,
@@ -45,20 +94,12 @@ class SduiScaffold extends SduiWidget {
Widget toFlutterWidget() {
Widget? flutterAppBar;
if (appBar != null) {
- // Attempt to cast to PreferredSizeWidget. This assumes the SDUI appBar resolves to something like AppBar.
- // More robust handling might be needed if it can be any widget.
- // For now, we expect it to be a widget that can be an AppBar (e.g. SduiContainer styled as an AppBar)
- // or a custom SduiAppBar widget if we introduce one.
- var potentialAppBar = appBar!.toFlutterWidget();
+ final potentialAppBar = appBar!.toFlutterWidget();
if (potentialAppBar is PreferredSizeWidget) {
flutterAppBar = potentialAppBar;
} else {
- // If it's not a PreferredSizeWidget, wrap it in one if possible or log a warning.
- // For simplicity, we are strict for now. Consider a SduiAppBar sdui widget for proper typing.
- print(
+ log(
"Warning: appBar widget for SduiScaffold is not a PreferredSizeWidget. It might not render correctly.");
- // As a fallback, one might wrap it in a simple PreferredSize if it has a defined height.
- // flutterAppBar = PreferredSize(child: potentialAppBar, preferredSize: Size.fromHeight(kToolbarHeight));
}
}
diff --git a/lib/src/widgets/sdui_sized_box.dart b/lib/src/widgets/sdui_sized_box.dart
index 3feb28e..1eb7de5 100644
--- a/lib/src/widgets/sdui_sized_box.dart
+++ b/lib/src/widgets/sdui_sized_box.dart
@@ -1,12 +1,29 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a SizedBox widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [SizedBox] widget.
+///
+/// This widget forces its child to have a specific width and/or height.
+/// It's useful for creating fixed-size layouts or adding spacing between widgets.
+///
+/// If no dimensions are specified, the widget will try to be as big as possible.
+/// If only one dimension is specified, the widget will try to be as big as
+/// possible in the other dimension.
class SduiSizedBox extends SduiWidget {
+ /// The width to constrain the child to.
final double? width;
+
+ /// The height to constrain the child to.
final double? height;
+
+ /// The widget below this widget in the tree.
final SduiWidget? child;
+ /// Creates a new [SduiSizedBox] widget.
+ ///
+ /// All parameters are optional. If neither [width] nor [height] are
+ /// specified, the child will be unconstrained. If only one dimension
+ /// is specified, the child will be constrained in that dimension only.
SduiSizedBox({this.width, this.height, this.child});
@override
diff --git a/lib/src/widgets/sdui_spacer.dart b/lib/src/widgets/sdui_spacer.dart
index 4095f41..5d33740 100644
--- a/lib/src/widgets/sdui_spacer.dart
+++ b/lib/src/widgets/sdui_spacer.dart
@@ -1,10 +1,24 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Spacer widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Spacer] widget.
+///
+/// This widget creates an adjustable, empty spacer that can be used to tune
+/// the spacing between widgets in a [Flex] container, like [Row] or [Column].
+///
+/// The spacer takes up space proportional to its [flex] value relative to
+/// other flexible widgets in the same container.
class SduiSpacer extends SduiWidget {
+ /// The flex factor to use for determining how much space to take up.
+ ///
+ /// The amount of space this widget takes up is proportional to its [flex]
+ /// value divided by the total flex values of all widgets in the container.
final int flex;
+ /// Creates a new [SduiSpacer] widget.
+ ///
+ /// The [flex] parameter defaults to 1, which means the spacer will take
+ /// up an equal amount of space as other spacers with the same flex value.
SduiSpacer({this.flex = 1});
@override
diff --git a/lib/src/widgets/sdui_text.dart b/lib/src/widgets/sdui_text.dart
index 331869f..9a9a1d0 100644
--- a/lib/src/widgets/sdui_text.dart
+++ b/lib/src/widgets/sdui_text.dart
@@ -1,24 +1,64 @@
import 'package:flutter/widgets.dart';
import 'package:flutter_sdui/src/widgets/sdui_widget.dart';
-/// Represents a Text widget in SDUI.
+/// A server-driven UI widget that represents a Flutter [Text] widget.
+///
+/// This widget allows displaying text with customizable styling properties
+/// that can be defined on the server side and rendered on the client.
+///
+/// The widget supports all common text properties including font styling,
+/// alignment, overflow handling, and text direction.
class SduiText extends SduiWidget {
+ /// The text content to display.
final String text;
+
+ /// The text style to apply. This can be merged with individual style properties.
final TextStyle? style;
+
+ /// How the text should be aligned horizontally.
final TextAlign? textAlign;
+
+ /// How visual overflow should be handled.
final TextOverflow? overflow;
+
+ /// An optional maximum number of lines for the text to span.
final int? maxLines;
+
+ /// The decoration to paint near the text (e.g., underline).
final TextDecoration? decoration;
+
+ /// The size of glyphs (in logical pixels) to use when painting the text.
final double? fontSize;
+
+ /// The typeface thickness to use when painting the text.
final FontWeight? fontWeight;
+
+ /// The color to use when painting the text.
final Color? color;
+
+ /// Whether the text should break at soft line breaks.
final bool? softWrap;
+
+ /// The amount of space (in logical pixels) to add between each letter.
final double? letterSpacing;
+
+ /// The amount of space (in logical pixels) to add at each sequence of white-space.
final double? wordSpacing;
+
+ /// The height of this text span, as a multiple of the font size.
final double? height;
+
+ /// The name of the font to use when painting the text.
final String? fontFamily;
+
+ /// The directionality of the text.
final TextDirection? textDirection;
+ /// Creates a new [SduiText] widget.
+ ///
+ /// The [text] parameter is required and specifies the content to display.
+ /// All other parameters are optional and can be used to customize the
+ /// appearance and behavior of the text.
SduiText(
this.text, {
this.style,
@@ -39,8 +79,8 @@ class SduiText extends SduiWidget {
@override
Widget toFlutterWidget() {
- // Create a merged TextStyle that combines the individual properties with the style
- TextStyle mergedStyle = (style ?? const TextStyle()).copyWith(
+ // Merge individual style properties with the base style
+ final TextStyle mergedStyle = (style ?? const TextStyle()).copyWith(
decoration: decoration,
fontSize: fontSize,
fontWeight: fontWeight,
diff --git a/lib/src/widgets/sdui_widget.dart b/lib/src/widgets/sdui_widget.dart
index 2b01502..d50a7b4 100644
--- a/lib/src/widgets/sdui_widget.dart
+++ b/lib/src/widgets/sdui_widget.dart
@@ -1,6 +1,20 @@
import 'package:flutter/widgets.dart';
-/// Abstract class for all SDUI widgets.
+/// Abstract base class for all Server-Driven UI widgets.
+///
+/// This class defines the contract that all SDUI widgets must implement.
+/// Each SDUI widget can be converted to its corresponding Flutter widget
+/// through the [toFlutterWidget] method.
+///
+/// All concrete SDUI widget implementations should extend this class and
+/// provide their own implementation of [toFlutterWidget].
abstract class SduiWidget {
+ /// Converts this SDUI widget to its corresponding Flutter widget.
+ ///
+ /// This method is responsible for mapping the SDUI widget's properties
+ /// to the equivalent Flutter widget properties and returning a fully
+ /// configured Flutter widget instance.
+ ///
+ /// Returns a [Widget] that can be rendered in the Flutter widget tree.
Widget toFlutterWidget();
}
diff --git a/pubspec.yaml b/pubspec.yaml
index fe72900..522644f 100644
--- a/pubspec.yaml
+++ b/pubspec.yaml
@@ -1,7 +1,8 @@
name: flutter_sdui
-description: "A Flutter package to render server driven UI."
+description: "A Flutter package for Server-Driven UI with JSON and gRPC support. Build dynamic UIs updated from the server without app releases."
version: 0.0.1
-# homepage:
+homepage: https://github.com/GDGVIT/flutter-sdui-package
+repository: https://github.com/GDGVIT/flutter-sdui-package
environment:
sdk: ">=3.0.0 <4.0.0"
diff --git a/test/flutter_sdui_test.dart b/test/flutter_sdui_test.dart
index 120d6ec..d810967 100644
--- a/test/flutter_sdui_test.dart
+++ b/test/flutter_sdui_test.dart
@@ -1,37 +1,34 @@
-// import 'package:flutter_test/flutter_test.dart';
-
-// import 'package:flutter_sdui/flutter_sdui.dart';
-
-// void main() {
-// test('adds one to input values', () {
-// final calculator = Calculator();
-// expect(calculator.addOne(2), 3);
-// expect(calculator.addOne(-7), -6);
-// expect(calculator.addOne(0), 1);
-// });
-// }
+import 'package:flutter_test/flutter_test.dart';
import 'package:flutter/material.dart';
import 'dart:convert';
import 'dart:io';
import 'package:flutter_sdui/src/parser/sdui_proto_parser.dart';
+/// Main test entry point for Flutter SDUI package.
+///
+/// This test demonstrates JSON parsing functionality by loading an example
+/// JSON file, parsing it into SDUI widgets, and rendering as Flutter widgets.
void main() async {
WidgetsFlutterBinding.ensureInitialized();
- // Load the example JSON file
- final file = File('example/example.json');
- final jsonString = await file.readAsString();
- final Map jsonData = json.decode(jsonString);
+ group('Flutter SDUI Tests', () {
+ test('JSON parsing and widget conversion', () async {
+ final file = File('example/example.json');
+ final jsonString = await file.readAsString();
+ final Map jsonData = json.decode(jsonString);
- // Parse the JSON into an SDUI widget
- final sduiWidget = SduiParser.parseJSON(jsonData);
+ final sduiWidget = SduiParser.parseJSON(jsonData);
+ final widget = sduiWidget.toFlutterWidget();
- // Convert to Flutter widget
- final widget = sduiWidget.toFlutterWidget();
+ expect(widget, isA());
+ expect(sduiWidget, isNotNull);
+ });
- runApp(MaterialApp(
- home: widget,
- ));
-}
+ test('SDUI parser handles empty JSON', () {
+ final emptyJson = {};
+ expect(() => SduiParser.parseJSON(emptyJson), throwsA(isA()));
+ });
+ });
+}