niuma-ui 1.1.12 → 1.2.1

package/dist/theme/apply.d.ts

@@ -0,0 +1,6 @@
+import type { RsThemeMode } from './types';
+/**
+ * 切换明暗主题：仅设置 data-rs-theme，色值由 styles.css 中的 CSS 变量提供。
+ * 业务定制请写 CSS 覆盖 --rs-*，见 theme/brand.example.css
+ */
+export declare function applyTheme(mode: RsThemeMode, el?: HTMLElement): void;

package/dist/theme/apply.js

@@ -0,0 +1,10 @@
+//#region src/theme/apply.ts
+/**
+* 切换明暗主题：仅设置 data-rs-theme，色值由 styles.css 中的 CSS 变量提供。
+* 业务定制请写 CSS 覆盖 --rs-*，见 theme/brand.example.css
+*/
+function applyTheme(mode, el = document.documentElement) {
+	el.setAttribute("data-rs-theme", mode);
+}
+//#endregion
+export { applyTheme };

package/dist/theme/css-token.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 读取已计算的 CSS 自定义属性（不含首尾空白）。
+ * 会展开嵌套 `var(--token)`，便于 jsdom 与宿主覆盖。
+ * SSR / 无 DOM 时返回空字符串。
+ */
+export declare function readCssVar(name: string, el?: HTMLElement | null): string;
+/** 根元素字号（px），供 rem 换算；失败时按 16。 */
+export declare function readRootFontSizePx(): number;
+/**
+ * 将 `12px` / `0.875rem` / 无单位数字解析为 px。
+ * 嵌套 `var()` 须先经 getComputedStyle 展开。
+ */
+export declare function parseCssLengthToPx(raw: string, rootPx?: number): number | null;
+/** 读取长度类 token 并转为 px，供 Monaco / xterm 等只接受数字的 API。 */
+export declare function readCssLengthPx(name: string, fallback: number, el?: HTMLElement | null): number;
+/** 代码编辑器字体族：`--rs-code-font-family` → `--rs-font-mono`。 */
+export declare function readCodeFontFamily(el?: HTMLElement | null): string;
+/** 代码编辑器字号（px）：`--rs-code-font-size`，缺省按 sm=14。 */
+export declare function readCodeFontSizePx(el?: HTMLElement | null): number;
+/** 终端字体族：`--rs-terminal-font-family` → `--rs-font-mono`。 */
+export declare function readTerminalFontFamily(el?: HTMLElement | null): string;
+/** 终端字号（px）：`--rs-terminal-font-size`，缺省按 sm=14。 */
+export declare function readTerminalFontSizePx(el?: HTMLElement | null): number;
+/** 终端字重：`--rs-terminal-font-weight`，缺省 regular。 */
+export declare function readTerminalFontWeight(el?: HTMLElement | null): string;
+/** 终端粗体字重：`--rs-terminal-font-weight-bold`，缺省 medium。 */
+export declare function readTerminalFontWeightBold(el?: HTMLElement | null): string;

package/dist/theme/css-token.js

