niuma-ui 1.0.0

package/src/index.ts

@@ -0,0 +1,425 @@
+export { default as RsConfigProvider } from './components/RsConfigProvider.vue'
+export { default as RsBadge } from './components/RsBadge.vue'
+export { default as RsContainer } from './components/RsContainer.vue'
+export { default as RsBreadcrumb } from './components/RsBreadcrumb.vue'
+export { default as RsToolbar } from './components/RsToolbar.vue'
+export { default as RsButton } from './components/RsButton.vue'
+export { default as RsCheckbox } from './components/RsCheckbox.vue'
+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 { default as RsInputNumber } from './components/RsInputNumber.vue'
+export type { RsInputNumberValue } from './components/input-number-utils'
+export {
+  clampNumber,
+  formatNumberValue,
+  fromModelValue,
+  isNumberInputInterim,
+  normalizeCommittedNumber,
+  parseNumberInput,
+  resolveNumberPrecision,
+  roundToPrecision,
+  stepNumberValue,
+  toModelValue,
+} from './components/input-number-utils'
+export { default as RsLabel } from './components/RsLabel.vue'
+export { default as RsLink } from './components/RsLink.vue'
+export { default as RsMenu } from './components/RsMenu.vue'
+export { default as RsSelect } from './components/RsSelect.vue'
+export { default as RsScrollbar } from './components/RsScrollbar.vue'
+export { default as RsAvatar } from './components/RsAvatar.vue'
+export { default as RsCard } from './components/RsCard.vue'
+export type { RsCardVariant } from './components/RsCard.vue'
+export { default as RsEmpty } from './components/RsEmpty.vue'
+export { default as RsLoading } from './components/RsLoading.vue'
+export { default as RsTabs } from './components/RsTabs.vue'
+export { default as RsTooltip } from './components/RsTooltip.vue'
+export { default as RsTooltipProvider } from './components/RsTooltipProvider.vue'
+export { default as RsPopover } from './components/RsPopover.vue'
+export { default as RsDialog } from './components/RsDialog.vue'
+export { default as RsContextMenu } from './components/RsContextMenu.vue'
+export { default as RsConfirmDialog } from './components/RsConfirmDialog.vue'
+export { default as RsDrawer } from './components/RsDrawer.vue'
+export { default as RsForm } from './components/RsForm.vue'
+export { default as RsToaster } from './components/RsToaster.vue'
+export { default as RsDatePicker } from './components/RsDatePicker.vue'
+export { default as RsDateTimePicker } from './components/RsDateTimePicker.vue'
+export { default as RsTimePicker } from './components/RsTimePicker.vue'
+export { default as RsCalendarGrid } from './components/RsCalendarGrid.vue'
+export { default as RsTimePickerColumns } from './components/RsTimePickerColumns.vue'
+export { default as RsSidebar } from './components/RsSidebar.vue'
+export { default as RsSidebarGroup } from './components/RsSidebarGroup.vue'
+export { default as RsSidebarItem } from './components/RsSidebarItem.vue'
+export { default as RsSplitPane } from './components/RsSplitPane.vue'
+export { default as RsStatCard } from './components/RsStatCard.vue'
+export { default as RsSteps } from './components/RsSteps.vue'
+export { default as RsTable } from './components/RsTable.vue'
+export { default as RsTableCellEditor } from './components/table/RsTableCellEditor.vue'
+export { default as RsTableHeaderRow } from './components/RsTableHeaderRow.vue'
+export { default as RsTableColgroup } from './components/RsTableColgroup.vue'
+export { default as RsPagination } from './components/RsPagination.vue'
+export { default as RsTree } from './components/RsTree.vue'
+export { default as RsUpload } from './components/RsUpload.vue'
+export { default as RsVirtualList } from './components/RsVirtualList.vue'
+export { default as RsCodeEditor } from './components/RsCodeEditor.vue'
+export { default as RsMonacoEditor } from './components/RsMonacoEditor.vue'
+export type {
+  MonacoCompletionContext,
+  MonacoCompletionPrefixResolver,
+  MonacoCompletionRequest,
+  MonacoCompletionSnippet,
+} from './components/RsMonacoEditor.vue'
+export type {
+  MonacoBuiltinLanguage,
+  MonacoLanguage,
+  MonacoSqlLanguageId,
+} from './monaco'
+export {
+  applyMonacoDebugDecorations,
+  buildMonacoDebugDecorations,
+  ensureMongodbShellLanguage,
+  MONACO_GENERIC_SQL_LANGUAGE,
+  MONACO_MONGODB_SHELL_LANGUAGE,
+  MONACO_PGSQL_LANGUAGE,
+  MONACO_MYSQL_LANGUAGE,
+  MONACO_DAMENG_LANGUAGE,
+  MONACO_KINGBASE_LANGUAGE,
+  MONACO_SQLITE_LANGUAGE,
+  RS_MONACO_DEBUG,
+  setupMonacoWorkers,
+} from './monaco'
+export type { MonacoDebugDecorationState } from './monaco'
+export { default as RsCodeBlock } from './components/RsCodeBlock.vue'
+export { default as RsMarkdown } from './components/RsMarkdown.vue'
+export type { RsMarkdownMode, RsMarkdownRenderOptions } from './components/markdown-utils'
+export {
+  escapeHtml,
+  isSafeHref,
+  isSafeImageSrc,
+  renderMarkdown,
+  resolveMarkdownHeight,
+  resolveMarkdownMode,
+} from './components/markdown-utils'
+export { default as RsProseEditor } from './components/RsProseEditor.vue'
+export { default as RsTerminal } from './components/RsTerminal.vue'
+export {
+  beginClipboardPrefetch,
+  copyTextToClipboard,
+  copyTextWithExecCommand,
+  prefetchClipboardText,
+  readClipboardText,
+  writeClipboardText,
+} from './utils/rs-clipboard'
+export { resolveCodeMirrorLanguage, isCodeMirrorLightTheme, prewarmCodeMirrorEditor } from './components/code-mirror-lang'
+export {
+  buildAnsiColorDemo,
+  containsEscapeSequence,
+  getTerminalThemePalette,
+  mergeTerminalTheme,
+  readTerminalThemeFromCss,
+  resolveTerminalTheme,
+  terminalShortcutLabel,
+} from './components/terminal-utils'
+export type {
+  RsResolvedTerminalTheme,
+  RsTerminalAction,
+  RsTerminalThemeMode,
+} from './components/terminal-utils'
+
+export type {
+  RsContainerBreakpoint,
+  RsContainerGap,
+  RsContainerMaxWidth,
+  RsContainerMaybeResponsive,
+  RsContainerPadding,
+  RsContainerResponsive,
+} from './components/RsContainer.vue'
+export type { RsBreadcrumbItem } from './components/RsBreadcrumb.vue'
+export type { RsToolbarBorder, RsToolbarSize } from './components/RsToolbar.vue'
+export type { RsContextMenuItem } from './components/context-menu-utils'
+export type { RsDropdownItem, RsDropdownItemGroup, RsDropdownItems } from './components/dropdown-utils'
+export type { RsMenuItem, RsMenuItemGroup, RsMenuItems } from './components/menu-utils'
+export type { RsScrollbarOrientation, RsScrollbarType } from './components/scrollbar-utils'
+export type { RsSelectOption, RsSelectOptionGroup, RsSelectOptions } from './components/select-utils'
+export type { RsFeedbackTone, RsToastPosition, RsToastType } from './components/overlay-utils'
+export { RS_TOAST_DEFAULT_GAP, RS_TOAST_DEFAULT_POSITION, rsToastPositions, rsFeedbackIconClass } from './components/overlay-utils'
+export type {
+  RsFormContext,
+  RsFormFieldExpose,
+  RsFormGap,
+  RsFormLabelAlign,
+  RsFormLabelPosition,
+  RsFormMaxWidth,
+  RsFormSize,
+  RsFormValidationResult,
+} from './components/form-utils'
+export {
+  cloneFormFieldValue,
+  RS_FORM_INJECTION_KEY,
+  useRsFormContext,
+  useRsFormField,
+} from './components/form-utils'
+export type { RsTabItem, RsTabsOverflow, RsTabsSize, RsTabsVariant } from './components/tabs-utils'
+export {
+  getNextTabAfterClose,
+  isTabClosable,
+  isTabRenamable,
+  reorderTabItems,
+  resolveVisibleTabValues,
+} from './components/tabs-utils'
+export type { RsStepItem, RsStepStatus, RsStepsOrientation, RsStepsSize } from './components/steps-utils'
+export { isStepSeparatorCompleted, resolveStepStatus } from './components/steps-utils'
+export type { RsSplitConstraint, RsSplitOrientation, RsSplitPaneItem } from './components/split-pane-utils'
+export {
+  applySplitResize,
+  collapseSplitPane,
+  expandSplitPane,
+  isSplitPaneCollapsed,
+  normalizeSplitSizes,
+  resolveSplitConstraints,
+  splitSizesEqual,
+} from './components/split-pane-utils'
+export type {
+  RsTableCellCommitTrigger,
+  RsTableCellEditFocusMode,
+  RsTableCellEditTrigger,
+  RsTableCellEditorInputType,
+  RsTableCellNavigateDirection,
+  RsTableEditableCellRef,
+} from './components/table/table-edit-utils'
+export {
+  RS_TABLE_NULL_DRAFT,
+  isNullDraft,
+  nullToEditText,
+  parseClipboardGrid,
+  navigateEditableCell,
+  listEditableCells,
+  listBatchColumnTargets,
+  validateCellValueAsync,
+} from './components/table/table-edit-utils'
+export type { RsTableStagedCell, RsTableUndoEntry, RsTableFocusCell } from './composables/useTableEdit'
+export type { RsTableRowDragTrigger, RsTableRowDropMode } from './components/table-drag'
+export type {
+  RsTableCellRenderResult,
+  RsTableColumn,
+  RsTableColumnAlign,
+  RsTableColumnEditorOptions,
+  RsTableColumnEditorOptionsResolved,
+  RsTableColumnFixed,
+  RsTableCellValueType,
+  RsTableFieldAccessor,
+  RsTableGroupBy,
+  RsTableRowConvention,
+  RsTableRowData,
+  RsTableRowDropPosition,
+  RsTableRowEntry,
+  RsTableRowKey,
+  RsTableSelectAllState,
+  RsTableSelectionType,
+  RsTableSize,
+  RsTableSortOrder,
+  RsTableSortState,
+} from './components/table-utils'
+export {
+  buildTableEntries,
+  clampColumnWidth,
+  compareTableValues,
+  createInitialColumnWidths,
+  filterTableRows,
+  fixedCellStyle,
+  getCellValue,
+  getSortOrderForKey,
+  getSortPriorityForKey,
+  groupTableRows,
+  injectExpandRows,
+  isNearScrollBottom,
+  isTableRowDisabled,
+  parseColumnWidth,
+  reorderColumnKeys,
+  reorderTableRows,
+  resolveColumnOrder,
+  resolveEntryKey,
+  resolveFixedColumnStyles,
+  resolveOrderedColumns,
+  resolveRowKey,
+  resolveSelectableRowKeys,
+  resolveSelectAllState,
+  resolveTableSize,
+  resolveTableVirtualEnabled,
+  selectRowKeys,
+  selectRowKeysByClick,
+  sliceVirtualTableEntries,
+  sortTableRows,
+  sortTableRowsMulti,
+  toggleExpandedRowKeys,
+  toggleMultiSortState,
+  toggleRowSelection,
+  toggleSelectAll,
+  toggleSortState,
+} from './components/table-utils'
+export type {
+  RsTreeCheckState,
+  RsTreeDragTrigger,
+  RsTreeDropPosition,
+  RsTreeFieldNames,
+  RsTreeFlatNode,
+  RsTreeFocusMove,
+  RsTreeNode,
+  RsTreeNodeIndex,
+  RsTreeSize,
+} from './components/tree-utils'
+export {
+  buildTreeNodeIndex,
+  collectDescendantKeys,
+  collectExpandableKeys,
+  collectHalfCheckedKeys,
+  defaultTreeFilterNode,
+  filterTreeNodes,
+  flattenTreeNodeIds,
+  flattenVisibleTreeNodes,
+  getTreeChildren,
+  getTreeKey,
+  getTreeLabel,
+  hasTreeChildren,
+  isTreeAncestorKey,
+  resolveAccordionExpandedKeys,
+  resolveTreeCheckState,
+  resolveTreeFieldNames,
+  resolveTreeFocusKey,
+  resolveTreeIndent,
+  resolveTreeRowHeight,
+  resolveTreeVirtualEnabled,
+  sliceVirtualTreeNodes,
+  splitTreeLabelHighlight,
+  shouldShowTreeCheckbox,
+  toggleTreeCheck,
+} from './components/tree-utils'
+export type { RsUploadValidationError, RsUploadValidationRules } from './components/upload-utils'
+export {
+  formatFileSize,
+  isFileAccepted,
+  mergeUploadFiles,
+  removeUploadFileAt,
+  validateUploadFiles,
+} from './components/upload-utils'
+export type { RsVirtualListItemSize } from './components/virtual-list-utils'
+export { resolveItemSize, resolveVirtualListHeight } from './components/virtual-list-utils'
+export type {
+  RsCodeEditorDiagnostic,
+  RsCodeEditorLanguage,
+  RsCodeEditorSqlColumn,
+  RsCodeEditorSqlConfig,
+  RsCodeEditorSqlDialect,
+  RsCodeEditorSqlNamespace,
+  RsCodeEditorTheme,
+  RsResolvedCodeEditorTheme,
+} from './components/code-editor-utils'
+export {
+  codeEditorLanguageLabel,
+  readDocumentTheme,
+  resolveCodeEditorLanguage,
+  resolveCodeEditorSize,
+  resolveCodeEditorTheme,
+} from './components/code-editor-utils'
+export type { RsDateRangeValue, RsParsedDate, RsParsedDateTime } from './components/date-picker-utils'
+export {
+  EMPTY_DATE_RANGE,
+  formatDateDisplay,
+  formatDateParts,
+  formatDateRangeDisplay,
+  formatDateTimeDisplay,
+  formatDateTimeValue,
+  formatDateValue,
+  isDateRangeEmpty,
+  isDateRangeOrdered,
+  isDateTimeRangeOrdered,
+  parseDateTimeValue,
+  parseDateValue,
+} from './components/date-picker-utils'
+export {
+  RS_DATE_FORMAT,
+  RS_DATETIME_FORMAT,
+  RS_TIME_MINUTE_FORMAT,
+  RS_TIME_SECONDS_FORMAT,
+} from './lib/rs-dayjs'
+export {
+  formatIsoUtcToLocal,
+  looksLikeIsoDateTimeWithTz,
+  parseLocalDateTimeToUtcIso,
+} from './lib/iso-local-datetime'
+export type { RsParsedTime, RsTimeRangeValue } from './components/time-picker-utils'
+export {
+  EMPTY_TIME_RANGE,
+  formatTimeFromParts,
+  formatTimeParts,
+  formatTimeRangeDisplay,
+  formatTimeValue,
+  isTimeRangeEmpty,
+  isTimeRangeOrdered,
+  isTimeWithinBounds,
+  parseTimeValue,
+} from './components/time-picker-utils'
+export type {
+  RsDateTimeValidationError,
+  RsDateTimeValidationResult,
+  RsDateTimeValidationRules,
+  RsDateValidationError,
+  RsDateValidationResult,
+  RsDateValidationRules,
+} from './components/date-validation'
+export { validateDateTimeValue, validateDateValue } from './components/date-validation'
+export type { RsTimeValidationError, RsTimeValidationResult, RsTimeValidationRules } from './components/time-validation'
+export { validateTimeValue } from './components/time-validation'
+export type {
+  RsDateRangeValidationError,
+  RsDateRangeValidationResult,
+  RsDateRangeValidationRules,
+  RsDateTimeRangeValidationError,
+  RsDateTimeRangeValidationResult,
+  RsDateTimeRangeValidationRules,
+} from './components/date-range-validation'
+export { validateDateRangeValue, validateDateTimeRangeValue } from './components/date-range-validation'
+export type {
+  RsTimeRangeValidationError,
+  RsTimeRangeValidationResult,
+  RsTimeRangeValidationRules,
+} from './components/time-range-validation'
+export { validateTimeRangeValue } from './components/time-range-validation'
+export {
+  clampPage,
+  createPageSizeSelectOptions,
+  DEFAULT_PAGE_SIZE_OPTIONS,
+  getPageCount,
+  getPaginationRange,
+  slicePageData,
+} from './components/pagination-utils'
+export type {
+  RsInputRule,
+  RsInputValidateTrigger,
+  RsInputValidateResult,
+} from './components/input-rules'
+export {
+  validateInputRule,
+  runInputValidation,
+  getInputRuleMessage,
+  inputRuleMessageKeys,
+} from './components/input-rules'
+export { useRsI18n, createTranslator } from './composables/useRsI18n'
+export type { RsTranslateFn } from './composables/useRsI18n'
+export { useRsToast } from './composables/useRsToast'
+export type { RsToastInput } from './composables/useRsToast'
+export {
+  rsCommonIconNames,
+  LUCIDE_ATTRIBUTION,
+  LUCIDE_LICENSE,
+  lucideIconCount,
+  isRsIconName,
+} from './icons/registry'
+export type { RsThemeMode, RsThemeTokens, RsComponentSize, RsRadius } from './theme/types'
+export { RS_COMPONENT_SIZES, RS_COMPONENT_SIZE_ICON_PX, RS_RADII, RS_RADIUS_CSS } from './theme/types'
+export type { RsLocale } from './locale/types'
+export { useRsConfig, useRsConfigOptional, createRsConfigState } from './composables/useRsConfig'
+export { useResolvedRsComponentSize, resolveRsComponentSize } from './components/resolve-size'
+export { useResolvedRsRadius, rsRadiusCss } from './components/resolve-radius'
+export { themePresets } from './theme/presets'
+export { applyTheme } from './theme/apply'

