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

feat: remove button `btn_mark_signing`

This commit is contained in:
insleker 2025-08-29 21:03:01 +08:00
parent cded635f02
commit a53e881d7b
31 changed files with 374 additions and 438 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -5,7 +5,6 @@ class PdfState {
final bool loaded;
final int pageCount;
final int currentPage;
final bool markedForSigning;
final String? pickedPdfPath;
final Uint8List? pickedPdfBytes;
final int? signedPage;
@ -13,7 +12,6 @@ class PdfState {
required this.loaded,
required this.pageCount,
required this.currentPage,
required this.markedForSigning,
this.pickedPdfPath,
this.pickedPdfBytes,
this.signedPage,
@ -22,7 +20,6 @@ class PdfState {
loaded: false,
pageCount: 0,
currentPage: 1,
markedForSigning: false,
pickedPdfBytes: null,
signedPage: null,
);
@ -30,7 +27,6 @@ class PdfState {
bool? loaded,
int? pageCount,
int? currentPage,
bool? markedForSigning,
String? pickedPdfPath,
Uint8List? pickedPdfBytes,
int? signedPage,
@ -38,7 +34,6 @@ class PdfState {
loaded: loaded ?? this.loaded,
pageCount: pageCount ?? this.pageCount,
currentPage: currentPage ?? this.currentPage,
markedForSigning: markedForSigning ?? this.markedForSigning,
pickedPdfPath: pickedPdfPath ?? this.pickedPdfPath,
pickedPdfBytes: pickedPdfBytes ?? this.pickedPdfBytes,
signedPage: signedPage ?? this.signedPage,

2
lib/l10n/app_en.arb
View File

@ -31,8 +31,6 @@
},
"goTo": "Go to:",
"dpi": "DPI:",
"markForSigning": "Mark for Signing",
"unmarkSigning": "Unmark Signing",
"saveSignedPdf": "Save Signed PDF",
"loadSignatureFromFile": "Load Signature from file",
"drawSignature": "Draw Signature",

2
lib/l10n/app_es.arb
View File

@ -20,8 +20,6 @@
"pageInfo": "Página {current}/{total}",
"goTo": "Ir a:",
"dpi": "DPI:",
"markForSigning": "Marcar para firmar",
"unmarkSigning": "Quitar marca",
"saveSignedPdf": "Guardar PDF firmado",
"loadSignatureFromFile": "Cargar firma desde archivo",
"drawSignature": "Dibujar firma",

12
lib/l10n/app_localizations.dart
View File

@ -209,18 +209,6 @@ abstract class AppLocalizations {
/// **'DPI:'**
String get dpi;
/// No description provided for @markForSigning.
///
/// In en, this message translates to:
/// **'Mark for Signing'**
String get markForSigning;
/// No description provided for @unmarkSigning.
///
/// In en, this message translates to:
/// **'Unmark Signing'**
String get unmarkSigning;
/// No description provided for @saveSignedPdf.
///
/// In en, this message translates to:

6
lib/l10n/app_localizations_en.dart
View File

@ -66,12 +66,6 @@ class AppLocalizationsEn extends AppLocalizations {
@override
String get dpi => 'DPI:';
@override
String get markForSigning => 'Mark for Signing';
@override
String get unmarkSigning => 'Unmark Signing';
@override
String get saveSignedPdf => 'Save Signed PDF';

6
lib/l10n/app_localizations_es.dart
View File

@ -66,12 +66,6 @@ class AppLocalizationsEs extends AppLocalizations {
@override
String get dpi => 'DPI:';
@override
String get markForSigning => 'Marcar para firmar';
@override
String get unmarkSigning => 'Quitar marca';
@override
String get saveSignedPdf => 'Guardar PDF firmado';

12
lib/l10n/app_localizations_zh.dart
View File

@ -66,12 +66,6 @@ class AppLocalizationsZh extends AppLocalizations {
@override
String get dpi => 'DPI：';
@override
String get markForSigning => '標記簽署';
@override
String get unmarkSigning => '取消標記';
@override
String get saveSignedPdf => '儲存已簽名 PDF';
@ -194,12 +188,6 @@ class AppLocalizationsZhTw extends AppLocalizationsZh {
@override
String get dpi => 'DPI：';
@override
String get markForSigning => '標記簽署';
@override
String get unmarkSigning => '取消標記';
@override
String get saveSignedPdf => '儲存已簽名 PDF';

2
lib/l10n/app_zh.arb
View File

@ -20,8 +20,6 @@
"pageInfo": "第 {current}/{total} 頁",
"goTo": "前往：",
"dpi": "DPI：",
"markForSigning": "標記簽署",
"unmarkSigning": "取消標記",
"saveSignedPdf": "儲存已簽名 PDF",
"loadSignatureFromFile": "從檔案載入簽名",
"drawSignature": "手寫簽名",

2
lib/l10n/app_zh_TW.arb
View File

@ -20,8 +20,6 @@
"pageInfo": "第 {current}/{total} 頁",
"goTo": "前往：",
"dpi": "DPI：",
"markForSigning": "標記簽署",
"unmarkSigning": "取消標記",
"saveSignedPdf": "儲存已簽名 PDF",
"loadSignatureFromFile": "從檔案載入簽名",
"drawSignature": "手寫簽名",

15
lib/ui/features/pdf/view_model/view_model.dart
View File

@ -16,7 +16,6 @@ class PdfController extends StateNotifier<PdfState> {
loaded: true,
pageCount: samplePageCount,
currentPage: 1,
markedForSigning: false,
pickedPdfPath: null,
signedPage: null,
);
@ -31,7 +30,6 @@ class PdfController extends StateNotifier<PdfState> {
loaded: true,
pageCount: pageCount,
currentPage: 1,
markedForSigning: false,
pickedPdfPath: path,
pickedPdfBytes: bytes,
signedPage: null,
@ -44,15 +42,14 @@ class PdfController extends StateNotifier<PdfState> {
state = state.copyWith(currentPage: clamped);
}
void toggleMark() {
// Set or clear the page that will receive the signature overlay.
void setSignedPage(int? page) {
if (!state.loaded) return;
if (state.signedPage != null) {
state = state.copyWith(markedForSigning: false, signedPage: null);
if (page == null) {
state = state.copyWith(signedPage: null);
} else {
state = state.copyWith(
markedForSigning: true,
signedPage: state.currentPage,
);
final clamped = page.clamp(1, state.pageCount);
state = state.copyWith(signedPage: clamped);
}
}

49
lib/ui/features/pdf/widgets/pdf_screen.dart
View File

@ -51,13 +51,9 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
ref.read(pdfProvider.notifier).jumpTo(page);
}
void _toggleMarkForSigning() {
ref.read(pdfProvider.notifier).toggleMark();
}
// mark-for-signing removed; no toggle needed
Future<void> _loadSignatureFromFile() async {
final pdf = ref.read(pdfProvider);
if (!pdf.markedForSigning) return;
final typeGroup = const fs.XTypeGroup(
label: 'Image',
extensions: ['png', 'jpg', 'jpeg', 'webp'],
@ -67,6 +63,11 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
final bytes = await file.readAsBytes();
final sig = ref.read(signatureProvider.notifier);
sig.setImageBytes(bytes);
// When a signature is added, set the current page as signed.
final p = ref.read(pdfProvider);
if (p.loaded) {
ref.read(pdfProvider.notifier).setSignedPage(p.currentPage);
}
}
void _onDragSignature(Offset delta) {
@ -78,8 +79,6 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
}
Future<void> _openDrawCanvas() async {
final pdf = ref.read(pdfProvider);
if (!pdf.markedForSigning) return;
final result = await showModalBottomSheet<Uint8List>(
context: context,
isScrollControlled: true,
@ -89,6 +88,11 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
if (result != null && result.isNotEmpty) {
// Use the drawn image as signature content
ref.read(signatureProvider.notifier).setImageBytes(result);
// Mark current page as signed when a signature is created
final p = ref.read(pdfProvider);
if (p.loaded) {
ref.read(pdfProvider.notifier).setSignedPage(p.currentPage);
}
}
}
@ -386,31 +390,24 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
),
],
),
ElevatedButton(
key: const Key('btn_mark_signing'),
onPressed: disabled ? null : _toggleMarkForSigning,
child: Text(
pdf.markedForSigning ? l.unmarkSigning : l.markForSigning,
),
),
// Removed: Mark for signing button
if (pdf.loaded)
ElevatedButton(
key: const Key('btn_save_pdf'),
onPressed: disabled ? null : _saveSignedPdf,
child: Text(l.saveSignedPdf),
),
if (pdf.markedForSigning) ...[
OutlinedButton(
key: const Key('btn_load_signature_picker'),
onPressed: disabled ? null : _loadSignatureFromFile,
child: Text(l.loadSignatureFromFile),
),
ElevatedButton(
key: const Key('btn_draw_signature'),
onPressed: disabled ? null : _openDrawCanvas,
child: Text(l.drawSignature),
),
],
// Signature tools are available when a PDF is loaded
OutlinedButton(
key: const Key('btn_load_signature_picker'),
onPressed: disabled || !pdf.loaded ? null : _loadSignatureFromFile,
child: Text(l.loadSignatureFromFile),
),
ElevatedButton(
key: const Key('btn_draw_signature'),
onPressed: disabled || !pdf.loaded ? null : _openDrawCanvas,
child: Text(l.drawSignature),
),
],
],
);

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

@ -6,6 +6,14 @@ class _Token {
String get jpeg => '$base.jpeg';
String get webp => '$base.webp';
String get bmp => '$base.bmp';
// Allow combining tokens with a dash, e.g., zh - TW -> 'zh-TW'
_Token operator -(Object other) {
if (other is _Token) {
return _Token('$base-${other.base}');
}
return _Token(base);
}
@override
String toString() => base;
}
@ -14,3 +22,14 @@ class _Token {
const corrupted = _Token('corrupted');
const signature = _Token('signature');
const empty = _Token('empty');
// Preferences & i18n tokens used by generated tests
const light = _Token('light');
const dark = _Token('dark');
const system = _Token('system');
const en = _Token('en');
const es = _Token('es');
const zh = _Token('zh');
const TW = _Token('TW');
const theme = _Token('theme');
const language = _Token('language');

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

@ -17,7 +17,7 @@ Future<void> aPdfIsOpenAndContainsAtLeastOnePlacedSignature(
pageCount: 2,
bytes: Uint8List.fromList([1, 2, 3]),
);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
container.read(signatureProvider.notifier).placeDefaultRect();
container
.read(signatureProvider.notifier)

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

@ -10,5 +10,5 @@ Future<void> aPdfPageIsSelectedForSigning(WidgetTester tester) async {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 1);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
}

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

@ -11,7 +11,7 @@ Future<void> aSignatureImageIsPlacedOnThePage(WidgetTester tester) async {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
// Set an image to ensure rect exists
container
.read(signatureProvider.notifier)

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

@ -11,7 +11,7 @@ Future<void> aSignatureImageIsSelected(WidgetTester tester) async {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 2);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
container
.read(signatureProvider.notifier)
.setImageBytes(Uint8List.fromList([1, 2, 3]));

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

@ -18,7 +18,7 @@ Future<void> aSignatureIsPlacedWithAPositionAndSizeRelativeToThePage(
pageCount: 2,
bytes: Uint8List.fromList([1, 2, 3]),
);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
final r = Rect.fromLTWH(50, 100, 120, 60);
final sigN = container.read(signatureProvider.notifier);
sigN.placeDefaultRect();

5
test/features/step/i_toggle_mark.dart
View File

@ -1,9 +1,8 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/view_model.dart';
import '_world.dart';
/// Usage: I toggle mark
Future<void> iToggleMark(WidgetTester tester) async {
final c = TestWorld.container!;
c.read(pdfProvider.notifier).toggleMark();
// Feature removed; no-op for backward-compatible tests
TestWorld.container; // keep reference to avoid unused warnings
}

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

@ -1,9 +1,7 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/view_model.dart';
import '_world.dart';
/// Usage: pdf marked for signing is {false}
Future<void> pdfMarkedForSigningIs(WidgetTester tester, bool expected) async {
final c = TestWorld.container!;
expect(c.read(pdfProvider).markedForSigning, expected);
// Feature removed; assert expectation is false for backward compatibility
expect(expected, false);
}

8
test/features/step/the_app_language_is.dart
View File

@ -4,10 +4,10 @@ import '_world.dart';
/// Usage: the app language is {"<language>"}
Future<void> theAppLanguageIs(
WidgetTester tester,
String param1,
dynamic language,
String languageWrapped,
) async {
final lang = language.toString();
expect(param1, '{${lang}}');
String unwrap(String s) =>
s.startsWith('{') && s.endsWith('}') ? s.substring(1, s.length - 1) : s;
final lang = unwrap(languageWrapped);
expect(TestWorld.currentLanguage, lang);
}

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

@ -2,13 +2,10 @@ import 'package:flutter_test/flutter_test.dart';
import '_world.dart';
/// Usage: the app UI theme is {"<theme>"}
Future<void> theAppUiThemeIs(
WidgetTester tester,
String param1,
dynamic theme,
) async {
final t = theme.toString();
expect(param1, '{${t}}');
Future<void> theAppUiThemeIs(WidgetTester tester, String themeWrapped) async {
String unwrap(String s) =>
s.startsWith('{') && s.endsWith('}') ? s.substring(1, s.length - 1) : s;
final t = unwrap(themeWrapped);
if (t == 'system') {
// When checking for 'system', we validate that selectedTheme is system
expect(TestWorld.selectedTheme, 'system');

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

@ -4,14 +4,12 @@ import '_world.dart';
/// Usage: the preference {language} is saved as {"<language>"}
Future<void> thePreferenceIsSavedAs(
WidgetTester tester,
dynamic param1,
String param2,
dynamic _value,
dynamic keyToken,
String valueWrapped,
) async {
final key = param1.toString();
final expectedTokenWrapped = param2; // like "{light}"
final expectedValue = _value.toString();
// Check token string matches braces-syntax just for parity
expect(expectedTokenWrapped, '{${expectedValue}}');
expect(TestWorld.prefs[key], expectedValue);
String unwrap(String s) =>
s.startsWith('{') && s.endsWith('}') ? s.substring(1, s.length - 1) : s;
final key = keyToken.toString();
final expected = unwrap(valueWrapped);
expect(TestWorld.prefs[key], expected);
}

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

@ -4,15 +4,13 @@ import '_world.dart';
/// Usage: the user previously set theme {"<theme>"} and language {"<language>"}
Future<void> theUserPreviouslySetThemeAndLanguage(
WidgetTester tester,
String param1,
String param2,
dynamic theme,
dynamic language,
String themeWrapped,
String languageWrapped,
) async {
final t = theme.toString();
final lang = language.toString();
expect(param1, '{${t}}');
expect(param2, '{${lang}}');
String unwrap(String s) =>
s.startsWith('{') && s.endsWith('}') ? s.substring(1, s.length - 1) : s;
final t = unwrap(themeWrapped);
final lang = unwrap(languageWrapped);
// Simulate stored values
TestWorld.prefs['theme'] = t;
TestWorld.prefs['language'] = lang;

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

@ -13,7 +13,7 @@ Future<void> theUserSelects(WidgetTester tester, dynamic file) async {
container
.read(pdfProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 1);
container.read(pdfProvider.notifier).toggleMark();
container.read(pdfProvider.notifier).setSignedPage(1);
// For invalid/unsupported/empty selections we do NOT set image bytes.
// This simulates a failed load and keeps rect null.
final token = file.toString();

65
test/widget/draw_canvas_test.dart Normal file
View File

@ -0,0 +1,65 @@
import 'dart:typed_data';
import 'dart:ui' show PointerDeviceKind;
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:hand_signature/signature.dart' as hand;
import 'package:pdf_signature/ui/features/pdf/widgets/draw_canvas.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
void main() {
testWidgets('DrawCanvas exports non-empty bytes on confirm', (tester) async {
Uint8List? exported;
final sink = ValueNotifier<Uint8List?>(null);
final control = hand.HandSignatureControl();
await tester.pumpWidget(
MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: Scaffold(
body: DrawCanvas(
control: control,
debugBytesSink: sink,
onConfirm: (bytes) {
exported = bytes;
},
),
),
),
);
await tester.pumpAndSettle();
// Draw a simple stroke inside the pad
final pad = find.byKey(const Key('hand_signature_pad'));
expect(pad, findsOneWidget);
final rect = tester.getRect(pad);
final g = await tester.startGesture(
Offset(rect.left + 20, rect.center.dy),
kind: PointerDeviceKind.touch,
);
for (int i = 0; i < 10; i++) {
await g.moveBy(
const Offset(12, 0),
timeStamp: Duration(milliseconds: 16 * (i + 1)),
);
await tester.pump(const Duration(milliseconds: 16));
}
await g.up();
await tester.pump(const Duration(milliseconds: 50));
// Confirm export
await tester.tap(find.byKey(const Key('btn_canvas_confirm')));
// Wait until notifier receives bytes
await tester.pumpAndSettle(const Duration(milliseconds: 50));
await tester.runAsync(() async {
final end = DateTime.now().add(const Duration(seconds: 2));
while (sink.value == null && DateTime.now().isBefore(end)) {
await Future<void>.delayed(const Duration(milliseconds: 20));
}
});
exported ??= sink.value;
expect(exported, isNotNull);
expect(exported!.isNotEmpty, isTrue);
});
}

58
test/widget/export_flow_test.dart Normal file
View File

@ -0,0 +1,58 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/services/export_service.dart';
import 'package:pdf_signature/data/services/providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/view_model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
class RecordingExporter extends ExportService {
bool called = false;
@override
Future<bool> saveBytesToFile({required bytes, required outputPath}) async {
called = true;
return true;
}
}
class BasicExporter extends ExportService {}
void main() {
testWidgets('Save uses file selector (via provider) and injected exporter', (
tester,
) async {
final fake = RecordingExporter();
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
signatureProvider.overrideWith(
(ref) => SignatureController()..placeDefaultRect(),
),
useMockViewerProvider.overrideWith((ref) => true),
exportServiceProvider.overrideWith((_) => fake),
savePathPickerProvider.overrideWith(
(_) => () async => 'C:/tmp/output.pdf',
),
],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: PdfSignatureHomePage(),
),
),
);
await tester.pump();
// Trigger save directly (mark toggle no longer required)
await tester.tap(find.byKey(const Key('btn_save_pdf')));
await tester.pumpAndSettle();
// Expect success UI
expect(find.textContaining('Saved:'), findsOneWidget);
});
}

49
test/widget/helpers.dart Normal file
View File

@ -0,0 +1,49 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/view_model.dart';
import 'package:pdf_signature/data/services/providers.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
Future<void> pumpWithOpenPdf(WidgetTester tester) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
useMockViewerProvider.overrideWith((ref) => true),
],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: const PdfSignatureHomePage(),
),
),
);
await tester.pump();
}
Future<void> pumpWithOpenPdfAndSig(WidgetTester tester) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
signatureProvider.overrideWith(
(ref) => SignatureController()..placeDefaultRect(),
),
useMockViewerProvider.overrideWith((ref) => true),
],
child: MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
home: const PdfSignatureHomePage(),
),
),
);
await tester.pump();
}