@@ -0,0 +1,72 @@
+//#region src/theme/css-token.ts
+var FALLBACK_ROOT_PX = 16;
+function unwrapCssVar(raw, el, depth = 0) {
+	if (!raw || depth > 8) return raw;
+	const match = /^var\(\s*(--[\w-]+)\s*(?:,\s*((?:.|\s)+))?\)$/.exec(raw);
+	if (!match) return raw;
+	const inner = getComputedStyle(el).getPropertyValue(match[1]).trim();
+	if (inner) return unwrapCssVar(inner, el, depth + 1);
+	const fallback = (match[2] || "").trim();
+	return fallback ? unwrapCssVar(fallback, el, depth + 1) : "";
+}
+/**
+* 读取已计算的 CSS 自定义属性（不含首尾空白）。
+* 会展开嵌套 `var(--token)`，便于 jsdom 与宿主覆盖。
+* SSR / 无 DOM 时返回空字符串。
+*/
+function readCssVar(name, el) {
+	if (typeof document === "undefined" || typeof getComputedStyle === "undefined") return "";
+	const target = el ?? document.documentElement;
+	return unwrapCssVar(getComputedStyle(target).getPropertyValue(name).trim(), target);
+}
+/** 根元素字号（px），供 rem 换算；失败时按 16。 */
+function readRootFontSizePx() {
+	if (typeof document === "undefined" || typeof getComputedStyle === "undefined") return FALLBACK_ROOT_PX;
+	const n = Number.parseFloat(getComputedStyle(document.documentElement).fontSize);
+	return Number.isFinite(n) && n > 0 ? n : FALLBACK_ROOT_PX;
+}
+/**
+* 将 `12px` / `0.875rem` / 无单位数字解析为 px。
+* 嵌套 `var()` 须先经 getComputedStyle 展开。
+*/
+function parseCssLengthToPx(raw, rootPx = readRootFontSizePx()) {
+	const value = raw.trim();
+	if (!value) return null;
+	const n = Number.parseFloat(value);
+	if (!Number.isFinite(n)) return null;
+	if (value.endsWith("px") || /^-?[\d.]+$/.test(value)) return n;
+	if (value.endsWith("rem") || value.endsWith("em")) return n * rootPx;
+	return null;
+}
+/** 读取长度类 token 并转为 px，供 Monaco / xterm 等只接受数字的 API。 */
+function readCssLengthPx(name, fallback, el) {
+	const parsed = parseCssLengthToPx(readCssVar(name, el));
+	return parsed == null ? fallback : parsed;
+}
+var CODE_FONT_FALLBACK = "ui-monospace, SF Mono, Consolas, Liberation Mono, Menlo, monospace";
+/** 代码编辑器字体族：`--rs-code-font-family` → `--rs-font-mono`。 */
+function readCodeFontFamily(el) {
+	return readCssVar("--rs-code-font-family", el) || readCssVar("--rs-font-mono", el) || CODE_FONT_FALLBACK;
+}
+/** 代码编辑器字号（px）：`--rs-code-font-size`，缺省按 sm=14。 */
+function readCodeFontSizePx(el) {
+	return readCssLengthPx("--rs-code-font-size", 14, el);
+}
+/** 终端字体族：`--rs-terminal-font-family` → `--rs-font-mono`。 */
+function readTerminalFontFamily(el) {
+	return readCssVar("--rs-terminal-font-family", el) || readCssVar("--rs-font-mono", el) || CODE_FONT_FALLBACK;
+}
+/** 终端字号（px）：`--rs-terminal-font-size`，缺省按 sm=14。 */
+function readTerminalFontSizePx(el) {
+	return readCssLengthPx("--rs-terminal-font-size", 14, el);
+}
+/** 终端字重：`--rs-terminal-font-weight`，缺省 regular。 */
+function readTerminalFontWeight(el) {
+	return readCssVar("--rs-terminal-font-weight", el) || readCssVar("--rs-font-weight-regular", el) || "400";
+}
+/** 终端粗体字重：`--rs-terminal-font-weight-bold`，缺省 medium。 */
+function readTerminalFontWeightBold(el) {
+	return readCssVar("--rs-terminal-font-weight-bold", el) || readCssVar("--rs-font-weight-medium", el) || "500";
+}
+//#endregion
+export { parseCssLengthToPx, readCodeFontFamily, readCodeFontSizePx, readCssLengthPx, readCssVar, readRootFontSizePx, readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold };

package/dist/theme/presets.d.ts

@@ -0,0 +1,7 @@
+import type { RsThemeMode, RsThemeTokens } from './types';
+/**
+ * 色板参考值（与 styles.css 中的 --rs-* 保持同步，勿单独改此处）
+ * 暗色：VS Code Dark Modern 灰阶 + macOS 系统色（primary / danger / success 等）
+ * 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义
+ */
+export declare const themePresets: Record<RsThemeMode, RsThemeTokens>;

package/dist/theme/presets.js

