niuma-ui 1.1.12 → 1.2.1

package/src/components/table/rs-table-feature-host.ts

@@ -1,178 +0,0 @@
-/**
- * Feature 运行时宿主：贡献袋 + 生命周期（对标可插拔中间件总线）。
- *
- * 贡献点（实例级，多表互不串扰）：
- * - contextMenu：右键菜单
- * - toolbar：表头工具条项
- * - overlay：浮层/旁路 UI 标记（图表容器挂载点等）
- *
- * 每个 RsTable 各自 createRsTableFeatureHost()；不要跨实例复用 host。
- */
-
-import type { RsContextMenuItem } from '../context-menu-utils'
-import type { RsTableRowData } from '../table-utils'
-import type { RsTableAnalyticsSnapshot } from '../../composables/useRsTableSelectionSource'
-import type { RsTableFeature, RsTableFeatureContext } from './table-features'
-import { setupTableFeatures } from './table-features'
-
-/** 动态右键菜单贡献函数 */
-export type RsTableContextMenuContributor<T extends RsTableRowData> = (
-  items: RsContextMenuItem[],
-  ctx: { row: T | null; selectedRows: T[] },
-) => void
-
-/** 工具条贡献项 */
-export interface RsTableToolbarItem {
-  key: string
-  label: string
-  icon?: string
-  disabled?: boolean
-  onClick?: () => void
-}
-
-export type RsTableToolbarContributor = (
-  items: RsTableToolbarItem[],
-) => void
-
-/** Overlay 贡献（旁路挂载描述，不直接操作 DOM） */
-export interface RsTableOverlayContribution {
-  key: string
-  /** 业务自定义渲染/挂载标识 */
-  slot?: string
-  meta?: Record<string, unknown>
-}
-
-export type RsTableOverlayContributor = (
-  items: RsTableOverlayContribution[],
-) => void
-
-/**
- * 单次 setup 周期内的贡献收集器（实例私有）。
- */
-export interface RsTableFeatureHost<T extends RsTableRowData = RsTableRowData> {
-  createContext: (base: {
-    getViewRows: () => T[]
-    getSelectedRows: () => T[]
-    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
-    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
-  }) => RsTableFeatureContext<T>
-  setup: (features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>) => () => void
-  mergeContextMenuItems: (
-    baseItems: RsContextMenuItem[],
-    menuCtx: { row: T | null; selectedRows: T[] },
-  ) => RsContextMenuItem[]
-  /** 合并 toolbar 贡献 */
-  getToolbarItems: () => RsTableToolbarItem[]
-  /** 合并 overlay 贡献 */
-  getOverlayContributions: () => RsTableOverlayContribution[]
-  getActiveFeatureIds: () => string[]
-}
-
-/**
- * 创建 Feature 宿主（每个 RsTable 实例一个 —— 多表请各建各的）。
- */
-export function createRsTableFeatureHost<T extends RsTableRowData>(): RsTableFeatureHost<T> {
-  let menuContributors: Array<RsTableContextMenuContributor<T>> = []
-  let toolbarContributors: RsTableToolbarContributor[] = []
-  let overlayContributors: RsTableOverlayContributor[] = []
-  let activeIds: string[] = []
-
-  function createContext(base: {
-    getViewRows: () => T[]
-    getSelectedRows: () => T[]
-    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
-    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
-  }): RsTableFeatureContext<T> {
-    return {
-      getViewRows: base.getViewRows,
-      getSelectedRows: base.getSelectedRows,
-      getAnalyticsSnapshot: base.getAnalyticsSnapshot,
-      subscribeAnalytics: base.subscribeAnalytics,
-      contributeContextMenuItems(contributor) {
-        if (typeof contributor === 'function') {
-          menuContributors.push(contributor)
-          return
-        }
-        const staticItems = contributor
-        menuContributors.push((items) => {
-          items.push(...staticItems)
-        })
-      },
-      contributeToolbarItems(contributor) {
-        if (typeof contributor === 'function') {
-          toolbarContributors.push(contributor)
-          return
-        }
-        const staticItems = contributor
-        toolbarContributors.push((items) => {
-          items.push(...staticItems)
-        })
-      },
-      contributeOverlay(contributor) {
-        if (typeof contributor === 'function') {
-          overlayContributors.push(contributor)
-          return
-        }
-        const staticItems = contributor
-        overlayContributors.push((items) => {
-          items.push(...staticItems)
-        })
-      },
-    }
-  }
-
-  function setup(features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>): () => void {
-    menuContributors = []
-    toolbarContributors = []
-    overlayContributors = []
-    activeIds = features.map((f) => f.id)
-    const dispose = setupTableFeatures(features, ctx)
-    return () => {
-      dispose()
-      menuContributors = []
-      toolbarContributors = []
-      overlayContributors = []
-      activeIds = []
-    }
-  }
-
-  function mergeContextMenuItems(
-    baseItems: RsContextMenuItem[],
-    menuCtx: { row: T | null; selectedRows: T[] },
-  ): RsContextMenuItem[] {
-    const items = [...baseItems]
-    const before = items.length
-    for (const contribute of menuContributors) {
-      contribute(items, menuCtx)
-    }
-    if (before > 0 && items.length > before && !items[before]?.separator) {
-      items.splice(before, 0, { key: '__ctx-feature-sep', label: '', separator: true })
-    }
-    return items
-  }
-
-  function getToolbarItems(): RsTableToolbarItem[] {
-    const items: RsTableToolbarItem[] = []
-    for (const contribute of toolbarContributors) contribute(items)
-    return items
-  }
-
-  function getOverlayContributions(): RsTableOverlayContribution[] {
-    const items: RsTableOverlayContribution[] = []
-    for (const contribute of overlayContributors) contribute(items)
-    return items
-  }
-
-  function getActiveFeatureIds(): string[] {
-    return [...activeIds]
-  }
-
-  return {
-    createContext,
-    setup,
-    mergeContextMenuItems,
-    getToolbarItems,
-    getOverlayContributions,
-    getActiveFeatureIds,
-  }
-}

