@pipelex/mthds-form 0.24.0 → 0.26.0

package/dist/core/index.d.ts

@@ -6,7 +6,7 @@ export { StuffFile, StuffFileKind, collectStuffFiles } from './stuff-files.js';
 export { SaveFailure, SaveFile, SaveFileKind, SaveFiles, SavePlan, SavePlanOptions, SaveResult, UnavailableFile, planFileSave, planStuffSave } from './save-plan.js';
 export { DOCUMENT_FORMATS, FileFormat, IMAGE_FORMATS, acceptLabel, acceptMap, formatsForKind, isAcceptedFile } from './file-formats.js';
 export { narrowFileFormats } from './narrow-file-formats.js';
-export { CompositeMember, DataUrlView, DateContentView, DocumentContentView, HtmlContentView, ImageContentView, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, TYPED_SCALAR_MARKERS, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isViewableUrl, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, viewableUrl } from './native-content.js';
+export { ChoiceContentView, CompositeMember, DataUrlView, DateContentView, DocumentContentView, HtmlContentView, ImageContentView, NATIVE_CHOICE_CONCEPT_REF, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, NATIVE_PAGE_CONCEPT_REF, NATIVE_RATING_CONCEPT_REF, NATIVE_YES_NO_CONCEPT_REF, PageContentView, RatingContentView, TYPED_SCALAR_MARKERS, YesNoContentView, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativePageNode, isViewableUrl, nativeVerdictOf, readChoiceContent, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, readPageContent, readRatingContent, readYesNoContent, viewableUrl } from './native-content.js';
 export { Readiness, anyOptionalStructureOpen, computeReadiness, fieldFilled, foldsBehindOptionalDisclosure, isFilled, isFoldedOptional, isOptionalStructure, mustBeFilled, optionalStructureOpen, shownAsOptional } from './readiness.js';
 export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue } from './seed.js';
 export { InputPresence, buildPipeRef, getPipeIOContract, inputMustBeFilled, isFixedCountInput, isOptionalInput, isPluralInput } from './contracts.js';

package/dist/core/index.js

@@ -1,11 +1,11 @@
-export { planFileSave, planStuffSave } from '../chunk-ICUEHNEH.js';
+export { planFileSave, planStuffSave } from '../chunk-QWHUUMSB.js';
 export { closeOptionalStructures, openOptionalStructures, seedInputs, seedObjectValue } from '../chunk-VH5CDQDR.js';
 export { addChosenFiles, chosenFilesAdded, roomForChosenFiles, sourceFileValue } from '../chunk-NSHGLM6A.js';
-export { collectStuffFiles } from '../chunk-RRTI7AIR.js';
+export { collectStuffFiles } from '../chunk-QINLJ5RM.js';
 export { describeValidationError, displayValue, valueAtProperty } from '../chunk-RPA7DNSK.js';
 export { apiInputsFromRunValues, fieldsForContract, inputDataFromWorkingMemory, outputsFromPipeOutput, rjsfDataFromRunValues, runValuesFromInputs, runValuesFromStore, sameRunValues, setValueAtPath, storeInputDataFromRunValues } from '../chunk-ZX52CQJ4.js';
 export { narrowFileFormats } from '../chunk-CAKQ5VFT.js';
-export { NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, TYPED_SCALAR_MARKERS, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isViewableUrl, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, viewableUrl } from '../chunk-CM4KVG53.js';
+export { NATIVE_CHOICE_CONCEPT_REF, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, NATIVE_PAGE_CONCEPT_REF, NATIVE_RATING_CONCEPT_REF, NATIVE_YES_NO_CONCEPT_REF, TYPED_SCALAR_MARKERS, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativePageNode, isViewableUrl, nativeVerdictOf, readChoiceContent, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, readPageContent, readRatingContent, readYesNoContent, viewableUrl } from '../chunk-JSPF4BQP.js';
 export { getPipeOutputForm } from '../chunk-JIGRWJTV.js';
 export { buildResultField, buildRunFields, getPipeInputForm } from '../chunk-ZB4RYUKV.js';
 export { conceptCategory } from '../chunk-FABY3DEY.js';

package/dist/core/native-content.d.ts

