niuma-ui 1.1.7 → 1.1.9

package/CHANGELOG.md

@@ -6,6 +6,32 @@
 
 ## [Unreleased]
 
+## [1.1.9] - 2026-08-28
+
+### 修复
+
+- `RsTable`：子表 / 表头默认 `T = any`，避免 inject 子组件把插槽 `row` 收成 `object`。宿主 `#col="{ row }"` 即可用行字段，不必断言。公开类型仍导出 `RsTableSlots` / `RsTableColumnSlotProps`。
+- `RsSelect`：增加泛型 `Value` / `Multiple` / `LabelInValue`，默认单选 `string`。`@update:model-value` 不再是 `string | number | 数组 | labeled` 大联合。数字 value 写 `RsSelect<number>`；`labelInValue` 仍可用。
+- `RsSplitPane`：导出 `RsSplitPaneExpose` / `RsSplitPaneInstance`，模板 ref 用该类型，避免 `InstanceType<typeof RsSplitPane>` 把 vue-tsc 打爆。
+- `RsMonacoEditor`：导出 `RsMonacoEditorExpose`，模板 ref 用该类型，避免 `InstanceType<typeof RsMonacoEditor>` 把 vue-tsc 打爆。
+- `RsInput`：导出 `RsInputExpose` / `RsInputInstance`，模板 ref 用该类型，避免 `InstanceType<typeof RsInput>` 把 vue-tsc 打爆。
+
+运行时兼容 1.1.8；以上为 TypeScript 合约收口。
+
+## [1.1.8] - 2026-08-28
+
+### 新增
+
+- `RsCodeBlock`：`editable`（默认 `false`，只读行为不变）；可写时 `update:code` 同步正文；expose `getSelection` 返回选区文本与起止行号。可写态显示光标。`showBar`（默认 `true`）为 `false` 时隐藏语言条与复制/下载。
+- `RsTree`：`node-contextmenu`（`node, key, event`）；行节点带 `data-tree-key`，便于宿主挂右键菜单。
+- `RsPopover.popupClassName`：附加到弹出层 class，对齐 `RsSelect`。
+- `renderMarkdownInline`：行内 Markdown（不包 `<p>`），并从包入口导出。
+
+### 修复
+
+- `RsButton`：内置 `tooltip` 打开时 Teleport 到 `document.body`（`position: fixed`），避免侧栏 / Dialog 等 overflow 父级裁切。关闭即卸载；延迟 300ms、Escape 关闭；有可见文案时用 `aria-describedby`，仅图标走 `aria-label` 不重复朗读。
+- `RsMarkdown`：GFM 表格对齐 `align`；裸 URL 与行内代码中的 `http(s)` 可点击；任务列表改为 span 标记并禁止消毒后的 `<input>`。
+
 ## [1.1.7] - 2026-08-21
 
 ### 新增
@@ -169,7 +195,9 @@
 
 - 1.0 之前的私有 tag（如 `v0.1.0`）仅作历史记录；新接入请依赖 `v1.0.0` 及之后版本。
 
-[Unreleased]: https://github.com/Blair-Shang/niuma-ui/compare/v1.1.7...HEAD
+[Unreleased]: https://github.com/Blair-Shang/niuma-ui/compare/v1.1.9...HEAD
+[1.1.9]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.1.9
+[1.1.8]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.1.8
 [1.1.7]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.1.7
 [1.1.6]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.1.6
 [1.1.5]: https://github.com/Blair-Shang/niuma-ui/releases/tag/v1.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niuma-ui",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Vue 3 设计系统与 Rs* 组件库（--rs-* token）",

package/src/__tests__/RsButton.spec.ts

@@ -1,7 +1,12 @@
-import { describe, expect, it } from 'vitest'
+import { describe, expect, it, vi } from 'vitest'
 import { mount } from '@vue/test-utils'
 import RsButton from '../components/RsButton.vue'
 