package/src/components/table/rs-table-grid-nav.ts

@@ -1,122 +0,0 @@
-/**
- * ARIA Grid 单元格导航（矩形行列模型，不限于可编辑格）。
- * 对标 Excel / AG Grid 漫游：箭头、Home/End、Ctrl+Home/End、PageUp/PageDown。
- */
-
-export type RsTableGridNavDirection =
-  | 'left'
-  | 'right'
-  | 'up'
-  | 'down'
-  | 'home'
-  | 'end'
-  | 'first'
-  | 'last'
-  | 'pageUp'
-  | 'pageDown'
-
-export interface RsTableGridCellRef {
-  rowKey: string
-  colKey: string
-  rowIndex: number
-}
-
-/**
- * 在「行列表 × 列 key」矩形上移动焦点。
- * rows 按视觉顺序；colKeys 为可见数据列顺序。
- */
-export function navigateGridCell(
-  rows: Array<{ rowKey: string; rowIndex: number }>,
-  colKeys: string[],
-  current: RsTableGridCellRef | null,
-  direction: RsTableGridNavDirection,
-  pageSize = 10,
-): RsTableGridCellRef | null {
-  if (!rows.length || !colKeys.length) return null
-
-  const seed = current ?? {
-    rowKey: rows[0]!.rowKey,
-    colKey: colKeys[0]!,
-    rowIndex: rows[0]!.rowIndex,
-  }
-
-  let rowPos = rows.findIndex((r) => r.rowKey === seed.rowKey)
-  if (rowPos < 0) rowPos = 0
-  let colPos = colKeys.indexOf(seed.colKey)
-  if (colPos < 0) colPos = 0
-
-  const lastRow = rows.length - 1
-  const lastCol = colKeys.length - 1
-  const step = Math.max(1, pageSize)
-
-  switch (direction) {
-    case 'left':
-      colPos = Math.max(0, colPos - 1)
-      break
-    case 'right':
-      colPos = Math.min(lastCol, colPos + 1)
-      break
-    case 'up':
-      rowPos = Math.max(0, rowPos - 1)
-      break
-    case 'down':
-      rowPos = Math.min(lastRow, rowPos + 1)
-      break
-    case 'home':
-      colPos = 0
-      break
-    case 'end':
-      colPos = lastCol
-      break
-    case 'first':
-      rowPos = 0
-      colPos = 0
-      break
-    case 'last':
-      rowPos = lastRow
-      colPos = lastCol
-      break
-    case 'pageUp':
-      rowPos = Math.max(0, rowPos - step)
-      break
-    case 'pageDown':
-      rowPos = Math.min(lastRow, rowPos + step)
-      break
-    default:
-      break
-  }
-
-  const row = rows[rowPos]!
-  return {
-    rowKey: row.rowKey,
-    colKey: colKeys[colPos]!,
-    rowIndex: row.rowIndex,
-  }
-}
-
-/**
- * 将 KeyboardEvent 映射为网格导航方向；无法识别则返回 null。
- */
-export function resolveGridNavDirection(event: KeyboardEvent): RsTableGridNavDirection | null {
-  const mod = event.ctrlKey || event.metaKey
-  switch (event.key) {
-    case 'ArrowLeft':
-      return 'left'
-    case 'ArrowRight':
-      return 'right'
-    case 'ArrowUp':
-      return 'up'
-    case 'ArrowDown':
-      return 'down'
-    case 'Home':
-      return mod ? 'first' : 'home'
-    case 'End':
-      return mod ? 'last' : 'end'
-    case 'PageUp':
-      return 'pageUp'
-    case 'PageDown':
-      return 'pageDown'
-    default:
-      return null
-  }
-}

