@jini-ai/ui 0.1.0

package/dist/features/file-dropzone/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/file-dropzone/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,uCAAuC,EACvC,6CAA6C,EAC7C,wCAAwC,GACzC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/features/file-dropzone/react/components/FileDropzone.d.ts

@@ -0,0 +1,55 @@
+import { useFileDropzone } from '../hooks/useFileDropzone.js';
+import { useFileDropzonePreviews } from '../hooks/useFileDropzonePreviews.js';
+export interface FileDropzoneSecondaryAction {
+    label: string;
+    onClick: () => void;
+}
+export interface FileDropzoneProps {
+    /** Heading above the zone (e.g. `"Local code"`). Omit for a bare zone with no heading. */
+    label?: string;
+    /** Prompt shown inside the zone. Defaults to a generic drag/drop/browse prompt (varying on `enablePaste`). */
+    prompt?: string;
+    /** Helper text under the zone. */
+    helper?: string;
+    /** Native file input `accept` attribute. */
+    accept?: string;
+    /** Enables directory selection (`webkitdirectory`) on the native input, and folder-aware drag/drop (folders are always expanded on drop regardless of this flag — it only controls whether the native file-picker itself offers folder selection). */
+    directory?: boolean;
+    /** Enables a page-wide clipboard-paste listener that stages pasted files directly. */
+    enablePaste?: boolean;
+    /** Staged files for the kind-aware thumbnail-grid + lightbox variant. */
+    files?: File[];
+    /** Remove one staged file (thumbnail-grid variant). Omit to render the grid without remove tiles. */
+    onRemove?: (file: File) => void;
+    /** Staged names for the simple labeled variant (no `File` objects retained). */
+    names?: string[];
+    /** Remove one staged name (simple variant). Names render as plain zone text instead of a removable chip list when this is omitted. */
+    onRemoveName?: (name: string) => void;
+    /** Resolved files ready to stage — always the fully directory-expanded flat list, regardless of drag/click/paste origin. */
+    onFiles: (files: File[]) => void;
+    /** Fires on a native click on the zone. Drag/drop and paste don't trigger it. */
+    onZoneClick?: () => void;
+    /** Surfaces a read error (e.g. a dropped folder failed to enumerate), or clears it (`null`). */
+    onError?: (message: string | null) => void;
+    /** Wraps staging of a large selection so a host can show a loading affordance while it resolves — see `react/hooks/useFileDropzone.ts`. */
+    onProcessingStart?: () => () => void;
+    /** External browse-folder trigger (e.g. a desktop-host native folder picker), rendered as a button beside the zone. */
+    onBrowseFolder?: () => void;
+    /** A host-injected secondary affordance rendered below the zone (e.g. "Select from library"). Renders only when supplied — replaces the origin's product-specific feature-flag gate with plain prop presence. */
+    secondaryAction?: FileDropzoneSecondaryAction;
+    /** Custom hook overrides for dependency injection / testing. */
+    useFileDropzone?: typeof useFileDropzone;
+    useFileDropzonePreviews?: typeof useFileDropzonePreviews;
+}
+/**
+ * Consolidates two independent OD file-staging zones into one
+ * primitive: `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
+ * grid with click-to-enlarge preview over staged `File[]`) and
+ * `DesignSystemFlow.tsx`'s `DropZone` (a labeled, prompt-driven zone with a
+ * file-dialog cancel-vs-still-loading detection heuristic and a plain
+ * staged-names list). Both are the same underlying interaction — native
+ * drag/drop + click-to-browse resolving to a flat `File[]` — configured
+ * differently; see `packages/ui/source-map.md` for the full writeup.
+ */
+export declare function FileDropzone({ label, prompt, helper, accept, directory, enablePaste, files, onRemove, names, onRemoveName, onFiles, onZoneClick, onError, onProcessingStart, onBrowseFolder, secondaryAction, useFileDropzone: useFileDropzoneHook, useFileDropzonePreviews: useFileDropzonePreviewsHook, }: FileDropzoneProps): import("react").JSX.Element;
+//# sourceMappingURL=FileDropzone.d.ts.map

package/dist/features/file-dropzone/react/components/FileDropzone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzone.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzone.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAK9E,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAUD,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8GAA8G;IAC9G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sPAAsP;IACtP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,yEAAyE;IACzE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,qGAAqG;IACrG,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAEhC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sIAAsI;IACtI,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,4HAA4H;IAC5H,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACjC,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,gGAAgG;IAChG,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,2IAA2I;IAC3I,iBAAiB,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IAErC,uHAAuH;IACvH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,iNAAiN;IACjN,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,eAAe,CAAC;IACzC,uBAAuB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAiB,EACjB,WAAmB,EACnB,KAAK,EACL,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,OAAO,EACP,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EAAE,mBAAqC,EACtD,uBAAuB,EAAE,2BAAqD,GAC/E,EAAE,iBAAiB,+BAyGnB"}

package/dist/features/file-dropzone/react/components/FileDropzone.js

