import 'package:camera_extended/camera_extended.dart';

CameraController(
  CameraDescription description,
  ResolutionPreset resolutionPreset, {
  bool enableAudio = true,
  int? fps,
  int? videoBitrate,
  int? audioBitrate,
  CameraAspectRatio aspectRatio = CameraAspectRatio.ratioDefault,
  ImageFormatGroup? imageFormatGroup,
})

// The aspect ratio this controller targets at the sensor level.
CameraAspectRatio get targetAspectRatio; // => mediaSettings.aspectRatio

// The full media settings (resolution, fps, bitrates, audio, aspectRatio).
final MediaSettings mediaSettings;

enum CameraAspectRatio {
  ratio16x9,    // 16:9 widescreen — standard for HD video
  ratio4x3,     // 4:3 standard — more vertical field of view
  ratio1x1,     // 1:1 square — widest horizontal field of view on most sensors
  ratioDefault, // camera's default ratio — typically 4:3 on mobile
}

// Defined in camera_extended_platform_interface.
extension CameraAspectRatioExtension on CameraAspectRatio {
  double get value;   // 16/9, 4/3, 1.0, 4/3 (for ratioDefault)
  String get label;   // '16:9', '4:3', '1:1', 'Default'
  bool get isSquare;  // true only for ratio1x1
  String serialize(); // 'ratio16x9' | 'ratio4x3' | 'ratio1x1' | 'ratioDefault'

  static CameraAspectRatio deserialize(String value);
}

Future<Uint8List> takePictureAsBytes();

final Uint8List bytes = await controller.takePictureAsBytes();

// Use the JPEG-encoded bytes directly — no file I/O.
await api.uploadImage(bytes);

enum VideoStabilizationMode {
  off,     // stabilization disabled
  level1,  // least stabilized, least latency
  level2,  // more stabilized, more latency
  level3,  // most stabilized, most latency
}

// Query the modes this device actually supports.
// The list may be empty when the platform has no support.
Future<Iterable<VideoStabilizationMode>>
    getSupportedVideoStabilizationModes();

// Apply a mode. When [allowFallback] is true (default) and [mode] is
// unsupported, the controller walks down to a lower supported level;
// with allowFallback: false it throws an ArgumentError instead.
Future<void> setVideoStabilizationMode(
  VideoStabilizationMode mode, {
  bool allowFallback = true,
});

const MediaSettings({
  ResolutionPreset? resolutionPreset,
  int? fps,          // must be null or > 0
  int? videoBitrate, // must be null or > 0
  int? audioBitrate, // must be null or > 0
  bool enableAudio = false,
  CameraAspectRatio aspectRatio = CameraAspectRatio.ratioDefault,
})

class CameraPreview extends StatelessWidget {
  const CameraPreview(this.controller, {super.key, this.child});

  final CameraController controller; // an initialized controller
  final Widget? child;               // optional overlay on top of the preview
}

Future<List<CameraDescription>> availableCameras();