@fses/workbench-app 0.2.0 → 0.2.2

package/node_modules/@fses/workbench-card/src/renderers/resizableTable.ts

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview Ant Design Vue table column resize helpers - applies native column resizable settings for workbench tables.
+ * @author seadon
+ * @created 2026-08-04
+ */
+
+export const WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH = 72;
+
+export interface WorkbenchResizableTableColumn {
+  dataIndex?: string | number | readonly (string | number)[];
+  key?: string | number;
+  width?: number | string;
+  minWidth?: number;
+  maxWidth?: number;
+  resizable?: boolean;
+  workbenchTableKey?: string;
+  workbenchColumnKey?: string;
+}
+
+/**
+ * Applies Ant Design Vue's native resizable column settings and effective widths.
+ * @param columns - Base table column definitions.
+ * @param options - Resize state and table identity.
+ * @returns Columns decorated with native resizable metadata.
+ */
+export function applyWorkbenchResizableColumns<T extends WorkbenchResizableTableColumn>(
+  columns: T[],
+  options: {
+    tableKey: string;
+    widths: Record<string, number>;
+    defaultWidth?: number;
+    minWidth?: number;
+  },
+): T[] {
+  const minWidth = options.minWidth || WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH;
+  const defaultWidth = Math.max(minWidth, options.defaultWidth || 120);
+  return columns.map((column, index) => {
+    const columnKey = workbenchResizableColumnKey(column, index);
+    const widthKey = workbenchResizableWidthKey(options.tableKey, columnKey);
+    const width = Math.max(minWidth, Number(options.widths[widthKey] || column.width || defaultWidth));
+    return {
+      ...column,
+      width,
+      minWidth,
+      resizable: true,
+      workbenchTableKey: options.tableKey,
+      workbenchColumnKey: columnKey,
+    };
+  });
+}
+
+/**
+ * Persists a resized column width emitted by Ant Design Vue's native resizeColumn event.
+ * @param widths - Mutable width map.
+ * @param width - New column width from AntD.
+ * @param column - AntD column metadata.
+ */
+export function setWorkbenchResizableColumnWidth(
+  widths: Record<string, number>,
+  width: number,
+  column: unknown,
+): void {
+  const tableColumn = (column && typeof column === 'object' ? column : {}) as WorkbenchResizableTableColumn;
+  const tableKey = typeof tableColumn.workbenchTableKey === 'string' ? tableColumn.workbenchTableKey : 'table';
+  const columnKey = typeof tableColumn.workbenchColumnKey === 'string'
+    ? tableColumn.workbenchColumnKey
+    : workbenchResizableColumnKey(tableColumn, 0);
+  widths[workbenchResizableWidthKey(tableKey, columnKey)] = Math.max(
+    WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH,
+    Math.round(width),
+  );
+}
+
+/**
+ * Calculates a horizontal scroll width from AntD column widths.
+ * @param columns - Current table columns.
+ * @param fallback - Minimum scroll width.
+ * @returns Scroll x value.
+ */
+export function workbenchResizableTableScrollX(
+  columns: WorkbenchResizableTableColumn[],
+  fallback: number,
+): number {
+  const totalWidth = columns.reduce((total, column) => {
+    const width = typeof column.width === 'number' ? column.width : Number(column.width);
+    return total + (Number.isFinite(width) ? width : WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH);
+  }, 0);
+  return Math.max(fallback, totalWidth);
+}
+
+/**
+ * Calculates a horizontal scroll width that honors resized columns without shrinking mid-drag.
+ * @param columns - Current table columns.
+ * @param fallback - Minimum scroll width.
+ * @param defaultWidth - Baseline width per column before user resizing.
+ * @param floors - Optional mutable table scroll floors, preserving expanded width while dragging back.
+ * @returns Stable scroll x value.
+ */
+export function workbenchStableResizableTableScrollX(
+  columns: WorkbenchResizableTableColumn[],
+  fallback: number,
+  defaultWidth: number,
+  floors?: Record<string, number>,
+): number {
+  const baselineWidth = columns.length * Math.max(WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH, defaultWidth);
+  const totalWidth = columns.reduce((total, column) => {
+    const width = typeof column.width === 'number' ? column.width : Number(column.width);
+    return total + (Number.isFinite(width) ? width : WORKBENCH_RESIZABLE_TABLE_MIN_WIDTH);
+  }, 0);
+  const tableKey = columns.find((column) => typeof column.workbenchTableKey === 'string')?.workbenchTableKey || 'table';
+  const scrollX = Math.max(fallback, baselineWidth, totalWidth, floors?.[tableKey] || 0);
+  if (floors) floors[tableKey] = scrollX;
+  return scrollX;
+}
+
+/**
+ * Builds a stable width map key for one table column.
+ * @param tableKey - Table instance key.
+ * @param columnKey - Column key inside the table.
+ * @returns Combined width key.
+ */
+function workbenchResizableWidthKey(tableKey: string, columnKey: string): string {
+  return `${tableKey || 'table'}::${columnKey}`;
+}
+
+/**
+ * Reads a stable column key from AntD column metadata.
+ * @param column - AntD table column.
+ * @param index - Column index fallback.
+ * @returns Stable string key.
+ */
+function workbenchResizableColumnKey(column: WorkbenchResizableTableColumn, index: number): string {
+  if (typeof column.key === 'string' || typeof column.key === 'number') return String(column.key);
+  if (typeof column.dataIndex === 'string' || typeof column.dataIndex === 'number') return String(column.dataIndex);
+  return String(index);
+}