@@ -0,0 +1,61 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Icon } from '../../../../react/components/Icon.js';
+import { useGlobalKeydown } from '../../../../browser/useGlobalKeydown.js';
+import { useT } from '../../../i18n/index.js';
+import { useFileDropzone } from '../hooks/useFileDropzone.js';
+import { useFileDropzonePreviews } from '../hooks/useFileDropzonePreviews.js';
+import { FileDropzoneThumbnailGrid } from './FileDropzoneThumbnailGrid.js';
+import { FileDropzoneLightbox } from './FileDropzoneLightbox.js';
+import { FileDropzoneNameList } from './FileDropzoneNameList.js';
+// Stable identity for the "no files" case — `files ?? []` would otherwise
+// allocate a fresh array every render, and `useFileDropzonePreviews` keys its
+// effects on `files` by reference: a fresh array every render re-triggers
+// those effects, whose own `setState` calls (a new, also-fresh `Map` each
+// time) re-render this component, recreating the fallback array again — an
+// infinite render loop whenever `files` is omitted entirely.
+const NO_FILES = [];
+/**
+ * Consolidates two independent OD file-staging zones into one
+ * primitive: `DesignSystemAssetDropzone.tsx` (a rich, kind-aware thumbnail
+ * grid with click-to-enlarge preview over staged `File[]`) and
+ * `DesignSystemFlow.tsx`'s `DropZone` (a labeled, prompt-driven zone with a
+ * file-dialog cancel-vs-still-loading detection heuristic and a plain
+ * staged-names list). Both are the same underlying interaction — native
+ * drag/drop + click-to-browse resolving to a flat `File[]` — configured
+ * differently; see `packages/ui/source-map.md` for the full writeup.
+ */
+export function FileDropzone({ label, prompt, helper, accept, directory = false, enablePaste = false, files, onRemove, names, onRemoveName, onFiles, onZoneClick, onError, onProcessingStart, onBrowseFolder, secondaryAction, useFileDropzone: useFileDropzoneHook = useFileDropzone, useFileDropzonePreviews: useFileDropzonePreviewsHook = useFileDropzonePreviews, }) {
+    const t = useT();
+    const [lightboxFile, setLightboxFile] = useState(null);
+    const dropzone = useFileDropzoneHook({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste });
+    const previews = useFileDropzonePreviewsHook(files ?? NO_FILES);
+    useGlobalKeydown((event) => {
+        if (event.key === 'Escape')
+            setLightboxFile(null);
+    }, { enabled: lightboxFile !== null });
+    function onZoneKeyDown(event) {
+        if (event.key === 'Enter' || event.key === ' ') {
+            event.preventDefault();
+            dropzone.openPicker();
+        }
+    }
+    const defaultPrompt = enablePaste ? t('Drag & drop, paste, or browse') : t('Drag & drop or browse');
+    const promptText = prompt ? t(prompt) : defaultPrompt;
+    const isSimpleVariant = names !== undefined;
+    const showNamesInZone = !!names && names.length > 0 && !onRemoveName;
+    const zoneText = showNamesInZone ? names.join(', ') : promptText;
+    const directoryInputProps = directory ? { webkitdirectory: '', directory: '' } : {};
+    return (_jsxs("div", { className: "jini-file-dropzone", children: [label ? _jsx("strong", { className: "jini-file-dropzone__label", children: t(label) }) : null, _jsxs("div", { className: "jini-file-dropzone__wrap", children: [_jsxs("div", { className: `jini-file-dropzone__zone${dropzone.dragOver ? ' is-drag-over' : ''}`, role: "button", tabIndex: 0, "aria-label": t('Add files — drag and drop{paste}, or click to browse', {
+                            paste: enablePaste ? t(', paste') : '',
+                        }), "data-testid": "file-dropzone-zone", onClick: dropzone.openPicker, onKeyDown: onZoneKeyDown, onDragEnter: dropzone.onZoneDragEnter, onDragOver: dropzone.onZoneDragOver, onDragLeave: dropzone.onZoneDragLeave, onDrop: dropzone.onZoneDrop, children: [_jsx("input", { ref: dropzone.inputRef, type: "file", multiple: true, accept: accept, className: "jini-file-dropzone__input", onClick: (event) => {
+                                    // The input is nested inside the zone div so a real user
+                                    // click on it (e.g. via `openPicker`'s own `input.click()`
+                                    // call) would otherwise bubble straight back into the zone's
+                                    // own `onClick={dropzone.openPicker}`, re-triggering it and
+                                    // opening the file dialog a second time.
+                                    event.stopPropagation();
+                                    dropzone.onInputClick();
+                                }, onChange: dropzone.onInputChange, ...directoryInputProps }), _jsx("span", { className: "jini-file-dropzone__icon", children: _jsx(Icon, { name: "upload", size: 19 }) }), _jsx("span", { className: "jini-file-dropzone__prompt", children: zoneText }), !isSimpleVariant && helper ? _jsx("span", { className: "jini-file-dropzone__hint", children: t(helper) }) : null] }), onBrowseFolder ? (_jsx("button", { type: "button", className: "jini-file-dropzone__browse-folder", onClick: onBrowseFolder, children: t('Browse folder') })) : null] }), secondaryAction ? (_jsx("div", { className: "jini-file-dropzone__secondary", children: _jsx("button", { type: "button", className: "jini-file-dropzone__secondary-action", onClick: secondaryAction.onClick, children: t(secondaryAction.label) }) })) : null, names && names.length > 0 && onRemoveName ? (_jsx(FileDropzoneNameList, { names: names, onRemoveName: onRemoveName, ariaLabel: label ? t('{label} selections', { label: t(label) }) : t('Selections') })) : null, files && files.length > 0 ? (_jsx(FileDropzoneThumbnailGrid, { files: files, previews: previews, onSelect: setLightboxFile, onRemove: onRemove })) : null, isSimpleVariant && helper ? _jsx("p", { className: "jini-file-dropzone__helper", children: t(helper) }) : null, lightboxFile ? (_jsx(FileDropzoneLightbox, { file: lightboxFile, previews: previews, onClose: () => setLightboxFile(null) })) : null] }));
+}
+//# sourceMappingURL=FileDropzone.js.map

