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

package/README.md

@@ -1,6 +1,8 @@
 # Foggy Data Viewer
 
-一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
+一个基于 Vue 3 + TypeScript + vxe-table 的企业级数据表格组件库。
+
+HTTP 鉴权接入（beta.47 起）：从公共入口导入 `configureDataViewerHttp`，在应用挂载前配置动态 `getHeaders` 和 `onUnauthorized`。允许先导入 SDK 再配置，无需 patch Axios，也无需修改 generated 文件。详见 [HTTP 接入与 TMS 迁移指南](./docs/http-auth.md)。
 
 ## 特性
 
@@ -8,7 +10,7 @@
 - 📊 **动态列配置** - 基于 QM Schema + TableConfig 的灵活列配置
 - 🔍 **高级筛选** - 支持多种数据类型的筛选器（表头过滤 + 独立搜索工具栏）
 - 📈 **汇总行** - 自动计算选中行和全量汇总
-- 🎨 **自定义渲染** - 支持 `column-*` 插槽、自定义格式化和渲染函数
+- 🎨 **自定义渲染** - 支持 `column-*` 插槽、自定义格式化和渲染函数
 - 🔧 **组合组件** - 提供 SearchToolbar + DataTable 的组合组件
 - ✅ **高测试覆盖** - 核心组件覆盖率 90%+
 - 📦 **按需引入** - ES Module 支持
