flea-qml 0.0.0-stage → 0.1.0

package/ui/js/Update.js

@@ -0,0 +1,130 @@
+.pragma library
+
+.import "Format.js" as Format
+
+// The updater's row state and every word it shows, pure so tests/js/update.js drives it without a window; ui/UpdateCheck.qml runs the processes.
+
+// The background poll's period, which is also how long a finished check stands before Settings > About asks again.
+var INTERVAL_MS = 6 * 60 * 60 * 1000
+// The first background look, a minute after the window opens: off the launch path, and early enough for the menu row.
+var FIRST_CHECK_MS = 60 * 1000
+
+// Every word the About row, its note line and the footer use, in one table so a restyle touches nothing else.
+var WORDS = {
+    check: "Check",
+    checking: "Checking",
+    available: "%1 available",
+    current: "Up to date · %1",
+    failed: "Could not check",
+    launched: "Updating in terminal",
+    source: "Built from source",
+    noteLaunched: "Restart Flea when the update finishes",
+    noteFailed: "Offline: Omarchy update still opens",
+    noteSource: "Built locally: rebuild from the checkout",
+    opening: "Opening Omarchy update · restart Flea when it finishes",
+    launchFailed: "Omarchy's updater could not be started."
+}
+
+// The four words `flea --update check` prints first, see src/update.rs; anything else is a check that failed.
+var ANSWERS = ["available", "current", "failed", "unchecked"]
+
+function idle() {
+    return { state: "idle", kind: "", installed: "", latest: "", checkedAt: 0 }
+}
+
+function copy(status, changes) {
+    return Object.assign({}, status, changes)
+}
+
+function checking(status) {
+    return copy(status, { state: "checking" })
+}
+
+// Sample input: "available opr 0.3.2-1 0.3.3-1\n", the one line src/update.rs prints.
+function answered(status, text, now) {
+    // A launch is final until Flea restarts: a check that was already running when it began changes nothing.
+    if (status.state === "launched")
+        return status
+    var words = String(text || "").trim().split(" ")
+    var known = words.length === 4 && ANSWERS.indexOf(words[0]) >= 0
+    return copy(status, { state: known ? words[0] : "failed", kind: known ? words[1] : "",
+                          installed: known && words[2] !== "-" ? words[2] : "",
+                          latest: known && words[3] !== "-" ? words[3] : "", checkedAt: now })
+}
+
+// A launch hands the machine to Omarchy until Flea restarts; one that failed leaves the row as it was.
+function launchedFrom(status, started) {
+    return started ? copy(status, { state: "launched" }) : status
+}
+
+// What the About row's Enter does: check, launch Omarchy's updater, or nothing while a check or an update runs.
+function onActivate(status) {
+    switch (status.state) {
+    case "idle": case "current": return "check"
+    case "available": case "failed": return "launch"
+    }
+    return ""
+}
+
+// The chevron: drawn exactly when Enter does something.
+function acts(status) {
+    return onActivate(status) !== ""
+}
+
+// A local build has nothing to check or launch, so its row is a fact.
+function isFact(status) {
+    return status.state === "unchecked"
+}
+
+// About opening asks again unless the switch is off, a check or an update is running, or an answer from the last period stands.
+function due(status, now, automatic) {
+    if (!automatic || status.state === "checking" || status.state === "launched")
+        return false
+    var settled = status.state === "available" || status.state === "current" || status.state === "unchecked"
+    return !settled || now - status.checkedAt >= INTERVAL_MS
+}
+
+// pkgver alone, unless that is what is installed and only the package release moved.
+function shownVersion(latest, installed) {
+    var version = latest.split("-")[0]
+    return version === installed.split("-")[0] ? latest : version
+}
+
+function value(status) {
+    switch (status.state) {
+    case "checking": return WORDS.checking
+    case "available": return Format.fill(WORDS.available, shownVersion(status.latest, status.installed))
+    case "current": return Format.fill(WORDS.current, status.installed.split("-")[0])
+    case "failed": return WORDS.failed
+    case "launched": return WORDS.launched
+    case "unchecked": return WORDS.source
+    }
+    return WORDS.check
+}
+
+// The value's colour role in ui/SettingsRow.qml: accent for an update, muted while checking, foreground otherwise.
+function role(status) {
+    if (status.state === "available")
+        return "accent"
+    return status.state === "checking" ? "" : "live"
+}
+
+// The line under the Updates group, as [words, role], or null in the states that need no explanation.
+function note(status) {
+    switch (status.state) {
+    case "launched": return [WORDS.noteLaunched, "accent"]
+    case "failed": return [WORDS.noteFailed, "foreground"]
+    case "unchecked": return [WORDS.noteSource, "foreground"]
+    }
+    return null
+}
+
+// The background menu's row exists only while a newer build is known, and its hint is that version.
+function menuVersion(status) {
+    return status.state === "available" ? shownVersion(status.latest, status.installed) : ""
+}
+
+// What the footer says after a launch, as [sentence, isError].
+function launchSentence(started) {
+    return started ? [WORDS.opening, false] : [WORDS.launchFailed, true]
+}

