niuma-ui 1.1.12 → 1.2.0

package/src/composables/createRsTableEditEmitBridge.ts

@@ -1,38 +0,0 @@
-/**
- * 将 Vue emit 适配为 useRsTableEditActions 所需的 edit emit 袋。
- */
-
-import type { EmitFn } from 'vue'
-import type { RsTableEmits } from '../components/table/rs-table-props'
-import type { RsTableRowData } from '../components/table-utils'
-import type { UseRsTableEditActionsOptions } from './useRsTableEditActions'
-
-type EditEmitBag<T extends RsTableRowData> = UseRsTableEditActionsOptions<T>['emit']
-
-/**
- * 创建编辑 emit 桥（避免 RsTable 内联一长串箭头函数）。
- *
- * 入参用 Vue `EmitFn<RsTableEmits>`，与 `defineEmits` 产物对齐；
- * 勿用手写 overload 接口承接（交叉重载在参数位逆变，会报 cellView ̸∈ update:columnOrder）。
- */
-export function createRsTableEditEmitBridge<T extends RsTableRowData>(
-  emit: EmitFn<RsTableEmits<T>>,
-): EditEmitBag<T> {
-  return {
-    cellView: (row, column, index) => emit('cellView', row, column, index),
-    cellEditStart: (row, column, index) => emit('cellEditStart', row, column, index),
-    cellEditDialog: (row, column, index, draft) =>
-      emit('cellEditDialog', row, column, index, draft),
-    cellEditCommit: (row, column, index, value, previous) =>
-      emit('cellEditCommit', row, column, index, value, previous),
-    cellEditCancel: (row, column, index) => emit('cellEditCancel', row, column, index),
-    cellEditInvalid: (row, column, index, message, value) =>
-      emit('cellEditInvalid', row, column, index, message, value),
-    cellEditBatchCommit: (column, changes) => emit('cellEditBatchCommit', column, changes),
-    cellEditUndo: (entry) => emit('cellEditUndo', entry),
-    cellEditRedo: (entry) => emit('cellEditRedo', entry),
-    cellEditReject: (row, index, reason) => emit('cellEditReject', row, index, reason),
-    rowEditCommit: (row, index, changes) => emit('rowEditCommit', row, index, changes),
-    rowEditRollback: (row, index) => emit('rowEditRollback', row, index),
-  }
-}

package/src/composables/useClickOutside.ts

@@ -1,22 +0,0 @@
-import { onBeforeUnmount, onMounted, type Ref } from 'vue'
-
-export function useClickOutside(
-  target: Ref<HTMLElement | null>,
-  handler: () => void,
-) {
-  function onPointerDown(event: MouseEvent) {
-    const el = target.value
-    if (!el || el.contains(event.target as Node)) {
-      return
-    }
-    handler()
-  }
-
-  onMounted(() => {
-    document.addEventListener('mousedown', onPointerDown)
-  })
-
-  onBeforeUnmount(() => {
-    document.removeEventListener('mousedown', onPointerDown)
-  })
-}

package/src/composables/useRsConfig.ts

