@pipelex/mthds-ui 0.26.0 → 0.27.0

package/dist/graph/react/index.d.ts

@@ -2,8 +2,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import { c as GraphNodeData, d as GraphEdge, e as GraphNode, b as GraphSpec, f as GraphConfig, g as GraphDirection, F as FoldMode, h as GraphThemeMode, T as ToolbarPosition, G as GraphTheme, i as PipeStatus, j as GraphSpecNodeIoItem, k as ValidationState, V as ValidationIssue, L as LabelDescriptor, l as PipeControllerType, m as FoldToggleOptions, N as NodeValidationSummary, n as PipeType, o as GraphSpecMode, C as ConceptInfo, p as GraphSpecNode } from '../../types-DgqW3Jg4.js';
 export { q as PipeOperatorType } from '../../types-DgqW3Jg4.js';
-import { PipeIOContracts, OutputForm, InputForm } from '@pipelex/mthds-form';
-import { ResolveUrl, ResolveShareUrl } from '@pipelex/mthds-form/react';
+import { PipeIOContracts, OutputForm, InputForm, SaveFiles } from '@pipelex/mthds-form';
+import { ResolveUrl, ResolveShareUrl, DownloadDisplay } from '@pipelex/mthds-form/react';
 import { Edge, Node, ReactFlowInstance } from '@xyflow/react';
 
 /** ReactFlow node parameterized with our domain data. */