package/dist/features/file-dropzone/react/components/FileDropzone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzone.js","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzone.tsx"],"names":[],"mappings":"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"}

package/dist/features/file-dropzone/react/components/FileDropzoneLightbox.d.ts

@@ -0,0 +1,9 @@
+import type { FileDropzonePreviewState } from '../../types.js';
+export interface FileDropzoneLightboxProps {
+    file: File;
+    previews: FileDropzonePreviewState;
+    onClose: () => void;
+}
+/** Click-to-enlarge, kind-aware preview for one staged file — image, PDF embed, HTML mini-render, video/audio player, font specimen, or a text snippet, with a name/size fallback card for everything else. Portaled to `document.body`. Ported from `DesignSystemAssetDropzone.tsx`'s lightbox. */
+export declare function FileDropzoneLightbox({ file, previews, onClose }: FileDropzoneLightboxProps): import("react").ReactPortal;
+//# sourceMappingURL=FileDropzoneLightbox.d.ts.map

package/dist/features/file-dropzone/react/components/FileDropzoneLightbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneLightbox.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneLightbox.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAoB,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,wBAAwB,CAAC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAqED,oSAAoS;AACpS,wBAAgB,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,yBAAyB,+BAiC1F"}

package/dist/features/file-dropzone/react/components/FileDropzoneLightbox.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createPortal } from 'react-dom';
+import { Icon } from '../../../../react/components/Icon.js';
+import { useT } from '../../../i18n/index.js';
+import { FILE_DROPZONE_FONT_PANGRAM, FILE_DROPZONE_FONT_SPECIMEN, FILE_DROPZONE_GLYPH_ICON } from '../../constants.js';
+import { fileDropzoneExtensionLabel, fileDropzoneKind, fileDropzoneSizeLabel } from '../../rules.js';
+function renderStage(t, file, kind, previews) {
+    const url = previews.previewUrls.get(file);
+    if (kind === 'image' && url) {
+        return _jsx("img", { src: url, alt: file.name, className: "jini-file-dropzone__lightbox-img" });
+    }
+    if (kind === 'video' && url) {
+        return _jsx("video", { src: url, className: "jini-file-dropzone__lightbox-video", controls: true, autoPlay: true, playsInline: true });
+    }
+    if (kind === 'audio' && url) {
+        return (_jsxs("div", { className: "jini-file-dropzone__lightbox-audio", children: [_jsx("span", { className: "jini-file-dropzone__lightbox-audio-icon", children: _jsx(Icon, { name: "volume", size: 34 }) }), _jsx("audio", { src: url, controls: true, className: "jini-file-dropzone__lightbox-audio-player" })] }));
+    }
+    if (kind === 'pdf' && url) {
+        return _jsx("iframe", { src: url, className: "jini-file-dropzone__lightbox-frame", title: file.name });
+    }
+    if (kind === 'html' && url) {
+        return (_jsx("iframe", { src: url, className: "jini-file-dropzone__lightbox-frame", title: file.name, sandbox: "allow-scripts allow-popups" }));
+    }
+    if (kind === 'font') {
+        const family = previews.fontFamilies.get(file);
+        if (family) {
+            return (_jsxs("div", { className: "jini-file-dropzone__lightbox-font", style: { fontFamily: `'${family}'` }, children: [_jsxs("div", { className: "jini-file-dropzone__lightbox-font-hero", children: [FILE_DROPZONE_FONT_SPECIMEN, "Bb Cc"] }), _jsx("div", { className: "jini-file-dropzone__lightbox-font-pangram", children: FILE_DROPZONE_FONT_PANGRAM }), _jsxs("div", { className: "jini-file-dropzone__lightbox-font-scale", children: [_jsx("span", { style: { fontSize: 13 }, children: FILE_DROPZONE_FONT_PANGRAM }), _jsx("span", { style: { fontSize: 18 }, children: FILE_DROPZONE_FONT_PANGRAM }), _jsx("span", { style: { fontSize: 26 }, children: FILE_DROPZONE_FONT_PANGRAM })] })] }));
+        }
+    }
+    if (kind === 'text') {
+        const snippet = previews.textSnippets.get(file);
+        if (snippet != null) {
+            return _jsx("pre", { className: "jini-file-dropzone__lightbox-text", children: snippet || t('(empty file)') });
+        }
+    }
+    return (_jsxs("div", { className: "jini-file-dropzone__lightbox-fallback", children: [_jsx("span", { className: "jini-file-dropzone__lightbox-fallback-glyph", "data-kind": kind, children: _jsx(Icon, { name: FILE_DROPZONE_GLYPH_ICON[kind], size: 40 }) }), _jsx("p", { className: "jini-file-dropzone__lightbox-fallback-name", children: file.name }), _jsxs("p", { className: "jini-file-dropzone__lightbox-fallback-meta", children: [fileDropzoneExtensionLabel(file), " \u00B7 ", fileDropzoneSizeLabel(file.size) || '—'] }), _jsx("p", { className: "jini-file-dropzone__lightbox-fallback-hint", children: t('No inline preview for this file type.') })] }));
+}
+/** Click-to-enlarge, kind-aware preview for one staged file — image, PDF embed, HTML mini-render, video/audio player, font specimen, or a text snippet, with a name/size fallback card for everything else. Portaled to `document.body`. Ported from `DesignSystemAssetDropzone.tsx`'s lightbox. */
+export function FileDropzoneLightbox({ file, previews, onClose }) {
+    const t = useT();
+    const kind = fileDropzoneKind(file);
+    return createPortal(_jsx("div", { className: "jini-file-dropzone__lightbox", onClick: onClose, role: "presentation", children: _jsxs("div", { className: "jini-file-dropzone__lightbox-inner", onClick: (event) => event.stopPropagation(), role: "dialog", "aria-modal": "true", "aria-label": file.name, children: [_jsx("div", { className: "jini-file-dropzone__lightbox-stage", "data-kind": kind, children: renderStage(t, file, kind, previews) }), _jsxs("div", { className: "jini-file-dropzone__lightbox-bar", children: [_jsx("span", { className: "jini-file-dropzone__lightbox-name", title: file.name, children: file.name }), _jsx("span", { className: "jini-file-dropzone__lightbox-meta", children: fileDropzoneSizeLabel(file.size) }), _jsx("button", { type: "button", className: "jini-file-dropzone__lightbox-close", onClick: onClose, "aria-label": t('Close preview'), children: _jsx(Icon, { name: "close", size: 18 }) })] })] }) }), document.body);
+}
+//# sourceMappingURL=FileDropzoneLightbox.js.map

