foggy-data-viewer 1.0.1-beta.38 → 1.0.1-beta.40

package/README.md

@@ -149,6 +149,20 @@ function handlePageChange(page: number, pageSize: number) {
 
 `DataTableWithSearch` 在 `schema + fetchData` 服务端查询模式下默认 `localFilter=false`：列头筛选仍会提交给 `fetchData`，但返回数据不会再被前端二次过滤，避免聚合字段、派生字段、字典展示字段被简单本地比较误删。需要纯前端过滤时，可显式设置 `localFilter=true` 或 `schema.localFilter=true`。
 
+### DataTableWithSearch tableInstanceId 默认查询配置
+
+`schema + fetchData` 模式支持按 `tableInstanceId` 加载默认查询配置。默认查询配置只负责默认展示列、排序、分页和筛选；`requiredRuntimeColumns`、`lockedColumns` 由 TM/QM 产出的 `TableSchema` 提供。
+
+```vue
+<DataTableWithSearch
+  :schema="{ ...tableSchema, qmModel: 'TicketQueryModel', tableInstanceId: 'ticket-list' }"
+  :fetch-data="fetchTickets"
+  :default-query-config-scope="{ userId: currentUser.id, tenantId: currentTenant.id, roleIds: currentRoleIds }"
+/>
+```
+
+后端可通过 `foggy.data-viewer.table-defaults.system/tenants/roles` 配置 fallback；用户默认配置仍可通过 `listPreset` 覆盖。`requiredRuntimeColumns` 只会追加到 `fetchData(params).columns`，不会显示为普通列。
+
 ### DataTable Events
 
 | 事件名 | 参数 | 说明 |
@@ -256,6 +270,66 @@ const columns = buildTableColumns(qmSchema, {
 
 选择原则：需要绑定业务事件时优先用 `column-*` 插槽；只改显示内容时使用 `render` 更轻。
 
+### 全局列渲染器（应用级统一增强）
+
+业务系统可以在应用启动时注册 `globalColumnRenderers`，按列元数据统一增强单元格展示。生成的 QueryTable wrapper 不需要批量修改。
+
+```typescript
+import { h } from 'vue'
+import { globalColumnRenderers } from 'foggy-data-viewer'
+
+const dispose = globalColumnRenderers.add({
+  id: 'app.orderNoLink',
+  priority: 100,
+  match: ({ column }) => column.name === 'orderNo' && /运单号/.test(column.title ?? ''),
+  render: ({ value }) => {
+    const text = String(value ?? '').trim()
+    if (!text) return '-'
+    return h('button', {
+      type: 'button',
+      class: 'data-viewer-link-cell',
+      onClick: (event: MouseEvent) => {
+        event.stopPropagation()
+        // 在业务应用闭包里调用 router.push(...)
+      }
+    }, text)
+  }
+})
+
+// 应用卸载或测试清理
+dispose()
+```
+
+渲染优先级固定为：`column-*` 插槽 > `column.customRender` > `globalColumnRenderers` > 默认渲染/字典/formatter。列级退出可设置 `column.uiConfig.disableGlobalRender = true`。
+
+### 全局搜索生命周期 Hook
+
+`globalSearchHooks` 作用于搜索动作层，早于最终 `fetchData` 和 `globalQueryHooks.onBeforeQuery`。它可以区分搜索来源和触发原因，适合埋点、默认条件补充和无效查询拦截。
+
+```typescript
+import { globalSearchHooks } from 'foggy-data-viewer'
+
+globalSearchHooks.register({
+  beforeSearch: (ctx) => {
+    if (ctx.trigger === 'search' && ctx.slice.length === 0) return false
+    return {
+      slice: [
+        ...ctx.slice,
+        { field: 'tenantId', op: '=', value: currentTenantId }
+      ]
+    }
+  },
+  afterSearch: (ctx, result) => {
+    console.log(ctx.source, ctx.trigger, result.total)
+  },
+  searchError: (ctx, error) => {
+    console.warn(ctx.source, ctx.trigger, error)
+  }
+})
+```
+
+`ctx.source` 为 `search-toolbar | query-panel | column-filter | external | api`，`ctx.trigger` 为 `search | reset | filter | sort | page | refresh | reload | mount`。
+
 ## 类型定义
 
 ```typescript

package/dist/api/listPreset.d.ts

@@ -3,6 +3,7 @@ export interface ListPresetScope {
     userId: string;
     model: string;
     businessKey?: string;
+    tableInstanceId?: string;
 }
 export interface SaveListPresetRequest {
     title: string;

package/dist/api/tableDefaultQueryConfig.d.ts

@@ -0,0 +1,2 @@
+import type { TableDefaultQueryConfig, TableDefaultQueryConfigScope } from '@/types';
+export declare function getTableDefaultQueryConfig(scope: TableDefaultQueryConfigScope): Promise<TableDefaultQueryConfig | null>;

package/dist/components/DataTable.vue.d.ts

@@ -1,5 +1,5 @@
 import type { VxeGridInstance } from 'vxe-table';
-import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, CellCopyConfig, MemberQueryRequest, MemberQueryResponse, TableDensity } from '@/types';
+import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, CellCopyConfig, MemberQueryRequest, MemberQueryResponse, TableDensity, TableSchema } from '@/types';
 /**
  * DataTable 组件属性
  *
@@ -44,6 +44,8 @@ interface Props {
     filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
     /** QM 模型名称（远程成员加载所需） */
     qmModel?: string;
+    /** 表格 Schema 元数据（全局列渲染器上下文使用） */
+    tableSchema?: TableSchema;
     /** 自定义过滤器组件映射 */
     customFilterComponents?: Record<string, unknown>;
     /** 普通单元格悬浮复制配置 */

package/dist/components/DataTableWithSearch.vue.d.ts

@@ -1,4 +1,4 @@
-import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, TableSchema, FetchDataParams, FetchDataResult, OrderRequestDef, QueryHooks, MemberQueryRequest, MemberQueryResponse, CellCopyConfig, QueryMode, ListViewState, ListPresetConfig, TableDensity } from '@/types';
+import type { EnhancedColumnSchema, SliceRequestDef, FilterOption, TableSchema, FetchDataParams, FetchDataResult, OrderRequestDef, QueryHooks, MemberQueryRequest, MemberQueryResponse, CellCopyConfig, QueryMode, ListViewState, ListPresetConfig, TableDensity, SearchHooks, TableDefaultQueryConfig, TableDefaultQueryConfigScope, TableDefaultQueryConfigLoadOptions } from '@/types';
 import type { QueryPanelExpose, QuerySchema } from './QueryPanel.vue';
 /**
  * DataTableWithSearch 组件
@@ -55,14 +55,24 @@ interface Props {
     filterMergeMode?: 'replace' | 'merge';
     /** 查询钩子（声明式） */
     queryHooks?: QueryHooks;
+    /** 搜索动作层钩子（声明式） */
+    searchHooks?: SearchHooks;
     /** 查询 Schema（传统查询区定义） */
     querySchema?: QuerySchema;
     /** 是否显示传统查询区 */
     showQueryPanel?: boolean;
     /** QM 模型名称（远程成员加载所需） */
     qmModel?: string;
+    /** 同一 QM 下的业务表格实例标识 */
+    tableInstanceId?: string;
     /** 远程维度成员加载器 */
     filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
+    /** 已解析的表格实例默认查询配置 */
+    defaultQueryConfig?: TableDefaultQueryConfig | null;
+    /** 默认查询配置自动加载作用域 */
+    defaultQueryConfigScope?: TableDefaultQueryConfigLoadOptions;
+    /** 自定义默认查询配置加载器 */
+    defaultQueryConfigLoader?: (scope: TableDefaultQueryConfigScope) => Promise<TableDefaultQueryConfig | null>;
     /** 启用保存查询功能 */
     enableSavedQuery?: boolean;
     /** 自定义列表配置 */
@@ -84,6 +94,9 @@ interface DataTableExpose {
     clearSelection: (options?: ClearSelectionOptions) => void;
 }
 declare function clearSelectionState(options?: ClearSelectionOptions): void;
+declare function applyTableDefaultQueryConfig(config: TableDefaultQueryConfig, options?: {
+    reload?: boolean;
+}): void;
 declare function searchQueryPanel(): void;
 declare function resetQueryPanel(): void;
 declare function getListViewState(): ListViewState;
@@ -166,6 +179,8 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     getListViewState: typeof getListViewState;
     /** 应用列表视图状态（用于加载自定义列表） */
     applyListViewState: typeof applyListViewState;
+    /** 应用表格实例默认查询配置 */
+    applyTableDefaultQueryConfig: typeof applyTableDefaultQueryConfig;
     /** 重置列表视图状态 */
     resetListViewState: typeof resetListViewState;
     /** 获取当前查询状态（用于保存查询） */

package/dist/components/QueryPanel.vue.d.ts

@@ -65,12 +65,12 @@ declare const _default: import("vue").DefineComponent<Props, {
     reset: typeof handleReset;
     getSlices: () => SliceRequestDef[];
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:modelValue": (value: SliceRequestDef[]) => any;
     search: () => any;
     reset: () => any;
+    "update:modelValue": (value: SliceRequestDef[]) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    "onUpdate:modelValue"?: (value: SliceRequestDef[]) => any;
     onSearch?: () => any;
     onReset?: () => any;
+    "onUpdate:modelValue"?: (value: SliceRequestDef[]) => any;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/SearchToolbar.vue.d.ts

@@ -33,13 +33,13 @@ declare const _default: import("vue").DefineComponent<Props, {
     /** 获取当前筛选条件 */
     getFilters: () => SliceRequestDef[];
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    "update:modelValue": (value: SliceRequestDef[]) => any;
     search: () => any;
     reset: () => any;
+    "update:modelValue": (value: SliceRequestDef[]) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
-    "onUpdate:modelValue"?: (value: SliceRequestDef[]) => any;
     onSearch?: () => any;
     onReset?: () => any;
+    "onUpdate:modelValue"?: (value: SliceRequestDef[]) => any;
 }>, {
     layout: "horizontal" | "vertical";
     showActions: boolean;

package/dist/components/composables/globalColumnRenderers.d.ts

@@ -0,0 +1,16 @@
+import type { GlobalColumnRenderContext, GlobalColumnRenderResolution, GlobalColumnRenderer } from '@/types';
+/**
+ * Global column renderer registry.
+ *
+ * Host applications register business-specific renderers once at startup.
+ * DataTable keeps page-level slots and customRender ahead of this registry.
+ */
+export declare const globalColumnRenderers: {
+    add(renderer: GlobalColumnRenderer): () => void;
+    register(renderers: GlobalColumnRenderer | GlobalColumnRenderer[]): () => void;
+    remove(id: string): void;
+    clear(): void;
+    list(): GlobalColumnRenderer[];
+    resolve(ctx: GlobalColumnRenderContext): GlobalColumnRenderer | undefined;
+    render(ctx: GlobalColumnRenderContext): GlobalColumnRenderResolution | undefined;
+};

package/dist/components/composables/globalSearchHooks.d.ts

@@ -0,0 +1,21 @@
+import type { AfterSearchHookFn, BeforeSearchHookFn, ErrorSearchHookFn, SearchHookName, SearchHooks } from '@/types';
+import { SearchHookRegistry } from './searchHookRegistry';
+type SearchHookFnMap = {
+    beforeSearch: BeforeSearchHookFn;
+    afterSearch: AfterSearchHookFn;
+    searchError: ErrorSearchHookFn;
+};
+/**
+ * Global search lifecycle hooks.
+ *
+ * These hooks run at the DataTableWithSearch action layer, before the final
+ * fetch/query lifecycle handled by globalQueryHooks.
+ */
+export declare const globalSearchHooks: {
+    add<N extends SearchHookName>(name: N, fn: SearchHookFnMap[N]): () => void;
+    remove<N extends SearchHookName>(name: N, fn: SearchHookFnMap[N]): void;
+    register(hooks: SearchHooks): () => void;
+    clear(): void;
+    _getRegistry(): SearchHookRegistry;
+};
+export {};

package/dist/components/composables/index.d.ts

@@ -6,5 +6,8 @@ export { useDeferredVisibility } from './useDeferredVisibility';
 export type { DeferredVisibilityOptions, DeferredVisibilityState } from './useDeferredVisibility';
 export { HookRegistry } from './hookRegistry';
 export { globalQueryHooks } from './globalQueryHooks';
+export { globalColumnRenderers } from './globalColumnRenderers';
+export { SearchHookRegistry } from './searchHookRegistry';
+export { globalSearchHooks } from './globalSearchHooks';
 export { useQueryState } from './useQueryState';
 export type { UseQueryStateReturn } from './useQueryState';

package/dist/components/composables/searchHookRegistry.d.ts

@@ -0,0 +1,19 @@
+import type { AfterSearchHookFn, BeforeSearchHookFn, ErrorSearchHookFn, FetchDataResult, SearchHookContext, SearchHookName, SearchHooks } from '@/types';
+type SearchHookFnMap = {
+    beforeSearch: BeforeSearchHookFn;
+    afterSearch: AfterSearchHookFn;
+    searchError: ErrorSearchHookFn;
+};
+export declare class SearchHookRegistry {
+    private hooks;
+    add<N extends SearchHookName>(name: N, fn: SearchHookFnMap[N]): () => void;
+    remove<N extends SearchHookName>(name: N, fn: SearchHookFnMap[N]): void;
+    register(hooks: SearchHooks): () => void;
+    removeRegistered(hooks: SearchHooks): void;
+    size(name: SearchHookName): number;
+    clear(): void;
+    runBefore(ctx: SearchHookContext): Promise<void | false>;
+    runAfter(ctx: SearchHookContext, result: FetchDataResult): Promise<void>;
+    runError(ctx: SearchHookContext, error: Error): Promise<boolean>;
+}
+export {};

package/dist/components/composables/useTableQuery.d.ts

@@ -24,6 +24,7 @@ export interface UseTableQueryReturn {
     currentOrderBy: ReturnType<typeof ref<OrderRequestDef[]>>;
     currentSlice: ReturnType<typeof ref<SliceRequestDef[]>>;
     currentColumns: ReturnType<typeof ref<string[]>>;
+    currentTableInstanceId: ReturnType<typeof ref<string | undefined>>;
     loadData: (trigger?: QueryTrigger) => Promise<void>;
     refresh: () => Promise<void>;
     reload: () => Promise<void>;
@@ -31,6 +32,7 @@ export interface UseTableQueryReturn {
     setSort: (orderBy: OrderRequestDef[]) => void;
     setSlice: (slice: SliceRequestDef[]) => void;
     setColumns: (columns: string[]) => void;
+    setTableInstanceId: (tableInstanceId?: string) => void;
     addHook: <N extends QueryHookName>(name: N, fn: HookFnMap[N]) => () => void;
     removeHook: <N extends QueryHookName>(name: N, fn: HookFnMap[N]) => void;
 }

package/dist/index.d.ts

@@ -26,4 +26,5 @@ export { saveQuery, listSavedQueries, getSavedQuery, updateSavedQuery, deleteSav
 export type { SavedQueryDef, SaveQueryRequest, QueryVisibility } from './api/savedQuery';
 export { listPresets, getDefaultListPreset, createListPreset, getListPreset, updateListPreset, deleteListPreset, setDefaultListPreset, clearDefaultListPreset } from './api/listPreset';
 export type { ListPresetScope, SaveListPresetRequest, UpdateListPresetRequest } from './api/listPreset';
-export type { ColumnSchema, EnhancedColumnSchema, TableConfig, TableSchema, CellRenderContext, CellRenderFn, CellCopyConfig, QueryMode, ColumnCustomization, QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, SliceRequestDef, OrderRequestDef, FilterOption, FetchDataParams, FetchDataResult, FetchDataFn, DictItem, PaginationState, SortState, QueryHooks, QueryHookContext, QueryTrigger, QueryHookName, BeforeQueryHookFn, AfterQueryHookFn, ErrorQueryHookFn, MaybePromise, PivotAxisField, PivotAxisPage, PivotAxisPageScope, PivotAxisRole, PivotHeaderNode, PivotHeaderRole, PivotMetric, PivotRawAxisMember, PivotRawCell, PivotRawPayload, PivotShape, PivotViewMode, PivotViewModel, ListPresetVisibility, ListPresetPlacement, ListPresetConfig, ColumnViewSetting, QueryConditionPreset, ListViewState, ListPresetDef, FrontendMeta, FieldMeta, FieldCategory, MemberLookupMeta, UiHintsMeta, DefaultsMeta, CapabilitiesMeta, ParamsMeta, MemberQueryRequest, MemberOption, MemberQueryResponse } from './types';
+export { getTableDefaultQueryConfig } from './api/tableDefaultQueryConfig';
+export type { ColumnSchema, EnhancedColumnSchema, TableConfig, TableSchema, CellRenderContext, CellRenderFn, GlobalColumnRenderContext, GlobalColumnMatchFn, GlobalColumnRenderFn, GlobalColumnRenderer, GlobalColumnRenderResolution, CellCopyConfig, QueryMode, ColumnCustomization, QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, SliceRequestDef, OrderRequestDef, FilterOption, FetchDataParams, FetchDataResult, FetchDataFn, DictItem, PaginationState, SortState, QueryHooks, QueryHookContext, QueryTrigger, QueryHookName, BeforeQueryHookFn, AfterQueryHookFn, ErrorQueryHookFn, SearchSource, SearchTrigger, SearchHookContext, SearchHookUpdate, SearchHookName, BeforeSearchHookFn, AfterSearchHookFn, ErrorSearchHookFn, SearchHooks, MaybePromise, PivotAxisField, PivotAxisPage, PivotAxisPageScope, PivotAxisRole, PivotHeaderNode, PivotHeaderRole, PivotMetric, PivotRawAxisMember, PivotRawCell, PivotRawPayload, PivotShape, PivotViewMode, PivotViewModel, ListPresetVisibility, ListPresetPlacement, ListPresetConfig, TableDefaultQueryConfig, TableDefaultQueryConfigScope, TableDefaultQueryConfigLoadOptions, TableDefaultQueryConfigSource, ColumnViewSetting, QueryConditionPreset, ListViewState, ListPresetDef, FrontendMeta, FieldMeta, FieldCategory, MemberLookupMeta, UiHintsMeta, DefaultsMeta, CapabilitiesMeta, ParamsMeta, MemberQueryRequest, MemberOption, MemberQueryResponse } from './types';