@overvis/hmi-workspace-ui 0.0.0-stage → 0.1.0

package/dist/src/workspace/setup/base-revision.d.ts

@@ -0,0 +1,64 @@
+import { type SetupConflictDetails } from "@overvis/hmi-shared/setup";
+import { type FormValidationErrorResult } from "../../form/index.js";
+export interface SetupBaseRevision {
+    /** Send as `baseRevision` with the save. Undefined when there is no entity yet (create). */
+    readonly baseRevision: number | undefined;
+    /** The conflict the last save hit, until it is settled. */
+    readonly conflict: SetupConflictDetails | null;
+    /** Pass as `mutationFormValidators`' `onError`. */
+    readonly onError: (error: unknown) => void;
+    /**
+     * Wraps `mutationFormValidators`' `mapError`: a conflict shows in `SetupConflictNotice`, not
+     * as a form error.
+     */
+    readonly mapError: (map?: (error: unknown, value: unknown) => FormValidationErrorResult) => (error: unknown, value: unknown) => FormValidationErrorResult;
+    /** Base the next save on the version the conflict reported: it replaces that version. */
+    readonly keepMine: () => void;
+    /** Base the next save on `revision`, after a save that keeps the form open or a reload. */
+    readonly rebase: (revision: number) => void;
+}
+export interface SetupBaseRevisionState {
+    readonly baseRevision: number | undefined;
+    readonly conflict: SetupConflictDetails | null;
+}
+export type SetupBaseRevisionAction = 
+/** A save failed with `error`. */
+{
+    type: "failed";
+    error: unknown;
+}
+/** Keep the edits: base the next save on the version the conflict reported. */
+ | {
+    type: "keep-mine";
+}
+/** Base the next save on `revision`. */
+ | {
+    type: "rebase";
+    revision: number;
+};
+export declare function setupBaseRevisionReducer(state: SetupBaseRevisionState, action: SetupBaseRevisionAction): SetupBaseRevisionState;
+/**
+ * The revision a setup entity had when its form opened. The form sends it with the save, so a
+ * save made from an outdated form fails with `setup_conflict` instead of silently replacing
+ * someone else's change. Live updates refresh the entity the form was opened from; the base does
+ * not follow them.
+ */
+export declare function useSetupBaseRevision(revision: number | undefined): SetupBaseRevision;
+/**
+ * Runs a conflict action that may fetch the latest version, and returns its failure (null when it
+ * succeeded). An action replaces the form only once its fetch succeeded, so a failure leaves the
+ * form and its edits in place.
+ */
+export declare function settleConflictAction(action: () => void | Promise<void>): Promise<unknown>;
+/**
+ * What a setup form offers after its save hit `setup_conflict`: keep the edits and save them over
+ * the newer version, or load the newer version instead. While an action runs, both are disabled;
+ * when it fails, the notice shows why and the form keeps its edits.
+ */
+export declare function SetupConflictNotice({ base, onReload, onKeepMine, }: {
+    base: SetupBaseRevision;
+    /** Loads the latest version and reopens the form on it; rejects when the load fails. */
+    onReload: () => Promise<void>;
+    /** Replaces `base.keepMine` when keeping the edits must rebase more than the revision. */
+    onKeepMine?: () => void | Promise<void>;
+}): import("react").JSX.Element | null;

package/dist/src/workspace/setup/breadcrumbs.d.ts