@@ -1,98 +0,0 @@
-import { inject, provide, ref, type InjectionKey, type Ref } from 'vue'
-import {
-  interpolateRsMessage,
-  resolveRsTranslateArgs,
-  type RsTranslateFn,
-} from '../locale/interpolate'
-import { localeMap } from '../locale/messages'
-import { defaultLocale, type RsLocale } from '../locale/types'
-import type { RsComponentSize, RsRadius, RsThemeMode } from '../theme/types'
-
-export interface RsConfigContext {
-  theme: Ref<RsThemeMode>
-  locale: Ref<RsLocale>
-  /** 全局默认控件尺寸（ssm / sm / md / lg）。 */
-  controlSize: Ref<RsComponentSize>
-  /**
-   * 全局默认圆角。未设置时各组件保留自身默认档（如按钮 full、输入 sm）。
-   * 设为 `none` 可整站直角风格。
-   */
-  controlRadius: Ref<RsRadius | undefined>
-  setTheme: (mode: RsThemeMode) => void
-  setLocale: (locale: RsLocale) => void
-  setControlSize: (size: RsComponentSize) => void
-  setControlRadius: (radius: RsRadius | undefined) => void
-  t: RsTranslateFn
-}
-
-export const rsConfigKey: InjectionKey<RsConfigContext> = Symbol('rs-config')
-
-export function useRsConfig(): RsConfigContext {
-  const ctx = inject(rsConfigKey)
-  if (!ctx) {
-    throw new Error('useRsConfig() must be used within RsConfigProvider')
-  }
-  return ctx
-}
-
-/** 可选读取；组件在 Provider 外也可独立使用。 */
-export function useRsConfigOptional(): RsConfigContext | null {
-  return inject(rsConfigKey, null)
-}
-
-export function createRsConfigState(
-  initialTheme: RsThemeMode = 'light',
-  initialLocale: RsLocale = defaultLocale,
-  initialControlSize: RsComponentSize = 'md',
-  initialControlRadius?: RsRadius,
-): RsConfigContext {
-  const theme = ref<RsThemeMode>(initialTheme)
-  const locale = ref<RsLocale>(initialLocale)
-  const controlSize = ref<RsComponentSize>(initialControlSize)
-  const controlRadius = ref<RsRadius | undefined>(initialControlRadius)
-
-  function setTheme(mode: RsThemeMode) {
-    theme.value = mode
-  }
-
-  function setLocale(next: RsLocale) {
-    locale.value = next
-    if (typeof document !== 'undefined') {
-      document.documentElement.setAttribute('data-rs-locale', next)
-    }
-  }
-
-  function setControlSize(size: RsComponentSize) {
-    controlSize.value = size
-  }
-
-  function setControlRadius(radius: RsRadius | undefined) {
-    controlRadius.value = radius
-  }
-
-  const t: RsTranslateFn = (key, fallbackOrVars, vars) => {
-    const parsed = resolveRsTranslateArgs(fallbackOrVars, vars)
-    const raw = localeMap[locale.value][key] ?? parsed.fallback ?? key
-    return interpolateRsMessage(raw, parsed.vars)
-  }
-
-  if (typeof document !== 'undefined') {
-    document.documentElement.setAttribute('data-rs-locale', locale.value)
-  }
-
-  return {
-    theme,
-    locale,
-    controlSize,
-    controlRadius,
-    setTheme,
-    setLocale,
-    setControlSize,
-    setControlRadius,
-    t,
-  }
-}
-
-export function provideRsConfig(ctx: RsConfigContext) {
-  provide(rsConfigKey, ctx)
-}

package/src/composables/useRsI18n.ts

@@ -1,33 +0,0 @@
-import { computed, inject } from 'vue'
-import { interpolateRsMessage, resolveRsTranslateArgs, type RsI18nVars, type RsTranslateFn } from '../locale/interpolate'
-import { localeMap } from '../locale/messages'
-import { defaultLocale, type RsLocale } from '../locale/types'
-import { rsConfigKey } from './useRsConfig'
-
-export type { RsI18nVars, RsTranslateFn }
-
-function translate(
-  locale: RsLocale,
-  key: string,
-  fallbackOrVars?: string | RsI18nVars,
-  vars?: RsI18nVars,
-): string {
-  const parsed = resolveRsTranslateArgs(fallbackOrVars, vars)
-  const raw = localeMap[locale][key] ?? parsed.fallback ?? key
-  return interpolateRsMessage(raw, parsed.vars)
-}
-
-/** 组件内安全取文案：Provider 内跟随 locale，否则回退 defaultLocale */
-export function useRsI18n() {
-  const ctx = inject(rsConfigKey, null)
-  const locale = computed<RsLocale>(() => ctx?.locale.value ?? defaultLocale)
-
-  const t: RsTranslateFn = (key, fallbackOrVars, vars) =>
-    translate(locale.value, key, fallbackOrVars, vars)
-
-  return { t, locale }
-}
-
-export function createTranslator(locale: RsLocale): RsTranslateFn {
-  return (key, fallbackOrVars, vars) => translate(locale, key, fallbackOrVars, vars)
-}

