@elaraai/e3-ui-components 1.0.83 → 1.0.85

package/README.md

@@ -64,38 +64,145 @@ const { data } = useTaskList(apiUrl, repo, workspace, requestOptions, {
 });
 ```
 
+### Recovering a failed read
+
+A view on a screen no one touches, such as a kiosk's, has no one to reload it.
+`useQueryRecovery` tries a failed query again by itself while the view is
+mounted, as every stage of `UITaskPreview` does. It waits a random point in the
+second half of a backoff from 1 s to 30 s (`recoveryDelay`), and shows the
+latest failure through each try, never loading again.
+
+```tsx
+import { StatusDisplay, useQueryRecovery, useTaskGet } from '@elaraai/e3-ui-components';
+
+const details = useTaskGet(apiUrl, repo, workspace, task);
+const failure = useQueryRecovery(details); // null once it reads
+if (failure !== null) return <StatusDisplay variant="error" title="Error" message={failure.message} />;
+```
+
 ## Components
 
 ### TaskPreview
 
-Displays task execution output and logs with a virtualized log viewer.
+Previews a task by its role: a `ui()` task renders its UI; a data task shows its
+output (Output) and its logs (Logs) under a band holding the Output/Logs switch.
+Above the output are its key search, size and Download, and above its tree
+Collapse all and Expand all; above the log, its stdout/stderr tabs, its search
+and Copy.
 
 ```tsx
 import { TaskPreview } from '@elaraai/e3-ui-components';
 
-<TaskPreview apiUrl={url} workspace={ws} task={taskName} taskInfo={info} outputHash={hash} />
+<TaskPreview apiUrl={url} repo="default" workspace={ws} task={taskName} />
+```
+
+| Prop | Meaning |
+|------|---------|
+| `apiUrl`, `repo`, `workspace`, `task` | **required** — the task to preview |
+| `requestOptions` | the token, and the `fetch` every request goes through |
+| `bare` | no task-name header, and a `ui()` task's output edge to edge — for a kiosk |
+| `toolbar` | `false` draws no band anywhere in a data task's preview — no switch, nothing above the output or its tree, nothing above the log, which fills the view edge to edge; the host draws the controls. Default `true` |
+| `view`, `onViewChange` | a data task's tab, `'output'` or `'logs'`, controlled |
+| `search`, `onSearchChange` | the output's key search, controlled: a given `search` is found and scrolled to (`''` clears), and the preview draws no search box of its own; otherwise `onSearchChange` hears the preview's own box |
+| `logStream`, `onLogStreamChange` | the log's stream, `'stdout'` or `'stderr'`, controlled |
+| `logSearch`, `onLogSearchChange` | the log's search, controlled: a given `logSearch` marks its matches, in any case, and scrolls to the first (`''` clears), and the log draws no search box, count or chevrons of its own; otherwise `onLogSearchChange` hears the log's own box |
+| `onLogMatchesChange` | told `{ current, count }` — the log's match shown, from 0, and how many there are — whenever either changes |
+| `controls` | the handle the host's own buttons act through, made with `usePreviewControls()` |
+
+A host whose frame holds its controls in its header draws them itself and hides
+the bands:
+
+```tsx
+import {
+    TaskPreview, downloadDataset, formatSize, usePreviewControls, useDatasetStatus, useTaskDetails, type LogMatches,
+} from '@elaraai/e3-ui-components';
+
+const [view, setView] = useState<'output' | 'logs'>('output');
+const [search, setSearch] = useState('');
+const [stream, setStream] = useState<'stdout' | 'stderr'>('stdout');
+const [logSearch, setLogSearch] = useState('');
+const [matches, setMatches] = useState<LogMatches>({ current: 0, count: 0 });
+const controls = usePreviewControls();
+const details = useTaskDetails(url, 'default', ws, taskName);
+const output = details.data?.output.path.map((step) => step.value).join('.') ?? null;
+const status = useDatasetStatus(url, 'default', ws, output);
+
+// In the header, at the header's size: the tab; on Output, the search, the size,
+// Download, and Collapse all and Expand all; on Logs, the stream, the search,
+// `${matches.current + 1}/${matches.count}`, the chevrons and Copy.
+// In the body:
+<TaskPreview apiUrl={url} repo="default" workspace={ws} task={taskName} bare
+    toolbar={false} view={view} onViewChange={setView} search={search}
+    logStream={stream} onLogStreamChange={setStream} logSearch={logSearch}
+    onLogMatchesChange={setMatches} controls={controls} />
+// Download: downloadDataset(url, 'default', ws, output); the size: formatSize(status.data.sizeBytes)
+// Collapse all: controls.collapseAll(); Expand all: controls.expandAll()
+// The chevrons: controls.previousMatch(), controls.nextMatch(); Copy: controls.copyLog()
+```
+
+`search` is read as the preview's own search box reads its text: a key's
+prefix, a struct key's leading fields (`press, 2`), a `from..to` range, or a
+whole key in `.east` syntax.
+
+`usePreviewControls()` makes the handle. `collapseAll()` and `expandAll()` act
+on the output's tree; `nextMatch()` and `previousMatch()` step through the
+log's matches, from the last round to the first and back; and `copyLog()`
+copies the log shown, resolving `true` once it is on the clipboard and `false`
+when the clipboard refuses it. Each does nothing while its view is not shown —
+the Output tab shows no log, and a value too large to show has no tree. A
+handle serves one preview at a time, and holds no query, so a header outside
+`<E3Provider>` can make it.
+
+### DatasetPreview
+
+Shows a dataset's value: a tree, inline while it is small, a page at a time
+for a read-only collection, and a Download for a value too large to show.
+`editable` writes a mutable input's edits back. `toolbar`, `search`,
+`onSearchChange` and `controls` are `TaskPreview`'s, for the value alone.
+
+```tsx
+import { DatasetPreview } from '@elaraai/e3-ui-components';
+
+<DatasetPreview apiUrl={url} repo="default" workspace={ws} path="inputs.threshold" editable />
 ```
 
 ### InputPreview
 
-Displays dataset input values with type-aware rendering.
+Shows an input's value, editable, under a band naming the input.
 
 ```tsx
 import { InputPreview } from '@elaraai/e3-ui-components';
 
