rj-grid 0.2.2 → 0.2.4

package/dist/types/src/RjGrid.vue.d.ts

@@ -46,9 +46,16 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel?: boolean | undefined;
     chartable?: boolean | undefined;
     exportable?: boolean | undefined;
+    /** 工具栏各导出/打印按钮单独显隐（仅在 exportable 为真时生效）；默认全 true，可按需关掉其中任意几个 */
+    showPrint?: boolean | undefined;
+    showCsv?: boolean | undefined;
+    showPdf?: boolean | undefined;
+    showExcel?: boolean | undefined;
     colReorder?: boolean | undefined;
     resizable?: boolean | undefined;
     rowSelection?: false | "multiple" | "single" | undefined;
+    /** 单击数据行单元格即选中该行（替换式，无需再点复选框）；按住 Ctrl/Shift/Alt 仍走区域选择，复选框保留多选，双击仍编辑。默认 true */
+    selectOnCellClick?: boolean | undefined;
     keepSelectionCrossPage?: boolean | undefined;
     editable?: boolean | undefined;
     rangeSelection?: boolean | undefined;
@@ -96,6 +103,12 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
      */
     serverExport?: ((params: RjServerExportParams) => void | Promise<void>) | undefined;
     exportFileName?: string | undefined;
+    /**
+     * 打印 / PDF 单次最大行数护栏：浏览器打印靠把整表排版进隐藏 iframe，
+     * 上万行会生成十几 MB HTML 并让主线程卡死（页面假死）。超过此上限只打印前 N 行并提示，
+     * 需全量请先筛选 / 用分页 / 走后端导出，或按宿主机器性能调大本值。置 0 或负数则不限。
+     */
+    printMaxRows?: number | undefined;
     /** 导出取值口径：默认导出「所见即所得」的格式化文本（与屏幕一致、单文件内口径统一）；
      *  置 true 则导出原始类型值，让 Excel 里数字仍是数字（对齐 AG Grid useCellValuesForExports） */
     exportRawValues?: boolean | undefined;
@@ -151,9 +164,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: boolean;
+    selectOnCellClick: boolean;
     editable: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
@@ -182,6 +200,7 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     copyHeadersToClipboard: boolean;
     markDirtyCells: boolean;
     rowHover: boolean;
+    printMaxRows: number;
     queryable: boolean;
     viewable: boolean;
     queryFields: () => never[];
@@ -253,9 +272,16 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel?: boolean | undefined;
     chartable?: boolean | undefined;
     exportable?: boolean | undefined;
+    /** 工具栏各导出/打印按钮单独显隐（仅在 exportable 为真时生效）；默认全 true，可按需关掉其中任意几个 */
+    showPrint?: boolean | undefined;
+    showCsv?: boolean | undefined;
+    showPdf?: boolean | undefined;
+    showExcel?: boolean | undefined;
     colReorder?: boolean | undefined;
     resizable?: boolean | undefined;
     rowSelection?: false | "multiple" | "single" | undefined;
+    /** 单击数据行单元格即选中该行（替换式，无需再点复选框）；按住 Ctrl/Shift/Alt 仍走区域选择，复选框保留多选，双击仍编辑。默认 true */
+    selectOnCellClick?: boolean | undefined;
     keepSelectionCrossPage?: boolean | undefined;
     editable?: boolean | undefined;
     rangeSelection?: boolean | undefined;
@@ -303,6 +329,12 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
      */
     serverExport?: ((params: RjServerExportParams) => void | Promise<void>) | undefined;
     exportFileName?: string | undefined;