@@ -0,0 +1,10 @@
+import { type SetupSectionId } from "./sections.js";
+/**
+ * Ancestors of a Setup page for `PageHeader`'s `breadcrumbs` slot. Section lists get the plain
+ * "Setup" eyebrow; a full-page child (endpoint status) also links to its section. "Setup"
+ * itself is never a link: there is no Setup landing page, the sidebar owns that level.
+ */
+export declare function SetupBreadcrumbs({ workspaceId, section, }: {
+    workspaceId: string;
+    section?: SetupSectionId;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/catalog-list.d.ts

@@ -0,0 +1,21 @@
+import { Button } from "../../ui/button.js";
+/** Shared Setup catalog list chrome (dashboards, endpoints, reports). */
+export declare function CatalogPage({ className, ...props }: React.ComponentProps<"div">): import("react").JSX.Element;
+/** Content column below the page header. */
+export declare function CatalogBody({ className, ...props }: React.ComponentProps<"div">): import("react").JSX.Element;
+export declare function CatalogList({ className, ...props }: React.ComponentProps<"ul">): import("react").JSX.Element;
+export declare function CatalogRow({ className, ...props }: React.ComponentProps<"li">): import("react").JSX.Element;
+/** Name block: live dashboard / endpoint status / report runtime. */
+declare function CatalogNameAnchor({ className, ...props }: React.ComponentProps<"a">): import("react").JSX.Element;
+export declare const CatalogNameLink: import("@tanstack/react-router").LinkComponent<typeof CatalogNameAnchor, string>;
+export declare function CatalogName({ className, ...props }: React.ComponentProps<"p">): import("react").JSX.Element;
+export declare function CatalogMeta({ className, ...props }: React.ComponentProps<"p">): import("react").JSX.Element;
+export declare function CatalogActions({ className, ...props }: React.ComponentProps<"div">): import("react").JSX.Element;
+export declare function CatalogIconActions({ className, ...props }: React.ComponentProps<"div">): import("react").JSX.Element;
+/** Quiet per-row icon button; destructive tone only colors on hover so rows stay calm. */
+export declare function CatalogRowButton({ className, tone, ...props }: Omit<React.ComponentProps<typeof Button>, "variant" | "size"> & {
+    tone?: "default" | "destructive";
+}): import("react").JSX.Element;
+/** Muted one-liner for lists with nothing to show yet. */
+export declare function CatalogEmpty({ className, ...props }: React.ComponentProps<"p">): import("react").JSX.Element;
+export {};

package/dist/src/workspace/setup/dashboards-order.d.ts

@@ -0,0 +1,10 @@
+/** Dense catalog permutation after a sortable move. `null` means no write. */
+export declare function moveDashboardCatalogOrder(input: {
+    ids: readonly string[];
+    fromIndex: number;
+    toIndex: number;
+}): string[] | null;
+/** Apply `ids` onto `items`. Keep current rows (and their fields); skip ids not in `items`. */
+export declare function applyDashboardCatalogOrder<T extends {
+    id: string;
+}>(items: readonly T[], ids: readonly string[]): T[];

package/dist/src/workspace/setup/dashboards-page.d.ts

@@ -0,0 +1,24 @@
+export declare function SetupDashboardsPage({ workspaceId }: {
+    workspaceId: string;
+}): import("react").JSX.Element;
+export declare function CreateDashboardFromReportForm({ workspaceId, onCancel, onCreated, }: {
+    workspaceId: string;
+    onCancel: () => void;
+    onCreated: () => void;
+}): import("react").JSX.Element;
+/** The long description of the template chosen in the Create dashboard picker. */
+export declare function DashboardTemplateDescription({ workspaceId, templateId, }: {
+    workspaceId: string;
+    templateId: string;
+}): import("react").JSX.Element | null;
+export declare function CreateDashboardForm({ workspaceId, onCancel, onCreated, }: {
+    workspaceId: string;
+    onCancel: () => void;
+    onCreated: () => void;
+}): import("react").JSX.Element;
+/** Loads dashboard by id and renders its settings form. */
+export declare function SetupDashboardSettingsDialogBody({ workspaceId, dashboardId, onClose, }: {
+    workspaceId: string;
+    dashboardId: string;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/dashboards-reorder-queue.d.ts

@@ -0,0 +1,13 @@
+export interface LatestOrderHandlers<Order, Result> {
+    send: (order: Order) => Promise<Result>;
+    onLatestSuccess: (result: Result) => void;
+    onLatestFailure: (error: unknown) => void;
+}
+export interface LatestOrderQueue<Order, Result> {
+    enqueue: (order: Order, handlers: LatestOrderHandlers<Order, Result>) => void;
+}
+/**
+ * One in-flight write; newer enqueue calls replace the pending order.
+ * Only the latest settled request reports success or failure.
+ */
+export declare function createLatestOrderQueue<Order, Result>(): LatestOrderQueue<Order, Result>;

package/dist/src/workspace/setup/dashboards-sortable-list.d.ts

@@ -0,0 +1,6 @@
+import type { DashboardListItem } from "@overvis/hmi-shared/dashboard";
+export declare function SetupDashboardsCatalogList({ workspaceId, dashboards, onDelete, }: {
+    workspaceId: string;
+    dashboards: DashboardListItem[];
+    onDelete: (dashboard: DashboardListItem) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/connection-error.d.ts

@@ -0,0 +1,3 @@
+import type { EndpointStatusLastError } from "@overvis/hmi-shared/endpoint";
+/** Device access is a possible cause of a closed socket, not a confirmed diagnosis. */
+export declare function endpointConnectionErrorText(error: EndpointStatusLastError): string;

package/dist/src/workspace/setup/endpoints/connection-indicator.d.ts

@@ -0,0 +1,4 @@
+/** Live connection dot for an endpoint list row. */
+export declare function EndpointConnectionIndicator({ endpointId }: {
+    endpointId: string;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/device-log-clock.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Warns that an MC252's clock is too far off for the readings its programs record to be imported,
+ * with the offset and how to fix it. Renders nothing while the clock is right.
+ */
+export declare function DeviceLogClockAlert({ endpointId }: {
+    endpointId: string;
+}): import("react").JSX.Element | null;

package/dist/src/workspace/setup/endpoints/display.d.ts

@@ -0,0 +1,12 @@
+/** manufacturer · sku — omit null/empty; null if nothing to show. */
+export declare function formatEndpointManufacturerSkuLine(manufacturer: string | null | undefined, sku: string | null | undefined): string | null;
+/** List/status subtitle for PIN kind: `PIN: …` plus manufacturer/sku when present (no port). */
+export declare function formatPinEndpointListSubtitle(endpoint: {
+    pinCode: string | null;
+    sku: string | null;
+    deviceMeta: {
+        manufacturer?: string | null;
+    } | null;
+}): string;
+/** List/status subtitle for WireGuard kind: kind label plus port (no hostname). */
+export declare function formatWireGuardEndpointListSubtitle(port: number): string;

package/dist/src/workspace/setup/endpoints/edit-dialog.d.ts

@@ -0,0 +1,5 @@
+export declare function SetupEndpointEditDialogBody({ workspaceId, endpointId, onClose, }: {
+    workspaceId: string;
+    endpointId: string;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/enabled-switch.d.ts

@@ -0,0 +1,10 @@
+import type { EndpointListItem } from "@overvis/hmi-shared/endpoint";
+export declare function EndpointEnabledSwitch({ workspaceId, endpoint, compact, className, }: {
+    workspaceId: string;
+    endpoint: EndpointListItem;
+    compact?: boolean;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function EndpointDisabledBadge({ endpoint }: {
+    endpoint: EndpointListItem;
+}): import("react").JSX.Element | null;

package/dist/src/workspace/setup/endpoints/form-problem.d.ts

@@ -0,0 +1,5 @@
+import type { EndpointFormProblem } from "@overvis/hmi-shared/endpoint";
+/** Current-locale text for a failed endpoint form conversion. */
+export declare function endpointFormProblemMessage({ problem }: {
+    problem: EndpointFormProblem;
+}): string;

package/dist/src/workspace/setup/endpoints/page.d.ts

@@ -0,0 +1,11 @@
+export declare function SetupEndpointsPage({ workspaceId }: {
+    workspaceId: string;
+}): import("react").JSX.Element;
+export declare function CreateEndpointForm({ workspaceId, onCancel, onCreated, }: {
+    workspaceId: string;
+    onCancel: () => void;
+    onCreated: (created: {
+        id: string;
+        kind: "direct" | "pin" | "wireguard";
+    }) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/presence-challenge.d.ts

@@ -0,0 +1,34 @@
+import type { EndpointBeginPinPresenceInput } from "@overvis/hmi-shared/endpoint";
+import { type FormValidationErrorResult } from "../../../form/index.js";
+/**
+ * Presence step errors: without a code on the device screen, only the R button can prove presence,
+ * so the missing-press message leaves the code out.
+ */
+export declare function mapPresenceFormErrors(error: unknown, formValue: unknown, codeDisplayed: boolean): FormValidationErrorResult;
+/** A wrong code, a missing press, or an unreachable device can be retried on the same challenge. */
+export declare function presenceRetryable(error: unknown): boolean;
+export interface PinPresenceChallenge {
+    challengeId: string;
+    codeDisplayed: boolean;
+}
+/**
+ * MC252 presence challenges owned by one dialog. A challenge still open when the dialog
+ * unmounts is cancelled, including one whose begin was in flight at that moment.
+ */
+export declare function usePinPresenceChallenge(): {
+    begin: (input: EndpointBeginPinPresenceInput) => Promise<PinPresenceChallenge | "closed" | null>;
+    cancel: (challengeId: string) => void;
+    settle: (challengeId: string) => void;
+};
+/**
+ * Polls the device about once a second while mounted and calls `onDone` when the R button was
+ * pressed for this challenge, or once when the challenge is no longer valid. The caller submits
+ * its form then, and the server checks the proof again. A submit that fails, for example on a
+ * device timeout, is retried on the next poll that still sees the press. Other poll errors are
+ * shown in place; old firmware stops polling, and anything else clears on the next good poll.
+ */
+export declare function PinPresencePressWatcher({ challengeId, paused, onDone, }: {
+    challengeId: string;
+    paused: boolean;
+    onDone: () => void;
+}): import("react").JSX.Element | null;

package/dist/src/workspace/setup/endpoints/presence-code.d.ts

@@ -0,0 +1,6 @@
+export declare function parseScreenAuthorizationCode(raw: string): {
+    ok: true;
+    code: number | undefined;
+} | {
+    ok: false;
+};

package/dist/src/workspace/setup/endpoints/programs/deploy-status-bar.d.ts

@@ -0,0 +1,13 @@
+import type { EdgeDeployStatusFeed } from "../../../edge-programs/deploy-status.js";
+/**
+ * Where the device's programs stand, live: one bar with the deploy state, its times, Settings
+ * and Sync now, and below it a compile error the device reported or why a deploy failed.
+ */
+export declare function EdgeDeployStatusBar({ workspaceId, deploy, canEdit, onOpenSettings, onShowLine, }: {
+    workspaceId: string;
+    deploy: EdgeDeployStatusFeed;
+    canEdit: boolean;
+    onOpenSettings: () => void;
+    /** Opens a program in the editor at a line the device reported. */
+    onShowLine: (programId: string, line: number) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/device-log.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The device's system log on the Programs tab: what programs write with `SYSLOG` and the errors
+ * they do not handle, newest first, with links to the program line of an error. Read from the
+ * device when shown and on Refresh.
+ */
+export declare function EdgeDeviceLog({ endpointId, deviceLogging, settingsPending, canEdit, onOpenSettings, onShowLine, }: {
+    endpointId: string;
+    /** Device-side logging is on in the endpoint's edge settings. */
+    deviceLogging: boolean;
+    /** Logging settings were saved on the device and apply after it restarts. */
+    settingsPending: boolean;
+    canEdit: boolean;
+    onOpenSettings: () => void;
+    onShowLine: (programId: string, line: number) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/dialogs.d.ts

@@ -0,0 +1,16 @@
+import { type EdgeProgram } from "@overvis/hmi-shared/endpoint";
+/** Creates a program (without `program`) or renames one. */
+export declare function EdgeProgramNameDialog({ workspaceId, endpointId, program, onClose, onSaved, }: {
+    workspaceId: string;
+    endpointId: string;
+    program?: EdgeProgram;
+    onClose: () => void;
+    onSaved: (programId: string) => void;
+}): import("react").JSX.Element;
+/** Confirms deleting a program. */
+export declare function EdgeProgramDeleteDialog({ workspaceId, program, onClose, onDeleted, }: {
+    workspaceId: string;
+    program: EdgeProgram;
+    onClose: () => void;
+    onDeleted: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/live-state-pane.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The program's live state on the device, for the editor's bottom pane: the task's run
+ * statistics, its variables and its conditions. The device is read only while this is shown.
+ */
+export declare function EdgeLiveStatePane({ programId }: {
+    programId: string;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/program-editor.d.ts

@@ -0,0 +1,79 @@
+import { type ReactNode, type RefObject } from "react";
+import { type EdgeProgramDetail, type EdgeProgramSource } from "@overvis/hmi-shared/endpoint";
+import { type TaskfileHmiParameter, type TaskfileLanguageService, type TaskfileLocation } from "@overvis/hmi-shared/taskfile";
+import { type CodeEditorHandle } from "../../../../code-editor/code-editor.js";
+import type { EdgeProgramDraft } from "./starter-dialog.js";
+/** What "Start from an example" puts into an empty program. */
+export declare const EDGE_PROGRAM_EXAMPLE = "@PROTOCOLVERSION 12\n@UPDATE 60\n\nDEF counter VAR\n\nrun:\nIF ISNOTKNOWN counter\nPUT counter 0\nPUT counter ADD counter 1\nEXIT OK\n";
+/**
+ * The language service of the program `fileName` as the device sees it: checked with the other
+ * enabled programs of the device in load order when it is deployed (enabled, with text), on its
+ * own otherwise or while the others load.
+ */
+export declare function edgeProgramLanguageService(fileName: string, deployed: boolean, others: readonly EdgeProgramSource[] | null, parameters: readonly TaskfileHmiParameter[] | null, ownUnitId: number | null): TaskfileLanguageService;
+/** `source` with the LF line endings the editor holds. */
+export declare function editorText(source: string): string;
+/** The text range of a one-based `line` of `text`, for revealing it. */
+export declare function lineRange(text: string, line: number): {
+    from: number;
+    to: number;
+};
+/** Asks before leaving the page, or another program, with unsaved changes. */
+export declare function DiscardChangesDialog({ fileName, onKeep, onDiscard, }: {
+    fileName: string;
+    onKeep: () => void;
+    onDiscard: () => void;
+}): import("react").JSX.Element;
+/**
+ * The main column of the Programs panel for one program: a toolbar with its name, controls and
+ * Save, the source editor with taskfile highlighting and the validator's problems marked as it is
+ * typed (checked with the device's other programs, as the device loads them), a status line, and
+ * a bottom pane with the problems, the tasks the device runs and, for editors, the program's live
+ * variables.
+ */
+export declare function EdgeProgramEditor({ workspaceId, detail, others, autoSync, canEdit, editorRef, title, actions, tasks, taskCount, variables, onReload, fetchLatest, onDirtyChange, onOpenLocation, }: {
+    workspaceId: string;
+    detail: EdgeProgramDetail;
+    /** The device's other programs, or null while they load. */
+    others: readonly EdgeProgramSource[] | null;
+    autoSync: boolean;
+    canEdit: boolean;
+    editorRef: RefObject<CodeEditorHandle | null>;
+    /** The program's name, or a program picker on narrow screens, at the toolbar's start. */
+    title: ReactNode;
+    /** The program's controls, before Save. */
+    actions: ReactNode;
+    /** The tasks the device runs, for the bottom pane. */
+    tasks: ReactNode;
+    taskCount: number;
+    /** The program's live state, for the bottom pane; null hides its tab. Mounted only while shown. */
+    variables: ReactNode;
+    /** Reopens the editor on the latest saved version, dropping unsaved edits. */
+    onReload: () => Promise<void>;
+    /** Fetches the latest saved version without reopening the editor. */
+    fetchLatest: () => Promise<EdgeProgramDetail>;
+    /** Told whether the editor holds unsaved changes. */
+    onDirtyChange: (dirty: boolean) => void;
+    /** Opens a place in another program of the device. */
+    onOpenLocation?: (location: TaskfileLocation) => void;
+}): import("react").JSX.Element;
+/**
+ * The main column for a program a starter built and nobody saved yet. Save creates the program,
+ * then the parameters the starter adds; Discard drops it. Leaving asks first, as with edits.
+ */
+export declare function EdgeProgramDraftEditor({ workspaceId, endpointId, draft, others, autoSync, editorRef, tasks, taskCount, onDiscard, onCreated, onDirtyChange, }: {
+    workspaceId: string;
+    endpointId: string;
+    draft: EdgeProgramDraft;
+    /** The device's other programs, or null while they load. */
+    others: readonly EdgeProgramSource[] | null;
+    autoSync: boolean;
+    editorRef: RefObject<CodeEditorHandle | null>;
+    tasks: ReactNode;
+    taskCount: number;
+    onDiscard: () => void;
+    /** The program is saved: open it, unless this draft was left while it saved. */
+    onCreated: (programId: string) => void;
+    /** Told whether the draft is still unsaved. */
+    onDirtyChange: (dirty: boolean) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/programs-tab.d.ts

@@ -0,0 +1,14 @@
+import type { EdgeDeployStatusFeed } from "../../../edge-programs/deploy-status.js";
+/**
+ * The Programs tab of an MC252 endpoint: where the device's programs stand, its programs with an
+ * editor, its program settings, the tasks it runs and its log. Editing needs Setup write access.
+ */
+export declare function SetupEndpointProgramsTab({ workspaceId, endpointId, deploy, canEdit, programId, onProgramChange, }: {
+    workspaceId: string;
+    endpointId: string;
+    deploy: EdgeDeployStatusFeed;
+    canEdit: boolean;
+    /** The program open in the editor; the first one when undefined. */
+    programId?: string;
+    onProgramChange: (programId: string | undefined) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/settings-dialog.d.ts

@@ -0,0 +1,9 @@
+import type { EdgeSettingsOutput } from "@overvis/hmi-shared/endpoint";
+/** A device's edge settings: auto-sync, device-side logging and the readings import period. */
+export declare function EdgeSettingsDialog({ workspaceId, settings, onReload, onClose, }: {
+    workspaceId: string;
+    settings: EdgeSettingsOutput;
+    /** Loads the latest settings and reopens the dialog on them. */
+    onReload: () => Promise<void>;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/starter-dialog.d.ts

@@ -0,0 +1,17 @@
+import { type EdgeProgramStarter, type EdgeProgramStarterResult } from "@overvis/hmi-shared/endpoint";
+/** A program a starter built, open unsaved in the editor until it is saved or discarded. */
+export interface EdgeProgramDraft extends EdgeProgramStarterResult {
+    readonly starterName: EdgeProgramStarter["name"];
+}
+/**
+ * Programs tab → From a starter: choose a starter, fill in its placeholders for this MC252, and
+ * open the program it builds, unsaved, in the editor.
+ */
+export declare function EdgeProgramStarterDialog({ workspaceId, endpointId, fileNames, onClose, onBuilt, }: {
+    workspaceId: string;
+    endpointId: string;
+    /** The device's programs, whose names a new one must not take. */
+    fileNames: readonly string[];
+    onClose: () => void;
+    onBuilt: (draft: EdgeProgramDraft) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/programs/tasks-table.d.ts

@@ -0,0 +1,5 @@
+import type { EdgeDeployStatus } from "@overvis/hmi-shared/endpoint";
+/** The tasks the device reported after it last loaded its programs, for the bottom pane. */
+export declare function EdgeTasksTable({ tasks }: {
+    tasks: EdgeDeployStatus["tasks"];
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/sharing.d.ts

@@ -0,0 +1,9 @@
+/**
+ * One line inside the connection status strip: the other workspaces that hold this MC252, and
+ * the disconnect action for editors. Renders nothing when no other workspace holds it.
+ */
+export declare function EndpointSharingRow({ workspaceId, endpointId, pinCode, }: {
+    workspaceId: string;
+    endpointId: string;
+    pinCode: string | null;
+}): import("react").JSX.Element | null;

package/dist/src/workspace/setup/endpoints/status-connection.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import type { Endpoint } from "@overvis/hmi-shared/endpoint";
+export declare function SetupEndpointConnectionPage({ endpointId, endpoint, statusDetails, }: {
+    endpointId: string;
+    endpoint: Endpoint;
+    /** Extra full-width line at the end of the status strip. */
+    statusDetails?: ReactNode;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/status-device-ui-progress.d.ts

@@ -0,0 +1,9 @@
+import type { DeviceUiProgressMessage } from "@overvis/hmi-shared/endpoint";
+/** Percent of the announced bytes that have arrived, or `null` while no size is known yet. */
+export declare function deviceUiLoadPercent(progress: DeviceUiProgressMessage | null): number | null;
+/** True while the device page still has files waiting or transferring. */
+export declare function deviceUiFilesPending(progress: DeviceUiProgressMessage | null): boolean;
+/** Covers the device frame while the device's page files arrive over a slow connection. */
+export declare function DeviceUiLoadOverlay({ progress }: {
+    progress: DeviceUiProgressMessage | null;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/status-device-ui.d.ts

@@ -0,0 +1,8 @@
+import type { MintDeviceUiTicket } from "../../context.js";
+export declare function SetupEndpointDeviceUiPage({ mintTicket, endpointId, kind, onTicketUrl, resolveDeviceUiOrigin, }: {
+    mintTicket: MintDeviceUiTicket;
+    endpointId: string;
+    kind: "direct" | "pin" | "wireguard";
+    onTicketUrl: (url: string | null) => void;
+    resolveDeviceUiOrigin?: (configuredOrigin: string) => string;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/status-page.d.ts

@@ -0,0 +1,14 @@
+import { type RecordedAddress } from "./status-recorded.js";
+import type { EndpointStatusTab } from "./status-tab.js";
+export declare function SetupEndpointStatusPage({ workspaceId, endpointId, tab, onTabChange, programId, onProgramChange, onCreateParameter, resolveDeviceUiOrigin, }: {
+    workspaceId: string;
+    endpointId: string;
+    tab?: EndpointStatusTab;
+    onTabChange?: (tab: EndpointStatusTab) => void;
+    /** The program open on the Programs tab of an MC252. */
+    programId?: string;
+    onProgramChange?: (programId: string | undefined) => void;
+    /** Opens the parameter form for an address the device recorded readings of. */
+    onCreateParameter?: (address: RecordedAddress) => void;
+    resolveDeviceUiOrigin?: (configuredOrigin: string) => string;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/status-recorded.d.ts

@@ -0,0 +1,13 @@
+import type { DeviceLogAddress } from "@overvis/hmi-shared/endpoint";
+/** A recorded address a new parameter starts from; its history is filled in once it is saved. */
+export type RecordedAddress = Pick<DeviceLogAddress, "unitId" | "table" | "address"> & {
+    endpointId: string;
+};
+/**
+ * Addresses the device's programs recorded readings of that no parameter of the endpoint reads.
+ * Creating a parameter for one fills its history from the stored records.
+ */
+export declare function SetupEndpointRecordedPage({ endpointId, onCreateParameter, }: {
+    endpointId: string;
+    onCreateParameter?: (address: RecordedAddress) => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/endpoints/status-tab.d.ts

@@ -0,0 +1,12 @@
+export type EndpointStatusTab = "connection" | "programs" | "recorded" | "device-ui";
+export declare function parseEndpointStatusTab(value: unknown): EndpointStatusTab;
+/** The program open on the Programs tab, or undefined for none. */
+export declare function parseEndpointStatusProgram(value: unknown): string | undefined;
+/**
+ * Search of the endpoint status page: `tab` is omitted for the default (connection) tab, and
+ * `program` names the program open on the Programs tab.
+ */
+export declare function parseEndpointStatusSearch(search: Record<string, unknown>): {
+    tab?: EndpointStatusTab;
+    program?: string;
+};

package/dist/src/workspace/setup/endpoints/wireguard-docs.d.ts

@@ -0,0 +1,11 @@
+import { type ReactNode } from "react";
+export declare function useWireGuardDocs(): {
+    open: (endpointId: string) => void;
+};
+export declare function WireGuardDocsProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function WireGuardDocsDialog({ endpointId, onClose, }: {
+    endpointId: string;
+    onClose: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/files/errors.d.ts

@@ -0,0 +1 @@
+export declare function ingestJobErrorMessage(errorCode: string | undefined): string;

package/dist/src/workspace/setup/files/http.d.ts

@@ -0,0 +1,21 @@
+import type { UploadsUploadOutput } from "@overvis/hmi-shared/workspace";
+export interface WorkspaceUploadHost {
+    apiBaseUrl: string;
+    credentials: RequestCredentials;
+    getHeaders?: () => HeadersInit;
+}
+export declare function postWorkspaceUpload(input: {
+    workspaceId: string;
+    file: File;
+    host: WorkspaceUploadHost;
+    signal?: AbortSignal;
+}): Promise<UploadsUploadOutput>;
+export declare function downloadWorkspaceUpload(input: {
+    workspaceId: string;
+    name: string;
+    kind: "file" | "dir";
+    host: WorkspaceUploadHost;
+}): Promise<{
+    filename: string;
+    blob: Blob;
+}>;

package/dist/src/workspace/setup/files/page.d.ts

@@ -0,0 +1,3 @@
+export declare function SetupFilesPage({ workspaceId }: {
+    workspaceId: string;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/menu.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dropdown into Setup from the dashboard view. Once inside, the sidebar lists the sections. Render
+ * it only for editors, admins and owners.
+ */
+export declare function SetupMenu({ workspaceId, collapsed, variant, size, className, label, onNavigate, }: {
+    workspaceId: string;
+    collapsed?: boolean;
+    variant?: "outline" | "default" | "ghost";
+    size?: "sm" | "default";
+    className?: string;
+    /** Override trigger label (default: Setup…). */
+    label?: string;
+    onNavigate?: () => void;
+}): import("react").JSX.Element;

package/dist/src/workspace/setup/nav.d.ts

@@ -0,0 +1,11 @@
+import { type SetupSectionId } from "./sections.js";
+/**
+ * Sidebar contents while a Setup section is open: a way back to the dashboard view, a separator
+ * with a small "Setup" group label, then one row per section with the current one highlighted.
+ */
+export declare function SetupNav({ workspaceId, activeSection, collapsed, onNavigate, }: {
+    workspaceId: string;
+    activeSection: SetupSectionId;
+    collapsed: boolean;
+    onNavigate?: () => void;
+}): import("react").JSX.Element;