@zjlab-fe/data-hub-ui 0.21.7 → 0.23.0

package/package.json

@@ -1,28 +1,50 @@
 {
   "name": "@zjlab-fe/data-hub-ui",
-  "version": "0.21.7",
+  "version": "0.23.0",
   "main": "lib/index.js",
   "module": "es/index.js",
   "types": "dist/types/index.d.ts",
   "license": "ISC",
   "scripts": {
     "start": "cross-env NODE_ENV=development webpack-dev-server --open /data-hub-ui/demo --config webpack.dev.config.js",
-    "build:dist": "npm run build:lib & npm run build:es",
+    "build:dist": "npm run build:lib && npm run build:es && npm run build:types",
     "build": "cross-env NODE_ENV=production webpack --config webpack.dev.config.js",
     "build:lib": "cross-env NODE_ENV=production webpack --config webpack.prod.config.js",
-    "build:es": "cross-env NODE_ENV=production OUTPUT_TYPE=module webpack --config webpack.prod.config.js",
+    "build:es": "rollup -c rollup.es.config.mjs",
+    "build:types": "tsc --emitDeclarationOnly",
     "generate:skill": "node scripts/generateComponentsSkill.js",
     "lint": "npm run lint-eslint",
     "lint-eslint": "eslint -c .eslintrc.js --ext .ts,.tsx,.js,.jsx src --fix",
     "prepare": "husky",
     "test": "jest --coverage"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.js"
+    },
+    "./components/*": {
+      "types": "./dist/types/components/*/index.d.ts",
+      "import": "./es/components/*/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "**/*.css.js",
+    "**/*.scss.js"
+  ],
   "devDependencies": {
     "@babel/core": "^7.24.7",
     "@babel/preset-env": "^7.25.7",
     "@babel/preset-react": "^7.24.7",
     "@babel/preset-typescript": "^7.25.7",
     "@jest/globals": "^29.7.0",
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@rollup/plugin-url": "^8.0.2",
     "@tailwindcss/typography": "^0.5.16",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.0.1",
@@ -36,7 +58,6 @@
     "babel-jest": "^29.7.0",
     "babel-loader": "^9.1.3",
     "babel-preset-react-app": "^10.0.1",
-    "clsx": "^2.1.1",
     "cross-env": "^7.0.3",
     "css-loader": "^7.1.2",
     "eslint": "8.x",
@@ -52,16 +73,20 @@
     "lint-staged": "^15.2.7",
     "mini-css-extract-plugin": "^2.9.0",
     "postcss": "^8.4.47",
+    "postcss-import": "^16.1.1",
     "postcss-loader": "^8.1.1",
+    "postcss-modules": "^6.0.1",
     "postcss-nested": "^6.2.0",
     "prettier": "^3.3.3",
     "raw-loader": "^4.0.2",
     "react-syntax-highlighter": "^15.6.1",
     "react-test-renderer": "^18.3.1",
+    "rollup": "^4.62.2",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-postcss": "^4.0.2",
     "sass": "1.77.x",
     "sass-loader": "14.x",
     "style-loader": "^4.0.0",
-    "tailwind-merge": "^2.6.0",
     "ts-jest": "^29.2.5",
     "ts-loader": "^9.5.1",
     "ts-node": "^10.9.2",
@@ -108,6 +133,7 @@
     "axios": "^1.7.2",
     "chardet": "^2.1.0",
     "classnames": "^2.5.1",
+    "clsx": "^2.1.1",
     "copy-to-clipboard": "^3.3.3",
     "dayjs": "^1.11.11",
     "i18next": "^25.0.0",
@@ -115,7 +141,6 @@
     "jotai-scope": "^0.9.7",
     "lowlight": "^3.3.0",
     "marked": "^16.1.2",
-    "mathjax-full": "3.2.2",
     "parquet-wasm": "^0.6.1",
     "prosemirror-state": "^1.4.3",
     "prosemirror-transform": "^1.12.0",
@@ -133,7 +158,9 @@
     "remark-math": "^6.0.0",
     "resize-observer-polyfill": "^1.5.1",
     "shiki": "^4.1.0",
+    "tailwind-merge": "^2.6.0",
     "tailwindcss": "^3.4.13",
+    "tslib": "^2.8.1",
     "unist-util-visit": "^5.0.0",
     "uuid": "^14.0.0"
   },

package/rollup.es.config.mjs

@@ -0,0 +1,177 @@
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import typescript from '@rollup/plugin-typescript';
+import peerDepsExternal from 'rollup-plugin-peer-deps-external';
+import alias from '@rollup/plugin-alias';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+import * as sass from 'sass';
+import postcss from 'postcss';
+import postcssModules from 'postcss-modules';
+import tailwindcss from 'tailwindcss';
+import autoprefixer from 'autoprefixer';
+import postcssImport from 'postcss-import';
+import postcssNested from 'postcss-nested';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const srcDir = path.resolve(__dirname, 'src');
+
+// PostCSS 基础插件
+const basePostcssPlugins = [postcssImport(), postcssNested(), tailwindcss(), autoprefixer()];
+
+// 图片插件：将图片全部 base64 内联到 JS 中
+// 消费端无需任何额外配置，无路径问题
+function imagePlugin() {
+  return {
+    name: 'images',
+    async load(id) {
+      const ext = path.extname(id).toLowerCase();
+      if (!['.png', '.jpg', '.jpeg', '.gif', '.svg'].includes(ext)) return null;
+      if (id.includes('node_modules')) return null;
+
+      const buffer = fs.readFileSync(id);
+      const mimeMap = {
+        '.png': 'image/png',
+        '.jpg': 'image/jpeg',
+        '.jpeg': 'image/jpeg',
+        '.gif': 'image/gif',
+        '.svg': 'image/svg+xml',
+      };
+      const dataUrl = `data:${mimeMap[ext] || 'image/png'};base64,${buffer.toString('base64')}`;
+
+      return { code: `export default ${JSON.stringify(dataUrl)};`, map: null };
+    },
+  };
+}
+
+// 自定义 SCSS/CSS 处理插件
+function stylePlugin() {
+  return {
+    name: 'styles',
+
+    async transform(code, id) {
+      // 处理 src 目录下的样式文件
+      const isSrc = id.startsWith(srcDir);
+      // 处理从 node_modules 导入的 CSS（经由 src 文件引用）
+      const isNodeModuleCss = !isSrc && id.includes('node_modules') && id.endsWith('.css');
+
+      if (!isSrc && !isNodeModuleCss) return null;
+      if (!id.endsWith('.scss') && !id.endsWith('.css')) return null;
+
+      const isModule = id.endsWith('.module.scss') && isSrc;
+      const ext = path.extname(id);
+      const dir = path.dirname(id);
+
+      let processedCode = code;
+
+      // 替换 SCSS @import 中的 @/ 为相对路径（仅 src 文件）
+      if (isSrc) {
+        processedCode = code.replace(
+          /@(import|use)\s+['"]@\/([^'"]+)['"]/g,
+          (_match, directive, importPath) => {
+            const absolutePath = path.resolve(srcDir, importPath);
+            const relativePath = path.relative(dir, absolutePath).replace(/\\/g, '/');
+            return `@${directive} '${relativePath.startsWith('.') ? relativePath : './' + relativePath}'`;
+          },
+        );
+      }
+
+      // 编译 SCSS → CSS
+      let css;
+      try {
+        if (ext === '.scss') {
+          const result = sass.compileString(processedCode, {
+            loadPaths: [dir, srcDir, path.resolve(srcDir, 'styles')],
+          });
+          css = result.css;
+        } else {
+          css = processedCode;
+        }
+      } catch (err) {
+        this.error(`SCSS compile error: ${err.message}`);
+      }
+
+      // 对所有 CSS 运行 PostCSS（tailwindcss + postcss-nested + postcss-import）
+      try {
+        const tailwindResult = await postcss(basePostcssPlugins).process(css, {
+          from: id,
+          to: id.replace(/\.(scss|css)$/, '.css'),
+        });
+        css = tailwindResult.css;
+      } catch (err) {
+        this.error(`PostCSS error: ${err.message}`);
+      }
+
+      // 对 .module.scss 文件，用 postcss-modules 提取类名映射
+      let classMap = {};
+
+      if (isModule) {
+        const modulesPlugin = postcssModules({
+          generateScopedName: '[name]__[local]___[hash:base64:5]',
+          getJSON(cssFileName, json) {
+            classMap = json;
+          },
+        });
+
+        const result = await postcss([modulesPlugin]).process(css, { from: id });
+        css = result.css;
+      }
+
+      // 生成 JS 模块代码
+      const escapedCss = css.replace(/\\/g, '\\\\').replace(/`/g, '\\`').replace(/\$/g, '\\$');
+
+      let jsCode;
+      if (isModule) {
+        const namedExports = Object.entries(classMap)
+          .map(([key, value]) => {
+            const jsKey = key.replace(/[^a-zA-Z0-9_$]/g, '_');
+            return `var ${jsKey} = ${JSON.stringify(value)}; export { ${jsKey} as ${JSON.stringify(key)} };`;
+          })
+          .join('\n');
+
+        const mapJson = JSON.stringify(classMap);
+
+        jsCode = `
+var style = document.createElement('style');
+style.textContent = \`${escapedCss}\`;
+document.head.appendChild(style);
+
+${namedExports}
+
+var styles = ${mapJson};
+export default styles;
+`;
+      } else {
+        // 普通样式或 node_modules CSS：只注入 CSS，没有 export
+        jsCode = `
+var style = document.createElement('style');
+style.textContent = \`${escapedCss}\`;
+document.head.appendChild(style);
+`;
+      }
+
+      return { code: jsCode, map: null };
+    },
+  };
+}
+
+export default {
+  input: 'src/index.tsx',
+  output: {
+    dir: 'es',
+    format: 'esm',
+    preserveModules: true,
+    preserveModulesRoot: 'src',
+    entryFileNames: '[name].js',
+  },
+  plugins: [
+    peerDepsExternal({ includeDependencies: true }),
+    alias({ entries: [{ find: '@', replacement: srcDir }] }),
+    imagePlugin(),
+    resolve({ extensions: ['.js', '.ts', '.jsx', '.tsx'] }),
+    commonjs(),
+    stylePlugin(),
+    typescript({ tsconfig: './tsconfig.rollup.json' }),
+  ],
+};

package/tsconfig.rollup.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "declaration": false,
+    "declarationDir": null
+  }
+}