+    /**
+     * 打印 / PDF 单次最大行数护栏：浏览器打印靠把整表排版进隐藏 iframe，
+     * 上万行会生成十几 MB HTML 并让主线程卡死（页面假死）。超过此上限只打印前 N 行并提示，
+     * 需全量请先筛选 / 用分页 / 走后端导出，或按宿主机器性能调大本值。置 0 或负数则不限。
+     */
+    printMaxRows?: number | undefined;
     /** 导出取值口径：默认导出「所见即所得」的格式化文本（与屏幕一致、单文件内口径统一）；
      *  置 true 则导出原始类型值，让 Excel 里数字仍是数字（对齐 AG Grid useCellValuesForExports） */
     exportRawValues?: boolean | undefined;
@@ -358,9 +390,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: boolean;
+    selectOnCellClick: boolean;
     editable: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
@@ -389,6 +426,7 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     copyHeadersToClipboard: boolean;
     markDirtyCells: boolean;
     rowHover: boolean;
+    printMaxRows: number;
     queryable: boolean;
     viewable: boolean;
     queryFields: () => never[];
@@ -451,9 +489,14 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     showGroupPanel: boolean;
     chartable: boolean;
     exportable: boolean;
+    showPrint: boolean;
+    showCsv: boolean;
+    showPdf: boolean;
+    showExcel: boolean;
     colReorder: boolean;
     resizable: boolean;
     rowSelection: false | "multiple" | "single";
+    selectOnCellClick: boolean;
     rangeSelection: boolean;
     clipboard: boolean;
     contextMenu: boolean | ((ctx: any) => RjMenuItem[]);
@@ -472,6 +515,7 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     detailHeight: number;
     fullWidthHeight: number;
     exportRange: "auto" | RjExportScopeResolved;
+    printMaxRows: number;
     statusBar: boolean;
     statusAggregations: ("sum" | "avg" | "min" | "max" | "count")[];
     undoRedoCellEditing: boolean;
@@ -594,6 +638,8 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
             autoSizeColumn: (colId: string) => void;
             autoSizeAll: () => void;
             sizeColumnsToFit: () => void;
