foggy-data-viewer 1.0.1-beta.47 → 1.0.1-beta.49

package/README.md

@@ -1,8 +1,8 @@
 # Foggy Data Viewer
 
-一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
-
-HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerHttp`，在应用挂载前配置动态 `getHeaders` 和 `onUnauthorized`。允许先导入 SDK 再配置，无需 patch Axios，也无需修改 generated 文件。详见 [HTTP 接入与 TMS 迁移指南](./docs/http-auth.md)。
+一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
+
+HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerHttp`，在应用挂载前配置动态 `getHeaders` 和 `onUnauthorized`。允许先导入 SDK 再配置，无需 patch Axios，也无需修改 generated 文件。详见 [HTTP 接入与 TMS 迁移指南](./docs/http-auth.md)。
 
 ## 特性
 
@@ -18,7 +18,7 @@ HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerH
 ## 安装
 
 ```bash
-npm install foggy-data-viewer
+npm install foggy-data-viewer
 # 或
 yarn add foggy-data-viewer
 # 或
@@ -184,7 +184,11 @@ const amountField = {
 />
 ```
 
-后端可通过 `foggy.data-viewer.table-defaults.system/tenants/roles` 配置 fallback；用户默认配置仍可通过 `listPreset` 覆盖。`requiredRuntimeColumns` 只会追加到 `fetchData(params).columns`，不会显示为普通列。
+后端可通过 `foggy.data-viewer.table-defaults.system/tenants/roles` 配置 fallback；用户默认配置仍可通过 `listPreset` 覆盖。
+
+从 `1.0.1-beta.49` 起，`requiredFields` / `requiredRuntimeColumns` 仅声明执行依赖：请求字段为用户选择 U 与依赖 R 的并集。用户主动选择的 U∩R 正常展示、保存并计入 50 字段额度；隐式补入的 R\\U 不自动展示、不保存、不占用户额度。永久隐藏的系统字段应使用独立元数据规则，不能由 required 推断。旧 `internalFields` 额度豁免选项不再生效。
+
+恢复方案中的维度 ID 时，`SelectFilter` 会通过当前 `filterMemberLoader` 主动回填名称，无需打开下拉。成员接口应在 `selectedItems` 返回不在当前分页内的已选成员；回填不改变 DSL 值或触发额外筛选/主表请求。
 
 ### DataTable Events
 

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

