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

Viewer completeness read-only block types

Author: RZEROSTERN

CHANGELOG.md

@@ -1,3 +1,21 @@
+## [0.2.1] - 2026-03-25 — Viewer completeness: embed, linkTool, attaches, raw
+
+### New block types (viewer only)
+* `embed` — tappable card showing service name, source URL, and optional caption; opens URL via `url_launcher`.
+* `linkTool` — link preview card with thumbnail, title, description, and URL; opens link via `url_launcher`.
+* `attaches` — file download card with type-specific icon, file size, and `url_launcher` download action.
+* `raw` — raw HTML content rendered through `flutter_html` with full `HtmlSanitizer` protection.
+
+### Cross-cutting renderer improvements
+* Extracted `HtmlStyleBuilder` shared utility — applies `defaultFont` to `flutter_html` `body` style and all CSS tag overrides, eliminating duplicate helpers across renderers.
+* Applied `HtmlSanitizer.sanitize()` to `QuoteRenderer` and `ListRenderer` (HTML content fields).
+* `ImageRenderer` caption now respects `styleConfig.defaultFont`.
+
+### Exports
+* All four new block entity classes (`EmbedBlock`, `LinkToolBlock`, `AttachesBlock`, `RawBlock`) exported from the public barrel file.
+
+---
+
 ## [0.2.0] - 2026-03-25 — Phase 2: Viewer & editor completeness
 
 ### New block types (viewer + editor)

lib/editorjs_flutter.dart

@@ -33,3 +33,7 @@ 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';
+export 'src/domain/entities/blocks/embed_block.dart';
+export 'src/domain/entities/blocks/link_tool_block.dart';
+export 'src/domain/entities/blocks/attaches_block.dart';
+export 'src/domain/entities/blocks/raw_block.dart';

lib/src/data/mappers/attaches_mapper.dart

@@ -0,0 +1,21 @@
+import '../../domain/entities/blocks/attaches_block.dart';
+import 'block_mapper.dart';
+
+class AttachesMapper implements BlockMapper<AttachesBlock> {
+  const AttachesMapper();
+
+  @override
+  String get supportedType => 'attaches';
+
+  @override
+  AttachesBlock fromJson(Map<String, dynamic> data) {
+    final file = data['file'] as Map<String, dynamic>?;
+    return AttachesBlock(
+      url: (file?['url'] as String?) ?? '',
+      name: file?['name'] as String?,
+      extension: file?['extension'] as String?,
+      size: file?['size'] as int?,
+      title: data['title'] as String?,
+    );
+  }
+}

lib/src/data/mappers/embed_mapper.dart

@@ -0,0 +1,19 @@
+import '../../domain/entities/blocks/embed_block.dart';
+import 'block_mapper.dart';
+
+class EmbedMapper implements BlockMapper<EmbedBlock> {
+  const EmbedMapper();
+
+  @override
+  String get supportedType => 'embed';
+
+  @override
+  EmbedBlock fromJson(Map<String, dynamic> data) => EmbedBlock(
+        service: (data['service'] as String?) ?? '',
+        source: (data['source'] as String?) ?? '',
+        embed: (data['embed'] as String?) ?? '',
+        width: data['width'] as int?,
+        height: data['height'] as int?,
+        caption: data['caption'] as String?,
+      );
+}

lib/src/data/mappers/link_tool_mapper.dart

@@ -0,0 +1,28 @@
+import '../../domain/entities/blocks/link_tool_block.dart';
+import 'block_mapper.dart';
+
+class LinkToolMapper implements BlockMapper<LinkToolBlock> {
+  const LinkToolMapper();
+
+  @override
+  String get supportedType => 'linkTool';
+
+  @override
+  LinkToolBlock fromJson(Map<String, dynamic> data) {
+    final rawMeta = data['meta'] as Map<String, dynamic>?;
+    final rawImage = rawMeta?['image'] as Map<String, dynamic>?;
+
+    final meta = rawMeta == null
+        ? null
+        : LinkToolMeta(
+            title: rawMeta['title'] as String?,
+            description: rawMeta['description'] as String?,
+            imageUrl: rawImage?['url'] as String?,
+          );
+
+    return LinkToolBlock(
+      link: (data['link'] as String?) ?? '',
+      meta: meta,
+    );
+  }
+}

