toolroll 0.9.85 → 0.9.87

package/dist/settings-groups-ui.d.ts

@@ -0,0 +1,279 @@
+import { type BrowserPhoneCard, type BrowserUpdates } from "./browser-workspace.js";
+import { type Html, type HtmlValue } from "./html.js";
+import { type UnattendedPermissionMode } from "./scope.js";
+import { type QualityMode } from "./quality.js";
+import { type ResultScreenshots } from "./store.js";
+export type SettingsGroup = "hub" | "general" | "agents" | "alerts" | "approval" | "projects" | "access" | "system";
+/** The group pages this module draws (Spend is /spend; Approvals and safety is /settings/approval, its own handler). */
+export declare const GROUP_PATHS: Readonly<Record<string, SettingsGroup>>;
+type Tone = "ok" | "warn" | "off" | "neutral";
+export type ProviderFacts = {
+    provider: string;
+    name: string;
+    tone: Tone;
+    words: string;
+    connection: {
+        words: string;
+        facts: string;
+    } | null;
+    usage: string;
+    envName: string;
+    subscriptionCapable: boolean;
+    mode: "subscription" | "api-key";
+    set: boolean;
+};
+export type WorkerFacts = {
+    name: string;
+    tone: "ok" | "warn" | "off";
+    state: string;
+    capacity: number;
+    busy: number;
+    running: {
+        taskId: string;
+        title: string;
+        href: string;
+        project: string | null;
+    }[];
+};
+export type EmailFacts = {
+    set: boolean;
+    host: string;
+    port: number;
+    secure: boolean;
+    user: string;
+    from: string;
+    imapHost: string;
+    imapPort: number;
+    google: {
+        connected: string | null;
+        clientId: string;
+        redirect: string | null;
+    };
+};
+/** What the overview and the group pages show, as the settings handler read it for this person. */
+export type SettingsFacts = {
+    /** The person: an approver (can manage and approve), an instance operator, signed in in a browser. */
+    name: string;
+    approver: boolean;
+    operator: boolean;
+    browser: boolean;
+    /** Installation-wide settings are this person's to see: not a project-limited account (the bot token, defaults…). */
+    installation: boolean;
+    said: string | null;
+    problem: string | null;
+    theme: "system" | "light" | "dark";
+    accent: string;
+    version: string | null;
+    permission: {
+        mode: UnattendedPermissionMode;
+        canManage: boolean;
+        changed: string | null;
+    } | null;
+    quality: {
+        mode: QualityMode;
+        canManage: boolean;
+        changed: string | null;
+    } | null;
+    providers: ProviderFacts[] | null;
+    workers: WorkerFacts[] | null;
+    updates: BrowserUpdates | null;
+    firstResult: string | null;
+    chat: {
+        mode: "quiet" | "all";
+        digestAt: string | null;
+        screenshots?: ResultScreenshots;
+        projects?: {
+            repo: string;
+            name: string;
+            muted: boolean;
+        }[];
+    } | null;
+    messaging: {
+        channel: string | null;
+        implicit: boolean;
+        configured: string[];
+        legacyWarning?: string;
+    } | null;
+    push: {
+        available: boolean;
+        devices: {
+            id: number;
+            words: string;
+            state: "ok" | "failing" | "expired";
+            removable: boolean;
+        }[];
+    } | null;
+    digest: {
+        every: string;
+        held: string | null;
+    } | null;
+    telegram: {
+        state: string;
+        current: string;
+        delivery: string | null;
+        failing: boolean;
+    };
+    email: EmailFacts | null;
+    phone: BrowserPhoneCard | null;
+    projects: {
+        repo: string;
+        name: string;
+    }[];
+    people: {
+        approvers: string[];
+        viewers: string[];
+        invites: number;
+    } | null;
+    passwordless: boolean | null;
+    sso: string | null;
+    access: {
+        sessions: number;
+        tokens: number;
+    };
+    backup: {
+        failed: boolean;
+        words: string;
+    } | null;
+};
+declare const groupHref: (slug: string) => string;
+export type NeedsItem = {
+    group: string;
+    title: string;
+    text: string;
+    action: readonly [label: string, href: string];
+};
+/** What waits on this person in Settings (never a task): no builder, a chat app failing, a failed backup. Read-only. */
+export declare function settingsNeeds(facts: SettingsFacts): NeedsItem[];
+/** Which groups have something waiting, for the section nav's dot and the overview's rows. */
+export declare function needsByGroup(items: readonly NeedsItem[]): Record<string, number>;
+/** The overview: what waits on this person, then one row per group with its state. Viewers see the groups they can open. */
+export declare function settingsHub(facts: SettingsFacts): Html;
+/** The hub's old anchors, forwarded to their group (fragments never reach the server). */
+export declare const HUB_ANCHORS: Readonly<Record<string, string>>;
+export declare const HUB_ANCHOR_SCRIPT: string;
+export declare function generalGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+export declare function agentsGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+/** Enrolling this device fills the subscription the form posts; it never reads the password beside it. With the kit's
+ * section forms (section-forms.ts) it answers their `k-prepare` hook after the password is confirmed, so the post
+ * goes exactly once under the pending guard; without them it holds the plain submit, then posts. */
+export declare function pushScriptOf(facts: SettingsFacts): string | null;
+export declare function alertsGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+export type ApprovalGroupFacts = {
+    facts: Pick<SettingsFacts, "permission" | "quality" | "said" | "problem">;
+    flags: Record<string, boolean>;
+    projects: {
+        repo: string;
+        name: string;
+    }[];
+    chosen: string;
+    /** The project's approval rules and release approval, drawn by approval-rules-ui.ts (kit markup). */
+    rules: Html;
+    mode: string;
+};
+export declare function approvalGroup(view: ApprovalGroupFacts): Html;
+export declare function projectsGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+export declare function accessGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+export declare function systemGroup(facts: SettingsFacts, flags: Record<string, boolean>): Html;
+/** One group page by its slug. */
+export declare function settingsGroupPage(group: SettingsGroup, facts: SettingsFacts): Html;
+export declare const groupTitle: (group: SettingsGroup) => string;
+export { groupHref };
+/** A settings sub-page in the frame: the group's breadcrumb, the page's title, its old body inside. */
+export declare function settingsSubPage(group: string, title: string, body: HtmlValue, options?: {
+    lead?: string;
+    flags?: Record<string, boolean>;
+}): Html;
+export type ModePageView = {
+    project: string;
+    name: string;
+    maxDays: number;
+    approver: boolean;
+    hasMergeGrant: boolean;
+    said: string | null;
+    problem: string | null;
+    live: {
+        name: string;
+        signedBy: string;
+        until: string;
+        words: string[];
+    } | null;
+};
+/** /mode: the mode a project runs under now, and (for an approver) the choices to sign a new one. Reading the terms is
+ * the next page (/mode/confirm), where the password signs exactly what it shows. */
+export declare function modePageHtml(view: ModePageView): Html;
+/** /mode/confirm: every resolved term in words; the password signs exactly this digest (a changed form is refused). */
+export declare function modeCeremonyHtml(view: {
+    name: string;
+    project: string;
+    words: string[];
+    chatApprove: boolean;
+    hidden: Readonly<Record<string, string>>;
+}): Html;
+export type PersonView = {
+    name: string;
+    you: boolean;
+    approver: boolean;
+    projects: readonly string[] | null;
+    projectNames: string;
+    revoked: string | null;
+    seen: string;
+    joined: string;
+    activity: string;
+    acts: string[];
+};
+export type PeopleView = {
+    operator: boolean;
+    you: string;
+    said: string | null;
+    problem: string | null;
+    people: PersonView[];
+    invites: {
+        id: number;
+        role: "approver" | "viewer";
+        projects: string;
+        from: string;
+        expires: string;
+        attempts: number;
+    }[];
+    projects: {
+        repo: string;
+        name: string;
+    }[];
+    /** The project the invite form starts with (the open one). */
+    openProject: string | null;
+    filers: {
+        name: string;
+        words: string;
+    }[];
+};
+/** People: who can get in, what each can do and where, open invites, and inviting someone. Inviting and widening
+ * access always ask for the password typed now; removing someone or cancelling an invite is a step-up. */
+export declare function peopleHtml(view: PeopleView): Html;
+/** People for someone limited to some projects: their own access, in words. */
+export declare function ownAccessHtml(view: {
+    name: string;
+    approver: boolean;
+    projects: string[];
+    activity: string;
+}): Html;
+/** The invite link, once, on a page with no script: selectable text, what it lets them do, and where to cancel it. */
+export declare function inviteLinkHtml(view: {
+    link: string;
+    approver: boolean;
+    projects: string;
+    expires: string;
+}): Html;
+/** The switch and the trade in plain words. Turning it on is a way in: it always asks for the password typed now.
+ * Turning it off is one click. */
+export declare function passwordlessHtml(view: {
+    on: boolean;
+    since: string | null;
+    trade: string;
+    said: string | null;
+    problem: string | null;
+}): Html;
+/** Which project a per-project settings page shows: a GET form (an address, not a save). */
+export declare function projectPicker(action: string, projects: readonly {
+    repo: string;
+    name: string;
+}[], chosen: string): Html;