@@ -121,10 +121,10 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     "onCheckbox-change"?: (rows: Record<string, unknown>[]) => any;
     "onCheckbox-all"?: (rows: Record<string, unknown>[]) => any;
 }>, {
+    pageSize: number;
     backgroundLoading: boolean;
     backgroundLoadingText: string;
     backgroundLoadingError: string | null;
-    pageSize: number;
     showFilters: boolean;
     showPager: boolean;
     localFilter: boolean;

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

@@ -12,6 +12,10 @@ interface Props {
     schema?: TableSchema;
     /** 数据加载函数 */
     fetchData?: (params: FetchDataParams) => Promise<FetchDataResult>;
+    /** 执行依赖；隐式补入不展示/保存，用户主动选择时正常展示/保存。 */
+    requiredFields?: string[];
+    /** 执行依赖，与 requiredFields 同义，不限制用户选择。 */
+    requiredRuntimeColumns?: string[];
     /** 列配置 */
     columns?: EnhancedColumnSchema[];
     /** 表格数据 */
@@ -102,6 +106,7 @@ declare function resetQueryPanel(): void;
 declare function getListViewState(): ListViewState;
 declare function applyListViewState(state: ListViewState, options?: {
     reload?: boolean;
+    validateLimits?: boolean;
 }): void;
 declare function resetListViewState(options?: {
     reload?: boolean;
@@ -151,6 +156,10 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
         value?: unknown;
         link?: 1 | 2;
         children?: /*elided*/ any[];
+        $or?: /*elided*/ any[];
+        $and?: /*elided*/ any[];
+        $expr?: string;
+        maxDepth?: number;
     }[];
     /** 重置分页 */
     resetPagination: () => void;

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

@@ -18,6 +18,7 @@ export interface UseTableQueryReturn {
     loading: ReturnType<typeof ref<boolean>>;
     activeTrigger: ReturnType<typeof ref<QueryTrigger | null>>;
     lastError: ReturnType<typeof ref<Error | null>>;
+    lastOutcome: ReturnType<typeof ref<'success' | 'cancelled' | 'error' | null>>;
     serverSummary: ReturnType<typeof ref<Record<string, unknown> | null>>;
     currentPage: ReturnType<typeof ref<number>>;
     currentPageSize: ReturnType<typeof ref<number>>;

package/dist/components/list-preset/ListPresetConditionEditor.vue.d.ts

@@ -0,0 +1,24 @@
+import type { ColumnSchema, SliceRequestDef, MemberQueryRequest, MemberQueryResponse } from '@/types';
+interface Props {
+    modelValue?: SliceRequestDef[];
+    columns: ColumnSchema[];
+    maxConditions?: number;
+    showToolbar?: boolean;
+    pathLabel?: string;
+    /** Leaf conditions outside this recursive subtree. */
+    conditionOffset?: number;
+    qmModel?: string;
+    filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
+}
+declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: SliceRequestDef[]) => any;
+}, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: (value: SliceRequestDef[]) => any;
+}>, {
+    modelValue: SliceRequestDef[];
+    maxConditions: number;
+    showToolbar: boolean;
+    pathLabel: string;
+    conditionOffset: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/list-preset/ListPresetManager.vue.d.ts

@@ -1,15 +1,18 @@
-import type { EnhancedColumnSchema, ListPresetConfig, ListPresetDef, ListPresetVisibility, ListViewState } from '@/types';
+import type { EnhancedColumnSchema, ListPresetConfig, ListPresetDef, ListPresetVisibility, ListViewState, MemberQueryRequest, MemberQueryResponse } from '@/types';
 interface Props {
     config: ListPresetConfig;
     getState: () => ListViewState;
     applyState: (state: ListViewState, options?: {
         reload?: boolean;
+        validateLimits?: boolean;
     }) => void;
     reload?: () => void | Promise<void>;
     clearConditions?: () => void | Promise<void>;
     availableColumns?: EnhancedColumnSchema[];
     lockedColumns?: string[];
+    /** @deprecated Execution dependencies belong to the query layer; never filter presets. */
     requiredRuntimeColumns?: string[];
+    filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
     triggerMode?: 'button' | 'none';
 }
 type MoveEdge = 'top' | 'bottom';
@@ -90,6 +93,10 @@ declare const _default: import("vue").DefineComponent<Props, {
                 value?: unknown;
                 link?: 1 | 2;
                 children?: /*elided*/ any[];
+                $or?: /*elided*/ any[];
+                $and?: /*elided*/ any[];
+                $expr?: string;
+                maxDepth?: number;
             }[];
             orderBy: {
                 field: string;

package/dist/index.d.ts

@@ -12,10 +12,12 @@ export { default as PivotGrid } from './components/PivotGrid.vue';
 export { default as PivotAxisPager } from './components/PivotAxisPager.vue';
 export { default as PivotEvidencePanel } from './components/PivotEvidencePanel.vue';
 export { default as ListPresetManager } from './components/list-preset/ListPresetManager.vue';
+export { default as ListPresetConditionEditor } from './components/list-preset/ListPresetConditionEditor.vue';
 export type { QueryFieldSchema, QueryPanelLayoutSchema, QueryPanelExpose, QuerySchema } from './components/QueryPanel.vue';
 export * from './components/filters';
 export * from './components/composables';
 export { buildTableColumns, calculateColumnWidth } from './utils/schemaHelper';
+export { MAX_LIST_PRESET_FIELDS, MAX_LIST_PRESET_CONDITIONS, countConditionLeaves, cloneSliceTree, getConditionFields, getListPresetFieldCount, getListPresetLimitResult, validateListPresetLimits, getUserConfigurableColumns, getDisplayColumnForCondition, getQueryFieldForColumn } from './utils/listPreset';
 export { MONEY_VIEWER, formatViewerValue, getColumnMoneyViewer, resolveMoneyViewer, viewerSlicesToDisplay, viewerSlicesToRaw } from './utils/viewer';
 export { buildPivotGridColumns, flattenPivotLeafNodes, validatePivotHeaderTree } from './utils/pivotHeaderTree';
 export { buildPivotCellField, toPivotViewModel } from './utils/pivotViewModelAdapter';