niuma-ui 1.0.1 → 1.1.0

package/src/composables/assembleRsTableApi.ts

@@ -0,0 +1,79 @@
+/**
+ * 装配 RsTable 公开 Api（从 SFC 下沉，单一出口）。
+ */
+
+import type { ComputedRef, Ref } from 'vue'
+import type { RsTableApi } from '../components/table/rs-table-api'
+import type { RsTableRowData, RsTableRowEntry } from '../components/table-utils'
+import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource'
+import type { useRsTable } from './useRsTable'
+
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, { type: 'row' }>
+
+export interface AssembleRsTableApiOptions<T extends RsTableRowData> {
+  tableSurface: ReturnType<typeof useRsTable<T>>
+  dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>
+  rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>
+  viewRows: Ref<T[]> | ComputedRef<T[]>
+  selectedRows: Ref<T[]> | ComputedRef<T[]>
+  selectedRowKeys: Ref<string[]> | ComputedRef<string[]>
+  getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>
+  subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void
+  getRowByKey: (
+    rowKey: string,
+    dataRows: RowEntry<T>[],
+    rowKeyByIndex: Map<number, string>,
+  ) => T | undefined
+  getRowByIndex: (index: number, dataRows: RowEntry<T>[]) => T | undefined
+  getColumnValues: (colKey: string, dataRows: RowEntry<T>[]) => unknown[]
+  getCellValue: (
+    rowKey: string,
+    colKey: string,
+    dataRows: RowEntry<T>[],
+    rowKeyByIndex: Map<number, string>,
+  ) => unknown
+  toApiEditSlice: (ctx: {
+    dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>
+    rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>
+  }) => Pick<
+    RsTableApi<T>,
+    | 'getHighlightedRowKey'
+    | 'setHighlightedRowKey'
+    | 'cancelCellEdit'
+    | 'cancelAllEdits'
+    | 'getDirtyCellKeys'
+    | 'getCellError'
+    | 'setCellError'
+    | 'stageCell'
+    | 'rejectRowEdit'
+    | 'undoEdit'
+    | 'redoEdit'
+    | 'commitRowEdits'
+    | 'rollbackRowEdits'
+  >
+}
+
+/**
+ * 创建并返回 RsTableApi（含 feature 元数据）。
+ */
+export function assembleRsTableApi<T extends RsTableRowData>(
+  options: AssembleRsTableApiOptions<T>,
+): RsTableApi<T> {
+  const { tableSurface, dataRows, rowKeyByIndex } = options
+  return tableSurface.createApi({
+    getRowByKey: (rowKey) =>
+      options.getRowByKey(rowKey, dataRows.value, rowKeyByIndex.value),
+    getRowByIndex: (index) => options.getRowByIndex(index, dataRows.value),
+    getColumnValues: (colKey) => options.getColumnValues(colKey, dataRows.value),
+    getCellValue: (rowKey, colKey) =>
+      options.getCellValue(rowKey, colKey, dataRows.value, rowKeyByIndex.value),
+    getViewRows: () => options.viewRows.value,
+    getSelectedRows: () => options.selectedRows.value,
+    getSelectedRowKeys: () => [...options.selectedRowKeys.value],
+    getAnalyticsSnapshot: options.getAnalyticsSnapshot,
+    subscribeAnalytics: options.subscribeAnalytics,
+    ...options.toApiEditSlice({ dataRows, rowKeyByIndex }),
+    getToolbarItems: () => tableSurface.getToolbarItems(),
+    getOverlayContributions: () => tableSurface.getOverlayContributions(),
+  })
+}

package/src/composables/bindRsTableViewContext.ts

