Flag Export Ready Download

ProNew

A long-running export shown as one flag that moves from Preparing to Ready with a download link, or to Failed with a retry, so people can leave the page.

Customize

Derived from this item’s props table, because it declares no controls of its own. This item has no standalone playground, so changes update the code, the share link and the AI prompt.

name

Guide and examples

When to use it

Use this when a job takes longer than a click should: exports, reports, archives, imports.

Do not use it when the result is instant (just download it) or must be reviewed before saving (use a page).

Installation

This item is part of tealmac UI Pro

The source for this item installs with a Pro licence key. Log in with your key to see the install command, or read the Pro setup page.

Props

Prop	Type	Required	Description
`name`	`string`	required	-
`job`	`ExportJob`	required	-
`onRetry`	`() => void`	required	-
`onDismiss`	`() => void`	required	-

Accessibility

Each state is a flag; failure uses role=alert and the others role=status.
Preparing has no dismiss button, so the job cannot be hidden while running.
The download is a real link.

Testing

The pattern ships with a Testing Library test (flag-export-ready-download.test.tsx) that covers progress, the ready link with size, the failure with retry and dismissing.

Guide and examples

When to use it

Use this when a job takes longer than a click should: exports, reports, archives, imports.

Do not use it when the result is instant (just download it) or must be reviewed before saving (use a page).

Installation

This item is part of tealmac UI Pro

The source for this item installs with a Pro licence key. Log in with your key to see the install command, or read the Pro setup page.

Props

Prop	Type	Required	Description
`name`	`string`	required	-
`job`	`ExportJob`	required	-
`onRetry`	`() => void`	required	-
`onDismiss`	`() => void`	required	-

Accessibility

Each state is a flag; failure uses role=alert and the others role=status.
Preparing has no dismiss button, so the job cannot be hidden while running.
The download is a real link.

Testing

The pattern ships with a Testing Library test (flag-export-ready-download.test.tsx) that covers progress, the ready link with size, the failure with retry and dismissing.