package/dist/types/components/FileUploader/FileUploaderContextProvider.d.ts

@@ -1,9 +0,0 @@
-import { FileInfo, UploadableFile, UploadManager } from './types';
-import { FileUploaderProps } from './FileUploaderMain';
-export default function FileUploaderContextProvider({ extra, dragAreaConfig, ...props }: {
-    root?: string;
-    identifier: string;
-    showFinished?: boolean;
-    externalUploadContext?: FileInfo[];
-    onUploadSuccess?: (file: UploadableFile) => void;
-} & UploadManager & FileUploaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderFileDragger.d.ts

@@ -1,11 +0,0 @@
-import './FileUploaderFileDragger.css';
-import { ReactNode } from 'react';
-export interface FileDraggerProps {
-    accept?: string;
-    directory?: boolean;
-    dragAreaDescription?: ReactNode;
-    maxSizePerFile?: number;
-    className?: string;
-    onFileReceived: (_files: File[]) => void;
-}
-export default function FileUploaderFileDragger({ className, accept, directory, dragAreaDescription, maxSizePerFile, onFileReceived, }: FileDraggerProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderFileDraggerDragAreaDescription.d.ts

@@ -1,4 +0,0 @@
-import { ReactNode } from 'react';
-export default function FileDraggerDragAreaDescription({ description }: {
-    description: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderList.d.ts

@@ -1 +0,0 @@
-export default function FileUploadModalList(): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/FileUploader/FileUploaderListItem.d.ts

@@ -1,26 +0,0 @@
-import { ProgressProps } from 'antd';
-import { UploadableFile } from './types';
-export declare const progressStyleProps: ProgressProps;
-declare const _default: import("react").NamedExoticComponent<{
-    file: UploadableFile;
-}>;
-export default _default;
-export declare function ListItemOutline({ children, className }: {
-    children: React.ReactNode;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ListItemName({ fileName, className }: {
-    fileName: string;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ListItemStatus({ className, fileStatus, percentage, strokeColor, }: {
-    className?: string;
-    fileStatus: string;
-    percentage: number;
-    strokeColor?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function ListItemActions({ onDelete, extraActions, className, }: {
-    onDelete: () => void;
-    extraActions?: React.ReactNode;
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderListItemFail.d.ts

@@ -1,5 +0,0 @@
-import { UploadableFile } from './types';
-declare const _default: import("react").NamedExoticComponent<{
-    file: UploadableFile;
-}>;
-export default _default;

package/dist/types/components/FileUploader/FileUploaderListItemPaused.d.ts

@@ -1,5 +0,0 @@
-import { UploadableFile } from './types';
-declare const _default: import("react").NamedExoticComponent<{
-    file: UploadableFile;
-}>;
-export default _default;

package/dist/types/components/FileUploader/FileUploaderListItemUploading.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("react").NamedExoticComponent<object>;
-export default _default;

package/dist/types/components/FileUploader/FileUploaderMain.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-import { FileDraggerProps } from './FileUploaderFileDragger';
-export type FileUploaderProps = {
-    extra?: React.ReactNode;
-    dragAreaConfig?: Omit<FileDraggerProps, 'onFileReceived'>;
-};
-export default function FileUploaderMain({ extra, dragAreaConfig }: FileUploaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/FileUploader/FileUploaderlListItemFinished.d.ts

@@ -1,5 +0,0 @@
-import { UploadableFile } from './types';
-declare const _default: import("react").NamedExoticComponent<{
-    file: UploadableFile;
-}>;
-export default _default;

package/dist/types/components/FileUploader/UploadStoreProvider.d.ts

@@ -1,41 +0,0 @@
-import React from 'react';
-import { UploadableFile } from './types';
-import { Locale } from './translations';
-export type UploadStore = {
-    [key: string]: UploadableFile[];
-};
-type UploadStoreAction = {
-    type: 'add';
-    identifier: string | number;
-} | {
-    type: 'edit_file';
-    identifier: string | number;
-    file: UploadableFile;
-} | {
-    type: 'remove_file';
-    identifier: string | number;
-    fileName: string;
-} | {
-    type: 'add_file';
-    identifier: string | number;
-    file: UploadableFile;
-} | {
-    type: 'clear_finished';
-    identifier: string | number;
-} | {
-    type: 'add_files';
-    identifier: string | number;
-    files: UploadableFile[];
-};
-type UploadStoreDispatch = React.Dispatch<UploadStoreAction>;
-export declare const localeAtom: import("jotai").PrimitiveAtom<Locale> & {
-    init: Locale;
-};
-export declare const TEMP_STORE: {};
-export declare const UploadStoreContext: React.Context<UploadStore>;
-export declare const UploadStoreDispatchContext: React.Context<UploadStoreDispatch>;
-export default function UploadStoreProvider({ locale, children, }: {
-    locale?: 'zh' | 'en';
-    children: React.ReactElement;
-}): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/types/components/FileUploader/hooks/useCheckForDuplicates.d.ts

@@ -1 +0,0 @@
-export declare function useCheckForDuplicates(): (files: File[]) => Promise<[boolean, Set<string>]>;

package/dist/types/components/FileUploader/hooks/useCurrentFIleOnInit.d.ts

@@ -1,5 +0,0 @@
-import { UploadUrl } from '../types';
-export declare function useOnInit(): (chunks: {
-    url: UploadUrl;
-    chunk: Blob;
-}[]) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnAllUploaded.d.ts

@@ -1 +0,0 @@
-export declare function useOnAllUploaded(): (allSuccess: boolean) => Promise<void>;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnCancel.d.ts

@@ -1,2 +0,0 @@
-import { UploadableFile } from '../types';
-export declare function useOnCancel(): (currentFile: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnFail.d.ts

@@ -1,2 +0,0 @@
-import { UploadableFile } from '../types';
-export declare function useOnFail(): (file: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useCurrentFileOnFinished.d.ts

@@ -1,2 +0,0 @@
-import { UploadableFile } from '../types';
-export declare function useOnFinished(): (file: UploadableFile) => void;

package/dist/types/components/FileUploader/hooks/useFileDragAndDrop.d.ts

@@ -1,9 +0,0 @@
-export declare function useFileDragAndDrop(directory: boolean, acceptList: Set<string>, triggerOnFileReceived: (files: File[]) => void): {
-    isDragOver: boolean;
-    handleDragEvents: {
-        onDrop: (e: React.DragEvent<HTMLDivElement>) => Promise<void>;
-        onDragLeave: () => void;
-        onDragEnter: (e: React.DragEvent) => void;
-        onDragOver: (e: React.DragEvent) => void;
-    };
-};

package/dist/types/components/FileUploader/hooks/useRemoveFilesInUploadQueue.d.ts

@@ -1 +0,0 @@
-export declare function useRemoveFilesInUploadQueue(): (duplicationOfName: Set<string>) => void;

package/dist/types/components/FileUploader/hooks/useResumeUnfinishedUploads.d.ts

@@ -1 +0,0 @@
-export declare function useResumeUnfinishedUploads(identifier: string): () => Promise<void>;

package/dist/types/components/FileUploader/hooks/useSaveUnfinishedUploads.d.ts

@@ -1,11 +0,0 @@
-import { UploadStore } from '../UploadStoreProvider';
-import { UploadableFile } from '../types';
-/**
- * 未完成任务信息存储在localStorage而不是indexdb中，需要分别处理
- * 因为之前的测试中发现，indexdb的存储方式在某些浏览器中会丢失数据
- * 所以需要将未完成任务信息存储在localStorage中
- *
- * TODO: 将未完成任务信息存储在indexdb中
- */
-export declare function useSaveUnfinishedUploads(uploadStore: UploadStore): void;
-export declare function formatUnfinishedUploads(uploads: UploadableFile[]): string;

package/dist/types/components/FileUploader/hooks/useTranslate.d.ts

@@ -1 +0,0 @@
-export declare function useTranslate(): (key: string) => string;

package/dist/types/components/FileUploader/hooks/useUploadContext.d.ts

@@ -1,26 +0,0 @@
-import { FileInfo, UploadableFile, UploadManager } from '../types';
-export declare const rootAtom: import("jotai").PrimitiveAtom<string> & {
-    init: string;
-};
-export declare const identifierAtom: import("jotai").PrimitiveAtom<string> & {
-    init: string;
-};
-export declare const showFinishedAtom: import("jotai").PrimitiveAtom<boolean> & {
-    init: boolean;
-};
-export declare const uploadManagerAtom: import("jotai").PrimitiveAtom<UploadManager | null> & {
-    init: UploadManager | null;
-};
-export declare const onUploadSuccessAtom: import("jotai").PrimitiveAtom<((file: UploadableFile) => void) | null> & {
-    init: ((file: UploadableFile) => void) | null;
-};
-export declare const externalUploadContextAtom: import("jotai").PrimitiveAtom<FileInfo[]> & {
-    init: FileInfo[];
-};
-export declare function useUploadContext({ root, identifier, showFinished, externalUploadContext, getUploadUrls, onCancelUpload, onOnePartDone, onAllPartDone, onUploadSuccess, onDeleteFile, }: {
-    root?: string;
-    identifier: string;
-    showFinished?: boolean;
-    externalUploadContext?: FileInfo[];
-    onUploadSuccess?: (file: UploadableFile) => void;
-} & UploadManager): void;

package/dist/types/components/FileUploader/hooks/useWathUploadQueueAndSetupCurrentFile.d.ts

@@ -1 +0,0 @@
-export declare function useWathUploadQueueAndSetupCurrentFile(): void;

package/dist/types/components/FileUploader/translations.d.ts

@@ -1,4 +0,0 @@
-export type Locale = Record<string, string>;
-declare const localeEn: Locale;
-declare const localeZh: Locale;
-export { localeEn, localeZh };

package/dist/types/components/file-uploader/hooks/use-upload-batch.d.ts

@@ -1,36 +0,0 @@
-/**
- * Hook for batch upload operations.
- *
- * Provides:
- * - Start all pending files
- * - Pause all uploading files
- * - Resume all paused files
- * - Cancel all uploads
- *
- * Use this hook when you need bulk control over multiple files.
- *
- * @example
- * ```tsx
- * function BatchControls() {
- *   const { startAll, pauseAll, cancelAll } = useUploadBatch();
- *
- *   return (
- *     <div>
- *       <button onClick={startAll}>Start All</button>
- *       <button onClick={pauseAll}>Pause All</button>
- *       <button onClick={cancelAll}>Cancel All</button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useUploadBatch(): {
-    /** Start all pending files */
-    startAll: () => Promise<void>;
-    /** Pause all uploading files */
-    pauseAll: () => void;
-    /** Resume all paused files */
-    resumeAll: () => Promise<void>;
-    /** Cancel all uploads */
-    cancelAll: () => void;
-};

package/dist/types/components/file-uploader/hooks/use-upload-control.d.ts

@@ -1,37 +0,0 @@
-/**
- * Hook for single file upload controls.
- *
- * Provides:
- * - Start a pending file
- * - Pause an uploading file
- * - Resume a paused file
- * - Cancel an upload
- *
- * Use this hook when you only need to control individual file uploads.
- *
- * @example
- * ```tsx
- * function FileControlButtons({ fileId, status }: { fileId: string; status: string }) {
- *   const { start, pause, resume, cancel } = useUploadControl();
- *
- *   return (
- *     <div>
- *       {status === 'pending' && <button onClick={() => start(fileId)}>Start</button>}
- *       {status === 'uploading' && <button onClick={() => pause(fileId)}>Pause</button>}
- *       {status === 'paused' && <button onClick={() => resume(fileId)}>Resume</button>}
- *       <button onClick={() => cancel(fileId)}>Cancel</button>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useUploadControl(): {
-    /** Start uploading a pending file */
-    start: (id: string) => Promise<void>;
-    /** Pause an uploading file */
-    pause: (id: string) => void;
-    /** Resume a paused file */
-    resume: (id: string) => Promise<void>;
-    /** Cancel a file upload */
-    cancel: (id: string) => Promise<void>;
-};

package/dist/types/components/file-uploader/hooks/use-upload-files.d.ts

@@ -1,40 +0,0 @@
-import type { UploadFile } from '../types';
-/**
- * Hook for accessing upload file state and filtered lists.
- *
- * Provides:
- * - All files in the upload queue
- * - Filtered lists by status (pending, uploading, completed, failed, paused)
- * - File lookup by ID
- *
- * Use this hook when you only need to display/read file data without controlling uploads.
- *
- * @example
- * ```tsx
- * function FileList() {
- *   const { files, pendingFiles, completedFiles } = useUploadFiles();
- *   return (
- *     <div>
- *       <h3>Pending: {pendingFiles.length}</h3>
- *       <ul>{files.map(f => <li key={f.id}>{f.fileName}</li>)}</ul>
- *     </div>
- *   );
- * }
- * ```
- */
-export declare function useUploadFiles(): {
-    /** All files in the upload queue */
-    files: UploadFile[];
-    /** Get a specific file by ID */
-    getFileById: (id: string) => UploadFile | undefined;
-    /** Files waiting to be uploaded */
-    pendingFiles: UploadFile[];
-    /** Files currently uploading */
-    uploadingFiles: UploadFile[];
-    /** Successfully completed uploads */
-    completedFiles: UploadFile[];
-    /** Failed uploads */
-    failedFiles: UploadFile[];
-    /** Paused uploads */
-    pausedFiles: UploadFile[];
-};