Merge pull request #17 from RZEROSTERN/feat/phase-2-viewer-completeness

Added available components to library

Author: RZEROSTERN

.gitignore

@@ -82,4 +82,6 @@ CLAUDE.local.md
 # FVM Version Cache
 .fvm/
 
-.vscode/
+.vscode/
+
+PR_DESCRIPTION.md

CHANGELOG.md

@@ -1,3 +1,29 @@
+## [0.2.0] - 2026-03-25 — Phase 2: Viewer & editor completeness
+
+### New block types (viewer + editor)
+* `quote` — blockquote with optional caption and left/center/right alignment.
+* `code` — monospace code block with horizontal scroll, selectable text, and a copy-to-clipboard button.
+* `checklist` — checkbox list with checked/unchecked state; strikethrough rendered on checked items.
+* `table` — 2-D table with optional heading row, horizontal scroll, and add/remove row & column controls in the editor.
+* `warning` — highlighted alert box with title and message fields.
+
+### Nested list support
+* `ListBlock` items are now `ListItem` objects with a recursive `items` field.
+* `ListMapper` handles both flat string items (`@editorjs/list`) and nested object items (`@editorjs/nested-list`) transparently.
+* `ListRenderer` renders nested items with indentation per depth level.
+
+### HTML sanitization
+* Added `HtmlSanitizer` utility in the data layer that strips `<script>`, `<iframe>`, and `on*` event handler attributes before passing HTML to `flutter_html`.
+* Applied in `ParagraphRenderer` and will apply to any renderer that calls `HtmlSanitizer.sanitize()`.
+
+### Toolbar
+* Added toolbar buttons for all new block types: Quote, Code, Checklist, Table, Warning.
+
+### Exports
+* All five new block entity classes are exported from the public barrel file.
+
+---
+
 ## [0.1.0] - 2026-03-25 — Clean Architecture refactor (breaking)
 
 This release is a full architectural rewrite. The public API has changed.

lib/editorjs_flutter.dart

@@ -28,3 +28,8 @@ export 'src/domain/entities/blocks/paragraph_block.dart';
 export 'src/domain/entities/blocks/list_block.dart';
 export 'src/domain/entities/blocks/delimiter_block.dart';
 export 'src/domain/entities/blocks/image_block.dart';
+export 'src/domain/entities/blocks/quote_block.dart';
+export 'src/domain/entities/blocks/code_block.dart';
+export 'src/domain/entities/blocks/checklist_block.dart';
+export 'src/domain/entities/blocks/table_block.dart';
+export 'src/domain/entities/blocks/warning_block.dart';

lib/src/data/mappers/checklist_mapper.dart

@@ -0,0 +1,22 @@
+import '../../domain/entities/blocks/checklist_block.dart';
+import 'block_mapper.dart';
+
+class ChecklistMapper implements BlockMapper<ChecklistBlock> {
+  const ChecklistMapper();
+
+  @override
+  String get supportedType => 'checklist';
+
+  @override
+  ChecklistBlock fromJson(Map<String, dynamic> data) {
+    final rawItems = (data['items'] as List<dynamic>?) ?? [];
+    return ChecklistBlock(
+      items: rawItems.whereType<Map<String, dynamic>>().map((i) {
+        return ChecklistItem(
+          text: (i['text'] as String?) ?? '',
+          checked: (i['checked'] as bool?) ?? false,
+        );
+      }).toList(),
+    );
+  }
+}

lib/src/data/mappers/code_mapper.dart

@@ -0,0 +1,13 @@
+import '../../domain/entities/blocks/code_block.dart';
+import 'block_mapper.dart';
+
+class CodeMapper implements BlockMapper<CodeBlock> {
+  const CodeMapper();
+
+  @override
+  String get supportedType => 'code';
+
+  @override
+  CodeBlock fromJson(Map<String, dynamic> data) =>
+      CodeBlock(code: (data['code'] as String?) ?? '');
+}

lib/src/data/mappers/list_mapper.dart

