@zjlab-fe/data-hub-ui 0.10.6 → 0.11.0

package/dist/types/components/file-uploader/context/action-registry.d.ts

@@ -0,0 +1,59 @@
+import type { HandlerContext } from '../types';
+/**
+ * Global action registry for providing fresh context to handlers.
+ *
+ * This registry stores references to the latest upload actions (removeFile, start, etc.)
+ * and state (files). It's updated on every render by useUpload hook, ensuring that
+ * when handlers are invoked, they receive always-current references.
+ *
+ * This solves the stale closure problem where handlers registered at file-add time
+ * would capture outdated versions of functions and state.
+ *
+ * Flow:
+ * 1. useUpload hook updates actionRegistry on every render with fresh refs
+ * 2. QueueManager callbacks (queue-callbacks.ts) invoke handlers
+ * 3. Before invoking, they call actionRegistry.getContext() to get fresh utilities
+ * 4. Handler receives fresh context, avoiding stale closure issues
+ *
+ * @example
+ * ```tsx
+ * // In useUpload hook (automatic):
+ * useEffect(() => {
+ *   actionRegistry.update({ files, removeFile, start, ... });
+ * });
+ *
+ * // In queue-callbacks.ts:
+ * const ctx = actionRegistry.getContext();
+ * handlers.onUploadSuccess?.(file, ctx);
+ * ```
+ */
+declare class ActionRegistry {
+    private context;
+    /**
+     * Update the stored context with fresh references.
+     * Called by useUpload hook on every render.
+     */
+    update(context: HandlerContext): void;
+    /**
+     * Get the current context with fresh references.
+     * Returns null if context hasn't been initialized yet.
+     */
+    getContext(): HandlerContext | null;
+    /**
+     * Check if context is available.
+     */
+    hasContext(): boolean;
+    /**
+     * Clear the context.
+     * Mainly for testing or complete reset.
+     */
+    clear(): void;
+}
+/**
+ * Singleton instance of the action registry.
+ * This is intentionally a module-level singleton, similar to handlerRegistry,
+ * because it needs to be accessible from queue-callbacks.ts which operates
+ * outside the React component tree.
+ */
+export declare const actionRegistry: ActionRegistry;
+export {};

package/dist/types/components/file-uploader/engine/queue-callbacks.d.ts

@@ -1,6 +1,6 @@
 import type { Dispatch } from 'react';
 import type { QueueCallbacks } from './queue-types';
-import type { UploadAction } from '../types';
+import type { UploadAction, HandlerContext } from '../types';
 /**
  * Dependencies required to create queue callbacks.
  * These are injected from the React hook to maintain reactivity.
@@ -19,3 +19,12 @@ export interface QueueCallbackDeps {
  * - onFileComplete: When all chunks of a file are uploaded
  */
 export declare function createQueueCallbacks({ dispatch }: QueueCallbackDeps): QueueCallbacks;
+/**
+ * Get fresh handler context from the action registry.
+ * This provides always-current references to files and upload utilities,
+ * solving the stale closure problem in handler callbacks.
+ *
+ * @returns HandlerContext with fresh references
+ * @throws Error if context not available (useUpload hook not mounted)
+ */
+export declare function getHandlerContext(): HandlerContext;

package/dist/types/components/file-uploader/index.d.ts

@@ -4,7 +4,7 @@ export { UploaderDropZone } from './components/uploader-drop-zone';
 export { UploaderFileListLayout } from './components/uploader-file-list';
 export { UploaderFileItem } from './components/uploader-file-item';
 export { useUpload } from './hooks/use-upload';
-export type { UploadFile, ChunkState, UploadHandlers, CallbackResult, GetUploadUrlsResult, UploadUrl, UploadConfig, AddFilesOptions, } from './types';
+export type { UploadFile, ChunkState, UploadHandlers, HandlerContext, CallbackResult, GetUploadUrlsResult, UploadUrl, UploadConfig, AddFilesOptions, } from './types';
 export type { DropZoneError, UploaderDropZoneClassNames, UploaderDropZoneProps, } from './components/uploader-drop-zone';
 export type { FileWithPath } from './components/utils/directory-reader';
 export type { FileListClassNames } from './components/uploader-file-list';

