niuma-ui 1.3.0 → 1.3.2

package/dist/components/RsVirtualList.css

@@ -1,29 +1,29 @@
 
-.rs-virtual-list[data-v-c2c4b7ba] {
+.rs-virtual-list[data-v-808bf3fd] {
   overflow: auto;
   border: 1px solid var(--rs-border-subtle);
   border-radius: var(--rs-virtual-list-radius, var(--rs-radius-sm));
 }
-.rs-virtual-list--fill[data-v-c2c4b7ba] {
+.rs-virtual-list--fill[data-v-808bf3fd] {
   flex: 1;
   align-self: stretch;
   width: 100%;
   min-height: 0;
   height: 0;
 }
-.rs-virtual-list__spacer[data-v-c2c4b7ba] {
+.rs-virtual-list__spacer[data-v-808bf3fd] {
   position: relative;
 }
-.rs-virtual-list__items[data-v-c2c4b7ba] {
+.rs-virtual-list__items[data-v-808bf3fd] {
   position: absolute;
   left: 0;
   right: 0;
   top: 0;
 }
-.rs-virtual-list__item[data-v-c2c4b7ba] {
+.rs-virtual-list__item[data-v-808bf3fd] {
   box-sizing: border-box;
 }
-.rs-virtual-list__item--active[data-v-c2c4b7ba] {
+.rs-virtual-list__item--active[data-v-808bf3fd] {
   background: color-mix(in srgb, var(--rs-primary) 14%, var(--rs-surface));
   box-shadow: inset 2px 0 0 var(--rs-primary);
 }

package/dist/components/RsVirtualList.d.ts

@@ -15,7 +15,7 @@ declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_se
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
-        scrollToIndex: (index: number) => void;
+        scrollToIndex: (index: number, align?: "nearest" | "center" | "start" | "end") => void;
     }>) => void;
     attrs: any;
     slots: {

package/dist/components/RsVirtualList.impl.js

@@ -89,17 +89,22 @@ var RsVirtualList_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		})));
 		const totalHeight = computed(() => props.items.length * fixedItemSize.value);
 		const offsetY = computed(() => startIndex.value * fixedItemSize.value);
-		function scrollToIndex(index) {
+		function scrollToIndex(index, align = "center") {
 			const el = rootRef.value;
 			if (!el || index < 0 || index >= props.items.length) return;
 			const itemTop = index * fixedItemSize.value;
 			const itemBottom = itemTop + fixedItemSize.value;
 			const viewTop = el.scrollTop;
 			const viewBottom = viewTop + el.clientHeight;
-			if (itemTop >= viewTop && itemBottom <= viewBottom) return;
+			if (align === "nearest" && itemTop >= viewTop && itemBottom <= viewBottom) return;
 			const maxScroll = Math.max(0, totalHeight.value - el.clientHeight);
-			const centered = itemTop - (el.clientHeight - fixedItemSize.value) / 2;
-			el.scrollTop = Math.min(maxScroll, Math.max(0, centered));
+			let next = itemTop - (el.clientHeight - fixedItemSize.value) / 2;
+			if (align === "start") next = itemTop;
+			if (align === "end") next = itemBottom - el.clientHeight;
+			if (align === "nearest") if (itemTop < viewTop) next = itemTop;
+			else if (itemBottom > viewBottom) next = itemBottom - el.clientHeight;
+			else return;
+			el.scrollTop = Math.min(maxScroll, Math.max(0, next));
 			scrollTop.value = el.scrollTop;
 		}
 		watch(() => [props.activeIndex, props.items.length], async ([index, length]) => {

package/dist/components/RsVirtualList.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../_virtual/_plugin-vue_export-he
 import RsVirtualList_vue_vue_type_script_setup_true_lang_default from "./RsVirtualList.impl.js";
 
 //#region src/components/RsVirtualList.vue
-var RsVirtualList_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsVirtualList_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-c2c4b7ba"]]);
+var RsVirtualList_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsVirtualList_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-808bf3fd"]]);
 //#endregion
 export { RsVirtualList_default as default };

package/dist/components/button-utils.d.ts

@@ -1,17 +1,26 @@
 /**
- * RsButton 外观变体
- * - primary / default / ghost / danger：常规控件按钮
- * - link：行内链接态（可带下划线）
- * - text：工具栏/表格操作等 quaternary 文字按钮（无底无边，靠 tone 着色）
+ * RsButton 外观变体（形态，与 tone 正交）
+ * - primary：实心
+ * - default / secondary：轮廓 + 浅底（secondary 等价 default）
+ * - ghost：透明底 + 描边
+ * - text：无底无边
+ * - link：行内链接
+ * - danger：兼容别名，等价 primary + tone="danger" 的历史实心底（保留独立样式）
  */
 export type RsButtonVariant = 'primary' | 'default' | 'secondary' | 'ghost' | 'danger' | 'link' | 'text';
 /**
- * RsButton 语义色调
- * 主要用于 text / ghost / link：只改文字与图标色，不改变填充形态。
- * 对 primary / default / danger 等填充变体将被忽略。
+ * RsButton 语义色（色相，与 variant 正交）
+ * 对齐 Ant Design color / Element Plus type / Naive UI type：
+ * `variant="default" tone="warning"` → 描边 + 浅底 + 警告色。
  */
 export type RsButtonTone = 'neutral' | 'primary' | 'danger' | 'success' | 'warning' | 'info';
-/** 填充类变体：已自带语义色，不再叠加 tone */
+/** 规范化变体：未传为 primary；secondary 视为 default。 */
+export declare function resolveRsButtonVariant(variant?: RsButtonVariant): Exclude<RsButtonVariant, 'secondary'>;
+/**
+ * 解析语义色。未传 tone 时：primary/link 用 primary，danger 变体用 danger，其余 neutral。
+ */
+export declare function resolveRsButtonTone(variant?: RsButtonVariant, tone?: RsButtonTone): RsButtonTone;
+/** 实心/轮廓填充类变体（相对 text / ghost / link）。 */
 export declare function isRsButtonFilledVariant(variant: RsButtonVariant): boolean;
-/** text / ghost / link 可叠加 tone */
-export declare function supportsRsButtonTone(variant: RsButtonVariant): boolean;
+/** 所有变体都可叠加 tone（形态 × 色相）。 */
+export declare function supportsRsButtonTone(_variant?: RsButtonVariant): boolean;

package/dist/components/button-utils.js

@@ -1,13 +1,28 @@
 //#region src/components/button-utils.ts
-/** 填充类变体：已自带语义色，不再叠加 tone */
+/** 规范化变体：未传为 primary；secondary 视为 default。 */
+function resolveRsButtonVariant(variant) {
+	if (variant === "secondary") return "default";
+	if (!variant) return "primary";
+	return variant;
+}
+/**
+* 解析语义色。未传 tone 时：primary/link 用 primary，danger 变体用 danger，其余 neutral。
+*/
+function resolveRsButtonTone(variant, tone) {
+	if (tone) return tone;
+	const resolved = resolveRsButtonVariant(variant);
+	if (resolved === "danger") return "danger";
+	if (resolved === "primary" || resolved === "link") return "primary";
+	return "neutral";
+}
+/** 实心/轮廓填充类变体（相对 text / ghost / link）。 */
 function isRsButtonFilledVariant(variant) {
-	const resolved = variant === "secondary" ? "default" : variant;
+	const resolved = resolveRsButtonVariant(variant);
 	return resolved === "primary" || resolved === "default" || resolved === "danger";
 }
-/** text / ghost / link 可叠加 tone */
-function supportsRsButtonTone(variant) {
-	const resolved = variant === "secondary" ? "default" : variant;
-	return resolved === "text" || resolved === "ghost" || resolved === "link";
+/** 所有变体都可叠加 tone（形态 × 色相）。 */
+function supportsRsButtonTone(_variant) {
+	return true;
 }
 //#endregion
-export { isRsButtonFilledVariant, supportsRsButtonTone };
+export { isRsButtonFilledVariant, resolveRsButtonTone, resolveRsButtonVariant, supportsRsButtonTone };

package/dist/components/dialog-window.d.ts

@@ -14,6 +14,8 @@ export declare function useRsDialogWindow(options: {
     widthPreset: Ref<RsDialogWidthPreset>;
     /** 自定义初始宽度（px）；有值时优先于预设/比例 */
     initialWidth?: Ref<number | undefined>;
+    /** 自定义初始高度（px）；有值时优先于默认 75% 视口高 */
+    initialHeight?: Ref<number | undefined>;
     draggable: Ref<boolean>;
     resizable: Ref<boolean>;
     compact?: Ref<boolean>;

package/dist/components/dialog-window.js

@@ -62,9 +62,10 @@ function useRsDialogWindow(options) {
 	function defaultWindowSize() {
 		const { width: maxW, height: maxH } = dialogViewportSize();
 		const customW = options.initialWidth?.value;
+		const customH = options.initialHeight?.value;
 		return {
 			width: customW != null && Number.isFinite(customW) && customW > 0 ? Math.min(maxW, Math.max(minWidth, Math.round(customW))) : Math.min(maxW, Math.max(minWidth, Math.round(maxW * defaultWidthRatio))),
-			height: Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio)))
+			height: customH != null && Number.isFinite(customH) && customH > 0 ? Math.min(maxH, Math.max(minHeight, Math.round(customH))) : Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio)))
 		};
 	}
 	function refreshCachedInsets() {

package/dist/components/fieldset-utils.d.ts

@@ -0,0 +1,29 @@
+import type { RsFontSize, RsFontWeight } from '../theme/types';
+/**
+ * 表单分组密度。只影响内边距与组内间距，不改变控件高度。
+ */
+export type RsFieldsetSize = 'sm' | 'md';
+/**
+ * 边框线型。对齐 CSS `border-style`（solid / dashed / dotted）。
+ */
+export type RsFieldsetBorderStyle = 'solid' | 'dashed' | 'dotted';
+/**
+ * 边框浓度。
+ * - default：主题分隔线
+ * - subtle：弱分隔
+ * - faded：虚化（降低不透明度）
+ */
+export type RsFieldsetBorderTone = 'default' | 'subtle' | 'faded';
+/**
+ * 标题对比（清晰度）。
+ * - strong：最高对比
+ * - default：正文色
+ * - muted：次要说明色
+ */
+export type RsFieldsetTitleTone = 'strong' | 'default' | 'muted';
+/** 分组标题字号，只开放 caption / 次要 / 正文三档。 */
+export type RsFieldsetTitleSize = Extract<RsFontSize, 'xs' | 'sm' | 'base'>;
+/** 解析标题字号 token。 */
+export declare function resolveFieldsetTitleSize(size: RsFieldsetTitleSize): string;
+/** 解析标题字重 token。 */
+export declare function resolveFieldsetTitleWeight(weight: RsFontWeight): string;

package/dist/components/fieldset-utils.js

@@ -0,0 +1,12 @@
+import { RS_FONT_SIZE_CSS, RS_FONT_WEIGHT_CSS } from "../theme/types.js";
+//#region src/components/fieldset-utils.ts
+/** 解析标题字号 token。 */
+function resolveFieldsetTitleSize(size) {
+	return RS_FONT_SIZE_CSS[size];
+}
+/** 解析标题字重 token。 */
+function resolveFieldsetTitleWeight(weight) {
+	return RS_FONT_WEIGHT_CSS[weight];
+}
+//#endregion
+export { resolveFieldsetTitleSize, resolveFieldsetTitleWeight };

package/dist/components/log-utils.d.ts

@@ -0,0 +1,105 @@
+/** 展示与过滤用的级别。success 是 UI 结果，不是 RFC 严重级别。 */
+export type RsLogLevel = 'trace' | 'debug' | 'info' | 'notice' | 'success' | 'warn' | 'error' | 'fatal' | 'plain';
+/** 数字严重级别的标尺。auto：0–7 当 syslog，更大当 OTel。 */
+export type RsLogSeverityScale = 'syslog' | 'otel' | 'auto';
+/** 调用方补充的成功 / 失败等标识。字符串按拉丁词边界匹配（中日韩按子串），也可传 RegExp。 */
+export type RsLogMarker = string | RegExp;
+/** 未写 level 时，在内置扫描之后用这些标识给正文上色。默认不启用。 */
+export type RsLogInferMarkers = {
+    [K in Exclude<RsLogLevel, 'plain'>]?: readonly RsLogMarker[];
+};
+export type InferLogLevelOptions = {
+    markers?: RsLogInferMarkers;
+};
+/** 一条结构化日志。level 缺省时可由 infer / severity 得出。 */
+export type RsLogLine = {
+    id?: string | number;
+    text: string;
+    /** 规范级别或别名（warning / critical…），由 parseRsLogLevel 收口 */
+    level?: string;
+    /** RFC 5424 0–7 或 OTel 1–24；未写 level 时参与解析 */
+    severity?: number;
+    time?: string | number | Date;
+};
+export type RsLogLineInput = string | RsLogLine;
+/** 渲染用的归一化行。key 稳定，供虚拟列表复用。 */
+export type RsNormalizedLogLine = {
+    key: string;
+    text: string;
+    level: RsLogLevel;
+    time?: string;
+    /** 裁剪后的 1-based 序号 */
+    seq: number;
+    /** RFC 5424 Severity，plain 为 null */
+    syslog: number | null;
+    /** OpenTelemetry severity number，plain 为 null */
+    otel: number | null;
+};
+export declare const RS_LOG_LEVELS: readonly RsLogLevel[];
+/** 可过滤的级别（不含 plain）。 */
+export declare const RS_LOG_FILTER_LEVELS: readonly RsLogLevel[];
+export declare function isRsLogLevel(value: unknown): value is RsLogLevel;
+/** RFC 5424 Severity（0–7）。plain 返回 null。 */
+export declare function syslogSeverityOf(level: RsLogLevel): number | null;
+/** OpenTelemetry severity number。plain 返回 null。 */
+export declare function otelSeverityOf(level: RsLogLevel): number | null;
+/**
+ * 把别名、syslog 0–7、OTel 1–24 收成规范级别。
+ * 无法识别时返回 undefined，由调用方决定是否再推断。
+ */
+export declare function parseRsLogLevel(value: unknown, scale?: RsLogSeverityScale): RsLogLevel | undefined;
+/** 把任意输入收成日志行数组：字符串按行拆，对象原样保留。 */
+export declare function asLogLineInputs(input: string | RsLogLineInput | RsLogLineInput[]): RsLogLineInput[];
+/** 拆成行。统一 CRLF；去掉末尾空行，避免 textarea 尾巴多一行。 */
+export declare function splitLogText(text: string): string[];
+/**
+ * 从一行正文推断语义色。
+ * 1. [error] / [ok] 等方括号级别（别名走 parseRsLogLevel）
+ * 2. 行首级别词，如 ERROR: / WARN
+ * 3. 工具链行首：BUILD SUCCESS / BUILD FAILURE / Exception in thread / panic:
+ * 4. 调用方 markers：成功 / 失败等产品标识（默认不扫）
+ * 行上已有 level / severity 时不会走到这里。
+ */
+export declare function inferLogLevel(text: string, options?: InferLogLevelOptions): RsLogLevel;
+/** 能解析的瞬间走 Intl；已是展示串则原样保留。 */
+export declare function formatLogTime(value: string | number | Date | undefined, locale?: string, options?: Intl.DateTimeFormatOptions): string | undefined;
+export type NormalizeLogLinesOptions = {
+    inferLevel?: boolean;
+    /** 传给 inferLogLevel 的成功 / 失败等标识。inferLevel 为 false 时不使用。 */
+    inferMarkers?: RsLogInferMarkers;
+    maxLines?: number;
+    severityScale?: RsLogSeverityScale;
+    locale?: string;
+    timeFormat?: Intl.DateTimeFormatOptions;
+};
+/** 把 string / 行对象收成渲染结构。inferLevel 默认开。 */
+export declare function normalizeLogLines(source: string | RsLogLineInput[] | undefined | null, options?: NormalizeLogLinesOptions): RsNormalizedLogLine[];
+/** 把一行收成可写回 v-model 的结构（字符串保持字符串）。 */
+export declare function toLogLineInput(input: RsLogLineInput): RsLogLineInput;
+export declare function joinLogLines(lines: Array<{
+    text: string;
+}>): string;
+export declare function clampLogCount<T>(items: T[], maxLines?: number): T[];
+export declare function filterLogLines(lines: RsNormalizedLogLine[], options?: {
+    levels?: readonly RsLogLevel[];
+    search?: string;
+}): RsNormalizedLogLine[];
+export type RsLogHighlightPart = {
+    text: string;
+    hit: boolean;
+};
+/** 按查询切开正文，供搜索高亮。大小写不敏感。 */
+export declare function splitLogHighlight(text: string, query: string): RsLogHighlightPart[];
+export declare function resolveLogLive(live?: boolean | 'off' | 'polite' | 'assertive'): 'off' | 'polite' | 'assertive';
+export declare function countDroppedLines(total: number, maxLines?: number): number;
+export type RsLogCopySource = 'selection' | 'line' | 'visible' | 'all';
+/** 复制优先级：选区 > 全文 > 当前行 > 可见行（含搜索过滤结果）。 */
+export declare function resolveLogCopyText(options: {
+    selection?: string;
+    activeText?: string;
+    visibleTexts: string[];
+    allTexts?: string[];
+}): {
+    text: string;
+    source: RsLogCopySource;
+};