lib/src/data/mappers/raw_mapper.dart

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

lib/src/data/registry/block_type_registry.dart

@@ -1,13 +1,17 @@
 import '../../domain/entities/block_entity.dart';
+import '../mappers/attaches_mapper.dart';
 import '../mappers/block_mapper.dart';
 import '../mappers/checklist_mapper.dart';
 import '../mappers/code_mapper.dart';
 import '../mappers/delimiter_mapper.dart';
+import '../mappers/embed_mapper.dart';
 import '../mappers/header_mapper.dart';
 import '../mappers/image_mapper.dart';
+import '../mappers/link_tool_mapper.dart';
 import '../mappers/list_mapper.dart';
 import '../mappers/paragraph_mapper.dart';
 import '../mappers/quote_mapper.dart';
+import '../mappers/raw_mapper.dart';
 import '../mappers/table_mapper.dart';
 import '../mappers/warning_mapper.dart';
 
@@ -29,6 +33,10 @@ class BlockTypeRegistry {
     register(const ChecklistMapper());
     register(const TableMapper());
     register(const WarningMapper());
+    register(const EmbedMapper());
+    register(const LinkToolMapper());
+    register(const AttachesMapper());
+    register(const RawMapper());
   }
 
   /// Registers a [BlockMapper]. Overwrites any existing mapper for the same type.

lib/src/domain/entities/blocks/attaches_block.dart

@@ -0,0 +1,34 @@
+import '../block_entity.dart';
+
+class AttachesBlock extends BlockEntity {
+  final String url;
+  final String? name;
+  final String? extension;
+
+  /// File size in bytes. Null if not provided.
+  final int? size;
+
+  final String? title;
+
+  const AttachesBlock({
+    required this.url,
+    this.name,
+    this.extension,
+    this.size,
+    this.title,
+  });
+
+  @override
+  String get type => 'attaches';
+
+  @override
+  Map<String, dynamic> toJson() => {
+        'file': {
+          'url': url,
+          if (name != null) 'name': name,
+          if (extension != null) 'extension': extension,
+          if (size != null) 'size': size,
+        },
+        'title': title ?? '',
+      };
+}

lib/src/domain/entities/blocks/embed_block.dart

@@ -0,0 +1,39 @@
+import '../block_entity.dart';
+
+class EmbedBlock extends BlockEntity {
+  /// The service name (e.g. 'youtube', 'vimeo', 'codepen').
+  final String service;
+
+  /// Original source URL as entered by the user.
+  final String source;
+
+  /// Embed URL (typically an iframe src). Not used for rendering in Flutter,
+  /// but preserved for round-trip JSON serialization.
+  final String embed;
+
+  final int? width;
+  final int? height;
+  final String? caption;
+
+  const EmbedBlock({
+    required this.service,
+    required this.source,
+    required this.embed,
+    this.width,
+    this.height,
+    this.caption,
+  });
+
+  @override
+  String get type => 'embed';
+
+  @override
+  Map<String, dynamic> toJson() => {
+        'service': service,
+        'source': source,
+        'embed': embed,
+        if (width != null) 'width': width,
+        if (height != null) 'height': height,
+        'caption': caption ?? '',
+      };
+}

lib/src/domain/entities/blocks/link_tool_block.dart

@@ -0,0 +1,31 @@
+import '../block_entity.dart';
+
+class LinkToolMeta {
+  final String? title;
+  final String? description;
+  final String? imageUrl;
+
+  const LinkToolMeta({this.title, this.description, this.imageUrl});
+
+  Map<String, dynamic> toJson() => {
+        if (title != null) 'title': title,
+        if (description != null) 'description': description,
+        if (imageUrl != null) 'image': {'url': imageUrl},
+      };
+}
+
+class LinkToolBlock extends BlockEntity {
+  final String link;
+  final LinkToolMeta? meta;
+
+  const LinkToolBlock({required this.link, this.meta});
+
+  @override
+  String get type => 'linkTool';
+
+  @override
+  Map<String, dynamic> toJson() => {
+        'link': link,
+        if (meta != null) 'meta': meta!.toJson(),
+      };
+}