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

Compare commits

base: bkinnightskytw:c82bb7fa2a0a67ac822e3fbfd139a3aa3794ea9a
Branches Tags
bkinnightskytw:main
bkinnightskytw:feat/cross
bkinnightskytw:feat/mobile
bkinnightskytw:fix/chrome_save
bkinnightskytw:feat/ui
bkinnightskytw:v1.1.0
..
compare: bkinnightskytw:545d3ad6882487e448276802df00f4199bc772dc
Branches Tags
bkinnightskytw:feat/cross
bkinnightskytw:feat/mobile
bkinnightskytw:main
bkinnightskytw:fix/chrome_save
bkinnightskytw:feat/ui
bkinnightskytw:v1.1.0

No commits in common. "c82bb7fa2a0a67ac822e3fbfd139a3aa3794ea9a" and "545d3ad6882487e448276802df00f4199bc772dc" have entirely different histories.
c82bb7fa2a ... 545d3ad688

73 changed files with 350 additions and 1410 deletions
Show Stats Expand all files Collapse all files

14
build.yaml
View File

@ -1,18 +1,8 @@
targets:
$default:
sources:
- integration_test/** # By default, build runner will not generate code in the integration folder
- test/** # so we override paths for code generation here
- integration_test/**
- test/**
- lib/**
- $package$
builders:
bdd_widget_test|featureBuilder:
generate_for:
- test/**
- integration_test/**
freezed:
generate_for:
- lib/**
json_serializable:
generate_for:
- lib/**

204
integration_test/export_flow_test.dart
View File

@ -4,19 +4,14 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:image/image.dart' as img;
import 'dart:io';
import 'package:pdf_signature/data/services/export_service.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/ui_services.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pages_sidebar.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:pdf_signature/data/repositories/preferences_repository.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
@ -39,8 +34,6 @@ void main() {
final fake = RecordingExporter();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
// For this test, we don't need the PDF bytes since it's not loaded
await tester.pumpWidget(
ProviderScope(
overrides: [
@ -51,7 +44,7 @@ void main() {
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
pageCount: 5,
),
),
useMockViewerProvider.overrideWith((ref) => false),
@ -97,8 +90,6 @@ void main() {
tester,
) async {
final sigBytes = _makeSig();
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
@ -112,8 +103,7 @@ void main() {
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
pageCount: 5,
),
),
signatureAssetRepositoryProvider.overrideWith((ref) {
@ -121,12 +111,6 @@ void main() {
c.add(sigBytes, name: 'image');
return c;
}),
signatureCardRepositoryProvider.overrideWith((ref) {
final cardRepo = SignatureCardStateNotifier();
final asset = SignatureAsset(bytes: sigBytes, name: 'image');
cardRepo.addWithAsset(asset, 0.0);
return cardRepo;
}),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
@ -155,10 +139,10 @@ void main() {
final r = container.read(activeRectProvider)!;
final lib = container.read(signatureAssetRepositoryProvider);
final asset = lib.isNotEmpty ? lib.first : null;
final currentPage = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(page: currentPage, rect: r, asset: asset);
.addPlacement(page: pdf.currentPage, rect: r, asset: asset);
// Clear active overlay by hiding signatures temporarily
container.read(signatureVisibilityProvider.notifier).state = false;
await tester.pump();
@ -178,182 +162,4 @@ void main() {
isTrue,
);
});
// ---- PDF view interaction tests (merged from pdf_view_test.dart) ----
testWidgets('PDF View: programmatic page jumps reach last page', (
tester,
) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
expect(container.read(pdfViewModelProvider), 1);
container.read(pdfViewModelProvider.notifier).jumpToPage(2);
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 2);
container.read(pdfViewModelProvider.notifier).jumpToPage(3);
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 3);
});
testWidgets('PDF View: zoom in/out', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final pdfViewer = find.byKey(const ValueKey('pdf_page_area'));
expect(pdfViewer, findsOneWidget);
final center = tester.getCenter(pdfViewer);
final g1 = await tester.createGesture();
final g2 = await tester.createGesture();
await g1.down(center - const Offset(10, 0));
await g2.down(center + const Offset(10, 0));
await g1.moveTo(center - const Offset(20, 0));
await g2.moveTo(center + const Offset(20, 0));
await g1.up();
await g2.up();
await tester.pumpAndSettle();
expect(pdfViewer, findsOneWidget);
});
testWidgets('PDF View: jump to page by clicking thumbnail', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
expect(container.read(pdfViewModelProvider), 1);
final page3Thumb = find.text('3');
expect(page3Thumb, findsOneWidget);
await tester.tap(page3Thumb);
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 3);
});
testWidgets('PDF View: thumbnails scroll and select', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
expect(container.read(pdfViewModelProvider), 1);
final sidebar = find.byType(PagesSidebar);
expect(sidebar, findsOneWidget);
await tester.drag(sidebar, const Offset(0, -200));
await tester.pumpAndSettle();
expect(find.text('1'), findsOneWidget);
expect(container.read(pdfViewModelProvider), 1);
await tester.tap(find.text('2'));
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 2);
});
}

221
integration_test/pdf_view_test.dart
View File

@ -1,221 +0,0 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'dart:io';
import 'package:flutter/services.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_screen.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pages_sidebar.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:pdf_signature/data/repositories/preferences_repository.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
/// It has known that sample-local-pdf.pdf has 3 pages.
void main() {
IntegrationTestWidgetsFlutterBinding.ensureInitialized();
testWidgets('PDF View: programmatic page jumps reach last page', (
tester,
) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
// Extra settle to avoid startup race when running with other integration tests.
await tester.pump(const Duration(milliseconds: 200));
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
final vm = container.read(pdfViewModelProvider);
expect(vm, 1);
container.read(pdfViewModelProvider.notifier).jumpToPage(2);
await tester.pumpAndSettle();
await tester.pump(const Duration(milliseconds: 120));
expect(container.read(pdfViewModelProvider), 2);
container.read(pdfViewModelProvider.notifier).jumpToPage(3);
await tester.pumpAndSettle();
await tester.pump(const Duration(milliseconds: 120));
expect(container.read(pdfViewModelProvider), 3);
});
testWidgets('PDF View: zoom in/out', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
await tester.pump(const Duration(milliseconds: 120));
final pdfViewer = find.byKey(const ValueKey('pdf_page_area'));
expect(pdfViewer, findsOneWidget);
final center = tester.getCenter(pdfViewer);
final gesture1 = await tester.createGesture();
final gesture2 = await tester.createGesture();
await gesture1.down(center - const Offset(10, 0));
await gesture2.down(center + const Offset(10, 0));
await gesture1.moveTo(center - const Offset(20, 0));
await gesture2.moveTo(center + const Offset(20, 0));
await gesture1.up();
await gesture2.up();
await tester.pumpAndSettle();
expect(pdfViewer, findsOneWidget);
});
testWidgets('PDF View: jump to page by clicking thumbnail', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
expect(container.read(pdfViewModelProvider), 1);
final page3Thumbnail = find.text('3');
expect(page3Thumbnail, findsOneWidget);
await tester.tap(page3Thumbnail);
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 3);
});
testWidgets('PDF View: thumbnails scroll and select', (tester) async {
final pdfBytes =
await File('integration_test/data/sample-local-pdf.pdf').readAsBytes();
SharedPreferences.setMockInitialValues({});
final prefs = await SharedPreferences.getInstance();
await tester.pumpWidget(
ProviderScope(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) =>
DocumentStateNotifier()..openPicked(
path: 'integration_test/data/sample-local-pdf.pdf',
pageCount: 3,
bytes: pdfBytes,
),
),
useMockViewerProvider.overrideWithValue(false),
],
child: const MaterialApp(
localizationsDelegates: AppLocalizations.localizationsDelegates,
supportedLocales: AppLocalizations.supportedLocales,
locale: Locale('en'),
home: PdfSignatureHomePage(),
),
),
);
await tester.pumpAndSettle();
final ctx = tester.element(find.byType(PdfSignatureHomePage));
final container = ProviderScope.containerOf(ctx);
expect(container.read(pdfViewModelProvider), 1);
final pagesSidebar = find.byType(PagesSidebar);
expect(pagesSidebar, findsOneWidget);
await tester.drag(pagesSidebar, const Offset(0, -200));
await tester.pumpAndSettle();
expect(find.text('1'), findsOneWidget);
expect(container.read(pdfViewModelProvider), 1);
// Select page 2 thumbnail and verify page changes
await tester.tap(find.text('2'));
await tester.pumpAndSettle();
expect(container.read(pdfViewModelProvider), 2);
});
}

94
lib/data/repositories/document_repository.dart
View File

@ -12,7 +12,12 @@ class DocumentStateNotifier extends StateNotifier<Document> {
@visibleForTesting
void openSample() {
state = state.copyWith(loaded: true, pageCount: 5, placementsByPage: {});
state = state.copyWith(
loaded: true,
pageCount: 5,
currentPage: 1,
placementsByPage: {},
);
}
void openPicked({
@ -23,20 +28,23 @@ class DocumentStateNotifier extends StateNotifier<Document> {
state = state.copyWith(
loaded: true,
pageCount: pageCount,
currentPage: 1,
pickedPdfBytes: bytes,
placementsByPage: {},
);
}
void jumpTo(int page) {
if (!state.loaded) return;
final clamped = page.clamp(1, state.pageCount);
state = state.copyWith(currentPage: clamped);
}
void setPageCount(int count) {
if (!state.loaded) return;
state = state.copyWith(pageCount: count.clamp(1, 9999));
}
void jumpTo(int page) {
// currentPage is now in view model, so jumpTo does nothing here
}
// Multiple-signature helpers (rects are stored in normalized fractions 0..1
// relative to the page size: left/top/width/height are all 0..1)
void addPlacement({
@ -44,7 +52,6 @@ class DocumentStateNotifier extends StateNotifier<Document> {
required Rect rect,
SignatureAsset? asset,
double rotationDeg = 0.0,
GraphicAdjust? graphicAdjust,
}) {
if (!state.loaded) return;
final p = page.clamp(1, state.pageCount);
@ -53,87 +60,14 @@ class DocumentStateNotifier extends StateNotifier<Document> {
list.add(
SignaturePlacement(
rect: rect,
asset: asset ?? SignatureAsset(bytes: _singleTransparentPng),
asset: asset ?? SignatureAsset(bytes: Uint8List(0)),
rotationDeg: rotationDeg,
graphicAdjust: graphicAdjust ?? const GraphicAdjust(),
),
);
map[p] = list;
state = state.copyWith(placementsByPage: map);
}
// Tiny 1x1 transparent PNG to avoid decode crashes in tests when no real
// signature bytes were provided.
static final Uint8List _singleTransparentPng = 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,
0x60,
0x00,
0x00,
0x00,
0x02,
0x00,
0x01,
0xE5,
0x27,
0xD4,
0xA6,
0x00,
0x00,
0x00,
0x00,
0x49,
0x45,
0x4E,
0x44,
0xAE,
0x42,
0x60,
0x82,
]);
void updatePlacementRotation({
required int page,
required int index,

5
lib/domain/models/document.dart
View File

@ -5,29 +5,34 @@ import 'signature_placement.dart';
class Document {
final bool loaded;
final int pageCount;
final int currentPage;
final Uint8List? pickedPdfBytes;
// Multiple signature placements per page, each combines geometry and asset.
final Map<int, List<SignaturePlacement>> placementsByPage;
const Document({
required this.loaded,
required this.pageCount,
required this.currentPage,
this.pickedPdfBytes,
this.placementsByPage = const {},
});
factory Document.initial() => const Document(
loaded: false,
pageCount: 0,
currentPage: 1,
pickedPdfBytes: null,
placementsByPage: {},
);
Document copyWith({
bool? loaded,
int? pageCount,
int? currentPage,
Uint8List? pickedPdfBytes,
Map<int, List<SignaturePlacement>>? placementsByPage,
}) => Document(
loaded: loaded ?? this.loaded,
pageCount: pageCount ?? this.pageCount,
currentPage: currentPage ?? this.currentPage,
pickedPdfBytes: pickedPdfBytes ?? this.pickedPdfBytes,
placementsByPage: placementsByPage ?? this.placementsByPage,
);

9
lib/ui/features/pdf/view_model/pdf_view_model.dart
View File

@ -6,15 +6,15 @@ import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdfrx/pdfrx.dart';
class PdfViewModel extends StateNotifier<int> {
class PdfViewModel {
final Ref ref;
PdfViewModel(this.ref) : super(1);
PdfViewModel(this.ref);
Document get document => ref.read(documentRepositoryProvider);
void jumpToPage(int page) {
state = page.clamp(1, document.pageCount);
ref.read(documentRepositoryProvider.notifier).jumpTo(page);
}
Future<void> openPdf({required String path, Uint8List? bytes}) async {
@ -31,7 +31,6 @@ class PdfViewModel extends StateNotifier<int> {
.read(documentRepositoryProvider.notifier)
.openPicked(path: path, pageCount: pageCount, bytes: bytes);
ref.read(signatureCardRepositoryProvider.notifier).clearAll();
state = 1; // Reset current page to 1
}
Future<Uint8List?> loadSignatureFromFile() async {
@ -61,6 +60,6 @@ class PdfViewModel extends StateNotifier<int> {
}
}
final pdfViewModelProvider = StateNotifierProvider<PdfViewModel, int>((ref) {
final pdfViewModelProvider = Provider<PdfViewModel>((ref) {
return PdfViewModel(ref);
});

12
lib/ui/features/pdf/widgets/draw_canvas.dart
View File

@ -47,10 +47,16 @@ class _DrawCanvasState extends State<DrawCanvas> {
children: [
ElevatedButton(
key: const Key('btn_canvas_confirm'),
onPressed: () {
onPressed: () async {
// Export signature to PNG bytes
// In test, use dummy bytes
final bytes = Uint8List.fromList([1, 2, 3]);
final data = await _control.toImage(
color: Colors.black,
background: Colors.transparent,
fit: true,
width: 1024,
height: 512,
);
final bytes = data?.buffer.asUint8List();
widget.debugBytesSink?.value = bytes;
if (widget.onConfirm != null) {
widget.onConfirm!(bytes);

75
lib/ui/features/pdf/widgets/pdf_mock_continuous_list.dart
View File

@ -59,6 +59,7 @@ class _PdfMockContinuousListState extends ConsumerState<PdfMockContinuousList> {
final clearPending = widget.clearPending;
final visible = ref.watch(signatureVisibilityProvider);
final assets = ref.watch(signatureAssetRepositoryProvider);
final aspectLocked = ref.watch(aspectLockedProvider);
if (pendingPage != null) {
WidgetsBinding.instance.addPostFrameCallback((_) {
final p = pendingPage;
@ -117,7 +118,6 @@ class _PdfMockContinuousListState extends ConsumerState<PdfMockContinuousList> {
rect: rect,
asset: dragData.card?.asset,
rotationDeg: dragData.card?.rotationDeg ?? 0.0,
graphicAdjust: dragData.card?.graphicAdjust,
);
}
},
@ -195,7 +195,35 @@ class _PdfMockContinuousListState extends ConsumerState<PdfMockContinuousList> {
height: height,
child: GestureDetector(
key: const Key('signature_overlay'),
// Removed onPanUpdate to allow scrolling
onPanUpdate: (d) {
final dx =
d.delta.dx /
constraints.maxWidth;
final dy =
d.delta.dy /
constraints.maxHeight;
setState(() {
double l = (_activeRect.left + dx)
.clamp(0.0, 1.0);
double t = (_activeRect.top + dy)
.clamp(0.0, 1.0);
// clamp so it stays within page
l = l.clamp(
0.0,
1.0 - _activeRect.width,
);
t = t.clamp(
0.0,
1.0 - _activeRect.height,
);
_activeRect = Rect.fromLTWH(
l,
t,
_activeRect.width,
_activeRect.height,
);
});
},
child: DecoratedBox(
decoration: BoxDecoration(
border: Border.all(
@ -215,7 +243,48 @@ class _PdfMockContinuousListState extends ConsumerState<PdfMockContinuousList> {
height: 14,
child: GestureDetector(
key: const Key('signature_handle'),
// Removed onPanUpdate to allow scrolling
onPanUpdate: (d) {
final dx =
d.delta.dx /
constraints.maxWidth;
final dy =
d.delta.dy /
constraints.maxHeight;
setState(() {
double newW = (_activeRect.width +
dx)
.clamp(0.05, 1.0);
double newH =
(_activeRect.height + dy)
.clamp(0.05, 1.0);
if (aspectLocked) {
final ratio =
_activeRect.width /
_activeRect.height;
// keep ratio; prefer width change driving height
newH = (newW /
(ratio == 0
? 1
: ratio))
.clamp(0.05, 1.0);
}
// clamp to page bounds
newW = newW.clamp(
0.05,
1.0 - _activeRect.left,
);
newH = newH.clamp(
0.05,
1.0 - _activeRect.top,
);
_activeRect = Rect.fromLTWH(
_activeRect.left,
_activeRect.top,
newW,
newH,
);
});
},
child: DecoratedBox(
decoration: BoxDecoration(
color: Colors.white,

24
lib/ui/features/pdf/widgets/pdf_page_area.dart
View File

@ -5,8 +5,6 @@ import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'pdf_viewer_widget.dart';
import '../view_model/pdf_view_model.dart';
import 'pdf_providers.dart';
class PdfPageArea extends ConsumerStatefulWidget {
const PdfPageArea({
@ -49,7 +47,10 @@ class _PdfPageAreaState extends ConsumerState<PdfPageArea> {
// is instructed to align to the provider's current page once ready.
WidgetsBinding.instance.addPostFrameCallback((_) {
if (!mounted) return;
// initial scroll not needed; controller handles positioning
final pdf = ref.read(documentRepositoryProvider);
if (pdf.loaded) {
_scrollToPage(pdf.currentPage);
}
});
}
@ -63,7 +64,6 @@ class _PdfPageAreaState extends ConsumerState<PdfPageArea> {
void _scrollToPage(int page) {
WidgetsBinding.instance.addPostFrameCallback((_) {
if (!mounted) return;
_programmaticTargetPage = page;
// Mock continuous: try ensureVisible on the page container
// Mock continuous: try ensureVisible on the page container
final ctx = _pageKey(page).currentContext;
@ -84,8 +84,6 @@ class _PdfPageAreaState extends ConsumerState<PdfPageArea> {
.clamp(position.minScrollExtent, position.maxScrollExtent)
.toDouble();
position.jumpTo(newPixels);
_visiblePage = page;
_programmaticTargetPage = null;
return;
}
} catch (_) {
@ -96,8 +94,6 @@ class _PdfPageAreaState extends ConsumerState<PdfPageArea> {
duration: Duration.zero,
curve: Curves.linear,
);
_visiblePage = page;
_programmaticTargetPage = null;
return;
}
return;
@ -119,18 +115,12 @@ class _PdfPageAreaState extends ConsumerState<PdfPageArea> {
Widget build(BuildContext context) {
final pdf = ref.watch(documentRepositoryProvider);
const pageViewMode = 'continuous';
// React to PdfViewModel (source of truth for current page)
ref.listen<int>(pdfViewModelProvider, (prev, next) {
if (prev != next) {
_scrollToPage(next);
}
});
// React to provider currentPage changes (e.g., user tapped overview)
ref.listen(currentPageProvider, (prev, next) {
ref.listen(documentRepositoryProvider, (prev, next) {
if (_suppressProviderListen) return;
if (prev != next) {
final target = next;
if ((prev?.currentPage != next.currentPage)) {
final target = next.currentPage;
// If we're already navigating to this target, ignore; otherwise allow new target.
if (_programmaticTargetPage != null &&
_programmaticTargetPage == target) {

37
lib/ui/features/pdf/widgets/pdf_page_overlays.dart
View File

@ -4,7 +4,6 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import '../../../../domain/models/model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'signature_overlay.dart';
import 'pdf_providers.dart';
/// Builds all overlays for a given page: placed signatures and the active one.
class PdfPageOverlays extends ConsumerWidget {
@ -48,42 +47,6 @@ class PdfPageOverlays extends ConsumerWidget {
);
}
// Add active overlay if present and not using mock (mock has its own)
final activeRect = ref.watch(activeRectProvider);
final useMock = ref.watch(useMockViewerProvider);
if (!useMock && activeRect != null) {
widgets.add(
LayoutBuilder(
builder: (context, constraints) {
final left = activeRect.left * constraints.maxWidth;
final top = activeRect.top * constraints.maxHeight;
final width = activeRect.width * constraints.maxWidth;
final height = activeRect.height * constraints.maxHeight;
return Stack(
children: [
Positioned(
left: left,
top: top,
width: width,
height: height,
child: GestureDetector(
key: const Key('signature_overlay'),
// Removed onPanUpdate to allow scrolling
child: DecoratedBox(
decoration: BoxDecoration(
border: Border.all(color: Colors.red, width: 2),
),
child: const SizedBox.expand(),
),
),
),
],
);
},
),
);
}
return Stack(children: widgets);
}
}

11
lib/ui/features/pdf/widgets/pdf_pages_overview.dart
View File

@ -21,13 +21,12 @@ class PdfPagesOverview extends ConsumerWidget {
separatorBuilder: (_, _) => const SizedBox(height: 8),
itemBuilder: (context, index) {
final pageNumber = index + 1;
final isSelected = ref.watch(currentPageProvider) == pageNumber;
final isSelected = pdf.currentPage == pageNumber;
return InkWell(
onTap: () {
final controller = ref.read(pdfViewerControllerProvider);
if (controller.isReady)
controller.goToPage(pageNumber: pageNumber);
},
onTap:
() => ref
.read(documentRepositoryProvider.notifier)
.jumpTo(pageNumber),
child: DecoratedBox(
decoration: BoxDecoration(
color:

12
lib/ui/features/pdf/widgets/pdf_providers.dart
View File

@ -1,6 +1,5 @@
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdfrx/pdfrx.dart';
/// Whether to use a mock continuous viewer (ListView) instead of a real PDF viewer.
/// Tests will override this to true.
@ -17,14 +16,3 @@ final aspectLockedProvider = StateProvider<bool>((ref) => false);
/// Current active overlay rect (normalized 0..1) for the mock viewer.
/// Integration tests can read this to confirm or compute placements.
final activeRectProvider = StateProvider<Rect?>((ref) => null);
/// Exposes the PdfViewerController so toolbar / thumbnails can invoke navigation.
/// It must be overridden at runtime by the hosting screen (e.g. `PdfSignatureHomePage`).
// Default controller (can be overridden by a screen to ensure a stable instance within its subtree).
final PdfViewerController _defaultPdfViewerController = PdfViewerController();
final pdfViewerControllerProvider = Provider<PdfViewerController>((ref) {
return _defaultPdfViewerController;
});
/// Current page (1-based). Updated by PdfViewer via onPageChanged.
final currentPageProvider = StateProvider<int>((ref) => 1);

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

@ -3,20 +3,18 @@ import 'package:file_selector/file_selector.dart' as fs;
import 'package:flutter/foundation.dart' show kIsWeb;
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdfrx/pdfrx.dart';
import 'package:pdf_signature/data/repositories/preferences_repository.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:multi_split_view/multi_split_view.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'pdf_providers.dart';
import 'package:pdfrx/pdfrx.dart';
import 'draw_canvas.dart';
import 'pdf_toolbar.dart';
import 'pdf_page_area.dart';
import 'pages_sidebar.dart';
import 'signatures_sidebar.dart';
import 'ui_services.dart';
import '../view_model/pdf_view_model.dart';
class PdfSignatureHomePage extends ConsumerStatefulWidget {
const PdfSignatureHomePage({super.key});
@ -80,26 +78,7 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
}
void _jumpToPage(int page) {
final controller = ref.read(pdfViewerControllerProvider);
final current = ref.read(currentPageProvider);
final pdf = ref.read(documentRepositoryProvider);
int target;
if (page == -1) {
target = (current - 1).clamp(1, pdf.pageCount);
} else {
target = page.clamp(1, pdf.pageCount);
}
// Update reactive page providers so UI/tests reflect navigation even if controller is a stub
if (current != target) {
ref.read(currentPageProvider.notifier).state = target;
// Also notify view model (if used elsewhere) via its public API
try {
ref.read(pdfViewModelProvider.notifier).jumpToPage(target);
} catch (_) {
// ignore if provider not available
}
}
if (controller.isReady) controller.goToPage(pageNumber: target);
ref.read(documentRepositoryProvider.notifier).jumpTo(page);
}
Future<Uint8List?> _loadSignatureFromFile() async {
@ -135,10 +114,7 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
context: context,
isScrollControlled: true,
enableDrag: false,
builder:
(_) => DrawCanvas(
onConfirm: (bytes) => Navigator.of(context).pop(bytes),
),
builder: (_) => const DrawCanvas(),
);
if (result != null && result.isNotEmpty) {
// In simplified UI, adding to library isn't implemented
@ -296,16 +272,6 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
@override
Widget build(BuildContext context) {
// Provide controller override so descendants can access it.
return ProviderScope(
overrides: [pdfViewerControllerProvider.overrideWithValue(_controller)],
child: _buildScaffold(context),
);
}
late final PdfViewerController _controller = PdfViewerController();
Widget _buildScaffold(BuildContext context) {
final isExporting = ref.watch(exportingProvider);
final l = AppLocalizations.of(context);
return Scaffold(
@ -345,24 +311,6 @@ class _PdfSignatureHomePageState extends ConsumerState<PdfSignatureHomePage> {
_applySidebarVisibility();
}),
),
// Expose a compact signature drawer trigger area for tests when sidebar hidden
if (!_showSignaturesSidebar)
Align(
alignment: Alignment.centerLeft,
child: SizedBox(
height:
0, // zero-height container exposing buttons offstage
width: 0,
child: Offstage(
offstage: true,
child: SignaturesSidebar(
onLoadSignatureFromFile: _loadSignatureFromFile,
onOpenDrawCanvas: _openDrawCanvas,
onSave: _saveSignedPdf,
),
),
),
),
const SizedBox(height: 8),
Expanded(
child: MultiSplitView(

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

@ -4,7 +4,6 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'pdf_providers.dart';
class PdfToolbar extends ConsumerStatefulWidget {
const PdfToolbar({
@ -57,9 +56,8 @@ class _PdfToolbarState extends ConsumerState<PdfToolbar> {
@override
Widget build(BuildContext context) {
final pdf = ref.watch(documentRepositoryProvider);
final currentPage = ref.watch(currentPageProvider);
final l = AppLocalizations.of(context);
final pageInfo = l.pageInfo(currentPage, pdf.pageCount);
final pageInfo = l.pageInfo(pdf.currentPage, pdf.pageCount);
return LayoutBuilder(
builder: (context, constraints) {
@ -105,7 +103,8 @@ class _PdfToolbarState extends ConsumerState<PdfToolbar> {
onPressed:
widget.disabled
? null
: () => widget.onJumpToPage(-1),
: () =>
widget.onJumpToPage(pdf.currentPage - 1),
icon: const Icon(Icons.chevron_left),
tooltip: l.prev,
),
@ -116,7 +115,8 @@ class _PdfToolbarState extends ConsumerState<PdfToolbar> {
onPressed:
widget.disabled
? null
: () => widget.onJumpToPage(currentPage + 1),
: () =>
widget.onJumpToPage(pdf.currentPage + 1),
icon: const Icon(Icons.chevron_right),
tooltip: l.next,
),

17
lib/ui/features/pdf/widgets/pdf_viewer_widget.dart
View File

@ -4,9 +4,9 @@ import 'package:pdfrx/pdfrx.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'pdf_page_overlays.dart';
import 'pdf_providers.dart';
import './pdf_mock_continuous_list.dart';
import '../../signature/widgets/signature_drag_data.dart';
import 'pdf_providers.dart';
class PdfViewerWidget extends ConsumerStatefulWidget {
const PdfViewerWidget({
@ -38,9 +38,6 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
PdfViewerController? _controller;
PdfDocumentRef? _documentRef;
// Public getter for testing the actual viewer page
int? get viewerCurrentPage => _controller?.pageNumber;
@override
void initState() {
super.initState();
@ -57,9 +54,6 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
Widget build(BuildContext context) {
final document = ref.watch(documentRepositoryProvider);
final useMock = ref.watch(useMockViewerProvider);
ref.watch(activeRectProvider); // trigger rebuild when active rect changes
// Watch to rebuild on page change
ref.watch(currentPageProvider);
// Update document ref when document changes
if (document.loaded && document.pickedPdfBytes != null) {
@ -115,8 +109,9 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
.setPageCount(document.pages.length);
},
onPageChanged: (page) {
// Update current page in repository
if (page != null) {
ref.read(currentPageProvider.notifier).state = page;
ref.read(documentRepositoryProvider.notifier).jumpTo(page);
}
},
),
@ -130,7 +125,8 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
// For real PDF viewer, we need to calculate which page was dropped on
// This is a simplified implementation - in a real app you'd need to
// determine the exact page and position within that page
final currentPage = ref.read(currentPageProvider);
final currentPage =
ref.read(documentRepositoryProvider).currentPage;
// Create a default rect for the signature (can be adjusted later)
final rect = const Rect.fromLTWH(0.1, 0.1, 0.2, 0.1);
@ -143,7 +139,6 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
rect: rect,
asset: dragData.card?.asset,
rotationDeg: dragData.card?.rotationDeg ?? 0.0,
graphicAdjust: dragData.card?.graphicAdjust,
);
},
builder: (context, candidateData, rejectedData) {
@ -168,7 +163,7 @@ class _PdfViewerWidgetState extends ConsumerState<PdfViewerWidget> {
// to handle overlays for each page properly
return PdfPageOverlays(
pageSize: widget.pageSize,
pageNumber: ref.watch(currentPageProvider),
pageNumber: document.currentPage,
onDragSignature: widget.onDragSignature,
onResizeSignature: widget.onResizeSignature,
onConfirmSignature: widget.onConfirmSignature,

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

@ -5,10 +5,8 @@ import 'package:pdf_signature/l10n/app_localizations.dart';
// No direct model construction needed here
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'image_editor_dialog.dart';
import '../../signature/widgets/signature_card.dart';
import 'pdf_providers.dart';
/// Data for drag-and-drop is in signature_drag_data.dart
@ -34,7 +32,7 @@ class _SignatureDrawerState extends ConsumerState<SignatureDrawer> {
@override
Widget build(BuildContext context) {
final l = AppLocalizations.of(context);
final library = ref.watch(signatureCardRepositoryProvider);
final library = ref.watch(signatureAssetRepositoryProvider);
// Exporting flag lives in ui_services; keep drawer interactive regardless here.
final isExporting = false;
final disabled = widget.disabled || isExporting;
@ -43,21 +41,20 @@ class _SignatureDrawerState extends ConsumerState<SignatureDrawer> {
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
if (library.isNotEmpty) ...[
for (final card in library) ...[
for (final a in library) ...[
Card(
margin: EdgeInsets.zero,
child: Padding(
padding: const EdgeInsets.all(12),
child: SignatureCard(
key: ValueKey('sig_card_${library.indexOf(card)}'),
asset: card.asset,
rotationDeg: card.rotationDeg,
graphicAdjust: card.graphicAdjust,
key: ValueKey('sig_card_${library.indexOf(a)}'),
asset: a,
rotationDeg: 0.0,
disabled: disabled,
onDelete:
() => ref
.read(signatureCardRepositoryProvider.notifier)
.remove(card),
.read(signatureAssetRepositoryProvider.notifier)
.remove(a),
onAdjust: () async {
if (!mounted) return;
await showDialog(
@ -65,11 +62,7 @@ class _SignatureDrawerState extends ConsumerState<SignatureDrawer> {
builder: (_) => const ImageEditorDialog(),
);
},
onTap: () {
ref
.read(activeRectProvider.notifier)
.state = const Rect.fromLTWH(0.2, 0.2, 0.3, 0.15);
},
onTap: () {},
),
),
),

22
lib/ui/features/signature/widgets/rotated_signature_image.dart
View File

@ -58,23 +58,13 @@ class _RotatedSignatureImageState extends State<RotatedSignatureImage> {
void _resolveImage() {
_unlisten();
// Decode synchronously to get aspect ratio
// Guard against empty / invalid bytes that some simplified tests may inject.
if (widget.bytes.isEmpty) {
_setAspectRatio(1.0); // assume square to avoid layout exceptions
return;
}
try {
final decoded = img.decodePng(widget.bytes);
if (decoded != null) {
final w = decoded.width;
final h = decoded.height;
if (w > 0 && h > 0) {
_setAspectRatio(w / h);
}
final decoded = img.decodePng(widget.bytes);
if (decoded != null) {
final w = decoded.width;
final h = decoded.height;
if (w > 0 && h > 0) {
_setAspectRatio(w / h);
}
} catch (_) {
// Swallow decode errors for test-provided dummy data; assume square.
_setAspectRatio(1.0);
}
final stream = _provider.resolve(createLocalImageConfiguration(context));
_stream = stream;

3
lib/ui/features/signature/widgets/signature_card.dart
View File

@ -14,7 +14,6 @@ class SignatureCard extends StatelessWidget {
this.onAdjust,
this.useCurrentBytesForDrag = false,
this.rotationDeg = 0.0,
this.graphicAdjust = const domain.GraphicAdjust(),
});
final domain.SignatureAsset asset;
final bool disabled;
@ -23,7 +22,6 @@ class SignatureCard extends StatelessWidget {
final VoidCallback? onAdjust;
final bool useCurrentBytesForDrag;
final double rotationDeg;
final domain.GraphicAdjust graphicAdjust;
@override
Widget build(BuildContext context) {
@ -148,7 +146,6 @@ class SignatureCard extends StatelessWidget {
card: domain.SignatureCard(
asset: asset,
rotationDeg: rotationDeg,
graphicAdjust: graphicAdjust,
),
),
feedback: Opacity(

61
test/features/_test_helper.dart
View File

@ -1,61 +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:shared_preferences/shared_preferences.dart';
import 'package:pdf_signature/app.dart';
import 'package:pdf_signature/data/repositories/preferences_repository.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/ui_services.dart';
import 'package:pdf_signature/data/services/export_service.dart';
import 'package:pdf_signature/domain/models/model.dart';
class FakeExportService extends ExportService {
bool exported = false;
@override
Future<Uint8List?> exportSignedPdfFromBytes({
Map<String, Uint8List>? libraryBytes,
required Uint8List srcBytes,
required Size uiPageSize,
required Uint8List? signatureImageBytes,
Map<int, List<SignaturePlacement>>? placementsByPage,
double targetDpi = 144.0,
}) async => Uint8List.fromList([1, 2, 3]);
@override
Future<bool> saveBytesToFile({
required Uint8List bytes,
required String outputPath,
}) async {
exported = true;
return true;
}
}
Future<ProviderContainer> pumpApp(
WidgetTester tester, {
Map<String, Object> initialPrefs = const {},
}) async {
SharedPreferences.setMockInitialValues(initialPrefs);
final prefs = await SharedPreferences.getInstance();
final fakeExport = FakeExportService();
final container = ProviderContainer(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) => DocumentStateNotifier()..openSample(),
),
useMockViewerProvider.overrideWith((ref) => true),
exportServiceProvider.overrideWith((ref) => fakeExport),
savePathPickerProvider.overrideWith((ref) => () async => 'out.pdf'),
],
);
await tester.pumpWidget(
UncontrolledProviderScope(container: container, child: const MyApp()),
);
await tester.pumpAndSettle();
return container;
}

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

@ -1,16 +1,11 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: a document page is selected for signing
Future<void> aDocumentPageIsSelectedForSigning(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Ensure current page is 1 for consistent subsequent steps
try {
container.read(pdfViewModelProvider.notifier).jumpToPage(1);
} catch (_) {}
container.read(documentRepositoryProvider.notifier).jumpTo(1);
}

31
test/features/step/a_drawn_signature_exists_in_the_canvas.dart
View File

@ -1,31 +1,12 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import '../_test_helper.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
/// Usage: a drawn signature exists in the canvas
Future<void> aDrawnSignatureExistsInTheCanvas(WidgetTester tester) async {
// Tap the draw signature button to open the dialog
if (find.byType(MaterialApp).evaluate().isEmpty) {
final container = await pumpApp(tester);
TestWorld.container = container;
}
// Ensure button exists
expect(find.byKey(const Key('btn_drawer_draw_signature')), findsOneWidget);
await tester.tap(find.byKey(const Key('btn_drawer_draw_signature')));
await tester.pumpAndSettle();
// Now the DrawCanvas dialog should be open
expect(find.byKey(const Key('draw_canvas')), findsOneWidget);
// Simulate drawing strokes on the canvas
final canvas = find.byKey(const Key('hand_signature_pad'));
expect(canvas, findsOneWidget);
// Draw a simple stroke
await tester.drag(canvas, const Offset(50, 50));
await tester.drag(canvas, const Offset(100, 100));
await tester.drag(canvas, const Offset(150, 150));
// Do not confirm, so the canvas has strokes but is not closed
final container = TestWorld.container ?? ProviderContainer();
final sigN = container.read(signatureProvider.notifier);
sigN.setStrokes([
[const Offset(0, 0), const Offset(1, 1)],
]);
}

9
test/features/step/a_multipage_document_is_open.dart
View File

@ -4,8 +4,6 @@ import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: a multi-page document is open
@ -21,11 +19,4 @@ Future<void> aMultipageDocumentIsOpen(WidgetTester tester) async {
container
.read(documentRepositoryProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
// Reset page state providers
try {
container.read(currentPageProvider.notifier).state = 1;
} catch (_) {}
try {
container.read(pdfViewModelProvider.notifier).jumpToPage(1);
} catch (_) {}
}

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

@ -1,16 +1,37 @@
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/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import '_world.dart';
/// Usage: a signature asset is created
Future<void> aSignatureAssetIsCreated(WidgetTester tester) async {
final container = TestWorld.container!;
final assets = container.read(signatureAssetRepositoryProvider);
expect(assets, isNotEmpty);
// The last added should be the drawn one
final lastAsset = assets.last;
expect(lastAsset.name, 'drawing');
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Pump to ensure UI is updated
await tester.pump();
// Ensure PDF is open
if (!container.read(documentRepositoryProvider).loaded) {
container
.read(documentRepositoryProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
}
// Create a dummy signature asset
final asset = SignatureAsset(bytes: Uint8List(100), name: 'Test Asset');
container
.read(signatureAssetRepositoryProvider.notifier)
.add(asset.bytes, name: asset.name);
// Place it on the current page
final pdf = container.read(documentRepositoryProvider);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: pdf.currentPage,
rect: Rect.fromLTWH(50, 50, 100, 50),
asset: asset,
);
}

71
test/features/step/a_signature_asset_is_loaded_or_drawn.dart
View File

@ -17,76 +17,7 @@ Future<void> aSignatureAssetIsLoadedOrDrawn(WidgetTester tester) async {
container.read(signatureCardRepositoryProvider.notifier).state = [
SignatureCard.initial(),
];
// Use a tiny valid PNG so any later image decoding succeeds.
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,
0x60,
0x00,
0x00,
0x00,
0x02,
0x00,
0x01,
0xE5,
0x27,
0xD4,
0xA6,
0x00,
0x00,
0x00,
0x00,
0x49,
0x45,
0x4E,
0x44,
0xAE,
0x42,
0x60,
0x82,
]);
final bytes = Uint8List.fromList([1, 2, 3, 4, 5]);
container
.read(signatureAssetRepositoryProvider.notifier)
.add(bytes, name: 'test.png');

7
test/features/step/a_signature_asset_is_placed_on_the_page.dart
View File

@ -5,7 +5,6 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: a signature asset is placed on the page
@ -36,12 +35,12 @@ Future<void> aSignatureAssetIsPlacedOnThePage(WidgetTester tester) async {
}
// Place it on the current page
final currentPage = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: currentPage,
rect: const Rect.fromLTWH(50, 50, 100, 50),
page: pdf.currentPage,
rect: Rect.fromLTWH(50, 50, 100, 50),
asset: asset,
);
}

4
test/features/step/a_signature_placement_appears_on_the_page_based_on_the_signature_card.dart
View File

@ -1,6 +1,5 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: a signature placement appears on the page based on the signature card
@ -9,8 +8,7 @@ Future<void> aSignaturePlacementAppearsOnThePageBasedOnTheSignatureCard(
) async {
final container = TestWorld.container!;
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(
placements.isNotEmpty,
true,

7
test/features/step/a_signature_placement_is_placed_with_a_position_and_size_relative_to_the_page.dart
View File

@ -3,7 +3,6 @@ import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/domain/models/model.dart';
import '_world.dart';
@ -13,12 +12,12 @@ Future<void> aSignaturePlacementIsPlacedWithAPositionAndSizeRelativeToThePage(
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final currentPage = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: currentPage,
rect: const Rect.fromLTWH(50, 50, 200, 100),
page: pdf.currentPage,
rect: Rect.fromLTWH(50, 50, 200, 100),
asset: SignatureAsset(bytes: Uint8List(0), name: 'test.png'),
);
}

13
test/features/step/an_empty_signature_canvas.dart
View File

@ -1,17 +1,6 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import '../_test_helper.dart';
import '_world.dart';
/// Usage: an empty signature canvas
Future<void> anEmptySignatureCanvas(WidgetTester tester) async {
// Pump the app so the signature drawer (and its draw button) exists.
if (find.byType(MaterialApp).evaluate().isEmpty) {
final container = await pumpApp(tester);
TestWorld.container = container;
}
// The draw canvas should not be open initially
expect(find.byKey(const Key('draw_canvas')), findsNothing);
// Ensure the draw signature button is present
expect(find.byKey(const Key('btn_drawer_draw_signature')), findsOneWidget);
// Mock: assume canvas is empty
}

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

@ -1,7 +1,7 @@
import 'dart:ui';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: dragging or resizing one does not change the other
@ -9,27 +9,26 @@ Future<void> draggingOrResizingOneDoesNotChangeTheOther(
WidgetTester tester,
) async {
final container = TestWorld.container ?? ProviderContainer();
final page = container.read(pdfViewModelProvider);
final list = container
.read(documentRepositoryProvider.notifier)
.placementsOn(page);
.placementsOn(1);
expect(list.length, greaterThanOrEqualTo(2));
// Capture rects independently (avoid invalidation by mutation)
final firstRectBefore = list[0].rect;
final secondRectBefore = list[1].rect;
// Simulate modifying only the first placement's size
final changedFirst = firstRectBefore.inflate(5);
final before = List<Rect>.from(list.take(2).map((p) => p.rect));
// Simulate changing the first only
final changed = before[0].inflate(5);
container
.read(documentRepositoryProvider.notifier)
.updatePlacementRect(page: page, index: 0, rect: changedFirst);
.removePlacement(page: 1, index: 0);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: 1,
rect: changed,
asset: list[1].asset,
rotationDeg: list[1].rotationDeg,
);
final after = container
.read(documentRepositoryProvider.notifier)
.placementsOn(page);
expect(after.length, greaterThanOrEqualTo(2));
// First changed, second unchanged
expect(after[0].rect, isNot(equals(firstRectBefore)));
expect(after[0].rect, equals(changedFirst));
expect(after[1].rect, equals(secondRectBefore));
.placementsOn(1);
expect(after.any((p) => p.rect == before[1]), isTrue);
}

4
test/features/step/each_signature_placement_can_be_dragged_and_resized_independently.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: each signature placement can be dragged and resized independently
@ -10,7 +9,6 @@ Future<void> eachSignaturePlacementCanBeDraggedAndResizedIndependently(
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.length, greaterThan(1));
}

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

@ -1,28 +1,12 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import '../_test_helper.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
/// Usage: multiple strokes were drawn
Future<void> multipleStrokesWereDrawn(WidgetTester tester) async {
// Open the draw dialog
if (find.byType(MaterialApp).evaluate().isEmpty) {
final container = await pumpApp(tester);
TestWorld.container = container;
}
expect(find.byKey(const Key('btn_drawer_draw_signature')), findsOneWidget);
await tester.tap(find.byKey(const Key('btn_drawer_draw_signature')));
await tester.pumpAndSettle();
// Draw multiple strokes
final canvas = find.byKey(const Key('hand_signature_pad'));
expect(canvas, findsOneWidget);
// First stroke
await tester.drag(canvas, const Offset(50, 50));
await tester.drag(canvas, const Offset(100, 100));
// Second stroke
await tester.drag(canvas, const Offset(200, 200));
await tester.drag(canvas, const Offset(250, 250));
final container = TestWorld.container ?? ProviderContainer();
container.read(signatureProvider.notifier).setStrokes([
[const Offset(0, 0), const Offset(1, 1)],
[const Offset(2, 2), const Offset(3, 3)],
]);
}

4
test/features/step/only_the_selected_signature_placement_is_removed.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: only the selected signature placement is removed
@ -10,7 +9,6 @@ Future<void> onlyTheSelectedSignaturePlacementIsRemoved(
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.length, 2); // Started with 3, removed 1, should have 2
}

4
test/features/step/page_becomes_visible_in_the_scroll_area.dart
View File

@ -1,6 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: page {5} becomes visible in the scroll area
@ -10,5 +10,5 @@ Future<void> pageBecomesVisibleInTheScrollArea(
) async {
final page = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
expect(c.read(pdfViewModelProvider), page);
expect(c.read(documentRepositoryProvider).currentPage, page);
}

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

@ -1,18 +1,11 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: page {1} is displayed
Future<void> pageIsDisplayed(WidgetTester tester, num param1) async {
final expected = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
final vm = c.read(pdfViewModelProvider);
final legacy = c.read(currentPageProvider);
expect(
vm == expected || legacy == expected,
true,
reason: 'Expected page $expected but got vm=$vm current=$legacy',
);
expect(c.read(documentRepositoryProvider).currentPage, expected);
}

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

@ -1,15 +1,14 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: resize to fit within bounding box
Future<void> resizeToFitWithinBoundingBox(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
for (final placement in placements) {
// Assume page size is 800x600 for testing
const pageWidth = 800.0;

27
test/features/step/signature_placement_occurs_on_the_selected_page.dart
View File

@ -1,28 +1,17 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import '_world.dart';
import 'dart:ui';
/// Usage: signature placement occurs on the selected page
/// Simplified: directly adds a placement to page 1 if none exist yet.
Future<void> signaturePlacementOccursOnTheSelectedPage(
WidgetTester tester,
) async {
final container = TestWorld.container!;
final repo = container.read(documentRepositoryProvider.notifier);
final state = container.read(documentRepositoryProvider);
final page = 1;
if ((state.placementsByPage[page] ?? const []).isEmpty) {
final assets = container.read(signatureAssetRepositoryProvider);
final asset = assets.isNotEmpty ? assets.last : null;
repo.addPlacement(
page: page,
rect: const Rect.fromLTWH(0.1, 0.1, 0.2, 0.1),
asset: asset,
);
}
await tester.pump();
final updated = container.read(documentRepositoryProvider);
expect(updated.placementsByPage[page], isNotEmpty);
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final pdf = container.read(documentRepositoryProvider);
// Check that there's at least one placement on the current page
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.isNotEmpty, true);
}

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

@ -6,17 +6,8 @@ Future<void> theAppLanguageIs(
WidgetTester tester,
String languageWrapped,
) async {
String unwrap(String s) {
var r = s.trim();
if (r.startsWith('{') && r.endsWith('}')) {
r = r.substring(1, r.length - 1).trim();
}
if (r.startsWith("'") && r.endsWith("'")) {
r = r.substring(1, r.length - 1);
}
return r;
}
String unwrap(String s) =>
s.startsWith('{') && s.endsWith('}') ? s.substring(1, s.length - 1) : s;
final lang = unwrap(languageWrapped);
expect(TestWorld.currentLanguage, lang);
}

100
test/features/step/the_app_launches.dart
View File

@ -1,100 +1,12 @@
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:pdf_signature/app.dart';
import 'package:pdf_signature/data/repositories/preferences_repository.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import '_world.dart';
class _BridgedSignatureCardStateNotifier extends SignatureCardStateNotifier {
void setAll(List<SignatureCard> cards) {
state = List.unmodifiable(cards);
}
}
/// Usage: the app launches
Future<void> theAppLaunches(WidgetTester tester) async {
// Preserve any previously simulated stored preferences (used by scenarios
// that set TestWorld.prefs BEFORE launching to emulate a prior run).
final preservedPrefs = Map<String, String>.from(TestWorld.prefs);
TestWorld.reset();
if (preservedPrefs.isNotEmpty) {
TestWorld.prefs = preservedPrefs; // restore for this launch
}
SharedPreferences.setMockInitialValues(TestWorld.prefs);
final prefs = await SharedPreferences.getInstance();
final container = ProviderContainer(
overrides: [
preferencesRepositoryProvider.overrideWith(
(ref) => PreferencesStateNotifier(prefs),
),
documentRepositoryProvider.overrideWith(
(ref) => DocumentStateNotifier()..openSample(),
),
useMockViewerProvider.overrideWith((ref) => true),
// Bridge: automatically mirror assets into signature cards so legacy
// feature steps that expect SignatureCard widgets keep working even
// though the production UI currently only stores raw assets.
signatureCardRepositoryProvider.overrideWith((ref) {
final notifier = _BridgedSignatureCardStateNotifier();
ref.listen<List<SignatureAsset>>(signatureAssetRepositoryProvider, (
prev,
next,
) {
for (final asset in next) {
if (!notifier.state.any((c) => identical(c.asset, asset))) {
notifier.add(SignatureCard(asset: asset, rotationDeg: 0.0));
}
}
// Remove cards whose assets were removed
final remaining =
notifier.state.where((c) => next.contains(c.asset)).toList();
if (remaining.length != notifier.state.length) {
notifier.setAll(remaining);
}
});
return notifier;
}),
],
);
TestWorld.container = container;
await tester.pumpWidget(
UncontrolledProviderScope(container: container, child: const MyApp()),
);
await tester.pumpAndSettle();
// ----- Simulated app preference initialization logic -----
// Theme initialization & validation
const validThemes = {'light', 'dark', 'system'};
final storedTheme = TestWorld.prefs['theme'];
if (storedTheme != null && validThemes.contains(storedTheme)) {
TestWorld.selectedTheme = storedTheme;
} else {
// Fallback to system if missing/invalid
TestWorld.selectedTheme = 'system';
TestWorld.prefs['theme'] = 'system';
}
// currentTheme reflects either explicit theme or current system appearance
TestWorld.currentTheme =
TestWorld.selectedTheme == 'system'
? TestWorld.systemTheme
: TestWorld.selectedTheme;
// Language initialization & validation
const validLangs = {'en', 'zh-TW', 'es'};
final storedLang = TestWorld.prefs['language'];
if (storedLang != null && validLangs.contains(storedLang)) {
TestWorld.currentLanguage = storedLang;
} else {
// Fallback to device locale
TestWorld.currentLanguage = TestWorld.deviceLocale;
TestWorld.prefs['language'] = TestWorld.deviceLocale;
}
// Read stored preferences and apply
final theme = TestWorld.prefs['theme'] ?? 'system';
TestWorld.selectedTheme = theme;
TestWorld.currentTheme = theme == 'system' ? TestWorld.systemTheme : theme;
final lang = TestWorld.prefs['language'] ?? TestWorld.deviceLocale;
TestWorld.currentLanguage = lang;
}

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

@ -3,17 +3,8 @@ import '_world.dart';
/// Usage: the app UI theme is {"<theme>"}
Future<void> theAppUiThemeIs(WidgetTester tester, String themeWrapped) async {
String unwrap(String s) {
var r = s.trim();
if (r.startsWith('{') && r.endsWith('}')) {
r = r.substring(1, r.length - 1).trim();
}
if (r.startsWith("'") && r.endsWith("'")) {
r = r.substring(1, r.length - 1);
}
return r;
}
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

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

@ -1,9 +1,7 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
/// Usage: the canvas becomes blank
Future<void> theCanvasBecomesBlank(WidgetTester tester) async {
// The canvas should still be open
expect(find.byKey(const Key('draw_canvas')), findsOneWidget);
// Assume it's blank after clear
// Mock: assume canvas is blank
expect(true, isTrue);
}

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

@ -1,11 +1,11 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the first page is displayed
Future<void> theFirstPageIsDisplayed(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final currentPage = container.read(pdfViewModelProvider);
expect(currentPage, 1);
final pdf = container.read(documentRepositoryProvider);
expect(pdf.currentPage, 1);
}

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

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the Go to input cannot be used
@ -9,9 +8,8 @@ Future<void> theGoToInputCannotBeUsed(WidgetTester tester) async {
final c = TestWorld.container ?? ProviderContainer();
// Not loaded, currentPage should remain 1 even after jump attempt
expect(c.read(documentRepositoryProvider).loaded, isFalse);
final before = c.read(pdfViewModelProvider);
// documentRepository jumpTo no longer changes page; ensure unchanged
final before = c.read(documentRepositoryProvider).currentPage;
c.read(documentRepositoryProvider.notifier).jumpTo(3);
final after = c.read(pdfViewModelProvider);
final after = c.read(documentRepositoryProvider).currentPage;
expect(before, equals(after));
}

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

@ -1,8 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import '_world.dart';
/// Usage: the last page is displayed (page {5})
@ -11,11 +9,5 @@ Future<void> theLastPageIsDisplayedPage(WidgetTester tester, num param1) async {
final c = TestWorld.container ?? ProviderContainer();
final pdf = c.read(documentRepositoryProvider);
expect(pdf.pageCount, last);
final vm = c.read(pdfViewModelProvider);
final legacy = c.read(currentPageProvider);
expect(
vm == last || legacy == last,
true,
reason: 'Expected last page $last but got vm=$vm current=$legacy',
);
expect(pdf.currentPage, last);
}

9
test/features/step/the_last_stroke_is_removed.dart
View File

@ -1,9 +1,10 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
/// Usage: the last stroke is removed
Future<void> theLastStrokeIsRemoved(WidgetTester tester) async {
// The canvas should still be open
expect(find.byKey(const Key('draw_canvas')), findsOneWidget);
// Assume the last stroke is removed
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
expect(sig.strokes.length, 1);
}

4
test/features/step/the_left_pages_overview_highlights_page.dart
View File

@ -1,6 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the left pages overview highlights page {5}
@ -10,5 +10,5 @@ Future<void> theLeftPagesOverviewHighlightsPage(
) async {
final n = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
expect(c.read(pdfViewModelProvider), n);
expect(c.read(documentRepositoryProvider).currentPage, n);
}

4
test/features/step/the_other_signature_placements_remain_unchanged.dart
View File

@ -1,6 +1,5 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the other signature placements remain unchanged
@ -9,7 +8,6 @@ Future<void> theOtherSignaturePlacementsRemainUnchanged(
) async {
final container = TestWorld.container!;
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
expect(placements.length, 2); // Should have 2 remaining after deleting 1
}

3
test/features/step/the_page_label_shows_page_of.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the page label shows "Page {5} of {5}"
@ -14,6 +13,6 @@ Future<void> thePageLabelShowsPageOf(
final total = param2.toInt();
final c = TestWorld.container ?? ProviderContainer();
final pdf = c.read(documentRepositoryProvider);
expect(c.read(pdfViewModelProvider), current);
expect(pdf.currentPage, current);
expect(pdf.pageCount, total);
}

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

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the signature placement remains within the page area
@ -10,8 +9,8 @@ Future<void> theSignaturePlacementRemainsWithinThePageArea(
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
for (final placement in placements) {
// Assume page size is 800x600 for testing
const pageWidth = 800.0;

4
test/features/step/the_signature_placement_rotates_around_its_center_in_real_time.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the signature placement rotates around its center in real time
@ -10,9 +9,8 @@ Future<void> theSignaturePlacementRotatesAroundItsCenterInRealTime(
) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final currentPage = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[currentPage] ?? [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
if (placements.isNotEmpty) {
final placement = placements[0];
expect(placement.rotationDeg, 45.0);

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

@ -1,15 +1,14 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the size and position update in real time
Future<void> theSizeAndPositionUpdateInRealTime(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final page = container.read(pdfViewModelProvider);
final placements = pdf.placementsByPage[page] ?? const [];
final placements = pdf.placementsByPage[pdf.currentPage] ?? [];
if (placements.isNotEmpty) {
final currentRect = placements[0].rect;
expect(currentRect.center, isNot(TestWorld.prevCenter));

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

@ -1,15 +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_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user can move to the next or previous page
Future<void> theUserCanMoveToTheNextOrPreviousPage(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final vm = container.read(pdfViewModelProvider.notifier);
expect(container.read(pdfViewModelProvider), 1);
vm.jumpToPage(2);
expect(container.read(pdfViewModelProvider), 2);
vm.jumpToPage(1);
expect(container.read(pdfViewModelProvider), 1);
final pdfN = container.read(documentRepositoryProvider.notifier);
final pdf = container.read(documentRepositoryProvider);
expect(pdf.currentPage, 1);
pdfN.jumpTo(2);
expect(container.read(documentRepositoryProvider).currentPage, 2);
pdfN.jumpTo(1);
expect(container.read(documentRepositoryProvider).currentPage, 1);
}

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

@ -1,9 +1,13 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
/// Usage: the user chooses undo
Future<void> theUserChoosesUndo(WidgetTester tester) async {
// Tap the undo button
await tester.tap(find.byKey(const Key('btn_canvas_undo')));
await tester.pumpAndSettle();
final container = TestWorld.container ?? ProviderContainer();
final sig = container.read(signatureProvider);
if (sig.strokes.isNotEmpty) {
final newStrokes = List<List<Offset>>.from(sig.strokes)..removeLast();
container.read(signatureProvider.notifier).setStrokes(newStrokes);
}
}

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

@ -1,9 +1,9 @@
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
/// Usage: the user clears the canvas
Future<void> theUserClearsTheCanvas(WidgetTester tester) async {
// Tap the clear button
await tester.tap(find.byKey(const Key('btn_canvas_clear')));
await tester.pumpAndSettle();
final container = TestWorld.container ?? ProviderContainer();
container.read(signatureProvider.notifier).setStrokes([]);
}

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

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user clicks the Go to apply button
@ -9,12 +8,7 @@ Future<void> theUserClicksTheGoToApplyButton(WidgetTester tester) async {
final c = TestWorld.container ?? ProviderContainer();
final pending = TestWorld.pendingGoTo;
if (pending != null) {
try {
c.read(currentPageProvider.notifier).state = pending;
} catch (_) {}
try {
c.read(pdfViewModelProvider.notifier).jumpToPage(pending);
} catch (_) {}
c.read(documentRepositoryProvider.notifier).jumpTo(pending);
await tester.pump();
}
}

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

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user clicks the thumbnail for page {2}
@ -11,11 +10,6 @@ Future<void> theUserClicksTheThumbnailForPage(
) async {
final page = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
try {
c.read(currentPageProvider.notifier).state = page;
} catch (_) {}
try {
c.read(pdfViewModelProvider.notifier).jumpToPage(page);
} catch (_) {}
c.read(documentRepositoryProvider.notifier).jumpTo(page);
await tester.pump();
}

7
test/features/step/the_user_deletes_one_selected_signature_placement.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user deletes one selected signature placement
@ -10,13 +9,13 @@ Future<void> theUserDeletesOneSelectedSignaturePlacement(
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final currentPage = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
final placements = container
.read(documentRepositoryProvider.notifier)
.placementsOn(currentPage);
.placementsOn(pdf.currentPage);
if (placements.isNotEmpty) {
container
.read(documentRepositoryProvider.notifier)
.removePlacement(page: currentPage, index: 0);
.removePlacement(page: pdf.currentPage, index: 0);
}
}

7
test/features/step/the_user_drags_handles_to_resize_and_drags_to_reposition.dart
View File

@ -2,7 +2,6 @@ import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user drags handles to resize and drags to reposition
@ -11,10 +10,10 @@ Future<void> theUserDragsHandlesToResizeAndDragsToReposition(
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final pdf = container.read(documentRepositoryProvider);
final pdfN = container.read(documentRepositoryProvider.notifier);
final currentPage = container.read(pdfViewModelProvider);
final placements = pdfN.placementsOn(currentPage);
final placements = pdfN.placementsOn(pdf.currentPage);
if (placements.isNotEmpty) {
final currentRect = placements[0].rect;
TestWorld.prevCenter = currentRect.center;
@ -26,6 +25,6 @@ Future<void> theUserDragsHandlesToResizeAndDragsToReposition(
height: currentRect.height + 30,
);
pdfN.updatePlacementRect(page: currentPage, index: 0, rect: newRect);
pdfN.updatePlacementRect(page: pdf.currentPage, index: 0, rect: newRect);
}
}

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

@ -6,7 +6,6 @@ import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user drags this signature card on the page of the document to place a signature placement
@ -48,14 +47,13 @@ theUserDragsThisSignatureCardOnThePageOfTheDocumentToPlaceASignaturePlacement(
final drop_card = temp_card;
// Place it on the current page
final currentPage = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: currentPage,
rect: const Rect.fromLTWH(100, 100, 100, 50),
page: pdf.currentPage,
rect: Rect.fromLTWH(100, 100, 100, 50),
asset: drop_card.asset,
rotationDeg: drop_card.rotationDeg,
graphicAdjust: drop_card.graphicAdjust,
);
}

123
test/features/step/the_user_draws_strokes_and_confirms.dart
View File

@ -1,124 +1,13 @@
import 'dart:typed_data';
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import '_world.dart';
import '../_test_helper.dart';
/// Usage: the user draws strokes and confirms
Future<void> theUserDrawsStrokesAndConfirms(WidgetTester tester) async {
// Ensure app is pumped if not already
if (find.byType(MaterialApp).evaluate().isEmpty) {
final container = await pumpApp(tester);
TestWorld.container = container;
}
// If the drawer button isn't in the tree (simplified UI), inject a hidden button that opens the canvas
// App provides the button via signature sidebar; no injection needed now
// Tap the draw signature button to open the dialog
await tester.tap(find.byKey(const Key('btn_drawer_draw_signature')));
await tester.pumpAndSettle();
// Now the DrawCanvas dialog should be open
expect(find.byKey(const Key('draw_canvas')), findsOneWidget);
// Simulate drawing strokes on the canvas
final canvas = find.byKey(const Key('hand_signature_pad'));
expect(canvas, findsOneWidget);
// Draw a simple stroke
await tester.drag(canvas, const Offset(50, 50));
await tester.drag(canvas, const Offset(100, 100));
await tester.drag(canvas, const Offset(150, 150));
// Check confirm button is there
expect(find.byKey(const Key('btn_canvas_confirm')), findsOneWidget);
// Tap confirm
await tester.tap(find.byKey(const Key('btn_canvas_confirm')));
await tester.pumpAndSettle();
// Dialog should be closed
expect(find.byKey(const Key('draw_canvas')), findsNothing);
// Inject a dummy asset into repository (app does not auto-add drawn bytes yet)
final container = TestWorld.container;
if (container != null) {
container
.read(signatureAssetRepositoryProvider.notifier)
.add(
// Tiny 1x1 transparent PNG (duplicated constant for test clarity)
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,
0x60,
0x00,
0x00,
0x00,
0x02,
0x00,
0x01,
0xE5,
0x27,
0xD4,
0xA6,
0x00,
0x00,
0x00,
0x00,
0x49,
0x45,
0x4E,
0x44,
0xAE,
0x42,
0x60,
0x82,
]),
name: 'drawing',
);
}
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Simulate drawn signature bytes
final bytes = Uint8List.fromList([1, 2, 3]);
container.read(signatureProvider.notifier).setImageBytes(bytes);
}

13
test/features/step/the_user_enters_into_the_go_to_input_and_applies_it.dart
View File

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user enters {99} into the Go to input and applies it
@ -11,14 +10,6 @@ Future<void> theUserEntersIntoTheGoToInputAndAppliesIt(
) async {
final value = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
// Clamp value to valid range (1..pageCount) mimicking UI behavior
final clamped =
value < 1 ? 1 : value; // upper bound validated in last-page check step
try {
c.read(currentPageProvider.notifier).state = clamped;
} catch (_) {}
try {
c.read(pdfViewModelProvider.notifier).jumpToPage(clamped);
} catch (_) {}
c.read(documentRepositoryProvider.notifier).jumpTo(value);
await tester.pump();
}

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

@ -1,18 +1,12 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user jumps to page {2}
Future<void> theUserJumpsToPage(WidgetTester tester, num param1) async {
final page = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
try {
c.read(currentPageProvider.notifier).state = page;
} catch (_) {}
try {
c.read(pdfViewModelProvider.notifier).jumpToPage(page);
} catch (_) {}
c.read(documentRepositoryProvider.notifier).jumpTo(page);
await tester.pump();
}

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

@ -4,8 +4,6 @@ import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user navigates to page {5} and places another signature placement
@ -16,13 +14,7 @@ Future<void> theUserNavigatesToPageAndPlacesAnotherSignaturePlacement(
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
final page = param1.toInt();
// Update page providers directly (repository jumpTo is a no-op now)
try {
container.read(currentPageProvider.notifier).state = page;
} catch (_) {}
try {
container.read(pdfViewModelProvider.notifier).jumpToPage(page);
} catch (_) {}
container.read(documentRepositoryProvider.notifier).jumpTo(page);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(

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

@ -4,7 +4,6 @@ import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user places two signature placements on the same page
@ -13,45 +12,20 @@ Future<void> theUserPlacesTwoSignaturePlacementsOnTheSamePage(
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// pdfViewModelProvider returns 1-based current page
final page = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
final page = pdf.currentPage;
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(10, 10, 100, 50),
asset: SignatureAsset(
bytes: Uint8List.fromList([
0x89,
0x50,
0x4E,
0x47,
0x0D,
0x0A,
0x1A,
0x0A,
]),
name: 'sig1.png',
),
asset: SignatureAsset(bytes: Uint8List(0), name: 'sig1.png'),
);
container
.read(documentRepositoryProvider.notifier)
.addPlacement(
page: page,
rect: Rect.fromLTWH(120, 10, 100, 50),
asset: SignatureAsset(
bytes: Uint8List.fromList([
0x89,
0x50,
0x4E,
0x47,
0x0D,
0x0A,
0x1A,
0x0A,
0x00,
]),
name: 'sig2.png',
),
asset: SignatureAsset(bytes: Uint8List(0), name: 'sig2.png'),
);
}

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

@ -7,17 +7,8 @@ Future<void> theUserPreviouslySetThemeAndLanguage(
String themeWrapped,
String languageWrapped,
) async {
String unwrap(String s) {
var r = s.trim();
if (r.startsWith('{') && r.endsWith('}')) {
r = r.substring(1, r.length - 1).trim();
}
if (r.startsWith("'") && r.endsWith("'")) {
r = r.substring(1, r.length - 1);
}
return r;
}
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

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

@ -1,7 +1,6 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import '_world.dart';
/// Usage: the user types {3} into the Go to input and presses Enter
@ -12,11 +11,6 @@ Future<void> theUserTypesIntoTheGoToInputAndPressesEnter(
final target = param1.toInt();
final c = TestWorld.container ?? ProviderContainer();
TestWorld.container = c;
try {
c.read(currentPageProvider.notifier).state = target;
} catch (_) {}
try {
c.read(pdfViewModelProvider.notifier).jumpToPage(target);
} catch (_) {}
c.read(documentRepositoryProvider.notifier).jumpTo(target);
await tester.pump();
}

9
test/features/step/the_user_uses_rotate_controls.dart
View File

@ -1,18 +1,19 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: the user uses rotate controls
Future<void> theUserUsesRotateControls(WidgetTester tester) async {
final container = TestWorld.container ?? ProviderContainer();
final pdf = container.read(documentRepositoryProvider);
final pdfN = container.read(documentRepositoryProvider.notifier);
final currentPage = container.read(pdfViewModelProvider);
final placements = pdfN.placementsOn(currentPage);
final placements = pdfN.placementsOn(pdf.currentPage);
if (placements.isNotEmpty) {
// Rotate the first placement by 45 degrees
pdfN.updatePlacementRotation(
page: currentPage,
page: pdf.currentPage,
index: 0,
rotationDeg: 45.0,
);

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

@ -6,7 +6,6 @@ import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/domain/models/model.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import '_world.dart';
/// Usage: three signature placements are placed on the current page
@ -15,7 +14,6 @@ Future<void> threeSignaturePlacementsArePlacedOnTheCurrentPage(
) async {
final container = TestWorld.container ?? ProviderContainer();
TestWorld.container = container;
// Reset repositories to a known initial state
container.read(signatureAssetRepositoryProvider.notifier).state = [];
container.read(documentRepositoryProvider.notifier).state =
Document.initial();
@ -26,7 +24,8 @@ Future<void> threeSignaturePlacementsArePlacedOnTheCurrentPage(
.read(documentRepositoryProvider.notifier)
.openPicked(path: 'mock.pdf', pageCount: 5);
final pdfN = container.read(documentRepositoryProvider.notifier);
final page = container.read(pdfViewModelProvider);
final pdf = container.read(documentRepositoryProvider);
final page = pdf.currentPage;
pdfN.addPlacement(
page: page,
rect: Rect.fromLTWH(10, 10, 50, 50),

10
test/widget/helpers.dart
View File

@ -9,7 +9,6 @@ import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/ui_services.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/data/repositories/signature_asset_repository.dart';
import 'package:pdf_signature/data/repositories/signature_card_repository.dart';
import 'package:pdf_signature/domain/models/signature_asset.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
@ -378,15 +377,6 @@ Future<void> pumpWithOpenPdfAndSig(WidgetTester tester) async {
repo.add(Uint8List.fromList(bytes), name: 'test');
return repo;
}),
signatureCardRepositoryProvider.overrideWith((ref) {
final cardRepo = SignatureCardStateNotifier();
final asset = SignatureAsset(
bytes: Uint8List.fromList(bytes),
name: 'test',
);
cardRepo.addWithAsset(asset, 0.0);
return cardRepo;
}),
// In new model, interactive overlay not implemented; keep library empty
useMockViewerProvider.overrideWithValue(true),
exportingProvider.overrideWith((ref) => false),

6
test/widget/navigation_test.dart
View File

@ -11,11 +11,11 @@ void main() {
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
await tester.tap(find.byKey(const Key('btn_next')));
await tester.pumpAndSettle();
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 2/5');
await tester.tap(find.byKey(const Key('btn_prev')));
await tester.pumpAndSettle();
await tester.pump();
expect((tester.widget<Text>(pageInfo)).data, 'Page 1/5');
});
@ -25,7 +25,7 @@ void main() {
final goto = find.byKey(const Key('txt_goto'));
await tester.enterText(goto, '4');
await tester.testTextInput.receiveAction(TextInputAction.done);
await tester.pumpAndSettle();
await tester.pump();
final pageInfo = find.byKey(const Key('lbl_page_info'));
expect((tester.widget<Text>(pageInfo)).data, 'Page 4/5');
});

6
test/widget/pdf_navigation_widget_test.dart
View File

@ -12,7 +12,11 @@ import 'package:pdf_signature/l10n/app_localizations.dart';
class _TestPdfController extends DocumentStateNotifier {
_TestPdfController() : super() {
// Start with a loaded multi-page doc, page 1 of 5
state = Document.initial().copyWith(loaded: true, pageCount: 5);
state = Document.initial().copyWith(
loaded: true,
pageCount: 5,
currentPage: 1,
);
}
}

14
test/widget/pdf_page_area_early_jump_test.dart
View File

@ -5,14 +5,17 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_page_area.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:pdf_signature/domain/models/model.dart';
class _TestPdfController extends DocumentStateNotifier {
_TestPdfController() : super() {
state = Document.initial().copyWith(loaded: true, pageCount: 6);
state = Document.initial().copyWith(
loaded: true,
pageCount: 6,
currentPage: 1,
);
}
}
@ -52,11 +55,8 @@ void main() {
),
);
// Jump to page 5 right away via view model
final ctx = tester.element(find.byType(PdfPageArea));
final container = ProviderScope.containerOf(ctx, listen: false);
final vm = container.read(pdfViewModelProvider.notifier);
vm.jumpToPage(5);
// Jump to page 5 right away
ctrl.jumpTo(5);
await tester.pump();
await tester.pumpAndSettle(const Duration(milliseconds: 600));

14
test/widget/pdf_page_area_jump_test.dart
View File

@ -5,14 +5,17 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_page_area.dart';
import 'package:pdf_signature/data/repositories/document_repository.dart';
import 'package:pdf_signature/ui/features/pdf/widgets/pdf_providers.dart';
import 'package:pdf_signature/ui/features/pdf/view_model/pdf_view_model.dart';
import 'package:pdf_signature/l10n/app_localizations.dart';
import 'package:pdf_signature/domain/models/model.dart';
class _TestPdfController extends DocumentStateNotifier {
_TestPdfController() : super() {
state = Document.initial().copyWith(loaded: true, pageCount: 6);
state = Document.initial().copyWith(
loaded: true,
pageCount: 6,
currentPage: 2,
);
}
}
@ -63,13 +66,9 @@ void main() {
double lastPixels =
tester.state<ScrollableState>(scrollableFinder).position.pixels;
final ctx = tester.element(find.byType(PdfPageArea));
final container = ProviderScope.containerOf(ctx, listen: false);
final vm = container.read(pdfViewModelProvider.notifier);
Future<void> jumpAndVerify(int targetPage) async {
final before = lastPixels;
vm.jumpToPage(targetPage);
ctrl.jumpTo(targetPage);
await tester.pump();
await tester.pumpAndSettle(const Duration(milliseconds: 600));
@ -93,7 +92,6 @@ void main() {
}
// Jump to 4 different pages and verify each
await jumpAndVerify(2);
await jumpAndVerify(5);
await jumpAndVerify(1);
await jumpAndVerify(6);

6
test/widget/pdf_page_area_test.dart
View File

@ -13,7 +13,11 @@ import 'package:pdf_signature/domain/models/model.dart';
class _TestPdfController extends DocumentStateNotifier {
_TestPdfController() : super() {
state = Document.initial().copyWith(loaded: true, pageCount: 6);
state = Document.initial().copyWith(
loaded: true,
pageCount: 6,
currentPage: 1,
);
}
}