@cut-workbench/workbench 0.2.0 → 0.3.0

package/dist/features/media-library/components/DropZone.d.ts

@@ -8,6 +8,12 @@ interface DropZoneProps {
 /**
  * 拖拽 / 点击导入区域。
  *
+ * 两条入口：
+ * - **拖拽**：走 react-dropzone（宿主无法介入，这是浏览器原生行为）；
+ * - **点击**：优先走 `HostBridge.files.pickFiles` —— 宿主可能不用系统文件
+ *   对话框，而是从自己的素材库 / 云端 / URL 导入。宿主返回 `null`（不接管）
+ *   时才回退到内置 `<input type=file>`。
+ *
  * 注意：react-dropzone 的 accept 只做初筛，真正按 MIME + 扩展名校验在
  * core/media/file-reader，从而保证「拖入 .webm 得到明确错误」而不是被静默拒绝。
  */

package/dist/features/media-library/lib/pick-files.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 选择素材文件：宿主优先，回退到浏览器的 `<input type=file>`。
+ *
+ * 为什么不能只用 react-dropzone 的 input：
+ * 素材来源不一定在本地文件系统 —— 宿主可能从自己的素材库、云端、录制器或
+ * URL 导入。`HostBridge.files.pickFiles` 就是给这类宿主用的口子。
+ *
+ * 三种结果必须区分清楚：
+ * - `File[]`：宿主或浏览器选到了文件；
+ * - `[]`：用户主动取消 —— **不要**再回退，否则会连弹两个选择框；
+ * - `null`：宿主不接管 —— 回退到内置 input。
+ */
+import type { HostBridge } from '@cut-workbench/core';
+export interface PickMediaOptions {
+    /** MIME 或扩展名，形如 `video/mp4`、`.srt` */
+    accept: string[];
+    multiple?: boolean;
+    /** 给宿主 UI 用的提示文案 */
+    description?: string;
+}
+/**
+ * @returns 选中的文件；用户取消时为空数组
+ */
+export declare function pickMediaFiles(bridge: HostBridge | null | undefined, options: PickMediaOptions): Promise<File[]>;

package/dist/hooks/use-toast-safe.d.ts

@@ -12,10 +12,18 @@ export interface EditorActions {
     jumpToStart: () => void;
     jumpToEnd: () => void;
 }
-/** 统一把异常转成可见提示，禁止静默吞掉 */
+/**
+ * 把异常转成可见提示，禁止静默吞掉。
+ *
+ * 这是**非 hook** 版本，供事件回调 / 非组件代码调用（例如 `useAvCanvas` 的
+ * 初始化失败）。它拿不到 React context，因此走 `notify` 注册的默认桥：
+ * `WorkbenchProvider` 挂载时会把 `bridge` 注册进来，宿主实现了 `notify`
+ * 就交给宿主，否则退回库内 toast。
+ */
 export declare function reportError(error: unknown, fallback?: string): void;
 export declare function useToastSafe(): {
     success: (message: string, description?: string) => void;
     error: (message: string, description?: string) => void;
     info: (message: string, description?: string) => void;
+    warning: (message: string, description?: string) => void;
 };