foggy-data-viewer 1.0.1-beta.39 → 1.0.1-beta.41

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
 
 | 事件名 | 参数 | 说明 |

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/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, SearchHooks } 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 组件
@@ -63,8 +63,16 @@ interface Props {
     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;
     /** 自定义列表配置 */
@@ -86,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;
@@ -95,6 +106,9 @@ declare function applyListViewState(state: ListViewState, options?: {
 declare function resetListViewState(options?: {
     reload?: boolean;
 }): void;
+declare function clearAllFilterState(options?: {
+    suppressControlEvents?: boolean;
+}): void;
 declare var __VLS_28: {}, __VLS_33: {}, __VLS_38: {}, __VLS_40: {}, __VLS_42: {
     row: Record<string, unknown>;
     column: EnhancedColumnSchema;
@@ -129,7 +143,7 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     /** 重置 QueryPanel 并刷新筛选 */
     resetQueryPanel: typeof resetQueryPanel;
     /** 清空所有筛选 */
-    clearAllFilters: () => void;
+    clearAllFilters: typeof clearAllFilterState;
     /** 获取合并后的筛选条件 */
     getMergedFilters: () => {
         field: string;
@@ -168,6 +182,8 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     getListViewState: typeof getListViewState;
     /** 应用列表视图状态（用于加载自定义列表） */
     applyListViewState: typeof applyListViewState;
+    /** 应用表格实例默认查询配置 */
+    applyTableDefaultQueryConfig: typeof applyTableDefaultQueryConfig;
     /** 重置列表视图状态 */
     resetListViewState: typeof resetListViewState;
     /** 获取当前查询状态（用于保存查询） */

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/components/list-preset/ListPresetManager.vue.d.ts

@@ -2,10 +2,16 @@ import type { EnhancedColumnSchema, ListPresetConfig, ListPresetDef, ListPresetV
 interface Props {
     config: ListPresetConfig;
     getState: () => ListViewState;
-    applyState: (state: ListViewState) => void;
+    applyState: (state: ListViewState, options?: {
+        reload?: boolean;
+    }) => void;
     reload?: () => void | Promise<void>;
+    clearConditions?: () => void | Promise<void>;
     availableColumns?: EnhancedColumnSchema[];
+    lockedColumns?: string[];
+    requiredRuntimeColumns?: string[];
 }
+type MoveEdge = 'top' | 'bottom';
 declare const form: import("vue").Ref<{
     title: string;
     description: string;
@@ -27,16 +33,24 @@ declare const form: import("vue").Ref<{
 }>;
 declare function openDialog(): void;
 declare function syncColumnDraftFromState(): void;
+declare function moveVisibleColumn(index: number, direction: -1 | 1): void;
+declare function moveVisibleColumnToEdge(index: number, edge: MoveEdge): void;
+declare function moveColumn(index: number, direction: -1 | 1): void;
 declare function loadPresets(): Promise<void>;
 declare function applyPreset(preset: ListPresetDef): Promise<void>;
 declare function startEditPreset(preset: ListPresetDef): void;
 declare function cancelEdit(): void;
 declare function saveCurrentPreset(): Promise<void>;
 declare function overwritePreset(preset: ListPresetDef): Promise<void>;
+declare function clearCurrentConditions(): Promise<void>;
 declare const _default: import("vue").DefineComponent<Props, {
     applyPreset: typeof applyPreset;
     cancelEdit: typeof cancelEdit;
+    clearCurrentConditions: typeof clearCurrentConditions;
     loadPresets: typeof loadPresets;
+    moveColumn: typeof moveColumn;
+    moveVisibleColumn: typeof moveVisibleColumn;
+    moveVisibleColumnToEdge: typeof moveVisibleColumnToEdge;
     openDialog: typeof openDialog;
     overwritePreset: typeof overwritePreset;
     saveCurrentPreset: typeof saveCurrentPreset;
@@ -93,6 +107,7 @@ declare const _default: import("vue").DefineComponent<Props, {
     getColumnDraft: () => {
         name: string;
         title?: string;
+        type?: string;
         visible: boolean;
         width?: number;
         minWidth?: number;

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, 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, 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';