package/dist/features/file-dropzone/react/components/FileDropzoneLightbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneLightbox.js","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneLightbox.tsx"],"names":[],"mappings":"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"}

package/dist/features/file-dropzone/react/components/FileDropzoneNameList.d.ts

@@ -0,0 +1,9 @@
+export interface FileDropzoneNameListProps {
+    names: readonly string[];
+    onRemoveName?: ((name: string) => void) | undefined;
+    /** Accessible label for the list (e.g. `"{label} selections"`). */
+    ariaLabel: string;
+}
+/** The simple staged-names display for the labeled/prompt-driven variant (no `File` objects retained, no thumbnails) — ported from `DesignSystemFlow.tsx`'s `DropZone`. */
+export declare function FileDropzoneNameList({ names, onRemoveName, ariaLabel }: FileDropzoneNameListProps): import("react").JSX.Element | null;
+//# sourceMappingURL=FileDropzoneNameList.d.ts.map

package/dist/features/file-dropzone/react/components/FileDropzoneNameList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneNameList.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneNameList.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2KAA2K;AAC3K,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,yBAAyB,sCAsBjG"}

package/dist/features/file-dropzone/react/components/FileDropzoneNameList.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../../../i18n/index.js';
+/** The simple staged-names display for the labeled/prompt-driven variant (no `File` objects retained, no thumbnails) — ported from `DesignSystemFlow.tsx`'s `DropZone`. */
+export function FileDropzoneNameList({ names, onRemoveName, ariaLabel }) {
+    const t = useT();
+    if (names.length === 0)
+        return null;
+    return (_jsx("div", { className: "jini-file-dropzone__name-list", "aria-label": ariaLabel, children: names.map((name) => (_jsxs("span", { className: "jini-file-dropzone__name-chip", children: [name, onRemoveName ? (_jsx("button", { type: "button", className: "jini-file-dropzone__name-remove", "aria-label": t('Remove {name}', { name }), onClick: () => onRemoveName(name), children: _jsx("span", { "aria-hidden": true, children: "\u00D7" }) })) : null] }, name))) }));
+}
+//# sourceMappingURL=FileDropzoneNameList.js.map

