bkinnightskytw
/
pdf_signature
mirror of https://github.com/existedinnettw/pdf_signature.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

feat: partially implement new feature test

This commit is contained in:
insleker 2025-09-09 22:26:33 +08:00
parent 380be43c05
commit 21a0638bf0
87 changed files with 661 additions and 732 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
integration_test/export_flow_test.dart
View File

@ -122,11 +122,11 @@ void main() {
final sigState = container.read(signatureProvider);
final r = sigState.rect!;
final lib = container.read(signatureLibraryProvider);
final imageId = lib.isNotEmpty ? lib.first.id : 'default.png';
final imageId = lib.isNotEmpty ? lib.first.id : '';
final pdf = container.read(pdfProvider);
container
.read(pdfProvider.notifier)
.addPlacement(page: pdf.currentPage, rect: r, imageId: imageId);
.addPlacement(page: pdf.currentPage, rect: r, assetId: imageId);
container.read(signatureProvider.notifier).clearActiveOverlay();
await tester.pumpAndSettle();

49
lib/data/model/model.dart
View File

@ -38,11 +38,23 @@ class GraphicAdjust {
class SignatureCard {
final double rotationDeg;
final SignatureAsset asset;
final GraphicAdjust graphicAdjust;
GraphicAdjust graphicAdjust;
const SignatureCard({
required this.rotationDeg,
required this.asset,
this.graphicAdjust = const GraphicAdjust(),
});
SignatureCard({required this.rotationDeg, required this.asset})
: graphicAdjust = GraphicAdjust();
SignatureCard copyWith({
double? rotationDeg,
SignatureAsset? asset,
GraphicAdjust? graphicAdjust,
}) => SignatureCard(
rotationDeg: rotationDeg ?? this.rotationDeg,
asset: asset ?? this.asset,
graphicAdjust: graphicAdjust ?? this.graphicAdjust,
);
}
/// Represents a single signature placement on a page combining both the
@ -52,29 +64,28 @@ class SignaturePlacement {
// The bounding box of this placement in UI coordinate space, implies scaling and position.
final Rect rect;
/// from `SignatureCard`
/// Rotation in degrees to apply when rendering/exporting this placement.
final double rotationDeg;
GraphicAdjust graphicAdjust;
final SignatureAsset asset;
final GraphicAdjust graphicAdjust;
final String assetId; // ID of the signature asset
SignaturePlacement({
const SignaturePlacement({
required this.rect,
required this.asset,
required this.assetId,
this.rotationDeg = 0.0,
GraphicAdjust graphicAdjust = const GraphicAdjust(),
}) : graphicAdjust = graphicAdjust;
this.graphicAdjust = const GraphicAdjust(),
});
SignaturePlacement copyWith({
required Rect rect,
required SignatureAsset asset,
double rotationDeg = 0.0,
GraphicAdjust graphicAdjust = const GraphicAdjust(),
Rect? rect,
String? assetId,
double? rotationDeg,
GraphicAdjust? graphicAdjust,
}) => SignaturePlacement(
rect: rect,
asset: asset,
rotationDeg: rotationDeg,
graphicAdjust: graphicAdjust,
rect: rect ?? this.rect,
assetId: assetId ?? this.assetId,
rotationDeg: rotationDeg ?? this.rotationDeg,
graphicAdjust: graphicAdjust ?? this.graphicAdjust,
);
}
@ -85,7 +96,7 @@ class PdfState {
final String? pickedPdfPath;
final Uint8List? pickedPdfBytes;
final int? signedPage;
// Multiple signature placements per page, each combines geometry and optional image id.
// Multiple signature placements per page, each combines geometry and asset id.
final Map<int, List<SignaturePlacement>> placementsByPage;
// UI state: selected placement index on the current page (if any)
final int? selectedPlacementIndex;

8
lib/data/services/export_service.dart
View File

@ -148,8 +148,8 @@ class ExportService {
final w = r.width / uiPageSize.width * widthPts;
final h = r.height / uiPageSize.height * heightPts;
Uint8List? bytes;
final id = placement.imageId;
if (id != null) {
final id = placement.assetId;
if (id.isNotEmpty) {
bytes = libraryBytes?[id];
}
bytes ??= signatureImageBytes; // fallback
@ -275,8 +275,8 @@ class ExportService {
final w = r.width / uiPageSize.width * widthPts;
final h = r.height / uiPageSize.height * heightPts;
Uint8List? bytes;
final id = placement.imageId;
if (id != null) {
final id = placement.assetId;
if (id.isNotEmpty) {
bytes = libraryBytes?[id];
}
bytes ??= signatureImageBytes; // fallback

10
lib/ui/features/pdf/view_model/pdf_controller.dart
View File

@ -65,7 +65,7 @@ class PdfController extends StateNotifier<PdfState> {
void addPlacement({
required int page,
required Rect rect,
String? imageId = 'default.png',
String? assetId,
double rotationDeg = 0.0,
}) {
if (!state.loaded) return;
@ -75,7 +75,7 @@ class PdfController extends StateNotifier<PdfState> {
list.add(
SignaturePlacement(
rect: rect,
imageId: imageId,
assetId: assetId ?? '',
rotationDeg: rotationDeg,
),
);
@ -165,11 +165,11 @@ class PdfController extends StateNotifier<PdfState> {
// NOTE: Programmatic reassignment of images has been removed.
// Convenience to get image name for a placement
String? imageOfPlacement({required int page, required int index}) {
// Convenience to get asset id for a placement
String? assetIdOfPlacement({required int page, required int index}) {
final list = state.placementsByPage[page] ?? const [];
if (index < 0 || index >= list.length) return null;
return list[index].imageId;
return list[index].assetId;
}
}

10
lib/ui/features/pdf/widgets/signature_drawer.dart
View File

@ -2,7 +2,7 @@ import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:pdf_signature/data/model/model.dart';
import 'package:pdf_signature/data/model/model.dart' as model;
import '../../../../data/services/export_providers.dart';
import '../../signature/view_model/signature_controller.dart';
@ -54,7 +54,7 @@ class _SignatureDrawerState extends ConsumerState<SignatureDrawer> {
key: ValueKey('sig_card_${a.id}'),
asset:
(sig.assetId == a.id)
? SignatureAsset(
? model.SignatureAsset(
id: a.id,
bytes: (processed ?? a.bytes),
name: a.name,
@ -97,7 +97,11 @@ class _SignatureDrawerState extends ConsumerState<SignatureDrawer> {
bytes == null
? Text(l.noSignatureLoaded)
: SignatureCard(
asset: SignatureAsset(id: '', bytes: bytes, name: ''),
asset: model.SignatureAsset(
id: '',
bytes: bytes,
name: '',
),
rotationDeg: sig.rotation,
disabled: disabled,
useCurrentBytesForDrag: true,

4
lib/ui/features/pdf/widgets/signature_overlay.dart
View File

@ -245,8 +245,8 @@ class _SignatureImage extends ConsumerWidget {
(placementList != null && placedIndex! < placementList.length)
? placementList[placedIndex!]
: null;
final imgId = placement?.imageId;
if (imgId != null) {
final imgId = placement?.assetId;
if (imgId != null && imgId.isNotEmpty) {
final lib = ref.watch(signatureLibraryProvider);
for (final a in lib) {
if (a.id == imgId) {

4
lib/ui/features/signature/view_model/signature_controller.dart
View File

@ -188,7 +188,7 @@ class SignatureController extends StateNotifier<SignatureState> {
.addPlacement(
page: pdf.currentPage,
rect: r,
imageId: id,
assetId: id,
rotationDeg: state.rotation,
);
// Newly placed index is the last one on the page
@ -220,7 +220,7 @@ class SignatureController extends StateNotifier<SignatureState> {
.addPlacement(
page: pdf.currentPage,
rect: r,
imageId: id,
assetId: id,
rotationDeg: state.rotation,
);
final idx =

6
test/features/step/a_created_signature_card.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a created signature card
Future<void> aCreatedSignatureCard(WidgetTester tester) async {
throw UnimplementedError();
}

22
test/features/step/the_signature_on_page_is_shown_on_page.dart → test/features/step/a_document_is_open_and_contains_at_least_one_signature_placement.dart
View File

@ -1,23 +1,23 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the signature on page {5} is shown on page {5}
Future<void> theSignatureOnPageIsShownOnPage(
/// Usage: a document is open and contains at least one signature placement
Future<void> aDocumentIsOpenAndContainsAtLeastOneSignaturePlacement(
WidgetTester tester,
num sourcePage,
num targetPage,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final srcList = container
container
.read(pdfProvider.notifier)
.placementsOn(sourcePage.toInt());
final tgtList = container
.openPicked(path: 'test.pdf', pageCount: 5);
container
.read(pdfProvider.notifier)
.placementsOn(targetPage.toInt());
// At least one exists on both
expect(srcList, isNotEmpty);
expect(tgtList, isNotEmpty);
.addPlacement(
page: 1,
rect: Rect.fromLTWH(10, 10, 100, 50),
assetId: 'sig.png',
);
}

38
test/features/step/a_document_is_open_and_contains_multiple_placed_signature_placements_across_pages.dart Normal file
View File

@ -0,0 +1,38 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a document is open and contains multiple placed signature placements across pages
Future<void>
aDocumentIsOpenAndContainsMultiplePlacedSignaturePlacementsAcrossPages(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'multi.pdf', pageCount: 5);
container
.read(pdfProvider.notifier)
.addPlacement(
page: 1,
rect: Rect.fromLTWH(10, 10, 100, 50),
assetId: 'sig1.png',
);
container
.read(pdfProvider.notifier)
.addPlacement(
page: 2,
rect: Rect.fromLTWH(20, 20, 100, 50),
assetId: 'sig2.png',
);
container
.read(pdfProvider.notifier)
.addPlacement(
page: 3,
rect: Rect.fromLTWH(30, 30, 100, 50),
assetId: 'sig3.png',
);
}

10
test/features/step/a_sample_multipage_pdf5_pages_is_available.dart → test/features/step/a_document_is_open_with_no_signature_placements_placed.dart
View File

@ -3,12 +3,14 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a sample multi-page PDF (5 pages) is available
Future<void> aSampleMultipagePdf5PagesIsAvailable(WidgetTester tester) async {
/// Usage: a document is open with no signature placements placed
Future<void> aDocumentIsOpenWithNoSignaturePlacementsPlaced(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Open a mock document with 5 pages
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
.openPicked(path: 'empty.pdf', pageCount: 5);
// No placements added
}

8
test/features/step/a_pdf_page_is_selected_for_signing.dart → test/features/step/a_document_page_is_selected_for_signing.dart
View File

@ -3,12 +3,10 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a PDF page is selected for signing
Future<void> aPdfPageIsSelectedForSigning(WidgetTester tester) async {
/// Usage: a document page is selected for signing
Future<void> aDocumentPageIsSelectedForSigning(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 1);
container.read(pdfProvider.notifier).setSignedPage(1);
container.read(pdfProvider.notifier).jumpTo(1);
}

17
test/features/step/a_signature_image_is_placed_on_the_page.dart → test/features/step/a_multipage_document_is_open.dart
View File

@ -1,20 +1,19 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_library.dart';
import 'package:pdf_signature/data/model/model.dart';
import '_world.dart';
/// Usage: a signature image is placed on the page
Future<void> aSignatureImageIsPlacedOnThePage(WidgetTester tester) async {
/// Usage: a multi-page document is open
Future<void> aMultipageDocumentIsOpen(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container.read(signatureLibraryProvider.notifier).state = [];
container.read(pdfProvider.notifier).state = PdfState.initial();
container.read(signatureProvider.notifier).state = SignatureState.initial();
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
container.read(pdfProvider.notifier).setSignedPage(1);
// Set an image to ensure rect exists
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
}

7
test/features/step/a_new_document_file_is_saved_at_specified_full_path_location_and_file_name.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a new document file is saved at specified full path, location and file name
Future<void> aNewDocumentFileIsSavedAtSpecifiedFullPathLocationAndFileName(
WidgetTester tester) async {
throw UnimplementedError();
}

15
test/features/step/a_new_pdf_file_is_saved_at_specified_full_path_location_and_file_name.dart
View File

@ -1,15 +0,0 @@
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import '_world.dart';
/// Usage: a new PDF file is saved at specified full path, location and file name
Future<void> aNewPdfFileIsSavedAtSpecifiedFullPathLocationAndFileName(
WidgetTester tester,
) async {
if (TestWorld.lastSavedPath != null) {
expect(File(TestWorld.lastSavedPath!).existsSync(), isTrue);
} else {
expect(TestWorld.lastExportBytes, isNotNull);
expect(TestWorld.lastExportBytes!.isNotEmpty, isTrue);
}
}

26
test/features/step/a_pdf_is_open_and_contains_at_least_one_placed_signature.dart
View File

@ -1,26 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a PDF is open and contains at least one placed signature
Future<void> aPdfIsOpenAndContainsAtLeastOnePlacedSignature(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(
path: 'mock.pdf',
pageCount: 2,
bytes: Uint8List.fromList([1, 2, 3]),
);
container.read(pdfProvider.notifier).setSignedPage(1);
container.read(signatureProvider.notifier).placeDefaultRect();
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
}

32
test/features/step/a_pdf_is_open_and_contains_multiple_placed_signatures_across_pages.dart
View File

@ -1,32 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a PDF is open and contains multiple placed signatures across pages
Future<void> aPdfIsOpenAndContainsMultiplePlacedSignaturesAcrossPages(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 6);
// Ensure signature image exists
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
// Place on two pages
container
.read(pdfProvider.notifier)
.addPlacement(page: 1, rect: const Rect.fromLTWH(10, 10, 80, 40));
container
.read(pdfProvider.notifier)
.addPlacement(page: 4, rect: const Rect.fromLTWH(120, 200, 100, 50));
// Keep backward compatibility with existing export step expectations
container.read(pdfProvider.notifier).setSignedPage(1);
container.read(signatureProvider.notifier).placeDefaultRect();
}

17
test/features/step/a_pdf_is_open_with_no_signatures_placed.dart
View File

@ -1,17 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a PDF is open with no signatures placed
Future<void> aPdfIsOpenWithNoSignaturesPlaced(WidgetTester tester) async {
// Fresh world for this scenario to avoid leftover rect/image from previous tests
TestWorld.reset();
final container = ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 1);
container.read(signatureProvider.notifier).resetForNewPage();
}

8
test/features/step/a_multipage_pdf_is_open.dart → test/features/step/a_sample_multipage_document5_pages_is_available.dart
View File

@ -3,11 +3,13 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a multi-page PDF is open
Future<void> aMultipagePdfIsOpen(WidgetTester tester) async {
/// Usage: a sample multi-page document (5 pages) is available
Future<void> aSampleMultipageDocument5PagesIsAvailable(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'sample.pdf', pageCount: 10);
.openPicked(path: 'sample.pdf', pageCount: 5);
}

6
test/features/step/a_signature_asset_is_created.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a signature asset is created
Future<void> aSignatureAssetIsCreated(WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/a_signature_asset_is_loaded_or_drawn.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a signature asset is loaded or drawn
Future<void> aSignatureAssetIsLoadedOrDrawn(WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/a_signature_asset_is_placed_on_the_page.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a signature asset is placed on the page
Future<void> aSignatureAssetIsPlacedOnThePage(WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/a_signature_asset_is_selected.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a signature asset is selected
Future<void> aSignatureAssetIsSelected(WidgetTester tester) async {
throw UnimplementedError();
}

23
test/features/step/a_signature_asset_loaded_or_drawn_is_wrapped_in_a_signature_card.dart Normal file
View File

@ -0,0 +1,23 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_library.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/data/model/model.dart';
import '_world.dart';
/// Usage: a signature asset loaded or drawn is wrapped in a signature card
Future<void> aSignatureAssetLoadedOrDrawnIsWrappedInASignatureCard(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container.read(signatureLibraryProvider.notifier).state = [];
container.read(pdfProvider.notifier).state = PdfState.initial();
container.read(signatureProvider.notifier).state = SignatureState.initial();
final bytes = Uint8List.fromList([1, 2, 3, 4, 5]);
container
.read(signatureLibraryProvider.notifier)
.add(bytes, name: 'test.png');
}

10
test/features/step/a_signature_image_is_created.dart
View File

@ -1,10 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: a signature image is created
Future<void> aSignatureImageIsCreated(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
expect(container.read(signatureProvider).imageBytes, isNotNull);
}

14
test/features/step/a_signature_image_is_loaded_or_drawn.dart
View File

@ -1,14 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: a signature image is loaded or drawn
Future<void> aSignatureImageIsLoadedOrDrawn(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
}

28
test/features/step/a_signature_image_is_selected.dart
View File

@ -1,28 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a signature image is selected
Future<void> aSignatureImageIsSelected(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 2);
container.read(pdfProvider.notifier).setSignedPage(1);
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
// Allow provider scheduler to process queued updates fully
await tester.pumpAndSettle();
// Extra pump with a non-zero duration to flush zero-delay timers
await tester.pump(const Duration(milliseconds: 1));
// Teardown to avoid pending timers from Riverpod's scheduler
addTearDown(() {
TestWorld.container?.dispose();
TestWorld.container = null;
});
}

25
test/features/step/a_signature_is_placed_on_page.dart
View File

@ -1,25 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a signature is placed on page {2}
Future<void> aSignatureIsPlacedOnPage(WidgetTester tester, num page) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 6);
// Ensure image and rect
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
container.read(signatureProvider.notifier).placeDefaultRect();
final Rect r = container.read(signatureProvider).rect!;
container
.read(pdfProvider.notifier)
.addPlacement(page: page.toInt(), rect: r, imageId: 'default.png');
}

37
test/features/step/a_signature_is_placed_with_a_position_and_size_relative_to_the_page.dart
View File

@ -1,37 +0,0 @@
import 'dart:typed_data';
import 'dart:ui';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a signature is placed with a position and size relative to the page
Future<void> aSignatureIsPlacedWithAPositionAndSizeRelativeToThePage(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(pdfProvider.notifier)
.openPicked(
path: 'mock.pdf',
pageCount: 2,
bytes: Uint8List.fromList([1, 2, 3]),
);
container.read(pdfProvider.notifier).setSignedPage(1);
final r = Rect.fromLTWH(50, 100, 120, 60);
final sigN = container.read(signatureProvider.notifier);
sigN.placeDefaultRect();
// overwrite to desired rect
final sig = container.read(signatureProvider);
sigN
..toggleAspect(true)
..resize(Offset(r.width - sig.rect!.width, r.height - sig.rect!.height));
// move to target top-left
final movedDelta = Offset(r.left - sig.rect!.left, r.top - sig.rect!.top);
sigN.drag(movedDelta);
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([4, 5, 6]));
}

7
test/features/step/a_signature_placement_appears_on_the_page_based_on_the_signature_card.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: a signature placement appears on the page based on the signature card
Future<void> aSignaturePlacementAppearsOnThePageBasedOnTheSignatureCard(
WidgetTester tester) async {
throw UnimplementedError();
}

18
test/features/step/three_signatures_are_placed_on_the_current_page.dart → test/features/step/a_signature_placement_is_placed_on_page.dart
View File

@ -1,20 +1,22 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: three signatures are placed on the current page
Future<void> threeSignaturesArePlacedOnTheCurrentPage(
/// Usage: a signature placement is placed on page {2}
Future<void> aSignaturePlacementIsPlacedOnPage(
WidgetTester tester,
num param1,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final page = param1.toInt();
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
final n = container.read(pdfProvider.notifier);
n.addPlacement(page: 1, rect: const Rect.fromLTWH(10, 10, 80, 40));
n.addPlacement(page: 1, rect: const Rect.fromLTWH(100, 50, 80, 40));
n.addPlacement(page: 1, rect: const Rect.fromLTWH(200, 90, 80, 40));
.addPlacement(
page: page,
rect: Rect.fromLTWH(20, 20, 100, 50),
assetId: 'test.png',
);
}

21
test/features/step/a_signature_placement_is_placed_with_a_position_and_size_relative_to_the_page.dart Normal file
View File

@ -0,0 +1,21 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: a signature placement is placed with a position and size relative to the page
Future<void> aSignaturePlacementIsPlacedWithAPositionAndSizeRelativeToThePage(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final pdf = container.read(pdfProvider);
container
.read(pdfProvider.notifier)
.addPlacement(
page: pdf.currentPage,
rect: Rect.fromLTWH(50, 50, 200, 100),
assetId: 'test.png',
);
}

2
test/features/step/adjusting_one_instance_does_not_affect_the_others.dart
View File

@ -14,7 +14,7 @@ Future<void> adjustingOneInstanceDoesNotAffectTheOthers(
container.read(pdfProvider.notifier).removePlacement(page: 2, index: 0);
container
.read(pdfProvider.notifier)
.addPlacement(page: 2, rect: modified, imageId: before[0].imageId);
.addPlacement(page: 2, rect: modified, assetId: before[0].assetId);
final after = container.read(pdfProvider.notifier).placementsOn(2);
expect(after.any((p) => p.rect == before[1].rect), isTrue);
}

7
test/features/step/adjusting_one_of_the_signature_placements_does_not_affect_the_others.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: adjusting one of the signature placements does not affect the others
Future<void> adjustingOneOfTheSignaturePlacementsDoesNotAffectTheOthers(
WidgetTester tester) async {
throw UnimplementedError();
}

18
test/features/step/all_placed_signature_placements_appear_on_their_corresponding_pages_in_the_output.dart Normal file
View File

@ -0,0 +1,18 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: all placed signature placements appear on their corresponding pages in the output
Future<void>
allPlacedSignaturePlacementsAppearOnTheirCorrespondingPagesInTheOutput(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final totalPlacements = pdf.placementsByPage.values.fold(
0,
(sum, list) => sum + list.length,
);
expect(totalPlacements, greaterThan(1));
}

17
test/features/step/all_placed_signatures_appear_on_their_corresponding_pages_in_the_output.dart
View File

@ -1,17 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: all placed signatures appear on their corresponding pages in the output
Future<void> allPlacedSignaturesAppearOnTheirCorrespondingPagesInTheOutput(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
expect(container.read(pdfProvider.notifier).placementsOn(1), isNotEmpty);
// One of 4 or 5 depending on scenario
final p4 = container.read(pdfProvider.notifier).placementsOn(4);
final p5 = container.read(pdfProvider.notifier).placementsOn(5);
expect(p4.isNotEmpty || p5.isNotEmpty, isTrue);
expect(TestWorld.lastExportBytes, isNotNull);
}

14
test/features/step/both_signature_placements_are_shown_on_their_respective_pages.dart Normal file
View File

@ -0,0 +1,14 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: both signature placements are shown on their respective pages
Future<void> bothSignaturePlacementsAreShownOnTheirRespectivePages(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
expect(pdf.placementsByPage[1], isNotEmpty);
expect(pdf.placementsByPage[3], isNotEmpty);
}

15
test/features/step/both_signatures_are_shown_on_their_respective_pages.dart
View File

@ -1,15 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: both signatures are shown on their respective pages
Future<void> bothSignaturesAreShownOnTheirRespectivePages(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final p1 = container.read(pdfProvider.notifier).placementsOn(1);
final p3 = container.read(pdfProvider.notifier).placementsOn(3);
expect(p1, isNotEmpty);
expect(p3, isNotEmpty);
}

2
test/features/step/dragging_or_resizing_one_does_not_change_the_other.dart
View File

@ -20,7 +20,7 @@ Future<void> draggingOrResizingOneDoesNotChangeTheOther(
.addPlacement(
page: 1,
rect: changed,
imageId: list[1].imageId,
assetId: list[1].assetId,
rotationDeg: list[1].rotationDeg,
);
final after = container.read(pdfProvider.notifier).placementsOn(1);

19
test/features/step/each_signature_can_be_dragged_and_resized_independently.dart
View File

@ -1,19 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: each signature can be dragged and resized independently
Future<void> eachSignatureCanBeDraggedAndResizedIndependently(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final list = container.read(pdfProvider.notifier).placementsOn(1);
expect(list.length, greaterThanOrEqualTo(2));
// Independence is modeled by distinct rects; ensure not equal and both within page
expect(list[0].rect, isNot(equals(list[1].rect)));
for (final p in list.take(2)) {
expect(p.rect.left, greaterThanOrEqualTo(0));
expect(p.rect.top, greaterThanOrEqualTo(0));
}
}

14
test/features/step/each_signature_placement_can_be_dragged_and_resized_independently.dart Normal file
View File

@ -0,0 +1,14 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: each signature placement can be dragged and resized independently
Future<void> eachSignaturePlacementCanBeDraggedAndResizedIndependently(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.length, greaterThan(1));
}

16
test/features/step/identical_signature_placements_appear_in_each_location.dart Normal file
View File

@ -0,0 +1,16 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: identical signature placements appear in each location
Future<void> identicalSignaturePlacementsAppearInEachLocation(
WidgetTester tester,
) async {
final container = TestWorld.container!;
final pdf = container.read(pdfProvider);
final allPlacements =
pdf.placementsByPage.values.expand((list) => list).toList();
final assetIds = allPlacements.map((p) => p.assetId).toSet();
expect(assetIds.length, 1); // All the same
}

10
test/features/step/it_is_placed_on_the_selected_page.dart
View File

@ -1,10 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: it is placed on the selected page
Future<void> itIsPlacedOnTheSelectedPage(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
expect(container.read(signatureProvider).imageBytes, isNotNull);
}

11
test/features/step/only_the_selected_signature_is_removed.dart
View File

@ -1,11 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: only the selected signature is removed
Future<void> onlyTheSelectedSignatureIsRemoved(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final list = container.read(pdfProvider.notifier).placementsOn(1);
expect(list.length, 2);
}

14
test/features/step/only_the_selected_signature_placement_is_removed.dart Normal file
View File

@ -0,0 +1,14 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: only the selected signature placement is removed
Future<void> onlyTheSelectedSignaturePlacementIsRemoved(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.length, lessThan(3)); // Assuming started with 3, removed 1
}

6
test/features/step/resize_to_fit_within_bounding_box.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: resize to fit within bounding box
Future<void> resizeToFitWithinBoundingBox(WidgetTester tester) async {
throw UnimplementedError();
}

7
test/features/step/signature_placement_occurs_on_the_selected_page.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: signature placement occurs on the selected page
Future<void> signaturePlacementOccursOnTheSelectedPage(
WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/the_app_attempts_to_load_the_asset.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the app attempts to load the asset
Future<void> theAppAttemptsToLoadTheAsset(WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/the_app_attempts_to_load_the_image.dart
View File

@ -1,6 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the app attempts to load the image
Future<void> theAppAttemptsToLoadTheImage(WidgetTester tester) async {
// No-op for logic-level test; selection step already applied state.
}

7
test/features/step/the_asset_is_loaded_and_shown_as_a_signature_asset.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the asset is loaded and shown as a signature asset
Future<void> theAssetIsLoadedAndShownAsASignatureAsset(
WidgetTester tester) async {
throw UnimplementedError();
}

7
test/features/step/the_asset_is_loaded_and_shown_as_a_signature_card.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the asset is loaded and shown as a signature card
Future<void> theAssetIsLoadedAndShownAsASignatureCard(
WidgetTester tester) async {
throw UnimplementedError();
}

6
test/features/step/the_asset_is_not_added_to_the_document.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the asset is not added to the document
Future<void> theAssetIsNotAddedToTheDocument(WidgetTester tester) async {
throw UnimplementedError();
}

14
test/features/step/the_image_is_loaded_and_shown_as_a_signature_asset.dart
View File

@ -1,14 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the image is loaded and shown as a signature asset
Future<void> theImageIsLoadedAndShownAsASignatureAsset(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
expect(sig.imageBytes, isNotNull);
expect(sig.rect, isNotNull);
}

11
test/features/step/the_image_is_not_added_to_the_document.dart
View File

@ -1,11 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the image is not added to the document
Future<void> theImageIsNotAddedToTheDocument(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
expect(sig.rect, isNull);
}

12
test/features/step/the_image_scales_proportionally.dart
View File

@ -1,12 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the image scales proportionally
Future<void> theImageScalesProportionally(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
final aspect = sig.rect!.width / sig.rect!.height;
expect((aspect - (TestWorld.prevAspect ?? aspect)).abs() < 0.05, isTrue);
}

7
test/features/step/the_other_signature_placements_remain_unchanged.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the other signature placements remain unchanged
Future<void> theOtherSignaturePlacementsRemainUnchanged(
WidgetTester tester) async {
throw UnimplementedError();
}

12
test/features/step/the_other_signatures_remain_unchanged.dart
View File

@ -1,12 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the other signatures remain unchanged
Future<void> theOtherSignaturesRemainUnchanged(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final list = container.read(pdfProvider.notifier).placementsOn(1);
// After deleting index 1, two should remain
expect(list.length, 2);
}

15
test/features/step/the_signature_is_stamped_at_the_exact_pdf_page_coordinates_and_size.dart
View File

@ -1,15 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the signature is stamped at the exact PDF page coordinates and size
Future<void> theSignatureIsStampedAtTheExactPdfPageCoordinatesAndSize(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
expect(sig.rect, isNotNull);
expect(sig.rect!.width, greaterThan(0));
expect(sig.rect!.height, greaterThan(0));
}

12
test/features/step/the_signature_on_page_remains.dart
View File

@ -1,12 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the signature on page {2} remains
Future<void> theSignatureOnPageRemains(WidgetTester tester, num page) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final list = container.read(pdfProvider.notifier).placementsOn(page.toInt());
expect(list, isNotEmpty);
}

7
test/features/step/the_signature_placement_is_stamped_at_the_exact_pdf_page_coordinates_and_size.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the signature placement is stamped at the exact PDF page coordinates and size
Future<void> theSignaturePlacementIsStampedAtTheExactPdfPageCoordinatesAndSize(
WidgetTester tester) async {
throw UnimplementedError();
}

16
test/features/step/the_signature_placement_on_page_is_shown_on_page.dart Normal file
View File

@ -0,0 +1,16 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the signature placement on page {5} is shown on page {5}
Future<void> theSignaturePlacementOnPageIsShownOnPage(
WidgetTester tester,
num param1,
num param2,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final page = param1.toInt();
expect(pdf.placementsByPage[page], isNotEmpty);
}

15
test/features/step/the_signature_placement_on_page_remains.dart Normal file
View File

@ -0,0 +1,15 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the signature placement on page {2} remains
Future<void> theSignaturePlacementOnPageRemains(
WidgetTester tester,
num param1,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final page = param1.toInt();
expect(pdf.placementsByPage[page], isNotEmpty);
}

7
test/features/step/the_signature_placement_remains_within_the_page_area.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the signature placement remains within the page area
Future<void> theSignaturePlacementRemainsWithinThePageArea(
WidgetTester tester) async {
throw UnimplementedError();
}

7
test/features/step/the_signature_placement_rotates_around_its_center_in_real_time.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the signature placement rotates around its center in real time
Future<void> theSignaturePlacementRotatesAroundItsCenterInRealTime(
WidgetTester tester) async {
throw UnimplementedError();
}

7
test/features/step/the_signature_placements_appear_on_the_corresponding_page_in_the_output.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the signature placements appear on the corresponding page in the output
Future<void> theSignaturePlacementsAppearOnTheCorrespondingPageInTheOutput(
WidgetTester tester) async {
throw UnimplementedError();
}

14
test/features/step/the_signature_remains_within_the_page_area.dart
View File

@ -1,14 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the signature remains within the page area
Future<void> theSignatureRemainsWithinThePageArea(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
final r = sig.rect!;
expect(r.left >= 0 && r.top >= 0, isTrue);
expect(r.right <= SignatureController.pageSize.width, isTrue);
expect(r.bottom <= SignatureController.pageSize.height, isTrue);
}

17
test/features/step/the_signatures_appear_on_the_corresponding_page_in_the_output.dart
View File

@ -1,17 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the signatures appear on the corresponding page in the output
Future<void> theSignaturesAppearOnTheCorrespondingPageInTheOutput(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(pdfProvider);
final sig = container.read(signatureProvider);
expect(pdf.signedPage, isNotNull);
expect(sig.rect, isNotNull);
expect(sig.imageBytes, isNotNull);
}

7
test/features/step/the_user_chooses_a_image_file_as_a_signature_asset.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the user chooses a image file as a signature asset
Future<void> theUserChoosesAImageFileAsASignatureAsset(
WidgetTester tester) async {
throw UnimplementedError();
}

7
test/features/step/the_user_chooses_a_signature_asset_to_created_a_signature_card.dart Normal file
View File

@ -0,0 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the user chooses a signature asset to created a signature card
Future<void> theUserChoosesASignatureAssetToCreatedASignatureCard(
WidgetTester tester) async {
throw UnimplementedError();
}

82
test/features/step/the_user_chooses_a_signature_image_file.dart
View File

@ -1,82 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the user chooses a signature image file
Future<void> theUserChoosesASignatureImageFile(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Simulate loading a tiny valid PNG/JPEG bytes; using 1x1 transparent PNG
final bytes = Uint8List.fromList([
0x89,
0x50,
0x4E,
0x47,
0x0D,
0x0A,
0x1A,
0x0A,
0x00,
0x00,
0x00,
0x0D,
0x49,
0x48,
0x44,
0x52,
0x00,
0x00,
0x00,
0x01,
0x00,
0x00,
0x00,
0x01,
0x08,
0x06,
0x00,
0x00,
0x00,
0x1F,
0x15,
0xC4,
0x89,
0x00,
0x00,
0x00,
0x0A,
0x49,
0x44,
0x41,
0x54,
0x78,
0x9C,
0x63,
0x00,
0x01,
0x00,
0x00,
0x05,
0x00,
0x01,
0x0D,
0x0A,
0x2D,
0xB4,
0x00,
0x00,
0x00,
0x00,
0x49,
0x45,
0x4E,
0x44,
0xAE,
0x42,
0x60,
0x82,
]);
container.read(signatureProvider.notifier).setImageBytes(bytes);
}

11
test/features/step/the_user_deletes_one_selected_signature.dart
View File

@ -1,11 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user deletes one selected signature
Future<void> theUserDeletesOneSelectedSignature(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
// Remove the middle one (index 1)
container.read(pdfProvider.notifier).removePlacement(page: 1, index: 1);
}

17
test/features/step/the_user_deletes_one_selected_signature_placement.dart Normal file
View File

@ -0,0 +1,17 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user deletes one selected signature placement
Future<void> theUserDeletesOneSelectedSignaturePlacement(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final pdf = container.read(pdfProvider);
if (pdf.selectedPlacementIndex == null) {
container.read(pdfProvider.notifier).selectPlacement(0);
}
container.read(pdfProvider.notifier).deleteSelectedPlacement();
}

37
test/features/step/the_user_drags_it_on_the_page_of_the_document_to_place_signature_placements_in_multiple_locations_in_the_document.dart Normal file
View File

@ -0,0 +1,37 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_library.dart';
import '_world.dart';
/// Usage: the user drags it on the page of the document to place signature placements in multiple locations in the document
Future<void>
theUserDragsItOnThePageOfTheDocumentToPlaceSignaturePlacementsInMultipleLocationsInTheDocument(
WidgetTester tester,
) async {
final container = TestWorld.container!;
final lib = container.read(signatureLibraryProvider);
final assetId = lib.isNotEmpty ? lib.first.id : 'shared.png';
container
.read(pdfProvider.notifier)
.addPlacement(
page: 1,
rect: Rect.fromLTWH(10, 10, 100, 50),
assetId: assetId,
);
container
.read(pdfProvider.notifier)
.addPlacement(
page: 2,
rect: Rect.fromLTWH(20, 20, 100, 50),
assetId: assetId,
);
container
.read(pdfProvider.notifier)
.addPlacement(
page: 3,
rect: Rect.fromLTWH(30, 30, 100, 50),
assetId: assetId,
);
}

8
test/features/step/the_user_drags_this_signature_card_on_the_page_of_the_document_to_place_a_signature_placement.dart Normal file
View File

@ -0,0 +1,8 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the user drags this signature card on the page of the document to place a signature placement
Future<void>
theUserDragsThisSignatureCardOnThePageOfTheDocumentToPlaceASignaturePlacement(
WidgetTester tester) async {
throw UnimplementedError();
}

16
test/features/step/the_user_enables_aspect_ratio_lock_and_resizes.dart
View File

@ -1,16 +0,0 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import '_world.dart';
/// Usage: the user enables aspect ratio lock and resizes
Future<void> theUserEnablesAspectRatioLockAndResizes(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final sigN = container.read(signatureProvider.notifier);
final sig = container.read(signatureProvider);
TestWorld.prevAspect = sig.rect!.width / sig.rect!.height;
sigN.toggleAspect(true);
sigN.resize(const Offset(100, 50));
}

35
test/features/step/the_user_navigates_to_page_and_places_another_signature.dart
View File

@ -1,35 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user navigates to page {3} and places another signature
Future<void> theUserNavigatesToPageAndPlacesAnotherSignature(
WidgetTester tester,
num page,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Ensure doc open
final pdf = container.read(pdfProvider);
if (!pdf.loaded) {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 6);
}
container.read(pdfProvider.notifier).jumpTo(page.toInt());
// Ensure an image is loaded
if (container.read(signatureProvider).imageBytes == null) {
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
}
container.read(signatureProvider.notifier).placeDefaultRect();
final Rect r = container.read(signatureProvider).rect!;
container
.read(pdfProvider.notifier)
.addPlacement(page: page.toInt(), rect: r, imageId: 'default.png');
}

23
test/features/step/the_user_navigates_to_page_and_places_another_signature_placement.dart Normal file
View File

@ -0,0 +1,23 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user navigates to page {5} and places another signature placement
Future<void> theUserNavigatesToPageAndPlacesAnotherSignaturePlacement(
WidgetTester tester,
num param1,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final page = param1.toInt();
container.read(pdfProvider.notifier).jumpTo(page);
container
.read(pdfProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(40, 40, 100, 50),
assetId: 'another.png',
);
}

58
test/features/step/the_user_places_a_signature_from_picture_on_page.dart
View File

@ -1,58 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user places a signature from picture <second_image> on page <second_page>
Future<void> theUserPlacesASignatureFromPictureOnPage(
WidgetTester tester, [
dynamic imageName,
dynamic pageNumber,
]) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Ensure a document is open
final pdf = container.read(pdfProvider);
if (!pdf.loaded) {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 6);
}
// Load image bytes based on provided name
if (imageName == null) {
// Alternate between alice/bob for the first two calls to match Examples
final idx = TestWorld.placeFromPictureCallCount++;
imageName = (idx % 2 == 0) ? 'alice.png' : 'bob.png';
}
final String name =
imageName is String
? imageName
: (imageName?.toString() ?? 'default.png');
Uint8List bytes;
switch (name) {
case 'alice.png':
bytes = Uint8List.fromList([1, 2, 3]);
break;
case 'bob.png':
bytes = Uint8List.fromList([4, 5, 6]);
break;
default:
bytes = Uint8List.fromList([7, 8, 9]);
}
container.read(signatureProvider.notifier).setImageBytes(bytes);
// Place default rect and add placement on target page with image name
container.read(signatureProvider.notifier).placeDefaultRect();
final Rect r = container.read(signatureProvider).rect!;
final int page =
(pageNumber is num)
? pageNumber.toInt()
: int.tryParse(pageNumber?.toString() ?? '') ??
// Default pages for the two calls in the scenario: 1 then 3
((TestWorld.placeFromPictureCallCount <= 1) ? 1 : 3);
container
.read(pdfProvider.notifier)
.addPlacement(page: page, rect: r, imageId: name);
}

34
test/features/step/the_user_places_a_signature_on_page.dart
View File

@ -1,34 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter/material.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user places a signature on page {1}
Future<void> theUserPlacesASignatureOnPage(
WidgetTester tester,
num page,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Ensure doc open
final pdf = container.read(pdfProvider);
if (!pdf.loaded) {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 6);
}
// Ensure an image is loaded
if (container.read(signatureProvider).imageBytes == null) {
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
}
container.read(signatureProvider.notifier).placeDefaultRect();
final Rect r = container.read(signatureProvider).rect!;
container
.read(pdfProvider.notifier)
.addPlacement(page: page.toInt(), rect: r, imageId: 'default.png');
}

36
test/features/step/the_user_places_a_signature_placement_from_asset_on_page.dart Normal file
View File

@ -0,0 +1,36 @@
import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_library.dart';
import 'package:pdf_signature/data/model/model.dart';
import '_world.dart';
/// Usage: the user places a signature placement from asset <second_asset> on page <second_page>
Future<void> theUserPlacesASignaturePlacementFromAssetOnPage(
WidgetTester tester,
String assetName,
int page,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final library = container.read(signatureLibraryProvider);
var asset = library.where((a) => a.name == assetName).firstOrNull;
if (asset == null) {
// add dummy asset
final id = container
.read(signatureLibraryProvider.notifier)
.add(Uint8List(0), name: assetName);
asset = container
.read(signatureLibraryProvider)
.firstWhere((a) => a.id == id);
}
container
.read(pdfProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(10, 10, 50, 50),
assetId: asset.id,
);
}

22
test/features/step/the_user_places_a_signature_placement_on_page.dart Normal file
View File

@ -0,0 +1,22 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user places a signature placement on page {1}
Future<void> theUserPlacesASignaturePlacementOnPage(
WidgetTester tester,
num param1,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final page = param1.toInt();
container
.read(pdfProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(20, 20, 100, 50),
assetId: 'test.png',
);
}

29
test/features/step/the_user_places_two_signature_placements_on_the_same_page.dart Normal file
View File

@ -0,0 +1,29 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user places two signature placements on the same page
Future<void> theUserPlacesTwoSignaturePlacementsOnTheSamePage(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final pdf = container.read(pdfProvider);
final page = pdf.currentPage;
container
.read(pdfProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(10, 10, 100, 50),
assetId: 'sig1.png',
);
container
.read(pdfProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(120, 10, 100, 50),
assetId: 'sig2.png',
);
}

24
test/features/step/the_user_places_two_signatures_on_the_same_page.dart
View File

@ -1,24 +0,0 @@
import 'dart:typed_data';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import '_world.dart';
/// Usage: the user places two signatures on the same page
Future<void> theUserPlacesTwoSignaturesOnTheSamePage(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));
// First
container.read(signatureProvider.notifier).placeDefaultRect();
final r1 = container.read(signatureProvider).rect!;
container.read(pdfProvider.notifier).addPlacement(page: 1, rect: r1);
// Second (offset a bit)
final r2 = r1.shift(const Offset(30, 30));
container.read(pdfProvider.notifier).addPlacement(page: 1, rect: r2);
}

19
test/features/step/the_user_savesexports_the_document.dart
View File

@ -15,9 +15,22 @@ Future<void> theUserSavesexportsTheDocument(WidgetTester tester) async {
final pdf = container.read(pdfProvider);
final sig = container.read(signatureProvider);
expect(pdf.loaded, isTrue, reason: 'PDF must be loaded before export');
expect(pdf.signedPage, isNotNull, reason: 'A signed page must be selected');
expect(sig.rect, isNotNull, reason: 'Signature rect must exist');
expect(sig.imageBytes, isNotNull, reason: 'Signature image must exist');
// Check if there are placements
final hasPlacements = pdf.placementsByPage.values.any(
(list) => list.isNotEmpty,
);
if (!hasPlacements) {
expect(
sig.rect,
isNotNull,
reason: 'Signature rect must exist if no placements',
);
expect(
sig.imageBytes,
isNotNull,
reason: 'Signature image must exist if no placements',
);
}
// Simulate output
TestWorld.lastExportBytes =

6
test/features/step/the_user_uses_rotate_controls.dart Normal file
View File

@ -0,0 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
/// Usage: the user uses rotate controls
Future<void> theUserUsesRotateControls(WidgetTester tester) async {
throw UnimplementedError();
}

40
test/features/step/three_signature_placements_are_placed_on_the_current_page.dart Normal file
View File

@ -0,0 +1,40 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_controller.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_library.dart';
import 'package:pdf_signature/ui/features/signature/view_model/signature_controller.dart';
import 'package:pdf_signature/data/model/model.dart';
import '_world.dart';
/// Usage: three signature placements are placed on the current page
Future<void> threeSignaturePlacementsArePlacedOnTheCurrentPage(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
container.read(signatureLibraryProvider.notifier).state = [];
container.read(pdfProvider.notifier).state = PdfState.initial();
container.read(signatureProvider.notifier).state = SignatureState.initial();
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
final pdfN = container.read(pdfProvider.notifier);
final pdf = container.read(pdfProvider);
final page = pdf.currentPage;
pdfN.addPlacement(
page: page,
rect: Rect.fromLTWH(10, 10, 50, 50),
assetId: 'test1',
);
pdfN.addPlacement(
page: page,
rect: Rect.fromLTWH(70, 10, 50, 50),
assetId: 'test2',
);
pdfN.addPlacement(
page: page,
rect: Rect.fromLTWH(130, 10, 50, 50),
assetId: 'test3',
);
}

3
test/widget/regression_signature_tests.dart
View File

@ -119,8 +119,9 @@ void main() {
final processed = container3.read(processedSignatureImageProvider);
expect(processed, isNotNull);
final pdf = container3.read(pdfProvider);
final imgId = pdf.placementsByPage[pdf.currentPage]?.first.imageId;
final imgId = pdf.placementsByPage[pdf.currentPage]?.first.assetId;
expect(imgId, isNotNull);
expect(imgId, isNotEmpty);
final lib = container3.read(signatureLibraryProvider);
final match = lib.firstWhere((a) => a.id == imgId);
expect(match.bytes, equals(processed));