package/dist/types/components/file-uploader/types.d.ts

@@ -45,37 +45,73 @@ export type CallbackResult = {
     success: false;
     reason?: string;
 };
+/**
+ * Context object passed to handler callbacks with fresh utilities.
+ * This solves the stale closure problem by providing always-current references.
+ *
+ * @example
+ * ```tsx
+ * addFiles(files, {
+ *   getHandlers: () => ({
+ *     onUploadSuccess: (file, ctx) => {
+ *       // Use ctx instead of closed-over values - always fresh!
+ *       console.log('Current files:', ctx.files.length);
+ *       ctx.removeFile(file.id);
+ *     }
+ *   })
+ * });
+ * ```
+ */
+export interface HandlerContext {
+    /** Current files in the upload queue (always fresh) */
+    files: UploadFile[];
+    /** Remove a file from the queue (always fresh) */
+    removeFile: (id: string) => Promise<void>;
+    /** Start uploading a pending file (always fresh) */
+    start: (id: string) => Promise<void>;
+    /** Pause an uploading file (always fresh) */
+    pause: (id: string) => void;
+    /** Resume a paused file (always fresh) */
+    resume: (id: string) => Promise<void>;
+    /** Cancel a file upload (always fresh) */
+    cancel: (id: string) => void;
+    /** Get a specific file by ID (always fresh) */
+    getFileById: (id: string) => UploadFile | undefined;
+}
 /**
  * Upload lifecycle handler callbacks
- * These hooks allow consumers to integrate with the upload process at various stages
+ * These hooks allow consumers to integrate with the upload process at various stages.
+ *
+ * All callbacks that receive a file also receive a `ctx` (HandlerContext) parameter
+ * with fresh references to upload utilities, solving the stale closure problem.
  */
 export interface UploadHandlers {
-    /** Called before requesting upload URLs. Return { status: false } to cancel upload */
-    onBeforeUpload?: (file: UploadFile) => Promise<CallbackResult>;
+    /** Called before requesting upload URLs. Return { success: false } to cancel upload */
+    onBeforeUpload?: (file: UploadFile, ctx: HandlerContext) => Promise<CallbackResult>;
     /** Request upload URLs from server (required) */
     onGetUploadUrls: (fileName: string, partCount: number) => Promise<GetUploadUrlsResult>;
     /** Called after URLs received, before chunk uploads begin */
-    onUploadStart?: (file: UploadFile) => void;
+    onUploadStart?: (file: UploadFile, ctx: HandlerContext) => void;
     /** Called when file progress updates (0-100) */
-    onProgress?: (file: UploadFile, progress: number) => void;
+    onProgress?: (file: UploadFile, progress: number, ctx: HandlerContext) => void;
     /** Called when a chunk upload completes (required) */
     onPartComplete: (fileName: string, uploadId: string, partNum: number) => Promise<CallbackResult>;
     /** Called when upload is paused */
-    onPause?: (file: UploadFile) => void;
+    onPause?: (file: UploadFile, ctx: HandlerContext) => void;
     /** Called when upload is resumed */
-    onResume?: (file: UploadFile) => void;
+    onResume?: (file: UploadFile, ctx: HandlerContext) => void;
     /** Called when entire file upload completes (required) */
     onFileComplete: (fileName: string, uploadId: string) => Promise<CallbackResult>;
     /** Called when upload is successful */
-    onUploadSuccess?: (file: UploadFile) => void;
+    onUploadSuccess?: (file: UploadFile, ctx: HandlerContext) => void;
     /** Called when upload is cancelled */
     onUploadCancel?: (fileName: string, uploadId: string) => Promise<CallbackResult>;
     /** Called when file is deleted */
-    onDeleteFile?: (file: UploadFile) => Promise<CallbackResult>;
+    onDeleteFile?: (file: UploadFile, ctx: HandlerContext) => Promise<CallbackResult>;
     /** Called when upload is retried (smart or full retry) */
-    onRetry?: (file: UploadFile, retryType: 'smart' | 'full') => void;
+    onRetry?: (file: UploadFile, retryType: 'smart' | 'full', ctx: HandlerContext) => void;
     /** Called when an error occurs during upload */
-    onError?: (file: UploadFile, error: Error) => void;
+    onError?: (file: UploadFile, error: Error, ctx: HandlerContext) => void;
 }
 export interface UploadConfig {
     /** Maximum chunk size in bytes */

package/dist/types/components/menu/demo/index.d.ts

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

package/dist/types/components/menu/index.d.ts

@@ -0,0 +1,16 @@
+import './index.css';
+import type { ItemType } from 'antd/es/menu/interface';
+export interface IProps {
+    menus: ItemType[];
+    collapsed: boolean;
+    onCollapse: (collapsed: boolean) => void;
+}
+/**
+ * 左侧菜单
+ * @param menus {MenuItem[]} 菜单项目
+ * @param collapsed {boolean} 是否折叠
+ * @param onCollapse {function} 折叠回调
+ * @returns
+ */
+declare const MainLayoutSider: (props: IProps) => import("react/jsx-runtime").JSX.Element;
+export default MainLayoutSider;

package/dist/types/components/tip-tap/extensions/index.d.ts

@@ -1,2 +1,2 @@
-export declare const editorExtensions: (placeholder?: string) => (import("@tiptap/core").Extension<import("@tiptap/starter-kit").StarterKitOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-style").ColorOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-align").TextAlignOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-image").ImageOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableRowOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-code-block-lowlight").CodeBlockLowlightOptions, any> | import("@tiptap/core").Extension<any, any> | import("@tiptap/core").Extension<import("@tiptap/extension-placeholder").PlaceholderOptions, any> | import("@tiptap/core").Extension<import("@tiptap/markdown").MarkdownExtensionOptions, import("@tiptap/markdown").MarkdownExtensionStorage>)[];
+export declare const editorExtensions: (placeholder?: string) => (import("@tiptap/core").Extension<import("@tiptap/starter-kit").StarterKitOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-placeholder").PlaceholderOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-style").ColorOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-align").TextAlignOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-image").ImageOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableRowOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-code-block-lowlight").CodeBlockLowlightOptions, any> | import("@tiptap/core").Extension<import("@tiptap/markdown").MarkdownExtensionOptions, import("@tiptap/markdown").MarkdownExtensionStorage> | import("@tiptap/core").Extension<any, any>)[];
 export declare const readerExtensions: () => (import("@tiptap/core").Extension<import("@tiptap/starter-kit").StarterKitOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-style").ColorOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-align").TextAlignOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-image").ImageOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableRowOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-code-block-lowlight").CodeBlockLowlightOptions, any>)[];

package/dist/types/demo/router/index.d.ts

@@ -1,14 +1,18 @@
-import { createBrowserRouter } from 'react-router-dom';
-export declare const routerConfig: ({
-    path: string;
-    children: never[];
-    element?: undefined;
-} | {
+import { createBrowserRouter, createHashRouter } from 'react-router-dom';
+export declare const routerConfig: {
     path: string;
     element: import("react/jsx-runtime").JSX.Element;
-    children: {
+    children: ({
+        path: string;
+        element: import("react/jsx-runtime").JSX.Element;
+        children?: undefined;
+    } | {
         path: string;
         element: import("react/jsx-runtime").JSX.Element;
-    }[];
-})[];
-export declare const router: ReturnType<typeof createBrowserRouter>;
+        children: {
+            path: string;
+            element: import("react/jsx-runtime").JSX.Element;
+        }[];
+    })[];
+}[];
+export declare const router: ReturnType<typeof createBrowserRouter | typeof createHashRouter>;