package/dist/features/file-dropzone/react/components/FileDropzoneNameList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneNameList.js","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneNameList.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAS9C,2KAA2K;AAC3K,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAA6B;IAChG,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,CACL,cAAK,SAAS,EAAC,+BAA+B,gBAAa,SAAS,YACjE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,gBAAM,SAAS,EAAC,+BAA+B,aAC5C,IAAI,EACJ,YAAY,CAAC,CAAC,CAAC,CACd,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,iCAAiC,gBAC/B,CAAC,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,EACxC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAEjC,yDAA0B,GACnB,CACV,CAAC,CAAC,CAAC,IAAI,KAX2C,IAAI,CAYlD,CACR,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.d.ts

@@ -0,0 +1,10 @@
+import type { FileDropzonePreviewState } from '../../types.js';
+export interface FileDropzoneThumbnailGridProps {
+    files: readonly File[];
+    previews: FileDropzonePreviewState;
+    onSelect: (file: File) => void;
+    onRemove?: ((file: File) => void) | undefined;
+}
+/** Kind-aware thumbnail grid over staged files, with remove tiles and click-to-select (the host renders the lightbox — see `FileDropzoneLightbox`). Ported from `DesignSystemAssetDropzone.tsx`'s staged-asset grid. */
+export declare function FileDropzoneThumbnailGrid({ files, previews, onSelect, onRemove }: FileDropzoneThumbnailGridProps): import("react").JSX.Element | null;
+//# sourceMappingURL=FileDropzoneThumbnailGrid.d.ts.map

package/dist/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneThumbnailGrid.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/C;AAmDD,wNAAwN;AACxN,wBAAgB,yBAAyB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,8BAA8B,sCAmChH"}

package/dist/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Icon } from '../../../../react/components/Icon.js';
+import { useT } from '../../../i18n/index.js';
+import { FILE_DROPZONE_FONT_SPECIMEN, FILE_DROPZONE_GLYPH_ICON, FILE_DROPZONE_TEXT_THUMB_CHARS } from '../../constants.js';
+import { fileDropzoneExtensionLabel, fileDropzoneKind, fileDropzoneStagingKey } from '../../rules.js';
+function renderGlyph(file, kind) {
+    return (_jsxs("span", { className: "jini-file-dropzone__glyph", "data-kind": kind, children: [_jsx(Icon, { name: FILE_DROPZONE_GLYPH_ICON[kind], size: 20 }), _jsx("span", { className: "jini-file-dropzone__glyph-ext", children: fileDropzoneExtensionLabel(file) })] }));
+}
+function renderThumb(file, kind, previews) {
+    const url = previews.previewUrls.get(file);
+    if (kind === 'image' && url) {
+        return _jsx("img", { src: url, alt: "", className: "jini-file-dropzone__thumb", loading: "lazy" });
+    }
+    if (kind === 'video' && url) {
+        return (_jsx("video", { className: "jini-file-dropzone__thumb", src: url, muted: true, playsInline: true, preload: "metadata", tabIndex: -1 }));
+    }
+    if (kind === 'font') {
+        const family = previews.fontFamilies.get(file);
+        if (family) {
+            return (_jsx("span", { className: "jini-file-dropzone__font-thumb", style: { fontFamily: `'${family}'` }, "aria-hidden": true, children: FILE_DROPZONE_FONT_SPECIMEN }));
+        }
+    }
+    if (kind === 'html' && url) {
+        return (_jsx("span", { className: "jini-file-dropzone__frame-thumb", "aria-hidden": true, children: _jsx("iframe", { className: "jini-file-dropzone__html-thumb", src: url, title: "", sandbox: "", tabIndex: -1 }) }));
+    }
+    if (kind === 'text') {
+        const snippet = previews.textSnippets.get(file);
+        if (snippet && snippet.trim()) {
+            return (_jsx("span", { className: "jini-file-dropzone__text-thumb", "aria-hidden": true, children: snippet.slice(0, FILE_DROPZONE_TEXT_THUMB_CHARS) }));
+        }
+    }
+    return renderGlyph(file, kind);
+}
+/** Kind-aware thumbnail grid over staged files, with remove tiles and click-to-select (the host renders the lightbox — see `FileDropzoneLightbox`). Ported from `DesignSystemAssetDropzone.tsx`'s staged-asset grid. */
+export function FileDropzoneThumbnailGrid({ files, previews, onSelect, onRemove }) {
+    const t = useT();
+    if (files.length === 0)
+        return null;
+    return (_jsx("ul", { className: "jini-file-dropzone__grid", "aria-label": t('Staged files'), children: files.map((file) => {
+            const kind = fileDropzoneKind(file);
+            return (_jsxs("li", { className: "jini-file-dropzone__tile", children: [_jsx("button", { type: "button", className: "jini-file-dropzone__tile-main", onClick: () => onSelect(file), title: file.name, children: renderThumb(file, kind, previews) }), onRemove ? (_jsx("button", { type: "button", className: "jini-file-dropzone__remove", "aria-label": t('Remove {name}', { name: file.name }), onClick: () => onRemove(file), children: _jsx(Icon, { name: "close", size: 12 }) })) : null, _jsx("span", { className: "jini-file-dropzone__caption", title: file.name, children: file.name })] }, fileDropzoneStagingKey(file)));
+        }) }));
+}
+//# sourceMappingURL=FileDropzoneThumbnailGrid.js.map