package/node_modules/@fses/workbench-card/src/renderers/tableDisplay.ts

@@ -0,0 +1,140 @@
+/**
+ * @fileoverview 表格显示工具 - 清洗图生卡表格列与结构化单元格文本。
+ * @author seadon
+ * @created 2026-06-22
+ */
+
+const BUSINESS_VALUE_KEYS = [
+  'displayValue',
+  'text',
+  'label',
+  'name',
+  'title',
+  'status',
+  'amount',
+  'count',
+  'ratio',
+  'progress',
+  'description',
+  'detail',
+];
+
+const ISO_LOCAL_DATETIME_PATTERN = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2}:\d{2})(?:\.\d+)?$/;
+
+export const IMAGE_TABLE_INTERNAL_COLUMN_KEYS = new Set([
+  'id',
+  'cells',
+  'key',
+  'value',
+  'raw',
+  'rawValue',
+  'payload',
+  'source',
+  'sourceLabel',
+  'shape',
+  'visualKind',
+  'rendererKey',
+  'dataShape',
+  'dataBinding',
+  'dataBindingId',
+  'dataBindingStatus',
+  'dataBindingError',
+  'humanIntervention',
+  'dataBindingHumanIntervention',
+  'queryIntent',
+  'refreshApi',
+  'composeSource',
+  'snapshotSource',
+  'meta',
+  'style',
+  'visual',
+  'backgroundColor',
+  'borderColor',
+  'textColor',
+  'accentColor',
+  'baseCols',
+  'x',
+  'y',
+  'w',
+  'h',
+  'row',
+  'col',
+  'rowSpan',
+  'columnSpan',
+  'layout',
+  'layoutBasis',
+  'nestedBlocks',
+  'nestedLayoutBasis',
+  'nestedLayoutMode',
+  'nestedLayoutStacks',
+  'nestedLayoutItems',
+  'childIds',
+  'children',
+  'slots',
+]);
+
+/**
+ * 将数据库常见的本地 ISO 时间转成标准展示格式。
+ * @param value - 已去除首尾空格的单元格文本。
+ * @returns 标准时间文本，非目标格式保持原样。
+ */
+function normalizeTableDateTimeText(value: string): string {
+  const match = value.match(ISO_LOCAL_DATETIME_PATTERN);
+  if (!match) return value;
+  return `${match[1]} ${match[2]}`;
+}
+
+/**
+ * 判断表格列是否应作为用户可见列渲染。
+ * @param key - 候选列名。
+ * @returns 非内部协议列返回 true。
+ */
+export function imageTableColumnVisible(key: unknown): key is string {
+  return typeof key === 'string' && key.trim() !== '' && !IMAGE_TABLE_INTERNAL_COLUMN_KEYS.has(key.trim());
+}
+
+/**
+ * 将任意表格单元格值转成业务可读文本，避免泄露 JSON/对象结构。
+ * @param value - 原始单元格值。
+ * @param fallback - 空值兜底。
+ * @returns 可直接渲染的短文本。
+ */
+export function structuredTableCellText(value: unknown, fallback = ''): string {
+  if (value === null || value === undefined) return fallback;
+  if (typeof value === 'string') {
+    const text = value.trim();
+    return text ? normalizeTableDateTimeText(text) : fallback;
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  if (Array.isArray(value)) {
+    const parts = value.map((item) => structuredTableCellText(item)).filter(Boolean);
+    return parts.slice(0, 3).join(' / ') || fallback;
+  }
+  if (typeof value === 'object') {
+    const record = value as Record<string, unknown>;
+    for (const key of BUSINESS_VALUE_KEYS) {
+      const text = structuredTableCellText(record[key]);
+      if (text) return text;
+    }
+    const parts = Object.entries(record)
+      .filter(([key]) => imageTableColumnVisible(key))
+      .map(([key, item]) => {
+        const text = structuredTableCellText(item);
+        return text ? `${key}：${text}` : '';
+      })
+      .filter(Boolean);
+    return parts.slice(0, 2).join(' / ') || fallback;
+  }
+  return fallback;
+}
+
+/**
+ * 过滤声明列，去掉内部协议字段。
+ * @param columns - 模型或系统声明的列数组。
+ * @returns 可见列名。
+ */
+export function visibleImageTableColumns(columns: unknown): string[] {
+  return Array.isArray(columns)
+    ? columns.map((column) => structuredTableCellText(column)).filter(imageTableColumnVisible)
+    : [];
+}