package/src/composables/useRsLoadingBar.ts

@@ -1,36 +0,0 @@
-import { inject, type InjectionKey, type ShallowRef } from 'vue'
-
-export type RsLoadingBarApi = {
-  start: () => void
-  finish: () => void
-  error: () => void
-}
-
-export const RS_LOADING_BAR_KEY: InjectionKey<ShallowRef<RsLoadingBarApi | null>> =
-  Symbol('rs-loading-bar')
-
-/**
- * useRsLoadingBar 读取最近的 RsLoadingBar 实例 API。
- * 调用方须位于 RsLoadingBar 默认插槽的后代树中；
- * 未挂载或未包裹时返回空操作实现，避免调用方崩溃。
- */
-export function useRsLoadingBar(): RsLoadingBarApi {
-  const injected = inject(RS_LOADING_BAR_KEY, null)
-  const noop: RsLoadingBarApi = {
-    start() {},
-    finish() {},
-    error() {},
-  }
-  if (!injected) return noop
-  return {
-    start() {
-      injected.value?.start()
-    },
-    finish() {
-      injected.value?.finish()
-    },
-    error() {
-      injected.value?.error()
-    },
-  }
-}

package/src/composables/useRsTable.ts

@@ -1,134 +0,0 @@
-/**
- * RsTable 公开面编排（对标 AG Grid api / TanStack table instance）。
- *
- * 职责：
- * - FeatureHost：全局模块 + 实例 features 生命周期与贡献袋
- * - RsTableApi：统一 create / provide，避免 expose 与 inject 漂移
- *
- * 内核装配（Columns / Engine / Virtual）见 useRsTableCore；本文件保持公开面轻量。
- */
-
-import { inject, provide, type InjectionKey } from 'vue'
-import type { RsContextMenuItem } from '../components/context-menu-utils'
-import type { RsTableRowData } from '../components/table-utils'
-import {
-  createRsTableApi,
-  RS_TABLE_API_KEY,
-  type RsTableApi,
-} from '../components/table/rs-table-api'
-import {
-  createRsTableFeatureHost,
-  type RsTableFeatureHost,
-  type RsTableOverlayContribution,
-  type RsTableToolbarItem,
-} from '../components/table/rs-table-feature-host'
-import { resolveInstanceFeatures } from '../components/table/rs-table-module-registry'
-import {
-  createBuiltinTableFeatures,
-  type RsTableBuiltinFeatureId,
-  type RsTableFeature,
-} from '../components/table/table-features'
-import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource'
-
-export type { RsTableApi }
-export { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, isRsTableApi } from '../components/table/rs-table-api'
-export { RsTableModuleRegistry, resolveInstanceFeatures } from '../components/table/rs-table-module-registry'
-
-/**
- * useRsTable 返回的公开面：Feature 宿主 + API 工厂。
- */
-export interface UseRsTableSurface<T extends RsTableRowData = RsTableRowData> {
-  featureHost: RsTableFeatureHost<T>
-  /**
-   * 绑定内置 id + 实例/全局 features；返回 dispose。
-   * 应在 watch(immediate) 中调用，替换旧 dispose。
-   */
-  bindFeatures: (options: {
-    builtinIds: RsTableBuiltinFeatureId[]
-    instanceFeatures?: RsTableFeature<T>[] | null
-    getViewRows: () => T[]
-    getSelectedRows: () => T[]
-    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
-    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
-  }) => () => void
-  /** 合并 props 自定义菜单与 feature 贡献 */
-  mergeContextMenuItems: (
-    baseItems: RsContextMenuItem[],
-    menuCtx: { row: T | null; selectedRows: T[] },
-  ) => RsContextMenuItem[]
-  /** 由内部实现装配冻结 API，并可选 provide */
-  createApi: (
-    impl: Omit<RsTableApi<T>, 'apiVersion' | 'getActiveFeatureIds'> & {
-      getActiveFeatureIds?: () => string[]
-    },
-    options?: { provide?: boolean },
-  ) => RsTableApi<T>
-  getActiveFeatureIds: () => string[]
-  /** 实例级 toolbar 贡献（多表互不共享） */
-  getToolbarItems: () => RsTableToolbarItem[]
-  /** 实例级 overlay 贡献 */
-  getOverlayContributions: () => RsTableOverlayContribution[]
-}
-
-/**
- * 创建表格公开面（每个 RsTable 实例调用一次）。
- */
-export function useRsTable<T extends RsTableRowData = RsTableRowData>(): UseRsTableSurface<T> {
-  const featureHost = createRsTableFeatureHost<T>()
-
-  function bindFeatures(options: {
-    builtinIds: RsTableBuiltinFeatureId[]
-    instanceFeatures?: RsTableFeature<T>[] | null
-    getViewRows: () => T[]
-    getSelectedRows: () => T[]
-    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
-    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
-  }): () => void {
-    // 合并顺序：全局模块 → 内置 → 实例 features（同 id 后者覆盖）
-    const features = resolveInstanceFeatures<T>([
-      ...createBuiltinTableFeatures<T>(options.builtinIds),
-      ...(options.instanceFeatures ?? []),
-    ])
-    const ctx = featureHost.createContext({
-      getViewRows: options.getViewRows,
-      getSelectedRows: options.getSelectedRows,
-      getAnalyticsSnapshot: options.getAnalyticsSnapshot,
-      subscribeAnalytics: options.subscribeAnalytics,
-    })
-    return featureHost.setup(features, ctx)
-  }
-
-  function createApi(
-    impl: Omit<RsTableApi<T>, 'apiVersion' | 'getActiveFeatureIds'> & {
-      getActiveFeatureIds?: () => string[]
-    },
-    options?: { provide?: boolean },
-  ): RsTableApi<T> {
-    const api = createRsTableApi<T>({
-      ...impl,
-      getActiveFeatureIds: impl.getActiveFeatureIds ?? (() => featureHost.getActiveFeatureIds()),
-    })
-    if (options?.provide !== false) {
-      provide(RS_TABLE_API_KEY as InjectionKey<RsTableApi<T>>, api)
-    }
-    return api
-  }
-
-  return {
-    featureHost,
-    bindFeatures,
-    mergeContextMenuItems: (base, menuCtx) => featureHost.mergeContextMenuItems(base, menuCtx),
-    createApi,
-    getActiveFeatureIds: () => featureHost.getActiveFeatureIds(),
-    getToolbarItems: () => featureHost.getToolbarItems(),
-    getOverlayContributions: () => featureHost.getOverlayContributions(),
-  }
-}
-
-/**
- * 子树内注入表格 API（插槽/子组件用）。
- * 未 provide 时返回 undefined。
- */
-export function useRsTableApi<T extends RsTableRowData = RsTableRowData>(): RsTableApi<T> | undefined {
-  return inject(RS_TABLE_API_KEY as InjectionKey<RsTableApi<T>>, undefined)
-}