@@ -153,6 +153,24 @@ interface GraphViewerProps {
      * since it starts expiring the moment it exists.
      */
     resolveShareUrl?: ResolveShareUrl;
+    /**
+     * Delivers the files the result panel's downloads hand over: its Download
+     * control and each file's own button.
+     *
+     * Without it the kernel saves them in the browser tab, through an object URL
+     * and a clicked link. A host whose view runs in a sandboxed frame is refused
+     * both, so its downloads fail without a word unless it supplies this, handing
+     * the planned files to its own bridge. It goes on the panel's provider beside
+     * `resolveUrl`, which replaces an outer provider rather than merging with it,
+     * so a `saveFiles` set around the graph does not reach the panel.
+     */
+    saveFiles?: SaveFiles;
+    /**
+     * Which of the result panel's download controls are drawn: the whole-result
+     * Download (`result`) and each file's own button (`files`, which also takes
+     * the kinds that carry one). Both are drawn by default.
+     */
+    downloads?: DownloadDisplay;
     /**
      * State of the toolbar's validation widget. The widget renders only when this
      * is set — `undefined` (the default) disables the feature entirely. Reactive:
@@ -349,6 +367,17 @@ declare function PipeCardBase({ data, children }: PipeCardBaseProps): react_jsx_
  * `resolveUrl`, which is installed as the kernel's `ResultEnvProvider` so the
  * kernel's own file arms paint the file; without one, the panel paints whatever
  * `public_url` the payload carries.
+ *
+ * ## Saving
+ *
+ * The kernel's Download control and its per-file download buttons save through
+ * the browser tab unless a host says otherwise. A host whose view runs in a
+ * sandboxed frame, where the tab's object URL, clicked link and popup are all
+ * refused, passes `saveFiles` to deliver the files through its own bridge, and
+ * `downloads` to choose which of those controls are drawn. Both go on the same
+ * provider as `resolveUrl`, because the kernel's provider replaces an outer
+ * one rather than merging with it: set around the graph instead, they would
+ * never reach a panel that installs its own.
  */
 interface StuffResultRendererOptions {
     /** `pipe_io_contracts` for the method being displayed. */
@@ -400,8 +429,18 @@ interface StuffResultPanelProps extends StuffResultRendererOptions {
      * own credential.
      */
     resolveShareUrl?: ResolveShareUrl;
+    /**
+     * Delivers the files a download hands over, for a host that cannot save
+     * through the browser tab. Without one, the kernel saves in the tab.
+     */
+    saveFiles?: SaveFiles;
+    /**
+     * Which download controls are drawn: the whole-result Download and each
+     * file's own button, set independently. Both are drawn by default.
+     */
+    downloads?: DownloadDisplay;
 }
-declare function StuffResultPanel({ contracts, outputForm, inputForm, stuff, producerPipeRef, consumer, resolveUrl, resolveShareUrl, }: StuffResultPanelProps): react_jsx_runtime.JSX.Element | null;
+declare function StuffResultPanel({ contracts, outputForm, inputForm, stuff, producerPipeRef, consumer, resolveUrl, resolveShareUrl, saveFiles, downloads, }: StuffResultPanelProps): react_jsx_runtime.JSX.Element | null;
 
 interface DetailPanelProps {
     isOpen: boolean;

package/dist/graph/react/index.js

@@ -128,7 +128,9 @@ function StuffResultPanel({
   producerPipeRef,
   consumer,
   resolveUrl,
-  resolveShareUrl
+  resolveShareUrl,
+  saveFiles,
+  downloads
 }) {
   const field = React2.useMemo(
     () => {
@@ -139,7 +141,16 @@ function StuffResultPanel({
   );
   if (field) {
     const panel = /* @__PURE__ */ jsx(StuffViewer, { field, value: stuff.data, name: stuff.name });
-    return resolveUrl || resolveShareUrl ? /* @__PURE__ */ jsx(ResultEnvProvider, { resolveUrl, resolveShareUrl, children: panel }) : panel;
+    return resolveUrl || resolveShareUrl || saveFiles || downloads ? /* @__PURE__ */ jsx(
+      ResultEnvProvider,
+      {
+        resolveUrl,
+        resolveShareUrl,
+        saveFiles,
+        downloads,
+        children: panel
+      }
+    ) : panel;
   }
   return stuff.data === void 0 || stuff.data === null ? null : /* @__PURE__ */ jsx(UndescribedValue, { value: stuff.data });
 }
@@ -2515,19 +2526,21 @@ function StuffNodeDetail({
   outputForm,
   inputForm,
   resolveUrl,
-  resolveShareUrl
+  resolveShareUrl,
+  saveFiles,
+  downloads
 }) {
   var _a;
   const conceptInfo = stuffData.concept && graphspec ? resolveConceptRef(graphspec, stuffData.concept) : void 0;
   const isDryRun = graphSpecMode(graphspec) === GRAPH_SPEC_MODE.DRY;
   const renderData = contracts && outputForm ? () => /* @__PURE__ */ jsx24(
     StuffResultPanel,
-    __spreadProps(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadProps(__spreadValues({
+    __spreadProps(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadValues(__spreadProps(__spreadValues({
       contracts,
       outputForm
     }, inputForm ? { inputForm } : {}), {
       stuff: stuffData
-    }), conceptInfo ? { concept: conceptInfo } : {}), producerPipeRef ? { producerPipeRef } : {}), consumer ? { consumer } : {}), resolveUrl ? { resolveUrl } : {}), resolveShareUrl ? { resolveShareUrl } : {}), {
+    }), conceptInfo ? { concept: conceptInfo } : {}), producerPipeRef ? { producerPipeRef } : {}), consumer ? { consumer } : {}), resolveUrl ? { resolveUrl } : {}), resolveShareUrl ? { resolveShareUrl } : {}), saveFiles ? { saveFiles } : {}), downloads ? { downloads } : {}), {
       theme
     })
   ) : void 0;
@@ -2616,6 +2629,8 @@ function GraphViewer(props) {
     inputForm,
     resolveUrl,
     resolveShareUrl,
+    saveFiles,
+    downloads,
     validationState,
     validationIssues,
     onValidationIssueClick
@@ -3293,7 +3308,9 @@ function GraphViewer(props) {
                   outputForm,
                   inputForm,
                   resolveUrl,
-                  resolveShareUrl
+                  resolveShareUrl,
+                  saveFiles,
+                  downloads
                 }
               ) : null,
               renderDetailExtra && detailSelection && !conceptOverride && renderDetailExtra(detailSelection.nodeId, detailSelection.nodeData)