Merge branch 'master' into chore/pubspec-details

Author: RZEROSTERN

.github/workflows/ci.yml

@@ -15,6 +15,7 @@ jobs:
 
       - uses: subosito/flutter-action@v2
         with:
+          flutter-version: '3.41.5'
           channel: stable
 
       - name: Install dependencies

LICENSE.md LICENSELICENSE.md renamed to LICENSE

@@ -1,9 +1,13 @@
 # EditorJS viewer for Flutter
 
-A viewer and editor compatible with the EditorJS schema.
+A viewer and editor compatible with the [EditorJS](https://editorjs.io/) JSON schema. Supports 14 built-in block types with a Clean Architecture extension point for custom blocks.
+
+[![pub package](https://img.shields.io/pub/v/editorjs_flutter.svg)](https://pub.dev/packages/editorjs_flutter)
+[![CI](https://github.com/DEV1-Softworks/editorjs-flutter/actions/workflows/ci.yml/badge.svg)](https://github.com/DEV1-Softworks/editorjs-flutter/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/DEV1-Softworks/editorjs-flutter/branch/master/graph/badge.svg)](https://codecov.io/gh/DEV1-Softworks/editorjs-flutter)
 
 # DISCLAIMER
-This library is under active development. While the architecture is stable, some block types are still being added. Use with care in production environments.
+This package is in active development (pre-1.0). The public API is stable and the Clean Architecture foundation is solid, but some editor features are still being refined. Suitable for early production use with the understanding that minor API changes may occur in future minor versions.
 
 Requires **Flutter 3.10+** and **Dart 3.0+**.
 
@@ -13,7 +17,7 @@ Add the following to your `pubspec.yaml` dependencies:
 
 ```yaml
 dependencies:
-  editorjs_flutter: ^0.1.0
+  editorjs_flutter: ^0.5.0
 ```
 
 Then run `flutter pub get`.
@@ -136,10 +140,16 @@ class CreateNoteState extends State<CreateNote> {
 
 ### Pre-loading existing content into the editor
 
+Load a previously saved JSON string directly:
+
 ```dart
-_controller = EditorController(
-  initialBlocks: parsedDocument.blocks, // List<BlockEntity>
-);
+_controller = EditorController.fromJson(savedJsonString);
+```
+
+Or pass a parsed block list if you already have one:
+
+```dart
+_controller = EditorController(initialBlocks: parsedDocument.blocks);
 ```
 
 ### Registering custom block types

README.md

@@ -0,0 +1,11 @@
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    - avoid_print
+    - prefer_const_constructors
+    - prefer_const_declarations
+    - prefer_final_fields
+    - use_super_parameters
+    - unnecessary_this
+    - sort_child_properties_last

analysis_options.yaml

@@ -354,7 +354,7 @@ DA:16,1
 DA:19,2
 DA:20,1
 DA:21,5
-DA:29,5
+DA:29,8
 DA:34,3
 DA:37,1
 DA:38,1
@@ -418,7 +418,7 @@ LF:10
 LH:9
 end_of_record
 SF:lib/src/domain/entities/blocks/table_block.dart
-DA:10,5
+DA:10,8
 DA:15,3
 DA:18,1
 DA:19,1
@@ -1621,20 +1621,12 @@ DA:61,2
 DA:64,3
 DA:67,2
 DA:70,3
-DA:71,1
-DA:73,1
 DA:77,2
 DA:80,3
-DA:81,1
-DA:83,1
 DA:87,2
 DA:90,3
 DA:97,2
 DA:100,3
-DA:101,1
-DA:102,1
-DA:103,1
-DA:104,1
 DA:109,2
 DA:112,3
 DA:114,2
@@ -1683,6 +1675,6 @@ DA:230,2
 DA:231,2
 DA:232,2
 DA:233,2
-LF:87
-LH:87
+LF:79
+LH:79
 end_of_record

coverage/lcov.info

@@ -0,0 +1 @@
+# Lint configuration placeholder. Add local lint rules or includes here if needed.

demo/analysis_options.yaml

@@ -46,10 +46,9 @@ class _MyHomePageState extends State<MyHomePage> {
   }
 
   Future<void> _loadTestData() async {
-    final data = await DefaultAssetBundle.of(context)
-        .loadString('test_data/editorjsdatatest.json');
-    final stylesJson = await DefaultAssetBundle.of(context)
-        .loadString('test_data/editorjsstyles.json');
+    final bundle = DefaultAssetBundle.of(context);
+    final data = await bundle.loadString('test_data/editorjsdatatest.json');
+    final stylesJson = await bundle.loadString('test_data/editorjsstyles.json');
 
     final stylesMap = jsonDecode(stylesJson) as Map<String, dynamic>;
     final rawTags = stylesMap['cssTags'] as List<dynamic>? ?? [];

demo/lib/main.dart

@@ -1,29 +1,11 @@
-// This is a basic Flutter widget test.
-//
-// To perform an interaction with a widget in your test, use the WidgetTester
-// utility that Flutter provides. For example, you can send tap and scroll
-// gestures. You can also use WidgetTester to find child widgets in the widget
-// tree, read text, and verify that the values of widget properties are correct.
-
 import 'package:flutter/material.dart';
 import 'package:flutter_test/flutter_test.dart';
-import '../lib/main.dart';
 
+// Smoke test for the demo app shell.
+// Full integration tests live in the package's own test/ directory.
 void main() {
-  testWidgets('Counter increments smoke test', (WidgetTester tester) async {
-    // Build our app and trigger a frame.
-    await tester.pumpWidget(MyApp());
-
-    // Verify that our counter starts at 0.
-    expect(find.text('0'), findsOneWidget);
-    expect(find.text('1'), findsNothing);
-
-    // Tap the '+' icon and trigger a frame.
-    await tester.tap(find.byIcon(Icons.add));
-    await tester.pump();
-
-    // Verify that our counter has incremented.
-    expect(find.text('0'), findsNothing);
-    expect(find.text('1'), findsOneWidget);
+  testWidgets('MaterialApp renders without throwing', (tester) async {
+    await tester.pumpWidget(const MaterialApp(home: Scaffold()));
+    expect(find.byType(MaterialApp), findsOneWidget);
   });
 }

demo/test/widget_test.dart

@@ -11,3 +11,6 @@ dependencies:
     sdk: flutter
   editorjs_flutter:
     path: ../
+
+flutter:
+  uses-material-design: true

example/pubspec.yaml

@@ -68,19 +68,19 @@ class EditorJSToolbar extends StatelessWidget {
                 icon: Icons.format_list_bulleted,
                 tooltip: 'Unordered list',
                 onTap: () => controller.addBlock(
-                  ListBlock(
+                  const ListBlock(
                     style: ListStyle.unordered,
-                    items: [const ListItem(content: '')],
+                    items: [ListItem(content: '')],
                   ),
                 ),
               ),
               _ToolbarButton(
                 icon: Icons.format_list_numbered,
                 tooltip: 'Ordered list',
                 onTap: () => controller.addBlock(
-                  ListBlock(
+                  const ListBlock(
                     style: ListStyle.ordered,
-                    items: [const ListItem(content: '')],
+                    items: [ListItem(content: '')],
                   ),
                 ),
               ),
@@ -98,7 +98,7 @@ class EditorJSToolbar extends StatelessWidget {
                 icon: Icons.table_chart_outlined,
                 tooltip: 'Table',
                 onTap: () => controller.addBlock(
-                  TableBlock(
+                  const TableBlock(
                     content: [
                       ['', ''],
                       ['', ''],