@@ -0,0 +1,74 @@
+//#region src/theme/presets.ts
+/**
+* 色板参考值（与 styles.css 中的 --rs-* 保持同步，勿单独改此处）
+* 暗色：VS Code Dark Modern 灰阶 + macOS 系统色（primary / danger / success 等）
+* 亮色：macOS systemBackground / label + VS Code Light Modern 表格语义
+*/
+var themePresets = {
+	light: {
+		primary: "#007aff",
+		primaryHover: "#0071eb",
+		primaryForeground: "#ffffff",
+		primaryContainer: "#e5f1ff",
+		onPrimaryContainer: "#003d99",
+		bg: "#f5f5f7",
+		surface: "#ffffff",
+		surfaceElevated: "#ffffff",
+		surfaceHover: "#e8e8ed",
+		inputBg: "#ffffff",
+		border: "#8c8c8c",
+		borderSubtle: "rgb(60 60 67 / 0.20)",
+		text: "#1d1d1f",
+		muted: "#6e6e73",
+		placeholder: "#909090",
+		textDisabled: "#aeaeb2",
+		textInverse: "#ffffff",
+		danger: "#ff3b30",
+		dangerContainer: "#ffe5e3",
+		onDangerContainer: "#c41e16",
+		success: "#34c759",
+		successContainer: "#e4f8e9",
+		onSuccessContainer: "#1a7f37",
+		warning: "#ff9500",
+		warningContainer: "#fff3e0",
+		onWarningContainer: "#b26500",
+		info: "#007aff",
+		infoContainer: "#e5f1ff",
+		onInfoContainer: "#003d99",
+		focusRing: "color-mix(in srgb, #007aff 22%, transparent)"
+	},
+	dark: {
+		primary: "#0a84ff",
+		primaryHover: "#409cff",
+		primaryForeground: "#ffffff",
+		primaryContainer: "#0a2540",
+		onPrimaryContainer: "#6cb4ff",
+		bg: "#181818",
+		surface: "#1f1f1f",
+		surfaceElevated: "#262626",
+		surfaceHover: "#2e2e2e",
+		inputBg: "#2b2b2b",
+		border: "#6e6e6e",
+		borderSubtle: "#3a3a3a",
+		text: "#cccccc",
+		muted: "#9d9d9d",
+		placeholder: "#919191",
+		textDisabled: "#6e6e6e",
+		textInverse: "#ffffff",
+		danger: "#ff453a",
+		dangerContainer: "#3b1210",
+		onDangerContainer: "#ff8a84",
+		success: "#30d158",
+		successContainer: "#0d2818",
+		onSuccessContainer: "#6ee79a",
+		warning: "#ff9f0a",
+		warningContainer: "#2e1f08",
+		onWarningContainer: "#ffc46b",
+		info: "#0a84ff",
+		infoContainer: "#0a2540",
+		onInfoContainer: "#6cb4ff",
+		focusRing: "color-mix(in srgb, #0a84ff 28%, transparent)"
+	}
+};
+//#endregion
+export { themePresets };

package/dist/theme/types.d.ts