package/dist/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDropzoneThumbnailGrid.js","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/components/FileDropzoneThumbnailGrid.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC3H,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAUtG,SAAS,WAAW,CAAC,IAAU,EAAE,IAAsB;IACrD,OAAO,CACL,gBAAM,SAAS,EAAC,2BAA2B,eAAY,IAAI,aACzD,KAAC,IAAI,IAAC,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,GAAI,EACxD,eAAM,SAAS,EAAC,+BAA+B,YAAE,0BAA0B,CAAC,IAAI,CAAC,GAAQ,IACpF,CACR,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAU,EAAE,IAAsB,EAAE,QAAkC;IACzF,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,EAAE,CAAC;QAC5B,OAAO,cAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAC,EAAE,EAAC,SAAS,EAAC,2BAA2B,EAAC,OAAO,EAAC,MAAM,GAAG,CAAC;IACvF,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,EAAE,CAAC;QAC5B,OAAO,CACL,gBAAO,SAAS,EAAC,2BAA2B,EAAC,GAAG,EAAE,GAAG,EAAE,KAAK,QAAC,WAAW,QAAC,OAAO,EAAC,UAAU,EAAC,QAAQ,EAAE,CAAC,CAAC,GAAI,CAC7G,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CACL,eAAM,SAAS,EAAC,gCAAgC,EAAC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,MAAM,GAAG,EAAE,iCAClF,2BAA2B,GACvB,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3B,OAAO,CACL,eAAM,SAAS,EAAC,iCAAiC,iCAC/C,iBAAQ,SAAS,EAAC,gCAAgC,EAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAC,EAAE,EAAC,OAAO,EAAC,EAAE,EAAC,QAAQ,EAAE,CAAC,CAAC,GAAI,GAC5F,CACR,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9B,OAAO,CACL,eAAM,SAAS,EAAC,gCAAgC,iCAC7C,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,8BAA8B,CAAC,GAC5C,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,wNAAwN;AACxN,MAAM,UAAU,yBAAyB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAkC;IAC/G,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,CACL,aAAI,SAAS,EAAC,0BAA0B,gBAAa,CAAC,CAAC,cAAc,CAAC,YACnE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,CACL,cAAuC,SAAS,EAAC,0BAA0B,aACzE,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,+BAA+B,EACzC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC7B,KAAK,EAAE,IAAI,CAAC,IAAI,YAEf,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,GAC3B,EACR,QAAQ,CAAC,CAAC,CAAC,CACV,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,4BAA4B,gBAC1B,CAAC,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EACnD,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAE7B,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAE,EAAE,GAAI,GACxB,CACV,CAAC,CAAC,CAAC,IAAI,EACR,eAAM,SAAS,EAAC,6BAA6B,EAAC,KAAK,EAAE,IAAI,CAAC,IAAI,YAC3D,IAAI,CAAC,IAAI,GACL,KArBA,sBAAsB,CAAC,IAAI,CAAC,CAsBhC,CACN,CAAC;QACJ,CAAC,CAAC,GACC,CACN,CAAC;AACJ,CAAC"}

package/dist/features/file-dropzone/react/hooks/useFileDialogTracking.d.ts

@@ -0,0 +1,35 @@
+export interface UseFileDialogTrackingResult {
+    /** Call when the file input is clicked, before the OS dialog opens. A no-op if no `onProcessingStart` was supplied. */
+    prepareTracking: () => void;
+    /**
+     * Call once the input's `change` event fires (a real selection). Clears
+     * every timer and returns any in-flight "finish" callback (`undefined` if
+     * no loading affordance was ever shown) — undelayed, so the caller
+     * decides its own timing around the staging work that follows.
+     */
+    completeTracking: () => (() => void) | undefined;
+    /** Call from the input's `cancel` event: completes tracking and, if a loading affordance was showing, schedules its finish after the minimum-visible delay so it doesn't flash. */
+    handleDialogCancelled: () => void;
+}
+/**
+ * The file-dialog cancel-vs-still-loading detection heuristic, ported from
+ * `DesignSystemFlow.tsx`'s `DropZone`. A native `<input type=file>` click
+ * opens an OS-level dialog with no DOM signal for "still open" — only
+ * `window` regaining `focus` (the dialog closed, picked or not) and the
+ * input's own `cancel` event (dismissed with no selection) are observable.
+ * Two racing timers decide when a `focus` is trustworthy enough to start a
+ * loading affordance: a short delay that ignores a spurious focus firing
+ * immediately after the click, and a longer warmup that force-starts the
+ * affordance if `focus` never arrives at all (some platforms never blur the
+ * main window for a file dialog). A stale-timeout safety net force-clears a
+ * loading affordance that's been open too long without the dialog
+ * resolving (a hung or buggy picker).
+ *
+ * Deliberately generalized from the origin: there, this heuristic only ran
+ * for the directory-browse zone (`directory && onProcessingStart`); here it
+ * runs for any zone that supplies `onProcessingStart`, since the heuristic
+ * itself has no directory-specific behavior — a large flat file selection
+ * benefits from the same loading affordance a large folder selection does.
+ */
+export declare function useFileDialogTracking(onProcessingStart?: () => () => void): UseFileDialogTrackingResult;
+//# sourceMappingURL=useFileDialogTracking.d.ts.map

