niuma-ui 2.0.4 → 2.1.0

package/dist/components/loading/src/loading-status.impl.js

@@ -0,0 +1,84 @@
+import { resolveRsLoadingSkeletonCount } from "./loading-utils.js";
+import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, normalizeClass, openBlock, renderList, renderSlot, toDisplayString } from "vue";
+//#region src/components/loading/src/loading-status.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["id", "aria-label"];
+var _hoisted_2 = {
+	key: 0,
+	class: "rs-loading__label"
+};
+var loading_status_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsLoadingStatus",
+	__name: "loading-status",
+	props: {
+		id: {},
+		variant: {},
+		size: {},
+		tone: {},
+		label: {},
+		ariaLabel: {},
+		showText: {
+			type: Boolean,
+			default: false
+		},
+		block: {
+			type: Boolean,
+			default: false
+		},
+		overlay: {
+			type: Boolean,
+			default: false
+		},
+		fullscreen: {
+			type: Boolean,
+			default: false
+		},
+		skeletonCount: {}
+	},
+	setup(__props) {
+		const props = __props;
+		const lines = computed(() => Array.from({ length: resolveRsLoadingSkeletonCount(props.skeletonCount) }, (_, index) => index));
+		const rootClass = computed(() => [
+			"rs-loading",
+			`rs-loading--${props.size}`,
+			`rs-loading--tone-${props.tone}`,
+			{
+				"rs-loading--block": props.block,
+				"rs-loading--overlay": props.overlay,
+				"rs-loading--fullscreen": props.fullscreen
+			}
+		]);
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				id: __props.id,
+				class: normalizeClass(rootClass.value),
+				role: "status",
+				"aria-busy": "true",
+				"aria-label": __props.ariaLabel
+			}, [createElementVNode("div", {
+				class: normalizeClass(["rs-loading__mark", { "rs-loading__mark--fill": __props.variant === "skeleton" && !_ctx.$slots.indicator }]),
+				"aria-hidden": "true"
+			}, [renderSlot(_ctx.$slots, "indicator", {}, () => [__props.variant === "spinner" ? (openBlock(), createElementBlock("span", {
+				key: 0,
+				class: normalizeClass(["rs-loading__spinner", [`rs-loading__spinner--${__props.size}`, `rs-loading__spinner--${__props.tone}`]])
+			}, null, 2)) : __props.variant === "dots" ? (openBlock(), createElementBlock("span", {
+				key: 1,
+				class: normalizeClass(["rs-loading__dots", `rs-loading__dots--${__props.size}`])
+			}, [(openBlock(), createElementBlock(Fragment, null, renderList(3, (dot) => {
+				return createElementVNode("span", {
+					key: dot,
+					class: "rs-loading__dot"
+				});
+			}), 64))], 2)) : (openBlock(), createElementBlock("div", {
+				key: 2,
+				class: normalizeClass(["rs-loading__skeleton", `rs-loading__skeleton--${__props.size}`])
+			}, [(openBlock(true), createElementBlock(Fragment, null, renderList(lines.value, (line) => {
+				return openBlock(), createElementBlock("span", {
+					key: line,
+					class: "rs-loading__skeleton-line"
+				});
+			}), 128))], 2))], true)], 2), __props.showText ? (openBlock(), createElementBlock("div", _hoisted_2, [renderSlot(_ctx.$slots, "label", {}, () => [createTextVNode(toDisplayString(__props.label), 1)], true)])) : createCommentVNode("", true)], 10, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { loading_status_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/loading/src/loading-status.js

@@ -0,0 +1,8 @@
+import './loading-status.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
+import loading_status_vue_vue_type_script_setup_true_lang_default from "./loading-status.impl.js";
+
+//#region src/components/loading/src/loading-status.vue
+var loading_status_default = /*#__PURE__*/ _plugin_vue_export_helper_default(loading_status_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-3e88a656"]]);
+//#endregion
+export { loading_status_default as default };

package/dist/components/loading/src/loading-utils.d.ts

@@ -1,6 +1,53 @@
-/** 加载指示器尺寸 */
+/** 加载指示器尺寸。不是表单控件四档，不跟 ConfigProvider。 */
 export type RsLoadingSize = 'sm' | 'md' | 'lg';
-/** 加载指示器色调 */
-export type RsLoadingTone = 'default' | 'primary';
-/** 加载指示器变体 */
+/**
+ * 色相。`default` 是旧调用，画面与 `neutral` 相同。
+ * 形态仍由 variant 决定。
+ */
+export type RsLoadingTone = 'default' | 'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+/** 加载指示器形态。 */
 export type RsLoadingVariant = 'spinner' | 'dots' | 'skeleton';
+/** 骨架行上限，避免一次挂出过多无限动画节点。 */
+export declare const RS_LOADING_SKELETON_MAX = 12;
+/** delay / minDuration 上限（毫秒）。非法值或非有限数视为 0。 */
+export declare const RS_LOADING_MAX_MS = 60000;
+export declare function resolveRsLoadingSize(size?: string | null): RsLoadingSize;
+export declare function resolveRsLoadingTone(tone?: string | null): RsLoadingTone;
+export declare function resolveRsLoadingVariant(variant?: string | null): RsLoadingVariant;
+export declare function resolveRsLoadingSkeletonCount(lines: number | undefined, fallback?: number): number;
+export declare function clampRsLoadingDuration(value: number | undefined): number;
+export type RsLoadingVisibilityPlan = {
+    action: 'show';
+    shownAt: number;
+} | {
+    action: 'hide';
+} | {
+    action: 'idle';
+} | {
+    action: 'keep';
+} | {
+    action: 'wait';
+    ms: number;
+    then: 'show' | 'hide';
+};
+/**
+ * 纯函数：决定指示器现在出现、消失，还是再等一会儿。
+ * 组件负责定时器，并在卸载时清掉。
+ */
+export declare function planRsLoadingVisibility(input: {
+    loading: boolean;
+    visible: boolean;
+    delayMs: number;
+    minDurationMs: number;
+    shownAt: number | null;
+    now: number;
+}): RsLoadingVisibilityPlan;
+/** 全屏传送目标。非全屏不调用 getContainer。失败或空节点回退 body。 */
+export declare function resolveRsLoadingTeleportTarget(fullscreen: boolean, getContainer?: () => HTMLElement | string | null): string | HTMLElement;
+/**
+ * 全屏锁滚动，并暂时挡住页面点击。引用计数，释放函数可重复调用。
+ * 不改焦点陷阱。无 document 时返回空操作（SSR）。
+ */
+export declare function acquireRsLoadingScrollLock(): () => void;
+/** 单测收尾。生产路径靠释放函数把计数减到 0。 */
+export declare function resetRsLoadingScrollLock(): void;

package/dist/components/loading/src/loading-utils.js

@@ -0,0 +1,122 @@
+//#region src/components/loading/src/loading-utils.ts
+var SIZES = /* @__PURE__ */ new Set([
+	"sm",
+	"md",
+	"lg"
+]);
+var TONES = /* @__PURE__ */ new Set([
+	"default",
+	"neutral",
+	"primary",
+	"success",
+	"warning",
+	"danger",
+	"info"
+]);
+var VARIANTS = /* @__PURE__ */ new Set([
+	"spinner",
+	"dots",
+	"skeleton"
+]);
+/** delay / minDuration 上限（毫秒）。非法值或非有限数视为 0。 */
+var RS_LOADING_MAX_MS = 6e4;
+function resolveRsLoadingSize(size) {
+	if (size && SIZES.has(size)) return size;
+	return "md";
+}
+function resolveRsLoadingTone(tone) {
+	if (tone && TONES.has(tone)) return tone;
+	return "primary";
+}
+function resolveRsLoadingVariant(variant) {
+	if (variant && VARIANTS.has(variant)) return variant;
+	return "spinner";
+}
+function resolveRsLoadingSkeletonCount(lines, fallback = 4) {
+	return Math.min(12, Math.max(1, typeof lines === "number" && Number.isFinite(lines) ? Math.floor(lines) : fallback));
+}
+function clampRsLoadingDuration(value) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return 0;
+	return Math.min(value, RS_LOADING_MAX_MS);
+}
+/**
+* 纯函数：决定指示器现在出现、消失，还是再等一会儿。
+* 组件负责定时器，并在卸载时清掉。
+*/
+function planRsLoadingVisibility(input) {
+	const delay = clampRsLoadingDuration(input.delayMs);
+	const minDuration = clampRsLoadingDuration(input.minDurationMs);
+	if (input.loading) {
+		if (input.visible) return { action: "keep" };
+		if (delay <= 0) return {
+			action: "show",
+			shownAt: input.now
+		};
+		return {
+			action: "wait",
+			ms: delay,
+			then: "show"
+		};
+	}
+	if (!input.visible) return { action: "idle" };
+	if (input.shownAt == null || minDuration <= 0) return { action: "hide" };
+	const remaining = minDuration - (input.now - input.shownAt);
+	if (remaining <= 0) return { action: "hide" };
+	return {
+		action: "wait",
+		ms: remaining,
+		then: "hide"
+	};
+}
+function isElementNode(value) {
+	return Boolean(value) && typeof value === "object" && value.nodeType === 1;
+}
+/** 全屏传送目标。非全屏不调用 getContainer。失败或空节点回退 body。 */
+function resolveRsLoadingTeleportTarget(fullscreen, getContainer) {
+	if (!fullscreen || !getContainer) return "body";
+	try {
+		const target = getContainer();
+		if (typeof target === "string" && target.trim()) return target;
+		if (isElementNode(target)) return target;
+	} catch {
+		return "body";
+	}
+	return "body";
+}
+var lockCount = 0;
+var previousOverflow = null;
+var previousPointer = null;
+var previousBusy = null;
+/**
+* 全屏锁滚动，并暂时挡住页面点击。引用计数，释放函数可重复调用。
+* 不改焦点陷阱。无 document 时返回空操作（SSR）。
+*/
+function acquireRsLoadingScrollLock() {
+	if (typeof document === "undefined" || !document.body) return () => {};
+	if (lockCount === 0) {
+		previousOverflow = document.body.style.overflow;
+		previousPointer = document.body.style.pointerEvents;
+		previousBusy = document.documentElement.getAttribute("aria-busy");
+		document.body.style.overflow = "hidden";
+		document.body.style.pointerEvents = "none";
+		document.documentElement.setAttribute("aria-busy", "true");
+	}
+	lockCount += 1;
+	let released = false;
+	return () => {
+		if (released) return;
+		released = true;
+		lockCount = Math.max(0, lockCount - 1);
+		if (lockCount === 0 && document.body) {
+			document.body.style.overflow = previousOverflow ?? "";
+			document.body.style.pointerEvents = previousPointer ?? "";
+			if (previousBusy == null) document.documentElement.removeAttribute("aria-busy");
+			else document.documentElement.setAttribute("aria-busy", previousBusy);
+			previousOverflow = null;
+			previousPointer = null;
+			previousBusy = null;
+		}
+	};
+}
+//#endregion
+export { RS_LOADING_MAX_MS, acquireRsLoadingScrollLock, clampRsLoadingDuration, planRsLoadingVisibility, resolveRsLoadingSize, resolveRsLoadingSkeletonCount, resolveRsLoadingTeleportTarget, resolveRsLoadingTone, resolveRsLoadingVariant };

package/dist/components/loading-bar/index.d.ts

@@ -1 +1,2 @@
 export { default as RsLoadingBar } from './src/RsLoadingBar.js';
+export type { RsLoadingBarAttach, RsLoadingBarExpose, RsLoadingBarInstance, RsLoadingBarPosition, RsLoadingBarTone, } from './src/loading-bar-utils';

package/dist/components/loading-bar/src/RsLoadingBar.css

@@ -1,19 +1,83 @@
 
-.rs-loading-bar[data-v-98c35618] {
+.rs-loading-bar[data-v-aff2ed50] {
   position: fixed;
-  top: 0;
+  inset-block-start: 0;
   inset-inline: 0;
   z-index: var(--rs-z-loading-bar);
+  height: var(--rs-loading-bar-size, 2px);
+  overflow: hidden;
   pointer-events: none;
   opacity: 0;
-  transition: opacity 0.2s ease;
+  transition: opacity var(--rs-transition-normal);
 }
-.rs-loading-bar--visible[data-v-98c35618] {
+.rs-loading-bar--bottom[data-v-aff2ed50] {
+  inset-block-start: auto;
+  inset-block-end: 0;
+}
+.rs-loading-bar--parent[data-v-aff2ed50] {
+  position: absolute;
+}
+.rs-loading-bar--visible[data-v-aff2ed50] {
   opacity: 1;
 }
-.rs-loading-bar__peg[data-v-98c35618] {
-  height: 2px;
+.rs-loading-bar--neutral[data-v-aff2ed50] {
+  --rs-loading-bar-color: var(--rs-text-secondary);
+}
+.rs-loading-bar--info[data-v-aff2ed50] {
+  --rs-loading-bar-color: var(--rs-info);
+}
+.rs-loading-bar--success[data-v-aff2ed50] {
+  --rs-loading-bar-color: var(--rs-success);
+}
+.rs-loading-bar--warning[data-v-aff2ed50] {
+  --rs-loading-bar-color: var(--rs-warning);
+}
+.rs-loading-bar--danger[data-v-aff2ed50] {
+  --rs-loading-bar-color: var(--rs-danger);
+}
+.rs-loading-bar__peg[data-v-aff2ed50] {
+  height: 100%;
+  width: var(--rs-loading-bar-progress, 0%);
+  background-color: var(--rs-loading-bar-color, var(--rs-primary));
   transition:
-    width 0.2s ease,
-    background-color 0.2s ease;
+    width var(--rs-transition-normal),
+    background-color var(--rs-transition-normal);
+}
+.rs-loading-bar--error .rs-loading-bar__peg[data-v-aff2ed50] {
+  background-color: var(--rs-loading-bar-error, var(--rs-danger));
+}
+.rs-loading-bar--indeterminate .rs-loading-bar__peg[data-v-aff2ed50] {
+  position: absolute;
+  inset-block: 0;
+  width: 38%;
+  transition: none;
+  animation: rs-loading-bar-slide-aff2ed50 1.15s ease-in-out infinite;
+}
+@keyframes rs-loading-bar-slide-aff2ed50 {
+from {
+    inset-inline-start: -40%;
+}
+to {
+    inset-inline-start: 100%;
+}
+}
+@media (prefers-reduced-motion: reduce) {
+.rs-loading-bar[data-v-aff2ed50],
+  .rs-loading-bar__peg[data-v-aff2ed50] {
+    transition: none;
+    animation: none;
+}
+.rs-loading-bar--indeterminate .rs-loading-bar__peg[data-v-aff2ed50] {
+    width: 100%;
+    inset-inline-start: 0;
+}
+}
+@media (forced-colors: active) {
+.rs-loading-bar__peg[data-v-aff2ed50] {
+    forced-color-adjust: none;
+    background-color: Highlight;
+}
+.rs-loading-bar--error .rs-loading-bar__peg[data-v-aff2ed50] {
+    background-color: Mark;
+}
 }

package/dist/components/loading-bar/src/RsLoadingBar.d.ts

@@ -1,25 +1,69 @@
+import { type RsLoadingBarAttach, type RsLoadingBarPosition, type RsLoadingBarTone } from './loading-bar-utils';
 type __VLS_Props = {
-    /** 受控进度 0-100；未传时由 start/finish/error 驱动 */
+    /** 受控进度 0–100。传入后显隐只跟这个值，命令式 API 不再改这条。 */
     progress?: number;
+    /** 条高（px）。默认 2，与 --rs-loading-bar-size 一致；未改默认时不写内联，方便覆盖 token。 */
     height?: number;
+    /** 进度色。未传走 tone / --rs-loading-bar-color。 */
     color?: string;
+    /** 失败色。未传走 --rs-loading-bar-error。 */
     errorColor?: string;
+    /** 色相。color 传入时以 color 为准。 */
+    tone?: RsLoadingBarTone;
+    /** 贴上沿或下沿。 */
+    position?: RsLoadingBarPosition;
+    /** viewport 固定在窗口；parent 绝对定位到最近的定位祖先。 */
+    attach?: RsLoadingBarAttach;
+    /** 是否自动向 maximum 蠕动。 */
+    trickle?: boolean;
+    /** trickle 间隔（ms）。小于 16 回落 200。 */
+    trickleSpeed?: number;
+    /** start 的起步进度。 */
+    minimum?: number;
+    /** trickle 停住的上限，finish 才会到 100。 */
+    maximum?: number;
+    /** 短请求不闪条。delay 内 finish 则从不显示。0 与历史行为一致。 */
+    delay?: number;
+    /** finish 后淡出毫秒。 */
+    finishDuration?: number;
+    /** error 后淡出毫秒。 */
+    errorDuration?: number;
+    /** 重叠的 start/finish 计数。默认关闭，每次 start 仍会回到 minimum。 */
+    nesting?: boolean;
+    /** 未知进度：滑动条，不报 aria-valuenow。 */
+    indeterminate?: boolean;
+    /** 覆盖可访问名称。未传走 loadingBar.label / loadingBar.error。 */
+    ariaLabel?: string;
+    id?: string;
 };
-declare function start(): void;
-declare function finish(): void;
-declare function error(): void;
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {
-    start: typeof start;
-    finish: typeof finish;
-    error: typeof error;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    color: string;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, import("./loading-bar-utils").RsLoadingBarExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (progress: number) => any;
+    error: () => any;
+    start: (pending: number) => any;
+    finish: (pending: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((progress: number) => any) | undefined;
+    onError?: (() => any) | undefined;
+    onStart?: ((pending: number) => any) | undefined;
+    onFinish?: ((pending: number) => any) | undefined;
+}>, {
     height: number;
-    errorColor: string;
+    tone: RsLoadingBarTone;
+    indeterminate: boolean;
+    position: RsLoadingBarPosition;
+    attach: RsLoadingBarAttach;
+    trickle: boolean;
+    trickleSpeed: number;
+    minimum: number;
+    maximum: number;
+    delay: number;
+    finishDuration: number;
+    errorDuration: number;
+    nesting: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;