@@ -0,0 +1,269 @@
+/**
+ * 将 Shell / Edit / Chrome 接线捆成 ViewContext provide（削薄 RsTable.vue）。
+ */
+
+import type { ComputedRef, Ref } from 'vue'
+import type {
+  RsTableRowData,
+  RsTableRowEntry,
+  RsTableRowKey,
+  RsTableSelectionType,
+} from '../components/table-utils'
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger } from '../components/table/table-edit-utils'
+import type { RsTableBodyLabels, RsTableHeaderLabels } from '../components/table/rs-table-view-context'
+import type { useTableEdit } from './useTableEdit'
+import {
+  useRsTableViewProvide,
+  type RsTableViewProvideHandlers,
+  type RsTableViewProvideSources,
+} from './useRsTableViewProvide'
+
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, { type: 'row' }>
+type TableEditApi = ReturnType<typeof useTableEdit>
+
+export interface BindRsTableViewContextDeps<T extends RsTableRowData> {
+  props: {
+    columnDraggable: () => boolean
+    resizable: () => boolean
+    multiSort: () => boolean
+    loading: () => boolean
+    loadingMore: () => boolean
+    infinite: () => boolean
+    rowKey: () => RsTableRowKey<T> | undefined
+    striped: () => boolean
+    selectionType: () => RsTableSelectionType
+    editable: () => boolean
+    editTrigger: () => RsTableCellEditTrigger
+    rowCommit: () => boolean
+    allowNull: () => boolean
+    editFocusMode: () => RsTableCellEditFocusMode
+    nullLabel: () => string
+  }
+  layout: Pick<
+    RsTableViewProvideSources<T>,
+    | 'useFixedColumnLayout'
+    | 'showRowDragHandle'
+    | 'detailExpandable'
+    | 'showSelectColumn'
+    | 'showEditGutterColumn'
+    | 'showIndexColumn'
+    | 'showRowStatusColumn'
+    | 'columnPadLeft'
+    | 'columnPadRight'
+    | 'visibleDataColumns'
+    | 'prefixWidths'
+    | 'resolvedGutterWidth'
+    | 'resolvedIndexWidth'
+    | 'isRadioSelection'
+    | 'selectAllState'
+    | 'columnFiltersState'
+    | 'dragColumnKey'
+    | 'dropColumnKey'
+    | 'dragLeadHeaderStyle'
+    | 'expandLeadHeaderStyle'
+    | 'selectLeadHeaderStyle'
+    | 'gutterLeadHeaderStyle'
+    | 'indexLeadHeaderStyle'
+    | 'columnHeaderStyleMap'
+    | 'bodyColspan'
+    | 'emptyContentStyle'
+    | 'virtualScrollEnabled'
+    | 'virtualSlice'
+    | 'visibleEntries'
+    | 'treeMode'
+    | 'treeIndentPx'
+    | 'treeExpandColumnKey'
+    | 'treeLoadingKeySet'
+    | 'dragLeadStyle'
+    | 'expandLeadStyle'
+    | 'selectLeadStyle'
+    | 'indexLeadStyle'
+    | 'gutterLeadStyle'
+    | 'columnTdClassMap'
+    | 'columnStyleMap'
+    | 'dragRowKeys'
+    | 'dropRowTargetKey'
+    | 'dropRowPosition'
+  >
+  chrome: {
+    hasData: Ref<boolean> | ComputedRef<boolean>
+    headerLabels: Ref<RsTableHeaderLabels> | ComputedRef<RsTableHeaderLabels>
+    bodyLabels: Ref<RsTableBodyLabels> | ComputedRef<RsTableBodyLabels>
+    hasColumnSlot: (key: string) => boolean
+    hasEditSlot: (key: string) => boolean
+  }
+  edit: {
+    tableEdit: TableEditApi
+    activeEditCellKey: Ref<string> | ComputedRef<string>
+    activeFocusCellKey: Ref<string> | ComputedRef<string>
+    activeErrorMapSize: Ref<number> | ComputedRef<number>
+    activeValidatingMapSize: Ref<number> | ComputedRef<number>
+    cellTooltipEnabled: RsTableViewProvideHandlers<T>['cellTooltipEnabled']
+    cellTooltipMode: RsTableViewProvideHandlers<T>['cellTooltipMode']
+    cellTooltipText: RsTableViewProvideHandlers<T>['cellTooltipText']
+    cellTooltipFallbackTitle: RsTableViewProvideHandlers<T>['cellTooltipFallbackTitle']
+    rowEditPending: RsTableViewProvideHandlers<T>['rowEditPending']
+    isExternalRowPending: RsTableViewProvideHandlers<T>['isExternalRowPending']
+    onCellStartEdit: RsTableViewProvideHandlers<T>['onCellStartEdit']
+    onCellCommit: RsTableViewProvideHandlers<T>['onCellCommit']
+    onCellCancel: RsTableViewProvideHandlers<T>['onCellCancel']
+    onCellUpdateDraft: RsTableViewProvideHandlers<T>['onCellUpdateDraft']
+    onCellNavigate: RsTableViewProvideHandlers<T>['onCellNavigate']
+    onRowCommit: RsTableViewProvideHandlers<T>['onRowCommit']
+    onRowRollback: RsTableViewProvideHandlers<T>['onRowRollback']
+    onGutterCommit: RsTableViewProvideHandlers<T>['onGutterCommit']
+    onCellClick: RsTableViewProvideHandlers<T>['onCellClick']
+    onCellDblclick: RsTableViewProvideHandlers<T>['onCellDblclick']
+  }
+  interaction: {
+    isHighlighted: (key: string) => boolean
+    onCellTipOver: (event: PointerEvent) => void
+    onCellTipOut: (event: PointerEvent) => void
+  } & Pick<
+    RsTableViewProvideHandlers<T>,
+    | 'resolvedDataColumnWidth'
+    | 'columnFilterValue'
+    | 'sortOrderFor'
+    | 'sortPriorityFor'
+    | 'sortIconName'
+    | 'onToggleSelectAll'
+    | 'onColumnDragOver'
+    | 'onColumnDrop'
+    | 'onColumnDragStart'
+    | 'onColumnDragEnd'
+    | 'updateColumnFilter'
+    | 'onHeaderClick'
+    | 'onResizeStart'
+    | 'rowKeyFor'
+    | 'isRowSelected'
+    | 'isRowIndeterminate'
+    | 'isRowExpanded'
+    | 'treeDepthOf'
+    | 'canExpandRow'
+    | 'canSelectRow'
+    | 'isRowDragByRow'
+    | 'isRowDragging'
+    | 'isRowDropTarget'
+    | 'onRowClick'
+    | 'onRowSelectMouseDown'
+    | 'onCellContextmenu'
+    | 'onRowDblclick'
+    | 'onRowContextmenu'
+    | 'onRowDragOver'
+    | 'onRowDragLeave'
+    | 'onRowDrop'
+    | 'onRowDragStart'
+    | 'onRowDragEnd'
+    | 'onToggleExpand'
+    | 'onToggleSelect'
+  >
+}
+
+/**
+ * 装配并 provide ViewContext。
+ */
+export function bindRsTableViewContext<T extends RsTableRowData>(
+  deps: BindRsTableViewContextDeps<T>,
+) {
+  const { props, layout, chrome, edit, interaction } = deps
+  const { tableEdit } = edit
+
+  return useRsTableViewProvide<T>(
+    {
+      ...layout,
+      columnDraggable: props.columnDraggable,
+      resizable: props.resizable,
+      multiSort: props.multiSort,
+      headerLabels: chrome.headerLabels,
+      loading: props.loading,
+      hasData: chrome.hasData,
+      loadingMore: props.loadingMore,
+      infinite: props.infinite,
+      rowKey: props.rowKey,
+      striped: props.striped,
+      selectionType: props.selectionType,
+      editable: props.editable,
+      editTrigger: props.editTrigger,
+      rowCommit: props.rowCommit,
+      allowNull: props.allowNull,
+      editFocusMode: props.editFocusMode,
+      nullLabel: props.nullLabel,
+      activeEditCellKey: edit.activeEditCellKey,
+      activeFocusCellKey: edit.activeFocusCellKey,
+      activeErrorMapSize: edit.activeErrorMapSize,
+      activeValidatingMapSize: edit.activeValidatingMapSize,
+      stagedMapSize: () => tableEdit.stagedMap.value.size,
+      editingDraft: () => tableEdit.editingDraft.value,
+      editingCell: () => tableEdit.editingCell.value,
+      focusCell: () => tableEdit.focusCell.value,
+      bodyLabels: chrome.bodyLabels,
+    },
+    {
+      resolvedDataColumnWidth: interaction.resolvedDataColumnWidth,
+      columnFilterValue: interaction.columnFilterValue,
+      sortOrderFor: interaction.sortOrderFor,
+      sortPriorityFor: interaction.sortPriorityFor,
+      sortIconName: interaction.sortIconName,
+      onToggleSelectAll: interaction.onToggleSelectAll,
+      onColumnDragOver: interaction.onColumnDragOver,
+      onColumnDrop: interaction.onColumnDrop,
+      onColumnDragStart: interaction.onColumnDragStart,
+      onColumnDragEnd: interaction.onColumnDragEnd,
+      updateColumnFilter: interaction.updateColumnFilter,
+      onHeaderClick: interaction.onHeaderClick,
+      onResizeStart: interaction.onResizeStart,
+      onHeaderPointerOver: interaction.onCellTipOver,
+      onHeaderPointerOut: interaction.onCellTipOut,
+      rowKeyFor: interaction.rowKeyFor,
+      isRowSelected: interaction.isRowSelected,
+      isRowIndeterminate: interaction.isRowIndeterminate,
+      isRowExpanded: interaction.isRowExpanded,
+      isHighlighted: interaction.isHighlighted,
+      rowEditPending: edit.rowEditPending,
+      isExternalRowPending: edit.isExternalRowPending,
+      treeDepthOf: interaction.treeDepthOf,
+      canExpandRow: interaction.canExpandRow,
+      canSelectRow: interaction.canSelectRow,
+      isRowDragByRow: interaction.isRowDragByRow,
+      isRowDragging: interaction.isRowDragging,
+      isRowDropTarget: interaction.isRowDropTarget,
+      isRowDirty: tableEdit.isRowDirty,
+      hasColumnSlot: chrome.hasColumnSlot,
+      hasEditSlot: chrome.hasEditSlot,
+      cellTooltipEnabled: edit.cellTooltipEnabled,
+      cellTooltipMode: edit.cellTooltipMode,
+      cellTooltipText: edit.cellTooltipText,
+      cellTooltipFallbackTitle: edit.cellTooltipFallbackTitle,
+      getCellDraft: tableEdit.getDraft,
+      isCellDirty: tableEdit.isDirty,
+      getCellError: tableEdit.getCellError,
+      isCellValidating: tableEdit.isValidating,
+      onBodyPointerOver: interaction.onCellTipOver,
+      onBodyPointerOut: interaction.onCellTipOut,
+      onRowClick: interaction.onRowClick,
+      onRowSelectMouseDown: interaction.onRowSelectMouseDown,
+      onCellClick: edit.onCellClick,
+      onCellDblclick: edit.onCellDblclick,
+      onCellContextmenu: interaction.onCellContextmenu,
+      onRowDblclick: interaction.onRowDblclick,
+      onRowContextmenu: interaction.onRowContextmenu,
+      onRowDragOver: interaction.onRowDragOver,
+      onRowDragLeave: interaction.onRowDragLeave,
+      onRowDrop: interaction.onRowDrop,
+      onRowDragStart: interaction.onRowDragStart,
+      onRowDragEnd: interaction.onRowDragEnd,
+      onToggleExpand: interaction.onToggleExpand,
+      onToggleSelect: interaction.onToggleSelect,
+      onCellStartEdit: edit.onCellStartEdit,
+      onCellCommit: edit.onCellCommit,
+      onCellCancel: edit.onCellCancel,
+      onCellUpdateDraft: edit.onCellUpdateDraft,
+      onCellNavigate: edit.onCellNavigate,
+      onRowCommit: edit.onRowCommit,
+      onRowRollback: edit.onRowRollback,
+      onGutterCommit: edit.onGutterCommit,
+    },
+  )
+}
+
+export type { RowEntry }