@@ -0,0 +1,97 @@
+export type RsThemeMode = 'dark' | 'light';
+/**
+ * 控件尺寸（由小到大）：
+ * - ssm：极小
+ * - sm：小号
+ * - md：中号（默认）
+ * - lg：大号
+ *
+ * 高度由 `--rs-control-height-*` 统一控制，业务侧勿用 :deep 覆盖。
+ */
+export type RsComponentSize = 'ssm' | 'sm' | 'md' | 'lg';
+export declare const RS_COMPONENT_SIZES: readonly RsComponentSize[];
+/** 各档控件图标默认像素边长。 */
+export declare const RS_COMPONENT_SIZE_ICON_PX: Record<RsComponentSize, number>;
+/**
+ * 圆角档位（由小到大）：
+ * - none：直角（无圆角）
+ * - xs / sm / md / lg：对应 `--rs-radius-*`
+ * - full：胶囊 / 圆形
+ *
+ * 业务侧用组件 `radius` / `iconRadius` 等 prop，勿 :deep 改 border-radius。
+ */
+export type RsRadius = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'full';
+export declare const RS_RADII: readonly RsRadius[];
+/** 各档圆角对应的 CSS 值（可直接赋给 border-radius / CSS 变量）。 */
+export declare const RS_RADIUS_CSS: Record<RsRadius, string>;
+/**
+ * 字号档位（由小到大）：
+ * - xs：Caption / 辅助
+ * - sm：次要正文
+ * - base：正文（默认）
+ * - lg：强调正文
+ * - xl：小标题
+ * - 2xl：标题
+ * - 3xl：展示级标题
+ *
+ * 对应 `--rs-font-size-*`；业务侧优先用 token，勿硬编码 px。
+ * 字族走 `--rs-font-sans` / `--rs-font-mono` / `--rs-font-serif`，组件勿硬编码 system 栈。
+ */
+export type RsFontSize = 'xs' | 'sm' | 'base' | 'lg' | 'xl' | '2xl' | '3xl';
+export declare const RS_FONT_SIZES: readonly RsFontSize[];
+/** 各档字号对应的 CSS 值。 */
+export declare const RS_FONT_SIZE_CSS: Record<RsFontSize, string>;
+/**
+ * 字重档位：
+ * - regular：正文
+ * - medium：标签 / 弱强调
+ * - semibold：标题 / 表头
+ * - bold：强强调
+ */
+export type RsFontWeight = 'regular' | 'medium' | 'semibold' | 'bold';
+export declare const RS_FONT_WEIGHTS: readonly RsFontWeight[];
+/** 各档字重对应的 CSS 值。 */
+export declare const RS_FONT_WEIGHT_CSS: Record<RsFontWeight, string>;
+/**
+ * 设计 token
+ * 色彩语义：Google MD3 容器色 + 字节 Arco 中性色 + 国际 SaaS 功能色
+ * 文字语义：Ant / Arco 四级（primary / secondary / tertiary / disabled）+ link / inverse
+ */
+export interface RsThemeTokens {
+    primary: string;
+    primaryHover: string;
+    primaryForeground: string;
+    primaryContainer: string;
+    onPrimaryContainer: string;
+    bg: string;
+    surface: string;
+    surfaceElevated: string;
+    surfaceHover: string;
+    inputBg: string;
+    border: string;
+    borderSubtle: string;
+    /** 主文案（与 --rs-text / --rs-text-primary 同步） */
+    text: string;
+    /** 次要文案（与 --rs-muted / --rs-text-secondary 同步） */
+    muted: string;
+    /** 占位 / 三级文案（与 --rs-placeholder / --rs-text-tertiary 同步） */
+    placeholder: string;
+    /** 禁用文案（与 --rs-text-disabled 同步） */
+    textDisabled: string;
+    /** 反色文案，用于主色 / 深色底（与 --rs-text-inverse 同步） */
+    textInverse: string;
+    danger: string;
+    dangerContainer: string;
+    onDangerContainer: string;
+    success: string;
+    successContainer: string;
+    onSuccessContainer: string;
+    warning: string;
+    warningContainer: string;
+    onWarningContainer: string;
+    info: string;
+    infoContainer: string;
+    onInfoContainer: string;
+    focusRing: string;
+}
+export declare const themeAttribute = "data-rs-theme";

package/dist/theme/types.js

@@ -0,0 +1,65 @@
+//#region src/theme/types.ts
+var RS_COMPONENT_SIZES = [
+	"ssm",
+	"sm",
+	"md",
+	"lg"
+];
+/** 各档控件图标默认像素边长。 */
+var RS_COMPONENT_SIZE_ICON_PX = {
+	ssm: 12,
+	sm: 14,
+	md: 16,
+	lg: 18
+};
+var RS_RADII = [
+	"none",
+	"xs",
+	"sm",
+	"md",
+	"lg",
+	"full"
+];
+/** 各档圆角对应的 CSS 值（可直接赋给 border-radius / CSS 变量）。 */
+var RS_RADIUS_CSS = {
+	none: "0",
+	xs: "var(--rs-radius-xs)",
+	sm: "var(--rs-radius-sm)",
+	md: "var(--rs-radius)",
+	lg: "var(--rs-radius-lg)",
+	full: "var(--rs-radius-full)"
+};
+var RS_FONT_SIZES = [
+	"xs",
+	"sm",
+	"base",
+	"lg",
+	"xl",
+	"2xl",
+	"3xl"
+];
+/** 各档字号对应的 CSS 值。 */
+var RS_FONT_SIZE_CSS = {
+	xs: "var(--rs-font-size-xs)",
+	sm: "var(--rs-font-size-sm)",
+	base: "var(--rs-font-size-base)",
+	lg: "var(--rs-font-size-lg)",
+	xl: "var(--rs-font-size-xl)",
+	"2xl": "var(--rs-font-size-2xl)",
+	"3xl": "var(--rs-font-size-3xl)"
+};
+var RS_FONT_WEIGHTS = [
+	"regular",
+	"medium",
+	"semibold",
+	"bold"
+];
+/** 各档字重对应的 CSS 值。 */
+var RS_FONT_WEIGHT_CSS = {
+	regular: "var(--rs-font-weight-regular)",
+	medium: "var(--rs-font-weight-medium)",
+	semibold: "var(--rs-font-weight-semibold)",
+	bold: "var(--rs-font-weight-bold)"
+};
+//#endregion
+export { RS_COMPONENT_SIZES, RS_COMPONENT_SIZE_ICON_PX, RS_FONT_SIZES, RS_FONT_SIZE_CSS, RS_FONT_WEIGHTS, RS_FONT_WEIGHT_CSS, RS_RADII, RS_RADIUS_CSS };

