build69
build69  /  Components  /  JobProgress /  Source

JobProgress

One long-running operation that is happening on a SERVER — a move, copy, delete, archive or any kind a host names. Distinct from UploadTray, which counts the bytes it is sending and therefore always knows the percentage: here the host POLLS and gets whatever the server chose to report, so percent is OPTIONAL and a job with no size yet draws an indeterminate bar rather than a zero that reads as stalled. Queued, running, paused, done, failed and cancelled each have their own word, bar and controls, and a failed job shows the server's own message verbatim. JobProgressList stacks several under one heading.

Open docs← Back to catalog
3 files2 dependenciestokens resolved ✓
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
"use client";

import * as React from "react";
import { cn } from "@/lib/utils";
import { surface, type Tone, type Emphasis } from "@/lib/recipes";

// JobProgress — One long-running operation that is happening on a SERVER — a move, copy, delete, archive
export interface JobProgressProps extends React.ComponentProps<"div"> {
  /** Semantic role: which accent the component uses. */
  tone?: Tone;
  /** Visual loudness: how prominent it reads. */
  emphasis?: Emphasis;
}

export function JobProgress({
  className,
  tone = "primary",
  emphasis = "solid",
  ...props
}: JobProgressProps) {
  return (
    <div
      data-slot="job-progress"
      data-tone={tone}
      data-emphasis={emphasis}
      className={cn(
        "inline-flex items-center gap-2 rounded-lg transition-colors",
        surface(tone, emphasis),
        className,
      )}
      {...props}
    />
  );
}