@bit-sun/business-component 4.2.0-alpha.31-wyl → 4.2.0-alpha.32-wyl

package/dist/components/Business/BsSulaQueryTable/clipboard.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 写文本到剪贴板。
+ * 1）优先用异步 Clipboard API：不依赖 execCommand 的焦点/可见性限制，也不抢焦点；
+ * 2）非安全上下文或旧内核退回 execCommand：临时 textarea 真正移出视口，用完立即移除
+ *    （避免"每次复制在 body 残留节点、并把键盘焦点留在残留节点上，之后按 Ctrl+C 复制到旧内容"）。
+ * 返回是否写入成功；失败时调用方应保留选区并提示用户用 Ctrl+C 重试。
+ */
+export declare const writeClipboard: (text: string) => Promise<boolean>;

package/dist/components/Business/BsSulaQueryTable/rangeCopy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 表格「框选复制」的纯逻辑：单元格取值 → TSV，以及要排除的列判定。
+ * 零依赖、不碰 React，便于用 jsdom 做单测（见 __tests__/rangeCopy.test.ts）。
+ */
+export declare const DATA_ROW_SELECTOR = "tr.ant-table-row";
+export interface RangeCopyResult {
+    /** 制表符分隔的文本，行间以 \r\n 分隔 */
+    text: string;
+    rowCount: number;
+    colCount: number;
+}
+/** 选区里真正会被复制的列（按列序）；勾选列/操作列等被排除的列不占位 */
+export declare const getIncludedCols: (colStart: number, colEnd: number, excludeCols?: Set<number>) => number[];
+export declare const buildRangeCopy: (rows: HTMLTableRowElement[], colStart: number, colEnd: number, excludeCols?: Set<number>) => RangeCopyResult;
+/**
+ * 判定要排除的列下标：勾选列始终排除，另外按表头文本排除（默认由调用方传入「操作」）。
+ * 用表头最后一行（叶子表头）定位，因此用户隐藏/调整列序后依然按当前渲染结果生效；
+ * 表头缺失时退化为用数据行找勾选列。
+ */
+export declare const resolveExcludeCols: (tbody: HTMLTableSectionElement, titles: string[]) => Set<number>;

package/dist/components/Business/BsSulaQueryTable/useRangeCopy.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="react" />
+import './rangeCopy.less';
+export interface UseRangeCopyOptions {
+    /** 是否启用（默认 true）。虚拟滚动表只渲染可视行、DOM 取不到整段选区，应传 false */
+    enabled?: boolean;
+    /** 按表头文本排除的列，默认排除「操作」列；勾选列始终排除 */
+    excludeTitles?: string[];
+    /** 框选结束是否自动写入剪贴板（默认 true）；false 时仍支持框选后 Ctrl+C */
+    autoCopy?: boolean;
+}
+/**
+ * 表格「Excel 式框选复制」。返回容器 ref，挂到表格容器上即可（BsSulaQueryTable 挂在 #bs-sula-query-table）。
+ * 实现要点：事件委托 + 单个挂进滚动容器的高亮层（随内容滚动，不依赖 scroll 事件补帧），
+ * 全程只用 ref、不改表格内任何单元格、不触发 React 重渲染。
+ */
+export declare const useRangeCopy: (options?: UseRangeCopyOptions) => import("react").RefObject<HTMLDivElement>;