package/dist/utils/rs-clipboard.d.ts

@@ -0,0 +1,17 @@
+/** 剪贴板读写封装：浏览器 Clipboard API 优先，CEF Shell Bridge 最后兜底。
+ *  CEF 壳层通过 CefPermissionHandler 自动放行 CEF_PERMISSION_TYPE_CLIPBOARD，
+ *  避免 Alloy 默认 IGNORE；Shell Bridge 仅在 API 仍失败时使用。
+ */
+/** 在 contextmenu 等仍持有用户手势时预读剪贴板，供稍后菜单项点击使用 */
+export declare function prefetchClipboardText(): Promise<void>;
+/** 启动预读并返回 promise，菜单点击粘贴前应 await */
+export declare function beginClipboardPrefetch(): Promise<void>;
+export declare function waitClipboardPrefetch(): Promise<void>;
+export declare function readClipboardText(): Promise<string | null>;
+export declare function writeClipboardText(text: string): Promise<boolean>;
+/** execCommand 兜底：CEF / 无 Clipboard API 权限时菜单复制仍可用 */
+export declare function copyTextWithExecCommand(text: string): boolean;
+/** 写入系统剪贴板（API 优先，execCommand 兜底） */
+export declare function copyTextToClipboard(text: string): Promise<boolean>;
+/** @internal vitest 用 */
+export declare function __resetClipboardStateForTests(): void;

package/dist/utils/rs-clipboard.js

