@pipelex/mthds-form 0.10.1 → 0.12.0

package/dist/core/stuff-files.js

@@ -1,5 +1,5 @@
-export { collectStuffFiles } from '../chunk-4JQAJT7C.js';
-import '../chunk-TID7ZN63.js';
+export { collectStuffFiles, readStuffFile } from '../chunk-VS5JMFUV.js';
+import '../chunk-CM4KVG53.js';
 import '../chunk-V3OV2XQT.js';
 //# sourceMappingURL=stuff-files.js.map
 //# sourceMappingURL=stuff-files.js.map

package/dist/field-renderer-C5Onx6qB.d.ts

@@ -0,0 +1,65 @@
+import * as react from 'react';
+import { RunField } from './core/descriptor.js';
+
+/**
+ * Ambient state that any field in the tree may need, threaded unchanged through
+ * the recursion so containers don't have to re-plumb it for every child.
+ */
+interface FieldEnv {
+    disabled?: boolean;
+    /**
+     * A file field asks its parent to upload; the parent sets the value later.
+     *
+     * Its presence is the capability. A host that supplies it gets a dropzone on
+     * every file field; a host that does not gets no dropzone and no file picker,
+     * because a file taken with nowhere to go used to be dropped without a word.
+     * See docs/upload-seam.md, "Which ways into a file value a host offers".
+     */
+    onDropFile?: (id: string, file: File) => void;
+    /**
+     * Whether a file field offers a link input, the way in that needs no upload.
+     * `true` when absent; `false` hides the "paste a URL instead" toggle and the
+     * input behind it on every file field.
+     *
+     * It governs that input and nothing else. A file value is a URL whichever way
+     * it arrived, so this says nothing about which values are valid: a web link
+     * the host writes is still shown on the field's card and can still be
+     * cleared. Setting it to `false` with no `onDropFile` leaves a file field no
+     * way in at all, and the field throws, naming its path, when it renders.
+     */
+    allowUrl?: boolean;
+    /** Ids currently mid-upload. */
+    uploadingIds?: ReadonlySet<string>;
+    /**
+     * Why an upload failed, keyed by the same id `onDropFile` was handed, so the
+     * message shows on the field that took the file rather than under the whole
+     * form, where only its wording could say which input failed.
+     *
+     * The map is the host's truth about each upload attempt: a host removes an
+     * entry when the next file is dropped at that id, and sets it again if that
+     * upload fails too. A clear or a typed link on the field hides the message
+     * until the host sends a different one or removes it, and a list holds back
+     * the entries a row removal left at a renumbered position.
+     */
+    uploadErrors?: ReadonlyMap<string, string>;
+    /** Resolve a `pipelex-storage://` URI to a browser-viewable URL (for previews
+     *  of already-stored files). */
+    resolveUrl?: (uri: string) => Promise<string | null>;
+}
+interface FieldRendererProps {
+    field: RunField;
+    value: unknown;
+    onChange: (value: unknown) => void;
+    /** Unique, stable id used for label linkage and upload tracking. */
+    id: string;
+    error?: string;
+    env?: FieldEnv;
+}
+/**
+ * The single dispatch point: a normalized `RunField` → the matching control.
+ * Object and list fields recurse back through here, so the whole form is one
+ * data-driven tree with no per-type branching anywhere else.
+ */
+declare function FieldRenderer({ field, value, onChange, id, error, env }: FieldRendererProps): react.JSX.Element;
+
+export { type FieldEnv as F, FieldRenderer as a, type FieldRendererProps as b };

package/dist/generative/index.d.ts

@@ -7,7 +7,7 @@ import * as react from 'react';
 import * as _json_render_react from '@json-render/react';
 import { Components, Renderer } from '@json-render/react';
 import * as zod_v4_core from 'zod/v4/core';
-import { F as FieldEnv } from '../field-renderer-BSU2hMf6.js';
+import { F as FieldEnv } from '../field-renderer-C5Onx6qB.js';
 import '../core/contracts.js';
 import 'mthds/protocol';
 import '../core/file-formats.js';

package/dist/generative/index.js

@@ -1,7 +1,8 @@
 "use client";
-import { cn, fieldControlClass, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-W56WIIVC.js';
-import '../chunk-4JQAJT7C.js';
-import { isNativeValueNode, readDateContent, formatDateContent, isNativeHtmlNode, isNativeDateNode, isNativeCompositeNode } from '../chunk-TID7ZN63.js';
+import { cn, fieldControlClass, ResultRoot, ResultField, FieldRenderer, ToggleGroup, ToggleGroupItem, Switch, Select, SelectTrigger, SelectValue, SelectContent, SelectItem } from '../chunk-4KX6YTLW.js';
+import '../chunk-V7T4DM63.js';
+import '../chunk-VS5JMFUV.js';
+import { isNativeValueNode, readDateContent, formatDateContent, isNativeHtmlNode, isNativeDateNode, isNativeCompositeNode } from '../chunk-CM4KVG53.js';
 import '../chunk-FABY3DEY.js';
 import '../chunk-XCO6GTEC.js';
 import '../chunk-PM55AHRO.js';
@@ -2292,8 +2293,9 @@ function MthdsResult({ props }) {
   const path = useAbsolutePath(props.path) ?? "";
   const field = scope.result && path ? resultFieldAtPath(scope.result, path) : void 0;
   const value = useStateValue(path);
-  if (!field) return /* @__PURE__ */ jsx(Unresolved, { path: props.path, side: "result" });
-  return /* @__PURE__ */ jsx(ResultField, { field, value, hideLabel: props.hideLabel ?? false });
+  if (!field || !scope.result) return /* @__PURE__ */ jsx(Unresolved, { path: props.path, side: "result" });
+  const place = [scope.result.name, ...segmentsUnder(RESULT_ROOT, path) ?? []];
+  return /* @__PURE__ */ jsx(ResultRoot, { baseName: scope.result.name, path: place, children: /* @__PURE__ */ jsx(ResultField, { field, value, hideLabel: props.hideLabel ?? false }) });
 }
 function AccessibleSelect({ props, bindings, emit }) {
   const [boundValue, setBoundValue] = useBoundProp(