ux: bulk WIP — UxPlugin→XPlugin rename + new anim/core/navi/reactive packages

Catch-all commit for outstanding pre-existing local changes. Mixes
several themes that would normally be split:

- Rename: UxPlugin → XPlugin across iOS, macOS, Android registrants.
- New top-level packages under lib/src/: anim/ (animated values,
  panes, sheets, dock, measured), core/ (Emitter, ReactiveBuilder
  scaffolding, presenter/widget/value/dispose primitives), navi/
  (Screen/ScreenStack/Router/hero/transitions), reactive/.
- Edits across existing plugins (clipboard, crash, file, gallery,
  keyboard, scanner, sensor, url) to align with the new core.
- Test updates and CHANGELOG/README touches accompanying the above.
This commit is contained in:
agra
2026-05-21 08:58:07 +03:00
parent a508aca2bb
commit d68a2978eb
83 changed files with 5006 additions and 275 deletions

View File

@@ -5,14 +5,14 @@ import 'package:ux/ux.dart';
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
group('MethodChannelUxCameraBackend — arg/return parsing', () {
group('MethodChannelXCameraBackend — arg/return parsing', () {
const channel = MethodChannel('ux/camera');
late MethodChannelUxCameraBackend backend;
late MethodChannelXCameraBackend backend;
late List<MethodCall> calls;
setUp(() {
backend = MethodChannelUxCameraBackend();
backend = MethodChannelXCameraBackend();
calls = [];
});
@@ -39,10 +39,10 @@ void main() {
expect(calls.single.method, 'availableCameras');
expect(result, [
const UxCameraDescription(
id: 'a', lens: UxCameraLens.front, sensorOrientation: 270),
const UxCameraDescription(
id: 'b', lens: UxCameraLens.back, sensorOrientation: 90),
const XCameraDescription(
id: 'a', lens: XCameraLens.front, sensorOrientation: 270),
const XCameraDescription(
id: 'b', lens: XCameraLens.back, sensorOrientation: 90),
]);
});
@@ -57,7 +57,7 @@ void main() {
final result = await backend.create(
cameraId: 'cam-1',
enableAudio: true,
preset: UxResolutionPreset.high,
preset: XResolutionPreset.high,
);
expect(calls.single.method, 'create');
@@ -98,8 +98,8 @@ void main() {
test('setFlashMode encodes the enum', () async {
handle((_) => null);
await backend.setFlashMode(3, UxFlashMode.always);
await backend.setFlashMode(3, UxFlashMode.off);
await backend.setFlashMode(3, XFlashMode.always);
await backend.setFlashMode(3, XFlashMode.off);
expect(calls.map((c) => (c.arguments as Map)['mode']).toList(),
['always', 'off']);
@@ -180,11 +180,11 @@ void main() {
);
addTearDown(() => messenger.setMockStreamHandler(eventsChannel, null));
final received = <UxCameraEvent>[];
final received = <XCameraEvent>[];
await backend.events(4).forEach(received.add);
expect(received, hasLength(1));
final e = received.single as UxCameraDiagnostic;
final e = received.single as XCameraDiagnostic;
expect(e.handle, 4);
expect(e.message, 'video input added');
});
@@ -208,7 +208,7 @@ void main() {
);
});
test('PlatformException maps to UxCameraException carrying code/message',
test('PlatformException maps to XCameraException carrying code/message',
() async {
handle((_) => throw PlatformException(
code: 'device_busy',
@@ -217,7 +217,7 @@ void main() {
await expectLater(
backend.initialize(1),
throwsA(isA<UxCameraException>()
throwsA(isA<XCameraException>()
.having((e) => e.code, 'code', 'device_busy')
.having((e) => e.description, 'description', 'front camera in use')),
);

View File

@@ -50,7 +50,7 @@ void main() {
return null;
});
await UxCrash.drainAndReport();
await XCrash.drainAndReport();
final records = sink.snapshot();
expect(records.length, 2);
@@ -78,7 +78,7 @@ void main() {
throw MissingPluginException();
});
await UxCrash.drainAndReport();
await XCrash.drainAndReport();
expect(sink.snapshot(), isEmpty);
});
@@ -91,7 +91,7 @@ void main() {
throw PlatformException(code: 'oops');
});
await UxCrash.drainAndReport();
await XCrash.drainAndReport();
expect(sink.snapshot().length, 1);
expect(sink.snapshot().single.level, LogLevel.warn);

View File

@@ -6,11 +6,11 @@ import 'package:ux/ux.dart';
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
group('UxGallery facade — method channel parsing', () {
group('XGallery facade — method channel parsing', () {
const channel = MethodChannel('ux/gallery');
setUp(() {
UxGallery.backend = MethodChannelGalleryBackend();
XGallery.backend = MethodChannelGalleryBackend();
});
tearDown(() {
@@ -25,17 +25,17 @@ void main() {
return 'granted';
});
expect(await UxGallery.permission(), UxGalleryPermission.granted);
expect(await XGallery.permission(), XGalleryPermission.granted);
});
test('permission() falls back to denied on unknown values', () async {
TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
.setMockMethodCallHandler(channel, (_) async => 'mystery');
expect(await UxGallery.permission(), UxGalleryPermission.denied);
expect(await XGallery.permission(), XGalleryPermission.denied);
});
test('albums() decodes a list of UxAlbum', () async {
test('albums() decodes a list of XAlbum', () async {
TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger
.setMockMethodCallHandler(channel, (call) async {
expect(call.method, 'albums');
@@ -56,12 +56,12 @@ void main() {
];
});
final albums = await UxGallery.albums();
final albums = await XGallery.albums();
expect(albums, hasLength(2));
expect(albums[0].id, 'recents');
expect(albums[0].count, 1234);
expect(albums[0].coverKind, UxAssetKind.image);
expect(albums[1].coverKind, UxAssetKind.video);
expect(albums[0].coverKind, XAssetKind.image);
expect(albums[1].coverKind, XAssetKind.video);
});
test('assets() decodes durations and timestamps', () async {
@@ -85,14 +85,14 @@ void main() {
];
});
final assets = await UxGallery.assets(
final assets = await XGallery.assets(
albumId: 'recents',
filter: UxAssetKind.video,
filter: XAssetKind.video,
start: 0,
end: 60,
);
expect(assets, hasLength(1));
expect(assets.single.kind, UxAssetKind.video);
expect(assets.single.kind, XAssetKind.video);
expect(assets.single.duration, const Duration(milliseconds: 8500));
expect(assets.single.createdAt.millisecondsSinceEpoch, 1700000000000);
});
@@ -111,76 +111,76 @@ void main() {
};
});
final thumb = await UxGallery.thumbnail('a1', sizePx: 381);
final thumb = await XGallery.thumbnail('a1', sizePx: 381);
expect(thumb.bytes, [1, 2, 3]);
expect(thumb.width, 381);
expect(thumb.height, 254);
});
});
group('FakeUxGalleryBackend', () {
group('FakeXGalleryBackend', () {
test('requestPermission flips state to granted by default', () async {
final fake = FakeUxGalleryBackend(
permissionState: UxGalleryPermission.notDetermined,
final fake = FakeXGalleryBackend(
permissionState: XGalleryPermission.notDetermined,
);
UxGallery.backend = fake;
XGallery.backend = fake;
expect(await UxGallery.permission(),
UxGalleryPermission.notDetermined);
expect(await UxGallery.requestPermission(),
UxGalleryPermission.granted);
expect(await UxGallery.permission(), UxGalleryPermission.granted);
expect(await XGallery.permission(),
XGalleryPermission.notDetermined);
expect(await XGallery.requestPermission(),
XGalleryPermission.granted);
expect(await XGallery.permission(), XGalleryPermission.granted);
});
test('assets honours the (start, end) page window per album', () async {
final pile = [
for (var i = 0; i < 50; i++)
UxAsset(
XAsset(
id: 'a$i',
kind: UxAssetKind.image,
kind: XAssetKind.image,
width: 100,
height: 100,
createdAt: DateTime.fromMillisecondsSinceEpoch(i * 1000),
),
];
final fake = FakeUxGalleryBackend(
final fake = FakeXGalleryBackend(
recents: pile,
assetsByAlbum: {'all': pile},
);
UxGallery.backend = fake;
XGallery.backend = fake;
final firstPage = await UxGallery.assets(start: 0, end: 10);
final firstPage = await XGallery.assets(start: 0, end: 10);
expect(firstPage.map((a) => a.id), [
for (var i = 0; i < 10; i++) 'a$i',
]);
final tail = await UxGallery.assets(albumId: 'all', start: 45, end: 999);
final tail = await XGallery.assets(albumId: 'all', start: 45, end: 999);
expect(tail, hasLength(5));
final past = await UxGallery.assets(start: 200, end: 210);
final past = await XGallery.assets(start: 200, end: 210);
expect(past, isEmpty);
});
test('assets filters by kind when requested', () async {
final mix = [
UxAsset(
XAsset(
id: 'p',
kind: UxAssetKind.image,
kind: XAssetKind.image,
width: 1,
height: 1,
createdAt: DateTime(2024),
),
UxAsset(
XAsset(
id: 'v',
kind: UxAssetKind.video,
kind: XAssetKind.video,
duration: const Duration(seconds: 3),
width: 1,
height: 1,
createdAt: DateTime(2024),
),
];
UxGallery.backend = FakeUxGalleryBackend(recents: mix);
XGallery.backend = FakeXGalleryBackend(recents: mix);
final justVideos = await UxGallery.assets(
filter: UxAssetKind.video,
final justVideos = await XGallery.assets(
filter: XAssetKind.video,
start: 0,
end: 10,
);

View File

@@ -2,15 +2,15 @@ import 'package:flutter_test/flutter_test.dart';
import 'package:ux/ux.dart';
void main() {
test('UxKeyboard.instance is a singleton', () {
expect(UxKeyboard.instance, same(UxKeyboard.instance));
test('XKeyboard.instance is a singleton', () {
expect(XKeyboard.instance, same(XKeyboard.instance));
});
test('UxKeyboard.height starts at 0', () {
expect(UxKeyboard.instance.height, 0);
test('XKeyboard.height starts at 0', () {
expect(XKeyboard.instance.height, 0);
});
test('UxKeyboard.isOpen is false when height is 0', () {
expect(UxKeyboard.instance.isOpen, false);
test('XKeyboard.isOpen is false when height is 0', () {
expect(XKeyboard.instance.isOpen, false);
});
}