package/src/composables/useRsTableA11y.ts

@@ -1,52 +0,0 @@
-/**
- * RsTable 无障碍基线：region / grid 语义与 loading busy。
- *
- * 与 useRsTableGridKeyboard + 单元格 role=gridcell 配合，形成可漫游网格。
- * tabindex 放在 role=grid 的 table 上（复合控件可聚焦），勿放在 region 壳层。
- */
-
-import { computed, type ComputedRef, type Ref } from 'vue'
-
-export interface UseRsTableA11yOptions {
-  /** 显式无障碍名称；空则回退 defaultLabel */
-  ariaLabel: () => string | undefined
-  defaultLabel: () => string
-  loading: () => boolean
-  /** 业务行数（view / dataRows） */
-  rowCount: Ref<number> | ComputedRef<number> | (() => number)
-  /** 可见数据列数 */
-  colCount: Ref<number> | ComputedRef<number> | (() => number)
-}
-
-function read(source: Ref<number> | ComputedRef<number> | (() => number)): number {
-  return typeof source === 'function' ? source() : source.value
-}
-
-/**
- * 壳层 / table 元素无障碍属性。
- */
-export function useRsTableA11y(options: UseRsTableA11yOptions) {
-  const resolvedLabel = computed(
-    () => options.ariaLabel()?.trim() || options.defaultLabel(),
-  )
-
-  const shellA11y = computed(() => ({
-    role: 'region' as const,
-    'aria-label': resolvedLabel.value,
-    'aria-busy': options.loading() ? true : undefined,
-  }))
-
-  const tableA11y = computed(() => ({
-    role: 'grid' as const,
-    tabindex: 0,
-    'aria-rowcount': Math.max(0, read(options.rowCount)),
-    'aria-colcount': Math.max(0, read(options.colCount)),
-    'aria-label': resolvedLabel.value,
-  }))
-
-  return {
-    resolvedLabel,
-    shellA11y,
-    tableA11y,
-  }
-}