package/src/lib/iso-local-datetime.ts

@@ -0,0 +1,152 @@
+/**
+ * 带显式时区的 ISO-8601 ↔ 本机本地墙钟。
+ * 用于表格展示 / 编辑草稿 / 写回，避免剥 Z 丢时区，并尽量保留毫秒。
+ */
+
+/** `YYYY-MM-DDTHH:mm:ssZ` = 20；含毫秒/偏移上限约 35，放宽到 40 */
+const ISO_TZ_MIN_LEN = 20
+const ISO_TZ_MAX_LEN = 40
+
+const ISO_WITH_TZ_RE =
+  /^(\d{4}-\d{2}-\d{2})[T ](\d{2}:\d{2}:\d{2})(\.\d{1,9})?(Z|[+-]\d{2}:?\d{2})$/i
+
+/** 本地墙钟（无时区） */
+const LOCAL_DATETIME_RE =
+  /^(\d{4}-\d{2}-\d{2})[T ](\d{2}:\d{2}:\d{2})(\.\d{1,9})?$/
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0')
+}
+
+function pad3(n: number): string {
+  return String(n).padStart(3, '0')
+}
+
+function isDigit(c: string): boolean {
+  return c >= '0' && c <= '9'
+}
+
+/**
+ * 廉价判定：是否像「带时区的 ISO 日期时间」。
+ * 失败路径只做长度/字符检查，避免对普通文本跑正则。
+ */
+export function looksLikeIsoDateTimeWithTz(value: string): boolean {
+  const n = value.length
+  if (n < ISO_TZ_MIN_LEN || n > ISO_TZ_MAX_LEN) return false
+  if (
+    !isDigit(value[0]!) ||
+    !isDigit(value[1]!) ||
+    !isDigit(value[2]!) ||
+    !isDigit(value[3]!) ||
+    value[4] !== '-' ||
+    !isDigit(value[5]!) ||
+    !isDigit(value[6]!) ||
+    value[7] !== '-' ||
+    !isDigit(value[8]!) ||
+    !isDigit(value[9]!)
+  ) {
+    return false
+  }
+  const sep = value[10]
+  if (sep !== 'T' && sep !== 't' && sep !== ' ') return false
+  const last = value[n - 1]!
+  if (last === 'Z' || last === 'z') return true
+  if (n >= 25 && (value.includes('+', 19) || value.lastIndexOf('-') > 19)) return true
+  return false
+}
+
+function formatLocalFromDate(d: Date, withMs: boolean): string {
+  const base =
+    `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())} ` +
+    `${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}`
+  if (!withMs) return base
+  return `${base}.${pad3(d.getMilliseconds())}`
+}
+
+function formatUtcIsoFromDate(d: Date, withMs: boolean): string {
+  const base =
+    `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}T` +
+    `${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`
+  if (!withMs) return `${base}Z`
+  return `${base}.${pad3(d.getUTCMilliseconds())}Z`
+}
+
+function localSecondKey(local: string): string {
+  // `YYYY-MM-DD HH:mm:ss` 前 19 字符；兼容 T 分隔
+  const t = local.trim().replace('T', ' ')
+  return t.length >= 19 ? t.slice(0, 19) : t
+}
+
+/** 将带时区的 ISO 串转为本地时间；无法识别则返回 null。 */
+export function formatIsoUtcToLocal(value: string): string | null {
+  const t = value.trim()
+  if (!looksLikeIsoDateTimeWithTz(t)) return null
+
+  const m = ISO_WITH_TZ_RE.exec(t)
+  if (!m) return null
+
+  const hasFrac = Boolean(m[3])
+  const frac = hasFrac ? m[3]!.slice(0, 4) : ''
+  const iso = `${m[1]}T${m[2]}${frac}${m[4]}`
+  const d = new Date(iso)
+  if (Number.isNaN(d.getTime())) return null
+
+  return formatLocalFromDate(d, hasFrac)
+}
+
+/**
+ * 将本地墙钟（或已带时区的 ISO）写回 UTC ISO。
+ * - 与 previousIso 在「秒」级一致且输入无新小数秒 → 原样返回 previous（保留毫秒/更长小数）
+ * - 否则按输入精度生成 `...Z`（有小数秒则到毫秒）
+ */
+export function parseLocalDateTimeToUtcIso(
+  local: string,
+  previousIso?: string,
+): string | null {
+  const t = local.trim()
+  if (!t) return null
+
+  if (looksLikeIsoDateTimeWithTz(t)) {
+    const m = ISO_WITH_TZ_RE.exec(t)
+    if (!m) return null
+    const hasFrac = Boolean(m[3])
+    const frac = hasFrac ? m[3]!.slice(0, 4) : ''
+    const d = new Date(`${m[1]}T${m[2]}${frac}${m[4]}`)
+    if (Number.isNaN(d.getTime())) return null
+    const prev = previousIso?.trim()
+    if (prev && looksLikeIsoDateTimeWithTz(prev)) {
+      const prevLocal = formatIsoUtcToLocal(prev)
+      if (
+        prevLocal &&
+        !hasFrac &&
+        localSecondKey(prevLocal) === localSecondKey(formatLocalFromDate(d, false))
+      ) {
+        return prev
+      }
+    }
+    return formatUtcIsoFromDate(d, hasFrac)
+  }
+
+  const m = LOCAL_DATETIME_RE.exec(t)
+  if (!m) return null
+
+  const hasFrac = Boolean(m[3])
+  const frac = hasFrac ? m[3]!.slice(0, 4) : ''
+  // 无 Z 的日期时间按 ES 本地时区解析
+  const d = new Date(`${m[1]}T${m[2]}${frac}`)
+  if (Number.isNaN(d.getTime())) return null
+
+  const prev = previousIso?.trim()
+  if (prev && looksLikeIsoDateTimeWithTz(prev)) {
+    const prevLocal = formatIsoUtcToLocal(prev)
+    if (prevLocal) {
+      const inputNorm = t.replace('T', ' ')
+      // 草稿与展示本地值完全一致 → 原样写回（保留 .NET 7 位等超毫秒小数）
+      if (inputNorm === prevLocal) return prev
+      // 日期选择器通常只到秒：未改秒则保留原始精度
+      if (!hasFrac && localSecondKey(prevLocal) === localSecondKey(inputNorm)) return prev
+    }
+  }
+
+  return formatUtcIsoFromDate(d, hasFrac)
+}