package/ui/js/UserDirs.js

@@ -0,0 +1,56 @@
+.pragma library
+
+// Sample input: XDG_DOWNLOAD_DIR="$HOME/Photo\"Inbox" # local inbox
+function parseLine(line, home) {
+    var kv = String(line || "").match(/^[ \t]*XDG_([A-Z]+)_DIR[ \t]*=([\s\S]*)$/)
+    if (!kv)
+        return null
+    var value = kv[2].match(/^[ \t]*"(\$HOME(?=\/|"))?((?:\\[\s\S]|[^"\\])*)"/)
+    var path = null
+    if (value && (value[1] || value[2].charAt(0) === "/")) {
+        path = (value[1] ? home : "") + value[2].replace(/\\([\s\S])/g, "$1")
+        path = path.replace(/\/+$/, "")
+        if (path.charAt(0) !== "/")
+            path = null
+    }
+    return { role: kv[1], path: path }
+}
+
+// Sample input: XDG_DOWNLOAD_DIR="$HOME/Old" then XDG_DOWNLOAD_DIR="$HOME/Inbox"; the last valid path wins.
+function readRoles(body, home) {
+    var roles = []
+    var paths = {}
+    var lines = String(body || "").split("\n")
+    for (var i = 0; i < lines.length; i++) {
+        var entry = parseLine(lines[i], home)
+        if (!entry)
+            continue
+        if (roles.indexOf(entry.role) < 0)
+            roles.push(entry.role)
+        if (entry.path)
+            paths[entry.role] = entry.path
+    }
+    var out = []
+    for (var r = 0; r < roles.length; r++) {
+        if (paths[roles[r]] !== undefined)
+            out.push({ role: roles[r], path: paths[roles[r]] })
+    }
+    return out
+}
+
+// Sample input: XDG_DOWNLOAD_DIR="$HOME/Downloads".
+function userDirs(body, home) {
+    var out = []
+    var entries = readRoles(body, home)
+    for (var i = 0; i < entries.length; i++) {
+        // A disabled role points at Home, which is not a separate place or a default-sort folder.
+        if (entries[i].path !== home)
+            out.push({ path: entries[i].path, label: leaf(entries[i].path) })
+    }
+    return out
+}
+
+function leaf(path) {
+    var cut = path.lastIndexOf("/")
+    return cut < 0 ? path : path.substring(cut + 1)
+}

package/ui/qmldir

@@ -0,0 +1,228 @@
+module flea
+RowDropTarget 1.0 RowDropTarget.qml
+TrashDropHandler 1.0 TrashDropHandler.qml
+singleton Theme 1.0 Theme.qml
+ThemeColors 1.0 ThemeColors.qml
+singleton Glass 1.0 Glass.qml
+GlassTagger 1.0 GlassTagger.qml
+singleton MediaSound 1.0 MediaSound.qml
+singleton Scripts 1.0 Scripts.qml
+singleton ViewState 1.0 ViewState.qml
+singleton UserDirs 1.0 UserDirs.qml
+singleton UpdateCheck 1.0 UpdateCheck.qml
+singleton DefaultClaim 1.0 DefaultClaim.qml
+singleton SettingsMetrics 1.0 SettingsMetrics.qml
+Backend 1.0 Backend.qml
+CheckBox 1.0 CheckBox.qml
+ChromeBar 1.0 ChromeBar.qml
+ChromeButton 1.0 ChromeButton.qml
+ChromeModes 1.0 ChromeModes.qml
+ColumnsArea 1.0 ColumnsArea.qml
+ColumnsLanding 1.0 ColumnsLanding.qml
+ColumnPane 1.0 ColumnPane.qml
+ColumnRow 1.0 ColumnRow.qml
+CountedWorker 1.0 CountedWorker.qml
+Crumb 1.0 Crumb.qml
+CursorMark 1.0 CursorMark.qml
+PreviewColumn 1.0 PreviewColumn.qml
+CodeLines 1.0 CodeLines.qml
+CompareView 1.0 CompareView.qml
+CodeRefusal 1.0 CodeRefusal.qml
+CsvTable 1.0 CsvTable.qml
+PreviewLines 1.0 PreviewLines.qml
+PreviewScroll 1.0 PreviewScroll.qml
+PreviewMarkdown 1.0 PreviewMarkdown.qml
+WebPreview 1.0 WebPreview.qml
+PreviewHtml 1.0 PreviewHtml.qml
+HtmlPane 1.0 HtmlPane.qml
+HtmlClip 1.0 HtmlClip.qml
+MarkdownSource 1.0 MarkdownSource.qml
+MarkdownRemote 1.0 MarkdownRemote.qml
+QuickLookBar 1.0 QuickLookBar.qml
+MarkdownPane 1.0 MarkdownPane.qml
+FontPane 1.0 FontPane.qml
+MarkdownText 1.0 MarkdownText.qml
+MarkdownPictures 1.0 MarkdownPictures.qml
+MarkdownImages 1.0 MarkdownImages.qml
+MarkdownMathsText 1.0 MarkdownMathsText.qml
+MarkdownQuote 1.0 MarkdownQuote.qml
+MarkdownList 1.0 MarkdownList.qml
+MarkdownBlocks 1.0 MarkdownBlocks.qml
+MarkdownBlockView 1.0 MarkdownBlockView.qml
+MarkdownTable 1.0 MarkdownTable.qml
+MarkdownTableScroll 1.0 MarkdownTableScroll.qml
+MarkdownTableWheel 1.0 MarkdownTableWheel.qml
+MarkdownFigure 1.0 MarkdownFigure.qml
+singleton FigureService 1.0 FigureService.qml
+PreviewPdf 1.0 PreviewPdf.qml
+PreviewSwap 1.0 PreviewSwap.qml
+PreviewImage 1.0 PreviewImage.qml
+PreviewImagePan 1.0 PreviewImagePan.qml
+PreviewImageSharp 1.0 PreviewImageSharp.qml
+PreviewAnimation 1.0 PreviewAnimation.qml
+ConvertDialog 1.0 ConvertDialog.qml
+BulkOldNames 1.0 BulkOldNames.qml
+BulkRenameDialog 1.0 BulkRenameDialog.qml
+DialogButton 1.0 DialogButton.qml
+ProtocolChip 1.0 ProtocolChip.qml
+DialogField 1.0 DialogField.qml
+DialogHeader 1.0 DialogHeader.qml
+DialogScrim 1.0 DialogScrim.qml
+DialogTitle 1.0 DialogTitle.qml
+Divider 1.0 Divider.qml
+EscapeHint 1.0 EscapeHint.qml
+ContextMenu 1.0 ContextMenu.qml
+MenuHost 1.0 MenuHost.qml
+KeymapSheet 1.0 KeymapSheet.qml
+KeymapSheetResult 1.0 KeymapSheetResult.qml
+SettingsPanel 1.0 SettingsPanel.qml
+SettingsPane 1.0 SettingsPane.qml
+SettingsRail 1.0 SettingsRail.qml
+SettingsRow 1.0 SettingsRow.qml
+SettingsGroup 1.0 SettingsGroup.qml
+SettingsHint 1.0 SettingsHint.qml
+SettingsRuler 1.0 SettingsRuler.qml
+SettingsSegment 1.0 SettingsSegment.qml
+MediaSession 1.0 MediaSession.qml
+MediaStrip 1.0 MediaStrip.qml
+MediaTrack 1.0 MediaTrack.qml
+MediaVolume 1.0 MediaVolume.qml
+MenuRow 1.0 MenuRow.qml
+MenuEdgeFade 1.0 MenuEdgeFade.qml
+RenameField 1.0 RenameField.qml
+EmptyState 1.0 EmptyState.qml
+FastScrollHandler 1.0 FastScrollHandler.qml
+ViewportScrollBar 1.0 ViewportScrollBar.qml
+ViewportScrollBars 1.0 ViewportScrollBars.qml
+CardScroll 1.0 CardScroll.qml
+CardFrame 1.0 CardFrame.qml
+Reveal 1.0 Reveal.qml
+FlyoutFade 1.0 FlyoutFade.qml
+DeviceMounts 1.0 DeviceMounts.qml
+DropboxMark 1.0 DropboxMark.qml
+HyprlandMark 1.0 HyprlandMark.qml
+DropInto 1.0 DropInto.qml
+FileDrag 1.0 FileDrag.qml
+FitMetrics 1.0 FitMetrics.qml
+RowDrag 1.0 RowDrag.qml
+WindowDrag 1.0 WindowDrag.qml
+Glyph 1.0 Glyph.qml
+LangMark 1.0 LangMark.qml
+GlyphSolid 1.0 GlyphSolid.qml
+GvfsBridge 1.0 GvfsBridge.qml
+GridTile 1.0 GridTile.qml
+GridArea 1.0 GridArea.qml
+Header 1.0 Header.qml
+Ipc 1.0 Ipc.qml
+IpcControls 1.0 IpcControls.qml
+IpcMenuState 1.0 IpcMenuState.qml
+IpcPreviewState 1.0 IpcPreviewState.qml
+List 1.0 List.qml
+MatchText 1.0 MatchText.qml
+PathJump 1.0 PathJump.qml
+JumpPath 1.0 JumpPath.qml
+LoadingState 1.0 LoadingState.qml
+NetworkDialog 1.0 NetworkDialog.qml
+NetworkForm 1.0 NetworkForm.qml
+NetworkMounts 1.0 NetworkMounts.qml
+NetworkPlaces 1.0 NetworkPlaces.qml
+MountListing 1.0 MountListing.qml
+PhoneMounts 1.0 PhoneMounts.qml
+FleaMark 1.0 FleaMark.qml
+Opener 1.0 Opener.qml
+Preview 1.0 Preview.qml
+PreviewArchive 1.0 PreviewArchive.qml
+PreviewFacts 1.0 PreviewFacts.qml
+PreviewFactsLine 1.0 PreviewFactsLine.qml
+PreviewMedia 1.0 PreviewMedia.qml
+QuickLookPrepare 1.0 QuickLookPrepare.qml
+QuickLookWarm 1.0 QuickLookWarm.qml
+QuickLookSwap 1.0 QuickLookSwap.qml
+QuickLookArchive 1.0 QuickLookArchive.qml
+PreviewText 1.0 PreviewText.qml
+Row 1.0 Row.qml
+ResizeHandle 1.0 ResizeHandle.qml
+PreviewEdge 1.0 PreviewEdge.qml
+Pane 1.0 Pane.qml
+PickerBox 1.0 PickerBox.qml
+PickerChrome 1.0 PickerChrome.qml
+PickerGrid 1.0 PickerGrid.qml
+PickerHeader 1.0 PickerHeader.qml
+PickerList 1.0 PickerList.qml
+PickerSelection 1.0 PickerSelection.qml
+PickerPlaces 1.0 PickerPlaces.qml
+PickerRecent 1.0 PickerRecent.qml
+PickerSave 1.0 PickerSave.qml
+PickerAnswers 1.0 PickerAnswers.qml
+PickerFilter 1.0 PickerFilter.qml
+PickerPathBar 1.0 PickerPathBar.qml
+PathEntry 1.0 PathEntry.qml
+PanePath 1.0 PanePath.qml
+PaneRail 1.0 PaneRail.qml
+PaneWire 1.0 PaneWire.qml
+PaneSwap 1.0 PaneSwap.qml
+ParkedWait 1.0 ParkedWait.qml
+ShareBrowser 1.0 ShareBrowser.qml
+Sidebar 1.0 Sidebar.qml
+SidebarRow 1.0 SidebarRow.qml
+RailDrop 1.0 RailDrop.qml
+RailTrashRow 1.0 RailTrashRow.qml
+DropTarget 1.0 DropTarget.qml
+Spinner 1.0 Spinner.qml
+SearchStrip 1.0 SearchStrip.qml
+FilterStrip 1.0 FilterStrip.qml
+ShareLink 1.0 ShareLink.qml
+StateMessage 1.0 StateMessage.qml
+TailscaleMark 1.0 TailscaleMark.qml
+StatusBar 1.0 StatusBar.qml
+StableModel 1.0 StableModel.qml
+PrebuildDriver 1.0 PrebuildDriver.qml
+SelectionBand 1.0 SelectionBand.qml
+TabBar 1.0 TabBar.qml
+TabDragGeometry 1.0 TabDragGeometry.qml
+TransferCard 1.0 TransferCard.qml
+Taildrop 1.0 Taildrop.qml
+LocalSend 1.0 LocalSend.qml
+LocalSendMark 1.0 LocalSendMark.qml
+FactsTable 1.0 FactsTable.qml
+KindStack 1.0 KindStack.qml
+AboutFacts 1.0 AboutFacts.qml
+SelectionPreview 1.0 SelectionPreview.qml
+PermissionsDialog 1.0 PermissionsDialog.qml
+PermissionsHeadings 1.0 PermissionsHeadings.qml
+singleton Favourites 1.0 Favourites.qml
+singleton RailPlaces 1.0 RailPlaces.qml
+singleton ShelfPins 1.0 ShelfPins.qml
+SettingsFavourite 1.0 SettingsFavourite.qml
+TrashView 1.0 TrashView.qml
+TrashConfirm 1.0 TrashConfirm.qml
+TagSlot 1.0 TagSlot.qml
+TagSwatch 1.0 TagSwatch.qml
+RailHeading 1.0 RailHeading.qml
+TagState 1.0 TagState.qml
+TagRailSection 1.0 TagRailSection.qml
+TagMenuMark 1.0 TagMenuMark.qml
+CollideConfirm 1.0 CollideConfirm.qml
+CollideHost 1.0 CollideHost.qml
+RunCard 1.0 RunCard.qml
+FatNamesConfirm 1.0 FatNamesConfirm.qml
+TrashMonitor 1.0 TrashMonitor.qml
+TrashHost 1.0 TrashHost.qml
+FlashView 1.0 FlashView.qml
+FlashHost 1.0 FlashHost.qml
+FlashImageRow 1.0 FlashImageRow.qml
+FlashDriveRows 1.0 FlashDriveRows.qml
+FlashStepRow 1.0 FlashStepRow.qml
+FlashRunner 1.0 FlashRunner.qml
+FlashStrip 1.0 FlashStrip.qml
+UnlockDialog 1.0 UnlockDialog.qml
+UnlockHost 1.0 UnlockHost.qml
+DeviceLock 1.0 DeviceLock.qml
+PaneMenuActions 1.0 PaneMenuActions.qml
+PaneStates 1.0 PaneStates.qml
+MenuActionDialog 1.0 MenuActionDialog.qml
+PickerListing 1.0 PickerListing.qml
+PickerLifecycle 1.0 PickerLifecycle.qml
+ArchiveCompressDialog 1.0 ArchiveCompressDialog.qml
+ArchivePasswordDialog 1.0 ArchivePasswordDialog.qml
+ArchiveCards 1.0 ArchiveCards.qml