+async function openTooltip(wrapper: ReturnType<typeof mount>) {
+  await wrapper.trigger('mouseenter')
+  await vi.advanceTimersByTimeAsync(300)
+}
+
 describe('RsButton', () => {
   it('renders slot', () => {
     const wrapper = mount(RsButton, {
@@ -92,17 +97,23 @@ describe('RsButton', () => {
       props: { icon: 'search', iconOnly: true, tooltip: '搜索' },
     })
     expect(wrapper.classes()).toContain('rs-btn--icon-only')
-    expect(wrapper.find('.rs-btn__tooltip').text()).toBe('搜索')
     expect(wrapper.attributes('aria-label')).toBe('搜索')
+    expect(document.body.querySelector('.rs-btn__tooltip')).toBeNull()
+    wrapper.unmount()
   })
 
-  it('iconOnly uses slot text in floating tooltip when tooltip omitted', () => {
+  it('iconOnly uses slot text in floating tooltip when tooltip omitted', async () => {
+    vi.useFakeTimers()
     const wrapper = mount(RsButton, {
       props: { icon: 'message-square', iconOnly: true },
       slots: { default: '消息' },
+      attachTo: document.body,
     })
     expect(wrapper.find('.rs-btn__label').exists()).toBe(false)
-    expect(wrapper.find('.rs-btn__tooltip').text()).toBe('消息')
+    await openTooltip(wrapper)
+    expect(document.body.querySelector('.rs-btn__tooltip')?.textContent).toBe('消息')
+    wrapper.unmount()
+    vi.useRealTimers()
   })
 
   it('reveal-label mode keeps label in dom with reveal class', () => {
@@ -115,12 +126,34 @@ describe('RsButton', () => {
     expect(wrapper.text()).toContain('新建对话')
   })
 
-  it('shows tooltip when tooltip prop is set with label', () => {
+  it('shows tooltip when tooltip prop is set with label', async () => {
+    vi.useFakeTimers()
     const wrapper = mount(RsButton, {
       props: { icon: 'plus', tooltip: 'Ctrl+N' },
       slots: { default: '新建' },
+      attachTo: document.body,
+    })
+    await openTooltip(wrapper)
+    const tip = document.body.querySelector('.rs-btn__tooltip')
+    expect(tip?.textContent).toBe('Ctrl+N')
+    expect(wrapper.attributes('aria-describedby')).toBe(tip?.id)
+    wrapper.unmount()
+    vi.useRealTimers()
+  })
+
+  it('portals tooltip to document.body so overflow parents cannot clip it', async () => {
+    vi.useFakeTimers()
+    const wrapper = mount(RsButton, {
+      props: { icon: 'plus', iconOnly: true, tooltip: '新建' },
+      attachTo: document.body,
     })
-    expect(wrapper.find('.rs-btn__tooltip').text()).toBe('Ctrl+N')
+    await openTooltip(wrapper)
+    const tip = document.body.querySelector('.rs-btn__tooltip')
+    expect(tip).not.toBeNull()
+    expect(wrapper.element.contains(tip)).toBe(false)
+    expect(tip?.parentElement).toBe(document.body)
+    wrapper.unmount()
+    vi.useRealTimers()
   })
 
   it('loading: applies class, keeps enabled, shows inline spinner and label', async () => {

package/src/__tests__/RsDialog.spec.ts

@@ -375,7 +375,7 @@ describe('RsDialog', () => {
     const wrapper = mount(Host, { attachTo: document.body })
     await flushPromises()
     const closeBtn = document.body.querySelector('.rs-dialog__actions button') as HTMLElement
-    expect(closeBtn.querySelector('.rs-btn__tooltip')?.textContent).toContain('Close')
+    expect(closeBtn?.getAttribute('aria-label')).toContain('Close')
     wrapper.unmount()
   })
 

package/src/__tests__/RsDrawer.spec.ts

@@ -232,7 +232,13 @@ describe('RsDrawer', () => {
     const wrapper = mount(Host, { attachTo: document.body })
     await flushPromises()
     const closeBtn = document.body.querySelector('.rs-drawer__header button') as HTMLElement
-    expect(closeBtn.querySelector('.rs-btn__tooltip')?.textContent).toContain('Close')
+    expect(closeBtn).not.toBeNull()
+    vi.useFakeTimers()
+    closeBtn.dispatchEvent(new MouseEvent('mouseenter', { bubbles: true }))
+    await vi.advanceTimersByTimeAsync(300)
+    await flushPromises()
+    expect(document.body.querySelector('.rs-btn__tooltip')?.textContent).toContain('Close')
+    vi.useRealTimers()
     wrapper.unmount()
   })
 

package/src/__tests__/RsMarkdown.spec.ts

@@ -41,6 +41,12 @@ describe('markdown-utils', () => {
     expect(html).not.toContain('javascript:')
   })
 
+  it('keeps GFM table alignment attributes', () => {
+    const html = renderMarkdown('| a | b |\n| ---: | :---: |\n| 1 | 2 |')
+    expect(html).toContain('align="right"')
+    expect(html).toContain('align="center"')
+  })
+
   it('opens http links in a new tab with noopener', () => {
     const html = renderMarkdown('[docs](https://example.com)')
     expect(html).toContain('href="https://example.com"')
@@ -48,6 +54,37 @@ describe('markdown-utils', () => {
     expect(html).toContain('rel="noopener noreferrer"')
   })
 
+  it('autolinks bare http addresses', () => {
+    const html = renderMarkdown('然后打开 http://127.0.0.1:3000')
+    expect(html).toContain('href="http://127.0.0.1:3000"')
+    expect(html).toContain('target="_blank"')
+  })
+
+  it('turns inline-code http addresses into links', () => {
+    const html = renderMarkdown('然后打开 `http://127.0.0.1:3000`')
+    expect(html).toContain('<code>http://127.0.0.1:3000</code>')
+    expect(html).toContain('href="http://127.0.0.1:3000"')
+    expect(html).toContain('target="_blank"')
+  })
+
+  it('does not linkify inline code that is not a URL', () => {
+    const html = renderMarkdown('run `npm start`')
+    expect(html).toContain('<code>npm start</code>')
+    expect(html).not.toContain('href=')
+  })
+
+  it('renders GFM task lists without input tags', () => {
+    const html = renderMarkdown('- [ ] todo\n- [x] done')
+    expect(html).toContain('rs-markdown__task')
+    expect(html).toContain('rs-markdown__task--on')
+    expect(html.toLowerCase()).not.toContain('<input')
+  })
+
+  it('strips raw HTML input tags', () => {
+    const html = renderMarkdown('Hello <input type="text" name="x">')
+    expect(html.toLowerCase()).not.toContain('<input')
+  })
+
   it('sanitizes raw HTML injection', () => {
     const html = renderMarkdown('Hello <img src=x onerror=alert(1)>')
     expect(html.toLowerCase()).not.toContain('onerror')

package/src/__tests__/RsPopover.spec.ts

@@ -50,6 +50,20 @@ describe('RsPopover', () => {
     wrapper.unmount()
   })
 
+  it('applies popupClassName on content', async () => {
+    const wrapper = mount(RsPopover, {
+      props: { open: true, popupClassName: 'custom-pop' },
+      slots: {
+        default: '<button type="button" class="trigger">Open</button>',
+        content: '<p>Custom chrome</p>',
+      },
+      attachTo: document.body,
+    })
+    await flushPromises()
+    expect(document.body.querySelector('.rs-popover__content.custom-pop')).not.toBeNull()
+    wrapper.unmount()
+  })
+
   it('lazy-mounts content when closed by default', async () => {
     const wrapper = mount(RsPopover, {
       slots: {

package/src/__tests__/rs-select-model.types.spec.ts

@@ -0,0 +1,28 @@
+import { describe, expectTypeOf, it } from 'vitest'
+import type { RsSelectLabeledValue, RsSelectResolvedModel } from '../components/select-utils'
+
+describe('RsSelect resolved model', () => {
+  it('defaults to a string (single select)', () => {
+    expectTypeOf<RsSelectResolvedModel>().toEqualTypeOf<string>()
+  })
+
+  it('multiple literal true is a string array', () => {
+    expectTypeOf<RsSelectResolvedModel<string, true>>().toEqualTypeOf<string[]>()
+  })
+
+  it('number value stays number | empty', () => {
+    expectTypeOf<RsSelectResolvedModel<number>>().toEqualTypeOf<number | ''>()
+  })
+
+  it('labelInValue literal true is labeled or empty', () => {
+    expectTypeOf<RsSelectResolvedModel<string, false, true>>().toEqualTypeOf<
+      RsSelectLabeledValue | ''
+    >()
+  })
+
+  it('boolean multiple keeps the union so runtime flags still type-check', () => {
+    expectTypeOf<RsSelectResolvedModel<string, boolean>>().toEqualTypeOf<
+      string | string[]
+    >()
+  })
+})

package/src/__tests__/rs-table-slots.types.spec.ts

@@ -0,0 +1,20 @@
+import { describe, expectTypeOf, it } from 'vitest'
+import type {
+  RsTableColumnSlotProps,
+  RsTableSlots,
+} from '../components/table/rs-table-props'
+
+describe('RsTable slot types', () => {
+  it('column slot row is the table generic', () => {
+    type Row = { id: string; name: string }
+    expectTypeOf<RsTableColumnSlotProps<Row>['row']>().toEqualTypeOf<Row>()
+    expectTypeOf<RsTableColumnSlotProps<Row>['index']>().toEqualTypeOf<number>()
+  })
+
+  it('named column slots stay callable with the row generic', () => {
+    type Row = { id: string; name: string }
+    type NameSlot = NonNullable<RsTableSlots<Row>['name']>
+    expectTypeOf<NameSlot>().toBeFunction()
+    expectTypeOf<NameSlot>().parameter(0).toMatchTypeOf<{ row: Row; index: number }>()
+  })
+})

package/src/components/RsButton.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { computed, nextTick, ref, useSlots, watch } from 'vue'
+import { computed, nextTick, onUnmounted, ref, useId, useSlots, watch } from 'vue'
 import type { RsComponentSize, RsRadius } from '../theme/types'
 import { RS_COMPONENT_SIZE_ICON_PX } from '../theme/types'
 import {
@@ -35,7 +35,10 @@ const props = withDefaults(
     iconSize?: number
     /** 仅显示图标，文字通过 tooltip / slot 悬浮展示 */
     iconOnly?: boolean
-    /** 悬浮提示文案 */
+    /**
+     * 悬浮提示。打开时 Teleport 到 `document.body`（对齐 WAI-ARIA APG Tooltip / Reka Portal）。
+     * 仅图标按钮时作可视提示；无障碍名称仍走 `aria-label`，避免与 tip 重复朗读。
+     */
     tooltip?: string
     /** icon-only 时无障碍标签（与 tooltip 二选一，避免与外部 RsTooltip 重复） */
     ariaLabel?: string
@@ -106,24 +109,120 @@ const ariaLabel = computed(() => {
   return props.ariaLabel || props.tooltip || undefined
 })
 
-/** tooltip 水平对齐方式：center / left / right */
-const tooltipAlign = ref<'center' | 'left' | 'right'>('center')
+/** 与 RsTooltipProvider 默认一致：避免路过按钮时闪一下 */
+const TOOLTIP_DELAY_MS = 300
+
+const tipId = useId()
+const tipOpen = ref(false)
+const tipStyle = ref<Record<string, string>>({})
+
+let openTimer: ReturnType<typeof setTimeout> | null = null
+let posRaf = 0
+
+/** 有可见文案时 tip 是补充说明；仅图标时名称已在 aria-label，不再 describedby（避免读两遍） */
+const tipDescribedBy = computed(() =>
+  tipOpen.value && showFloatingText.value && !props.iconOnly ? tipId : undefined,
+)
+
+function clearOpenTimer(): void {
+  if (openTimer == null) return
+  clearTimeout(openTimer)
+  openTimer = null
+}
 
-function updateTooltipAlign(): void {
+function updateTipPosition(): void {
   const el = btnRef.value
   if (!el) return
   const rect = el.getBoundingClientRect()
   const mid = rect.left + rect.width / 2
   const vw = window.innerWidth
+  const gap = 6
+  let left = mid
+  let transform = 'translateX(-50%)'
   if (mid > vw * 0.72) {
-    tooltipAlign.value = 'right'
+    left = rect.right
+    transform = 'translateX(-100%)'
   } else if (mid < vw * 0.28) {
-    tooltipAlign.value = 'left'
+    left = rect.left
+    transform = 'none'
+  }
+  tipStyle.value = {
+    top: `${Math.round(rect.bottom + gap)}px`,
+    left: `${Math.round(left)}px`,
+    transform,
+  }
+}
+
+function scheduleTipPosition(): void {
+  if (typeof window === 'undefined' || posRaf) return
+  posRaf = window.requestAnimationFrame(() => {
+    posRaf = 0
+    if (tipOpen.value) updateTipPosition()
+  })
+}
+
+function onDocKeydown(e: KeyboardEvent): void {
+  if (e.key !== 'Escape' || !tipOpen.value) return
+  e.preventDefault()
+  e.stopPropagation()
+  closeTip()
+}
+
+function bindTipFollow(on: boolean): void {
+  if (typeof window === 'undefined') return
+  if (on) {
+    window.addEventListener('scroll', scheduleTipPosition, true)
+    window.addEventListener('resize', scheduleTipPosition)
+    window.addEventListener('keydown', onDocKeydown, true)
   } else {
-    tooltipAlign.value = 'center'
+    window.removeEventListener('scroll', scheduleTipPosition, true)
+    window.removeEventListener('resize', scheduleTipPosition)
+    window.removeEventListener('keydown', onDocKeydown, true)
+    if (posRaf) {
+      window.cancelAnimationFrame(posRaf)
+      posRaf = 0
+    }
+  }
+}
+
+function openTipNow(): void {
+  if (!showFloatingText.value || props.disabled || props.loading) return
+  updateTipPosition()
+  if (!tipOpen.value) {
+    tipOpen.value = true
+    bindTipFollow(true)
   }
 }
 
+function scheduleOpenTip(): void {
+  if (!showFloatingText.value || props.disabled || props.loading) return
+  clearOpenTimer()
+  openTimer = setTimeout(() => {
+    openTimer = null
+    openTipNow()
+  }, TOOLTIP_DELAY_MS)
+}
+
+function closeTip(): void {
+  clearOpenTimer()
+  if (!tipOpen.value) return
+  tipOpen.value = false
+  bindTipFollow(false)
+}
+
+function onFocus(e: FocusEvent): void {
+  const el = e.currentTarget
+  if (!(el instanceof HTMLElement)) return
+  if (el.matches(':focus-visible')) scheduleOpenTip()
+}
+
+watch(
+  () => props.disabled || props.loading,
+  (off) => {
+    if (off) closeTip()
+  },
+)
+
 watch(
   () => props.loading,
   async (loading) => {
@@ -140,6 +239,10 @@ watch(
     }
   },
 )
+
+onUnmounted(() => {
+  closeTip()
+})
 </script>
 
 <template>
@@ -153,7 +256,11 @@ watch(
     :aria-busy="loading || undefined"
     :aria-disabled="disabled || loading || undefined"
     :aria-label="ariaLabel"
-    @mouseenter="updateTooltipAlign"
+    :aria-describedby="tipDescribedBy"
+    @mouseenter="scheduleOpenTip"
+    @mouseleave="closeTip"
+    @focus="onFocus"
+    @blur="closeTip"
   >
     <span v-if="loading" class="rs-btn__spinner" aria-hidden="true">
       <span class="rs-btn__spinner-ring" />
@@ -172,15 +279,18 @@ watch(
     >
       <slot />
     </span>
-    <span
-      v-if="showFloatingText"
-      class="rs-btn__tooltip"
-      :class="`rs-btn__tooltip--${tooltipAlign}`"
-      role="tooltip"
-    >
-      <template v-if="tooltip">{{ tooltip }}</template>
-      <slot v-else-if="iconOnly" />
-    </span>
+    <Teleport to="body">
+      <span
+        v-if="tipOpen"
+        :id="tipId"
+        class="rs-btn__tooltip"
+        :style="tipStyle"
+        role="tooltip"
+      >
+        <template v-if="tooltip">{{ tooltip }}</template>
+        <slot v-else-if="iconOnly" />
+      </span>
+    </Teleport>
   </button>
 </template>
 
@@ -464,10 +574,8 @@ watch(
   opacity: 1;
 }
 .rs-btn__tooltip {
-  position: absolute;
-  left: 50%;
-  top: calc(100% + 0.375rem);
-  transform: translateX(-50%) translateY(-2px);
+  position: fixed;
+  z-index: calc(var(--rs-z-modal) + 2);
   padding: 0.25rem 0.5rem;
   border-radius: var(--rs-radius-sm);
   border: 1px solid var(--rs-border);
@@ -478,36 +586,7 @@ watch(
   line-height: 1.25rem;
   white-space: nowrap;
   box-shadow: var(--rs-shadow-sm);
-  opacity: 0;
   pointer-events: none;
-  transition:
-    opacity 0.15s ease,
-    transform 0.15s ease;
-  z-index: var(--rs-z-tooltip);
-}
-/* 靠左边的按钮：tooltip 左对齐 */
-.rs-btn__tooltip--left {
-  left: 0;
-  transform: translateY(-2px);
-}
-/* 靠右边的按钮：tooltip 右对齐 */
-.rs-btn__tooltip--right {
-  left: auto;
-  right: 0;
-  transform: translateY(-2px);
-}
-.rs-btn:hover:not(:disabled) .rs-btn__tooltip,
-.rs-btn:focus-visible .rs-btn__tooltip {
-  opacity: 1;
-  transform: translateX(-50%) translateY(0);
-}
-.rs-btn:hover:not(:disabled) .rs-btn__tooltip--left,
-.rs-btn:focus-visible .rs-btn__tooltip--left {
-  transform: translateY(0);
-}
-.rs-btn:hover:not(:disabled) .rs-btn__tooltip--right,
-.rs-btn:focus-visible .rs-btn__tooltip--right {
-  transform: translateY(0);
 }
 @keyframes rs-spin {
   to {

package/src/components/RsCodeBlock.vue

@@ -19,10 +19,18 @@ const props = withDefaults(
     downloadFilename?: string
     /** 覆盖内置"下载"文案 */
     downloadLabel?: string
+    /** 为 true 时允许改正文，并向外同步 */
+    editable?: boolean
+    /** 为 false 时隐藏语言条与复制/下载（嵌入编辑器用） */
+    showBar?: boolean
   }>(),
-  { lang: 'text' },
+  { lang: 'text', editable: false, showBar: true },
 )
 
+const emit = defineEmits<{
+  'update:code': [value: string]
+}>()
+
 const { t } = useRsI18n()
 
 const editorEl = ref<HTMLElement | null>(null)
@@ -62,10 +70,15 @@ async function initEditor() {
     doc: props.code,
     extensions: [
       basicSetup,
-      EditorView.editable.of(false),
+      EditorView.editable.of(props.editable),
       EditorView.lineWrapping,
       ...langExts,
       ...(isLight() ? [] : [oneDark]),
+      EditorView.updateListener.of((u) => {
+        if (props.editable && u.docChanged) {
+          emit('update:code', u.state.doc.toString())
+        }
+      }),
     ],
   })
 
@@ -98,8 +111,29 @@ onUnmounted(() => {
   }
 })
 
-// lang 变化时重新初始化（切换语言高亮）
-watch(() => props.lang, () => { void initEditor() })
+watch(() => [props.lang, props.editable] as const, () => { void initEditor() })
+
+function getSelection(): { text: string; startLine: number; endLine: number } | null {
+  const ed = view.value
+  if (!ed) {
+    return null
+  }
+  const range = ed.state.selection.main
+  if (range.empty) {
+    return null
+  }
+  const text = ed.state.sliceDoc(range.from, range.to)
+  if (!text.trim()) {
+    return null
+  }
+  return {
+    text,
+    startLine: ed.state.doc.lineAt(range.from).number,
+    endLine: ed.state.doc.lineAt(range.to).number,
+  }
+}
+
+defineExpose({ getSelection })
 
 // 代码内容更新时同步文档（不需要重建整个编辑器）
 watch(
@@ -151,8 +185,14 @@ function download() {
 </script>
 
 <template>
-  <figure class="rs-code-block">
-    <figcaption class="rs-code-block__bar">
+  <figure
+    class="rs-code-block"
+    :class="{
+      'rs-code-block--editable': editable,
+      'rs-code-block--plain': !showBar,
+    }"
+  >
+    <figcaption v-if="showBar" class="rs-code-block__bar">
       <span class="rs-code-block__lang">{{ lang }}</span>
       <div class="rs-code-block__actions">
         <button
@@ -182,6 +222,15 @@ function download() {
   font-size: var(--rs-font-size-sm);
 }
 
+.rs-code-block--plain {
+  border: 0;
+  border-radius: 0;
+}
+
+.rs-code-block--plain .rs-code-block__editor :deep(.cm-editor) {
+  max-height: none;
+}
+
 .rs-code-block__bar {
   display: flex;
   align-items: center;
@@ -257,7 +306,7 @@ function download() {
 }
 
 /* 只读时隐藏光标，保持纯展示外观 */
-.rs-code-block__editor :deep(.cm-cursor) {
+.rs-code-block:not(.rs-code-block--editable) :deep(.cm-cursor) {
   display: none;
 }
 

package/src/components/RsInput.vue

@@ -31,7 +31,19 @@ import RsVNodeHost from './RsVNodeHost.vue'
 
 import RsIcon from './RsIcon.vue'
 
+/**
+ * RsInput 模板 ref 请用此类型。
+ * 不要写 `InstanceType<typeof RsInput>`：组件实例类型过深，vue-tsc 会报 Excessive stack depth。
+ */
+export interface RsInputExpose {
+  validate: (trigger?: RsFormRuleTrigger) => Promise<boolean>
+  clearValidation: () => void
+  setValue: (value: unknown) => void
+  setError: (message: string) => void
+}
 
+/** 模板 ref 实例：expose + 根节点 */
+export type RsInputInstance = RsInputExpose & { $el: HTMLElement }
 
 const { t } = useRsI18n()
 
@@ -537,7 +549,7 @@ useRsFormField(() => ({
   setError,
 }))
 
-defineExpose({
+defineExpose<RsInputExpose>({
   validate: runValidate,
   clearValidation,
   setValue,

package/src/components/RsMarkdown.vue

@@ -247,6 +247,10 @@ function setMode(next: RsMarkdownMode): void {
   color: var(--rs-primary);
   text-decoration: underline;
   text-underline-offset: 0.15em;
+  cursor: pointer;
+}
+.rs-markdown__prose a code {
+  color: inherit;
 }
 .rs-markdown__prose a:hover {
   opacity: 0.85;
@@ -322,8 +326,23 @@ function setMode(next: RsMarkdownMode): void {
   height: auto;
   border-radius: var(--rs-radius);
 }
-.rs-markdown__prose input[type='checkbox'] {
-  margin-right: 0.35em;
+.rs-markdown__task {
+  display: inline-block;
+  width: 0.9em;
+  height: 0.9em;
+  margin: 0 0.4em 0.05em 0;
+  border: 1px solid var(--rs-border);
+  border-radius: 0.15em;
   vertical-align: middle;
+  background: var(--rs-surface);
+}
+.rs-markdown__task--on {
+  background: var(--rs-primary);
+  border-color: var(--rs-primary);
+  box-shadow: inset 0 0 0 0.12em var(--rs-surface);
+}
+.rs-markdown__prose li:has(> .rs-markdown__task) {
+  list-style: none;
+  margin-left: -1.15em;
 }
 </style>

package/src/components/RsMonacoEditor.vue

@@ -31,6 +31,16 @@ export interface MonacoCompletionSnippet {
   preselect?: boolean
 }
 
+/**
+ * RsMonacoEditor 模板 ref 请用此类型。
+ * 不要写 `InstanceType<typeof RsMonacoEditor>`：组件实例类型过深，vue-tsc 会报 Excessive stack depth。
+ */
+export interface RsMonacoEditorExpose {
+  format: () => void
+  getEditor: () => import('monaco-editor').editor.IStandaloneCodeEditor | null
+  revealLine: (line: number) => void
+}
+
 /** MonacoCompletionContext 描述一次补全请求的编辑器上下文。 */
 export interface MonacoCompletionContext {
   text: string
@@ -498,7 +508,7 @@ watch(() => props.completionTriggerCharacters, () => applySnippets(), { deep: tr
 watch(() => props.completionPrefixResolver, () => applySnippets())
 
 // ── Expose ────────────────────────────────────────────────────────────
-defineExpose({
+defineExpose<RsMonacoEditorExpose>({
   /** 格式化文档（等价于 Shift+Alt+F） */
   format(): void {
     editor?.getAction('editor.action.formatDocument')?.run().catch(() => undefined)

package/src/components/RsPopover.vue

@@ -14,6 +14,8 @@ const props = withDefaults(
     width?: RsPopoverWidth
     lazyMount?: boolean
     forceMount?: boolean
+    /** 附加到弹出层，对齐 RsSelect popupClassName */
+    popupClassName?: string
   }>(),
   {
     side: 'bottom',
@@ -38,7 +40,7 @@ const portalMounted = computed(() => props.forceMount || !props.lazyMount || ope
     <PopoverPortal v-if="portalMounted">
       <PopoverContent
         class="rs-popover__content"
-        :class="`rs-popover__content--${width}`"
+        :class="[`rs-popover__content--${width}`, popupClassName]"
         :side="side"
         :align="align"
         :side-offset="sideOffset"

package/src/components/RsSelect.vue

@@ -1,5 +1,5 @@
-<script setup lang="ts">
-import { computed, ref, useAttrs } from 'vue'
+<script setup lang="ts" generic="Value extends string | number = string, Multiple extends boolean = false, LabelInValue extends boolean = false">
+import { computed, ref, useAttrs, type ModelRef } from 'vue'
 
 import { useRsI18n } from '../composables/useRsI18n'
 import type { RsComponentSize, RsRadius } from '../theme/types'
@@ -31,6 +31,7 @@ import {
   type RsSelectOptionFilterProp,
   type RsSelectOptionsInput,
   type RsSelectPlacement,
+  type RsSelectResolvedModel,
   type RsSelectStatus,
   type RsSelectValue,
 } from './select-utils'
@@ -53,7 +54,9 @@ import {
 
 defineOptions({ inheritAttrs: false })
 
-const model = defineModel<RsSelectModelValue>({ default: '' })
+const model = defineModel<RsSelectResolvedModel<Value, Multiple, LabelInValue>>({
+  default: '' as never,
+})
 const open = defineModel<boolean>('open', { default: false })
 const searchQuery = defineModel<string>('searchValue', { default: '' })
 
@@ -69,7 +72,7 @@ const props = withDefaults(
      * 开启后若未显式关 searchable，将自动启用搜索框。
      */
     creatable?: boolean
-    multiple?: boolean
+    multiple?: Multiple
     required?: boolean
     name?: string
     clearable?: boolean
@@ -98,7 +101,7 @@ const props = withDefaults(
     maxTagCount?: number
     maxTagPlaceholder?: string | ((omitted: number) => string)
     multipleLimit?: number
-    labelInValue?: boolean
+    labelInValue?: LabelInValue
     filterSort?: RsSelectFilterSort
     maxTagTextLength?: number
     maxTagTooltip?: boolean
@@ -125,7 +128,6 @@ const props = withDefaults(
     disabled: false,
     searchable: false,
     creatable: false,
-    multiple: false,
     required: false,
     clearable: false,
     virtual: false,
@@ -137,7 +139,6 @@ const props = withDefaults(
     filterOption: true,
     optionFilterProp: 'label',
     optionLabelProp: 'label',
-    labelInValue: false,
     maxTagTooltip: true,
     autoClearSearchValue: true,
     fillSearchWithValue: false,
@@ -198,7 +199,7 @@ const {
   removeTag,
   setValue,
   resetSearch,
-} = useRsSelect(props, model, open, searchQuery, emit, t)
+} = useRsSelect(props, model as ModelRef<RsSelectModelValue>, open, searchQuery, emit, t)
 
 const resolvedDisabled = computed(() => props.disabled || formContext?.disabled.value || false)
 const resolvedSize = useResolvedRsComponentSize(() => props.size)

package/src/components/RsSplitPane.vue

@@ -13,6 +13,7 @@ import {
   roundSize,
   splitSizesEqual,
   type RsSplitOrientation,
+  type RsSplitPaneExpose,
   type RsSplitPaneItem,
 } from './split-pane-utils'
 
@@ -440,7 +441,12 @@ function reset(): void {
   emit('resize-end', sizes.value.slice())
 }
 
-defineExpose({ collapse, expand, reset, getSizes: () => sizes.value.slice() })
+defineExpose<RsSplitPaneExpose>({
+  collapse,
+  expand,
+  reset,
+  getSizes: () => sizes.value.slice(),
+})
 </script>
 
 <template>

package/src/components/RsTable.vue

@@ -1,4 +1,4 @@
-<script setup lang="ts" generic="T extends import('./table-utils').RsTableRowData">
+<script setup lang="ts" generic="T extends import('./table-utils').RsTableRowData = any">
 import { computed, ref, useSlots } from 'vue'
 import RsContextMenu from './RsContextMenu.vue'
 import { assembleRsTableApi } from '../composables/assembleRsTableApi'

package/src/components/RsTree.vue

@@ -116,6 +116,7 @@ const props = withDefaults(
 const emit = defineEmits<{
   'node-click': [node: RsTreeNode, key: string]
   'node-dblclick': [node: RsTreeNode, key: string]
+  'node-contextmenu': [node: RsTreeNode, key: string, event: MouseEvent]
   expand: [key: string, expanded: boolean]
   check: [keys: string[], halfCheckedKeys: string[], node: RsTreeNode, key: string]
   'node-drop': [dragKey: string, dropKey: string, position: RsTreeDropPosition]
@@ -742,7 +743,9 @@ defineExpose({
               'rs-tree__row--drop-after': dropTargetKey === entry.key && dropPosition === 'after',
               'rs-tree__row--last': showLine && entry.isLast,
             }"
+            :data-tree-key="entry.key"
             :style="[rowIndentStyle(entry.depth), { minHeight: `${rowHeight}px` }]"
+            @contextmenu="emit('node-contextmenu', entry.node, entry.key, $event)"
             @keydown="handleKeydown"
             @dragstart="onDragStart(entry.key, $event)"
             @dragover="onDragOver(entry.key, $event)"

package/src/components/markdown-utils.ts

@@ -29,6 +29,21 @@ export function isSafeHref(href: string): boolean {
   return /^(https?:|mailto:)/i.test(value)
 }
 
+/** 行内代码整段就是 http(s) 地址时，转成可点击链接（模型常用反引号包 URL）。 */
+function isStandaloneHttpUrl(text: string): boolean {
+  const value = text.trim()
+  if (!value || /\s/.test(value)) return false
+  if (!/^https?:\/\//i.test(value)) return false
+  return isSafeHref(value)
+}
+
+function renderSafeLink(href: string, innerHtml: string, title?: string): string {
+  const url = href.trim()
+  if (!isSafeHref(url)) return innerHtml
+  const titleAttr = title ? ` title="${escapeHtml(title)}"` : ''
+  return `<a href="${escapeHtml(url)}"${titleAttr} target="_blank" rel="noopener noreferrer">${innerHtml}</a>`
+}
+
 export function isSafeImageSrc(src: string): boolean {
   const value = src.trim()
   if (!value) return false
@@ -60,11 +75,19 @@ function wrapTables(html: string): string {
   })
 }
 
+function renderTaskMarker(checked: boolean): string {
+  const on = checked ? ' rs-markdown__task--on' : ''
+  return `<span class="rs-markdown__task${on}" aria-hidden="true"></span> `
+}
+
 function createMarked(breaks: boolean): Marked {
   return new Marked({
     gfm: true,
     breaks,
     renderer: {
+      checkbox({ checked }) {
+        return renderTaskMarker(Boolean(checked))
+      },
       code({ text, lang }) {
         return renderCodeBlock(text, lang)
       },
@@ -73,10 +96,12 @@ function createMarked(breaks: boolean): Marked {
         token: Tokens.Link,
       ) {
         const text = this.parser.parseInline(token.tokens)
-        const href = token.href?.trim() ?? ''
-        if (!isSafeHref(href)) return text
-        const title = token.title ? ` title="${escapeHtml(token.title)}"` : ''
-        return `<a href="${escapeHtml(href)}"${title} target="_blank" rel="noopener noreferrer">${text}</a>`
+        return renderSafeLink(token.href ?? '', text, token.title ?? undefined)
+      },
+      codespan({ text }) {
+        const inner = `<code>${escapeHtml(text)}</code>`
+        if (!isStandaloneHttpUrl(text)) return inner
+        return renderSafeLink(text.trim(), inner)
       },
       image({ href, title, text }) {
         const src = href?.trim() ?? ''
@@ -106,9 +131,32 @@ export function renderMarkdown(source = '', options?: RsMarkdownRenderOptions):
   if (!source.trim()) return ''
   const breaks = options?.breaks !== false
   const dirty = wrapTables(getMarked(breaks).parse(source, { async: false }) as string)
+  return sanitizeMarkdownHtml(dirty)
+}
+
+/** 行内 Markdown（不包 <p>），供对话里夹杂公式的片段使用。 */
+export function renderMarkdownInline(source = ''): string {
+  if (!source) return ''
+  const dirty = getMarked(true).parseInline(source, { async: false }) as string
+  return sanitizeMarkdownHtml(dirty)
+}
+
+function sanitizeMarkdownHtml(dirty: string): string {
   return DOMPurify.sanitize(dirty, {
     USE_PROFILES: { html: true },
-    ADD_ATTR: ['class', 'target', 'rel', 'loading', 'decoding', 'alt', 'src', 'data-rs-md-lang'],
+    FORBID_TAGS: ['input', 'form', 'textarea', 'select', 'option', 'button'],
+    ADD_ATTR: [
+      'class',
+      'target',
+      'rel',
+      'loading',
+      'decoding',
+      'alt',
+      'src',
+      'data-rs-md-lang',
+      'align',
+      'start',
+    ],
   })
 }
 

package/src/components/select-utils.ts

@@ -57,6 +57,27 @@ export type RsSelectModelValue =
   | RsSelectLabeledValue[]
   | ''
 
+/**
+ * 按泛型收窄后的 v-model。
+ * 默认单选、值为 string：宿主 `@update:model-value="(v: string) => void"` 可直接赋值。
+ * `multiple` / `labelInValue` 为字面量 true 时收成数组或 labeled；为 `boolean` 时保留联合。
+ */
+export type RsSelectResolvedModel<
+  Value extends RsSelectValue = string,
+  Multiple extends boolean = false,
+  LabelInValue extends boolean = false,
+> = LabelInValue extends true
+  ? Multiple extends true
+    ? RsSelectLabeledValue[]
+    : Multiple extends false
+      ? RsSelectLabeledValue | ''
+      : RsSelectLabeledValue | RsSelectLabeledValue[] | ''
+  : Multiple extends true
+    ? Value[]
+    : Multiple extends false
+      ? Value | ''
+      : Value | Value[] | ''
+
 /**
  * Reka ComboboxItem 禁止 value 为空串（空串表示未选中 / placeholder）。
  * 选项若传入 value: ''，对内映射为此哨兵，避免崩溃；对外读写仍为 ''。

package/src/components/split-pane-utils.ts

@@ -27,6 +27,20 @@ export interface RsSplitPaneItem {
   resizerHandle?: boolean
 }
 
+/**
+ * RsSplitPane 模板 ref 请用此类型。
+ * 不要写 `InstanceType<typeof RsSplitPane>`：组件实例类型过深，vue-tsc 会报 Excessive stack depth。
+ */
+export interface RsSplitPaneExpose {
+  collapse: (key: string) => void
+  expand: (key: string, toSize?: number) => void
+  reset: () => void
+  getSizes: () => number[]
+}
+
+/** 模板 ref 实例：expose + 根节点 */
+export type RsSplitPaneInstance = RsSplitPaneExpose & { $el: HTMLElement }
+
 /** 由 RsSplitPaneItem 解析出的规范化约束 */
 export interface RsSplitConstraint {
   min: number

package/src/components/table/RsTableBody.vue

@@ -1,4 +1,4 @@
-<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData">
+<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData = any">
 /**
  * RsTable 表体视图：通过 ViewContext inject 取状态（多表互不串扰）。
  * 行级 v-memo 保留，避免抽离后丢失细粒度跳过渲染。

package/src/components/table/RsTableBodyRow.vue

@@ -1,4 +1,4 @@
-<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData">
+<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData = any">
 import type { RsTableColumn, RsTableRowDropPosition, RsTableSelectionType } from '../table-utils'
 import type { RsTableCellEditTrigger } from './table-edit-utils'
 import RsTableCell from './RsTableCell.vue'

package/src/components/table/RsTableCell.vue

@@ -1,4 +1,4 @@
-<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData">
+<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData = any">
 import { computed, ref, watch } from 'vue'
 import type { RsTableColumn } from '../table-utils'
 import RsCheckbox from '../RsCheckbox.vue'

package/src/components/table/RsTableCellEditor.vue

@@ -6,7 +6,7 @@ import RsDatePicker from '../RsDatePicker.vue'
 import RsInput from '../RsInput.vue'
 import RsInputNumber from '../RsInputNumber.vue'
 import RsSelect from '../RsSelect.vue'
-import type { RsSelectModelValue, RsSelectOptions } from '../select-utils'
+import type { RsSelectOptions } from '../select-utils'
 import type { RsTableColumnEditorOptionsResolved, RsTableCellValueType } from '../table-utils'
 import {
   applyFocusMode,
@@ -223,15 +223,8 @@ function onKeydown(event: KeyboardEvent): void {
   }
 }
 
-function onSelectUpdate(value: RsSelectModelValue): void {
-  const toToken = (item: RsSelectModelValue): string => {
-    if (item == null || item === '') return ''
-    if (typeof item === 'object' && !Array.isArray(item) && 'value' in item) {
-      return String(item.value)
-    }
-    return String(item)
-  }
-  const tokens = Array.isArray(value) ? value.map(toToken) : toToken(value)
+function onSelectUpdate(value: string | string[]): void {
+  const tokens = Array.isArray(value) ? value.map(String) : String(value)
   const empty =
     tokens === '' || (Array.isArray(tokens) && tokens.length === 0)
   // 表格内下拉默认不可清除：仅选择；显式 clearable 时才允许清空

package/src/components/table/RsTableHeader.vue

@@ -1,4 +1,4 @@
-<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData">
+<script setup lang="ts" generic="T extends import('../table-utils').RsTableRowData = any">
 import RsIcon from '../RsIcon.vue'
 import RsTableHeaderFilter from './RsTableHeaderFilter.vue'
 import { useRsTableView } from './rs-table-view-context'

package/src/components/table/rs-table-props.ts

@@ -211,6 +211,72 @@ export type RsTableEmits<T extends RsTableRowData = RsTableRowData> = {
   rowEditRollback: [row: T, index: number]
 }
 
+/**
+ * 插槽回调按双变处理：宿主把 row 写成业务行类型时，不被逆变拒绝。
+ * 列插槽名是动态的，vue-tsc 不能从子组件 inject 推断 T，必须由 RsTable 自身 declare。
+ */
+type RsTableSlotFn<P> = {
+  bivarianceHack(props: P): unknown
+}['bivarianceHack']
+
+/** 列单元格插槽参数（`#columnKey`） */
+export interface RsTableColumnSlotProps<T extends RsTableRowData = RsTableRowData> {
+  row: T
+  column: RsTableColumn<T>
+  index: number
+}
+
+/** 自定义编辑器插槽参数（`#edit-columnKey`） */
+export interface RsTableEditSlotProps<T extends RsTableRowData = RsTableRowData>
+  extends RsTableColumnSlotProps<T> {
+  draft: string
+  error: string | null
+  update: (value: string) => void
+  commit: () => void
+  cancel: () => void
+}
+
+/** 列头插槽参数（`#header-columnKey`） */
+export interface RsTableHeaderSlotProps<T extends RsTableRowData = RsTableRowData> {
+  column: RsTableColumn<T>
+}
+
+/** 展开行插槽参数（`#expand`） */
+export interface RsTableExpandSlotProps<T extends RsTableRowData = RsTableRowData> {
+  row: T
+  index: number
+}
+
+/** 分组行插槽参数（`#group`） */
+export interface RsTableGroupSlotProps {
+  key: string
+  label: string
+}
+
+/**
+ * 按插槽名解析参数。列名是动态 key；`edit-*` / `header-*` 用模板字面量区分。
+ */
+export type RsTableSlotPropsOf<T extends RsTableRowData, K extends string> = K extends
+  | 'empty'
+  | 'summary'
+  ? Record<string, never>
+  : K extends 'group'
+    ? RsTableGroupSlotProps
+    : K extends 'expand'
+      ? RsTableExpandSlotProps<T>
+      : K extends `header-${string}`
+        ? RsTableHeaderSlotProps<T>
+        : K extends `edit-${string}`
+          ? RsTableEditSlotProps<T>
+          : RsTableColumnSlotProps<T>
+
+/**
+ * RsTable 公开插槽。用映射类型而不是 string 索引，避免 empty/group 与列插槽冲突。
+ */
+export type RsTableSlots<T extends RsTableRowData = RsTableRowData> = {
+  [K in string]?: RsTableSlotFn<RsTableSlotPropsOf<T, K>>
+}
+
 /** withDefaults 第二参（工厂默认用函数） */
 export const RS_TABLE_PROP_DEFAULTS = {
   loading: false,

package/src/index.ts

@@ -37,6 +37,7 @@ export type { RsLoadingBarApi } from './composables/useRsLoadingBar'
 export { default as RsDropdown } from './components/RsDropdown.vue'
 export { default as RsIcon } from './components/RsIcon.vue'
 export { default as RsInput } from './components/RsInput.vue'
+export type { RsInputExpose, RsInputInstance } from './components/RsInput.vue'
 export { default as RsInputNumber } from './components/RsInputNumber.vue'
 export type { RsInputNumberValue } from './components/input-number-utils'
 export {
@@ -141,6 +142,7 @@ export type {
   MonacoCompletionPrefixResolver,
   MonacoCompletionRequest,
   MonacoCompletionSnippet,
+  RsMonacoEditorExpose,
 } from './components/RsMonacoEditor.vue'
 export type {
   MonacoBuiltinLanguage,
@@ -171,6 +173,7 @@ export {
   isSafeHref,
   isSafeImageSrc,
   renderMarkdown,
+  renderMarkdownInline,
   resolveMarkdownHeight,
   resolveMarkdownMode,
 } from './components/markdown-utils'
@@ -223,6 +226,7 @@ export type {
   RsSelectGetPopupContainer,
   RsSelectLabeledValue,
   RsSelectModelValue,
+  RsSelectResolvedModel,
   RsSelectOption,
   RsSelectOptionFilterProp,
   RsSelectOptionGroup,
@@ -329,6 +333,8 @@ export { isStepSeparatorCompleted, resolveStepStatus } from './components/steps-
 export type {
   RsSplitConstraint,
   RsSplitOrientation,
+  RsSplitPaneExpose,
+  RsSplitPaneInstance,
   RsSplitPaneItem,
   RsSplitPaneSize,
 } from './components/split-pane-utils'
@@ -478,6 +484,13 @@ export {
 export type {
   RsTableProps,
   RsTableEmits,
+  RsTableColumnSlotProps,
+  RsTableEditSlotProps,
+  RsTableHeaderSlotProps,
+  RsTableExpandSlotProps,
+  RsTableGroupSlotProps,
+  RsTableSlots,
+  RsTableSlotPropsOf,
 } from './components/table/rs-table-props'
 export { RS_TABLE_PROP_DEFAULTS } from './components/table/rs-table-props'
 export { useRsTableGridKeyboard } from './composables/useRsTableGridKeyboard'