@rightkit/system-ui 0.0.0-stage → 0.1.0

package/dist/onboarding/flow.js

@@ -0,0 +1,81 @@
+import { invoke } from "@tauri-apps/api/core";
+import { onboardingSettings } from "../lib/onboardingSettings.js";
+// The window's own progress, kept in the hub's `hub-onboarding.json` document beside the shared component's record
+// (`onboarding.state`: step, completed, a copy of the legal receipt). One versioned object holds the draft choices, the access
+// choices and the commit status, saved after every change, so closing the window or restarting loses nothing.
+export const FLOW_KEY = "pulseFlow";
+export const FLOW_VERSION = 1;
+export const freshFlow = (first) => ({ version: FLOW_VERSION, first, draft: {}, deferred: [], commit: { status: "idle", failed: {} } });
+export async function loadFlow() {
+    try {
+        const snapshot = await onboardingSettings.load();
+        const raw = snapshot.values[FLOW_KEY];
+        if (!raw || raw.version !== FLOW_VERSION || typeof raw.first !== "boolean")
+            return null;
+        const commit = raw.commit && typeof raw.commit === "object" ? raw.commit : undefined;
+        return {
+            version: FLOW_VERSION,
+            first: raw.first,
+            draft: raw.draft && typeof raw.draft === "object" ? raw.draft : {},
+            deferred: Array.isArray(raw.deferred) ? raw.deferred.filter((id) => typeof id === "string") : [],
+            // A run interrupted mid-write is unfinished, not done.
+            commit: { status: commit?.status === "done" ? "done" : commit?.status === "partial" ? "partial" : "idle", failed: commit?.failed ?? {} },
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveFlow(flow) {
+    await onboardingSettings.patch({ [FLOW_KEY]: flow });
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export async function readSettings() {
+    try {
+        return ((await invoke("notch_state")).settings ?? {});
+    }
+    catch {
+        return null;
+    }
+}
+/** Waits for the notch to publish `key` at `value`: the proof for an answer that was only "pending". */
+async function published(key, value) {
+    for (let attempt = 0; attempt < 8; attempt++) {
+        const settings = await readSettings();
+        if (settings && settings[key] === value)
+            return true;
+        await sleep(600);
+    }
+    return false;
+}
+/** One confirmed write: the notch's typed answer, or, when it has not answered yet, its published state. */
+export async function writeSetting(key, value) {
+    let answer;
+    try {
+        answer = await invoke("notch_command", { command: { command: "set", key, value } });
+    }
+    catch (error) {
+        return String(error);
+    }
+    if (answer?.status === "rejected" || answer?.status === "not_saved")
+        return answer.reason ?? answer.status;
+    if (answer?.status === "committed" || answer?.status === "unchanged" || answer?.status === "applied")
+        return null;
+    return (await published(key, value)) ? null : "the notch did not confirm the change";
+}
+/**
+ * Writes each `[key, value]` that the notch does not already hold, one at a time, and returns the keys whose write was
+ * not confirmed. Nothing is assumed: the next call reads the published state again, so a retry repeats only what failed.
+ */
+export async function writeAll(plan) {
+    const failed = {};
+    const current = (await readSettings()) ?? {};
+    for (const [key, value] of plan) {
+        if (current[key] === value)
+            continue;
+        const reason = await writeSetting(key, value);
+        if (reason)
+            failed[key] = reason;
+    }
+    return failed;
+}

package/dist/onboarding/gate.d.ts

@@ -0,0 +1,8 @@
+/** Settings > General > "Show onboarding again" fires this on `window` (Settings.tsx). */
+export declare const SHOW_ONBOARDING = "pulse-show-onboarding";
+/**
+ * The hub window's part of first run. It never renders onboarding: the first-run window is its own window
+ * (`onboarding.rs`). The native side opens it instead of the hub while the notch says setup is unfinished; this hook
+ * covers the two cases the native side cannot see, a new legal agreement and "Show onboarding again".
+ */
+export declare function useFirstRunGate(section: string): void;

package/dist/onboarding/gate.js

@@ -0,0 +1,52 @@
+import { useEffect } from "react";
+import { invoke } from "@tauri-apps/api/core";
+import { onboardingStateKey } from "@rightkit/onboarding";
+import { legalReceipt } from "../lib/legal.js";
+import { onboardingSettings } from "../lib/onboardingSettings.js";
+import { FLOW_KEY, freshFlow, writeSetting } from "./flow.js";
+/** Settings > General > "Show onboarding again" fires this on `window` (Settings.tsx). */
+export const SHOW_ONBOARDING = "pulse-show-onboarding";
+async function savedState() {
+    const snapshot = await onboardingSettings.load();
+    return snapshot.values[onboardingStateKey()];
+}
+/**
+ * Whether the native receipt holds the current agreement (version and document hash). The first read also carries over
+ * one the web view recorded earlier, including one saved under the pre-port digest of the same documents (#475).
+ */
+async function legalAccepted() {
+    return (await legalReceipt.read()) !== null;
+}
+/**
+ * Re-run: puts the shared record back to its first app step (the agreement, once accepted, is kept), starts a flow that
+ * keeps the current values, marks setup unfinished in the notch so an interrupted re-run resumes, and opens the window.
+ */
+async function rerun(section) {
+    const saved = await savedState();
+    await onboardingSettings.patch({
+        ...(saved ? { [onboardingStateKey()]: { ...saved, currentStep: 1, completed: [], skipped: false, skippedSteps: [] } } : {}),
+        [FLOW_KEY]: freshFlow(false),
+    });
+    // Unconfirmed, the re-run still opens: the window itself decides again when it finishes.
+    await writeSetting("onboardingDone", false);
+    await invoke("onboarding_open", { section });
+}
+/**
+ * The hub window's part of first run. It never renders onboarding: the first-run window is its own window
+ * (`onboarding.rs`). The native side opens it instead of the hub while the notch says setup is unfinished; this hook
+ * covers the two cases the native side cannot see, a new legal agreement and "Show onboarding again".
+ */
+export function useFirstRunGate(section) {
+    useEffect(() => {
+        void legalAccepted()
+            .then((ok) => (ok ? undefined : invoke("onboarding_open", { section })))
+            .catch(() => { });
+        // Once, when the hub window opens.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    useEffect(() => {
+        const again = () => void rerun(section).catch(() => { });
+        window.addEventListener(SHOW_ONBOARDING, again);
+        return () => window.removeEventListener(SHOW_ONBOARDING, again);
+    }, [section]);
+}

package/dist/styles.css

@@ -0,0 +1,8 @@
+/* Every stylesheet this package's components use. Hosts import "<package>/styles.css" once (Node cannot import CSS from JS). */
+@import "./views/monitor.css";
+@import "./views/activity.css";
+@import "./views/apps.css";
+@import "./views/chat.css";
+@import "./views/cleanup.css";
+@import "./views/health.css";
+@import "./views/storage.css";

package/dist/views/Activity.d.ts

@@ -0,0 +1,3 @@
+export declare function Activity({ onNavigate }: {
+    onNavigate: (section: string) => void;
+}): import("react").JSX.Element;

package/dist/views/Activity.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { Button, Select } from "@rightkit/react-shell/react";
+import { api, bytes, isWindows } from "../api.js";
+import { clearVisibleInterval, visibleInterval } from "../visible.js";
+import { useActivityLease } from "../activityLease.js";
+/** Rows per page, both for the newest page and for each "Load older". */
+const PAGE = 50;
+/** Refresh while the section is open. Never faster than 30 seconds. */
+const REFRESH_MS = 30_000;
+const SECTION_TITLES = {
+    cleanup: "Cleanup",
+    apps: "Apps",
+    storage: "Storage",
+    chat: "Chat",
+};
+const KIND_ORDER = ["Cleanup", "Undo", "Uninstall", "App update", "Drive health", "Scan", "Send", "Chat", "Remote", "File index", "Hub"];
+const startOfDay = (date) => new Date(date.getFullYear(), date.getMonth(), date.getDate());
+/** "Today", "Yesterday", or the date. */
+function dayLabel(at, now) {
+    const day = startOfDay(new Date(at * 1000));
+    const today = startOfDay(now);
+    const yesterday = new Date(today);
+    yesterday.setDate(today.getDate() - 1);
+    if (day.getTime() === today.getTime())
+        return "Today";
+    if (day.getTime() === yesterday.getTime())
+        return "Yesterday";
+    return day.toLocaleDateString(undefined, { weekday: "short", month: "short", day: "numeric", year: "numeric" });
+}
+const clock = (at) => new Date(at * 1000).toLocaleTimeString(undefined, { hour: "numeric", minute: "2-digit" });
+const rowKey = (row) => `${row.at}|${row.kind}|${row.summary}`;
+const TRASH = isWindows ? "Recycle Bin" : "Trash";
+const utc = (at) => `${new Date(at * 1000).toISOString().slice(0, 16).replace("T", " ")} UTC`;
+const TOTAL_TITLES = { week: "This week", month: "This month" };
+export function Activity({ onNavigate }) {
+    const [rows, setRows] = useState(null);
+    const [unreadable, setUnreadable] = useState([]);
+    const [totals, setTotals] = useState([]);
+    const [more, setMore] = useState(false);
+    const [filter, setFilter] = useState("All");
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    /** Replace the newest page, keeping older rows the user has already loaded. */
+    const refresh = useCallback(async () => {
+        setBusy(true);
+        try {
+            const page = await api.activityTimeline(PAGE, null);
+            const oldest = page.rows.length ? page.rows[page.rows.length - 1].at : null;
+            setRows((previous) => {
+                const older = oldest === null ? [] : (previous ?? []).filter((row) => row.at < oldest);
+                return [...page.rows, ...older];
+            });
+            setUnreadable(page.unreadable);
+            setTotals(page.totals ?? []);
+            setMore((previous) => previous || page.rows.length >= PAGE);
+            setError(null);
+        }
+        catch (e) {
+            setError(String(e));
+        }
+        finally {
+            setBusy(false);
+        }
+    }, []);
+    useEffect(() => {
+        void refresh();
+        const id = visibleInterval(() => void refresh(), REFRESH_MS);
+        return () => clearVisibleInterval(id);
+    }, [refresh]);
+    // Live-activity lease (#448): the notch's session monitors poll every 1 s while this page is visible.
+    useActivityLease();
+    const loadOlder = async () => {
+        if (!rows || rows.length === 0)
+            return;
+        setBusy(true);
+        try {
+            // `before` is exclusive; one second past the oldest row shown brings back its
+            // whole second, and rows already shown are dropped below.
+            const last = rows[rows.length - 1];
+            const page = await api.activityTimeline(PAGE, last.at + 1);
+            setRows((previous) => {
+                const seen = new Set((previous ?? []).map(rowKey));
+                return [...(previous ?? []), ...page.rows.filter((row) => !seen.has(rowKey(row)))];
+            });
+            setUnreadable(page.unreadable);
+            setMore(page.rows.length >= PAGE);
+            setError(null);
+        }
+        catch (e) {
+            setError(String(e));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const kinds = useMemo(() => KIND_ORDER.filter((kind) => (rows ?? []).some((row) => row.kind === kind)), [rows]);
+    const current = kinds.includes(filter) ? filter : "All";
+    const visible = useMemo(() => (rows ?? []).filter((row) => current === "All" || row.kind === current), [rows, current]);
+    const now = new Date();
+    const groups = [];
+    for (const row of visible) {
+        const label = dayLabel(row.at, now);
+        const last = groups[groups.length - 1];
+        if (last && last.label === label)
+            last.rows.push(row);
+        else
+            groups.push({ label, rows: [row] });
+    }
+    return (_jsxs("div", { className: "ck-activity", children: [_jsxs("div", { className: "ck-activity-head", children: [_jsx("p", { className: "muted", children: "What Pulse did and saw, newest first. Read only: nothing is recorded here." }), _jsx(Select, { className: "ck-activity-select", label: "Filter by kind", value: current, disabled: rows === null, onChange: setFilter, options: [{ value: "All", label: "All" }, ...kinds.map((kind) => ({ value: kind, label: kind }))] })] }), error && _jsxs("p", { className: "ck-activity-error", role: "alert", children: ["Activity could not be loaded: ", error] }), rows === null && !error && _jsx("p", { className: "muted", children: "Loading activity\u2026" }), rows !== null && rows.length === 0 && (_jsxs("div", { className: "ck-activity-empty", children: [_jsx("strong", { children: "Nothing recorded yet" }), _jsx("p", { className: "muted", children: "Cleanup runs and undos, uninstalls, drive alerts, storage scans, file transfers and chat messages will appear here as they happen." })] })), rows !== null && rows.length > 0 && visible.length === 0 && (_jsxs("p", { className: "muted", children: ["No ", current.toLowerCase(), " records in the rows loaded so far."] })), totals.length > 0 && current === "All" && (_jsxs("section", { className: "ck-activity-day", "aria-label": "Totals", children: [_jsx("h2", { children: "Totals" }), _jsx("ul", { className: "ck-activity-list", children: totals.map((t) => (_jsxs("li", { className: "ck-activity-row", children: [_jsx("span", { className: "ck-activity-kind", children: TOTAL_TITLES[t.period] }), _jsxs("span", { className: "ck-activity-summary", children: [t.events, " ", t.events === 1 ? "record" : "records", ", ", t.transfers, " ", t.transfers === 1 ? "transfer" : "transfers", ",", " ", bytes(t.moved_bytes), " moved to the ", TRASH, " (not freed). From ", utc(t.from), " to ", utc(t.to), "."] })] }, t.period))) }), _jsx("p", { className: "muted ck-activity-note", children: "Totals cover the newest records each source keeps, not every record ever made." })] })), groups.map((group) => (_jsxs("section", { className: "ck-activity-day", "aria-label": group.label, children: [_jsx("h2", { children: group.label }), _jsx("ul", { className: "ck-activity-list", children: group.rows.map((row) => (_jsxs("li", { className: "ck-activity-row", children: [_jsx("time", { className: "ck-activity-time", dateTime: new Date(row.at * 1000).toISOString(), children: clock(row.at) }), _jsx("span", { className: "ck-activity-kind", children: row.kind }), _jsx("span", { className: "ck-activity-summary", children: row.summary }), row.open && (_jsxs(Button, { size: "sm", variant: "secondary", onClick: () => onNavigate(row.open), children: ["Open ", SECTION_TITLES[row.open] ?? row.open] }))] }, rowKey(row)))) })] }, group.label))), more && (_jsx("div", { className: "ck-activity-more", children: _jsx(Button, { size: "sm", variant: "secondary", onClick: () => void loadOlder(), disabled: busy, children: "Load older" }) })), unreadable.length > 0 && (_jsxs("p", { className: "muted ck-activity-note", children: ["Could not read: ", unreadable.join(", "), "."] }))] }));
+}

package/dist/views/Apps.d.ts

@@ -0,0 +1 @@
+export declare function Apps(): import("react").JSX.Element;