@@ -0,0 +1,187 @@
+//#region src/utils/rs-clipboard.ts
+function bridgeRequestId() {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+	return `clip-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+}
+function getCefQuery() {
+	const fn = globalThis.cefQuery;
+	return typeof fn === "function" ? fn : null;
+}
+async function bridgeInvokeClipboard(method, params = {}) {
+	const cefQuery = getCefQuery();
+	if (!cefQuery) return null;
+	return new Promise((resolve) => {
+		cefQuery({
+			request: JSON.stringify({
+				method,
+				params,
+				id: bridgeRequestId()
+			}),
+			onSuccess: (response) => {
+				try {
+					resolve(JSON.parse(response));
+				} catch {
+					resolve(null);
+				}
+			},
+			onFailure: () => resolve(null)
+		});
+	});
+}
+async function readClipboardViaShell() {
+	const text = (await bridgeInvokeClipboard("shell.clipboard.readText"))?.text;
+	return text ? text : null;
+}
+async function writeClipboardViaShell(text) {
+	const result = await bridgeInvokeClipboard("shell.clipboard.writeText", { text });
+	return Boolean(result?.written);
+}
+var prefetchedText = null;
+var prefetchAt = 0;
+var prefetchPromise = null;
+var readApiBlocked = false;
+var writeApiBlocked = false;
+var permissionStateProbed = false;
+var PREFETCH_TTL_MS = 1e4;
+function isClipboardPermissionDeniedError(err) {
+	return err instanceof DOMException && (err.name === "NotAllowedError" || err.name === "SecurityError");
+}
+function markReadApiBlocked(err) {
+	if (err === void 0 || isClipboardPermissionDeniedError(err)) readApiBlocked = true;
+}
+function markWriteApiBlocked(err) {
+	if (err === void 0 || isClipboardPermissionDeniedError(err)) writeApiBlocked = true;
+}
+async function syncClipboardPermissionState() {
+	if (permissionStateProbed) return;
+	permissionStateProbed = true;
+	if (!navigator.permissions?.query) return;
+	try {
+		const read = await navigator.permissions.query({ name: "clipboard-read" });
+		if (read.state === "denied") readApiBlocked = true;
+		read.onchange = () => {
+			readApiBlocked = read.state === "denied";
+		};
+	} catch {}
+	try {
+		const write = await navigator.permissions.query({ name: "clipboard-write" });
+		if (write.state === "denied") writeApiBlocked = true;
+		write.onchange = () => {
+			writeApiBlocked = write.state === "denied";
+		};
+	} catch {}
+}
+/** 在 contextmenu 等仍持有用户手势时预读剪贴板，供稍后菜单项点击使用 */
+async function prefetchClipboardText() {
+	prefetchedText = null;
+	prefetchAt = Date.now();
+	await syncClipboardPermissionState();
+	if (!readApiBlocked) {
+		const fromReadText = await readClipboardViaReadText();
+		if (fromReadText) {
+			prefetchedText = fromReadText;
+			return;
+		}
+		const fromItems = await readClipboardViaItems();
+		if (fromItems) {
+			prefetchedText = fromItems;
+			return;
+		}
+	}
+	const fromShell = await readClipboardViaShell();
+	if (fromShell) prefetchedText = fromShell;
+}
+/** 启动预读并返回 promise，菜单点击粘贴前应 await */
+function beginClipboardPrefetch() {
+	prefetchPromise = prefetchClipboardText().finally(() => {
+		prefetchPromise = null;
+	});
+	return prefetchPromise;
+}
+async function waitClipboardPrefetch() {
+	if (prefetchPromise) await prefetchPromise;
+}
+function takePrefetchedText() {
+	if (!prefetchedText || Date.now() - prefetchAt > PREFETCH_TTL_MS) {
+		prefetchedText = null;
+		return null;
+	}
+	const text = prefetchedText;
+	prefetchedText = null;
+	return text;
+}
+async function readClipboardText() {
+	await waitClipboardPrefetch();
+	const cached = takePrefetchedText();
+	if (cached) return cached;
+	await syncClipboardPermissionState();
+	if (!readApiBlocked) {
+		const fromReadText = await readClipboardViaReadText();
+		if (fromReadText) return fromReadText;
+		const fromItems = await readClipboardViaItems();
+		if (fromItems) return fromItems;
+	}
+	return readClipboardViaShell();
+}
+async function readClipboardViaReadText() {
+	if (readApiBlocked || !navigator.clipboard?.readText) return null;
+	try {
+		return await navigator.clipboard.readText() || null;
+	} catch (err) {
+		markReadApiBlocked(err);
+		return null;
+	}
+}
+/** readText 失败时尝试 clipboard.read() 取 text/plain（CEF 部分场景更稳） */
+async function readClipboardViaItems() {
+	if (readApiBlocked || !navigator.clipboard?.read) return null;
+	try {
+		const items = await navigator.clipboard.read();
+		for (const item of items) {
+			if (!item.types.includes("text/plain")) continue;
+			const text = await (await item.getType("text/plain")).text();
+			if (text) return text;
+		}
+	} catch (err) {
+		markReadApiBlocked(err);
+		return null;
+	}
+	return null;
+}
+async function writeClipboardText(text) {
+	if (!text || writeApiBlocked || !navigator.clipboard?.writeText) return false;
+	try {
+		await navigator.clipboard.writeText(text);
+		return true;
+	} catch (err) {
+		markWriteApiBlocked(err);
+		return false;
+	}
+}
+/** execCommand 兜底：CEF / 无 Clipboard API 权限时菜单复制仍可用 */
+function copyTextWithExecCommand(text) {
+	if (!text || typeof document === "undefined") return false;
+	try {
+		const textarea = document.createElement("textarea");
+		textarea.value = text;
+		textarea.setAttribute("readonly", "");
+		textarea.style.cssText = "position:fixed;left:-9999px;top:0;opacity:0";
+		document.body.appendChild(textarea);
+		textarea.select();
+		const ok = document.execCommand("copy");
+		textarea.remove();
+		return ok;
+	} catch {
+		return false;
+	}
+}
+/** 写入系统剪贴板（API 优先，execCommand 兜底） */
+async function copyTextToClipboard(text) {
+	if (!text) return false;
+	await syncClipboardPermissionState();
+	if (!writeApiBlocked && await writeClipboardText(text)) return true;
+	if (copyTextWithExecCommand(text)) return true;
+	return writeClipboardViaShell(text);
+}
+//#endregion
+export { beginClipboardPrefetch, copyTextToClipboard, copyTextWithExecCommand, prefetchClipboardText, readClipboardText, waitClipboardPrefetch, writeClipboardText };

package/dist/vite-plugins/monaco-zh-nls.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'vite';
+/** MonacoZhNlsOptions 预留扩展（例如后续 locale）。 */
+export type MonacoZhNlsOptions = object;
+/**
+ * MonacoZhNlsPlugin 用官方中文 NLS 替换 monaco-editor 的 nls.messages.js。
+ */
+export declare function monacoZhNlsPlugin(_options?: MonacoZhNlsOptions): Plugin;

package/dist/vite-plugins/monaco-zh-nls.js

@@ -0,0 +1,84 @@
+/**
+ * Vite 插件：将 Monaco Editor 0.55 内置的官方中文 NLS 注入 `nls.messages.js`。
+ *
+ * localize() 使用数字索引，需设置 globalThis._VSCODE_NLS_MESSAGES。
+ * 官方文件：monaco-editor/min/vs/nls.messages.zh-cn.js.js。
+ *
+ * 两阶段 load：
+ *  1. config + rolldown plugin → Vite 8 optimizeDeps
+ *  2. Rollup load → 生产构建 / 未预构建的 dev
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+function extractZhCnMessages() {
+    try {
+        const require = createRequire(import.meta.url);
+        const zhCnPath = require.resolve('monaco-editor/min/vs/nls.messages.zh-cn.js.js');
+        const raw = readFileSync(zhCnPath, 'utf8');
+        const start = raw.indexOf('_VSCODE_NLS_MESSAGES=[');
+        if (start === -1)
+            return '';
+        const arrStart = raw.indexOf('[', start);
+        let depth = 0;
+        let arrEnd = -1;
+        for (let i = arrStart; i < raw.length; i++) {
+            if (raw[i] === '[')
+                depth++;
+            else if (raw[i] === ']') {
+                depth--;
+                if (depth === 0) {
+                    arrEnd = i;
+                    break;
+                }
+            }
+        }
+        return arrEnd !== -1 ? raw.slice(arrStart, arrEnd + 1) : '';
+    }
+    catch (e) {
+        console.warn('[monaco-zh-nls] 无法加载 Monaco 官方中文 NLS:', e);
+        return '';
+    }
+}
+/**
+ * MonacoZhNlsPlugin 用官方中文 NLS 替换 monaco-editor 的 nls.messages.js。
+ */
+export function monacoZhNlsPlugin(_options = {}) {
+    const messagesCode = extractZhCnMessages();
+    if (!messagesCode) {
+        console.warn('[monaco-zh-nls] 中文 NLS 数组提取失败，跳过插件');
+        return { name: 'monaco-zh-nls' };
+    }
+    const nlsModuleCode = `
+/* monaco-zh-nls: Monaco 0.55 官方中文翻译 */
+globalThis._VSCODE_NLS_MESSAGES = ${messagesCode};
+globalThis._VSCODE_NLS_LANGUAGE = 'zh-cn';
+export function getNLSMessages() { return globalThis._VSCODE_NLS_MESSAGES; }
+export function getNLSLanguage() { return globalThis._VSCODE_NLS_LANGUAGE; }
+`;
+    const nlsFileFilter = /monaco-editor[/\\]esm[/\\]vs[/\\]nls\.messages\.js$/;
+    const rolldownPlugin = {
+        name: 'monaco-zh-nls-rolldown',
+        load(id) {
+            if (nlsFileFilter.test(id))
+                return nlsModuleCode;
+            return undefined;
+        },
+    };
+    return {
+        name: 'monaco-zh-nls',
+        enforce: 'pre',
+        config() {
+            return {
+                optimizeDeps: {
+                    rolldownOptions: {
+                        plugins: [rolldownPlugin],
+                    },
+                },
+            };
+        },
+        load(id) {
+            if (nlsFileFilter.test(id))
+                return nlsModuleCode;
+        },
+    };
+}