@@ -102,6 +104,27 @@ function handlePageChange(page: number, pageSize: number) {
 </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`。
+
 ## 组件列表
 
 ### 核心组件
@@ -139,33 +162,33 @@ function handlePageChange(page: number, pageSize: number) {
 | columns | `EnhancedColumnSchema[]` | - | 列配置（必填） |
 | data | `any[]` | - | 表格数据（必填） |
 | total | `number` | - | 总数据量（必填） |
-| loading | `boolean` | `false` | 加载状态 |
-| pageSize | `number` | `50` | 每页显示数量 |
-| showFilters | `boolean` | `true` | 是否显示筛选器 |
-| localFilter | `boolean` | `true` | 是否把列头筛选条件应用到当前 `data` |
-| serverSummary | `object \| null` | `null` | 服务端汇总数据 |
-| initialSlice | `SliceCondition[]` | - | 初始筛选条件 |
-| filterOptionsLoader | `Function` | - | 筛选选项加载器 |
-
-`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
-
-| 事件名 | 参数 | 说明 |
+| loading | `boolean` | `false` | 加载状态 |
+| pageSize | `number` | `50` | 每页显示数量 |
+| showFilters | `boolean` | `true` | 是否显示筛选器 |
+| localFilter | `boolean` | `true` | 是否把列头筛选条件应用到当前 `data` |
+| serverSummary | `object \| null` | `null` | 服务端汇总数据 |
+| initialSlice | `SliceCondition[]` | - | 初始筛选条件 |
+| filterOptionsLoader | `Function` | - | 筛选选项加载器 |
+
+`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
+
+| 事件名 | 参数 | 说明 |
 |--------|------|------|
 | page-change | `(page, pageSize)` | 分页变化 |
 | sort-change | `(field, order)` | 排序变化 |
@@ -201,179 +224,179 @@ function buildTableColumns(
   - `showAll?: boolean` - 是否显示所有列
   - `customizations?: ColumnCustomization[]` - 列自定义配置
 
-**返回：**
-- `EnhancedColumnSchema[]` - 增强的列配置数组
-
-## 列内容自定义
-
-### `column-*` 插槽（推荐用于交互）
-
-当业务列需要渲染成链接、按钮，或点击后交给上游页面打开详情、编辑弹窗时，推荐使用 `#column-{field}` 插槽。插槽参数为 `{ row, value, column }`。
-
-```vue
-<script setup lang="ts">
-function openDetail(row: Record<string, unknown>) {
-  // 由业务系统决定跳转、弹窗或其他处理方式
-}
-</script>
-
-<template>
-  <DataTableWithSearch
-    :columns="columns"
-    :data="data"
-    :total="total"
-    :loading="loading"
-  >
-    <template #column-name="{ row, value }">
-      <button type="button" class="link-cell" @click.stop="openDetail(row)">
-        {{ value || '-' }}
-      </button>
-    </template>
-  </DataTableWithSearch>
-</template>
-```
-
-`foggy-gen` 生成的 QueryTable wrapper 也会透传 `column-*` / `filter-*` 动态插槽，因此业务页可以直接在生成组件上写同样的插槽：
-
-```vue
-<VehicleCapacityProfileManagementQueryTable>
-  <template #column-profileName="{ row, value }">
-    <button type="button" class="link-cell" @click.stop="openProfile(row)">
-      {{ value || '-' }}
-    </button>
-  </template>
-</VehicleCapacityProfileManagementQueryTable>
-```
-
-### `render` 函数（适合纯展示）
-
-如果只是添加颜色、图标、标签等展示效果，也可以通过 `ColumnCustomization.render` 或生成组件的 `columnOverrides[field].render` 配置渲染函数：
-
-```typescript
-import { h } from 'vue'
-import { buildTableColumns } from 'foggy-data-viewer'
-
-const columns = buildTableColumns(qmSchema, {
-  visibleColumns: ['name', 'status'],
-  customizations: [
-    {
-      name: 'status',
-      render: ({ value, column }) => h(
-        'span',
-        { class: value === 'active' ? 'status-ok' : 'status-muted' },
-        `${column.title}: ${String(value ?? '-')}`
-      )
-    }
-  ]
-})
-```
-
-选择原则：需要绑定业务事件时优先用 `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
-import type { Component } from 'vue'
-
-interface ColumnSchema {
-  name: string
-  type: string
-  title: string
-}
-
-interface CellRenderContext {
-  row: Record<string, unknown>
-  value: unknown
-  column: EnhancedColumnSchema
-}
-
-type CellRenderFn = (params: CellRenderContext) => unknown
-
-interface ColumnCustomization {
-  name: string
-  width?: number
-  minWidth?: number
-  fixed?: 'left' | 'right'
-  formatter?: (value: unknown) => string
-  render?: CellRenderFn
-  filterComponent?: Component | unknown
-}
-
-interface TableConfig {
+**返回：**
+- `EnhancedColumnSchema[]` - 增强的列配置数组
+
+## 列内容自定义
+
+### `column-*` 插槽（推荐用于交互）
+
+当业务列需要渲染成链接、按钮，或点击后交给上游页面打开详情、编辑弹窗时，推荐使用 `#column-{field}` 插槽。插槽参数为 `{ row, value, column }`。
+
+```vue
+<script setup lang="ts">
+function openDetail(row: Record<string, unknown>) {
+  // 由业务系统决定跳转、弹窗或其他处理方式
+}
+</script>
+
+<template>
+  <DataTableWithSearch
+    :columns="columns"
+    :data="data"
+    :total="total"
+    :loading="loading"
+  >
+    <template #column-name="{ row, value }">
+      <button type="button" class="link-cell" @click.stop="openDetail(row)">
+        {{ value || '-' }}
+      </button>
+    </template>
+  </DataTableWithSearch>
+</template>
+```
+
+`foggy-gen` 生成的 QueryTable wrapper 也会透传 `column-*` / `filter-*` 动态插槽，因此业务页可以直接在生成组件上写同样的插槽：
+
+```vue
+<VehicleCapacityProfileManagementQueryTable>
+  <template #column-profileName="{ row, value }">
+    <button type="button" class="link-cell" @click.stop="openProfile(row)">
+      {{ value || '-' }}
+    </button>
+  </template>
+</VehicleCapacityProfileManagementQueryTable>
+```
+
+### `render` 函数（适合纯展示）
+
+如果只是添加颜色、图标、标签等展示效果，也可以通过 `ColumnCustomization.render` 或生成组件的 `columnOverrides[field].render` 配置渲染函数：
+
+```typescript
+import { h } from 'vue'
+import { buildTableColumns } from 'foggy-data-viewer'
+
+const columns = buildTableColumns(qmSchema, {
+  visibleColumns: ['name', 'status'],
+  customizations: [
+    {
+      name: 'status',
+      render: ({ value, column }) => h(
+        'span',
+        { class: value === 'active' ? 'status-ok' : 'status-muted' },
+        `${column.title}: ${String(value ?? '-')}`
+      )
+    }
+  ]
+})
+```
+
+选择原则：需要绑定业务事件时优先用 `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
+import type { Component } from 'vue'
+
+interface ColumnSchema {
+  name: string
+  type: string
+  title: string
+}
+
+interface CellRenderContext {
+  row: Record<string, unknown>
+  value: unknown
+  column: EnhancedColumnSchema
+}
+
+type CellRenderFn = (params: CellRenderContext) => unknown
+
+interface ColumnCustomization {
+  name: string
+  width?: number
+  minWidth?: number
+  fixed?: 'left' | 'right'
+  formatter?: (value: unknown) => string
+  render?: CellRenderFn
+  filterComponent?: Component | unknown
+}
+
+interface TableConfig {
   visibleColumns?: string[]
   showAll?: boolean
   customizations?: ColumnCustomization[]
 }
 
 interface EnhancedColumnSchema extends ColumnSchema {
-  width?: number
-  minWidth?: number
-  fixed?: 'left' | 'right'
-  customFormatter?: (value: unknown) => string
-  customRender?: CellRenderFn
-  customFilterComponent?: Component | unknown
-}
-```
+  width?: number
+  minWidth?: number
+  fixed?: 'left' | 'right'
+  customFormatter?: (value: unknown) => string
+  customRender?: CellRenderFn
+  customFilterComponent?: Component | unknown
+}
+```
 
 ## 开发
 

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

@@ -67,6 +67,8 @@ type __VLS_Slots = {
         row: Record<string, unknown>;
         column: EnhancedColumnSchema;
         value: unknown;
+        rawValue: unknown;
+        displayValue: string;
     }) => unknown;
     /** 自定义过滤器 */
     [key: `filter-${string}`]: (props: {
@@ -82,7 +84,7 @@ interface ClearSelectionOptions {
 }
 declare function clearTableSelection(options?: ClearSelectionOptions): void;
 declare function getAllFilterSlices(): SliceRequestDef[];
-declare function updateFilter(columnName: string, value: SliceRequestDef[] | null): void;
+declare function setRawFilter(columnName: string, value: SliceRequestDef[] | null): void;
 declare function resetPagination(): void;
 declare function clearFilters(): void;
 declare const __VLS_component: import("vue").DefineComponent<Props, {
@@ -91,7 +93,7 @@ declare const __VLS_component: import("vue").DefineComponent<Props, {
     /** 获取当前过滤状态 (DSL slices) */
     getFilters: typeof getAllFilterSlices;
     /** 设置过滤值 */
-    setFilter: typeof updateFilter;
+    setFilter: typeof setRawFilter;
     /** 获取 vxe-grid 实例 */
     getGridInstance: () => VxeGridInstance;
     /** 获取当前选中行数组 */

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

@@ -1,4 +1,4 @@
-import type { SliceRequestDef, MemberQueryRequest, MemberQueryResponse } from '@/types';
+import type { FieldExtData, SliceRequestDef, MemberQueryRequest, MemberQueryResponse } from '@/types';
 /**
  * QueryPanel - 传统查询区组件
  *
@@ -21,6 +21,7 @@ export interface QueryFieldSchema {
     order?: number;
     span?: number;
     visible?: boolean;
+    extData?: FieldExtData;
 }
 export interface QueryPanelLayoutSchema {
     mode?: 'grid';
@@ -59,11 +60,12 @@ interface Props {
     qmModel?: string;
 }
 declare function handleSearch(): void;
+declare function getRawSlices(): SliceRequestDef[];
 declare function handleReset(): void;
 declare const _default: import("vue").DefineComponent<Props, {
     search: typeof handleSearch;
     reset: typeof handleReset;
-    getSlices: () => SliceRequestDef[];
+    getSlices: typeof getRawSlices;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     search: () => any;
     reset: () => any;

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

@@ -26,12 +26,13 @@ interface Props {
     /** QM 模型名称（远程成员加载所需） */
     qmModel?: string;
 }
+declare function getRawFilterSlices(): SliceRequestDef[];
 declare function handleReset(): void;
 declare const _default: import("vue").DefineComponent<Props, {
     /** 清空所有筛选 */
     clearFilters: typeof handleReset;
     /** 获取当前筛选条件 */
-    getFilters: () => SliceRequestDef[];
+    getFilters: typeof getRawFilterSlices;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     search: () => any;
     reset: () => any;

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

@@ -12,5 +12,5 @@ export declare function useTableSummary(columns: Ref<ColumnSchema[]>): {
         type?: string;
     }[], selectedSummary: Record<string, unknown>, fallbackTotal?: number) => (string | number | null)[][];
     setServerSummary: (data: Record<string, unknown> | null) => void;
-    formatValue: (value: unknown, type?: string) => string;
+    formatValue: (value: unknown, typeOrColumn?: string | ColumnSchema) => string;
 };