re_ucm_lib

class SettingsService {
  // Initialize service with database directory
  static Future<SettingsService> init(String databaseDirectory) async
  
  // Download path template for books
  PathTemplate get downloadPathTemplate;
  
  // Separator used between multiple authors
  String get authorsPathSeparator;
  
  // Optional custom save directory
  String? get saveDirectory;
  
  // All portal sessions
  List<PortalSession> get sessions;
  
  // Get session by portal code
  PortalSession sessionByCode(String code);
  
  // Update settings
  void updateDownloadPathTemplate(PathTemplate template);
  void updateAuthorsPathSeparator(String separator);
  void updateSaveDirectory(String? path);
}

// Initialize the service
final settingsService = await SettingsService.init('/app/data');

// Access portal sessions
final authorTodaySession = settingsService.sessionByCode('author_today');

// Update download path template
final template = PathTemplate(
  path: '⦘Авторы⦗/⦘Название⦗',
  seriesPath: '⦘Авторы⦗/⦘Серия⦗/⦘Название⦗',
);
settingsService.updateDownloadPathTemplate(template);

class RecentBooksService {
  // Initialize service with database directory
  static Future<RecentBooksService> init(String databaseDirectory) async
  
  // Observable list of recent books
  final recentBooks = <RecentBook>[].asObservable();
  
  // Add a book to recent books
  Future<void> addRecentBook(Book book) async
  
  // Remove a book from recent books
  Future<void> removeRecentBook(RecentBook book) async
  
  // Restore a previously removed book
  Future<void> restoreRecentBook(RecentBook book) async
}

final recentBooksService = await RecentBooksService.init('/app/data');

// Add a book when user views it
await recentBooksService.addRecentBook(book);

// Remove a book
await recentBooksService.removeRecentBook(recentBook);

// Observe changes in Flutter with flutter_mobx
Observer(
  builder: (_) => ListView.builder(
    itemCount: recentBooksService.recentBooks.length,
    itemBuilder: (context, index) {
      final book = recentBooksService.recentBooks[index];
      return ListTile(title: Text(book.title));
    },
  ),
)

class PortalFactory {
  // Register a portal
  static void registerPortal(Portal portal)
  
  // Register multiple portals
  static void registerAll(List<Portal> portals)
  
  // Get all registered portals
  static List<Portal> get portals
  
  // Lookup portal by code
  static Portal fromCode(String code)
  
  // Lookup portal by URL
  static Portal fromUrl(Uri uri)
  
  // JSON serialization helpers
  static Portal fromJson(Map<String, dynamic> json)
  static Map<String, dynamic> toJson(Portal portal)
}

// Register portals at app startup
PortalFactory.registerAll([AuthorToday(), FicBook(), LitNet()]);

// Lookup portal from URL
final url = Uri.parse('https://author.today/work/12345');
final portal = PortalFactory.fromUrl(url);

// Get all available portals
final allPortals = PortalFactory.portals;

class PortalSession<T extends PortalSettings> {
  final Portal<T> portal;
  
  // Observable settings
  @observable
  late T settings;
  
  // Computed authorization status
  @computed
  bool get isAuthorized;
  
  // Computed settings schema for UI
  @computed
  List<PortalSettingItem> get schema;
  
  // Portal properties
  String get url;
  String get name;
  String get code;
  PortalLogo get logo;
  PortalService<T> get service;
  
  // Update settings and persist
  Future<void> updateSettings(T newSettings) async
  
  // Reset temporary flags in settings
  void resetTempFlags()
  
  // Fetch book data
  Future<Book> getBook(String id)
  Future<List<Chapter>> getText(String id)
}

final session = settingsService.sessionByCode('author_today');

// Check authorization
if (!session.isAuthorized) {
  // Show login UI
}

// Fetch book
final book = await session.getBook('12345');
final chapters = await session.getText('12345');

// Update settings
final newSettings = AuthorTodaySettings(sessionCookie: 'new_token');
await session.updateSettings(newSettings);

class RecentBook {
  final String id;
  final String title;
  final String authors;
  final String? coverUrl;
  final String? seriesName;
  final int? seriesNumber;
  final Portal portal;
  final DateTime added;
}

class PathTemplate {
  final String path;        // Template for standalone books
  final String seriesPath;  // Template for books in a series
  
  factory PathTemplate.initial();  // Default template
}

enum PathPlaceholders {
  name('Название'),           // Book title
  series('Серия'),            // Series name
  seriesNumber('Номер в серии'),  // Number in series
  authors('Авторы'),          // Authors list
  portal('Портал');           // Portal name
  
  // Resolve placeholder value for a book
  String resolve(Book data, String authorsSeparator);
}

class TemplateFormatter {
  // Special brackets used for placeholders
  static const String startTagChar = '⦘';  // U+2998
  static const String endTagChar = '⦗';    // U+2997
  
  // Build filename from template and book data
  static String buildTemplateFileName(Book data, SettingsService settings)
  
  // Render template with book data
  static String renderTemplate(
    String template,
    Book data,
    SettingsService settings,
  )
}

// Template: "⦘Авторы⦗/⦘Серия⦗ — ⦘Номер в серии⦗"
// Result: "John Doe/Fantasy Series — 3"

final filename = TemplateFormatter.buildTemplateFileName(book, settings);
// Illegal filename characters are replaced with underscores