Merge pull request #2088 from sfHariHaraSudhan/master

Moved the chat widget related release source to flutter widgets.

Author: LavanyaA

packages/syncfusion_flutter_chat/CHANGELOG.md

@@ -0,0 +1,10 @@
+## Unreleased
+
+Initial release.
+
+**Features** 
+1. Messages - A list of ChatMessage objects that will be displayed in the chat interface as either incoming or outgoing messages, depending on the current user.
+2. Composer - The primary text editor where the user can compose new chat messages.
+3. Action button - This represents the send button, which invokes a callback with the text entered in the default composer.
+4. Placeholder - This allows you to specify a custom widget to display when there are no messages in the chat.
+5. Bubble - This holds each message's header, content, footer, and avatar.

packages/syncfusion_flutter_chat/LICENSE

@@ -0,0 +1,12 @@
+Syncfusion License
+
+Syncfusion Flutter Chat package is available under the Syncfusion Essential Studio program, and can be licensed either under the Syncfusion Community License Program or the Syncfusion commercial license.
+
+To be qualified for the Syncfusion Community License Program you must have a gross revenue of less than one (1) million U.S. dollars ($1,000,000.00 USD) per year and have less than five (5) developers in your organization, and agree to be bound by Syncfusion’s terms and conditions. 
+
+Customers who do not qualify for the community license can contact [email protected] for commercial licensing options.
+
+Under no circumstances can you use this product without (1) either a Community License or a commercial license and (2) without agreeing and abiding by Syncfusion’s license containing all terms and conditions. 
+
+The Syncfusion license that contains the terms and conditions can be found at 
+https://www.syncfusion.com/content/downloads/syncfusion_license.pdf

packages/syncfusion_flutter_chat/README.md