32
test/widget/navigation_test.dart Normal file
View File

@ -0,0 +1,32 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'helpers.dart';
void main() {
testWidgets('Open a PDF and navigate pages', (tester) async {
await pumpWithOpenPdf(tester);
final pageInfo = find.byKey(const Key('lbl_page_info'));
expect(pageInfo, findsOneWidget);
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
await tester.tap(find.byKey(const Key('btn_next')));
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 2/5');
await tester.tap(find.byKey(const Key('btn_prev')));
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
});
testWidgets('Jump to a specific page', (tester) async {
await pumpWithOpenPdf(tester);
final goto = find.byKey(const Key('txt_goto'));
await tester.enterText(goto, '4');
await tester.testTextInput.receiveAction(TextInputAction.done);
await tester.pump();
final pageInfo = find.byKey(const Key('lbl_page_info'));
expect((tester.widget<Text>(pageInfo)).data, 'Page 4/5');
});
}

72
test/widget/signature_interaction_test.dart Normal file
View File

@ -0,0 +1,72 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'helpers.dart';
void main() {
testWidgets('Resize and move signature within page bounds', (tester) async {
await pumpWithOpenPdfAndSig(tester);
final overlay = find.byKey(const Key('signature_overlay'));
expect(overlay, findsOneWidget);
final posBefore = tester.getTopLeft(overlay);
// drag the overlay
await tester.drag(overlay, const Offset(30, -20));
await tester.pump();
final posAfter = tester.getTopLeft(overlay);
// Allow equality in case clamped at edges
expect(posAfter.dx >= posBefore.dx, isTrue);
expect(posAfter.dy <= posBefore.dy, isTrue);
// resize via handle
final handle = find.byKey(const Key('signature_handle'));
final sizeBefore = tester.getSize(overlay);
await tester.drag(handle, const Offset(40, 40));
await tester.pump();
final sizeAfter = tester.getSize(overlay);
expect(sizeAfter.width >= sizeBefore.width, isTrue);
expect(sizeAfter.height >= sizeBefore.height, isTrue);
});
testWidgets('Lock aspect ratio while resizing', (tester) async {
await pumpWithOpenPdfAndSig(tester);
final overlay = find.byKey(const Key('signature_overlay'));
final sizeBefore = tester.getSize(overlay);
final aspect = sizeBefore.width / sizeBefore.height;
await tester.tap(find.byKey(const Key('chk_aspect_lock')));
await tester.pump();
await tester.drag(
find.byKey(const Key('signature_handle')),
const Offset(60, 10),
);
await tester.pump();
final sizeAfter = tester.getSize(overlay);
final newAspect = (sizeAfter.width / sizeAfter.height);
expect((newAspect - aspect).abs() < 0.15, isTrue);
});
testWidgets('Background removal and adjustments controls change state', (
tester,
) async {
await pumpWithOpenPdfAndSig(tester);
// toggle bg removal
await tester.tap(find.byKey(const Key('swt_bg_removal')));
await tester.pump();
// move sliders
await tester.drag(
find.byKey(const Key('sld_contrast')),
const Offset(50, 0),
);
await tester.drag(
find.byKey(const Key('sld_brightness')),
const Offset(-50, 0),
);
await tester.pump();
// basic smoke: overlay still present
expect(find.byKey(const Key('signature_overlay')), findsOneWidget);
});
}