-<InputPreview apiUrl={url} workspace={ws} path={datasetPath} inputInfo={info} />
+<InputPreview apiUrl={url} repo="default" workspace={ws} path=".inputs.threshold" />
 ```
 
+`bare` draws no band naming the input, for a host whose frame names it, and
+`toolbar`, `search`, `onSearchChange` and `controls` reach the value's
+`DatasetPreview`.
+
 ### VirtualizedLogViewer
 
-Performant log viewer with search, copy, and auto-scroll.
+A log, its lines virtualized, under a band holding the stdout/stderr tabs, a
+search that marks its matches and steps through them, and Copy. It follows the
+log's end while it is there, and says when new lines arrive while it is not.
 
 ```tsx
+import { useTabs } from '@chakra-ui/react';
 import { VirtualizedLogViewer } from '@elaraai/e3-ui-components';
 
-<VirtualizedLogViewer lines={logLines} isLive={isRunning} />
+const tabs = useTabs({ defaultValue: 'stdout' });
+
+<VirtualizedLogViewer content={tabs.value === 'stderr' ? stderr : stdout} tabs={tabs} />
 ```
 
+| Prop | Meaning |
+|------|---------|
+| `content`, `tabs` | **required** — the log's text, and the tabs `useTabs` makes |
+| `toolbar` | `false` draws no band, and the log fills the view edge to edge, with no inset, corners or border. Default `true` |
+| `search`, `onSearchChange` | the search, controlled, as `TaskPreview`'s `logSearch` |
+| `onMatchesChange` | told `{ current, count }` whenever either changes |
+| `controlsRef` | given a `LogViewerControls` — `nextMatch()`, `previousMatch()` and `copy()` — while the view is mounted |
+
 ### StatusDisplay
 
 Status feedback component with error, warning, info, and loading variants.

package/dist/components/DataTaskPreview.d.ts

@@ -1,4 +1,6 @@
 import { RequestOptions } from '@elaraai/e3-api-client';
+import { PreviewControls } from './preview-controls.js';
+import { LogMatches } from './VirtualizedLogViewer.js';
 type ViewMode = 'output' | 'logs';
 export interface DataTaskPreviewProps {
     apiUrl: string;
@@ -6,10 +8,42 @@ export interface DataTaskPreviewProps {
     workspace: string;
     task: string;
     requestOptions?: RequestOptions;
-    /** Initially selected tab. Default 'output'. */
+    /** Initially selected tab, when `view` is not given. Default 'output'. */
     initialView?: ViewMode;
+    /** The tab, controlled (#1120): the preview shows it, and tells
+     *  `onViewChange` of a switch rather than making it. */
+    view?: ViewMode;
+    /** Told the tab the preview's switch picks. */
+    onViewChange?: (view: ViewMode) => void;
     /** Max output bytes to render inline (above → download button). Default 200KB. */
     sizeLimit?: number;
+    /** `false` draws no band — no Output/Logs switch; no key search, size or
+     *  Download above the output (#1120), nor its tree's Collapse all and
+     *  Expand all; and no tabs, search or Copy above the log, which fills the
+     *  view (#1209). Default `true`. */
+    toolbar?: boolean;
+    /** The output's key search, controlled: see {@link DatasetPreviewProps.search}. */
+    search?: string;
+    /** Told the text of the output's own search box: see {@link DatasetPreviewProps.onSearchChange}. */
+    onSearchChange?: (search: string) => void;
+    /** The log's stream, controlled (#1209): the log's tabs show it, and tell
+     *  `onLogStreamChange` of a click rather than switching. */
+    logStream?: 'stdout' | 'stderr';
+    /** Told the stream the log's tabs pick. */
+    onLogStreamChange?: (stream: 'stdout' | 'stderr') => void;
+    /** The log's search, controlled (#1209): the log draws no search box,
+     *  count or chevrons of its own, marks the text's matches in any case and
+     *  scrolls to the first; `''` clears. */
+    logSearch?: string;
+    /** Told the text of the log's own search box as it is edited, unless
+     *  `logSearch` is given. */
+    onLogSearchChange?: (search: string) => void;
+    /** Told the log's match shown (from 0) and how many there are whenever
+     *  either changes, for the host's "3/17" (#1209). */
+    onLogMatchesChange?: (matches: LogMatches) => void;
+    /** The handle a host's own controls act through, made with
+     *  `usePreviewControls` (#1209). */
+    controls?: PreviewControls;
 }
 export declare const DataTaskPreview: import('react').NamedExoticComponent<DataTaskPreviewProps>;
 export {};

package/dist/components/DataTaskPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/DataTaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAO7D,KAAK,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElC,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,eAAO,MAAM,eAAe,4DAoE1B,CAAC"}
+{"version":3,"file":"DataTaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/DataTaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,KAAK,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElC,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB;4DACwD;IACxD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACxC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;wCAGoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;gEAC4D;IAC5D,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC1D;;6CAEyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;gCAC4B;IAC5B,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C;yDACqD;IACrD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IACnD;wCACoC;IACpC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAMD,eAAO,MAAM,eAAe,4DAqG1B,CAAC"}

package/dist/components/DatasetPreview.d.ts

@@ -1,5 +1,6 @@
 import { RequestOptions } from '@elaraai/e3-api-client';
 import { Formatters } from '@elaraai/east-ui-components';
+import { PreviewControls } from './preview-controls.js';
 export interface DatasetPreviewProps {
     apiUrl: string;
     repo: string;
@@ -13,6 +14,21 @@ export interface DatasetPreviewProps {
     /** When set, leaf edits / inserts / removes / tag switches write back to
      *  this dataset path (for mutable inputs). Task outputs stay read-only. */
     editable?: boolean;
+    /** `false` draws no band above the value — no key search, size or
+     *  Download — for a host that draws them in its own header (#1120), and
+     *  no Collapse all and Expand all above the tree (#1209). A value too
+     *  large to show keeps its Download, which is the body. Default `true`. */
+    toolbar?: boolean;
+    /** The key search, controlled: the host draws its input, and the preview
+     *  draws no search box of its own. The text is read in the key search's
+     *  grammar and scrolled to its first match; `''` clears (#1120). */
+    search?: string;
+    /** Told the text of the preview's own search box as it is edited, unless
+     *  `search` is given. */
+    onSearchChange?: (search: string) => void;
+    /** The handle a host's own Collapse all and Expand all act on the tree
+     *  through, made with `usePreviewControls` (#1209). */
+    controls?: PreviewControls;
 }
 /**
  * Human-readable byte size, shared with the paged preview — its digits in the

package/dist/components/DatasetPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/DatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAIH,KAAK,UAAU,EAKlB,MAAM,6BAA6B,CAAC;AAWrC,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAOD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,UAAyB,GAAG,MAAM,CAIlF;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAYzF;AAED,eAAO,MAAM,cAAc,2DAoOzB,CAAC"}
+{"version":3,"file":"DatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/DatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAIH,KAAK,UAAU,EAKlB,MAAM,6BAA6B,CAAC;AAQrC,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7E,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mDAAmD;IACnD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;+EAC2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;+EAG2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;wEAEoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;6BACyB;IACzB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;2DACuD;IACvD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAOD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,UAAyB,GAAG,MAAM,CAIlF;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAYzF;AAED,eAAO,MAAM,cAAc,2DAsPzB,CAAC"}

package/dist/components/InputPreview.d.ts

@@ -1,10 +1,22 @@
 import { RequestOptions } from '@elaraai/e3-api-client';
+import { DatasetPreviewProps } from './DatasetPreview.js';
 export interface InputPreviewProps {
     apiUrl: string;
     repo: string;
     workspace: string;
     path: string;
     requestOptions?: RequestOptions;
+    /** No band naming the input, for a host whose frame names it, as
+     *  `TaskPreview`'s `bare` drops its own (#1209). Default `false`. */
+    bare?: boolean;
+    /** `false` draws no band above the value: see {@link DatasetPreviewProps.toolbar}. Default `true`. */
+    toolbar?: boolean;
+    /** The value's key search, controlled: see {@link DatasetPreviewProps.search}. */
+    search?: string;
+    /** Told the text of the value's own search box: see {@link DatasetPreviewProps.onSearchChange}. */
+    onSearchChange?: (search: string) => void;
+    /** The handle a host's own Collapse all and Expand all act through: see {@link DatasetPreviewProps.controls}. */
+    controls?: DatasetPreviewProps['controls'];
 }
 export declare const InputPreview: import('react').NamedExoticComponent<InputPreviewProps>;
 //# sourceMappingURL=InputPreview.d.ts.map

package/dist/components/InputPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputPreview.d.ts","sourceRoot":"","sources":["../../src/components/InputPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,eAAO,MAAM,YAAY,yDA6BuD,CAAC"}
+{"version":3,"file":"InputPreview.d.ts","sourceRoot":"","sources":["../../src/components/InputPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;yEACqE;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sGAAsG;IACtG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iHAAiH;IACjH,QAAQ,CAAC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED,eAAO,MAAM,YAAY,yDAgD6E,CAAC"}

package/dist/components/PagedDatasetPreview.d.ts

@@ -1,6 +1,7 @@
 import { DatasetPage, RequestOptions } from '@elaraai/e3-api-client';
 import { EastTypeValue } from '@elaraai/east';
 import { pruneRetainedPages } from '@elaraai/east-ui/internal';
+import { PreviewControls } from './preview-controls.js';
 /**
  * The page size to address pages by, given one landed page (#829).
  *
@@ -38,6 +39,20 @@ export interface PagedDatasetPreviewProps {
      *  contract). The parent falls back to the inline tree so pre-index
      *  values keep rendering instead of dead-ending here. */
     onNotIndexed?: () => void;
+    /** `false` draws no band above the rows — no totals, key search or
+     *  Download (#1120), nor the tree's Collapse all and Expand all (#1209).
+     *  Default `true`. */
+    toolbar?: boolean;
+    /** The key search, controlled: found on the server as the search box
+     *  finds a query, scrolled to its first match; the preview draws no
+     *  search box of its own (#1120). */
+    search?: string;
+    /** Told the text of the preview's own search box as it is edited, unless
+     *  `search` is given. */
+    onSearchChange?: (search: string) => void;
+    /** The handle a host's own Collapse all and Expand all act on the tree
+     *  through (#1209). */
+    controls?: PreviewControls;
 }
 export declare const PagedDatasetPreview: import('react').NamedExoticComponent<PagedDatasetPreviewProps>;
 //# sourceMappingURL=PagedDatasetPreview.d.ts.map

package/dist/components/PagedDatasetPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PagedDatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/PagedDatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAmB/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAC,GAC9D,MAAM,CAGR;AAWD;gFACgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oEAAoE;IACpE,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;6DAGyD;IACzD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAiCD,eAAO,MAAM,mBAAmB,gEAgOiC,CAAC"}
+{"version":3,"file":"PagedDatasetPreview.d.ts","sourceRoot":"","sources":["../../src/components/PagedDatasetPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAY/D,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,GAAG,eAAe,CAAC,GAC9D,MAAM,CAGR;AAWD;gFACgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,aAAa,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oEAAoE;IACpE,UAAU,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;6DAGyD;IACzD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;0BAEsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;yCAEqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;6BACyB;IACzB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;2BACuB;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAiCD,eAAO,MAAM,mBAAmB,gEA+OsE,CAAC"}

package/dist/components/TaskLogs.d.ts

@@ -1,3 +1,6 @@
+import { Ref } from 'react';
+import { LogMatches } from './VirtualizedLogViewer.js';
+import { LogViewerControls } from './preview-controls.js';
 import { RequestOptions } from '@elaraai/e3-api-client';
 export interface TaskLogsProps {
     apiUrl: string;
@@ -5,6 +8,22 @@ export interface TaskLogsProps {
     workspace: string;
     task: string;
     requestOptions?: RequestOptions;
+    /** The stream, controlled: the tabs show it, and a click tells
+     *  `onStreamChange` rather than switching (#1209). The view's own,
+     *  from `'stdout'`, when not given. */
+    stream?: 'stdout' | 'stderr' | undefined;
+    /** Told the stream the tabs pick. */
+    onStreamChange?: ((stream: 'stdout' | 'stderr') => void) | undefined;
+    /** `false` draws no band, and the log fills the view: see {@link VirtualizedLogViewer}. */
+    toolbar?: boolean | undefined;
+    /** The log's search, controlled: see {@link VirtualizedLogViewer}. */
+    search?: string | undefined;
+    /** Told the text of the view's own search box. */
+    onSearchChange?: ((search: string) => void) | undefined;
+    /** Told the match shown and how many there are. */
+    onMatchesChange?: ((matches: LogMatches) => void) | undefined;
+    /** Given the view's next and previous match and its Copy. */
+    controlsRef?: Ref<LogViewerControls> | undefined;
 }
 /**
  * Renders a virtualized log viewer for a task's stdout/stderr.

package/dist/components/TaskLogs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskLogs.d.ts","sourceRoot":"","sources":["../../src/components/TaskLogs.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,qDA4BnB,CAAC"}
+{"version":3,"file":"TaskLogs.d.ts","sourceRoot":"","sources":["../../src/components/TaskLogs.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;2CAEuC;IACvC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,qCAAqC;IACrC,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACrE,2FAA2F;IAC3F,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,kDAAkD;IAClD,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACxD,mDAAmD;IACnD,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D,6DAA6D;IAC7D,WAAW,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;CACpD;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,qDA2CnB,CAAC"}

package/dist/components/TaskPreview.d.ts

@@ -1,4 +1,5 @@
 import { RequestOptions } from '@elaraai/e3-api-client';
+import { DataTaskPreviewProps } from './DataTaskPreview.js';
 export interface TaskPreviewProps {
     apiUrl: string;
     repo: string;
@@ -11,6 +12,29 @@ export interface TaskPreviewProps {
      * `bare`) — for host kiosk embedding of a deployed `<App>`. Default `false`.
      */
     bare?: boolean;
+    /** A data task's tab, controlled: see {@link DataTaskPreviewProps.view}. */
+    view?: DataTaskPreviewProps['view'];
+    /** Told the tab a data task's switch picks. */
+    onViewChange?: DataTaskPreviewProps['onViewChange'];
+    /** `false` draws no band anywhere in a data task's preview (#1120,
+     *  #1209): see {@link DataTaskPreviewProps.toolbar}. Default `true`. */
+    toolbar?: boolean;
+    /** A data task's output's key search, controlled: see {@link DataTaskPreviewProps.search}. */
+    search?: string;
+    /** Told the text of the output's own search box: see {@link DataTaskPreviewProps.onSearchChange}. */
+    onSearchChange?: (search: string) => void;
+    /** A data task's log's stream, controlled: see {@link DataTaskPreviewProps.logStream}. */
+    logStream?: DataTaskPreviewProps['logStream'];
+    /** Told the stream the log's tabs pick. */
+    onLogStreamChange?: DataTaskPreviewProps['onLogStreamChange'];
+    /** A data task's log's search, controlled: see {@link DataTaskPreviewProps.logSearch}. */
+    logSearch?: string;
+    /** Told the text of the log's own search box: see {@link DataTaskPreviewProps.onLogSearchChange}. */
+    onLogSearchChange?: (search: string) => void;
+    /** Told the log's matches: see {@link DataTaskPreviewProps.onLogMatchesChange}. */
+    onLogMatchesChange?: DataTaskPreviewProps['onLogMatchesChange'];
+    /** The handle a host's own controls act through: see {@link DataTaskPreviewProps.controls}. */
+    controls?: DataTaskPreviewProps['controls'];
 }
 export declare const TaskPreview: import('react').NamedExoticComponent<TaskPreviewProps>;
 //# sourceMappingURL=TaskPreview.d.ts.map

package/dist/components/TaskPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/TaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,WAAW,wDA+CyC,CAAC"}
+{"version":3,"file":"TaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/TaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIlF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACpC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;IACpD;4EACwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,0FAA0F;IAC1F,SAAS,CAAC,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAC9D,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,oBAAoB,CAAC,oBAAoB,CAAC,CAAC;IAChE,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,WAAW,wDAgFsF,CAAC"}

package/dist/components/UITaskPreview.d.ts

@@ -12,7 +12,10 @@ export interface UITaskPreviewProps {
      */
     config?: E3Config;
     /**
-     * Poll interval (ms) for the manifest's declared reads. Default 1000ms.
+     * Poll interval (ms) for the manifest's declared reads while what they
+     * show changes: the workspace's poll backs off to 5 s once nothing has,
+     * and comes back to this on a change or when the viewer acts. Default
+     * 1000ms.
      */
     pollInterval?: number;
     /**

package/dist/components/UITaskPreview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UITaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/UITaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAyCH,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAY9E,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,eAAO,MAAM,aAAa,0DA8HxB,CAAC"}
+{"version":3,"file":"UITaskPreview.d.ts","sourceRoot":"","sources":["../../src/components/UITaskPreview.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAiDH,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAahG,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,eAAO,MAAM,aAAa,0DAoIxB,CAAC"}

package/dist/components/VirtualizedLogViewer.d.ts

@@ -1,7 +1,35 @@
+import { Ref } from 'react';
 import { UseTabsReturn } from '@chakra-ui/react';
+import { LogViewerControls } from './preview-controls.js';
+/** The search's matches, as a host's "3/17" shows them (#1209). */
+export interface LogMatches {
+    /** The match shown, from 0; 0 while there are none. */
+    current: number;
+    /** How many matches the log has. */
+    count: number;
+}
 export interface VirtualizedLogViewerProps {
+    /** The log's text. */
     content: string;
+    /** The stdout/stderr tabs the band shows. */
     tabs: UseTabsReturn;
+    /** `false` draws no band — no tabs, search, match count or chevrons, or
+     *  Copy — and the log fills the view edge to edge, with no inset, corners
+     *  or border, for the host's frame to hold (#1209). Default `true`. */
+    toolbar?: boolean | undefined;
+    /** The search, controlled: the view draws no search box, count or
+     *  chevrons of its own, marks the text's matches in any case, and scrolls
+     *  to the first; `''` clears (#1209). */
+    search?: string | undefined;
+    /** Told the text of the view's own search box as it is edited, unless
+     *  `search` is given. */
+    onSearchChange?: ((search: string) => void) | undefined;
+    /** Told the match shown and how many there are whenever either changes
+     *  (#1209). */
+    onMatchesChange?: ((matches: LogMatches) => void) | undefined;
+    /** Given the view's next and previous match and its Copy while it is
+     *  mounted, for a host's own controls (#1209). */
+    controlsRef?: Ref<LogViewerControls> | undefined;
 }
-export declare function VirtualizedLogViewer({ content, tabs }: VirtualizedLogViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare function VirtualizedLogViewer({ content, tabs, toolbar, search, onSearchChange, onMatchesChange, controlsRef, }: VirtualizedLogViewerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=VirtualizedLogViewer.d.ts.map

package/dist/components/VirtualizedLogViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VirtualizedLogViewer.d.ts","sourceRoot":"","sources":["../../src/components/VirtualizedLogViewer.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAqC,KAAK,aAAa,EAAgB,MAAM,kBAAkB,CAAC;AAUvG,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACvB;AA2DD,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,yBAAyB,2CAmVhF"}
+{"version":3,"file":"VirtualizedLogViewer.d.ts","sourceRoot":"","sources":["../../src/components/VirtualizedLogViewer.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA8G,KAAK,GAAG,EAAE,MAAM,OAAO,CAAC;AAE7I,OAAO,EAA+B,KAAK,aAAa,EAA+D,MAAM,kBAAkB,CAAC;AAGhJ,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAU/D,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACvB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACtC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,aAAa,CAAC;IACpB;;2EAEuE;IACvE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;6CAEyC;IACzC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;6BACyB;IACzB,cAAc,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACxD;mBACe;IACf,eAAe,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D;sDACkD;IAClD,WAAW,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;CACpD;AAuCD,wBAAgB,oBAAoB,CAAC,EACjC,OAAO,EACP,IAAI,EACJ,OAAc,EACd,MAAM,EACN,cAAc,EACd,eAAe,EACf,WAAW,GACd,EAAE,yBAAyB,2CA+T3B"}

package/dist/components/controlled-search.d.ts

@@ -0,0 +1,22 @@
+import { EastTypeValue } from '@elaraai/east';
+import { DatasetKeyMatchRange, DatasetKeyQuery } from '@elaraai/east-ui-components';
+/** How long a paged preview waits for the text to hold before it finds it, as its search box does: each find is a request. */
+export declare const SEARCH_DEBOUNCE_MS = 250;
+/**
+ * Finds a controlled search's text and jumps to its first match.
+ *
+ * @param search - The host's text, or `undefined` when the host does not
+ *   control the search
+ * @param keyType - The collection's key type, or `null` when it has no keys
+ *   to search
+ * @param onFind - Locates a query, as the search box's own `onFind` does
+ * @param onJump - Jumps the tree to a row, or clears its jump given
+ *   `undefined`
+ * @param debounceMs - How long the text must hold before it is found
+ *
+ * @remarks
+ * `''`, a text the grammar refuses and a text with no match each clear the
+ * jump. A find the text has since moved past is dropped.
+ */
+export declare function useControlledKeySearch(search: string | undefined, keyType: EastTypeValue | null, onFind: (query: DatasetKeyQuery) => Promise<DatasetKeyMatchRange>, onJump: (row: number | undefined) => void, debounceMs: number): void;
+//# sourceMappingURL=controlled-search.d.ts.map

package/dist/components/controlled-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlled-search.d.ts","sourceRoot":"","sources":["../../src/components/controlled-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAiB,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE7G,8HAA8H;AAC9H,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,oBAAoB,CAAC,EACjE,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,EACzC,UAAU,EAAE,MAAM,GACnB,IAAI,CAoBN"}

package/dist/components/preview-controls.d.ts

@@ -0,0 +1,73 @@
+import { RefObject } from 'react';
+import { ValueTreeControls } from '@elaraai/east-ui-components';
+/** What a log view does for a host's own controls (#1209). */
+export interface LogViewerControls {
+    /** Goes to the search's next match, after the last its first, as the band's chevron does. */
+    nextMatch(): void;
+    /** Goes to the search's previous match, before the first its last, as the band's chevron does. */
+    previousMatch(): void;
+    /**
+     * Copies the log shown, as the band's Copy does.
+     *
+     * @returns `true` once the log is on the clipboard, `false` when the
+     *   clipboard refuses it
+     */
+    copy(): Promise<boolean>;
+}
+/**
+ * What a host's header does to the preview it is given to (#1209). Each
+ * method does nothing while its view is not mounted: the Output tab shows no
+ * log, and a value too large to show has no tree.
+ */
+export interface PreviewControls {
+    /** Collapses every row of the value's tree, as its Collapse all does. */
+    collapseAll(): void;
+    /** Expands every row of the value's tree, as its Expand all does. */
+    expandAll(): void;
+    /** Goes to the log search's next match, as the log's chevron does. */
+    nextMatch(): void;
+    /** Goes to the log search's previous match, as the log's chevron does. */
+    previousMatch(): void;
+    /**
+     * Copies the log shown, as the log's Copy does.
+     *
+     * @returns `true` once the log is on the clipboard, `false` when no log
+     *   is shown or the clipboard refuses it
+     */
+    copyLog(): Promise<boolean>;
+}
+/**
+ * Makes the handle a host gives a preview as `controls`, to draw the
+ * preview's controls in its own header (#1209).
+ *
+ * @returns A handle that stays the same for the life of the component, and
+ *   serves one preview at a time
+ *
+ * @remarks
+ * It holds no query, so a header outside `<E3Provider>` can make it.
+ *
+ * @example
+ * ```tsx
+ * const controls = usePreviewControls();
+ *
+ * <Button onClick={controls.collapseAll}>Collapse all</Button>
+ * <TaskPreview apiUrl={url} repo="default" workspace={ws} task={task}
+ *     toolbar={false} controls={controls} />
+ * ```
+ */
+export declare function usePreviewControls(): PreviewControls;
+/**
+ * The ref a preview's value tree is given, for the controls it was given.
+ *
+ * @param controls - The host's handle, if it gave one
+ * @returns The tree's ref, or `undefined` without a handle
+ */
+export declare function treeControlsOf(controls: PreviewControls | undefined): RefObject<ValueTreeControls | null> | undefined;
+/**
+ * The ref a preview's log view is given, for the controls it was given.
+ *
+ * @param controls - The host's handle, if it gave one
+ * @returns The log view's ref, or `undefined` without a handle
+ */
+export declare function logControlsOf(controls: PreviewControls | undefined): RefObject<LogViewerControls | null> | undefined;
+//# sourceMappingURL=preview-controls.d.ts.map

package/dist/components/preview-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-controls.d.ts","sourceRoot":"","sources":["../../src/components/preview-controls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAC9B,6FAA6F;IAC7F,SAAS,IAAI,IAAI,CAAC;IAClB,kGAAkG;IAClG,aAAa,IAAI,IAAI,CAAC;IACtB;;;;;OAKG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,qEAAqE;IACrE,SAAS,IAAI,IAAI,CAAC;IAClB,sEAAsE;IACtE,SAAS,IAAI,IAAI,CAAC;IAClB,0EAA0E;IAC1E,aAAa,IAAI,IAAI,CAAC;IACtB;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B;AAUD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAcpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,SAAS,CAErH;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,SAAS,CAEpH"}

package/dist/diff/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diff/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AA2CH,OAAO,EAWH,KAAK,WAAW,EAQnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAmB,MAAM,yBAAyB,CAAC;AAwBhE,KAAK,SAAS,GAAG,WAAW,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AA62B3D,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,QAAA,MAAM,cAAc,2DAgbsC,CAAC;AAM3D,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diff/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AA2CH,OAAO,EAWH,KAAK,WAAW,EAQnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAmB,MAAM,yBAAyB,CAAC;AAwBhE,KAAK,SAAS,GAAG,WAAW,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AA82B3D,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,QAAA,MAAM,cAAc,2DAgbsC,CAAC;AAM3D,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/experiment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experiment/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH,OAAO,EAA4F,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3I,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA2CrD,KAAK,iBAAiB,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAuKzE,MAAM,WAAW,yBAAyB;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACtB;AAOD,QAAA,MAAM,oBAAoB,iEAsoB6E,CAAC;AAkZxG,OAAO,EAAE,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/experiment/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAkCH,OAAO,EAA4F,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3I,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAmDrD,KAAK,iBAAiB,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAuKzE,MAAM,WAAW,yBAAyB;IACtC,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACtB;AAOD,QAAA,MAAM,oBAAoB,iEAsoB6E,CAAC;AAkZxG,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/hooks/executions.d.ts

@@ -15,6 +15,20 @@ export declare function useDataflowGraph(url: string, repo: string, workspace: s
         readonly dependsOn: string[];
     }[];
 }, Error>;
+/**
+ * Polls a workspace's latest run: its state, with the events past
+ * `stateOptions.since`, at most `stateOptions.limit` of them, and the cursor
+ * past them (`nextSeq`).
+ *
+ * @param url - The API's base URL
+ * @param repo - Repository name
+ * @param workspace - Workspace name; nothing is polled while it is `null`
+ * @param stateOptions - The cursor to poll from, and the most events to serve:
+ *   `{ limit: 0 }` reads the run's state alone
+ * @param requestOptions - The request's token
+ * @param queryOptions - react-query overrides, such as a `refetchInterval`
+ * @returns The query of the run's state
+ */
 export declare function useDataflowExecution(url: string, repo: string, workspace: string | null, stateOptions?: ExecutionStateOptions, requestOptions?: RequestOptions, queryOptions?: QueryOverrides): UseQueryResult<DataflowExecutionState, Error>;
 export declare function useDataflowCancel(url: string, repo: string, workspace: string | null, requestOptions?: RequestOptions): UseMutationResult<void, Error, void, unknown>;
 export declare function useTaskLogs(url: string, repo: string, workspace: string | null, task: string | null, logOptions?: LogOptions, requestOptions?: RequestOptions, queryOptions?: QueryOverrides): UseQueryResult<{
@@ -23,5 +37,8 @@ export declare function useTaskLogs(url: string, repo: string, workspace: string
     readonly size: bigint;
     readonly totalSize: bigint;
     readonly complete: boolean;
+    readonly inputsHash: string;
+    readonly executionId: string;
+    readonly ended: boolean;
 }, Error>;
 //# sourceMappingURL=executions.d.ts.map

package/dist/hooks/executions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executions.d.ts","sourceRoot":"","sources":["../../src/hooks/executions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAE9K,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAAC,cAAc,EAAE,KAAK,EAAE;IAAE,eAAe,CAAC,EAAE,eAAe,CAAC;IAAC,WAAW,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAK3O;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,wEAKpH;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc;;;;;;;;UAOnJ;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,qBAAqB,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAO7O;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,iDAIrH;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc;;;;;;UAO5L"}
+{"version":3,"file":"executions.d.ts","sourceRoot":"","sources":["../../src/hooks/executions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAyB,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE3G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAM9K,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAAC,cAAc,EAAE,KAAK,EAAE;IAAE,eAAe,CAAC,EAAE,eAAe,CAAC;IAAC,WAAW,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAK3O;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,wEAKpH;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc;;;;;;;;UAOnJ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,CAAC,EAAE,qBAAqB,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAQ7O;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,cAAc,CAAC,EAAE,cAAc,iDAIrH;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,cAAc;;;;;;;;;UAO5L"}