@@ -0,0 +1,161 @@
+![Syncfusion Flutter Chat banner](https://cdn.syncfusion.com/content/images/Flutter/chat/chat_pub_banner.png)
+
+# Flutter Chat library
+
+The [Flutter Chat](https://www.syncfusion.com/flutter-widgets/flutter-Chat?utm_source=pubdev&utm_medium=listing&utm_campaign=flutter-Chat-pubdev) package is a UI library designed to help you create a robust chat application within your Flutter projects.
+
+## Overview
+* Offers a modern conversation UI to facilitate communication among users.
+* Displays both one-on-one and group conversations.
+* Provides a wide range of customization options for message content, headers, footers, avatars, editors, and action buttons.
+
+**Disclaimer:** This is a commercial package. To use this package, you need to have either a Syncfusion commercial license or Free [Syncfusion Community license](https://www.syncfusion.com/products/communitylicense). For more details, please check the [LICENSE](https://github.com/syncfusion/flutter-examples/blob/master/LICENSE).
+
+## Table of content:
+- [Chat Features](#chat-features)
+- [Get the demo application](#get-the-demo-application)
+- [Useful links](#other-useful-links)
+- [Installation](#installation)
+- [Flutter Chat example](#flutter-chat-example)
+- [Support and feedback](#support-and-feedback)
+- [About Syncfusion](#about-syncfusion)
+
+## Chat Features:
+
+**Placeholder:** Define a custom widget to show when there are no messages in the chat. This feature is especially beneficial for providing users with an engaging or pertinent message that signifies the conversation is currently empty.
+
+**Composer:** This is the primary text editor where users can compose new chat messages. There is an option to define a custom widget to serve as a composer, allowing one or more widgets to provide multiple options for composing a message.
+
+**Action button:** This is used for the Send button. Pressing this action button invokes the callback, where the outgoing user rebuilds the chat widget with their composed message. There is an option to define a custom widget consisting of one or more interactive widgets to serve as action buttons, such as a send button, microphone button, or file attachment button.
+
+**Conversation:** This displays the content of incoming and outgoing messages. Each message includes details such as the message text, time stamp, and author. There is an option available to individually customize incoming and outgoing messages, providing a distinct appearance for each message type.
+
+- **Incoming:** The content of incoming messages can be customize. Change the background color, content shape, and other features according to the message user or specific conditions.
+
+- **Outgoing:** The content of outgoing messages can be customized. Change the background color, content shape, and other features according to the message user or specific conditions.
+
+- **Header:** The header displays the username of the message's author along with the time stamp. Additionally, users can build a custom widget to display more information about the chat message.
+
+- **Footer:** Define a custom widget to display additional information about the chat message, such as the time stamp or message delivery status.
+
+- **Avatar:** The author's avatar displays either an image or the initials of their name. By default, if the avatar image source is not defined, the user's initials will be displayed. Additionally, users can create a custom widget that shows more information about them.
+
+- **Content:** Users can customize the message content's background color, content shape, and other features based on the user or other specific conditions. By default, the text content is shown as not selectable, but there is an option to display the message content using a custom widget.
+
+## Get the demo application
+
+Explore the full capabilities of our Flutter widgets on your device by installing our sample browser applications from the below app stores, and view samples code in GitHub.
+
+<p align="center">
+  <a href="https://play.google.com/store/apps/details?id=com.syncfusion.flutter.examples"><img src="https://cdn.syncfusion.com/content/images/FTControl/google-play-store.png"/></a>
+  <a href="https://flutter.syncfusion.com"><img src="https://cdn.syncfusion.com/content/images/FTControl/web-sample-browser.png"/></a>
+  <a href="https://www.microsoft.com/en-us/p/syncfusion-flutter-gallery/9nhnbwcsf85d?activetab=pivot:overviewtab"><img src="https://cdn.syncfusion.com/content/images/FTControl/windows-store.png"/></a> 
+</p>
+<p align="center">
+  <a href="https://install.appcenter.ms/orgs/syncfusion-demos/apps/syncfusion-flutter-gallery/distribution_groups/release"><img src="https://cdn.syncfusion.com/content/images/FTControl/macos-app-center.png"/></a>
+  <a href="https://snapcraft.io/syncfusion-flutter-gallery"><img src="https://cdn.syncfusion.com/content/images/FTControl/snap-store.png"/></a>
+  <a href="https://github.com/syncfusion/flutter-examples"><img src="https://cdn.syncfusion.com/content/images/FTControl/github-samples.png"/></a>
+</p>
+
+## Other useful links
+
+Take a look at the following to learn more about the Syncfusion Flutter Chat.
+
+* [Syncfusion Flutter Chat product page](https://www.syncfusion.com/flutter-widgets/flutter-chat)
+* [User guide documentation for Chat](https://help.syncfusion.com/flutter/chat)
+* [Knowledge base](https://www.syncfusion.com/kb)
+
+## Installation
+
+Add the [latest version](https://pub.dev/packages/syncfusion_flutter_chat/install) of [Syncfusion Flutter Chat](https://pub.dev/packages/syncfusion_flutter_chat) widget to your `pubspec.yaml` file..
+
+## Flutter Chat example 
+
+Import Chat library using the code provided below.
+
+```dart
+import 'package:syncfusion_flutter_chat/chat.dart';
+```
+### Add Chat widget
+
+Initialize the Chat widget as a child of any widget.
+
+```dart
+@override
+Widget build(BuildContext context) {
+  return Scaffold(
+    body: SfChat(),
+  );
+}
+```
+
+### Bind data source
+
+To bind the message conversations to the `Chat` widget, the predefined data model class `ChatMessage` is used. This class contains three essential properties: `text`, `time`, and `author`, which are required for rendering a chat message. The following code snippet illustrates how to assign data to the `Chat` widget.
+
+```dart
+late List<ChatMessage> _messages;
+
+@override
+void initState() {
+  _messages = <ChatMessage>[
+    ChatMessage(
+      text: 'Hello, how can I help you today?',
+      time: DateTime.now(),
+      author: const ChatAuthor(
+        id: 'a2c4-56h8-9x01-2a3d',
+        name: 'Incoming user name',
+      ),
+    ),
+  ];
+  super.initState();
+}
+
+@override
+Widget build(BuildContext context) {
+  return SfChat(
+    messages: _messages,
+    outgoingUser: '8ob3-b720-g9s6-25s8',
+    composer: const ChatComposer(
+      decoration: InputDecoration(
+        hintText: 'Type a message',
+      ),
+    ),
+    actionButton: ChatActionButton(
+      onPressed: (String newMessage) {
+        setState(() {
+          _messages.add(ChatMessage(
+            text: newMessage,
+            time: DateTime.now(),
+            author: const ChatAuthor(
+              id: '8ob3-b720-g9s6-25s8',
+              name: 'Outgoing user name',
+            ),
+          ));
+        });
+      },
+    ),
+  );
+}
+
+@override
+void dispose() {
+  _messages.clear();
+  super.dispose();
+}
+```
+
+The following output illustrates the result of the above code sample.
+
+![Default Chat demo](https://cdn.syncfusion.com/content/images/Flutter/chat/chat_pub_getting_started_demo.gif)
+
+## Support and feedback
+
+* For questions, reach out to our [Syncfusion support team](https://support.syncfusion.com/support/tickets/create) or post them through the [Community forums](https://www.syncfusion.com/forums). Submit a feature request or a bug in our [Feedback portal](https://www.syncfusion.com/feedback/flutter).
+* To renew your subscription, click [renew](https://www.syncfusion.com/sales/products) or contact our sales team at [email protected] | Toll Free: 1-888-9 DOTNET.
+
+## About Syncfusion
+
+Founded in 2001 and headquartered in Research Triangle Park, N.C., Syncfusion has more than 20,000 customers and more than 1 million users, including large financial institutions, Fortune 500 companies, and global IT consultancies.
+
+Today we provide 1,000+ controls and frameworks for web ([ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls), [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls), [ASP.NET WebForms](https://www.syncfusion.com/jquery/aspnet-web-forms-ui-controls), [JavaScript](https://www.syncfusion.com/javascript-ui-controls), [Angular](https://www.syncfusion.com/angular-ui-components), [React](https://www.syncfusion.com/react-ui-components), [Vue](https://www.syncfusion.com/vue-ui-components), [Flutter](https://www.syncfusion.com/flutter-widgets), and [Blazor](https://www.syncfusion.com/blazor-components)), mobile ([Xamarin](https://www.syncfusion.com/xamarin-ui-controls), [.NET MAUI](https://www.syncfusion.com/maui-controls), [Flutter](https://www.syncfusion.com/flutter-widgets), [UWP](https://www.syncfusion.com/uwp-ui-controls), and [JavaScript](https://www.syncfusion.com/javascript-ui-controls)), and desktop development ([Flutter](https://www.syncfusion.com/flutter-widgets), [WinForms](https://www.syncfusion.com/winforms-ui-controls), [WPF](https://www.syncfusion.com/wpf-ui-controls), [UWP](https://www.syncfusion.com/uwp-ui-controls), [.NET MAUI](https://www.syncfusion.com/maui-controls), and [WinUI](https://www.syncfusion.com/winui-controls)). We provide ready-to-deploy enterprise software for dashboards, reports, data integration, and big data processing. Many customers have saved millions in licensing fees by deploying our software.

packages/syncfusion_flutter_chat/analysis_options.yaml

@@ -0,0 +1,5 @@
+include: package:syncfusion_flutter_core/analysis_options.yaml
+
+analyzer:
+  errors:
+    todo: ignore

packages/syncfusion_flutter_chat/example/README.md

@@ -0,0 +1,3 @@
+# chat_example
+
+A new Flutter project.

packages/syncfusion_flutter_chat/example/analysis_options.yaml

@@ -0,0 +1 @@
+include: package:flutter_lints/flutter.yaml

packages/syncfusion_flutter_chat/example/android/.gitignore

@@ -0,0 +1,13 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
+key.properties
+**/*.keystore
+**/*.jks

packages/syncfusion_flutter_chat/example/android/app/build.gradle

@@ -0,0 +1,58 @@
+plugins {
+    id "com.android.application"
+    id "kotlin-android"
+    // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
+    id "dev.flutter.flutter-gradle-plugin"
+}
+
+def localProperties = new Properties()
+def localPropertiesFile = rootProject.file("local.properties")
+if (localPropertiesFile.exists()) {
+    localPropertiesFile.withReader("UTF-8") { reader ->
+        localProperties.load(reader)
+    }
+}
+
+def flutterVersionCode = localProperties.getProperty("flutter.versionCode")
+if (flutterVersionCode == null) {
+    flutterVersionCode = "1"
+}
+
+def flutterVersionName = localProperties.getProperty("flutter.versionName")
+if (flutterVersionName == null) {
+    flutterVersionName = "1.0"
+}
+
+android {
+    namespace = "com.syncfusion.chat_example"
+    compileSdk = flutter.compileSdkVersion
+    ndkVersion = flutter.ndkVersion
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId = "com.syncfusion.chat_example"
+        // You can update the following values to match your application needs.
+        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-gradle-build-configuration.
+        minSdk = flutter.minSdkVersion
+        targetSdk = flutter.targetSdkVersion
+        versionCode = flutterVersionCode.toInteger()
+        versionName = flutterVersionName
+    }
+
+    buildTypes {
+        release {
+            // TODO: Add your own signing config for the release build.
+            // Signing with the debug keys for now, so `flutter run --release` works.
+            signingConfig = signingConfigs.debug
+        }
+    }
+}
+
+flutter {
+    source = "../.."
+}

packages/syncfusion_flutter_chat/example/android/app/src/debug/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- The INTERNET permission is required for development. Specifically,
+         the Flutter tool needs it to communicate with the running application
+         to allow setting breakpoints, to provide hot reload, etc.
+    -->
+    <uses-permission android:name="android.permission.INTERNET"/>
+</manifest>

packages/syncfusion_flutter_chat/example/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,45 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application
+        android:label="chat_example"
+        android:name="${applicationName}"
+        android:icon="@mipmap/ic_launcher">
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:launchMode="singleTop"
+            android:taskAffinity=""
+            android:theme="@style/LaunchTheme"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
+            android:hardwareAccelerated="true"
+            android:windowSoftInputMode="adjustResize">
+            <!-- Specifies an Android theme to apply to this Activity as soon as
+                 the Android process has started. This theme is visible to the user
+                 while the Flutter UI initializes. After that, this theme continues
+                 to determine the Window background behind the Flutter UI. -->
+            <meta-data
+              android:name="io.flutter.embedding.android.NormalTheme"
+              android:resource="@style/NormalTheme"
+              />
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+        <!-- Don't delete the meta-data below.
+             This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
+        <meta-data
+            android:name="flutterEmbedding"
+            android:value="2" />
+    </application>
+    <!-- Required to query activities that can process text, see:
+         https://developer.android.com/training/package-visibility and
+         https://developer.android.com/reference/android/content/Intent#ACTION_PROCESS_TEXT.
+
+         In particular, this is used by the Flutter engine in io.flutter.plugin.text.ProcessTextPlugin. -->
+    <queries>
+        <intent>
+            <action android:name="android.intent.action.PROCESS_TEXT"/>
+            <data android:mimeType="text/plain"/>
+        </intent>
+    </queries>
+</manifest>