@@ -14,7 +14,23 @@ class ListMapper implements BlockMapper<ListBlock> {
 
     return ListBlock(
       style: styleStr == 'ordered' ? ListStyle.ordered : ListStyle.unordered,
-      items: rawItems.map((e) => e.toString()).toList(),
+      items: rawItems.map(_parseItem).toList(),
     );
   }
+
+  /// Handles both flat string items (standard @editorjs/list) and
+  /// nested object items (@editorjs/nested-list).
+  ListItem _parseItem(dynamic raw) {
+    if (raw is String) {
+      return ListItem(content: raw);
+    }
+    if (raw is Map<String, dynamic>) {
+      final nestedRaw = (raw['items'] as List<dynamic>?) ?? [];
+      return ListItem(
+        content: (raw['content'] as String?) ?? '',
+        items: nestedRaw.map(_parseItem).toList(),
+      );
+    }
+    return ListItem(content: raw.toString());
+  }
 }

lib/src/data/mappers/quote_mapper.dart

@@ -0,0 +1,22 @@
+import '../../domain/entities/blocks/quote_block.dart';
+import 'block_mapper.dart';
+
+class QuoteMapper implements BlockMapper<QuoteBlock> {
+  const QuoteMapper();
+
+  @override
+  String get supportedType => 'quote';
+
+  @override
+  QuoteBlock fromJson(Map<String, dynamic> data) {
+    final alignStr = (data['alignment'] as String?) ?? 'left';
+    return QuoteBlock(
+      text: (data['text'] as String?) ?? '',
+      caption: data['caption'] as String?,
+      alignment: QuoteAlignment.values.firstWhere(
+        (a) => a.name == alignStr,
+        orElse: () => QuoteAlignment.left,
+      ),
+    );
+  }
+}

lib/src/data/mappers/table_mapper.dart

@@ -0,0 +1,21 @@
+import '../../domain/entities/blocks/table_block.dart';
+import 'block_mapper.dart';
+
+class TableMapper implements BlockMapper<TableBlock> {
+  const TableMapper();
+
+  @override
+  String get supportedType => 'table';
+
+  @override
+  TableBlock fromJson(Map<String, dynamic> data) {
+    final rawContent = (data['content'] as List<dynamic>?) ?? [];
+    return TableBlock(
+      withHeadings: (data['withHeadings'] as bool?) ?? false,
+      content: rawContent.map((row) {
+        final List<dynamic> rowList = row is List ? row : <dynamic>[];
+        return rowList.map((cell) => cell.toString()).toList();
+      }).toList(),
+    );
+  }
+}

lib/src/data/mappers/warning_mapper.dart

@@ -0,0 +1,15 @@
+import '../../domain/entities/blocks/warning_block.dart';
+import 'block_mapper.dart';
+
+class WarningMapper implements BlockMapper<WarningBlock> {
+  const WarningMapper();
+
+  @override
+  String get supportedType => 'warning';
+
+  @override
+  WarningBlock fromJson(Map<String, dynamic> data) => WarningBlock(
+        title: (data['title'] as String?) ?? '',
+        message: (data['message'] as String?) ?? '',
+      );
+}

lib/src/data/registry/block_type_registry.dart

@@ -1,10 +1,15 @@
 import '../../domain/entities/block_entity.dart';
 import '../mappers/block_mapper.dart';
+import '../mappers/checklist_mapper.dart';
+import '../mappers/code_mapper.dart';
 import '../mappers/delimiter_mapper.dart';
 import '../mappers/header_mapper.dart';
 import '../mappers/image_mapper.dart';
 import '../mappers/list_mapper.dart';
 import '../mappers/paragraph_mapper.dart';
+import '../mappers/quote_mapper.dart';
+import '../mappers/table_mapper.dart';
+import '../mappers/warning_mapper.dart';
 
 /// Maps EditorJS block type strings to their [BlockMapper] implementations.
 ///
@@ -19,6 +24,11 @@ class BlockTypeRegistry {
     register(const ListMapper());
     register(const DelimiterMapper());
     register(const ImageMapper());
+    register(const QuoteMapper());
+    register(const CodeMapper());
+    register(const ChecklistMapper());
+    register(const TableMapper());
+    register(const WarningMapper());
   }
 
   /// Registers a [BlockMapper]. Overwrites any existing mapper for the same type.