filmopen_jobs_ui

A snapshot

This specification is a copy of docs/software/packages/filmopen_jobs_ui.md in the application’s repository, taken at commit 0b4fe88 of 11 November 2026. It is imported byte for byte and is not edited here; a change is made there, and arrives with the next snapshot.

Generated by scripts/package_digest.py; regenerate, never edit.

How a job looks: one row for a JobView — its name, its sentence, its progress and its actions — and two pages of the rail: Activity, which shows this device’s usage (a section the application hands in as a builder, since this package does not import the keys’) and then what is being added to the open film, from the insertion service, together with application-supplied unplaced attention, in one scroll view, and under them, while any is, Syncing: the open film’s files queued, being sent or fetched, or just done, each a line of its own with its name, a bar where its progress is measured and a check once done, logged activity.sync.rows as they change; and Share, what the open film is sending and receiving, from the sync service, in full with each job’s sentence and actions. Activity’s additions and Share’s rows are drawn through one row logic of the package’s own (job_lists.dart, not exported); Activity’s sync lines are its own, with no sentence or action, since Share acts on those jobs. A feature package: it draws JobViews and sends JobActions, knows nothing of the journal.

Flutter. 6 files, 836 lines under lib/; 58 tests in 4 files. Barrel: lib/filmopen_jobs_ui.dart.

Depends on

• filmopen_jobs — uses JobAction, JobPhase, JobView, Producer, describeJobError
• filmopen_state — uses BatchSelection, NavIndex, Settings, SettingsTab, browserProvider, insertionServiceProvider, kFilmOpenDomain, navIndexProvider, projectClosedProvider, projectProvider, settingsTabProvider, syncJobsProvider, syncServiceProvider, syncStatusProvider
• filmopen_store — uses AppLog, LogLevel
• filmopen_insertion — uses Function, InsertionService, producerFailureOf, producerJobKind
• filmopen_ui — uses Breakpoints, ChromeClearance, EmptyState
• filmopen_l10n — uses nothing by name the digest could see
• filmopen_format — uses EntityType, projectKeyOf
• filmopen_sync — uses SyncFile, SyncFileState, SyncStatus
• filmopen_test_support (dev) — uses nothing by name the digest could see

Third-party: flutter_riverpod.

Used by

filmopen_app

Public API

What the barrel exports, file by file. A name is class, enum, mixin, extension, typedef, a top-level function, getter, setter or variable; under a class, its public constructors, fields, getters, setters and methods.

lib/src/activity_page.dart

• class ActivityPage — The rail’s Activity, in two tabs: Now — this device’s usage, then the open film’s media being added — and Files, every file of the open film and where it stands against its cloud copy (§9.7).
  • const ActivityPage({super.key, this.usage}) — The page, with the application’s [usage] section first.
  • final WidgetBuilder? usage — Draws the usage section, which the page shows above the film’s jobs; none where it is null.

lib/src/job_row.dart

• function bool isSyncFetchKind(String kind) — Whether a job kind is one of the document or media receiving kinds.
• class JobRow — One job as a person reads it: what it is about, the sentence for its state, its progress and its actions.
  • const JobRow({super.key, required this.job, required this.onAction, this.cloud = false, this.onDetails}) — A row for [job], whose pressed actions go to [onAction].
  • final JobView job — The job the row draws.
  • final Future<void> Function(JobView job, JobAction action) onAction — What a pressed action does; the page decides, since a sign-in is not the engine’s to perform.
  • final bool cloud — Whether the job’s film is on FilmOpen Cloud, whose sign-in the row asks of the account, not of Google.
  • final VoidCallback? onDetails — What Details does, beside the job’s actions; no button where it is null (§6.15).

lib/src/share_page.dart

• class SharePage — The rail’s Share: the open film’s sends and receipts, newest first, with Dismiss finished above them (§9.7).
  • const SharePage({super.key, this.beforeSignIn, this.cancelSignIn}) — The page, with the application’s sign-in before a job’s signIn action and its cancellation.
  • final Future<bool> Function(JobView job)? beforeSignIn — What runs before a signIn action is sent to the job given; an answer of false sends nothing.
  • final void Function(JobView job)? cancelSignIn — What the wait line’s Cancel does while a sign-in waits, given the job whose press started it.

Internal

Files under lib/ the barrel does not reach; nothing outside the package may import them.

• lib/src/busy_actions.dart: BusyActions
• lib/src/job_lists.dart: JobLists