foggy-data-viewer 1.0.1-beta.46 → 1.0.1-beta.48

package/README.md

@@ -2,6 +2,8 @@
 
 一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
 
+HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerHttp`，在应用挂载前配置动态 `getHeaders` 和 `onUnauthorized`。允许先导入 SDK 再配置，无需 patch Axios，也无需修改 generated 文件。详见 [HTTP 接入与 TMS 迁移指南](./docs/http-auth.md)。
+
 ## 特性
 
 - 🎯 **TypeScript 支持** - 完整的类型定义
@@ -16,7 +18,7 @@
 ## 安装
 
 ```bash
-npm install foggy-data-viewer
+npm install foggy-data-viewer
 # 或
 yarn add foggy-data-viewer
 # 或
@@ -99,31 +101,31 @@ function handlePageChange(page: number, pageSize: number) {
     :loading="false"
     @page-change="handlePageChange"
   />
-</template>
-```
-
-### 3. 展示“分”为“元”的金额字段
-
-金额单位必须由字段元数据显式声明；组件不会根据字段名、`MONEY` 类型或
-`semanticScaleFactor` 推断。模型定义可直接复用公共导出：
-
-```typescript
-import { MONEY_VIEWER } from 'foggy-data-viewer'
-
-const amountField = {
-  name: 'amount',
-  type: 'MONEY',
-  extData: {
-    viewer: MONEY_VIEWER
-  }
-}
-```
-
-此配置会把原始值 `3400` 展示为 `34.00`，并把筛选输入的 `34` 精确换算为
-提交给查询端的 `3400`。行数据、服务端汇总数据和排序值始终保持原始“分”值；
-已经返回“元”的字段不要配置 `MONEY_VIEWER`。
-
-## 组件列表
+</template>
+```
+
+### 3. 展示“分”为“元”的金额字段
+
+金额单位必须由字段元数据显式声明；组件不会根据字段名、`MONEY` 类型或
+`semanticScaleFactor` 推断。模型定义可直接复用公共导出：
+
+```typescript
+import { MONEY_VIEWER } from 'foggy-data-viewer'
+
+const amountField = {
+  name: 'amount',
+  type: 'MONEY',
+  extData: {
+    viewer: MONEY_VIEWER
+  }
+}
+```
+
+此配置会把原始值 `3400` 展示为 `34.00`，并把筛选输入的 `34` 精确换算为
+提交给查询端的 `3400`。行数据、服务端汇总数据和排序值始终保持原始“分”值；
+已经返回“元”的字段不要配置 `MONEY_VIEWER`。
+
+## 组件列表
 
 ### 核心组件
 

package/dist/api/http.d.ts

@@ -0,0 +1,20 @@
+import type { AxiosRequestConfig } from 'axios';
+export type DataViewerHttpHeaders = Record<string, string | null | undefined>;
+export interface DataViewerHttpRequestOptions {
+    headers?: DataViewerHttpHeaders;
+}
+export interface DataViewerUnauthorizedContext {
+    status: 401;
+    method: string;
+    /** Path only: excludes credentials, query, fragment, headers and body. */
+    path: string;
+}
+export interface DataViewerHttpConfig {
+    getHeaders?: () => DataViewerHttpHeaders | Promise<DataViewerHttpHeaders>;
+    onUnauthorized?: (context: DataViewerUnauthorizedContext) => void | Promise<void>;
+}
+/** Replace configuration for all SDK clients, including already-created clients. */
+export declare function configureDataViewerHttp(config: DataViewerHttpConfig): void;
+export declare function httpOptions(options?: DataViewerHttpRequestOptions): AxiosRequestConfig;
+/** Internal factory; response unwrapping remains owned by each existing API. */
+export declare function createDataViewerHttpClient(baseURL: string): import("axios").AxiosInstance;

package/dist/api/listPreset.d.ts

@@ -1,3 +1,4 @@
+import type { DataViewerHttpRequestOptions } from './http';
 import type { ColumnViewSetting, ListPresetDef, ListPresetVisibility, QueryConditionPreset } from '@/types';
 export interface ListPresetScope {
     userId: string;
@@ -19,32 +20,32 @@ export type UpdateListPresetRequest = Partial<SaveListPresetRequest>;
 /**
  * 查询当前用户在指定 model/businessKey 下的自定义列表方案。
  */
-export declare function listPresets(scope: ListPresetScope): Promise<ListPresetDef[]>;
+export declare function listPresets(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef[]>;
 /**
  * 查询当前用户在指定 model/businessKey 下的默认自定义列表。
  */
-export declare function getDefaultListPreset(scope: ListPresetScope): Promise<ListPresetDef | null>;
+export declare function getDefaultListPreset(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef | null>;
 /**
  * 保存新的自定义列表方案。
  */
-export declare function createListPreset(scope: ListPresetScope, request: SaveListPresetRequest): Promise<ListPresetDef>;
+export declare function createListPreset(scope: ListPresetScope, request: SaveListPresetRequest, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 获取单个自定义列表详情。
  */
-export declare function getListPreset(userId: string, presetId: string): Promise<ListPresetDef>;
+export declare function getListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 更新自定义列表方案。
  */
-export declare function updateListPreset(userId: string, presetId: string, request: UpdateListPresetRequest): Promise<ListPresetDef>;
+export declare function updateListPreset(userId: string, presetId: string, request: UpdateListPresetRequest, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 删除自定义列表方案。
  */
-export declare function deleteListPreset(userId: string, presetId: string): Promise<void>;
+export declare function deleteListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<void>;
 /**
  * 将某个自定义列表设为默认方案。
  */
-export declare function setDefaultListPreset(userId: string, presetId: string): Promise<ListPresetDef>;
+export declare function setDefaultListPreset(userId: string, presetId: string, options?: DataViewerHttpRequestOptions): Promise<ListPresetDef>;
 /**
  * 清除当前 model/businessKey 下的默认方案。
  */
-export declare function clearDefaultListPreset(scope: ListPresetScope): Promise<void>;
+export declare function clearDefaultListPreset(scope: ListPresetScope, options?: DataViewerHttpRequestOptions): Promise<void>;

package/dist/api/tableDefaultQueryConfig.d.ts

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

package/dist/api/viewer.d.ts

@@ -1,3 +1,4 @@
+import type { DataViewerHttpRequestOptions } from './http';
 import type { QueryMetaResponse, ViewerQueryRequest, ViewerDataResponse, FilterOptionsResponse, ColumnSchema, FrontendMeta, MemberQueryRequest, MemberQueryResponse, OrderRequestDef } from '@/types';
 /**
  * 查询 payload（与 dataset.query_model 格式一致）
@@ -41,40 +42,40 @@ export interface CreateQueryResponse {
 /**
  * 创建查询（从 DSL 输入）
  */
-export declare function createQuery(request: CreateQueryRequest): Promise<CreateQueryResponse>;
+export declare function createQuery(request: CreateQueryRequest, options?: DataViewerHttpRequestOptions): Promise<CreateQueryResponse>;
 /**
  * 获取查询元数据
  */
-export declare function fetchQueryMeta(model: string, queryId: string): Promise<QueryMetaResponse>;
+export declare function fetchQueryMeta(model: string, queryId: string, options?: DataViewerHttpRequestOptions): Promise<QueryMetaResponse>;
 /**
  * 查询数据
  */
-export declare function fetchQueryData(model: string, queryId: string, request: ViewerQueryRequest): Promise<ViewerDataResponse>;
+export declare function fetchQueryData(model: string, queryId: string, request: ViewerQueryRequest, options?: DataViewerHttpRequestOptions): Promise<ViewerDataResponse>;
 /**
  * 获取过滤选项（维度成员或字典项）
  */
-export declare function fetchFilterOptions(model: string, queryId: string, columnName: string): Promise<FilterOptionsResponse>;
+export declare function fetchFilterOptions(model: string, queryId: string, columnName: string, options?: DataViewerHttpRequestOptions): Promise<FilterOptionsResponse>;
 /**
  * 获取 QM Schema（查询模型的字段元数据）
  */
-export declare function fetchQmSchema(qmModel: string): Promise<ColumnSchema[]>;
+export declare function fetchQmSchema(qmModel: string, options?: DataViewerHttpRequestOptions): Promise<ColumnSchema[]>;
 /**
  * 直连查询数据（无需提前创建 queryId）
  *
  * 适用于生成组件的标准用法：只需 qmModel + 分页/筛选/排序/列集合即可查询。
  * 现有 fetchQueryData(model, queryId, request) 保留给 DataViewer / SavedQuery 场景。
  */
-export declare function fetchQueryDataDirect(qmModel: string, request: ViewerQueryRequest): Promise<ViewerDataResponse>;
+export declare function fetchQueryDataDirect(qmModel: string, request: ViewerQueryRequest, options?: DataViewerHttpRequestOptions): Promise<ViewerDataResponse>;
 /**
  * 获取前端元数据契约 (frontend-meta v1)
  *
  * 返回面向前端渲染的标准元数据：fields 为有序数组、包含 memberLookup/category/uiHints。
  */
-export declare function fetchFrontendMeta(qmModel: string): Promise<FrontendMeta>;
+export declare function fetchFrontendMeta(qmModel: string, options?: DataViewerHttpRequestOptions): Promise<FrontendMeta>;
 /**
  * 查询维度成员（远程搜索、分页、回填）
  *
  * 用于 SelectFilter 的 dimension 远程模式，替代旧的 fetchFilterOptions。
  * DSL slice 应使用返回的 selectionFieldName，而非 displayFieldName。
  */
-export declare function fetchMemberOptions(request: MemberQueryRequest): Promise<MemberQueryResponse>;
+export declare function fetchMemberOptions(request: MemberQueryRequest, options?: DataViewerHttpRequestOptions): Promise<MemberQueryResponse>;

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[];
+    /** 业务查询所需但不一定展示的运行时字段；不会作为用户字段保存 */
+    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,17 @@
-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[];
     requiredRuntimeColumns?: string[];
+    filterMemberLoader?: (request: MemberQueryRequest) => Promise<MemberQueryResponse>;
     triggerMode?: 'button' | 'none';
 }
 type MoveEdge = 'top' | 'bottom';
@@ -90,6 +92,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,14 +12,18 @@ 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';
 export type { BuildPivotGridColumnsOptions, PivotGridColumn, PivotHeaderValidationResult } from './utils/pivotHeaderTree';
+export { configureDataViewerHttp } from './api/http';
+export type { DataViewerHttpConfig, DataViewerHttpHeaders, DataViewerHttpRequestOptions, DataViewerUnauthorizedContext } from './api/http';
 export { createQuery, fetchQueryMeta, fetchQueryData, fetchFilterOptions, fetchQmSchema, fetchQueryDataDirect, fetchFrontendMeta, fetchMemberOptions } from './api/viewer';
 export type { QueryPayload, CreateQueryRequest, CreateQueryResponse } from './api/viewer';
 export { listPresets, getDefaultListPreset, createListPreset, getListPreset, updateListPreset, deleteListPreset, setDefaultListPreset, clearDefaultListPreset } from './api/listPreset';