docs: add docs

catalyst_voices/packages/catalyst_voices_remote_widgets/lib/src/core/catalyst_core.dart

@@ -1,6 +1,10 @@
 import 'package:flutter/material.dart';
 import 'package:rfw/rfw.dart';
 
+/// Returns a map of Catalyst core widget definitions.
+///
+/// The map contains a collection of [LocalWidgetBuilder] functions
+/// that define the core widgets used in Catalyst.
 Map<String, LocalWidgetBuilder> get _catalystCoreWidgetsDefinitions =>
     <String, LocalWidgetBuilder>{
       'TextField': (BuildContext context, DataSource source) {
@@ -16,5 +20,9 @@ Map<String, LocalWidgetBuilder> get _catalystCoreWidgetsDefinitions =>
       },
     };
 
+/// Creates a [LocalWidgetLibrary] containing the Catalyst core widgets.
+///
+/// The [LocalWidgetLibrary] is created using the [_catalystCoreWidgetsDefinitions]
+/// map of widget definitions.
 LocalWidgetLibrary createCatalystCoreWidgets() =>
     LocalWidgetLibrary(_catalystCoreWidgetsDefinitions);

catalyst_voices/packages/catalyst_voices_remote_widgets/lib/src/formats/rfw_encode.dart

@@ -5,15 +5,22 @@ import 'dart:io';
 
 import 'package:rfw/formats.dart';
 
+/// A class that provides methods for encoding Remote Widget files.
 final class RemoteWidgetEncoder {
   const RemoteWidgetEncoder._();
 
+  /// Converts a text file in the Remote Widget format to the RFW binary format.
+  ///
+  /// The [inputFile] parameter specifies the path to the input text file.
+  /// The [outputFile] parameter specifies the path to the output binary file.
+  ///
+  /// Throws an exception if the conversion fails.
   static Future<void> rfwTxtToRfw({
     required String inputFile,
     required String outputFile,
   }) async {
     try {
-      print('Reading to $inputFile');
+      print('Reading from $inputFile');
       final content = await File(inputFile).readAsString();
       print('Content: $content');
 
@@ -23,7 +30,7 @@ final class RemoteWidgetEncoder {
       await File(outputFile).writeAsBytes(bytes);
       print('Successfully processed $outputFile');
     } catch (e) {
-      Exception('Failed to process $inputFile: $e');
+      throw Exception('Failed to process $inputFile: $e');
     }
   }
 }