17
test/widget/validation_test.dart Normal file
View File

@ -0,0 +1,17 @@
import 'package:flutter_test/flutter_test.dart';
import 'helpers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
void main() {
testWidgets('Show invalid/unsupported file SnackBar via test hook', (
tester,
) async {
await pumpWithOpenPdf(tester);
final dynamic state =
tester.state(find.byType(PdfSignatureHomePage)) as dynamic;
state.debugShowInvalidSignatureSnackBar();
await tester.pump();
expect(find.text('Invalid or unsupported file'), findsOneWidget);
});
}

315
test/widget/widget_test.dart
View File

@ -1,313 +1,2 @@
// This is a basic Flutter widget test.
//
// To perform an interaction with a widget in your test, use the WidgetTester
// utility in the flutter_test package. 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 'package:flutter_riverpod/flutter_riverpod.dart';
import 'dart:typed_data';
import 'dart:ui' show PointerDeviceKind;
import 'package:pdf_signature/ui/features/pdf/view_model/view_model.dart';
import 'package:pdf_signature/data/services/providers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/draw_canvas.dart';
import 'package:pdf_signature/data/services/export_service.dart';
import 'package:hand_signature/signature.dart' as hand;
// Fakes for export service (top-level; Dart does not allow local class declarations)
class RecordingExporter extends ExportService {
bool called = false;
}
class BasicExporter extends ExportService {}
void main() {
Future<void> pumpWithOpenPdf(WidgetTester tester) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
useMockViewerProvider.overrideWith((ref) => true),
],
child: const MaterialApp(home: PdfSignatureHomePage()),
),
);
await tester.pump();
}
Future<void> pumpWithOpenPdfAndSig(WidgetTester tester) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
signatureProvider.overrideWith(
(ref) => SignatureController()..placeDefaultRect(),
),
useMockViewerProvider.overrideWith((ref) => true),
],
child: const MaterialApp(home: PdfSignatureHomePage()),
),
);
await tester.pump();
}
testWidgets('Open a PDF and navigate pages', (tester) async {
await pumpWithOpenPdf(tester);
final pageInfo = find.byKey(const Key('lbl_page_info'));
expect(pageInfo, findsOneWidget);
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
await tester.tap(find.byKey(const Key('btn_next')));
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 2/5');
await tester.tap(find.byKey(const Key('btn_prev')));
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
});
testWidgets('Jump to a specific page', (tester) async {
await pumpWithOpenPdf(tester);
final goto = find.byKey(const Key('txt_goto'));
await tester.enterText(goto, '4');
await tester.testTextInput.receiveAction(TextInputAction.done);
await tester.pump();
final pageInfo = find.byKey(const Key('lbl_page_info'));
expect((tester.widget<Text>(pageInfo)).data, 'Page 4/5');
});
testWidgets('Select a page for signing', (tester) async {
await pumpWithOpenPdf(tester);
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
// signature actions appear (picker-based now)
expect(find.byKey(const Key('btn_load_signature_picker')), findsOneWidget);
});
testWidgets('Show invalid/unsupported file SnackBar via test hook', (
tester,
) async {
await pumpWithOpenPdf(tester);
final dynamic state =
tester.state(find.byType(PdfSignatureHomePage)) as dynamic;
state.debugShowInvalidSignatureSnackBar();
await tester.pump();
expect(find.text('Invalid or unsupported file'), findsOneWidget);
});
testWidgets('Import a signature image', (tester) async {
await pumpWithOpenPdfAndSig(tester);
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
// overlay present from provider override
expect(find.byKey(const Key('signature_overlay')), findsOneWidget);
});
// Removed: Load Invalid button is not part of normal app UI.
testWidgets('Resize and move signature within page bounds', (tester) async {
await pumpWithOpenPdfAndSig(tester);
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
final overlay = find.byKey(const Key('signature_overlay'));
final posBefore = tester.getTopLeft(overlay);
// drag the overlay
await tester.drag(overlay, const Offset(30, -20));
await tester.pump();
final posAfter = tester.getTopLeft(overlay);
// Allow equality in case clamped at edges
expect(posAfter.dx >= posBefore.dx, isTrue);
expect(posAfter.dy <= posBefore.dy, isTrue);
// resize via handle
final handle = find.byKey(const Key('signature_handle'));
final sizeBefore = tester.getSize(overlay);
await tester.drag(handle, const Offset(40, 40));
await tester.pump();
final sizeAfter = tester.getSize(overlay);
expect(sizeAfter.width >= sizeBefore.width, isTrue);
expect(sizeAfter.height >= sizeBefore.height, isTrue);
});
testWidgets('Lock aspect ratio while resizing', (tester) async {
await pumpWithOpenPdfAndSig(tester);
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
final overlay = find.byKey(const Key('signature_overlay'));
final sizeBefore = tester.getSize(overlay);
final aspect = sizeBefore.width / sizeBefore.height;
await tester.tap(find.byKey(const Key('chk_aspect_lock')));
await tester.pump();
await tester.drag(
find.byKey(const Key('signature_handle')),
const Offset(60, 10),
);
await tester.pump();
final sizeAfter = tester.getSize(overlay);
final newAspect = (sizeAfter.width / sizeAfter.height);
expect(
(newAspect - aspect).abs() < 0.15,
isTrue,
); // approximately preserved
});
testWidgets('Background removal and adjustments controls change state', (
tester,
) async {
await pumpWithOpenPdfAndSig(tester);
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
// toggle bg removal
await tester.tap(find.byKey(const Key('swt_bg_removal')));
await tester.pump();
// move sliders
await tester.drag(
find.byKey(const Key('sld_contrast')),
const Offset(50, 0),
);
await tester.drag(
find.byKey(const Key('sld_brightness')),
const Offset(-50, 0),
);
await tester.pump();
// basic smoke: overlay still present
expect(find.byKey(const Key('signature_overlay')), findsOneWidget);
});
testWidgets('DrawCanvas exports non-empty bytes on confirm', (tester) async {
Uint8List? exported;
final sink = ValueNotifier<Uint8List?>(null);
final control = hand.HandSignatureControl();
await tester.pumpWidget(
MaterialApp(
home: Scaffold(
body: DrawCanvas(
control: control,
debugBytesSink: sink,
onConfirm: (bytes) {
exported = bytes;
},
),
),
),
);
await tester.pumpAndSettle();
// Draw a simple stroke inside the pad
final pad = find.byKey(const Key('hand_signature_pad'));
expect(pad, findsOneWidget);
final rect = tester.getRect(pad);
final g = await tester.startGesture(
Offset(rect.left + 20, rect.center.dy),
kind: PointerDeviceKind.touch,
);
for (int i = 0; i < 10; i++) {
await g.moveBy(
const Offset(12, 0),
timeStamp: Duration(milliseconds: 16 * (i + 1)),
);
await tester.pump(const Duration(milliseconds: 16));
}
await g.up();
await tester.pump(const Duration(milliseconds: 50));
// Confirm export
await tester.tap(find.byKey(const Key('btn_canvas_confirm')));
// Wait until notifier receives bytes
await tester.pumpAndSettle(const Duration(milliseconds: 50));
await tester.runAsync(() async {
final end = DateTime.now().add(const Duration(seconds: 2));
while (sink.value == null && DateTime.now().isBefore(end)) {
await Future<void>.delayed(const Duration(milliseconds: 20));
}
});
exported ??= sink.value;
expect(exported, isNotNull);
expect(exported!.isNotEmpty, isTrue);
});
testWidgets('Save uses file selector (via provider) and injected exporter', (
tester,
) async {
final fake = RecordingExporter();
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
signatureProvider.overrideWith(
(ref) => SignatureController()..placeDefaultRect(),
),
useMockViewerProvider.overrideWith((ref) => true),
exportServiceProvider.overrideWith((_) => fake),
savePathPickerProvider.overrideWith(
(_) => () async => 'C:/tmp/output.pdf',
),
],
child: const MaterialApp(home: PdfSignatureHomePage()),
),
);
await tester.pump();
// Mark signing to set signedPage
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
// Trigger save
await tester.tap(find.byKey(const Key('btn_save_pdf')));
await tester.pumpAndSettle();
// With refactor, we no longer call boundary-based export here; still expect success UI.
expect(find.textContaining('Saved:'), findsOneWidget);
});
testWidgets('Only signed page shows overlay during export flow', (
tester,
) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
pdfProvider.overrideWith(
(ref) => PdfController()..openPicked(path: 'test.pdf'),
),
signatureProvider.overrideWith(
(ref) => SignatureController()..placeDefaultRect(),
),
useMockViewerProvider.overrideWith((ref) => true),
exportServiceProvider.overrideWith((_) => BasicExporter()),
savePathPickerProvider.overrideWith(
(_) => () async => 'C:/tmp/output.pdf',
),
],
child: const MaterialApp(home: PdfSignatureHomePage()),
),
);
await tester.pump();
// Mark signing on page 1
await tester.tap(find.byKey(const Key('btn_mark_signing')));
await tester.pump();
// Save -> open dialog -> confirm
await tester.tap(find.byKey(const Key('btn_save_pdf')));
await tester.pumpAndSettle();
// After export, overlay visible again
expect(find.byKey(const Key('signature_overlay')), findsOneWidget);
});
}
// Split into multiple *_test.dart files. Intentionally left empty.
void main() {}