package/src/composables/useRsTableChartBridge.ts

@@ -1,79 +0,0 @@
-/**
- * 表格图表桥：订阅 SelectionSource，产出库无关 chart series。
- *
- * 业务页可：
- * - 把 series 丢给 ECharts option 组装
- * - 或在图表点击时用 point.key 反查行做联动筛选
- *
- * 性能：series 随 sourceRows 浅引用变化重算；defs 建议业务侧稳定引用。
- */
-
-import { computed, type ComputedRef, type Ref } from 'vue'
-import type { RsTableRowData } from '../components/table-utils'
-import {
-  buildTableChartSeriesList,
-  type RsTableChartSeries,
-  type RsTableChartSeriesDef,
-} from '../components/table/table-chart-utils'
-import {
-  useRsTableSelectionSource,
-  type RsTableAnalyticsSnapshot,
-} from './useRsTableSelectionSource'
-
-export interface UseRsTableChartBridgeOptions<T extends RsTableRowData> {
-  viewRows: Ref<T[]> | ComputedRef<T[]>
-  selectedRows?: Ref<T[]> | ComputedRef<T[]>
-  /** 系列定义列表；变化会触发重算 */
-  seriesDefs: Ref<RsTableChartSeriesDef[]> | ComputedRef<RsTableChartSeriesDef[]> | RsTableChartSeriesDef[]
-}
-
-function readDefs(
-  defs:
-    | Ref<RsTableChartSeriesDef[]>
-    | ComputedRef<RsTableChartSeriesDef[]>
-    | RsTableChartSeriesDef[],
-): RsTableChartSeriesDef[] {
-  if (Array.isArray(defs)) return defs
-  return defs.value ?? []
-}
-
-/**
- * 选中联动图表桥。
- *
- * @returns selection 源 + series 列表 + getSnapshot
- */
-export function useRsTableChartBridge<T extends RsTableRowData>(
-  options: UseRsTableChartBridgeOptions<T>,
-) {
-  const selection = useRsTableSelectionSource<T>({
-    viewRows: options.viewRows,
-    selectedRows: options.selectedRows,
-  })
-
-  const series = computed<RsTableChartSeries[]>(() =>
-    buildTableChartSeriesList(selection.sourceRows.value, readDefs(options.seriesDefs)),
-  )
-
-  /** 按 id 取单系列，便于模板绑定 */
-  function getSeriesById(id: string): RsTableChartSeries | undefined {
-    return series.value.find((item) => item.id === id)
-  }
-
-  function getSnapshot(): RsTableAnalyticsSnapshot<T> & { series: RsTableChartSeries[] } {
-    return {
-      ...selection.getSnapshot(),
-      series: series.value,
-    }
-  }
-
-  return {
-    ...selection,
-    series,
-    getSeriesById,
-    getSnapshot,
-  }
-}
-
-export type RsTableChartBridgeApi<T extends RsTableRowData> = ReturnType<
-  typeof useRsTableChartBridge<T>
->