@parallelworks/ui 0.18.0 → 0.19.0

package/dist/chunks/memoryStore-CC91S5LP.js

@@ -0,0 +1,152 @@
+import { t as ChatAdapterError } from "./types-Yy0NrerF.js";
+//#region src/ai/adapter/memoryStore.ts
+function newId() {
+	return crypto.randomUUID();
+}
+function createMemoryConversationStore(options) {
+	const storageKey = options?.storageKey;
+	let conversations = [];
+	if (storageKey) try {
+		const raw = globalThis.localStorage?.getItem(storageKey);
+		if (raw) conversations = JSON.parse(raw);
+	} catch {
+		conversations = [];
+	}
+	const persist = () => {
+		if (storageKey) try {
+			globalThis.localStorage?.setItem(storageKey, JSON.stringify(conversations));
+		} catch {}
+	};
+	const find = (id) => {
+		const conversation = conversations.find((c) => c.id === id);
+		if (!conversation) throw new ChatAdapterError("Conversation not found", { status: 404 });
+		return conversation;
+	};
+	const toSummary = (c) => ({
+		id: c.id,
+		...c.title !== null ? { title: c.title } : {},
+		messageCount: c.messages.length,
+		createdAt: c.createdAt,
+		updatedAt: c.updatedAt,
+		isOwner: true,
+		canCollaborate: true
+	});
+	const recordUser = (req) => {
+		const conversation = conversations.find((c) => c.id === req.conversationId);
+		if (!conversation) return;
+		const last = req.messages[req.messages.length - 1];
+		const userContent = typeof last?.content === "string" ? last.content : "";
+		conversation.messages.push({
+			id: req.userMessageId,
+			role: "user",
+			content: userContent,
+			parentId: req.parentMessageId ?? null,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		conversation.activeBranchId = req.userMessageId;
+		conversation.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		persist();
+	};
+	const recordAssistant = (req, assistant) => {
+		const conversation = conversations.find((c) => c.id === req.conversationId);
+		if (!conversation) return;
+		conversation.messages.push({
+			...assistant,
+			role: "assistant"
+		});
+		conversation.activeBranchId = assistant.id;
+		conversation.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		persist();
+	};
+	return {
+		conversations: {
+			async list() {
+				return [...conversations].sort((a, b) => b.createdAt.localeCompare(a.createdAt)).map(toSummary);
+			},
+			async get(id) {
+				const c = find(id);
+				return {
+					id: c.id,
+					title: c.title,
+					messages: [...c.messages],
+					activeBranchId: c.activeBranchId,
+					createdAt: c.createdAt,
+					updatedAt: c.updatedAt,
+					isOwner: true,
+					canCollaborate: true
+				};
+			},
+			async create(title) {
+				const now = (/* @__PURE__ */ new Date()).toISOString();
+				const conversation = {
+					id: newId(),
+					title: title ?? null,
+					createdAt: now,
+					updatedAt: now,
+					activeBranchId: null,
+					messages: []
+				};
+				conversations.push(conversation);
+				persist();
+				return toSummary(conversation);
+			},
+			async rename(id, title) {
+				find(id).title = title;
+				persist();
+			},
+			async remove(id) {
+				conversations = conversations.filter((c) => c.id !== id);
+				persist();
+			}
+		},
+		recordingStream(inner) {
+			return async (req, handlers, signal) => {
+				let partialContent = "";
+				let partialReasoning = "";
+				const wrappedHandlers = {
+					...handlers,
+					onContent: (chunk) => {
+						partialContent += chunk;
+						handlers.onContent(chunk);
+					},
+					onReasoning: (chunk) => {
+						partialReasoning += chunk;
+						handlers.onReasoning?.(chunk);
+					}
+				};
+				recordUser(req);
+				try {
+					const result = await inner(req, wrappedHandlers, signal);
+					const assistantId = result.messageId || newId();
+					recordAssistant(req, {
+						id: assistantId,
+						content: result.content || null,
+						parentId: req.userMessageId,
+						model: result.model ?? req.model,
+						...result.reasoning ? { reasoning: result.reasoning } : {},
+						...result.responsesOutput.length ? { responsesOutput: result.responsesOutput } : {},
+						...result.toolCalls.length ? { toolCalls: result.toolCalls } : {},
+						timestamp: (/* @__PURE__ */ new Date()).toISOString()
+					});
+					return {
+						...result,
+						messageId: assistantId
+					};
+				} catch (error) {
+					if (error instanceof DOMException && error.name === "AbortError" && (partialContent || partialReasoning)) recordAssistant(req, {
+						id: newId(),
+						content: partialContent || null,
+						parentId: req.userMessageId,
+						model: req.model,
+						...partialReasoning ? { reasoning: partialReasoning } : {},
+						stopped: true,
+						timestamp: (/* @__PURE__ */ new Date()).toISOString()
+					});
+					throw error;
+				}
+			};
+		}
+	};
+}
+//#endregion
+export { createMemoryConversationStore as t };

package/dist/chunks/types-Yy0NrerF.js

@@ -0,0 +1,11 @@
+//#region src/ai/adapter/types.ts
+var ChatAdapterError = class extends Error {
+	status;
+	constructor(message, options) {
+		super(message, options?.cause === void 0 ? {} : { cause: options.cause });
+		this.name = "ChatAdapterError";
+		this.status = options?.status;
+	}
+};
+//#endregion
+export { ChatAdapterError as t };

package/dist/components/Avatar.d.ts

@@ -10,4 +10,4 @@ export interface AvatarProps {
 }
 /** Up to two initials: the first and last word of a name split on spaces and dots. */
 export declare function avatarInitials(name: string | undefined): string;
-export declare function Avatar({ src, name, size, status, className, }: AvatarProps): import("react").JSX.Element;
+export declare function Avatar({ src, name, size, status, className }: AvatarProps): import("react").JSX.Element;

package/dist/components/Breadcrumbs.d.ts

@@ -20,7 +20,7 @@ interface BreadcrumbContextType {
     claimedPath: React.MutableRefObject<string | null>;
 }
 export declare const useBreadcrumb: () => BreadcrumbContextType;
-export declare function BreadcrumbProvider({ children, }: {
+export declare function BreadcrumbProvider({ children }: {
     children: React.ReactNode;
 }): React.JSX.Element;
 export declare function useSetBreadcrumbs(getBreadcrumbs: (() => IBreadcrumbItem[]) | IBreadcrumbItem[]): void;

package/dist/components/Dropdown.d.ts

@@ -1,5 +1,5 @@
 import { type SetStateAction } from 'react';
-import { type IOptions, type ICategory } from './dropdownUtils.js';
+import { type ICategory, type IOptions } from './dropdownUtils.js';
 export interface IProps {
     options: (ICategory | IOptions | string)[];
     onActiveChange?: (option: unknown) => void;

package/dist/components/EmptyState.d.ts

@@ -7,5 +7,5 @@ interface EmptyStateProps {
         className?: string;
     }>;
 }
-export default function EmptyState({ title, description, action, icon: Icon, }: EmptyStateProps): React.JSX.Element;
+export default function EmptyState({ title, description, action, icon: Icon }: EmptyStateProps): React.JSX.Element;
 export {};

package/dist/components/Indicator.d.ts

@@ -1,4 +1,4 @@
-import type { TStatus } from '@parallelworks/workflow-parser';
+import type { RunStatus } from '../engine.js';
 export declare function Indicator({ status }: {
-    status: TStatus;
+    status: RunStatus;
 }): import("react").JSX.Element;

package/dist/components/Input.d.ts

@@ -1,4 +1,4 @@
-import type { InputHTMLAttributes, TextareaHTMLAttributes, ReactNode } from 'react';
+import type { InputHTMLAttributes, ReactNode, TextareaHTMLAttributes } from 'react';
 interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
     label?: ReactNode;
     error?: string | undefined;

package/dist/components/LetterBadge.d.ts

@@ -1,6 +1,6 @@
 /** A compact letter badge ("AI", "PUB", "SSH") used as a type mark in place of
  * an icon. Size the box and text via className (e.g. "h-5 w-5 text-[8px]"). */
-export declare function LetterBadge({ text, className, }: {
+export declare function LetterBadge({ text, className }: {
     text: string;
     className?: string;
 }): import("react").JSX.Element;

package/dist/components/MarkdownImpl.d.ts

@@ -1,2 +1,2 @@
 import type { MarkdownProps } from './Markdown.js';
-export default function Markdown({ children, isStreaming, controls, }: MarkdownProps): import("react").JSX.Element;
+export default function Markdown({ children, isStreaming, controls }: MarkdownProps): import("react").JSX.Element;

package/dist/components/Provider.d.ts

@@ -1,5 +1,6 @@
 import type { Dispatch, ReactNode, SetStateAction } from 'react';
-import type { RunLink } from '../workflow/types.js';
+import type { WorkflowEngine } from '../engine.js';
+import type { RunLink } from '../graph/types.js';
 export type UIToastId = string | number;
 export interface UIToastOptions {
     toastId?: UIToastId;
@@ -244,6 +245,7 @@ export interface UIStrings {
             collapse: string;
             upload: string;
             download: string;
+            downloadFromBrowser: string;
             access: string;
             manageAccess: string;
             delete: string;
@@ -318,10 +320,6 @@ export interface UIStrings {
         invalidDuration: string;
         durationOutOfRange: (min: string, max: string) => string;
         durationBelowMin: (min: string) => string;
-        readOnly: string;
-        readWrite: string;
-        readOnlyDescription: string;
-        readOnlyForced: string;
     };
     time: {
         now: string;
@@ -373,18 +371,11 @@ export interface UIStrings {
 }
 export interface UINavigation {
     goTo: (to: string) => void;
-    toWorkflow: (name: string) => void;
-    toMarketItem: (name: string) => void;
+    /** Opens the source of a step that runs another workflow, named by its `uses`;
+     * `sourceUrl` is a page the server resolved for it, when there is one. */
+    openStepSource: (uses: string, sourceUrl?: string) => void;
     openExternal: (href: string) => void;
 }
-export type WorkflowJsonRef = {
-    kind: 'marketplace';
-    slug: string;
-    version: string;
-} | {
-    kind: 'workflow';
-    name: string;
-};
 export interface RunFileResult {
     data: string | undefined;
     isLoading: boolean;
@@ -400,11 +391,6 @@ export interface UIData {
     useRunFile: (slug: string, path: string | null, options?: {
         refreshInterval?: number;
     }) => RunFileResult;
-    /**
-     * Resolves a workflow reference to its parsed JSON definition, for the YAML
-     * editor's input completion. Absent, that completion silently no-ops.
-     */
-    resolveWorkflowJson?: (ref: WorkflowJsonRef) => Promise<unknown>;
     /**
      * Provisions browser-access CORS rules on a storage. Absent, the storage
      * explorer hides its "add CORS rules" affordance.
@@ -418,48 +404,6 @@ export interface UIData {
         error?: string;
     }>;
     usePersistedState: PersistedStateHook;
-    /**
-     * Repository completions for `uses:`, bound by the host because the credential
-     * lives on the platform. Absent, those completions no-op.
-     */
-    repoSuggestions?: {
-        refs: (repo: string) => Promise<RepoRef[]>;
-        files: (repo: string, ref: string, path: string) => Promise<RepoEntry[]>;
-        file: (repo: string, ref: string, path: string) => Promise<string>;
-        repos: (owner: string) => Promise<RepoSummary[]>;
-        gitlabProjects: (search: string, host?: string) => Promise<GitlabProject[]>;
-        owners: (provider: 'github' | 'gitlab', search: string, host?: string) => Promise<RepoOwner[]>;
-    };
-}
-/** One branch, tag or commit a `uses:` reference can name. */
-export interface RepoRef {
-    name: string;
-    kind: string;
-    detail: string;
-}
-/** One repository in an owner listing. */
-export interface RepoSummary {
-    name: string;
-    description: string;
-    private: boolean;
-}
-/** One account, organization or group a repository can live under. */
-export interface RepoOwner {
-    name: string;
-    kind: string;
-    host?: string | undefined;
-}
-/** One GitLab project, with the server a $host must name to reach it. */
-export interface GitlabProject {
-    path: string;
-    host: string;
-    description: string;
-    private: boolean;
-}
-/** One entry in a repository directory listing. */
-export interface RepoEntry {
-    path: string;
-    type: 'blob' | 'tree';
 }
 import type { FieldComponent } from '../form/fieldRegistry.js';
 import type { PageHeaderCrumb } from './PageHeader.js';
@@ -530,25 +474,31 @@ export interface UISlots {
      * trail — the host's app-nav toggle. Absent hides it. */
     navToggle?: () => ReactNode;
 }
+/** An engine, or a loader so the host can keep the engine out of its first-load bundle. */
+export type WorkflowEngineSource = WorkflowEngine | (() => Promise<WorkflowEngine>);
 export interface UIProviderValue {
     notify: UINotify;
     strings: UIStrings;
     navigation: UINavigation;
     data: UIData;
     slots: UISlots;
+    engine?: WorkflowEngineSource | undefined;
 }
 export declare function useNotify(): UINotify;
 export declare function useStrings(): UIStrings;
 export declare function useNavigation(): UINavigation;
 export declare function useSlots(): UISlots;
-export declare function useWorkflowJsonResolver(): ((ref: WorkflowJsonRef) => Promise<unknown>) | undefined;
+/** The engine when one is provided and `enabled`; suspends while a loader resolves. */
+export declare function useOptionalWorkflowEngine(enabled?: boolean): WorkflowEngine | undefined;
+export declare function useWorkflowEngine(): WorkflowEngine;
+/** Resolves the engine without suspending, for async callers such as editor completions. */
+export declare function useWorkflowEngineLoader(): () => Promise<WorkflowEngine | undefined>;
 export declare function useProvisionCorsRules(): UIData['provisionCorsRules'];
-export declare function useRepoSuggestions(): UIData['repoSuggestions'];
 export declare function useRunFile(slug: string, path: string | null, options?: {
     refreshInterval?: number;
 }): RunFileResult;
 export declare function usePersistedState<T>(key: string, defaultValue: T): [T, Dispatch<SetStateAction<T>>];
-export declare function UIProvider({ notify, strings, navigation, data, slots, children, }: {
+export declare function UIProvider({ notify, strings, navigation, data, slots, engine, children, }: {
     notify?: Partial<UINotify>;
     strings?: {
         [G in keyof UIStrings]?: UIStrings[G] extends object ? Partial<UIStrings[G]> : UIStrings[G];
@@ -556,5 +506,6 @@ export declare function UIProvider({ notify, strings, navigation, data, slots, c
     navigation?: Partial<UINavigation>;
     data?: Partial<UIData>;
     slots?: UISlots;
+    engine?: WorkflowEngineSource;
     children: React.ReactNode;
 }): import("react").JSX.Element;

package/dist/components/SettingRow.d.ts

@@ -12,7 +12,7 @@ export declare function SettingRow({ label, htmlFor, helpText, children, isFirst
      * double toggle. */
     onClick?: () => void;
 }): import("react").JSX.Element;
-export declare function SettingSection({ title, isFirst, }: {
+export declare function SettingSection({ title, isFirst }: {
     title: string;
     isFirst?: boolean;
 }): import("react").JSX.Element;

package/dist/components/SettingsGroup.d.ts

@@ -4,5 +4,5 @@ interface SettingsGroupProps {
     children: React.ReactNode;
     className?: string;
 }
-export default function SettingsGroup({ title, children, className, }: SettingsGroupProps): React.JSX.Element;
+export default function SettingsGroup({ title, children, className }: SettingsGroupProps): React.JSX.Element;
 export {};

package/dist/components/focus.d.ts

@@ -0,0 +1,2 @@
+/** A ref that focuses a field once, when it mounts; stable so re-renders never move focus back. */
+export declare function focusOnMount(element: HTMLElement | null): void;

package/dist/components/keys.d.ts

@@ -0,0 +1,12 @@
+/** Pairs each item with a React key from its content, suffixing repeats so keys stay unique. */
+export declare function keyedByContent<T>(items: readonly T[], toKey: (item: T) => string): {
+    key: string;
+    item: T;
+}[];
+/** Keys for a list whose position is its identity, such as placeholder rows or a fixed grid. */
+export declare function positionKeys(count: number, prefix?: string): string[];
+/** Pairs each item of a list that never reorders with a key from its position. */
+export declare function withPositionKeys<T>(items: readonly T[], prefix?: string): {
+    key: string;
+    item: T;
+}[];

package/dist/duration.d.ts

@@ -0,0 +1,3 @@
+import { type DateTime, Duration } from 'luxon';
+export declare function durationToAbsHumanDuration(d: Duration): string;
+export declare function toAbsHumanDuration(start: DateTime, end: DateTime): string;

package/dist/editor/Monaco.d.ts

@@ -1,20 +1,4 @@
 import * as monaco from 'monaco-editor';
-export interface EditorMarketplaceItem {
-    readonly slug?: string;
-    readonly name?: string | null;
-    readonly description?: string | null;
-    readonly type?: string | null;
-    readonly subtype?: string | null;
-    readonly versions?: readonly string[] | null;
-}
-export interface EditorWorkflowItem {
-    readonly name?: string;
-    readonly displayName?: string | null;
-    readonly description?: string | null;
-    readonly type?: string | null;
-}
-type MarketplaceItem = EditorMarketplaceItem;
-type WorkflowItem = EditorWorkflowItem;
 export type ISchemaError = monaco.editor.IMarker;
 export interface IEditorProps extends monaco.editor.IStandaloneEditorConstructionOptions {
     className?: string;
@@ -24,8 +8,5 @@ export interface IEditorProps extends monaco.editor.IStandaloneEditorConstructio
     width?: string | number;
     height?: string | number;
     path?: 'file:///workflow.yaml' | string;
-    marketplaceItems?: MarketplaceItem[];
-    workflows?: WorkflowItem[];
 }
-export default function MonacoEditor({ className, disabled, onChange, onValidate, width, height, path, marketplaceItems, workflows, ...options }: IEditorProps): import("react").JSX.Element;
-export {};
+export default function MonacoEditor({ className, disabled, onChange, onValidate, width, height, path, ...options }: IEditorProps): import("react").JSX.Element;

package/dist/editor/index.d.ts

@@ -1,6 +1,7 @@
 export { default as Editor } from './Editor.js';
 export { default as EditorField, type IEditorField } from './EditorField.js';
 export { default as FormCodePanel } from './FormCodePanel.js';
-export type { EditorMarketplaceItem, EditorWorkflowItem, IEditorProps, ISchemaError, } from './Monaco.js';
+export type { IEditorProps, ISchemaError } from './Monaco.js';
 export { defineEditorThemes, getThemeName } from './themes.js';
 export { setupMonacoWorkers } from './workers.js';
+export { configureEditorYaml } from './yaml.js';

package/dist/editor/index.js

@@ -1,2 +1,2 @@
-import { a as EditorField, i as FormCodePanel, n as defineEditorThemes, o as Editor, r as getThemeName, t as setupMonacoWorkers } from "../chunks/editor-9_uVtUyy.js";
-export { Editor, EditorField, FormCodePanel, defineEditorThemes, getThemeName, setupMonacoWorkers };
+import { a as getThemeName, c as Editor, i as defineEditorThemes, o as FormCodePanel, r as setupMonacoWorkers, s as EditorField, t as configureEditorYaml } from "../chunks/editor-Dk1rbV75.js";
+export { Editor, EditorField, FormCodePanel, configureEditorYaml, defineEditorThemes, getThemeName, setupMonacoWorkers };

package/dist/editor/yaml.d.ts

@@ -0,0 +1,5 @@
+import type { SchemasSettings } from 'monaco-yaml';
+/** Adds JSON schemas that validate and complete YAML models whose URI matches. */
+export declare function configureEditorYaml(added: SchemasSettings[]): void;
+/** Lets the loaded editor pick up schemas added before or after it loads. */
+export declare function onYamlSchemas(listener: (schemas: SchemasSettings[]) => void): void;

package/dist/engine.d.ts

@@ -0,0 +1,98 @@
+export type RunStatus = 'started' | 'running' | 'completed' | 'error' | 'failed' | 'canceled' | 'skipped' | 'faulted' | 'canceling' | 'skipped-failed' | '' | undefined;
+export interface MatrixGroup {
+    originaljob: string;
+    members: string[];
+}
+export interface LogSegment {
+    content: string;
+    className: string;
+    highlighted?: boolean;
+}
+export interface LogCommand {
+    type: 'error' | 'warning' | 'notice' | 'debug' | 'group' | 'endgroup';
+    message: string;
+    params?: Record<string, string>;
+}
+export interface ProcessedLogLine {
+    index: number;
+    segments: LogSegment[];
+    command?: LogCommand;
+    groupDepth: number;
+    groupId?: number;
+}
+export interface WorkflowVariable {
+    key?: string;
+    value?: string | null;
+    secret?: boolean;
+}
+export type WorkflowVariables = Record<string, WorkflowVariable>;
+export interface EvaluateOptions<T> {
+    inputs: unknown;
+    obj: T;
+    path?: string[];
+    schema?: unknown;
+    orgVars?: WorkflowVariables | undefined;
+    userVars?: Record<string, string>;
+    remoteVars?: Record<string, string | undefined> | undefined;
+    secretKeys?: string[];
+    appInfo?: Record<string, unknown>;
+    sessionInfo?: Record<string, string>;
+    index?: number | undefined;
+}
+export interface ExpansionKeys {
+    subworkflowKeys: string[];
+    jobKeys: string[];
+    matrixKeys: string[];
+}
+export interface EngineJob {
+    status?: RunStatus;
+    needs?: string[];
+    if?: boolean | string;
+    steps?: unknown[];
+    _matrix?: {
+        originaljob?: string;
+        index?: number;
+    };
+    _matrixGroup?: MatrixGroup;
+}
+export interface EngineStep {
+    name?: string | undefined;
+    run?: string;
+    uses?: string;
+    subworkflow?: unknown;
+}
+/** The workflow semantics the form, graph, editor and log viewer defer to. */
+export interface WorkflowEngine {
+    /** Starts loading the expression runtime; safe to call repeatedly. */
+    init(): void;
+    isReady(): boolean;
+    /** Calls back when readiness changes; returns an unsubscribe function. */
+    onReady(listener: (ready: boolean) => void): () => void;
+    /** Resolves every `${{ }}` expression in `obj`. */
+    evaluate<T>(options: EvaluateOptions<T>): T;
+    /** Turns a workflow's input definitions into the form's field tree. */
+    convertInputs(inputs: Record<string, unknown>): Record<string, unknown>;
+    inputDependencies(obj: unknown): {
+        inputDeps: Set<string>;
+        hasExpressions: boolean;
+    };
+    jobDependencies(jobName: string, jobs: Record<string, {
+        needs?: string[];
+    }>, memo?: Record<string, Set<string>>): Set<string>;
+    matrixGroups(jobs: Record<string, EngineJob> | undefined): Record<string, MatrixGroup>;
+    /** Rewrites `visibleJobs` in place so each matrix group lays out as one node. */
+    collapseMatrixGroups(groups: Record<string, MatrixGroup>, visibleJobs: Record<string, EngineJob>): void;
+    expansionKeys(jobs: Record<string, EngineJob> | undefined, pathPrefix?: string): ExpansionKeys;
+    matrixStatus(statuses: RunStatus[]): {
+        aggStatus: RunStatus;
+        statusLabel: string;
+    };
+    stepLabel(step: EngineStep, index?: number): string;
+    stepLogPath(subworkflowPrefix: string, jobName: string, stepIndex: number | string): string;
+    isRunActive(status: string | null | undefined): boolean;
+    processLogLines(lines: {
+        index: number;
+        segments: LogSegment[];
+    }[], rawLines: string[]): ProcessedLogLine[];
+    toYaml(value: unknown): string;
+}

package/dist/file-explorer/FileExplorer.d.ts

@@ -1,5 +1,5 @@
 import type { IFileExplorerClient, IFileExplorerProvider } from './lib/fileExplorer.js';
-import type { TreeNode, TStorage } from './lib/types.js';
+import type { ExplorerObject, TreeNode, TStorage } from './lib/types.js';
 interface IFileExplorerProps {
     storages: TStorage[];
     /** Resolves the storage's injected provider pair; the host owns caching. */
@@ -33,6 +33,15 @@ interface IFileExplorerProps {
     initialExpandedPaths?: readonly string[];
     /** Fires whenever the expanded folders change, for the host to persist. */
     onExpandedPathsChange?: (paths: string[]) => void;
+    /** URIs that name an object, shown on its details and offered under Copy;
+     * the first is what Copy URI copies. None hides them. */
+    objectUris?: ((storage: TStorage, key: string) => string[]) | undefined;
+    /** A shell command that downloads files, offered beside the browser
+     * download. An empty command hides it for that selection. */
+    downloadCommand?: {
+        label: string;
+        build: (objects: ExplorerObject[]) => string;
+    } | undefined;
 }
-export default function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy, groups, groupsLoading, selectedPath, onPathChange, getProviderAndClient, treeOnly, initialExpandedPaths, onExpandedPathsChange, }: IFileExplorerProps): import("react").JSX.Element;
+export default function FileExplorer({ storages, onRefresh, refreshKey, onOpenFile, showUserHierarchy, groups, groupsLoading, selectedPath, onPathChange, getProviderAndClient, treeOnly, initialExpandedPaths, onExpandedPathsChange, objectUris, downloadCommand, }: IFileExplorerProps): import("react").JSX.Element;
 export {};

package/dist/file-explorer/FileExplorerContext.d.ts

@@ -1,5 +1,5 @@
-import type { TreeNode, UploadFileProgress, UploadNode, UploadSession } from './lib/types.js';
 import type { IFileExplorerClient, IFileExplorerProvider } from './lib/fileExplorer.js';
+import type { TreeNode, UploadFileProgress, UploadNode, UploadSession } from './lib/types.js';
 interface IFileExplorerContextValue {
     uploadSessionMap: Map<string, UploadSession>;
     uploadQueue: string[];

package/dist/file-explorer/FilePreview/CodePreviewEditor.d.ts

@@ -2,5 +2,5 @@ interface CodePreviewEditorProps {
     value: string;
     language: string;
 }
-export default function CodePreviewEditor({ value, language, }: CodePreviewEditorProps): import("react").JSX.Element;
+export default function CodePreviewEditor({ value, language }: CodePreviewEditorProps): import("react").JSX.Element;
 export {};

package/dist/file-explorer/FilePreview/previewType.d.ts

@@ -1,5 +1,5 @@
-import { getFileExtension } from '../lib/utils.js';
 import type { TreeNode } from '../lib/types.js';
+import { getFileExtension } from '../lib/utils.js';
 export { getFileExtension };
 export type PreviewKind = 'image' | 'video' | 'audio' | 'pdf' | 'code' | 'csv' | 'notebook' | 'archive' | 'unsupported';
 /** Short-lived so the link doesn't linger; an hour covers a viewing session. */

package/dist/file-explorer/FileRow.d.ts

@@ -1,5 +1,5 @@
-import { type OpenMenu, type RowMenuItem } from '../list/index.js';
 import type { ReactNode } from 'react';
+import { type OpenMenu, type RowMenuItem } from '../list/index.js';
 import type { TreeNode } from './lib/types.js';
 export declare const ROW_HEIGHT_SHORT = 45;
 export declare const ROW_HEIGHT_TALL = 52.25;

package/dist/file-explorer/helpers.d.ts

@@ -1,5 +1,5 @@
-import type { TreeNode, TStorage, UploadNode } from './lib/types.js';
 import { type JSX } from 'react';
+import type { TreeNode, TStorage, UploadNode } from './lib/types.js';
 declare const SIDEBAR_WIDTH_STORAGE_KEY = "fileExplorerSidebarWidth";
 declare const SIDEBAR_WIDTH_DEFAULT = 300;
 type StorageIconUrlResolver = (args: {
@@ -9,7 +9,7 @@ declare function getNodeIcon(node: TreeNode, storageIconUrl?: StorageIconUrlReso
 declare function renderUploadNodes(uploadNodes: UploadNode[]): JSX.Element[];
 declare function NoFileSelectedPreview(): JSX.Element;
 /** Shown instead of a skeleton that has nothing left to wait for. */
-declare function NotFoundPreview({ path, onRetry, }: {
+declare function NotFoundPreview({ path, onRetry }: {
     path: string;
     onRetry: () => void;
 }): JSX.Element;
@@ -36,10 +36,10 @@ interface IDragDropZoneProps {
     children: React.ReactNode;
     className?: string;
 }
-declare function DragDropZone({ onDropFiles, children, className, }: IDragDropZoneProps): JSX.Element;
+declare function DragDropZone({ onDropFiles, children, className }: IDragDropZoneProps): JSX.Element;
 interface IShareFileButtonProps {
     node: TreeNode;
     onShare: (node: TreeNode) => Promise<void>;
 }
 declare function ShareFileButton({ node, onShare }: IShareFileButtonProps): JSX.Element;
-export { CorsIssuePreview, DragDropZone, getNodeIcon, NoFileSelectedPreview, NoDataAvailablePreview, NotFoundPreview, renderUploadNodes, ShareFileButton, SIDEBAR_WIDTH_DEFAULT, SIDEBAR_WIDTH_STORAGE_KEY, SkeletonPreview, };
+export { CorsIssuePreview, DragDropZone, getNodeIcon, NoDataAvailablePreview, NoFileSelectedPreview, NotFoundPreview, renderUploadNodes, ShareFileButton, SIDEBAR_WIDTH_DEFAULT, SIDEBAR_WIDTH_STORAGE_KEY, SkeletonPreview, };