@@ -108,6 +108,78 @@ declare function readHtmlContent(value: unknown): HtmlContentView | undefined;
 declare const NATIVE_HTML_CONCEPT_REF = "native.Html";
 declare const NATIVE_DATE_CONCEPT_REF = "native.Date";
 declare const NATIVE_COMPOSITE_CONCEPT_REF = "native.Composite";
+declare const NATIVE_PAGE_CONCEPT_REF = "native.Page";
+declare const NATIVE_YES_NO_CONCEPT_REF = "native.YesNo";
+declare const NATIVE_RATING_CONCEPT_REF = "native.Rating";
+declare const NATIVE_CHOICE_CONCEPT_REF = "native.Choice";
+/**
+ * `native.Page`, read: what one page of an extracted document holds.
+ *
+ * The model is `{text_and_images: {text, images, raw_html}, page_view}`, where
+ * `text` is a `TextContent` (`{text}`) and the images and the page view are
+ * `ImageContent`s. A reader of a page wants its TEXT first, and the structural
+ * renderer never reached it: the descriptor states the page as an `object`
+ * over two members, and the text sits two levels down, under a member named
+ * `text` inside a member named `text_and_images`. Keyed by the concept, this
+ * reads the documented model and nothing else.
+ */
+interface PageContentView {
+    /** The page's extracted text, as the extractor wrote it, when it wrote any. */
+    text?: string;
+    /** The images extracted from the page, each an `ImageContent`, unread. */
+    images: readonly unknown[];
+    /**
+     * The page's markup as the extractor fetched it, when it kept any. It is the
+     * page's content a second time when the page has text, and its only content
+     * when it has none, which is when a renderer shows it, framed, never injected.
+     */
+    rawHtml?: string;
+    /** The rendering of the whole page, an `ImageContent`, when one was made. */
+    pageView?: unknown;
+}
+/**
+ * Read a `native.Page` value. `undefined` for anything that is not a record,
+ * so the caller renders its own absence.
+ */
+declare function readPageContent(value: unknown): PageContentView | undefined;
+/** `native.YesNo`, read. */
+interface YesNoContentView {
+    /** The answer: yes is `true`. */
+    yesNo: boolean;
+    /** The probability that the answer is yes, from 0 to 1, when the producer reported one. */
+    probability?: number;
+}
+/**
+ * Read a `native.YesNo` value: `{yes_no, probability}`, or the bare boolean a
+ * single-member YesNo is unwrapped to by its content key. Both are the model
+ * the concept states, so reading either is reading the standard.
+ */
+declare function readYesNoContent(value: unknown): YesNoContentView | undefined;
+/** `native.Rating`, read. */
+interface RatingContentView {
+    /** The index of the selected level, 0 being the first level declared. */
+    level: number;
+    /** The name the scale gives the selected level, when it names its levels. */
+    label?: string;
+    /** The producer's confidence in the level, from 0 to 1, when it reported one. */
+    confidence?: number;
+}
+/** Read a `native.Rating` value. `undefined` when it carries no whole `level`. */
+declare function readRatingContent(value: unknown): RatingContentView | undefined;
+/** `native.Choice`, read. */
+interface ChoiceContentView {
+    /** The key of the selected option, as the method declared it. */
+    choice: string;
+    /** The producer's confidence in the choice, from 0 to 1, when it reported one. */
+    confidence?: number;
+}
+/**
+ * Read a `native.Choice` value. `undefined` when it carries no `choice`, or an
+ * empty one: the content model types `choice` as any text, but a choice
+ * question's options are keyed by non-empty strings and its `Choice` names one
+ * of them, so an empty key names no option and leaves no answer to draw.
+ */
+declare function readChoiceContent(value: unknown): ChoiceContentView | undefined;
 /** One member of a composite: the name it was composed under, and its content. */
 interface CompositeMember {
     name: string;
@@ -164,15 +236,40 @@ declare function isNativeDateNode(node: NativeNode): boolean;
  */
 declare function isNativeCompositeNode(node: NativeNode): boolean;
 /**
- * Whether a node is one of the three natives the kind vocabulary cannot name —
- * a date, a page, a composite — which a renderer reads by CONCEPT before it
- * reads the kind. A list of one answers no (the predicates refuse a `list`
- * node), and its item answers yes.
+ * Whether a node is a `native.Page`, or a concept refining it — one page of an
+ * extracted document.
+ *
+ * Its node is an `object` over `{text_and_images, page_view}`, which the
+ * structural renderer laid out as a record: in a list, a table whose
+ * "Text and images" column was named by the first `text` member it found,
+ * `raw_html`, which an extractor leaves empty, so a page holding a whole
+ * report read as a row of dashes. Keyed by concept, the result view reads the
+ * page's text instead. See `readPageContent`.
+ */
+declare function isNativePageNode(node: NativeNode): boolean;
+/**
+ * Whether a node is one of the verdicts a judge returns — a yes or no
+ * (`native.YesNo`), a rating (`native.Rating`) or a choice (`native.Choice`),
+ * or a concept refining one — and which.
+ *
+ * Their nodes are `object`s over the verdict and its measures (a `YesNo` from
+ * an older runtime, whose model had one member, is a `boolean` node unwrapped
+ * by its content key), so the structural renderer printed the measures as a
+ * record: "Yes no: Yes / Probability: 1". The concept is what says the record
+ * is a verdict, read off `concept_ref` and `refines` like every other native
+ * predicate here, never off which keys the value happens to hold.
+ */
+declare function nativeVerdictOf(node: NativeNode): 'yes_no' | 'rating' | 'choice' | undefined;
+/**
+ * Whether a node is one of the natives the kind vocabulary cannot name that a
+ * list draws one value per line — a date, an HTML page, a composite — which a
+ * renderer reads by CONCEPT before it reads the kind. A list of one answers no
+ * (the predicates refuse a `list` node), and its item answers yes.
  *
  * One answer, read twice: the result view renders a list whose item answers yes
  * one value per line rather than as a table, and the generative layer delegates
  * that list to the kernel, because no catalog component reads a native value.
- * Not re-exported: a host asks the three predicates it needs.
+ * Not re-exported: a host asks the predicates it needs.
  */
 declare function isNativeValueNode(node: NativeNode): boolean;
 /** What the native predicates read off a node: its stated kind and its concept. */
@@ -277,4 +374,4 @@ declare const TYPED_SCALAR_MARKERS: readonly ["__class__", "__module__"];
 /** Whether a record carries the typed-scalar markers. Informational. */
 declare function hasTypedScalarMarkers(value: unknown): boolean;
 
-export { type CompositeMember, type DataUrlView, type DateContentView, type DocumentContentView, type HtmlContentView, type ImageContentView, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, TYPED_SCALAR_MARKERS, dataUrlExtensions, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativeValueNode, isViewableUrl, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, viewableUrl };
+export { type ChoiceContentView, type CompositeMember, type DataUrlView, type DateContentView, type DocumentContentView, type HtmlContentView, type ImageContentView, NATIVE_CHOICE_CONCEPT_REF, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, NATIVE_PAGE_CONCEPT_REF, NATIVE_RATING_CONCEPT_REF, NATIVE_YES_NO_CONCEPT_REF, type PageContentView, type RatingContentView, TYPED_SCALAR_MARKERS, type YesNoContentView, dataUrlExtensions, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativePageNode, isNativeValueNode, isViewableUrl, nativeVerdictOf, readChoiceContent, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, readPageContent, readRatingContent, readYesNoContent, viewableUrl };

package/dist/core/native-content.js

@@ -1,4 +1,4 @@
-export { NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, TYPED_SCALAR_MARKERS, dataUrlExtensions, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativeValueNode, isViewableUrl, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, viewableUrl } from '../chunk-CM4KVG53.js';
+export { NATIVE_CHOICE_CONCEPT_REF, NATIVE_COMPOSITE_CONCEPT_REF, NATIVE_DATE_CONCEPT_REF, NATIVE_HTML_CONCEPT_REF, NATIVE_PAGE_CONCEPT_REF, NATIVE_RATING_CONCEPT_REF, NATIVE_YES_NO_CONCEPT_REF, TYPED_SCALAR_MARKERS, dataUrlExtensions, formatDateContent, hasTypedScalarMarkers, isNativeCompositeNode, isNativeDateNode, isNativeHtmlNode, isNativePageNode, isNativeValueNode, isViewableUrl, nativeVerdictOf, readChoiceContent, readCompositeContent, readDataUrl, readDateContent, readDocumentContent, readHtmlContent, readImageContent, readPageContent, readRatingContent, readYesNoContent, viewableUrl } from '../chunk-JSPF4BQP.js';
 import '../chunk-V3OV2XQT.js';
 //# sourceMappingURL=native-content.js.map
 //# sourceMappingURL=native-content.js.map

package/dist/core/save-plan.js

@@ -1,6 +1,6 @@
-export { planFileSave, planStuffSave, splitFileName, typedFileStem } from '../chunk-ICUEHNEH.js';
-import '../chunk-RRTI7AIR.js';
-import '../chunk-CM4KVG53.js';
+export { planFileSave, planStuffSave, splitFileName, typedFileStem } from '../chunk-QWHUUMSB.js';
+import '../chunk-QINLJ5RM.js';
+import '../chunk-JSPF4BQP.js';
 import '../chunk-V3OV2XQT.js';
 //# sourceMappingURL=save-plan.js.map
 //# sourceMappingURL=save-plan.js.map

package/dist/core/stuff-files.js

@@ -1,5 +1,5 @@
-export { collectStuffFiles, readStuffFile } from '../chunk-RRTI7AIR.js';
-import '../chunk-CM4KVG53.js';
+export { collectStuffFiles, readStuffFile } from '../chunk-QINLJ5RM.js';
+import '../chunk-JSPF4BQP.js';
 import '../chunk-V3OV2XQT.js';
 //# sourceMappingURL=stuff-files.js.map
 //# sourceMappingURL=stuff-files.js.map

package/dist/generative/index.js

@@ -1,11 +1,11 @@
 "use client";
-import { cn, checkedAccentClass, focusOutlineClass, linkTextClass, selectedBorderClass, selectedFillClass, fieldControlClass, ResultRoot, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, selectedFillStrongClass, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-UGKFWX7L.js';
-import '../chunk-ICUEHNEH.js';
+import { cn, checkedAccentClass, focusOutlineClass, linkTextClass, selectedBorderClass, selectedFillClass, fieldControlClass, ResultRoot, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, selectedFillStrongClass, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-RSYOZZZF.js';
+import '../chunk-QWHUUMSB.js';
 export { seedInputs } from '../chunk-VH5CDQDR.js';
 import '../chunk-NSHGLM6A.js';
-import '../chunk-RRTI7AIR.js';
+import '../chunk-QINLJ5RM.js';
 import '../chunk-ZX52CQJ4.js';
-import { isNativeValueNode, readDateContent, formatDateContent, isNativeHtmlNode, isNativeDateNode, isNativeCompositeNode } from '../chunk-CM4KVG53.js';
+import { isNativeValueNode, readDateContent, formatDateContent, isNativeHtmlNode, isNativeDateNode, isNativeCompositeNode } from '../chunk-JSPF4BQP.js';
 export { brandManifestSchema } from '../chunk-QFX332LE.js';
 import '../chunk-ZB4RYUKV.js';
 import '../chunk-FABY3DEY.js';

package/dist/react/index.d.ts

@@ -276,6 +276,14 @@ interface FieldStrings {
     preview: string;
     removeFileAria: string;
     previewUnavailablePdf: string;
+    /**
+     * Said in a result, in place of a PDF's frame, where the browser draws no PDF
+     * in a page (Android's browsers, a headless browser): above the actions that
+     * open the file in a new tab and save it.
+     */
+    pdfViewerUnavailable: string;
+    /** The link that opens a file in a new tab, where it cannot be shown in the page. */
+    openInNewTab: string;
     /**
      * What a result slot the run resolved as an absence SHOWS — a dash, not a
      * sentence. Beside forty values in a grid, "not provided" repeated is louder
@@ -355,6 +363,38 @@ interface FieldStrings {
     resultViewGroup: string;
     yes: string;
     no: string;
+    /**
+     * The line under a yes or no verdict, in `app`, given the probability its
+     * producer reported that the answer is yes, from 0 to 1. It states the
+     * probability of yes whichever way the verdict went, which is what the
+     * producer measured: a "no" decided against a threshold can still carry a
+     * probability of yes above a half.
+     */
+    yesProbability: (share: number) => string;
+    /** The line under a rating or a choice, in `app`, given the producer's confidence, from 0 to 1. */
+    verdictConfidence: (share: number) => string;
+    /**
+     * A rating's verdict when its scale names no levels, given the level's
+     * position counted from one: the payload's `level` is an index from zero.
+     */
+    ratingLevel: (position: number) => string;
+    /** The caption over each page of an extracted document with several, counted from one. */
+    pageNumber: (position: number) => string;
+    /** What names a table read out of an extracted page when the table has no caption of its own. */
+    extractedTable: string;
+    /**
+     * The accessible name of a result's picture, which opens it in the viewer,
+     * given the picture's name: a gallery's tile in `app` shows no name, so this
+     * is what tells one tile from the next to a screen reader.
+     */
+    viewImage: (name: string) => string;
+    /** Where the viewer stands in a list of pictures, counted from one: "3 of 6". */
+    imagePosition: (position: number, count: number) => string;
+    /** The viewer's two buttons that move to the picture before or after this one. */
+    previousImage: string;
+    nextImage: string;
+    /** The viewer's link that opens the whole picture in a tab of its own. */
+    openOriginal: string;
     /**
      * Shown when a picked file is not a format this slot accepts. Takes the
      * slot's own formats as the hint names them (`PNG, JPG`), after any narrowing
@@ -930,6 +970,68 @@ declare function resolveHtmlStorageUrls(markup: string, { resolveUrl, resolveUrl
  * filename.
  */
 type ResolveUrl = (url: string) => string | undefined;
+/**
+ * What the view asks a host for when it draws a picture small: the width it
+ * would like the picture to be, in the picture's own pixels.
+ *
+ * It is the width that covers the box the view draws the picture in, at twice
+ * the box's CSS size, so the copy stays sharp on a high-density screen, and it
+ * follows the picture's shape when the payload states its `width` and
+ * `height`. A gallery's tile is a square narrower than 288 CSS pixels that
+ * the picture covers: `576` for a square or portrait picture, and `576` times
+ * the aspect ratio for a landscape one, which covers the square by its
+ * height. A table cell's thumbnail is 40 CSS pixels tall at the picture's own
+ * width: `80` times the aspect ratio, and never less than `256`. A picture of
+ * no stated shape is asked for at `576` in a tile and `256` in a cell. The
+ * view reads these from the shape rather than measuring each box, so a host
+ * that makes its copies on demand keeps few per picture, and may round a
+ * width up to the nearest copy it keeps.
+ */
+interface RenditionRequest {
+    width: number;
+}
+/**
+ * The host's seam for a SMALLER copy of a picture, which the view draws where
+ * it shows the picture small: a gallery's tiles and a table cell's thumbnail.
+ *
+ * ## Why a result view needs one
+ *
+ * Without it every tile loads the whole picture: a generated image is around
+ * a megabyte at 1024 pixels, drawn in a box of 150. A gallery of six spins for
+ * seconds before a single tile shows, and a table with a picture per row loads
+ * every original to draw a thumbnail 40 pixels tall. The kernel cannot make a
+ * smaller copy itself, since it holds a reference and the host holds the file;
+ * a host that can (a resizing route, copies made when the file was stored, an
+ * image service in front of its storage) answers here.
+ *
+ * ## The contract
+ *
+ * Called with the picture's own `url` member, exactly as `resolveUrl` is (a
+ * `pipelex-storage://` reference, or whatever `http(s):` or `data:` URL the
+ * payload carries), and the {@link RenditionRequest}. Answer the URL of a copy
+ * of that picture at least `width` pixels wide (or the original's own width,
+ * where the original is narrower), keeping its aspect ratio, or `undefined`
+ * to have the view draw the whole picture, which is exactly what it does with
+ * no such function. Synchronous and pure, for the reasons `ResolveUrl` gives:
+ * a host that presigns its copies resolves them in a batch before it renders
+ * and closes over the result.
+ *
+ * - **The answer passes the URL gate**, as any resolver's does, and an answer
+ *   the gate refuses counts as none.
+ * - **It only ever paints.** The copy is the `src` of that one small picture
+ *   and nothing else: the viewer the picture opens, its "open the original"
+ *   link, its copy control and every download keep the whole picture's URL,
+ *   chosen as before (`resolveUrl`, then `public_url`, then `url`). A copy
+ *   therefore never becomes the file a reader opens, saves or shares, and is
+ *   never framed.
+ * - **It is asked only about a picture the view can already paint.** A copy
+ *   makes a picture lighter; it never makes one showable that is not, so a
+ *   stored reference neither `resolveUrl` nor the payload can paint is still
+ *   named rather than drawn.
+ * - **A copy that does not load gives way to the whole picture**, so a
+ *   missing copy costs the reader the wait, never the picture.
+ */
+type ResolveRendition = (url: string, request: RenditionRequest) => string | undefined;
 /**
  * How a stored reference becomes a URL that works OUTSIDE this page — pasted
  * into another tab, another app, a colleague's message.
@@ -1069,6 +1171,13 @@ interface ResultEnv {
      * answer, so a page is never held back by it for good.
      */
     resolveUrls?: ResolveUrls;
+    /**
+     * A smaller copy of a picture, for the places the view draws one small: a
+     * gallery's tiles and a table cell's thumbnail. Optional; unset, or for a
+     * picture it does not answer, the whole picture is drawn. See
+     * {@link ResolveRendition}.
+     */
+    resolveRendition?: ResolveRendition;
     resolveShareUrl?: ResolveShareUrl;
     proseImages?: ProseImages;
     /**
@@ -1118,7 +1227,7 @@ interface ResultEnv {
      */
     renderPdf?: RenderPdf;
 }
-declare function ResultEnvProvider({ resolveUrl, resolveUrls, resolveShareUrl, proseImages, tableColumns, tableLayout, saveFiles, downloads, renderPdf, children, }: ResultEnv & {
+declare function ResultEnvProvider({ resolveUrl, resolveUrls, resolveRendition, resolveShareUrl, proseImages, tableColumns, tableLayout, saveFiles, downloads, renderPdf, children, }: ResultEnv & {
     children: ReactNode;
 }): react.JSX.Element;
 /**
@@ -1134,6 +1243,8 @@ declare function ResultEnvProvider({ resolveUrl, resolveUrls, resolveShareUrl, p
 declare function useResolvedUrl(url: string): string;
 /** For the non-React readers that need the same answer (previewability). */
 declare function useResolveUrl(): ResolveUrl | undefined;
+/** The host's smaller copies of a picture, when it supplies them. */
+declare function useResolveRendition(): ResolveRendition | undefined;
 /** The share-URL minter, when the host supplies one. */
 declare function useResolveShareUrl(): ResolveShareUrl | undefined;
 /** The prose-image policy, defaulted to the safe answer for a host that stated none. */
@@ -1196,8 +1307,11 @@ interface StuffViewerProps {
      *
      * So the name comes from the caller, because only the caller knows it: the
      * graph knows which node was opened, a run page knows which variable it is
-     * showing. Absent, the descriptor's own name stands, which keeps a host that
-     * has nothing better to say honest rather than blank.
+     * showing. Absent, the descriptor's own name stands in `studio`, which keeps
+     * a host that has nothing better to say honest rather than blank. In `app`
+     * the panel draws a title only when this is given: "Output" tells a method
+     * app's reader nothing, and a host that heads the result itself wants no
+     * second heading under its own.
      *
      * It also supplies `downloadBaseName`'s default, so the file a reader saves
      * is named after the thing they were reading rather than `output.json`.
@@ -1604,4 +1718,4 @@ declare function FieldDomIdProvider({ prefix, children, }: {
  */
 declare function useFieldDomId(path: string): string;
 
-export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, type DownloadDisplay, EN_FIELD_STRINGS, EnumField, ExampleSource, FIELD_STRINGS_BY_LOCALE, FR_FIELD_STRINGS, FieldDomIdProvider, FieldEnv, type FieldPresentation, FieldPresentationProvider, FieldShell, type FieldStrings, FieldStringsProvider, FilePickerSource, FillWithExample, type FillWithExampleProps, FormExample, type HtmlPdf, type HtmlPdfOptions, HtmlPreview, type HtmlPreviewProps, JsonView, ListField, Markdown, type MarkdownProps, type MarkupResolvers, MethodForm, type MethodFormController, type MethodFormProps, type MethodFormState, type MethodFormUploadContext, type MethodFormValues, NumberField, ObjectField, OptionalToggle, PdfDownloadButton, type PdfDownloadButtonProps, type PdfPage, ProseField, type ProseImages, type RenderPdf, type ResolveShareUrl, type ResolveUrl, type ResolveUrls, ResultEnvProvider, ResultField, type ResultFieldProps, RowMove, SUPPORTED_LOCALES, StuffViewer, type StuffViewerProps, type StuffViewerView, type TableLayout, TextField, UnknownField, UploadedFile, type UseMethodFormOptions, fieldControlClass, fieldStringsFor, humanizeFieldName, renderHtmlPdf, resolveHtmlStorageUrls, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useMethodForm, useProseImages, useResolveShareUrl, useResolveUrl, useResolvedUrl };
+export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, type DownloadDisplay, EN_FIELD_STRINGS, EnumField, ExampleSource, FIELD_STRINGS_BY_LOCALE, FR_FIELD_STRINGS, FieldDomIdProvider, FieldEnv, type FieldPresentation, FieldPresentationProvider, FieldShell, type FieldStrings, FieldStringsProvider, FilePickerSource, FillWithExample, type FillWithExampleProps, FormExample, type HtmlPdf, type HtmlPdfOptions, HtmlPreview, type HtmlPreviewProps, JsonView, ListField, Markdown, type MarkdownProps, type MarkupResolvers, MethodForm, type MethodFormController, type MethodFormProps, type MethodFormState, type MethodFormUploadContext, type MethodFormValues, NumberField, ObjectField, OptionalToggle, PdfDownloadButton, type PdfDownloadButtonProps, type PdfPage, ProseField, type ProseImages, type RenderPdf, type RenditionRequest, type ResolveRendition, type ResolveShareUrl, type ResolveUrl, type ResolveUrls, ResultEnvProvider, ResultField, type ResultFieldProps, RowMove, SUPPORTED_LOCALES, StuffViewer, type StuffViewerProps, type StuffViewerView, type TableLayout, TextField, UnknownField, UploadedFile, type UseMethodFormOptions, fieldControlClass, fieldStringsFor, humanizeFieldName, renderHtmlPdf, resolveHtmlStorageUrls, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useMethodForm, useProseImages, useResolveRendition, useResolveShareUrl, useResolveUrl, useResolvedUrl };

package/dist/react/index.js

@@ -1,11 +1,11 @@
 "use client";
-export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, DocumentField, EN_FIELD_STRINGS, EnumField, FIELD_STRINGS_BY_LOCALE, FR_FIELD_STRINGS, FieldDomIdProvider, FieldPresentationProvider, FieldRenderer, FieldShell, FieldStringsProvider, FilePicker, FilePickerEntry, FillWithExample, HtmlPreview, ImageField, JsonView, ListField, Markdown, MethodForm, NumberField, ObjectField, OptionalToggle, PdfDownloadButton, ProseField, ResultEnvProvider, ResultField, SUPPORTED_LOCALES, StuffViewer, TextField, UnknownField, fieldControlClass, fieldStringsFor, humanizeFieldName, renderHtmlPdf, resolveHtmlStorageUrls, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useMethodForm, useProseImages, useResolveShareUrl, useResolveUrl, useResolvedUrl } from '../chunk-UGKFWX7L.js';
-import '../chunk-ICUEHNEH.js';
+export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, DocumentField, EN_FIELD_STRINGS, EnumField, FIELD_STRINGS_BY_LOCALE, FR_FIELD_STRINGS, FieldDomIdProvider, FieldPresentationProvider, FieldRenderer, FieldShell, FieldStringsProvider, FilePicker, FilePickerEntry, FillWithExample, HtmlPreview, ImageField, JsonView, ListField, Markdown, MethodForm, NumberField, ObjectField, OptionalToggle, PdfDownloadButton, ProseField, ResultEnvProvider, ResultField, SUPPORTED_LOCALES, StuffViewer, TextField, UnknownField, fieldControlClass, fieldStringsFor, humanizeFieldName, renderHtmlPdf, resolveHtmlStorageUrls, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useMethodForm, useProseImages, useResolveRendition, useResolveShareUrl, useResolveUrl, useResolvedUrl } from '../chunk-RSYOZZZF.js';
+import '../chunk-QWHUUMSB.js';
 import '../chunk-VH5CDQDR.js';
 import '../chunk-NSHGLM6A.js';
-import '../chunk-RRTI7AIR.js';
+import '../chunk-QINLJ5RM.js';
 import '../chunk-ZX52CQJ4.js';
-import '../chunk-CM4KVG53.js';
+import '../chunk-JSPF4BQP.js';
 import '../chunk-ZB4RYUKV.js';
 import '../chunk-FABY3DEY.js';
 import '../chunk-XCO6GTEC.js';