@eifi1/ui-kit 0.33.1 → 0.35.0

package/dist/hooks/use-file-drop.d.ts

@@ -1,105 +1,5 @@
-import { DragEvent, ReactElement } from 'react';
-import { fM as UseFilePickerOptions } from '../delete-account-setting-DAgGBrbn.js';
-import '../components/tooltip.js';
-import './use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/write-lock.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import './use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import './use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import './use-authed-src.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../i18n/plurals.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
-
+import type { DragEvent, ReactElement } from "react";
+import type { UseFilePickerOptions } from "./use-file-picker.js";
 /**
  * Turn ANY element into a file drop target — kastlan's ask, for the document list of
  * a booking and the rows of its gantt, which are drop targets without being a
@@ -118,16 +18,16 @@ import '../components/focus-ring.js';
  * the same options can also back a "choose a file" menu item beside the drop target.
  */
 /** `useFilePicker`'s options, minus `capture` (a camera does not take drops). */
-type UseFileDropOptions = Omit<UseFilePickerOptions, "capture">;
+export type UseFileDropOptions = Omit<UseFilePickerOptions, "capture">;
 /** Spread onto the drop target. Four handlers, nothing else: the element keeps its
  *  own role, name and focus behaviour. */
-interface FileDropProps<E extends Element = Element> {
+export interface FileDropProps<E extends Element = Element> {
     onDragEnter: (e: DragEvent<E>) => void;
     onDragOver: (e: DragEvent<E>) => void;
     onDragLeave: (e: DragEvent<E>) => void;
     onDrop: (e: DragEvent<E>) => void;
 }
-interface UseFileDropReturn<E extends Element = Element> {
+export interface UseFileDropReturn<E extends Element = Element> {
     dropProps: FileDropProps<E>;
     /** A FILE drag is over the target (and it is not `disabled`). Style from this. */
     isOver: boolean;
@@ -141,7 +41,7 @@ interface UseFileDropReturn<E extends Element = Element> {
 }
 /** Whether a drag carries files — a dragged link, text or a row of the page does not,
  *  and must not light the target up or be swallowed by it. */
-declare function dragHasFiles(e: DragEvent): boolean;
+export declare function dragHasFiles(e: DragEvent): boolean;
 /**
  * @internal The drag half on its own, shared with `FileDropzone`.
  *
@@ -156,13 +56,11 @@ declare function dragHasFiles(e: DragEvent): boolean;
  * page-wide drop area) takes its own drop, and the outer one's count falls back to
  * zero while the pointer is over the inner one — only one of them lights up.
  */
-declare function useDragTarget<E extends Element = Element>({ disabled, onDropFiles, }: {
+export declare function useDragTarget<E extends Element = Element>({ disabled, onDropFiles, }: {
     disabled?: boolean;
     onDropFiles: (files: FileList | File[]) => void;
 }): {
     dropProps: FileDropProps<E>;
     isOver: boolean;
 };
-declare function useFileDrop<E extends Element = Element>(options: UseFileDropOptions): UseFileDropReturn<E>;
-
-export { type FileDropProps, type UseFileDropOptions, type UseFileDropReturn, dragHasFiles, useDragTarget, useFileDrop };
+export declare function useFileDrop<E extends Element = Element>(options: UseFileDropOptions): UseFileDropReturn<E>;

package/dist/hooks/use-file-drop.js

@@ -1,6 +1,6 @@
 "use client";
 import { useRef, useState } from "react";
-import { useFilePicker } from "../components/file-button.js";
+import { useFilePicker } from "./use-file-picker.js";
 function dragHasFiles(e) {
   return Array.from(e.dataTransfer?.types ?? []).includes("Files");
 }

package/dist/hooks/use-file-drop.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-file-drop.ts"],"sourcesContent":["import { useRef, useState } from \"react\";\nimport type { DragEvent, ReactElement } from \"react\";\nimport { useFilePicker } from \"../components/file-button\";\nimport type { UseFilePickerOptions } from \"../components/file-button\";\n\n/**\n * Turn ANY element into a file drop target — kastlan's ask, for the document list of\n * a booking and the rows of its gantt, which are drop targets without being a\n * `FileDropzone` (a dashed box with a Browse button inside would be the wrong thing\n * to draw over a list).\n *\n * ```tsx\n * const { dropProps, isOver, element } = useFileDrop({ accept: \".pdf\", multiple: true,\n *   maxSize: 10_000_000, onFiles: attach, onReject: ([r]) => setError(r.message) });\n * return <>{element}<ul {...dropProps} data-drop-over={isOver || undefined}>…</ul></>;\n * ```\n *\n * The screening is `useFilePicker`'s own — `accept` re-checked (a drop ignores the\n * dialog's filter), `maxSize`, `maxFiles`, `isValid`, `onPick` — so a file refused by\n * `FileButton` is refused here in the same words. It comes with `open()` as well, so\n * the same options can also back a \"choose a file\" menu item beside the drop target.\n */\n\n/** `useFilePicker`'s options, minus `capture` (a camera does not take drops). */\nexport type UseFileDropOptions = Omit<UseFilePickerOptions, \"capture\">;\n\n/** Spread onto the drop target. Four handlers, nothing else: the element keeps its\n *  own role, name and focus behaviour. */\nexport interface FileDropProps<E extends Element = Element> {\n  onDragEnter: (e: DragEvent<E>) => void;\n  onDragOver: (e: DragEvent<E>) => void;\n  onDragLeave: (e: DragEvent<E>) => void;\n  onDrop: (e: DragEvent<E>) => void;\n}\n\nexport interface UseFileDropReturn<E extends Element = Element> {\n  dropProps: FileDropProps<E>;\n  /** A FILE drag is over the target (and it is not `disabled`). Style from this. */\n  isOver: boolean;\n  /** Open the system picker with the same options — from a click handler only. */\n  open: () => void;\n  /** Screen and deliver files that arrived another way (a paste). */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The live region that speaks a refusal (and the picker's hidden input). Render it\n   *  once, anywhere; without it a refusal reaches `onReject` but is not announced. */\n  element: ReactElement;\n}\n\n/** Whether a drag carries files — a dragged link, text or a row of the page does not,\n *  and must not light the target up or be swallowed by it. */\nexport function dragHasFiles(e: DragEvent): boolean {\n  return Array.from(e.dataTransfer?.types ?? []).includes(\"Files\");\n}\n\n/**\n * @internal The drag half on its own, shared with `FileDropzone`.\n *\n * `dragenter`/`dragleave` fire for every CHILD the pointer crosses: moving from the\n * target onto a label inside it is a leave of the target followed by an enter of the\n * label, which bubbles. A boolean flipped by each one flickers off and on across\n * every child, and `relatedTarget` — the usual fix — is `null` in Safari's drag\n * events. So this counts: +1 per enter, -1 per leave, over while above zero, and a\n * drop resets it (the drop replaces the leave that would have balanced the enter).\n *\n * A file drag stops propagating here, so a target nested in another (a row inside a\n * page-wide drop area) takes its own drop, and the outer one's count falls back to\n * zero while the pointer is over the inner one — only one of them lights up.\n */\nexport function useDragTarget<E extends Element = Element>({\n  disabled,\n  onDropFiles,\n}: {\n  disabled?: boolean;\n  onDropFiles: (files: FileList | File[]) => void;\n}): { dropProps: FileDropProps<E>; isOver: boolean } {\n  const depth = useRef(0);\n  const [over, setOver] = useState(false);\n\n  const dropProps: FileDropProps<E> = {\n    onDragEnter: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current += 1;\n      if (!disabled) setOver(true);\n    },\n    onDragOver: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      // Always cancelled for a file drag, disabled or not: an uncancelled drop makes\n      // the browser NAVIGATE to the file, which loses the page.\n      e.preventDefault();\n      e.dataTransfer.dropEffect = disabled ? \"none\" : \"copy\";\n    },\n    onDragLeave: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      depth.current = Math.max(0, depth.current - 1);\n      if (depth.current === 0) setOver(false);\n    },\n    onDrop: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current = 0;\n      setOver(false);\n      if (!disabled) onDropFiles(e.dataTransfer.files);\n    },\n  };\n\n  return { dropProps, isOver: over && !disabled };\n}\n\nexport function useFileDrop<E extends Element = Element>(\n  options: UseFileDropOptions,\n): UseFileDropReturn<E> {\n  const picker = useFilePicker(options);\n  const { dropProps, isOver } = useDragTarget<E>({\n    disabled: options.disabled,\n    onDropFiles: picker.take,\n  });\n  return { dropProps, isOver, open: picker.open, take: picker.take, element: picker.element };\n}\n"],"mappings":";AAAA,SAAS,QAAQ,gBAAgB;AAEjC,SAAS,qBAAqB;AAgDvB,SAAS,aAAa,GAAuB;AAClD,SAAO,MAAM,KAAK,EAAE,cAAc,SAAS,CAAC,CAAC,EAAE,SAAS,OAAO;AACjE;AAgBO,SAAS,cAA2C;AAAA,EACzD;AAAA,EACA;AACF,GAGqD;AACnD,QAAM,QAAQ,OAAO,CAAC;AACtB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AAEtC,QAAM,YAA8B;AAAA,IAClC,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,WAAW;AACjB,UAAI,CAAC,SAAU,SAAQ,IAAI;AAAA,IAC7B;AAAA,IACA,YAAY,CAAC,MAAM;AACjB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAGlB,QAAE,eAAe;AACjB,QAAE,aAAa,aAAa,WAAW,SAAS;AAAA,IAClD;AAAA,IACA,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,YAAM,UAAU,KAAK,IAAI,GAAG,MAAM,UAAU,CAAC;AAC7C,UAAI,MAAM,YAAY,EAAG,SAAQ,KAAK;AAAA,IACxC;AAAA,IACA,QAAQ,CAAC,MAAM;AACb,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,UAAU;AAChB,cAAQ,KAAK;AACb,UAAI,CAAC,SAAU,aAAY,EAAE,aAAa,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,QAAQ,QAAQ,CAAC,SAAS;AAChD;AAEO,SAAS,YACd,SACsB;AACtB,QAAM,SAAS,cAAc,OAAO;AACpC,QAAM,EAAE,WAAW,OAAO,IAAI,cAAiB;AAAA,IAC7C,UAAU,QAAQ;AAAA,IAClB,aAAa,OAAO;AAAA,EACtB,CAAC;AACD,SAAO,EAAE,WAAW,QAAQ,MAAM,OAAO,MAAM,MAAM,OAAO,MAAM,SAAS,OAAO,QAAQ;AAC5F;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-file-drop.ts"],"sourcesContent":["import { useRef, useState } from \"react\";\nimport type { DragEvent, ReactElement } from \"react\";\nimport { useFilePicker } from \"./use-file-picker\";\nimport type { UseFilePickerOptions } from \"./use-file-picker\";\n\n/**\n * Turn ANY element into a file drop target — kastlan's ask, for the document list of\n * a booking and the rows of its gantt, which are drop targets without being a\n * `FileDropzone` (a dashed box with a Browse button inside would be the wrong thing\n * to draw over a list).\n *\n * ```tsx\n * const { dropProps, isOver, element } = useFileDrop({ accept: \".pdf\", multiple: true,\n *   maxSize: 10_000_000, onFiles: attach, onReject: ([r]) => setError(r.message) });\n * return <>{element}<ul {...dropProps} data-drop-over={isOver || undefined}>…</ul></>;\n * ```\n *\n * The screening is `useFilePicker`'s own — `accept` re-checked (a drop ignores the\n * dialog's filter), `maxSize`, `maxFiles`, `isValid`, `onPick` — so a file refused by\n * `FileButton` is refused here in the same words. It comes with `open()` as well, so\n * the same options can also back a \"choose a file\" menu item beside the drop target.\n */\n\n/** `useFilePicker`'s options, minus `capture` (a camera does not take drops). */\nexport type UseFileDropOptions = Omit<UseFilePickerOptions, \"capture\">;\n\n/** Spread onto the drop target. Four handlers, nothing else: the element keeps its\n *  own role, name and focus behaviour. */\nexport interface FileDropProps<E extends Element = Element> {\n  onDragEnter: (e: DragEvent<E>) => void;\n  onDragOver: (e: DragEvent<E>) => void;\n  onDragLeave: (e: DragEvent<E>) => void;\n  onDrop: (e: DragEvent<E>) => void;\n}\n\nexport interface UseFileDropReturn<E extends Element = Element> {\n  dropProps: FileDropProps<E>;\n  /** A FILE drag is over the target (and it is not `disabled`). Style from this. */\n  isOver: boolean;\n  /** Open the system picker with the same options — from a click handler only. */\n  open: () => void;\n  /** Screen and deliver files that arrived another way (a paste). */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The live region that speaks a refusal (and the picker's hidden input). Render it\n   *  once, anywhere; without it a refusal reaches `onReject` but is not announced. */\n  element: ReactElement;\n}\n\n/** Whether a drag carries files — a dragged link, text or a row of the page does not,\n *  and must not light the target up or be swallowed by it. */\nexport function dragHasFiles(e: DragEvent): boolean {\n  return Array.from(e.dataTransfer?.types ?? []).includes(\"Files\");\n}\n\n/**\n * @internal The drag half on its own, shared with `FileDropzone`.\n *\n * `dragenter`/`dragleave` fire for every CHILD the pointer crosses: moving from the\n * target onto a label inside it is a leave of the target followed by an enter of the\n * label, which bubbles. A boolean flipped by each one flickers off and on across\n * every child, and `relatedTarget` — the usual fix — is `null` in Safari's drag\n * events. So this counts: +1 per enter, -1 per leave, over while above zero, and a\n * drop resets it (the drop replaces the leave that would have balanced the enter).\n *\n * A file drag stops propagating here, so a target nested in another (a row inside a\n * page-wide drop area) takes its own drop, and the outer one's count falls back to\n * zero while the pointer is over the inner one — only one of them lights up.\n */\nexport function useDragTarget<E extends Element = Element>({\n  disabled,\n  onDropFiles,\n}: {\n  disabled?: boolean;\n  onDropFiles: (files: FileList | File[]) => void;\n}): { dropProps: FileDropProps<E>; isOver: boolean } {\n  const depth = useRef(0);\n  const [over, setOver] = useState(false);\n\n  const dropProps: FileDropProps<E> = {\n    onDragEnter: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current += 1;\n      if (!disabled) setOver(true);\n    },\n    onDragOver: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      // Always cancelled for a file drag, disabled or not: an uncancelled drop makes\n      // the browser NAVIGATE to the file, which loses the page.\n      e.preventDefault();\n      e.dataTransfer.dropEffect = disabled ? \"none\" : \"copy\";\n    },\n    onDragLeave: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      depth.current = Math.max(0, depth.current - 1);\n      if (depth.current === 0) setOver(false);\n    },\n    onDrop: (e) => {\n      if (!dragHasFiles(e)) return;\n      e.stopPropagation();\n      e.preventDefault();\n      depth.current = 0;\n      setOver(false);\n      if (!disabled) onDropFiles(e.dataTransfer.files);\n    },\n  };\n\n  return { dropProps, isOver: over && !disabled };\n}\n\nexport function useFileDrop<E extends Element = Element>(\n  options: UseFileDropOptions,\n): UseFileDropReturn<E> {\n  const picker = useFilePicker(options);\n  const { dropProps, isOver } = useDragTarget<E>({\n    disabled: options.disabled,\n    onDropFiles: picker.take,\n  });\n  return { dropProps, isOver, open: picker.open, take: picker.take, element: picker.element };\n}\n"],"mappings":";AAAA,SAAS,QAAQ,gBAAgB;AAEjC,SAAS,qBAAqB;AAgDvB,SAAS,aAAa,GAAuB;AAClD,SAAO,MAAM,KAAK,EAAE,cAAc,SAAS,CAAC,CAAC,EAAE,SAAS,OAAO;AACjE;AAgBO,SAAS,cAA2C;AAAA,EACzD;AAAA,EACA;AACF,GAGqD;AACnD,QAAM,QAAQ,OAAO,CAAC;AACtB,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AAEtC,QAAM,YAA8B;AAAA,IAClC,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,WAAW;AACjB,UAAI,CAAC,SAAU,SAAQ,IAAI;AAAA,IAC7B;AAAA,IACA,YAAY,CAAC,MAAM;AACjB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAGlB,QAAE,eAAe;AACjB,QAAE,aAAa,aAAa,WAAW,SAAS;AAAA,IAClD;AAAA,IACA,aAAa,CAAC,MAAM;AAClB,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,YAAM,UAAU,KAAK,IAAI,GAAG,MAAM,UAAU,CAAC;AAC7C,UAAI,MAAM,YAAY,EAAG,SAAQ,KAAK;AAAA,IACxC;AAAA,IACA,QAAQ,CAAC,MAAM;AACb,UAAI,CAAC,aAAa,CAAC,EAAG;AACtB,QAAE,gBAAgB;AAClB,QAAE,eAAe;AACjB,YAAM,UAAU;AAChB,cAAQ,KAAK;AACb,UAAI,CAAC,SAAU,aAAY,EAAE,aAAa,KAAK;AAAA,IACjD;AAAA,EACF;AAEA,SAAO,EAAE,WAAW,QAAQ,QAAQ,CAAC,SAAS;AAChD;AAEO,SAAS,YACd,SACsB;AACtB,QAAM,SAAS,cAAc,OAAO;AACpC,QAAM,EAAE,WAAW,OAAO,IAAI,cAAiB;AAAA,IAC7C,UAAU,QAAQ;AAAA,IAClB,aAAa,OAAO;AAAA,EACtB,CAAC;AACD,SAAO,EAAE,WAAW,QAAQ,MAAM,OAAO,MAAM,MAAM,OAAO,MAAM,SAAS,OAAO,QAAQ;AAC5F;","names":[]}

package/dist/hooks/use-file-picker-labels.d.ts

@@ -0,0 +1,2 @@
+import type { FilePickerLabels } from "./use-file-picker.js";
+export declare const DEFAULT_FILE_PICKER_LABELS: FilePickerLabels;

package/dist/hooks/use-file-picker-labels.js

@@ -0,0 +1,25 @@
+"use client";
+const DEFAULT_FILE_PICKER_LABELS = {
+  rejectedType: (name) => `\u201C${name}\u201D is not a supported file type`,
+  rejectedTypeOnly: (accept) => `Only ${accept} files`,
+  rejectedSize: (name, maxSize) => `\u201C${name}\u201D is larger than ${maxSize}`,
+  rejectedCount: (name, maxFiles) => `\u201C${name}\u201D was not added: at most ${maxFiles} ${maxFiles === 1 ? "file" : "files"}`,
+  rejectedInvalid: (name) => `\u201C${name}\u201D cannot be used here`,
+  rejectedMany: (count) => `${count} files were not added`,
+  rejectedPick: (count) => count === 1 ? "The file was not added" : `None of the ${count} files were added`,
+  selected: (count, firstName) => count === 1 ? `\u201C${firstName}\u201D selected` : `${count} files selected`,
+  remove: (name) => `Remove \u201C${name}\u201D`,
+  clearAll: "Remove all files",
+  removed: (name) => `\u201C${name}\u201D removed`,
+  cleared: "All files removed",
+  dropzone: "File upload",
+  browse: "Browse",
+  empty: "Drop a file here",
+  emptyMultiple: "Drop files here",
+  hint: (accept) => accept ? `Accepted: ${accept}` : "Any file type",
+  busy: "Uploading\u2026"
+};
+export {
+  DEFAULT_FILE_PICKER_LABELS
+};
+//# sourceMappingURL=use-file-picker-labels.js.map

package/dist/hooks/use-file-picker-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-file-picker-labels.ts"],"sourcesContent":["// The English words of the file pickers (./use-file-picker), in a module with no component\n// code: the English catalogue (src/i18n/defaults.ts) imports them without the component, so\n// `en` loads as one chunk like the other languages (0.34, KS U8). In hooks/ beside the hook\n// since 0.34 (MOD-8); components/file-button re-exports them.\n\nimport type { FilePickerLabels } from \"./use-file-picker\";\n\nexport const DEFAULT_FILE_PICKER_LABELS: FilePickerLabels = {\n  rejectedType: (name) => `“${name}” is not a supported file type`,\n  rejectedTypeOnly: (accept) => `Only ${accept} files`,\n  rejectedSize: (name, maxSize) => `“${name}” is larger than ${maxSize}`,\n  rejectedCount: (name, maxFiles) =>\n    `“${name}” was not added: at most ${maxFiles} ${maxFiles === 1 ? \"file\" : \"files\"}`,\n  rejectedInvalid: (name) => `“${name}” cannot be used here`,\n  rejectedMany: (count) => `${count} files were not added`,\n  rejectedPick: (count) =>\n    count === 1 ? \"The file was not added\" : `None of the ${count} files were added`,\n  selected: (count, firstName) => (count === 1 ? `“${firstName}” selected` : `${count} files selected`),\n  remove: (name) => `Remove “${name}”`,\n  clearAll: \"Remove all files\",\n  removed: (name) => `“${name}” removed`,\n  cleared: \"All files removed\",\n  dropzone: \"File upload\",\n  browse: \"Browse\",\n  empty: \"Drop a file here\",\n  emptyMultiple: \"Drop files here\",\n  hint: (accept) => (accept ? `Accepted: ${accept}` : \"Any file type\"),\n  busy: \"Uploading…\",\n};\n"],"mappings":";AAOO,MAAM,6BAA+C;AAAA,EAC1D,cAAc,CAAC,SAAS,SAAI,IAAI;AAAA,EAChC,kBAAkB,CAAC,WAAW,QAAQ,MAAM;AAAA,EAC5C,cAAc,CAAC,MAAM,YAAY,SAAI,IAAI,yBAAoB,OAAO;AAAA,EACpE,eAAe,CAAC,MAAM,aACpB,SAAI,IAAI,iCAA4B,QAAQ,IAAI,aAAa,IAAI,SAAS,OAAO;AAAA,EACnF,iBAAiB,CAAC,SAAS,SAAI,IAAI;AAAA,EACnC,cAAc,CAAC,UAAU,GAAG,KAAK;AAAA,EACjC,cAAc,CAAC,UACb,UAAU,IAAI,2BAA2B,eAAe,KAAK;AAAA,EAC/D,UAAU,CAAC,OAAO,cAAe,UAAU,IAAI,SAAI,SAAS,oBAAe,GAAG,KAAK;AAAA,EACnF,QAAQ,CAAC,SAAS,gBAAW,IAAI;AAAA,EACjC,UAAU;AAAA,EACV,SAAS,CAAC,SAAS,SAAI,IAAI;AAAA,EAC3B,SAAS;AAAA,EACT,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,eAAe;AAAA,EACf,MAAM,CAAC,WAAY,SAAS,aAAa,MAAM,KAAK;AAAA,EACpD,MAAM;AACR;","names":[]}

package/dist/hooks/use-file-picker.d.ts

@@ -0,0 +1,164 @@
+import type { ReactElement } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+/**
+ * The file pickers' headless half: the hidden input, the screening of a pick and the
+ * announcement of a refusal, which {@link FileButton}, `FileDropzone` and {@link useFileDrop}
+ * are built on.
+ *
+ * In hooks/ since 0.34 (MOD-8, refactor audit 2026-10). It lived in
+ * components/file-button.tsx, and `useFileDrop` — a hook — imported it from there, so
+ * hooks/ reached up into components/. components/file-button re-exports all of it, so an
+ * import from there keeps working.
+ */
+/** Every string the file pickers ({@link FileButton}, `FileDropzone`) render or speak.
+ *  Messages are functions of the file name so a translation can put it anywhere. */
+export interface FilePickerLabels {
+    /** The file's type is not in `accept`, when no `accept` is known to name (see
+     *  `rejectedTypeOnly`). */
+    rejectedType: (name: string) => string;
+    /** The file's type is not in `accept`, naming what IS accepted: `accept`'s tokens,
+     *  lower-cased and joined with ", " (`".csv"` => "Only .csv files"). Used whenever
+     *  `accept` is set — kastlan kept a custom `isValid` + `invalidMessage` per form only
+     *  to say this, and `accept` already knows it. */
+    rejectedTypeOnly: (accept: string, name: string) => string;
+    /** The file is larger than `maxSize`; `maxSize` arrives formatted ("5 MB"). */
+    rejectedSize: (name: string, maxSize: string) => string;
+    /** The file was one too many for `maxFiles`. */
+    rejectedCount: (name: string, maxFiles: number) => string;
+    /** `isValid` said no and the caller gave no `invalidMessage`. */
+    rejectedInvalid: (name: string) => string;
+    /** Spoken instead of the per-file message when more than one file was refused. */
+    rejectedMany: (count: number) => string;
+    /** Spoken (and shown, on a dropzone) when `onPick` refused the WHOLE pick.
+     *  Receives the number of files in it. */
+    rejectedPick: (count: number) => string;
+    /** Spoken after a pick the component itself echoes (the dropzone). */
+    selected: (count: number, firstName: string) => string;
+    /** The dropzone's remove button for one file. */
+    remove: (name: string) => string;
+    /** The dropzone's remove-everything button in `multiple` mode. */
+    clearAll: string;
+    /** Spoken after a remove / clear, since the button that was pressed is gone. */
+    removed: (name: string) => string;
+    cleared: string;
+    /** The dropzone's accessible name, when the host passes no `dropLabel`. */
+    dropzone: string;
+    /** The dropzone's Browse button, when the host passes no `browseLabel`. */
+    browse: string;
+    /** What an empty single-file dropzone says (no `emptyLabel` given). */
+    empty: string;
+    /** …and an empty `multiple` one. */
+    emptyMultiple: string;
+    /** The dropzone's second line (no `hint` given). Receives `accept` as a person
+     *  reads it (`".pdf, image/png"`), or `""` when anything goes. */
+    hint: (accept: string) => string;
+    /** What a `busy` dropzone says in place of its body ("Uploading…"). */
+    busy: string;
+}
+export type FileRejectionReason = "type" | "size" | "count" | "invalid";
+/** One file the picker refused, and why. `message` is already translated (see
+ *  {@link FilePickerLabels}, or the caller's `invalidMessage`), so a host that just
+ *  wants to show it can render `rejections[0].message` as is. */
+export interface FileRejection {
+    file: File;
+    reason: FileRejectionReason;
+    message: string;
+}
+/**
+ * Does `file` satisfy an `accept` string, the way the browser's dialog reads it?
+ * Comma-separated tokens: `.ext` (case-insensitive suffix of the name), `type/*`
+ * (a MIME family) or an exact MIME type. An empty or absent `accept` takes anything.
+ *
+ * A file with no `type` — common for `.step`, `.dat`, anything the OS has no MIME
+ * mapping for — can only match by extension, which is why lenkbank lists `.stp` AND
+ * `model/step`: that is how `accept` has to be written for the dialog anyway.
+ */
+export declare function matchesAccept(file: File, accept: string | undefined): boolean;
+/** @internal `" .PDF, image/png ,"` => `".pdf, image/png"` — `accept` as a person reads
+ *  it. Also the dropzone's default hint. */
+export declare function formatAccept(accept: string): string;
+/** What the pickers screen a pick with. All optional; nothing set accepts everything. */
+export interface FileScreenOptions {
+    accept?: string;
+    /** Bytes. Larger files are refused with reason `"size"`. */
+    maxSize?: number;
+    /** How many files one pick may deliver. The rest are refused with reason `"count"`
+     *  — first come, first kept. For a running cap ("at most 5 attachments") pass what
+     *  is LEFT: `maxFiles={5 - attachments.length}`. */
+    maxFiles?: number;
+    /** The caller's own check, after `accept` and `maxSize`. */
+    isValid?: (file: File) => boolean;
+    /** The message for an `isValid` refusal; `labels.rejectedInvalid` otherwise. */
+    invalidMessage?: string;
+}
+/** @internal Split a pick into the files that pass and the ones that do not. */
+export declare function screenFiles(files: readonly File[], opts: FileScreenOptions, labels: FilePickerLabels, formatSize: (bytes: number) => string): {
+    accepted: File[];
+    rejected: FileRejection[];
+};
+/**
+ * Judges a pick as a whole — keksdose's "refuse the pick if any file is bad", which
+ * with `onFiles` + `onReject` alone had to be rebuilt from two calls in a microtask.
+ *
+ * Called ONCE per pick, after screening and before `onFiles` / `onReject`, with both
+ * halves (either may be empty). Return `false` to refuse the whole pick: the accepted
+ * files are not delivered, `onReject` still receives what screening refused, and one
+ * sentence (`labels.rejectedPick`) is spoken for the pick instead of a per-file one.
+ * Return nothing to let the pick through as usual.
+ *
+ * ```tsx
+ * onPick={(ok, bad) => bad.length === 0 || false}  // all or nothing
+ * ```
+ */
+export type FilePickHandler = (accepted: File[], rejected: FileRejection[]) => boolean | void;
+/** @internal The shared tail of both pickers: run `onPick`, and say whether the pick
+ *  stands. A pick with nothing accepted has nothing to refuse, so `false` there is
+ *  treated as no verdict and the usual per-file messages are kept. */
+export declare function judgePick(onPick: FilePickHandler | undefined, accepted: File[], rejected: FileRejection[]): boolean;
+/** One sentence for a whole batch of refusals: the file's own message for one, a
+ *  count for several — reading out five sentences in a row helps nobody. */
+export declare function summariseRejections(rejected: readonly FileRejection[], labels: FilePickerLabels): string;
+export interface UseFilePickerOptions extends FileScreenOptions {
+    /** Let one pick deliver several files. Without it a drop of several keeps the first. */
+    multiple?: boolean;
+    /**
+     * Ask a phone for its camera instead of the file chooser: `"environment"` is the
+     * back camera, `"user"` the front. A HINT — desktop browsers ignore it, and Chrome
+     * drops it when `multiple` is also set (a camera cannot deliver a list), which is why
+     * keksdose's camera input has no `multiple`. Pass one or the other.
+     */
+    capture?: boolean | "user" | "environment";
+    /** The files that passed, in pick order. Never called with an empty array.
+     *  Optional since 0.7 for a caller that takes the pick through `onPick` alone. */
+    onFiles?: (files: File[]) => void;
+    /** See {@link FilePickHandler}: the whole pick at once, with the power to refuse it. */
+    onPick?: FilePickHandler;
+    /** The files that did not, with a translated message each. The refusals are also
+     *  spoken through a live region, so this is for SHOWING them, not for a11y. */
+    onReject?: (rejections: FileRejection[]) => void;
+    /** `open()` and `take()` do nothing while set. */
+    disabled?: boolean;
+    /** Per-instance overrides of the `filePicker` label namespace. */
+    labels?: LabelOverride<FilePickerLabels>;
+}
+export interface UseFilePickerReturn {
+    /** Open the system picker. Call it from a click handler — browsers only open a file
+     *  dialog in response to a user gesture. */
+    open: () => void;
+    /** Screen and deliver files that arrived some other way — a drop, a paste. Honours
+     *  `multiple` (only the first file without it) and every check. */
+    take: (files: ArrayLike<File> | null | undefined) => void;
+    /** The hidden input and the live region. Render it once, anywhere — it takes no
+     *  space and needs no positioned ancestor. */
+    element: ReactElement;
+}
+/**
+ * The headless half of {@link FileButton}: a hidden file input you can open from any
+ * control, with the reset, the screening and the announcement built in.
+ *
+ * ```tsx
+ * const picker = useFilePicker({ accept: ".pdf", onFiles: ([f]) => upload(f) });
+ * return <>{picker.element}<DetailTableCard onAdd={picker.open} … /></>;
+ * ```
+ */
+export declare function useFilePicker({ accept, multiple, capture, maxSize, maxFiles, isValid, invalidMessage, onFiles, onPick, onReject, disabled, labels: labelsProp, }: UseFilePickerOptions): UseFilePickerReturn;

package/dist/hooks/use-file-picker.js

@@ -0,0 +1,149 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useRef } from "react";
+import { useAnnounce } from "./use-announce.js";
+import { useKitFileLabels, useKitLabels } from "../i18n/kit-labels.js";
+import { DEFAULT_FILE_PICKER_LABELS } from "./use-file-picker-labels.js";
+function matchesAccept(file, accept) {
+  const tokens = (accept ?? "").split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
+  if (tokens.length === 0) return true;
+  const name = file.name.toLowerCase();
+  const type = (file.type || typeFromExtension(name) || "").toLowerCase();
+  if (!type && !tokens.every((t) => t.startsWith("."))) return true;
+  return tokens.some((token) => {
+    if (token.startsWith(".")) return name.endsWith(token);
+    if (!type) return false;
+    if (token.endsWith("/*")) return type.startsWith(token.slice(0, -1));
+    return type === token;
+  });
+}
+const EXTENSION_TYPES = {
+  heic: "image/heic",
+  heif: "image/heif",
+  avif: "image/avif",
+  webp: "image/webp",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  png: "image/png",
+  gif: "image/gif",
+  pdf: "application/pdf",
+  csv: "text/csv",
+  txt: "text/plain"
+};
+function typeFromExtension(name) {
+  const dot = name.lastIndexOf(".");
+  return dot === -1 ? void 0 : EXTENSION_TYPES[name.slice(dot + 1)];
+}
+function formatAccept(accept) {
+  return accept.split(",").map((t) => t.trim().toLowerCase()).filter(Boolean).join(", ");
+}
+function screenFiles(files, opts, labels, formatSize) {
+  const accepted = [];
+  const rejected = [];
+  const acceptText = opts.accept ? formatAccept(opts.accept) : "";
+  const useOnly = acceptText !== "" && (labels.rejectedTypeOnly !== DEFAULT_FILE_PICKER_LABELS.rejectedTypeOnly || labels.rejectedType === DEFAULT_FILE_PICKER_LABELS.rejectedType);
+  const typeMessage = (name) => useOnly ? labels.rejectedTypeOnly(acceptText, name) : labels.rejectedType(name);
+  for (const file of files) {
+    let reason = null;
+    if (!matchesAccept(file, opts.accept)) reason = "type";
+    else if (opts.maxSize !== void 0 && file.size > opts.maxSize) reason = "size";
+    else if (opts.isValid && !opts.isValid(file)) reason = "invalid";
+    else if (opts.maxFiles !== void 0 && accepted.length >= opts.maxFiles) reason = "count";
+    if (reason === null) {
+      accepted.push(file);
+      continue;
+    }
+    const message = reason === "type" ? typeMessage(file.name) : reason === "size" ? labels.rejectedSize(file.name, formatSize(opts.maxSize ?? 0)) : reason === "count" ? labels.rejectedCount(file.name, Math.max(0, opts.maxFiles ?? 0)) : opts.invalidMessage ?? labels.rejectedInvalid(file.name);
+    rejected.push({ file, reason, message });
+  }
+  return { accepted, rejected };
+}
+function judgePick(onPick, accepted, rejected) {
+  if (!onPick) return true;
+  return onPick(accepted, rejected) !== false || accepted.length === 0;
+}
+function summariseRejections(rejected, labels) {
+  if (rejected.length === 0) return "";
+  if (rejected.length === 1) return rejected[0].message;
+  return labels.rejectedMany(rejected.length);
+}
+function useFilePicker({
+  accept,
+  multiple,
+  capture,
+  maxSize,
+  maxFiles,
+  isValid,
+  invalidMessage,
+  onFiles,
+  onPick,
+  onReject,
+  disabled,
+  labels: labelsProp
+}) {
+  const inputRef = useRef(null);
+  const labels = useKitLabels("filePicker", DEFAULT_FILE_PICKER_LABELS, labelsProp);
+  const fileText = useKitFileLabels();
+  const { announce, regionProps } = useAnnounce({ politeness: "assertive" });
+  const take = (list) => {
+    if (disabled || !list || list.length === 0) return;
+    const all = Array.from(list);
+    const files = multiple ? all : all.slice(0, 1);
+    const { accepted, rejected } = screenFiles(
+      files,
+      // A single-file picker holds one file by definition; `maxFiles` is a multi-mode
+      // cap and would only ever say "0" there if a caller passed it by mistake.
+      { accept, maxSize, maxFiles: multiple ? maxFiles : void 0, isValid, invalidMessage },
+      labels,
+      fileText.size
+    );
+    if (!judgePick(onPick, accepted, rejected)) {
+      if (rejected.length > 0) onReject?.(rejected);
+      announce(labels.rejectedPick(files.length));
+      return;
+    }
+    if (accepted.length > 0) onFiles?.(accepted);
+    if (rejected.length > 0) {
+      onReject?.(rejected);
+      announce(summariseRejections(rejected, labels));
+    }
+  };
+  const element = /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref: inputRef,
+        type: "file",
+        accept,
+        multiple,
+        capture,
+        disabled,
+        className: "hidden",
+        tabIndex: -1,
+        "aria-hidden": true,
+        onChange: (e) => {
+          const picked = Array.from(e.currentTarget.files ?? []);
+          e.currentTarget.value = "";
+          take(picked);
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx("span", { ...regionProps })
+  ] });
+  return {
+    open: () => {
+      if (!disabled) inputRef.current?.click();
+    },
+    take,
+    element
+  };
+}
+export {
+  formatAccept,
+  judgePick,
+  matchesAccept,
+  screenFiles,
+  summariseRejections,
+  useFilePicker
+};
+//# sourceMappingURL=use-file-picker.js.map