package/src/composables/createRsDialog.ts

@@ -0,0 +1,357 @@
+import { createApp, h, ref, type App } from 'vue'
+import RsConfigProvider from '../components/RsConfigProvider.vue'
+import RsConfirmDialog from '../components/RsConfirmDialog.vue'
+import RsDialog from '../components/RsDialog.vue'
+import type { RsConfirmOptions } from '../components/dialog-utils'
+import type { RsDialogBeforeClose, RsDialogCloseReason, RsDialogWidth } from '../components/dialog-utils'
+import type { RsFeedbackTone } from '../components/overlay-utils'
+import { defaultLocale, type RsLocale } from '../locale/types'
+import type { RsThemeMode } from '../theme/types'
+
+export type RsConfirmResult = boolean
+
+export type RsConfirmInput = RsConfirmOptions | string
+
+export interface RsDialogOpenOptions {
+  title?: string
+  subtitle?: string
+  description?: string
+  width?: RsDialogWidth
+  tone?: RsFeedbackTone
+  /**
+   * 布局。默认 window（工作窗）。
+   * confirm 仅作历史兼容；新代码的确认/提示请用 rsConfirm / RsConfirmDialog。
+   */
+  layout?: 'window' | 'confirm'
+  showOverlay?: boolean
+  /** 遮罩不透明度 0–1 */
+  overlayOpacity?: number
+  /** 遮罩模糊；number 为 px */
+  overlayBlur?: number | string
+  showClose?: boolean
+  closeOnOverlayClick?: boolean
+  closeOnEsc?: boolean
+  showFooter?: boolean
+  showCancel?: boolean
+  showConfirm?: boolean
+  cancelText?: string
+  confirmText?: string
+  confirmVariant?: 'primary' | 'danger'
+  autoCloseOnConfirm?: boolean
+  beforeClose?: RsDialogBeforeClose
+  teleportTo?: string | HTMLElement
+  /** 默认插槽对应 #body 的渲染函数 */
+  body?: () => unknown
+  footer?: () => unknown
+  onConfirm?: () => void | Promise<void>
+  onCancel?: () => void
+  onAfterClose?: (reason: RsDialogCloseReason) => void
+  /** 命令式挂载时覆盖主题；默认读 document data-rs-theme */
+  theme?: RsThemeMode
+  /** 命令式挂载时覆盖语言；默认读 document data-rs-locale */
+  locale?: RsLocale
+}
+
+export interface RsDialogHandle {
+  close: (reason?: RsDialogCloseReason) => Promise<boolean>
+  destroy: () => void
+}
+
+/** tone 快捷方法：可传完整选项或纯文案（作为 description） */
+export interface RsConfirmApi {
+  (options?: RsConfirmOptions): Promise<RsConfirmResult>
+  warning: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+  danger: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+  info: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+  success: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+  error: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+  confirm: (options?: RsConfirmInput) => Promise<RsConfirmResult>
+}
+
+function readDomTheme(): RsThemeMode {
+  if (typeof document === 'undefined') return 'light'
+  return document.documentElement.getAttribute('data-rs-theme') === 'dark' ? 'dark' : 'light'
+}
+
+function readDomLocale(): RsLocale {
+  if (typeof document === 'undefined') return defaultLocale
+  const value = document.documentElement.getAttribute('data-rs-locale')
+  return value === 'en-US' || value === 'zh-CN' ? value : defaultLocale
+}
+
+function mountHost(
+  render: () => unknown,
+  config?: { theme?: RsThemeMode; locale?: RsLocale },
+): { app: App; container: HTMLDivElement; destroy: () => void } {
+  const container = document.createElement('div')
+  document.body.appendChild(container)
+
+  // themeScope=local：不覆盖主应用的 document 主题；Portal 仍靠页面已有 data-rs-theme。
+  // ConfigProvider 负责 provide locale，使命令式实例的 i18n 默认文案正确。
+  const theme = config?.theme ?? readDomTheme()
+  const locale = config?.locale ?? readDomLocale()
+
+  const app = createApp({
+    setup() {
+      return () =>
+        h(
+          RsConfigProvider,
+          { theme, locale, themeScope: 'local' },
+          { default: () => render() },
+        )
+    },
+  })
+  app.mount(container)
+  const destroy = () => {
+    app.unmount()
+    container.remove()
+  }
+  return { app, container, destroy }
+}
+
+function normalizeConfirmInput(
+  options: RsConfirmInput | undefined,
+  defaults: Partial<RsConfirmOptions>,
+): RsConfirmOptions {
+  if (typeof options === 'string') {
+    return { ...defaults, description: options }
+  }
+  return { ...defaults, ...(options ?? {}) }
+}
+
+/**
+ * 命令式确认框（基于 RsConfirmDialog）。
+ * resolve(true) 为确认，resolve(false) 为取消/关闭。
+ * 若传入 onConfirm 且返回 Promise，确认期间自动 loading，成功后关闭。
+ */
+function rsConfirmCore(options: RsConfirmOptions = {}): Promise<RsConfirmResult> {
+  return new Promise((resolve) => {
+    const open = ref(true)
+    const loading = ref(options.confirmLoading ?? false)
+    let settled = false
+    let confirmed = false
+    const hasAsyncConfirm = typeof options.onConfirm === 'function'
+
+    const settle = (value: boolean) => {
+      if (settled) return
+      settled = true
+      open.value = false
+      if (!value) options.onCancel?.()
+      // 等关闭帧后再销毁，避免动画被硬切
+      window.setTimeout(() => destroy(), 200)
+      resolve(value)
+    }
+
+    const { destroy } = mountHost(
+      () =>
+        h(
+          RsConfirmDialog,
+          {
+            open: open.value,
+            'onUpdate:open': (value: boolean) => {
+              open.value = value
+              if (!value) {
+                // 等同 tick 内的 confirm/cancel 事件先落定，避免 Action 关闭抢先 resolve(false)
+                queueMicrotask(() => settle(confirmed))
+              }
+            },
+            title: options.title,
+            subtitle: options.subtitle,
+            description: options.description,
+            tone: options.tone,
+            icon: options.icon,
+            width: options.width,
+            confirmText: options.confirmText,
+            cancelText: options.cancelText,
+            confirmVariant: options.confirmVariant,
+            showCancel: options.showCancel,
+            confirmLoading: loading.value,
+            beforeClose: options.beforeClose,
+            // 有异步 onConfirm 时由我们在结束后关闭，避免提前关掉
+            autoCloseOnConfirm: !hasAsyncConfirm,
+            showOverlay: options.showOverlay ?? true,
+            overlayOpacity: options.overlayOpacity,
+            overlayBlur: options.overlayBlur,
+            teleportTo: options.teleportTo === false ? false : options.teleportTo,
+            onConfirm: () => {
+              if (!hasAsyncConfirm) {
+                confirmed = true
+                return
+              }
+              loading.value = true
+              void Promise.resolve()
+                .then(() => options.onConfirm?.())
+                .then(() => {
+                  confirmed = true
+                  settle(true)
+                })
+                .catch(() => {
+                  loading.value = false
+                })
+            },
+            onCancel: () => {
+              confirmed = false
+            },
+          },
+          options.extra
+            ? {
+                extra: () => options.extra?.(),
+              }
+            : undefined,
+        ),
+      { theme: options.theme, locale: options.locale },
+    )
+  })
+}
+
+/**
+ * 命令式确认 / 提示 API。
+ * - rsConfirm(options) 基础调用
+ * - rsConfirm.warning / .danger / .confirm 双按钮确认
+ * - rsConfirm.info / .success / .error 默认单按钮提示（showCancel: false）
+ */
+export const rsConfirm: RsConfirmApi = Object.assign(rsConfirmCore, {
+  warning: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'danger',
+        confirmVariant: 'danger',
+        showOverlay: true,
+      }),
+    ),
+  danger: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'danger',
+        confirmVariant: 'danger',
+        showOverlay: true,
+      }),
+    ),
+  info: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'info',
+        confirmVariant: 'primary',
+        showCancel: false,
+        showOverlay: true,
+      }),
+    ),
+  success: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'success',
+        confirmVariant: 'primary',
+        showCancel: false,
+        showOverlay: true,
+      }),
+    ),
+  error: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'danger',
+        confirmVariant: 'danger',
+        showCancel: false,
+        showOverlay: true,
+      }),
+    ),
+  confirm: (options?: RsConfirmInput) =>
+    rsConfirmCore(
+      normalizeConfirmInput(options, {
+        tone: 'warning',
+        confirmVariant: 'primary',
+        showOverlay: true,
+      }),
+    ),
+})
+
+/**
+ * 命令式打开 RsDialog；适合临时表单/说明层。
+ * 确认/危险提示请用 rsConfirm，不要传 layout: 'confirm'。
+ * 复杂长期状态仍建议声明式使用组件。
+ */
+export function openRsDialog(options: RsDialogOpenOptions = {}): RsDialogHandle {
+  const open = ref(true)
+  let destroyed = false
+  let dialogExpose: { close?: (reason?: RsDialogCloseReason) => Promise<boolean> } | null = null
+  const layout = options.layout ?? 'window'
+
+  if (import.meta.env.DEV && layout === 'confirm') {
+    console.warn(
+      '[openRsDialog] layout:"confirm" 已弃用。确认/提示请使用 rsConfirm / RsConfirmDialog；本 API 仅用于工作窗/表单。',
+    )
+  }
+
+  const { destroy: unmount } = mountHost(
+    () =>
+      h(
+        RsDialog,
+        {
+          ref: (instance: unknown) => {
+            dialogExpose = instance as typeof dialogExpose
+          },
+          open: open.value,
+          'onUpdate:open': (value: boolean) => {
+            open.value = value
+            if (!value && !destroyed) {
+              window.setTimeout(() => destroy(), 200)
+            }
+          },
+          title: options.title,
+          description:
+            [options.subtitle, options.description].filter(Boolean).join('\n\n') ||
+            options.description,
+          width: options.width ?? 'md',
+          tone: options.tone,
+          layout,
+          resizable: layout === 'window',
+          fullscreenable: layout === 'window',
+          showOverlay: options.showOverlay ?? true,
+          overlayOpacity: options.overlayOpacity,
+          overlayBlur: options.overlayBlur,
+          showClose: options.showClose,
+          closeOnOverlayClick: options.closeOnOverlayClick,
+          closeOnEsc: options.closeOnEsc,
+          showFooter: options.showFooter ?? true,
+          showCancel: options.showCancel,
+          showConfirm: options.showConfirm,
+          cancelText: options.cancelText,
+          confirmText: options.confirmText,
+          confirmVariant: options.confirmVariant,
+          autoCloseOnConfirm: options.autoCloseOnConfirm ?? true,
+          beforeClose: options.beforeClose,
+          teleportTo: options.teleportTo,
+          deferBodyMount: false,
+          onConfirm: () => {
+            void options.onConfirm?.()
+          },
+          onCancel: () => {
+            options.onCancel?.()
+          },
+          onAfterClose: (reason: RsDialogCloseReason) => {
+            options.onAfterClose?.(reason)
+          },
+        },
+        {
+          body: options.body,
+          footer: options.footer,
+        },
+      ),
+    { theme: options.theme, locale: options.locale },
+  )
+
+  function destroy(): void {
+    if (destroyed) return
+    destroyed = true
+    unmount()
+  }
+
+  return {
+    async close(reason: RsDialogCloseReason = 'programmatic') {
+      if (destroyed) return false
+      if (dialogExpose?.close) return dialogExpose.close(reason)
+      open.value = false
+      return true
+    },
+    destroy,
+  }
+}