package/dist/features/file-dropzone/react/hooks/useFileDialogTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileDialogTracking.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/hooks/useFileDialogTracking.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,2BAA2B;IAC1C,uHAAuH;IACvH,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACjD,mLAAmL;IACnL,qBAAqB,EAAE,MAAM,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,MAAM,MAAM,IAAI,GAAG,2BAA2B,CA0FvG"}

package/dist/features/file-dropzone/react/hooks/useFileDialogTracking.js

@@ -0,0 +1,113 @@
+import { useEffect, useRef } from 'react';
+import { FILE_DIALOG_FOCUS_DELAY_MS, FILE_DIALOG_STALE_MS, FILE_DIALOG_WARMUP_MS, FILE_DROPZONE_PROCESSING_MIN_VISIBLE_MS, } from '../../constants.js';
+/**
+ * The file-dialog cancel-vs-still-loading detection heuristic, ported from
+ * `DesignSystemFlow.tsx`'s `DropZone`. A native `<input type=file>` click
+ * opens an OS-level dialog with no DOM signal for "still open" — only
+ * `window` regaining `focus` (the dialog closed, picked or not) and the
+ * input's own `cancel` event (dismissed with no selection) are observable.
+ * Two racing timers decide when a `focus` is trustworthy enough to start a
+ * loading affordance: a short delay that ignores a spurious focus firing
+ * immediately after the click, and a longer warmup that force-starts the
+ * affordance if `focus` never arrives at all (some platforms never blur the
+ * main window for a file dialog). A stale-timeout safety net force-clears a
+ * loading affordance that's been open too long without the dialog
+ * resolving (a hung or buggy picker).
+ *
+ * Deliberately generalized from the origin: there, this heuristic only ran
+ * for the directory-browse zone (`directory && onProcessingStart`); here it
+ * runs for any zone that supplies `onProcessingStart`, since the heuristic
+ * itself has no directory-specific behavior — a large flat file selection
+ * benefits from the same loading affordance a large folder selection does.
+ */
+export function useFileDialogTracking(onProcessingStart) {
+    const pendingRef = useRef(false);
+    const canShowLoadingRef = useRef(false);
+    const loadingFinishRef = useRef(undefined);
+    const focusDelayRef = useRef(undefined);
+    const warmupRef = useRef(undefined);
+    const staleRef = useRef(undefined);
+    const onProcessingStartRef = useRef(onProcessingStart);
+    onProcessingStartRef.current = onProcessingStart;
+    function clearTimer(ref) {
+        if (ref.current === undefined)
+            return;
+        window.clearTimeout(ref.current);
+        ref.current = undefined;
+    }
+    function completeTracking() {
+        clearTimer(focusDelayRef);
+        clearTimer(warmupRef);
+        clearTimer(staleRef);
+        pendingRef.current = false;
+        canShowLoadingRef.current = false;
+        const finish = loadingFinishRef.current;
+        loadingFinishRef.current = undefined;
+        return finish;
+    }
+    function scheduleFinish(finish) {
+        if (!finish)
+            return;
+        window.setTimeout(finish, FILE_DROPZONE_PROCESSING_MIN_VISIBLE_MS);
+    }
+    function handleDialogCancelled() {
+        scheduleFinish(completeTracking());
+    }
+    function beginReturnLoading() {
+        if (!pendingRef.current)
+            return;
+        if (!canShowLoadingRef.current)
+            return;
+        const start = onProcessingStartRef.current;
+        if (!start)
+            return;
+        if (loadingFinishRef.current)
+            return;
+        loadingFinishRef.current = start();
+        staleRef.current = window.setTimeout(() => {
+            handleDialogCancelled();
+        }, FILE_DIALOG_STALE_MS);
+    }
+    useEffect(() => {
+        if (!onProcessingStart)
+            return undefined;
+        function handleFocus() {
+            beginReturnLoading();
+        }
+        window.addEventListener('focus', handleFocus);
+        return () => window.removeEventListener('focus', handleFocus);
+        // `beginReturnLoading` closes only over refs (stable identity semantics) — re-subscribing per render would just churn the listener for no behavioral change.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [onProcessingStart]);
+    // Clears any pending timers on unmount without invoking a stored `finish`
+    // (calling into host state after unmount would be the host's problem, but
+    // avoiding it entirely is strictly safer than the origin, which had no
+    // unmount cleanup for these timers at all).
+    useEffect(() => {
+        return () => {
+            clearTimer(focusDelayRef);
+            clearTimer(warmupRef);
+            clearTimer(staleRef);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    function prepareTracking() {
+        if (!onProcessingStartRef.current)
+            return;
+        const previousFinish = completeTracking();
+        previousFinish?.();
+        pendingRef.current = true;
+        canShowLoadingRef.current = false;
+        focusDelayRef.current = window.setTimeout(() => {
+            canShowLoadingRef.current = true;
+            focusDelayRef.current = undefined;
+        }, FILE_DIALOG_FOCUS_DELAY_MS);
+        warmupRef.current = window.setTimeout(() => {
+            canShowLoadingRef.current = true;
+            warmupRef.current = undefined;
+            beginReturnLoading();
+        }, FILE_DIALOG_WARMUP_MS);
+    }
+    return { prepareTracking, completeTracking, handleDialogCancelled };
+}
+//# sourceMappingURL=useFileDialogTracking.js.map

package/dist/features/file-dropzone/react/hooks/useFileDialogTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileDialogTracking.js","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/hooks/useFileDialogTracking.ts"],"names":[],"mappings":"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"}

package/dist/features/file-dropzone/react/hooks/useFileDropzone.d.ts

@@ -0,0 +1,44 @@
+import { type ChangeEvent, type DragEvent, type RefObject } from 'react';
+export interface UseFileDropzoneParams {
+    /** Resolved files ready to stage — always the fully directory-expanded flat list, whether they arrived via drag/drop, click-to-browse, or paste. */
+    onFiles: (files: File[]) => void;
+    /** Fires on a native click on the zone. Drag/drop and paste don't trigger it. */
+    onZoneClick?: (() => void) | undefined;
+    /** Surfaces a read error (e.g. a dropped folder failed to enumerate), or clears it (`null`) right before a successful staging. */
+    onError?: ((message: string | null) => void) | undefined;
+    /**
+     * Wraps staging of a large selection (see `FILE_DROPZONE_PROCESSING_FILE_COUNT_THRESHOLD`
+     * / `_BYTES_THRESHOLD`) so a host can show a loading affordance while it
+     * resolves; returns the "finish" callback. Also drives the file-dialog
+     * cancel-vs-still-loading detection heuristic for click-to-browse. Omit
+     * for a zone that never needs a loading affordance (small selections
+     * stage synchronously regardless).
+     */
+    onProcessingStart?: (() => () => void) | undefined;
+    /** Listens for a page-wide clipboard paste (ignoring one that lands on a text-entry target) and stages any pasted files directly — bypasses the processing-affordance heuristic, matching the origin (a paste is never a directory, so it's never large enough to need one). */
+    enablePaste?: boolean | undefined;
+}
+export interface UseFileDropzoneResult {
+    inputRef: RefObject<HTMLInputElement | null>;
+    dragOver: boolean;
+    dropReadError: string | null;
+    openPicker: () => void;
+    onZoneDragEnter: (event: DragEvent<Element>) => void;
+    onZoneDragOver: (event: DragEvent<Element>) => void;
+    onZoneDragLeave: (event: DragEvent<Element>) => void;
+    onZoneDrop: (event: DragEvent<Element>) => void;
+    onInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    onInputClick: () => void;
+}
+/**
+ * Consolidates the two independent OD file-staging zones'
+ * behavior into one hook: native drag/drop (directory-aware, via
+ * `browser/useFileDropTarget`), click-to-browse (with the file-dialog
+ * cancel-vs-still-loading detection heuristic, via `useFileDialogTracking`),
+ * an optional page-wide clipboard-paste listener, and the shared
+ * large-selection loading-affordance heuristic that gates all of the above
+ * except paste. See `packages/ui/source-map.md` for the full consolidation
+ * writeup and which origin file contributed which piece.
+ */
+export declare function useFileDropzone({ onFiles, onZoneClick, onError, onProcessingStart, enablePaste, }: UseFileDropzoneParams): UseFileDropzoneResult;
+//# sourceMappingURL=useFileDropzone.d.ts.map

package/dist/features/file-dropzone/react/hooks/useFileDropzone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileDropzone.d.ts","sourceRoot":"","sources":["../../../../../src/features/file-dropzone/react/hooks/useFileDropzone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO5F,MAAM,WAAW,qBAAqB;IACpC,oJAAoJ;IACpJ,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACjC,iFAAiF;IACjF,WAAW,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACvC,kIAAkI;IAClI,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACzD;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnD,gRAAgR;IAChR,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD,cAAc,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC9D,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAUD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,WAAmB,GACpB,EAAE,qBAAqB,GAAG,qBAAqB,CAoH/C"}