package/dist/hooks/use-file-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-file-picker.tsx"],"sourcesContent":["import { useRef } from \"react\";\nimport type { ReactElement } from \"react\";\nimport { useAnnounce } from \"./use-announce\";\nimport { useKitFileLabels, useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_FILE_PICKER_LABELS } from \"./use-file-picker-labels\";\n\n/**\n * The file pickers' headless half: the hidden input, the screening of a pick and the\n * announcement of a refusal, which {@link FileButton}, `FileDropzone` and {@link useFileDrop}\n * are built on.\n *\n * In hooks/ since 0.34 (MOD-8, refactor audit 2026-10). It lived in\n * components/file-button.tsx, and `useFileDrop` — a hook — imported it from there, so\n * hooks/ reached up into components/. components/file-button re-exports all of it, so an\n * import from there keeps working.\n */\n\n/* ── Labels ──────────────────────────────────────────────────────────────── */\n\n/** Every string the file pickers ({@link FileButton}, `FileDropzone`) render or speak.\n *  Messages are functions of the file name so a translation can put it anywhere. */\nexport interface FilePickerLabels {\n  /** The file's type is not in `accept`, when no `accept` is known to name (see\n   *  `rejectedTypeOnly`). */\n  rejectedType: (name: string) => string;\n  /** The file's type is not in `accept`, naming what IS accepted: `accept`'s tokens,\n   *  lower-cased and joined with \", \" (`\".csv\"` => \"Only .csv files\"). Used whenever\n   *  `accept` is set — kastlan kept a custom `isValid` + `invalidMessage` per form only\n   *  to say this, and `accept` already knows it. */\n  rejectedTypeOnly: (accept: string, name: string) => string;\n  /** The file is larger than `maxSize`; `maxSize` arrives formatted (\"5 MB\"). */\n  rejectedSize: (name: string, maxSize: string) => string;\n  /** The file was one too many for `maxFiles`. */\n  rejectedCount: (name: string, maxFiles: number) => string;\n  /** `isValid` said no and the caller gave no `invalidMessage`. */\n  rejectedInvalid: (name: string) => string;\n  /** Spoken instead of the per-file message when more than one file was refused. */\n  rejectedMany: (count: number) => string;\n  /** Spoken (and shown, on a dropzone) when `onPick` refused the WHOLE pick.\n   *  Receives the number of files in it. */\n  rejectedPick: (count: number) => string;\n  /** Spoken after a pick the component itself echoes (the dropzone). */\n  selected: (count: number, firstName: string) => string;\n  /** The dropzone's remove button for one file. */\n  remove: (name: string) => string;\n  /** The dropzone's remove-everything button in `multiple` mode. */\n  clearAll: string;\n  /** Spoken after a remove / clear, since the button that was pressed is gone. */\n  removed: (name: string) => string;\n  cleared: string;\n  /** The dropzone's accessible name, when the host passes no `dropLabel`. */\n  dropzone: string;\n  /** The dropzone's Browse button, when the host passes no `browseLabel`. */\n  browse: string;\n  /** What an empty single-file dropzone says (no `emptyLabel` given). */\n  empty: string;\n  /** …and an empty `multiple` one. */\n  emptyMultiple: string;\n  /** The dropzone's second line (no `hint` given). Receives `accept` as a person\n   *  reads it (`\".pdf, image/png\"`), or `\"\"` when anything goes. */\n  hint: (accept: string) => string;\n  /** What a `busy` dropzone says in place of its body (\"Uploading…\"). */\n  busy: string;\n}\n\n/* ── Screening ───────────────────────────────────────────────────────────── */\n\nexport type FileRejectionReason = \"type\" | \"size\" | \"count\" | \"invalid\";\n\n/** One file the picker refused, and why. `message` is already translated (see\n *  {@link FilePickerLabels}, or the caller's `invalidMessage`), so a host that just\n *  wants to show it can render `rejections[0].message` as is. */\nexport interface FileRejection {\n  file: File;\n  reason: FileRejectionReason;\n  message: string;\n}\n\n/**\n * Does `file` satisfy an `accept` string, the way the browser's dialog reads it?\n * Comma-separated tokens: `.ext` (case-insensitive suffix of the name), `type/*`\n * (a MIME family) or an exact MIME type. An empty or absent `accept` takes anything.\n *\n * A file with no `type` — common for `.step`, `.dat`, anything the OS has no MIME\n * mapping for — can only match by extension, which is why lenkbank lists `.stp` AND\n * `model/step`: that is how `accept` has to be written for the dialog anyway.\n */\nexport function matchesAccept(file: File, accept: string | undefined): boolean {\n  const tokens = (accept ?? \"\")\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean);\n  if (tokens.length === 0) return true;\n  const name = file.name.toLowerCase();\n  // An EMPTY type is the browser saying \"I don't know\", not \"it's something else\": HEIC\n  // photos on Windows without the codec arrive with `type === \"\"`. Refusing them\n  // (0.6.0) refused iPhone photos the picker itself had just offered (keksdose). So a\n  // missing type is inferred from the extension where that is unambiguous, and a file\n  // whose type cannot be known at all is given the benefit of the doubt — nothing here\n  // proves it does not match, and the server validates what it receives anyway.\n  const type = (file.type || typeFromExtension(name) || \"\").toLowerCase();\n  if (!type && !tokens.every((t) => t.startsWith(\".\"))) return true;\n  return tokens.some((token) => {\n    if (token.startsWith(\".\")) return name.endsWith(token);\n    if (!type) return false;\n    if (token.endsWith(\"/*\")) return type.startsWith(token.slice(0, -1));\n    return type === token;\n  });\n}\n\n/** MIME types for the extensions a browser most often leaves untyped. */\nconst EXTENSION_TYPES: Record<string, string> = {\n  heic: \"image/heic\",\n  heif: \"image/heif\",\n  avif: \"image/avif\",\n  webp: \"image/webp\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  gif: \"image/gif\",\n  pdf: \"application/pdf\",\n  csv: \"text/csv\",\n  txt: \"text/plain\",\n};\n\nfunction typeFromExtension(name: string): string | undefined {\n  const dot = name.lastIndexOf(\".\");\n  return dot === -1 ? undefined : EXTENSION_TYPES[name.slice(dot + 1)];\n}\n\n/** @internal `\" .PDF, image/png ,\"` => `\".pdf, image/png\"` — `accept` as a person reads\n *  it. Also the dropzone's default hint. */\nexport function formatAccept(accept: string): string {\n  return accept\n    .split(\",\")\n    .map((t) => t.trim().toLowerCase())\n    .filter(Boolean)\n    .join(\", \");\n}\n\n/** What the pickers screen a pick with. All optional; nothing set accepts everything. */\nexport interface FileScreenOptions {\n  accept?: string;\n  /** Bytes. Larger files are refused with reason `\"size\"`. */\n  maxSize?: number;\n  /** How many files one pick may deliver. The rest are refused with reason `\"count\"`\n   *  — first come, first kept. For a running cap (\"at most 5 attachments\") pass what\n   *  is LEFT: `maxFiles={5 - attachments.length}`. */\n  maxFiles?: number;\n  /** The caller's own check, after `accept` and `maxSize`. */\n  isValid?: (file: File) => boolean;\n  /** The message for an `isValid` refusal; `labels.rejectedInvalid` otherwise. */\n  invalidMessage?: string;\n}\n\n/** @internal Split a pick into the files that pass and the ones that do not. */\nexport function screenFiles(\n  files: readonly File[],\n  opts: FileScreenOptions,\n  labels: FilePickerLabels,\n  formatSize: (bytes: number) => string,\n): { accepted: File[]; rejected: FileRejection[] } {\n  const accepted: File[] = [];\n  const rejected: FileRejection[] = [];\n  // Name what `accept` takes (\"Only .csv files\") — unless the host translated\n  // `rejectedType` but not yet `rejectedTypeOnly`: its own sentence beats an English one.\n  const acceptText = opts.accept ? formatAccept(opts.accept) : \"\";\n  const useOnly =\n    acceptText !== \"\" &&\n    (labels.rejectedTypeOnly !== DEFAULT_FILE_PICKER_LABELS.rejectedTypeOnly ||\n      labels.rejectedType === DEFAULT_FILE_PICKER_LABELS.rejectedType);\n  const typeMessage = (name: string) =>\n    useOnly ? labels.rejectedTypeOnly(acceptText, name) : labels.rejectedType(name);\n  for (const file of files) {\n    let reason: FileRejectionReason | null = null;\n    if (!matchesAccept(file, opts.accept)) reason = \"type\";\n    else if (opts.maxSize !== undefined && file.size > opts.maxSize) reason = \"size\";\n    else if (opts.isValid && !opts.isValid(file)) reason = \"invalid\";\n    // Count last, and only against files that passed everything else: a refused\n    // file should not use up one of the slots a good one could have had.\n    else if (opts.maxFiles !== undefined && accepted.length >= opts.maxFiles) reason = \"count\";\n    if (reason === null) {\n      accepted.push(file);\n      continue;\n    }\n    const message =\n      reason === \"type\"\n        ? typeMessage(file.name)\n        : reason === \"size\"\n          ? labels.rejectedSize(file.name, formatSize(opts.maxSize ?? 0))\n          : reason === \"count\"\n            ? labels.rejectedCount(file.name, Math.max(0, opts.maxFiles ?? 0))\n            : (opts.invalidMessage ?? labels.rejectedInvalid(file.name));\n    rejected.push({ file, reason, message });\n  }\n  return { accepted, rejected };\n}\n\n/**\n * Judges a pick as a whole — keksdose's \"refuse the pick if any file is bad\", which\n * with `onFiles` + `onReject` alone had to be rebuilt from two calls in a microtask.\n *\n * Called ONCE per pick, after screening and before `onFiles` / `onReject`, with both\n * halves (either may be empty). Return `false` to refuse the whole pick: the accepted\n * files are not delivered, `onReject` still receives what screening refused, and one\n * sentence (`labels.rejectedPick`) is spoken for the pick instead of a per-file one.\n * Return nothing to let the pick through as usual.\n *\n * ```tsx\n * onPick={(ok, bad) => bad.length === 0 || false}  // all or nothing\n * ```\n */\nexport type FilePickHandler = (accepted: File[], rejected: FileRejection[]) => boolean | void;\n\n/** @internal The shared tail of both pickers: run `onPick`, and say whether the pick\n *  stands. A pick with nothing accepted has nothing to refuse, so `false` there is\n *  treated as no verdict and the usual per-file messages are kept. */\nexport function judgePick(\n  onPick: FilePickHandler | undefined,\n  accepted: File[],\n  rejected: FileRejection[],\n): boolean {\n  if (!onPick) return true;\n  return onPick(accepted, rejected) !== false || accepted.length === 0;\n}\n\n/** One sentence for a whole batch of refusals: the file's own message for one, a\n *  count for several — reading out five sentences in a row helps nobody. */\nexport function summariseRejections(rejected: readonly FileRejection[], labels: FilePickerLabels): string {\n  if (rejected.length === 0) return \"\";\n  if (rejected.length === 1) return rejected[0].message;\n  return labels.rejectedMany(rejected.length);\n}\n\n/* ── useFilePicker ───────────────────────────────────────────────────────── */\n\nexport interface UseFilePickerOptions extends FileScreenOptions {\n  /** Let one pick deliver several files. Without it a drop of several keeps the first. */\n  multiple?: boolean;\n  /**\n   * Ask a phone for its camera instead of the file chooser: `\"environment\"` is the\n   * back camera, `\"user\"` the front. A HINT — desktop browsers ignore it, and Chrome\n   * drops it when `multiple` is also set (a camera cannot deliver a list), which is why\n   * keksdose's camera input has no `multiple`. Pass one or the other.\n   */\n  capture?: boolean | \"user\" | \"environment\";\n  /** The files that passed, in pick order. Never called with an empty array.\n   *  Optional since 0.7 for a caller that takes the pick through `onPick` alone. */\n  onFiles?: (files: File[]) => void;\n  /** See {@link FilePickHandler}: the whole pick at once, with the power to refuse it. */\n  onPick?: FilePickHandler;\n  /** The files that did not, with a translated message each. The refusals are also\n   *  spoken through a live region, so this is for SHOWING them, not for a11y. */\n  onReject?: (rejections: FileRejection[]) => void;\n  /** `open()` and `take()` do nothing while set. */\n  disabled?: boolean;\n  /** Per-instance overrides of the `filePicker` label namespace. */\n  labels?: LabelOverride<FilePickerLabels>;\n}\n\nexport interface UseFilePickerReturn {\n  /** Open the system picker. Call it from a click handler — browsers only open a file\n   *  dialog in response to a user gesture. */\n  open: () => void;\n  /** Screen and deliver files that arrived some other way — a drop, a paste. Honours\n   *  `multiple` (only the first file without it) and every check. */\n  take: (files: ArrayLike<File> | null | undefined) => void;\n  /** The hidden input and the live region. Render it once, anywhere — it takes no\n   *  space and needs no positioned ancestor. */\n  element: ReactElement;\n}\n\n/**\n * The headless half of {@link FileButton}: a hidden file input you can open from any\n * control, with the reset, the screening and the announcement built in.\n *\n * ```tsx\n * const picker = useFilePicker({ accept: \".pdf\", onFiles: ([f]) => upload(f) });\n * return <>{picker.element}<DetailTableCard onAdd={picker.open} … /></>;\n * ```\n */\nexport function useFilePicker({\n  accept,\n  multiple,\n  capture,\n  maxSize,\n  maxFiles,\n  isValid,\n  invalidMessage,\n  onFiles,\n  onPick,\n  onReject,\n  disabled,\n  labels: labelsProp,\n}: UseFilePickerOptions): UseFilePickerReturn {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const labels = useKitLabels(\"filePicker\", DEFAULT_FILE_PICKER_LABELS, labelsProp);\n  const fileText = useKitFileLabels();\n  // Assertive: a refusal is a failure the user has to hear before they move on, and\n  // it is the only thing this region ever says.\n  const { announce, regionProps } = useAnnounce({ politeness: \"assertive\" });\n\n  const take = (list: ArrayLike<File> | null | undefined) => {\n    if (disabled || !list || list.length === 0) return;\n    const all = Array.from(list);\n    const files = multiple ? all : all.slice(0, 1);\n    const { accepted, rejected } = screenFiles(\n      files,\n      // A single-file picker holds one file by definition; `maxFiles` is a multi-mode\n      // cap and would only ever say \"0\" there if a caller passed it by mistake.\n      { accept, maxSize, maxFiles: multiple ? maxFiles : undefined, isValid, invalidMessage },\n      labels,\n      fileText.size,\n    );\n    if (!judgePick(onPick, accepted, rejected)) {\n      if (rejected.length > 0) onReject?.(rejected);\n      announce(labels.rejectedPick(files.length));\n      return;\n    }\n    if (accepted.length > 0) onFiles?.(accepted);\n    if (rejected.length > 0) {\n      onReject?.(rejected);\n      announce(summariseRejections(rejected, labels));\n    }\n  };\n\n  const element = (\n    <>\n      <input\n        ref={inputRef}\n        type=\"file\"\n        accept={accept}\n        multiple={multiple}\n        capture={capture}\n        disabled={disabled}\n        // `hidden` (display: none), not `sr-only`: the control a user reaches is the\n        // button, and a second, nameless tab stop for the same action is noise. A\n        // display:none file input still opens on `.click()` in every current browser —\n        // and, unlike `sr-only`, it cannot escape to the initial containing block and\n        // stretch the page (see the note in `file-dropzone.tsx`).\n        className=\"hidden\"\n        tabIndex={-1}\n        aria-hidden\n        onChange={(e) => {\n          // Copy BEFORE the reset: `files` is a live view of the input's value, and\n          // clearing the value empties it.\n          const picked = Array.from(e.currentTarget.files ?? []);\n          e.currentTarget.value = \"\";\n          take(picked);\n        }}\n      />\n      <span {...regionProps} />\n    </>\n  );\n\n  return {\n    open: () => {\n      if (!disabled) inputRef.current?.click();\n    },\n    take,\n    element,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/use-focus-trap.d.ts

