@contraagent/ui 0.0.0-stage → 0.1.0

package/dist/elements/shell/ca-monitor.d.ts

@@ -0,0 +1,180 @@
+import { LitElement, nothing, type PropertyValues } from 'lit';
+import { type Locale } from '../../core/i18n.js';
+import type { ViewRoutePatch } from '../../core/view-route.js';
+import { type ViewRouterMode } from '../../core/view-router.js';
+import { type ShortcutScope } from '../../controllers/shortcuts.js';
+import '@contraagent/elements/segmented/define';
+import { type ThemeChoice, type ThemeName } from '@contraagent/elements/themes';
+import './ca-clock.js';
+import './ca-hosts.js';
+import './ca-run-picker.js';
+import './ca-toasts.js';
+import './ca-theme-switch.js';
+import '../trends/ca-trends.js';
+/**
+ * The whole monitor: header, run switcher, tabs, filters and the views, live.
+ * It owns the data (`MonitorStore`) and the view route (`ViewRouter`); every view below
+ * it only renders what it is given and sends `ca-*` events back up.
+ */
+export declare class CaMonitor extends LitElement {
+    static styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /**
+     * Where the monitor's API is served, such as `http://127.0.0.1:8787`; '' is
+     * this page's origin. A server on another origin must allow this page's
+     * (`contraagent monitor --cors-origin`). It takes effect whenever it is set,
+     * before or after the element connects: a change closes the old server's
+     * feeds and opens the run named by `run`, else the new server's newest run.
+     * A request that gets no JSON answer (a network error, a status outside 2xx,
+     * or an HTML page from a server without the API) is shown above the view,
+     * with its URL and cause, and written to the console.
+     */
+    baseUrl: string;
+    /**
+     * An export to read instead of a server (`contraagent monitor export`): its `data/`
+     * directory, relative to the page (`export="data/"`) or absolute. The monitor then
+     * makes no request to an API and opens no feed: it reads the export's files, which
+     * hold no transcripts and no processes. Set, it outranks `base-url`.
+     */
+    exportUrl: string;
+    /**
+     * `url`: the monitor is the page. The view route lives in the address bar (Back
+     * and reload return to it), and the monitor sets the page's title, `lang` and
+     * theme. `memory`: for a monitor embedded in another page. The view route, the
+     * scroll positions and the open sections live in the element, and the page's
+     * URL, history, title and `<html>` attributes stay the host's. A change after
+     * connecting takes effect at once: `memory` keeps the view route shown, `url`
+     * reads the address bar's.
+     */
+    history: ViewRouterMode;
+    /**
+     * Where the single-key shortcuts (1 to 9 for the tabs, `r` for the runs, `/`
+     * for the filter) work: `page`, anywhere in the page except in a text field;
+     * `element`, only while the focus is inside the monitor; `off`, nowhere.
+     * Unset: `page` with `history="url"`, `element` with `history="memory"`.
+     */
+    shortcuts: ShortcutScope | '';
+    /**
+     * The run to open first (in `memory` mode, or when the URL names none). A
+     * change after connecting opens that run.
+     */
+    run: string;
+    /**
+     * The language to show (`en`, `ja`). Unset: the reader's earlier choice, else
+     * the browser's language. The header's switch changes it and remembers it.
+     */
+    locale: Locale | '';
+    /**
+     * The theme: `contraagent-dark`, `contraagent-light`, `system` (one of the two,
+     * as the system's colour scheme), `github-dark`, `github-light`, `one-dark`,
+     * `nord` or `high-contrast`. Unset: the reader's earlier choice, else
+     * `contraagent-dark`. The header's control changes it and remembers it. The
+     * theme shown is reflected as `data-ca-theme` (on `<html>` too, with `history="url"`).
+     */
+    theme: ThemeChoice | '';
+    /** Reflects whether the run is live (the logo moves). */
+    live: boolean;
+    private snap;
+    private viewRoute;
+    private pickerOpen;
+    /** The filter text as typed, ahead of the URL. */
+    private qDraft;
+    private main;
+    private toasts;
+    private runBtn;
+    private picker;
+    private readonly themes;
+    /** One tab stop for the tab list, on the selected tab; the arrow keys, Home and End move between the tabs. */
+    private readonly tabFocus;
+    private store;
+    private viewRouter;
+    /** The `baseUrl` the store was made for, and the `history` the view router was. */
+    private storeBase;
+    private viewRouterMode;
+    /** Stop listening to the store. */
+    private readonly storeCleanups;
+    private readonly mainScroll;
+    private pendingScroll;
+    private qTimer;
+    private readonly cleanups;
+    /** The scroll positions and open sections, with `history="memory"`. */
+    private readonly localMemory;
+    /** Closes the run picker on a click outside it; listened for on the document only while the picker is open. */
+    private readonly onOutsideClick;
+    private outsideClickOn;
+    private navObserver;
+    private navObserved;
+    private readonly language;
+    /** Whether the elements can switch language: false when the page configured Lit Localize itself. */
+    private locales;
+    constructor();
+    /** The first paint waits for the reader's language: its module loads when first chosen. */
+    protected scheduleUpdate(): Promise<unknown>;
+    connectedCallback(): void;
+    /** Where the store reads: an export's files, else the server at `baseUrl`. */
+    private get source();
+    /** A store for the export, else for `baseUrl`, shown and listened to; not started. */
+    private openStore;
+    private closeStore;
+    /**
+     * A view router for `history`, started at the `run` property's run; when it replaces
+     * another view router, `memory` starts at the view route shown and `url` at the address bar's.
+     */
+    private openViewRouter;
+    /**
+     * A connection property changed while connected: a new `base-url` gets a new
+     * store (the feeds of the old one close) and the run named by `run`, else the
+     * newest of the new server's; a new `history` gets a new view router; a new `run` opens it.
+     */
+    protected willUpdate(changed: PropertyValues<this>): void;
+    /** Show a new snapshot of the data, and whether the run is live; write a new API failure to the console. */
+    private show;
+    /** Where the single-key shortcuts work now: the `shortcuts` property, else by `history`. */
+    private get shortcutScope();
+    /** Listen for a click outside the run picker on the document (while it is open), or stop. */
+    private listenOutside;
+    /** The theme shown now. */
+    get shownTheme(): ThemeName;
+    disconnectedCallback(): void;
+    /** Go elsewhere: the view route changes, and with it the URL (pushing an entry for a new place). */
+    navigate(patch: ViewRoutePatch, opts?: {
+        replace?: boolean;
+    }): void;
+    private onViewRoute;
+    /**
+     * With no run named, open the most recent one (replacing the entry: it is a
+     * default, not a step). The hosts page names none; a monitor of one host has no hosts page.
+     */
+    private pickDefaultRun;
+    private onKey;
+    /** The index of the selected tab in the tab list, or -1 (a custom view the run does not have). */
+    private selectedTab;
+    /** Close the run picker; the focus goes back to the button that opens it when it was in the picker. */
+    private closePicker;
+    protected updated(): void;
+    /** Move the line under the selected tab when the tab bar changes size. */
+    private observeNav;
+    private setQ;
+    /** The header's language switch: switch now, and remember it for the next visit. */
+    private pickLocale;
+    render(): import("lit").TemplateResult<1> | typeof nothing;
+    /**
+     * The run button's label for a run: its status dot, its name (on a hub,
+     * without the host, which follows it), no report from its host (a hub; before
+     * the run line, which the button may cut), its run line.
+     */
+    private runLabel;
+    /** The run button's label on the trends page: its name, and what it shows. */
+    private trendsLabel;
+    /** The run button's label on the hosts page: the hosts in one line, attention while a host has no report. */
+    private hostsLabel;
+    /** A request to the API that got no JSON answer: its URL and cause. */
+    private renderApiError;
+    private renderTabs;
+    private renderBar;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'ca-monitor': CaMonitor;
+    }
+}
+//# sourceMappingURL=ca-monitor.d.ts.map

package/dist/elements/shell/ca-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ca-monitor.d.ts","sourceRoot":"","sources":["../../../src/elements/shell/ca-monitor.ts"],"names":[],"mappings":"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"}