package/src/lib/rs-dayjs.ts

@@ -0,0 +1,56 @@
+import dayjs, { type Dayjs } from 'dayjs'
+import customParseFormat from 'dayjs/plugin/customParseFormat'
+
+dayjs.extend(customParseFormat)
+
+/** 日期 v-model / 展示格式 */
+export const RS_DATE_FORMAT = 'YYYY-MM-DD'
+
+/** 日期时间 v-model / 展示格式 */
+export const RS_DATETIME_FORMAT = 'YYYY-MM-DD HH:mm:ss'
+
+/** 时间片段格式（含秒） */
+export const RS_TIME_SECONDS_FORMAT = 'HH:mm:ss'
+
+/** 时间片段格式（分钟精度） */
+export const RS_TIME_MINUTE_FORMAT = 'HH:mm'
+
+export const RS_DATE_PARSE_FORMATS = [
+  RS_DATE_FORMAT,
+  'YYYY/MM/DD',
+  'YYYY-M-D',
+] as const
+
+/** 日期时间解析：兼容空格分隔与 ISO `T` 分隔（表格/后端常见） */
+export const RS_DATETIME_PARSE_FORMATS = [
+  RS_DATETIME_FORMAT,
+  'YYYY-MM-DD HH:mm',
+  'YYYY-MM-DDTHH:mm:ss',
+  'YYYY-MM-DDTHH:mm',
+  'YYYY-MM-DDTHH:mm:ss.SSS',
+] as const
+
+export function parseRsDayjs(
+  value?: string,
+  formats: readonly string[] = RS_DATE_PARSE_FORMATS,
+): Dayjs | null {
+  if (!value) return null
+  const parsed = dayjs(value, [...formats], true)
+  return parsed.isValid() ? parsed : null
+}
+
+export function parseRsDateTimeDayjs(value?: string): Dayjs | null {
+  if (!value) return null
+  // 去掉末尾 Z / 偏移，按本地墙钟解析（选中态与展示一致）
+  const normalized = value
+    .trim()
+    .replace(/Z$/i, '')
+    .replace(/[+-]\d{2}:?\d{2}$/, '')
+  for (const format of RS_DATETIME_PARSE_FORMATS) {
+    const parsed = dayjs(normalized, format, true)
+    if (parsed.isValid()) return parsed
+  }
+  return null
+}
+
+export { dayjs }