@@ -1,4 +1,4 @@
-interface FocusTrapOptions {
+export interface FocusTrapOptions {
     /** Trap only while this is true. Mount-time `true` is the common case. */
     active?: boolean;
     /** Return focus to whatever had it before the trap engaged. Default `true`. */
@@ -19,6 +19,4 @@ interface FocusTrapOptions {
      */
     initialFocus?: "container" | "first" | (() => HTMLElement | null);
 }
-declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, { active, restoreFocus, initialFocus }?: FocusTrapOptions): void;
-
-export { type FocusTrapOptions, useFocusTrap };
+export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, { active, restoreFocus, initialFocus }?: FocusTrapOptions): void;

package/dist/hooks/use-focus-trap.js

@@ -1,6 +1,7 @@
 "use client";
 import { useEffect, useLayoutEffect, useRef, useState } from "react";
 const FOCUSABLE = 'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
+const isTabStop = (el) => el.tabIndex >= 0 && !el.closest("[hidden],[inert]");
 const TRAP_ATTR = "data-focus-trap";
 function focusedElement() {
   return typeof document === "undefined" ? null : document.activeElement;
@@ -27,7 +28,7 @@ function useFocusTrap(containerRef, { active = true, restoreFocus = true, initia
       // A tabbable inside a NESTED open overlay belongs to that overlay's trap, not
       // to this one — otherwise the outer list spans both panels and Tab from the
       // inner panel's last control wraps to the OUTER panel's first.
-      (el) => !inNestedTrap(el)
+      (el) => isTabStop(el) && !inNestedTrap(el)
     );
     const { initialFocus: how } = optsRef.current;
     const focused = document.activeElement;