@pipelex/mthds-form 0.23.2 → 0.24.0

package/dist/{chunk-O2VIVDHO.js → chunk-NSHGLM6A.js}

@@ -24,6 +24,29 @@ function addChosenFiles(held, chosen) {
   }
   return items;
 }
+function placeDroppedFiles(held, count, maxItemCount, isFree = () => true) {
+  const items = [...held ?? []];
+  const targets = [];
+  for (let index = 0; index < items.length && targets.length < count; index += 1) {
+    if (heldUrl(items[index]) === void 0 && isFree(index)) targets.push(index);
+  }
+  let appended = 0;
+  while (targets.length < count && (maxItemCount === void 0 || items.length < maxItemCount)) {
+    targets.push(items.length);
+    items.push(void 0);
+    appended += 1;
+  }
+  return { items, appended, targets, leftOut: count - targets.length };
+}
+function roomForDroppedFiles(held, maxItemCount, isFree = () => true) {
+  if (maxItemCount === void 0) return void 0;
+  const items = held ?? [];
+  let free = 0;
+  for (let index = 0; index < items.length; index += 1) {
+    if (heldUrl(items[index]) === void 0 && isFree(index)) free += 1;
+  }
+  return free + Math.max(0, maxItemCount - items.length);
+}
 function chosenFilesAdded(held, chosen) {
   const urls = heldUrls(held ?? []);
   const before = urls.size;
@@ -36,6 +59,6 @@ function roomForChosenFiles(held, maxItemCount) {
   return Math.max(0, maxItemCount - files);
 }
 
-export { addChosenFiles, chosenFilesAdded, roomForChosenFiles, sourceFileValue };
-//# sourceMappingURL=chunk-O2VIVDHO.js.map
-//# sourceMappingURL=chunk-O2VIVDHO.js.map
+export { addChosenFiles, chosenFilesAdded, placeDroppedFiles, roomForChosenFiles, roomForDroppedFiles, sourceFileValue };
+//# sourceMappingURL=chunk-NSHGLM6A.js.map
+//# sourceMappingURL=chunk-NSHGLM6A.js.map

package/dist/chunk-NSHGLM6A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/sources.ts"],"names":[],"mappings":"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","file":"chunk-NSHGLM6A.js","sourcesContent":["/**\n * The two optional host seams beside the upload: a **file source**, which lets\n * a file field take a file the host already stores, and an **example source**,\n * which lets a whole form take a set of values someone saved for the method.\n *\n * The kernel states the shapes and applies the answers; the host answers. It\n * knows nothing of any platform's routes, records or permissions: a host maps\n * its own list onto these shapes, and a host that gives neither seam gets the\n * form it had before. The controls that use them are `./react`'s\n * (`FilePicker`, `FillWithExample`), and docs/sources.md is the contract.\n *\n * Shapes and pure functions only, so a host's server can import the types it\n * answers with, and the rules that write an answer into a value are tested in\n * node. No React, no fetch. What a row SAYS is data here (`SourceFile`'s\n * `typeLabel` and `origin` are the host's words); how a row DRAWS is a\n * rendering, so the glyph a host draws on a row is `./react`'s\n * (`FilePickerSource.renderGlyph`), never a field of these shapes.\n */\n\n/** Whose files a file source lists: the person's own, or the whole team's. */\nexport type FileSourceScope = 'mine' | 'everyone';\n\n/** One page of a file source's list, as the picker asks for it. */\nexport interface FileSourceQuery {\n  /** What the person searched for, trimmed; empty when they searched for nothing. */\n  search: string;\n  /** Whose files to list. */\n  scope: FileSourceScope;\n  /**\n   * The MIME types the field accepts, after any narrowing a host applied\n   * (`narrowFileFormats`), in the field's own order. The list must hold only\n   * files of these types: the picker writes what is chosen straight into the\n   * field, and a field that refuses a dropped file of another type must not\n   * be handed one this way.\n   */\n  mediaTypes: readonly string[];\n  /** Where to continue: absent for the first page, else the previous page's `nextCursor`. */\n  cursor?: string;\n  /** Aborted when the answer is no longer wanted: a newer search, a closed picker. */\n  signal: AbortSignal;\n}\n\n/** One row of a file source's list: a file the host already stores. */\nexport interface SourceFile {\n  /** The row's identity in the host's list, which a choice is kept by. */\n  id: string;\n  /**\n   * The stored file's address, written into the field as its `url`, exactly as\n   * an upload's result is. Several rows may share one address.\n   */\n  url: string;\n  /** The file's name, shown on the row and written into the field as its `filename`. */\n  name: string;\n  /**\n   * The file's MIME type, which picks the field's format the row's file is:\n   * the row names that format's label (\"PNG\") unless `typeLabel` words the\n   * type, and draws an image's glyph or a document's from it unless the\n   * host draws its own.\n   */\n  mediaType?: string;\n  /**\n   * The file's type in the host's own words (\"Picture\", \"PDF document\"), said\n   * on the row's second line in place of the format's label, so a row reads\n   * as the host's own list of files does. An empty string counts as none.\n   */\n  typeLabel?: string;\n  /** The file's size in bytes. */\n  size?: number;\n  /** How the file came to be. A `test` file is marked \"Test file\" at the head of its row's second line. */\n  kind?: 'uploaded' | 'generated' | 'test';\n  /** When the file was stored, as an ISO 8601 timestamp; the row says it as a date. */\n  createdAt?: string;\n  /**\n   * Where the file came from, in the host's own words (\"Uploaded by Ana\",\n   * \"Made by Invoice extraction\"), shown on the row's second line as it is.\n   */\n  origin?: string;\n}\n\n/** One page of a file source's answer. */\nexport interface FileSourcePage {\n  /** The page's files, newest first. A page may be empty and still carry a cursor. */\n  files: readonly SourceFile[];\n  /** Where the next page starts, or nothing when this page is the last. */\n  nextCursor?: string | null;\n}\n\n/**\n * Where a file field can take a file the host already stores. When a form has\n * one, every file field offers \"Choose from your team's files\", and a list of\n * files offers it for several at once.\n */\nexport interface FileSource {\n  /** Lists one page of files for a query. Rejecting shows the failure with Try again. */\n  list: (query: FileSourceQuery) => Promise<FileSourcePage>;\n  /** Which of Mine and Everyone the picker opens on. */\n  initialScope: FileSourceScope;\n}\n\n/** One example of a method: a name and the inputs a run of it sends. */\nexport interface FormExample {\n  /** The example's identity in the host's list. */\n  id: string;\n  /** The example's name, shown on its row. */\n  name: string;\n  /**\n   * The inputs as a run takes them: each input `{ concept, content }`, an\n   * optional input left out, an empty plural input a bare `[]`. It is the\n   * shape `apiInputsFromRunValues` produces, so a host saves an example from\n   * `form.inputs` and hands it back as it is.\n   */\n  inputs: Readonly<Record<string, unknown>>;\n}\n\n/** One page of an example source's list. */\nexport interface ExampleSourceQuery {\n  /** Where to continue: absent for the first page, else the previous page's `nextCursor`. */\n  cursor?: string;\n  /** Aborted when the answer is no longer wanted. */\n  signal: AbortSignal;\n}\n\n/** One page of an example source's answer. */\nexport interface ExampleSourcePage {\n  /** The page's examples, in the order the list shows them. */\n  examples: readonly FormExample[];\n  /** Where the next page starts, or nothing when this page is the last. */\n  nextCursor?: string | null;\n}\n\n/**\n * Where a form can take a whole set of values. When a form has one, it offers\n * \"Fill with an example\". `rename` and `delete` are capabilities: each is\n * offered on a row's menu only when given, so a host gives them only to a\n * person allowed to change examples.\n */\nexport interface ExampleSource {\n  /** Lists one page of the method's examples. Rejecting shows the failure with Try again. */\n  list: (query: ExampleSourceQuery) => Promise<ExampleSourcePage>;\n  /**\n   * Renames an example. Resolving to the example as stored replaces the row;\n   * resolving to nothing keeps the row under the new name.\n   */\n  rename?: (example: FormExample, name: string) => Promise<FormExample | void>;\n  /** Deletes an example. Asked for only after the person confirmed it. */\n  delete?: (example: FormExample) => Promise<void>;\n  /**\n   * Whether \"Fill with an example\" is left out while the method has no\n   * example. `false` by default, when the empty list says how to make one.\n   * A host sets it for a person who cannot save an example, to whom an empty\n   * list has nothing to offer; the form then asks for the first page as it\n   * mounts, to know whether to offer the control.\n   */\n  hideWhenEmpty?: boolean;\n}\n\n/** What a chosen file writes into its field: the same `{ url, filename }` an upload writes. */\nexport function sourceFileValue(file: SourceFile): { url: string; filename: string } {\n  return { url: file.url, filename: file.name };\n}\n\n/** The `url` a list item holds, when it is a file value holding one. */\nfunction heldUrl(item: unknown): string | undefined {\n  if (!item || typeof item !== 'object') return undefined;\n  const url = (item as { url?: unknown }).url;\n  return typeof url === 'string' && url !== '' ? url : undefined;\n}\n\n/** The addresses a list's items hold, each once. */\nfunction heldUrls(items: readonly unknown[]): Set<string> {\n  return new Set(items.map(heldUrl).filter((url): url is string => url !== undefined));\n}\n\n/**\n * A list of files with the chosen files written into it, in the order they\n * were chosen: first into the rows that hold no file yet (a row the person\n * added and left empty), then as new rows after the last. A file whose address\n * the list already holds is not written again, and neither is a second choice\n * of one address: two rows of a source may name the same stored file. Returns\n * a new array and leaves `held` as it was.\n */\nexport function addChosenFiles(\n  held: readonly unknown[] | undefined,\n  chosen: readonly SourceFile[],\n): unknown[] {\n  const items = [...(held ?? [])];\n  const urls = heldUrls(items);\n  let free = 0;\n  for (const file of chosen) {\n    if (urls.has(file.url)) continue;\n    urls.add(file.url);\n    while (free < items.length && heldUrl(items[free]) !== undefined) free += 1;\n    if (free < items.length) items[free] = sourceFileValue(file);\n    else items.push(sourceFileValue(file));\n    free += 1;\n  }\n  return items;\n}\n\n/** Where `placeDroppedFiles` puts a batch of files, and what it leaves out. */\nexport interface DroppedFilesPlacement {\n  /**\n   * The list once the rows the batch needs are appended: `held` as it was,\n   * then one empty row (`undefined`) per file that did not go into a free row.\n   * A new array whenever rows are appended, and a copy of `held` otherwise.\n   */\n  items: unknown[];\n  /** How many rows were appended, so a caller writes the list only when it grew. */\n  appended: number;\n  /** The row each placed file goes to, in the order the files were given. */\n  targets: number[];\n  /** How many files, from the end of the batch, found no room. */\n  leftOut: number;\n}\n\n/**\n * Where a batch of `count` files dropped on a list of files goes: first into\n * the rows that are free, in index order, then into new rows after the last,\n * as far as `maxItemCount` allows. The files keep the order they were given,\n * and those beyond the room are left out from the end of the batch.\n *\n * A row is free when it holds no file (its value carries no `url`) and\n * `isFree` says so too. The caller's predicate is where it adds what only it\n * knows of a row: that a file is still arriving there, whose write-back the row\n * must be kept for, or that the host reports a failure there, the only record\n * that one of the person's files did not arrive. Without one, every row holding\n * no file is free.\n *\n * It mirrors `addChosenFiles`, so the two ways several files enter a list fill\n * it alike, and it knows nothing of `File`: the caller judges each file and\n * hands over how many it accepted.\n */\nexport function placeDroppedFiles(\n  held: readonly unknown[] | undefined,\n  count: number,\n  maxItemCount: number | undefined,\n  isFree: (index: number) => boolean = () => true,\n): DroppedFilesPlacement {\n  const items = [...(held ?? [])];\n  const targets: number[] = [];\n  for (let index = 0; index < items.length && targets.length < count; index += 1) {\n    if (heldUrl(items[index]) === undefined && isFree(index)) targets.push(index);\n  }\n  let appended = 0;\n  while (targets.length < count && (maxItemCount === undefined || items.length < maxItemCount)) {\n    targets.push(items.length);\n    items.push(undefined);\n    appended += 1;\n  }\n  return { items, appended, targets, leftOut: count - targets.length };\n}\n\n/**\n * How many files `placeDroppedFiles` can place in `held`: its free rows, by the\n * same test, and the rows its bound still allows after the last. `undefined`\n * when the list has no bound, since appending then never runs out.\n */\nexport function roomForDroppedFiles(\n  held: readonly unknown[] | undefined,\n  maxItemCount: number | undefined,\n  isFree: (index: number) => boolean = () => true,\n): number | undefined {\n  if (maxItemCount === undefined) return undefined;\n  const items = held ?? [];\n  let free = 0;\n  for (let index = 0; index < items.length; index += 1) {\n    if (heldUrl(items[index]) === undefined && isFree(index)) free += 1;\n  }\n  return free + Math.max(0, maxItemCount - items.length);\n}\n\n/**\n * How many files `addChosenFiles` writes for `chosen` into `held`: the choices\n * whose address the list does not hold yet, each address once. This is what a\n * choice spends of `roomForChosenFiles`, so a held file chosen again, or a\n * second row naming a chosen file, takes no room.\n */\nexport function chosenFilesAdded(\n  held: readonly unknown[] | undefined,\n  chosen: readonly SourceFile[],\n): number {\n  const urls = heldUrls(held ?? []);\n  const before = urls.size;\n  for (const file of chosen) urls.add(file.url);\n  return urls.size - before;\n}\n\n/**\n * How many files a list may still take from a source: its bound less the files\n * it holds, since `addChosenFiles` writes into its empty rows before adding\n * any. `undefined` when the list has no bound.\n */\nexport function roomForChosenFiles(\n  held: readonly unknown[] | undefined,\n  maxItemCount: number | undefined,\n): number | undefined {\n  if (maxItemCount === undefined) return undefined;\n  const files = (held ?? []).filter((item) => heldUrl(item) !== undefined).length;\n  return Math.max(0, maxItemCount - files);\n}\n"]}

package/dist/{chunk-W5MYXDLO.js → chunk-UGKFWX7L.js}

@@ -1,6 +1,6 @@
 import { planFileSave, planStuffSave, splitFileName, typedFileStem } from './chunk-ICUEHNEH.js';
 import { seedInputs, closeOptionalStructures, openOptionalStructures } from './chunk-VH5CDQDR.js';
-import { sourceFileValue, roomForChosenFiles, addChosenFiles, chosenFilesAdded } from './chunk-O2VIVDHO.js';
+import { sourceFileValue, roomForChosenFiles, roomForDroppedFiles, addChosenFiles, placeDroppedFiles, chosenFilesAdded } from './chunk-NSHGLM6A.js';
 import { readStuffFile } from './chunk-RRTI7AIR.js';
 import { apiInputsFromRunValues, sameRunValues, runValuesFromInputs, setValueAtPath } from './chunk-ZX52CQJ4.js';
 import { viewableUrl, isNativeDateNode, isNativeHtmlNode, readHtmlContent, isNativeCompositeNode, readCompositeContent, isNativeValueNode, readDateContent, formatDateContent, readImageContent, readDataUrl, readDocumentContent } from './chunk-CM4KVG53.js';
@@ -31,6 +31,9 @@ import { marked } from 'marked';
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
+function isThenable(answer) {
+  return (typeof answer === "object" || typeof answer === "function") && answer !== null && typeof answer.then === "function";
+}
 var CATEGORY_ICON = {
   text: Type,
   date: CalendarDays,
@@ -222,6 +225,9 @@ function formatFileDate(date) {
   if (days === 1) return "Yesterday";
   return inCurrentYear(date) ? DAY.format(date) : DAY_YEAR.format(date);
 }
+function someNames(names, more) {
+  return AND.format(more > 0 ? [...names, `${more} more`] : names);
+}
 var EN_FIELD_STRINGS = {
   optionalBadge: "optional",
   selectPlaceholder: "Select\u2026",
@@ -276,6 +282,18 @@ var EN_FIELD_STRINGS = {
   yes: "Yes",
   no: "No",
   unsupportedFileType: (formats) => `That file type is not supported. Accepted formats: ${formats}.`,
+  dropFilesOrBrowse: "Drop files or click to browse",
+  dropFilesToAdd: "Drop to add the files",
+  addFilesAria: (label) => label ? `Add files to ${label}` : "Add files",
+  filesAdded: (count) => count === 1 ? "1 file added" : `${count} files added`,
+  filesRefused: (names, more, formats) => `${names.length + more === 1 ? "Not added, because its" : "Not added, because their"} file type is not supported: ${someNames(names, more)}. Accepted formats: ${formats}.`,
+  filesLeftOut: (names, more, fitted) => {
+    const these = names.length + more === 1 ? "this file was" : "these files were";
+    const room = fitted === 0 ? "The list is full" : `The list had room for ${fitted === 1 ? "1 more file" : `${fitted} more files`}`;
+    return `${room}, so ${these} not added: ${someNames(names, more)}.`;
+  },
+  oneFileOnly: "This field takes one file.",
+  oneFileOnlyInList: "This field takes one file. Drop several files on the list's drop area.",
   hideOptionalFields: "Hide optional fields",
   hideOptionalInputs: "Hide optional inputs",
   optionalFieldsCount: (count) => count === 1 ? "1 optional field" : `${count} optional fields`,
@@ -377,6 +395,9 @@ function formatBytes2(bytes) {
   if (bytes < 1024 * 1024) return KILOBYTES.format(bytes / 1024);
   return MEGABYTES.format(bytes / (1024 * 1024));
 }
+function someNames2(names, more) {
+  return AND2.format(more > 0 ? [...names, `${more} ${plural(more, "autre", "autres")}`] : names);
+}
 var FR_FIELD_STRINGS = {
   optionalBadge: "facultatif",
   selectPlaceholder: "Choisir\u2026",
@@ -431,6 +452,18 @@ var FR_FIELD_STRINGS = {
   yes: "Oui",
   no: "Non",
   unsupportedFileType: (formats) => `Ce type de fichier n\u2019est pas pris en charge. Formats accept\xE9s\xA0: ${formats}.`,
+  dropFilesOrBrowse: "D\xE9posez des fichiers ou cliquez pour parcourir",
+  dropFilesToAdd: "D\xE9posez pour ajouter les fichiers",
+  addFilesAria: (label) => label ? `Ajouter des fichiers \xE0 ${label}` : "Ajouter des fichiers",
+  filesAdded: (count) => `${count} ${plural(count, "fichier ajout\xE9", "fichiers ajout\xE9s")}`,
+  filesRefused: (names, more, formats) => `${names.length + more === 1 ? "Non ajout\xE9, car son type n\u2019est pas pris en charge" : "Non ajout\xE9s, car leur type n\u2019est pas pris en charge"}\xA0: ${someNames2(names, more)}. Formats accept\xE9s\xA0: ${formats}.`,
+  filesLeftOut: (names, more, fitted) => {
+    const these = names.length + more === 1 ? "ce fichier n\u2019a donc pas \xE9t\xE9 ajout\xE9" : "ces fichiers n\u2019ont donc pas \xE9t\xE9 ajout\xE9s";
+    const room = fitted === 0 ? "La liste est pleine" : `La liste n\u2019avait de place que pour ${fitted} ${plural(fitted, "fichier", "fichiers")} de plus`;
+    return `${room}, ${these}\xA0: ${someNames2(names, more)}.`;
+  },
+  oneFileOnly: "Ce champ accepte un seul fichier.",
+  oneFileOnlyInList: "Ce champ accepte un seul fichier. D\xE9posez-en plusieurs dans la zone de d\xE9p\xF4t de la liste.",
   hideOptionalFields: "Masquer les champs facultatifs",
   hideOptionalInputs: "Masquer les entr\xE9es facultatives",
   optionalFieldsCount: (count) => `${count} ${plural(count, "champ facultatif", "champs facultatifs")}`,
@@ -1267,6 +1300,10 @@ function FileRow({
     }
   );
 }
+var ListDropAreaContext = createContext(null);
+function useListDropArea() {
+  return useContext(ListDropAreaContext);
+}
 var IMAGE_EXT_RE = /\.(jpg|jpeg|png|gif|webp|bmp|svg|avif)(\?|$)/i;
 var PDF_EXT_RE = /\.pdf(\?|$)/i;
 var DATA_URL_MIME_RE = /^data:([^;,]+)/i;
@@ -1278,9 +1315,6 @@ function isReadableLink(url) {
 function dataUrlMime(url) {
   return DATA_URL_MIME_RE.exec(url)?.[1]?.toLowerCase();
 }
-function isThenable(answer) {
-  return (typeof answer === "object" || typeof answer === "function") && answer !== null && typeof answer.then === "function";
-}
 function storedUrlOf(stored) {
   if (typeof stored === "string") return stored === "" ? void 0 : stored;
   if (stored === null || typeof stored !== "object") return void 0;
@@ -1336,6 +1370,7 @@ function FileField({
   }, []);
   useEffect(() => () => setLocal(null), [setLocal]);
   const [rejected, setRejected] = useState(null);
+  const dropArea = useListDropArea();
   const [dismissedUploadError, setDismissedUploadError] = useState(null);
   useEffect(() => {
     if (uploadError === void 0) setDismissedUploadError(null);
@@ -1349,19 +1384,11 @@ function FileField({
   const hint = acceptLabel(formats);
   const accept = useMemo(() => acceptMap(formats), [formats]);
   const canUpload = onDropFile !== void 0;
-  const handleFile = useCallback(
-    (file) => {
-      if (!onDropFile) return;
-      if (!isAcceptedFile(formats, file)) {
-        setRejected(file.name);
-        return;
-      }
-      setRejected(null);
-      setDismissedUploadError(null);
-      const upload = onDropFile(file);
+  const track = useCallback(
+    (file, upload, heldUrl) => {
       const awaitingUpload = isThenable(upload);
       setLocal({ objectUrl: URL.createObjectURL(file), type: file.type, awaitingUpload });
-      urlInFlight.current = value?.url;
+      urlInFlight.current = heldUrl;
       flightSeen.current = false;
       if (!awaitingUpload) return;
       const generation = localGeneration.current;
@@ -1378,8 +1405,28 @@ function FileField({
         }
       );
     },
-    [formats, setLocal, onDropFile, value?.url]
+    [setLocal]
+  );
+  const handleFile = useCallback(
+    (file) => {
+      if (!onDropFile) return;
+      if (!isAcceptedFile(formats, file)) {
+        setRejected({ kind: "type", name: file.name, over: value?.url });
+        return;
+      }
+      setRejected(null);
+      setDismissedUploadError(null);
+      track(file, onDropFile(file), value?.url);
+    },
+    [formats, onDropFile, track, value?.url]
   );
+  useEffect(() => {
+    const placed = dropArea?.takePlaced(id);
+    if (!placed) return;
+    setRejected(null);
+    setDismissedUploadError(null);
+    track(placed.file, placed.upload, void 0);
+  }, [dropArea, id, track]);
   const busy = disabled || uploading;
   const {
     getRootProps,
@@ -1403,17 +1450,22 @@ function FileField({
     // handlers on a `role="presentation"` div, and the element a keyboard or
     // voice-control user lands on is a generic with no role and no name.
     noKeyboard: true,
-    onDrop: (files) => {
-      const file = files[0];
-      if (file) handleFile(file);
-    },
-    // react-dropzone rejects a file its own matcher refuses without ever calling
-    // `onDrop`, so without this a wrong drop is silently swallowed - the control
-    // simply does nothing, which reads as a broken dropzone rather than a
+    // Every drop and pick lands here, the files react-dropzone's own matcher
+    // refused included. Those must be answered: left alone, a wrong drop is
+    // silently swallowed, which reads as a broken dropzone rather than a
     // refused file.
-    onDropRejected: (rejections) => {
+    onDrop: (accepted, rejections) => {
+      if (accepted.length + rejections.length > 1) {
+        setRejected({ kind: "batch", over: value?.url });
+        return;
+      }
+      const file = accepted[0];
+      if (file) {
+        handleFile(file);
+        return;
+      }
       const name = rejections[0]?.file.name;
-      if (name) setRejected(name);
+      if (name) setRejected({ kind: "type", name, over: value?.url });
     }
   });
   const clear = useCallback(() => {
@@ -1439,11 +1491,13 @@ function FileField({
     if (!localPreview || localPreview.boundUrl !== void 0) return;
     if (failure !== null) setLocal(null);
   }, [failure, localPreview, setLocal]);
+  const refusal = rejected !== null && rejected.over === value?.url ? rejected : null;
   const lastUrl = useRef(value?.url);
   useEffect(() => {
     if (lastUrl.current === value?.url) return;
     lastUrl.current = value?.url;
     if (uploadError !== void 0) setDismissedUploadError(uploadError);
+    setRejected(null);
   }, [value?.url, uploadError]);
   useEffect(() => {
     if (!localPreview) return;
@@ -1600,11 +1654,15 @@ function FileField({
             }
           )
         ),
-        !busy && (rejected ? /* @__PURE__ */ jsxs("p", { role: "alert", className: "text-[12px] text-destructive", children: [
-          /* @__PURE__ */ jsx("span", { className: "font-mono", children: rejected }),
+        !busy && (refusal ? /* @__PURE__ */ jsx("p", { role: "alert", className: "text-[12px] text-destructive", children: refusal.kind === "type" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("span", { className: "font-mono", children: refusal.name }),
           " \u2014 ",
           s.unsupportedFileType(hint)
-        ] }) : failure && /* @__PURE__ */ jsx("p", { role: "alert", className: "text-[12px] text-destructive", children: failure })),
+        ] }) : dropArea?.open ? (
+          // Pointed to only while it takes files: a full list's area is
+          // shut, and would refuse the very drop this sends there.
+          s.oneFileOnlyInList
+        ) : s.oneFileOnly }) : failure && /* @__PURE__ */ jsx("p", { role: "alert", className: "text-[12px] text-destructive", children: failure })),
         linkOpen ? /* @__PURE__ */ jsx(
           "input",
           {
@@ -2199,6 +2257,76 @@ function firstFocusable(within) {
   }
   return null;
 }
+var NAMED = 3;
+function ListFileDrop({ label, formats, shut, onPlace }) {
+  const s = useFieldStrings();
+  const hint = acceptLabel(formats);
+  const accept = useMemo(() => acceptMap(formats), [formats]);
+  const [notice, setNotice] = useState(null);
+  const [added, setAdded] = useState({ count: 0, seq: 0 });
+  const { getRootProps, getInputProps, isDragActive } = useDropzone({
+    multiple: true,
+    disabled: shut,
+    // Filters the OS picker; `isAcceptedFile` below is the enforcement, as on a
+    // single field, because a drop bypasses the picker entirely.
+    accept,
+    noKeyboard: true,
+    onDrop: (accepted, rejections) => {
+      const refused = rejections.map((rejection) => rejection.file);
+      const taken = [];
+      for (const file of accepted) (isAcceptedFile(formats, file) ? taken : refused).push(file);
+      const fitted = taken.length > 0 ? onPlace(taken) : 0;
+      setNotice({
+        refused: refused.map((file) => file.name),
+        leftOut: taken.slice(fitted).map((file) => file.name),
+        fitted
+      });
+      if (fitted > 0) setAdded((prev) => ({ count: fitted, seq: prev.seq + 1 }));
+    }
+  });
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-1.5", children: [
+    /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ...getRootProps(),
+        "data-list-file-drop": true,
+        className: cn(
+          "flex flex-col items-center justify-center gap-1 rounded-md border border-dashed px-4 py-4 text-center max-sm:min-h-11",
+          "cursor-pointer select-none transition-colors",
+          "focus-within:ring-2 focus-within:ring-ring focus-within:ring-offset-2 focus-within:ring-offset-background",
+          isDragActive ? "border-primary/60 bg-primary/5" : "border-border bg-input hover:border-border hover:bg-muted",
+          shut && "cursor-not-allowed opacity-60"
+        ),
+        children: [
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              ...getInputProps({ tabIndex: 0 }),
+              disabled: shut,
+              "aria-label": s.addFilesAria(label)
+            }
+          ),
+          /* @__PURE__ */ jsx(Upload, { className: "h-4 w-4 text-muted-foreground", strokeWidth: 1.75 }),
+          /* @__PURE__ */ jsx("p", { className: "text-[13px] text-foreground", children: isDragActive ? s.dropFilesToAdd : s.dropFilesOrBrowse }),
+          hint && /* @__PURE__ */ jsx("p", { className: "font-mono text-[10.5px] text-muted-foreground", children: hint })
+        ]
+      }
+    ),
+    notice && (notice.refused.length > 0 || notice.leftOut.length > 0) && /* @__PURE__ */ jsxs("div", { role: "alert", className: "space-y-1 text-[12px] text-destructive", children: [
+      notice.refused.length > 0 && /* @__PURE__ */ jsx("p", { children: s.filesRefused(
+        notice.refused.slice(0, NAMED),
+        Math.max(0, notice.refused.length - NAMED),
+        hint
+      ) }),
+      notice.leftOut.length > 0 && /* @__PURE__ */ jsx("p", { children: s.filesLeftOut(
+        notice.leftOut.slice(0, NAMED),
+        Math.max(0, notice.leftOut.length - NAMED),
+        notice.fitted
+      ) })
+    ] }),
+    /* @__PURE__ */ jsx("p", { role: "status", className: "sr-only", children: /* @__PURE__ */ jsx("span", { children: added.count > 0 ? s.filesAdded(added.count) : "" }, added.seq) })
+  ] });
+}
 
 // src/react/row-moves.ts
 function destinationOf(order) {
@@ -2226,6 +2354,10 @@ function ListField({ field, value, onChange, id, error, env }) {
   const rowsRef = useRef(null);
   const landedRow = useRef(null);
   const [staleErrors, setStaleErrors] = useState(NO_ERRORS);
+  const [pending, setPending] = useState(NO_UPLOADS);
+  const nextUpload = useRef(0);
+  const rowMoves = env?.rowMoves;
+  const arriving = useMemo(() => arrivingRows(pending, rowMoves), [pending, rowMoves]);
   const setItem = (index, itemValue) => {
     const next = items.slice();
     next[index] = itemValue;
@@ -2242,7 +2374,7 @@ function ListField({ field, value, onChange, id, error, env }) {
     onChange(items.filter((_, i) => i !== index));
   };
   const addItem = () => onChange([...items, emptyValue(field.item)]);
-  const busy = listIsBusy(id, env?.uploadingIds);
+  const busy = listIsBusy(id, env?.uploadingIds) || arriving.size > 0;
   const hostErrors = env?.uploadErrors;
   useEffect(() => {
     setStaleErrors((prev) => {
@@ -2251,16 +2383,19 @@ function ListField({ field, value, onChange, id, error, env }) {
       return next.size === prev.size ? prev : next;
     });
   }, [hostErrors]);
+  const fileItem = field.item.kind === "document" || field.item.kind === "image" ? field.item : null;
+  const tracksUploads = fileItem !== null;
   const rowEnv = useMemo(() => {
-    if (!env || staleErrors.size === 0) return env;
+    if (!env || staleErrors.size === 0 && !tracksUploads) return env;
     const drop = env.onDropFile;
+    const uploadErrors = staleErrors.size === 0 ? env.uploadErrors : new Map(
+      [...env.uploadErrors ?? []].filter(
+        ([key, message]) => staleErrors.get(key) !== message
+      )
+    );
     return {
       ...env,
-      uploadErrors: new Map(
-        [...env.uploadErrors ?? []].filter(([key, message]) => staleErrors.get(key) !== message)
-      ),
-      // A new file at a position is a new attempt there, so what the host says
-      // about that position from now on is about the file that is there.
+      uploadErrors,
       onDropFile: drop ? (dropId, file) => {
         setStaleErrors((prev) => {
           if (!prev.has(dropId)) return prev;
@@ -2268,14 +2403,70 @@ function ListField({ field, value, onChange, id, error, env }) {
           next.delete(dropId);
           return next;
         });
-        return drop(dropId, file);
+        const upload = drop(dropId, file);
+        if (tracksUploads && isThenable(upload)) {
+          const token = nextUpload.current++;
+          const seq = env.rowMoves?.[env.rowMoves.length - 1]?.seq ?? 0;
+          setPending((prev) => new Map(prev).set(token, { id: dropId, seq }));
+          const answered = () => setPending((prev) => withoutUpload(prev, token));
+          void Promise.resolve(upload).then(answered, answered);
+        }
+        return upload;
       } : void 0
     };
-  }, [env, staleErrors]);
+  }, [env, staleErrors, tracksUploads]);
   const isFull = field.maxItemCount !== void 0 && items.length >= field.maxItemCount;
   const fileSource = env?.fileSource;
-  const fileItem = field.item.kind === "document" || field.item.kind === "image" ? field.item : null;
   const room = roomForChosenFiles(items, field.maxItemCount);
+  const dropFile = rowEnv?.onDropFile;
+  const dropOffered = fileItem !== null && dropFile !== void 0;
+  const isFreeRow = (index) => {
+    const rowId = `${id}.${index}`;
+    return !arriving.has(rowId) && !env?.uploadingIds?.has(rowId) && !rowEnv?.uploadErrors?.has(rowId);
+  };
+  const dropRoom = dropOffered ? roomForDroppedFiles(items, field.maxItemCount, isFreeRow) : 0;
+  const dropOpen = dropOffered && !env?.disabled && dropRoom !== 0;
+  const placed = useRef(/* @__PURE__ */ new Map());
+  const [placements, setPlacements] = useState(0);
+  const dropArea = useMemo(() => {
+    if (!dropOffered) return null;
+    return {
+      generation: placements,
+      open: dropOpen,
+      takePlaced: (rowId) => {
+        const file = placed.current.get(rowId);
+        placed.current.delete(rowId);
+        return file;
+      }
+    };
+  }, [dropOffered, dropOpen, placements]);
+  const dropRef = useRef(null);
+  const landing = useRef(null);
+  useEffect(() => {
+    const landed = landing.current;
+    if (landed === null) return;
+    landing.current = null;
+    const rows = rowsRef.current?.querySelectorAll(":scope > [data-list-row]");
+    const target = firstFocusable(rows?.[landed]) ?? followingFocusable(dropRef.current, dropRef.current);
+    target?.focus();
+  });
+  const placeFiles = (files) => {
+    if (!dropFile) return 0;
+    const placement = placeDroppedFiles(items, files.length, field.maxItemCount, isFreeRow);
+    if (placement.appended > 0) onChange(placement.items);
+    placement.targets.forEach((index, order) => {
+      const file = files[order];
+      if (!file) return;
+      const rowId = `${id}.${index}`;
+      placed.current.set(rowId, { file, upload: handOver(dropFile, rowId, file) });
+    });
+    const count = placement.targets.length;
+    if (count > 0) setPlacements((generation) => generation + 1);
+    if (count > 0 && count === dropRoom && dropRef.current?.contains(document.activeElement)) {
+      landing.current = placement.targets[count - 1] ?? null;
+    }
+    return count;
+  };
   return /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [
       /* @__PURE__ */ jsx(
@@ -2294,8 +2485,8 @@ function ListField({ field, value, onChange, id, error, env }) {
     ] }),
     field.description && /* @__PURE__ */ jsx("p", { className: "text-[12px] leading-relaxed text-muted-foreground", children: field.description }),
     /* @__PURE__ */ jsxs("div", { ref: rowsRef, className: "space-y-2", children: [
-      items.length === 0 && /* @__PURE__ */ jsx("p", { className: "rounded-md border border-dashed border-border bg-input/50 px-3 py-4 text-center text-[12px] text-muted-foreground", children: s.noItemsYet }),
-      items.map((item, index) => /* @__PURE__ */ jsxs(
+      items.length === 0 && !dropOffered && /* @__PURE__ */ jsx("p", { className: "rounded-md border border-dashed border-border bg-input/50 px-3 py-4 text-center text-[12px] text-muted-foreground", children: s.noItemsYet }),
+      /* @__PURE__ */ jsx(ListDropAreaContext.Provider, { value: dropArea, children: items.map((item, index) => /* @__PURE__ */ jsxs(
         "div",
         {
           "data-list-row": true,
@@ -2334,7 +2525,16 @@ function ListField({ field, value, onChange, id, error, env }) {
           ]
         },
         rowKeys[index] ?? index
-      )),
+      )) }),
+      dropOffered && fileItem && /* @__PURE__ */ jsx("div", { ref: dropRef, children: /* @__PURE__ */ jsx(
+        ListFileDrop,
+        {
+          label: fieldLabel(field.title, field.name, presentation),
+          formats: fileItem.formats,
+          shut: !dropOpen,
+          onPlace: placeFiles
+        }
+      ) }),
       /* @__PURE__ */ jsxs(
         "button",
         {
@@ -2411,6 +2611,42 @@ function listIsBusy(id, uploadingIds) {
   return false;
 }
 var NO_ERRORS = /* @__PURE__ */ new Map();
+var NO_IDS = /* @__PURE__ */ new Set();
+var NO_UPLOADS = /* @__PURE__ */ new Map();
+function withoutUpload(uploads, token) {
+  if (!uploads.has(token)) return uploads;
+  const next = new Map(uploads);
+  next.delete(token);
+  return next;
+}
+function arrivingRows(uploads, moves) {
+  if (uploads.size === 0) return NO_IDS;
+  const rows = /* @__PURE__ */ new Set();
+  for (const upload of uploads.values()) {
+    let at = upload.id;
+    for (const move of moves ?? []) {
+      if (at === void 0) break;
+      if (move.seq > upload.seq) at = movedId(at, move.listId, destinationOf(move.order));
+    }
+    if (at !== void 0) rows.add(at);
+  }
+  return rows;
+}
+function handOver(drop, rowId, file) {
+  try {
+    return drop(rowId, file);
+  } catch (error) {
+    reportHostError(error);
+    const failed = Promise.reject(error);
+    failed.catch(() => {
+    });
+    return failed;
+  }
+}
+function reportHostError(error) {
+  if (typeof globalThis.reportError === "function") globalThis.reportError(error);
+  else console.error(error);
+}
 function withRenumberedErrors(stale, listId, removed, hostErrors) {
   if (!hostErrors?.size) return stale;
   const prefix = `${listId}.`;
@@ -3132,12 +3368,12 @@ function withoutId(ids, id) {
   next.delete(id);
   return next;
 }
-var NO_UPLOADS = /* @__PURE__ */ new Map();
+var NO_UPLOADS2 = /* @__PURE__ */ new Map();
 var NO_MOVES = [];
 var NOTHING_HELD = {
   edited: null,
   failed: EMPTY_IDS,
-  uploads: NO_UPLOADS,
+  uploads: NO_UPLOADS2,
   moves: NO_MOVES
 };
 function withoutEntry(entries, id) {
@@ -3317,7 +3553,7 @@ function useMethodForm({
   );
   const reset = useCallback(
     (next) => {
-      commit({ edited: next ?? null, failed: EMPTY_IDS, uploads: NO_UPLOADS, moves: NO_MOVES });
+      commit({ edited: next ?? null, failed: EMPTY_IDS, uploads: NO_UPLOADS2, moves: NO_MOVES });
       setGiven(next ?? null);
       setAttempted(false);
       setResets((count) => count + 1);
@@ -6646,5 +6882,5 @@ function pdfFileName(field, value, baseName) {
 }
 
 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, ResultRoot, SUPPORTED_LOCALES, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, StuffViewer, Switch, TextField, ToggleGroup, ToggleGroupItem, UnknownField, checkedAccentClass, cn, fieldControlClass, fieldStringsFor, focusOutlineClass, humanizeFieldName, linkTextClass, renderHtmlPdf, resolveHtmlStorageUrls, saveInBrowser, selectedBorderClass, selectedFillClass, selectedFillStrongClass, useFieldDomId, useFieldPresentation, useFieldStrings, useMethodForm, useProseImages, useResolveShareUrl, useResolveUrl, useResolvedUrl };
-//# sourceMappingURL=chunk-W5MYXDLO.js.map
-//# sourceMappingURL=chunk-W5MYXDLO.js.map
+//# sourceMappingURL=chunk-UGKFWX7L.js.map
+//# sourceMappingURL=chunk-UGKFWX7L.js.map