package/src/components/table/rs-table-header-types.ts

@@ -1,47 +0,0 @@
-/**
- * RsTableHeader 视图契约（对标列头渲染层，与 Engine 解耦）。
- */
-
-import type { CSSProperties } from 'vue'
-import type { RsTableColumn, RsTableRowData } from '../table-utils'
-
-export interface RsTableHeaderProps<T extends RsTableRowData = RsTableRowData> {
-  showRowDragHandle: boolean
-  detailExpandable: boolean
-  showSelectColumn: boolean
-  isRadioSelection: boolean
-  selectAllState: 'checked' | 'indeterminate' | 'unchecked'
-  showEditGutterColumn: boolean
-  showIndexColumn: boolean
-  showRowStatusColumn: boolean
-  columnPadLeft: number
-  columnPadRight: number
-  visibleDataColumns: RsTableColumn<T>[]
-  columnDraggable: boolean
-  resizable: boolean
-  multiSort: boolean
-  columnFiltersState: Record<string, string>
-  dragColumnKey: string | null
-  dropColumnKey: string | null
-  dragLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
-  expandLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
-  selectLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
-  gutterLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
-  indexLeadHeaderStyle: CSSProperties | Record<string, string> | undefined
-  columnHeaderStyleMap: Map<string, Record<string, string> | undefined>
-  columnFilterValue: (key: string) => string
-  isColumnFilterActive: (filters: Record<string, string>, key: string) => boolean
-  sortOrderFor: (key: string) => string | null | undefined
-  sortPriorityFor: (key: string) => number
-  sortIconName: (key: string) => string
-  labels: {
-    selectAll: string
-    index: string
-    rowStatus: string
-    dragColumn: string
-    filterColumn: string
-    filterPlaceholder: string
-    filterClear: string
-    filterApply: string
-  }
-}

package/src/components/table/rs-table-module-registry.ts

@@ -1,72 +0,0 @@
-/**
- * RsTable 模块注册表（对标 AG Grid ModuleRegistry）。
- *
- * - 全局 register：所有表格实例默认挂载（同页多表会共享这些模块）
- * - 实例 props.features：仅该实例；同 id 覆盖全局
- * - 不改内核渲染；模块通过 Feature.setup 订阅/贡献
- * - 多表隔离要点：选中/编辑/ViewContext 仍是实例私有；仅 Registry 是全局点
- */
-
-import type { RsTableFeature } from './table-features'
-import type { RsTableRowData } from '../table-utils'
-
-const globalModules: RsTableFeature<RsTableRowData>[] = []
-
-/**
- * 全局模块注册表。
- *
- * @example
- * ```ts
- * RsTableModuleRegistry.register(
- *   createAnalyticsTableFeature({ onSnapshot: (s) => syncCharts(s) }),
- * )
- * ```
- */
-export const RsTableModuleRegistry = {
-  /**
-   * 注册全局 feature（幂等：同 id 覆盖）。
-   */
-  register<T extends RsTableRowData>(feature: RsTableFeature<T>): void {
-    const id = feature.id
-    const idx = globalModules.findIndex((item) => item.id === id)
-    const next = feature as RsTableFeature<RsTableRowData>
-    if (idx >= 0) globalModules[idx] = next
-    else globalModules.push(next)
-  },
-
-  /** 按 id 注销全局模块 */
-  unregister(id: string): void {
-    const idx = globalModules.findIndex((item) => item.id === id)
-    if (idx >= 0) globalModules.splice(idx, 1)
-  },
-
-  /** 清空（测试用） */
-  clear(): void {
-    globalModules.length = 0
-  },
-
-  /** 当前全局模块快照（浅拷贝） */
-  getModules<T extends RsTableRowData = RsTableRowData>(): RsTableFeature<T>[] {
-    return [...globalModules] as RsTableFeature<T>[]
-  },
-
-  listIds(): string[] {
-    return globalModules.map((item) => item.id)
-  },
-}
-
-/**
- * 合并全局模块 + 实例 features（实例同 id 覆盖全局）。
- */
-export function resolveInstanceFeatures<T extends RsTableRowData>(
-  instanceFeatures?: RsTableFeature<T>[] | null,
-): RsTableFeature<T>[] {
-  const map = new Map<string, RsTableFeature<T>>()
-  for (const feature of RsTableModuleRegistry.getModules<T>()) {
-    map.set(feature.id, feature)
-  }
-  for (const feature of instanceFeatures ?? []) {
-    map.set(feature.id, feature)
-  }
-  return [...map.values()]
-}