+            /** 清除宽度覆盖：把列宽还原到列定义/内容自适应默认值（配合 autoSizeAll 做「自适应↔还原」切换） */
+            resetColumnWidths: () => void;
             setTheme: (params: RjThemeParams) => void;
             getTheme: () => {
                 preset?: "legacy" | "alpine" | "quartz" | "material" | undefined;
@@ -728,6 +774,8 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
             autoSizeColumn: (colId: string) => void;
             autoSizeAll: () => void;
             sizeColumnsToFit: () => void;
+            /** 清除宽度覆盖：把列宽还原到列定义/内容自适应默认值（配合 autoSizeAll 做「自适应↔还原」切换） */
+            resetColumnWidths: () => void;
             setTheme: (params: RjThemeParams) => void;
             getTheme: () => {
                 preset?: "legacy" | "alpine" | "quartz" | "material" | undefined;
@@ -866,6 +914,8 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
             autoSizeColumn: (colId: string) => void;
             autoSizeAll: () => void;
             sizeColumnsToFit: () => void;
+            /** 清除宽度覆盖：把列宽还原到列定义/内容自适应默认值（配合 autoSizeAll 做「自适应↔还原」切换） */
+            resetColumnWidths: () => void;
             setTheme: (params: RjThemeParams) => void;
             getTheme: () => {
                 preset?: "legacy" | "alpine" | "quartz" | "material" | undefined;
@@ -1001,6 +1051,8 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
             autoSizeColumn: (colId: string) => void;
             autoSizeAll: () => void;
             sizeColumnsToFit: () => void;
+            /** 清除宽度覆盖：把列宽还原到列定义/内容自适应默认值（配合 autoSizeAll 做「自适应↔还原」切换） */
+            resetColumnWidths: () => void;
             setTheme: (params: RjThemeParams) => void;
             getTheme: () => {
                 preset?: "legacy" | "alpine" | "quartz" | "material" | undefined;

package/dist/types/src/nlq.d.ts

@@ -1,4 +1,5 @@
 import type { RjFilterModel, RjSortState } from './types';
+import type { RjLang } from './locale';
 export type RjNlqFilterType = 'text' | 'number' | 'date' | 'select';
 /** 参与解析的列描述（由网格从列定义构建） */
 export interface RjNlqColumn {
@@ -39,13 +40,20 @@ export interface RjNlqResult {
         model: RjFilterModel;
     }[];
     sort?: RjSortState;
+    /** 排序列展示名（title，供 explainNLQ 本地化回显） */
+    sortTitle?: string;
     groupBy?: string;
     groupColId?: string;
+    /** 分组列展示名（title，供 explainNLQ 本地化回显） */
+    groupTitle?: string;
     limit?: number;
     search?: string;
     clauses: RjNlqClause[];
 }
 /** 解析自然语言查询 */
 export declare function parseNLQ(text: string, columns: RjNlqColumn[]): RjNlqResult;
-/** 生成人类可读的解析摘要（供 UI 回显，key 交由上层 i18n；此处给结构串） */
-export declare function explainNLQ(r: RjNlqResult): string;
+/**
+ * 生成人类可读的解析摘要（供 UI 回显）。传 lang 则随语言本地化：
+ * 中文如「数量 > 100 · 按金额 降序 · 前5 · 搜索“轴承”」，英文如「qty > 100 · sort by amount desc · top 5 · search "bolt"」。
+ */
+export declare function explainNLQ(r: RjNlqResult, lang?: RjLang): string;

package/dist/types/src/types.d.ts

@@ -630,6 +630,8 @@ export interface RjGridApi extends ComponentPublicInstance {
     autoSizeAll: () => void;
     /** 列宽：按视口宽度等比缩放普通区列（对标 sizeColumnsToFit） */
     sizeColumnsToFit: () => void;
+    /** 清除全部列宽覆盖，还原到列定义/内容自适应默认宽（与 autoSizeAll 配合做自适应↔还原切换） */
+    resetColumnWidths: () => void;
     /** 主题引擎（对标 AG Grid Theming）：运行时替换预设/明暗/强调色等 */
     setTheme: (params: RjThemeParams) => void;
     /** 读取当前生效的主题参数 */

package/dist/types/src/useColumnState.d.ts

@@ -60,6 +60,7 @@ export declare function useColumnState(sourceColumns: () => RjColumn[]): {
     setAutoWidth: (colId: string, width: number) => void;
     hasSizedWidth: (colId: string) => boolean;
     sizeToFit: () => void;
+    clearWidths: () => void;
     moveColumn: (dragId: string, targetId: string) => void;
     togglePin: (colId: string, pin: 'left' | 'right' | null) => void;
     toggleHide: (colId: string, hide?: boolean) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rj-grid",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "零第三方依赖的自研 Vue3 虚拟表格：虚拟滚动 / 冻结列 / 行拖拽 / 分组透视 / 公式 / SSRM / 主题 i18n / 自然语言查询",
   "type": "module",
   "license": "MIT",
@@ -46,6 +46,7 @@
     }
   },
   "scripts": {
+    "start": "vite --config vite.playground.config.ts",
     "dev": "vite --config vite.playground.config.ts",
     "build:play": "vite build --config vite.playground.config.ts",
     "preview:play": "vite preview --config vite.playground.config.ts",
@@ -55,6 +56,8 @@
     "lint": "eslint --fix --ext .ts,.vue index.ts src __tests__ playground && stylelint \"src/styles/*.scss\"",
     "ts": "node --max_old_space_size=8192 ./node_modules/vue-tsc/bin/vue-tsc.js --noEmit -p tsconfig.json",
     "size": "node ./node_modules/vite/bin/vite.js build --config vite.size.config.ts && node build/rjSizeReport.mjs",
+    "publish:github": "node scripts/publish-github.mjs",
+    "publish:github:push": "node scripts/publish-github.mjs --push",
     "prepublishOnly": "pnpm build && pnpm test"
   },
   "keywords": [