@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.1.0

package/dist/utils/request/wire.js

@@ -0,0 +1,208 @@
+import { isDecimal, numericText } from "../data/numeric.js";
+import { CalendarDate, CalendarDateTime, Time, ZonedDateTime, getLocalTimeZone, parseAbsolute, parseDate, parseDateTime, parseTime } from "@internationalized/date";
+//#region src/utils/request/wire.ts
+/**
+* 线上的 typed JSON（与 query 库的 @zerodep-dev/wire、Java 的 org.dpdns.zerodep.wire 同一套写法）：bigint、Decimal、
+* 日期、时间、字节等 JSON 不能原样承载的值写成文字，根对象上的 `$types` 记下它们的位置（路径 → 种类），对方据此还原。
+* createHttpClient 默认就用它：请求体经 toWire 发出，带 `$types` 的响应经 fromWire 还原，地址栏参数经 wireText 写成文字。
+*
+*   toWire({ id: 9007199254740993n, amount: new Decimal('12.50'), on: new CalendarDate(2024, 1, 31) })
+*   // { id: '9007199254740993', amount: '12.5', on: '2024-01-31', $types: { id: 'bigint', amount: 'decimal', on: 'date' } }
+*
+* 种类与文字：bigint 是十进制整数，decimal 不用科学计数法，double 只有 NaN / ±Infinity 写成文字，date 'YYYY-MM-DD'、
+* time 'HH:mm:ss'、timestamp 'YYYY-MM-DDTHH:mm:ss[.fff]'、timestamptz 换算成 UTC 带 Z，bytes 是标准 base64。
+* 路径从根开始用点连接属性名，数组不占一段（`rows.amount` 是每一行的 amount），属性名里的 ~ 与 . 写成 ~0、~1。
+*
+* 还原的默认值跟组件的约定走：bigint 还原成 bigint；decimal 在给了 Decimal 构造函数时还原成 Decimal，否则留作十进制文字
+* （DataTable 的数字列、NumberField 都认）；日期与时间留作 ISO 文字（组件对外的值就是它），dates: 'objects' 时还原成
+* CalendarDate、Time、CalendarDateTime、ZonedDateTime。这里不在运行时导入 decimal.js（同 numeric.ts）。
+*/
+var TYPES = "$types";
+var VALUE = "$value";
+/** 值要还原成哪一种；JSON 能原样承载的值为 undefined */
+function wireTypeOf(value) {
+	if (typeof value === "bigint") return "bigint";
+	if (typeof value === "number") return Number.isFinite(value) ? void 0 : "double";
+	if (typeof value !== "object" || value === null) return void 0;
+	if (isDecimal(value)) return "decimal";
+	if (value instanceof CalendarDateTime) return "timestamp";
+	if (value instanceof CalendarDate) return "date";
+	if (value instanceof Time) return "time";
+	if (value instanceof ZonedDateTime || value instanceof Date) return "timestamptz";
+	if (value instanceof Uint8Array) return "bytes";
+}
+/** 要还原的值写成的文字 */
+function specialText(type, value) {
+	switch (type) {
+		case "decimal": return numericText(value);
+		case "timestamptz": return utcText(value instanceof Date ? value.getTime() : value.toDate().getTime());
+		case "bytes": return encodeBase64(value);
+		default: return String(value);
+	}
+}
+/** 某一时刻的 UTC 写法：总有秒，毫秒去掉末尾的零 */
+function utcText(epochMillis) {
+	return new Date(epochMillis).toISOString().replace(/\.(\d{3})Z$/, (_, ms) => ms === "000" ? "Z" : `.${ms.replace(/0+$/, "")}Z`);
+}
+/**
+* 一个值写成线上的文字：地址栏参数、表头筛选都用它。Decimal 不用科学计数法，日期与时间是 ISO 写法，
+* 带时区的时刻换算成 UTC；null、undefined 是空字符串
+*/
+function wireText(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number") return Object.is(value, -0) ? "0" : String(value);
+	if (typeof value === "boolean" || typeof value === "bigint") return String(value);
+	const type = wireTypeOf(value);
+	if (!type) throw new TypeError(`wireText：${String(value)} 不是单个值`);
+	return specialText(type, value);
+}
+/**
+* 把值写成线上的 JSON：要还原的值写成文字，根对象上加 `$types`；没有这样的值时就是普通 JSON。
+* 对象取自身可枚举的属性（undefined 与函数跳过），有 toJSON 的先调用它；同一路径上既有文字又有 Decimal 这类值时报错
+*/
+function toWire(value) {
+	const found = /* @__PURE__ */ new Map();
+	const json = encode(value, "", found, /* @__PURE__ */ new Set());
+	const types = {};
+	for (const [path, type] of found) if (type !== "text") types[path] = type;
+	if (Object.keys(types).length === 0) return json;
+	if (isRecord(json)) return {
+		...json,
+		[TYPES]: types
+	};
+	const wrapped = {};
+	for (const [path, type] of Object.entries(types)) wrapped[path === "" ? VALUE : `${VALUE}.${path}`] = type;
+	return {
+		[VALUE]: json,
+		[TYPES]: wrapped
+	};
+}
+function encode(value, path, found, seen) {
+	if (value === null || value === void 0) return null;
+	if (typeof value === "string") {
+		note(found, path, "text");
+		return value;
+	}
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number" && Number.isFinite(value)) return Object.is(value, -0) ? 0 : value;
+	if (typeof value === "function" || typeof value === "symbol") return null;
+	const type = wireTypeOf(value);
+	if (type) {
+		note(found, path, type);
+		return specialText(type, value);
+	}
+	const object = value;
+	if (seen.has(object)) throw new TypeError(`toWire：${path || "根对象"}引用了自己`);
+	seen.add(object);
+	try {
+		if (Array.isArray(object) || object instanceof Set) return [...object].map((item) => encode(item, path, found, seen));
+		if (typeof object.toJSON === "function") return encode(object.toJSON(), path, found, seen);
+		const entries = object instanceof Map ? [...object].map(([k, v]) => [String(k), v]) : Object.entries(object);
+		const out = {};
+		for (const [key, item] of entries) {
+			if (item === void 0 || typeof item === "function") continue;
+			out[key] = encode(item, path === "" ? escape(key) : `${path}.${escape(key)}`, found, seen);
+		}
+		return out;
+	} finally {
+		seen.delete(object);
+	}
+}
+/** 记下路径上的值的种类；同一路径出现两种时报错（对方无从还原） */
+function note(found, path, type) {
+	const known = found.get(path);
+	if (known !== void 0 && known !== type) throw new TypeError(`toWire：${path || "根"}上的值既有 ${known} 又有 ${type}，一个路径只能是一种值`);
+	found.set(path, type);
+}
+/**
+* 读线上的 JSON：按根上的 `$types` 还原（见文件开头的默认值），去掉 `$types`，`{ $value, $types }` 拆成里面的值；
+* 没有 `$types` 时原样返回。就地改写传入的对象（通常刚由 JSON.parse 得到）
+*/
+function fromWire(json, options = {}) {
+	if (!isRecord(json) || !Object.hasOwn(json, TYPES)) return json;
+	const types = json[TYPES];
+	if (!isRecord(types)) throw new TypeError("fromWire：$types 要是 路径 → 种类 的对象");
+	delete json[TYPES];
+	for (const [path, type] of Object.entries(types)) {
+		const steps = path.split(".").map(unescape);
+		try {
+			revive(json, steps[0], steps.slice(1), type, options);
+		} catch (error) {
+			throw new TypeError(`fromWire：${path}：${error.message}`, { cause: error });
+		}
+	}
+	const keys = Object.keys(json);
+	return keys.length === 1 && keys[0] === VALUE ? json[VALUE] : json;
+}
+function revive(holder, key, rest, type, options) {
+	const value = holder[key];
+	if (Array.isArray(value)) {
+		for (let i = 0; i < value.length; i++) revive(value, i, rest, type, options);
+		return;
+	}
+	if (rest.length === 0) {
+		if (typeof value === "string") holder[key] = parseText(type, value, options);
+		return;
+	}
+	if (isRecord(value)) revive(value, rest[0], rest.slice(1), type, options);
+}
+/** 按种类读一段文字；留作文字的种类原样返回 */
+function parseText(type, text, options) {
+	const objects = options.dates === "objects";
+	switch (type) {
+		case "bigint":
+			if (!/^[+-]?\d+$/.test(text)) throw new TypeError(`${JSON.stringify(text)} 不是整数`);
+			return BigInt(text);
+		case "decimal": return options.decimal ? new options.decimal(text) : text;
+		case "double": return Number(text);
+		case "bytes": return decodeBase64(text);
+		case "date": return objects ? parseDate(text) : text;
+		case "time": return objects ? parseTime(text) : text;
+		case "timestamp": return objects ? parseDateTime(text.replace(" ", "T")) : text;
+		case "timestamptz": return objects ? parseAbsolute(text, options.timeZone ?? getLocalTimeZone()) : text;
+	}
+}
+var BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** 标准 base64（带补齐的 =），与 Java 的 Base64.getEncoder() 一致 */
+function encodeBase64(bytes) {
+	let out = "";
+	for (let i = 0; i < bytes.length; i += 3) {
+		const [a, b, c] = [
+			bytes[i],
+			bytes[i + 1],
+			bytes[i + 2]
+		];
+		out += BASE64[a >> 2] + BASE64[(a & 3) << 4 | (b ?? 0) >> 4];
+		out += b === void 0 ? "==" : BASE64[(b & 15) << 2 | (c ?? 0) >> 6] + (c === void 0 ? "=" : BASE64[c & 63]);
+	}
+	return out;
+}
+/** 读标准 base64 */
+function decodeBase64(text) {
+	if (text.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(text)) throw new TypeError(`${JSON.stringify(text.slice(0, 40))} 不是 base64`);
+	const pad = text.endsWith("==") ? 2 : text.endsWith("=") ? 1 : 0;
+	const out = new Uint8Array(text.length / 4 * 3 - pad);
+	let at = 0;
+	for (let i = 0; i < text.length; i += 4) {
+		let n = 0;
+		for (let k = 0; k < 4; k++) n = n << 6 | Math.max(0, BASE64.indexOf(text[i + k]));
+		for (const byte of [
+			n >> 16,
+			n >> 8 & 255,
+			n & 255
+		]) if (at < out.length) out[at++] = byte;
+	}
+	return out;
+}
+/** 属性名写进路径：~ → ~0，. → ~1（同 JSON Pointer） */
+var escape = (key) => key.replaceAll("~", "~0").replaceAll(".", "~1");
+/** escape 的反向 */
+var unescape = (step) => step.replaceAll("~1", ".").replaceAll("~0", "~");
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { fromWire, toWire, wireText };
+
+//# sourceMappingURL=wire.js.map

package/dist/utils/request/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","names":[],"sources":["../../../src/utils/request/wire.ts"],"sourcesContent":["/**\n * 线上的 typed JSON（与 query 库的 @zerodep-dev/wire、Java 的 org.dpdns.zerodep.wire 同一套写法）：bigint、Decimal、\n * 日期、时间、字节等 JSON 不能原样承载的值写成文字，根对象上的 `$types` 记下它们的位置（路径 → 种类），对方据此还原。\n * createHttpClient 默认就用它：请求体经 toWire 发出，带 `$types` 的响应经 fromWire 还原，地址栏参数经 wireText 写成文字。\n *\n *   toWire({ id: 9007199254740993n, amount: new Decimal('12.50'), on: new CalendarDate(2024, 1, 31) })\n *   // { id: '9007199254740993', amount: '12.5', on: '2024-01-31', $types: { id: 'bigint', amount: 'decimal', on: 'date' } }\n *\n * 种类与文字：bigint 是十进制整数，decimal 不用科学计数法，double 只有 NaN / ±Infinity 写成文字，date 'YYYY-MM-DD'、\n * time 'HH:mm:ss'、timestamp 'YYYY-MM-DDTHH:mm:ss[.fff]'、timestamptz 换算成 UTC 带 Z，bytes 是标准 base64。\n * 路径从根开始用点连接属性名，数组不占一段（`rows.amount` 是每一行的 amount），属性名里的 ~ 与 . 写成 ~0、~1。\n *\n * 还原的默认值跟组件的约定走：bigint 还原成 bigint；decimal 在给了 Decimal 构造函数时还原成 Decimal，否则留作十进制文字\n * （DataTable 的数字列、NumberField 都认）；日期与时间留作 ISO 文字（组件对外的值就是它），dates: 'objects' 时还原成\n * CalendarDate、Time、CalendarDateTime、ZonedDateTime。这里不在运行时导入 decimal.js（同 numeric.ts）。\n */\nimport {\n  CalendarDate,\n  CalendarDateTime,\n  getLocalTimeZone,\n  parseAbsolute,\n  parseDate,\n  parseDateTime,\n  parseTime,\n  Time,\n  ZonedDateTime,\n} from '@internationalized/date';\nimport type Decimal from 'decimal.js';\nimport { isDecimal, numericText } from '../data/numeric';\n\n/** 线上要还原的值的种类 */\nexport type WireType =\n  'bigint' | 'decimal' | 'double' | 'date' | 'time' | 'timestamp' | 'timestamptz' | 'bytes';\n\n/** 根对象上的类型表：路径 → 种类 */\nexport type WireTypes = Record<string, WireType>;\n\n/** 能写成线上文字的单个值（地址栏参数、表头筛选） */\nexport type WireScalar =\n  | string\n  | number\n  | boolean\n  | bigint\n  | Decimal\n  | CalendarDate\n  | CalendarDateTime\n  | ZonedDateTime\n  | Time\n  | Date\n  | null\n  | undefined;\n\n/** fromWire 怎样还原 */\nexport interface WireReviveOptions {\n  /** 还原 decimal 用的构造函数（decimal.js 的 Decimal 或它 clone 出来的）；不给时 decimal 留作十进制文字 */\n  decimal?: new (text: string) => Decimal;\n  /** 日期与时间：'iso' 留作 ISO 文字（默认），'objects' 还原成 CalendarDate、Time、CalendarDateTime、ZonedDateTime */\n  dates?: 'iso' | 'objects';\n  /** 'objects' 时 timestamptz 还原到哪个时区，默认浏览器的时区 */\n  timeZone?: string;\n}\n\nconst TYPES = '$types';\nconst VALUE = '$value';\n\n/** 值要还原成哪一种；JSON 能原样承载的值为 undefined */\nfunction wireTypeOf(value: unknown): WireType | undefined {\n  if (typeof value === 'bigint') return 'bigint';\n  if (typeof value === 'number') return Number.isFinite(value) ? undefined : 'double';\n  if (typeof value !== 'object' || value === null) return undefined;\n  if (isDecimal(value)) return 'decimal';\n  if (value instanceof CalendarDateTime) return 'timestamp';\n  if (value instanceof CalendarDate) return 'date';\n  if (value instanceof Time) return 'time';\n  if (value instanceof ZonedDateTime || value instanceof Date) return 'timestamptz';\n  if (value instanceof Uint8Array) return 'bytes';\n  return undefined;\n}\n\n/** 要还原的值写成的文字 */\nfunction specialText(type: WireType, value: unknown): string {\n  switch (type) {\n    case 'decimal':\n      return numericText(value as Decimal);\n    case 'timestamptz':\n      return utcText(\n        value instanceof Date ? value.getTime() : (value as ZonedDateTime).toDate().getTime(),\n      );\n    case 'bytes':\n      return encodeBase64(value as Uint8Array);\n    default:\n      return String(value);\n  }\n}\n\n/** 某一时刻的 UTC 写法：总有秒，毫秒去掉末尾的零 */\nfunction utcText(epochMillis: number): string {\n  return new Date(epochMillis)\n    .toISOString()\n    .replace(/\\.(\\d{3})Z$/, (_, ms: string) => (ms === '000' ? 'Z' : `.${ms.replace(/0+$/, '')}Z`));\n}\n\n/**\n * 一个值写成线上的文字：地址栏参数、表头筛选都用它。Decimal 不用科学计数法，日期与时间是 ISO 写法，\n * 带时区的时刻换算成 UTC；null、undefined 是空字符串\n */\nexport function wireText(value: WireScalar): string {\n  if (value === null || value === undefined) return '';\n  if (typeof value === 'string') return value;\n  if (typeof value === 'number') return Object.is(value, -0) ? '0' : String(value);\n  if (typeof value === 'boolean' || typeof value === 'bigint') return String(value);\n  const type = wireTypeOf(value);\n  if (!type) throw new TypeError(`wireText：${String(value)} 不是单个值`);\n  return specialText(type, value);\n}\n\n/**\n * 把值写成线上的 JSON：要还原的值写成文字，根对象上加 `$types`；没有这样的值时就是普通 JSON。\n * 对象取自身可枚举的属性（undefined 与函数跳过），有 toJSON 的先调用它；同一路径上既有文字又有 Decimal 这类值时报错\n */\nexport function toWire(value: unknown): unknown {\n  const found = new Map<string, WireType | 'text'>();\n  const json = encode(value, '', found, new Set());\n  const types: WireTypes = {};\n  for (const [path, type] of found) if (type !== 'text') types[path] = type;\n  if (Object.keys(types).length === 0) return json;\n  if (isRecord(json)) return { ...json, [TYPES]: types };\n  const wrapped: WireTypes = {};\n  for (const [path, type] of Object.entries(types))\n    wrapped[path === '' ? VALUE : `${VALUE}.${path}`] = type;\n  return { [VALUE]: json, [TYPES]: wrapped };\n}\n\nfunction encode(\n  value: unknown,\n  path: string,\n  found: Map<string, WireType | 'text'>,\n  seen: Set<object>,\n): unknown {\n  if (value === null || value === undefined) return null;\n  if (typeof value === 'string') {\n    note(found, path, 'text');\n    return value;\n  }\n  if (typeof value === 'boolean') return value;\n  if (typeof value === 'number' && Number.isFinite(value)) return Object.is(value, -0) ? 0 : value;\n  if (typeof value === 'function' || typeof value === 'symbol') return null;\n  const type = wireTypeOf(value);\n  if (type) {\n    note(found, path, type);\n    return specialText(type, value);\n  }\n  const object = value as object;\n  if (seen.has(object)) throw new TypeError(`toWire：${path || '根对象'}引用了自己`);\n  seen.add(object);\n  try {\n    if (Array.isArray(object) || object instanceof Set)\n      return [...object].map((item: unknown) => encode(item, path, found, seen));\n    if (typeof (object as { toJSON?: unknown }).toJSON === 'function')\n      return encode((object as { toJSON(): unknown }).toJSON(), path, found, seen);\n    const entries =\n      object instanceof Map\n        ? [...(object as Map<unknown, unknown>)].map(([k, v]) => [String(k), v] as const)\n        : Object.entries(object);\n    const out: Record<string, unknown> = {};\n    for (const [key, item] of entries) {\n      if (item === undefined || typeof item === 'function') continue;\n      out[key] = encode(item, path === '' ? escape(key) : `${path}.${escape(key)}`, found, seen);\n    }\n    return out;\n  } finally {\n    seen.delete(object);\n  }\n}\n\n/** 记下路径上的值的种类；同一路径出现两种时报错（对方无从还原） */\nfunction note(found: Map<string, WireType | 'text'>, path: string, type: WireType | 'text') {\n  const known = found.get(path);\n  if (known !== undefined && known !== type)\n    throw new TypeError(\n      `toWire：${path || '根'}上的值既有 ${known} 又有 ${type}，一个路径只能是一种值`,\n    );\n  found.set(path, type);\n}\n\n/**\n * 读线上的 JSON：按根上的 `$types` 还原（见文件开头的默认值），去掉 `$types`，`{ $value, $types }` 拆成里面的值；\n * 没有 `$types` 时原样返回。就地改写传入的对象（通常刚由 JSON.parse 得到）\n */\nexport function fromWire<T = unknown>(json: unknown, options: WireReviveOptions = {}): T {\n  if (!isRecord(json) || !Object.hasOwn(json, TYPES)) return json as T;\n  const types = json[TYPES];\n  if (!isRecord(types)) throw new TypeError('fromWire：$types 要是 路径 → 种类 的对象');\n  delete json[TYPES];\n  for (const [path, type] of Object.entries(types)) {\n    const steps = path.split('.').map(unescape);\n    try {\n      revive(json, steps[0]!, steps.slice(1), type as WireType, options);\n    } catch (error) {\n      throw new TypeError(`fromWire：${path}：${(error as Error).message}`, { cause: error });\n    }\n  }\n  const keys = Object.keys(json);\n  return (keys.length === 1 && keys[0] === VALUE ? json[VALUE] : json) as T;\n}\n\nfunction revive(\n  holder: Record<string | number, unknown>,\n  key: string | number,\n  rest: readonly string[],\n  type: WireType,\n  options: WireReviveOptions,\n) {\n  const value = holder[key];\n  if (Array.isArray(value)) {\n    for (let i = 0; i < value.length; i++)\n      revive(value as unknown as Record<number, unknown>, i, rest, type, options);\n    return;\n  }\n  if (rest.length === 0) {\n    if (typeof value === 'string') holder[key] = parseText(type, value, options);\n    return;\n  }\n  if (isRecord(value)) revive(value, rest[0]!, rest.slice(1), type, options);\n}\n\n/** 按种类读一段文字；留作文字的种类原样返回 */\nfunction parseText(type: WireType, text: string, options: WireReviveOptions): unknown {\n  const objects = options.dates === 'objects';\n  switch (type) {\n    case 'bigint':\n      if (!/^[+-]?\\d+$/.test(text)) throw new TypeError(`${JSON.stringify(text)} 不是整数`);\n      return BigInt(text);\n    case 'decimal':\n      return options.decimal ? new options.decimal(text) : text;\n    case 'double':\n      return Number(text);\n    case 'bytes':\n      return decodeBase64(text);\n    case 'date':\n      return objects ? parseDate(text) : text;\n    case 'time':\n      return objects ? parseTime(text) : text;\n    case 'timestamp':\n      return objects ? parseDateTime(text.replace(' ', 'T')) : text;\n    case 'timestamptz':\n      return objects ? parseAbsolute(text, options.timeZone ?? getLocalTimeZone()) : text;\n  }\n}\n\nconst BASE64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\n/** 标准 base64（带补齐的 =），与 Java 的 Base64.getEncoder() 一致 */\nfunction encodeBase64(bytes: Uint8Array): string {\n  let out = '';\n  for (let i = 0; i < bytes.length; i += 3) {\n    const [a, b, c] = [bytes[i]!, bytes[i + 1], bytes[i + 2]];\n    out += BASE64[a >> 2]! + BASE64[((a & 3) << 4) | ((b ?? 0) >> 4)]!;\n    out +=\n      b === undefined\n        ? '=='\n        : BASE64[((b & 15) << 2) | ((c ?? 0) >> 6)]! + (c === undefined ? '=' : BASE64[c & 63]!);\n  }\n  return out;\n}\n\n/** 读标准 base64 */\nfunction decodeBase64(text: string): Uint8Array {\n  if (text.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(text))\n    throw new TypeError(`${JSON.stringify(text.slice(0, 40))} 不是 base64`);\n  const pad = text.endsWith('==') ? 2 : text.endsWith('=') ? 1 : 0;\n  const out = new Uint8Array((text.length / 4) * 3 - pad);\n  let at = 0;\n  for (let i = 0; i < text.length; i += 4) {\n    let n = 0;\n    for (let k = 0; k < 4; k++) n = (n << 6) | Math.max(0, BASE64.indexOf(text[i + k]!));\n    for (const byte of [n >> 16, (n >> 8) & 255, n & 255]) if (at < out.length) out[at++] = byte;\n  }\n  return out;\n}\n\n/** 属性名写进路径：~ → ~0，. → ~1（同 JSON Pointer） */\nconst escape = (key: string) => key.replaceAll('~', '~0').replaceAll('.', '~1');\n\n/** escape 的反向 */\nconst unescape = (step: string) => step.replaceAll('~1', '.').replaceAll('~0', '~');\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":"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"}

package/dist/utils/style/attached.d.ts

@@ -0,0 +1,25 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+/** 相连的方向 */
+export interface AttachedOrientations {
+    /** 横排（默认）：去掉左右相邻一侧的圆角 */
+    horizontal: unknown;
+    /** 竖排：去掉上下相邻一侧的圆角 */
+    vertical: unknown;
+}
+/** 组交给里面的控件的状态 */
+export interface AttachedState {
+    /** 排列方向：决定去掉哪一侧的圆角 */
+    readonly orientation: keyof AttachedOrientations;
+}
+/** 相连的一组的上下文：按钮家族与输入框外壳据此相连 */
+export declare const AttachedContext: import("@zerodep-dev/vue-tsx-pro-tsx").Context<AttachedState>;
+/**
+ * 组里相连的控件：去掉相邻一侧的圆角，边框叠在一起（不显得加粗）；
+ * 悬停、聚焦的那个浮到上面，边框与焦点环不被邻居盖住。
+ * 只在“不是第一个 / 最后一个”时设值：两端不写，控件自己的圆角（radiusStyles）照常生效
+ * （写成 default: 0 再在首尾设 null 时，null 只是不生成规则，0 仍然生效）
+ */
+export declare const attachedStyles: Readonly<{
+    horizontal: css.CompiledStyles;
+    vertical: css.CompiledStyles;
+}>;

package/dist/utils/style/attached.js

@@ -0,0 +1,82 @@
+import { t } from "../../config/theme/tokens.js";
+import { createContext } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/utils/style/attached.ts
+/**
+* 相连的一组控件：几个按钮（ButtonGroup）或输入框与按钮（ControlGroup，如“币种 + 金额 + 查询”）连成一条，
+* 相邻一侧不要圆角、边框叠在一起。组经 AttachedContext 告诉里面的控件排列方向，控件把 attachedStyles 加到自己的外壳上。
+* 外壳要是组的直接子元素。判断首尾时跳过不占位的兄弟（选择框的弹出面板、表单的隐藏 input），
+* 用 :nth-child(1 of …)（各浏览器 2023 年起支持）。
+*/
+/** 相连的一组的上下文：按钮家族与输入框外壳据此相连 */
+var AttachedContext = createContext("Attached");
+/**
+* 组里相连的控件：去掉相邻一侧的圆角，边框叠在一起（不显得加粗）；
+* 悬停、聚焦的那个浮到上面，边框与焦点环不被邻居盖住。
+* 只在“不是第一个 / 最后一个”时设值：两端不写，控件自己的圆角（radiusStyles）照常生效
+* （写成 default: 0 再在首尾设 null 时，null 只是不生成规则，0 仍然生效）
+*/
+var attachedStyles = css.create({
+	horizontal: {
+		position: "relative",
+		zIndex: {
+			default: null,
+			":hover": 1,
+			":focus-visible": 2,
+			":focus-within": 2
+		},
+		marginInlineStart: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": `calc(-1 * ${t.borderWidths.xs})`
+		},
+		borderStartStartRadius: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderEndStartRadius: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderStartEndRadius: {
+			default: null,
+			":not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderEndEndRadius: {
+			default: null,
+			":not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		}
+	},
+	vertical: {
+		position: "relative",
+		zIndex: {
+			default: null,
+			":hover": 1,
+			":focus-visible": 2,
+			":focus-within": 2
+		},
+		marginBlockStart: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": `calc(-1 * ${t.borderWidths.xs})`
+		},
+		borderStartStartRadius: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderStartEndRadius: {
+			default: null,
+			":not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderEndStartRadius: {
+			default: null,
+			":not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		},
+		borderEndEndRadius: {
+			default: null,
+			":not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))": 0
+		}
+	}
+});
+//#endregion
+export { AttachedContext, attachedStyles };
+
+//# sourceMappingURL=attached.js.map

package/dist/utils/style/attached.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attached.js","names":[],"sources":["../../../src/utils/style/attached.ts"],"sourcesContent":["/**\n * 相连的一组控件：几个按钮（ButtonGroup）或输入框与按钮（ControlGroup，如“币种 + 金额 + 查询”）连成一条，\n * 相邻一侧不要圆角、边框叠在一起。组经 AttachedContext 告诉里面的控件排列方向，控件把 attachedStyles 加到自己的外壳上。\n * 外壳要是组的直接子元素。判断首尾时跳过不占位的兄弟（选择框的弹出面板、表单的隐藏 input），\n * 用 :nth-child(1 of …)（各浏览器 2023 年起支持）。\n */\nimport { createContext } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { t } from '../../config/theme/tokens';\n\n/** 相连的方向 */\nexport interface AttachedOrientations {\n  /** 横排（默认）：去掉左右相邻一侧的圆角 */\n  horizontal: unknown;\n  /** 竖排：去掉上下相邻一侧的圆角 */\n  vertical: unknown;\n}\n\n/** 组交给里面的控件的状态 */\nexport interface AttachedState {\n  /** 排列方向：决定去掉哪一侧的圆角 */\n  readonly orientation: keyof AttachedOrientations;\n}\n\n/** 相连的一组的上下文：按钮家族与输入框外壳据此相连 */\nexport const AttachedContext = createContext<AttachedState>('Attached');\n\n/**\n * 组里相连的控件：去掉相邻一侧的圆角，边框叠在一起（不显得加粗）；\n * 悬停、聚焦的那个浮到上面，边框与焦点环不被邻居盖住。\n * 只在“不是第一个 / 最后一个”时设值：两端不写，控件自己的圆角（radiusStyles）照常生效\n * （写成 default: 0 再在首尾设 null 时，null 只是不生成规则，0 仍然生效）\n */\nexport const attachedStyles = css.create({\n  horizontal: {\n    position: 'relative',\n    zIndex: { default: null, ':hover': 1, ':focus-visible': 2, ':focus-within': 2 },\n    marginInlineStart: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': `calc(-1 * ${t.borderWidths.xs})`,\n    },\n    borderStartStartRadius: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderEndStartRadius: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderStartEndRadius: {\n      default: null,\n      ':not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderEndEndRadius: {\n      default: null,\n      ':not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n  },\n  vertical: {\n    position: 'relative',\n    zIndex: { default: null, ':hover': 1, ':focus-visible': 2, ':focus-within': 2 },\n    marginBlockStart: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': `calc(-1 * ${t.borderWidths.xs})`,\n    },\n    borderStartStartRadius: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderStartEndRadius: {\n      default: null,\n      ':not(:nth-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderEndStartRadius: {\n      default: null,\n      ':not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n    borderEndEndRadius: {\n      default: null,\n      ':not(:nth-last-child(1 of :not([popover], [hidden], input[type=\"hidden\"], template)))': 0,\n    },\n  },\n});\n"],"mappings":";;;;;;;;;;;AAyBA,IAAa,kBAAkB,cAA6B,UAAU;;;;;;;AAQtE,IAAa,iBAAiB,IAAI,OAAO;CACvC,YAAY;EACV,UAAU;EACV,QAAQ;GAAE,SAAS;GAAM,UAAU;GAAG,kBAAkB;GAAG,iBAAiB;EAAE;EAC9E,mBAAmB;GACjB,SAAS;GACT,sFAAoF,aAAa,EAAE,aAAa,GAAE;EACpH;EACA,wBAAwB;GACtB,SAAS;GACT,sFAAoF;EACtF;EACA,sBAAsB;GACpB,SAAS;GACT,sFAAoF;EACtF;EACA,sBAAsB;GACpB,SAAS;GACT,2FAAyF;EAC3F;EACA,oBAAoB;GAClB,SAAS;GACT,2FAAyF;EAC3F;CACF;CACA,UAAU;EACR,UAAU;EACV,QAAQ;GAAE,SAAS;GAAM,UAAU;GAAG,kBAAkB;GAAG,iBAAiB;EAAE;EAC9E,kBAAkB;GAChB,SAAS;GACT,sFAAoF,aAAa,EAAE,aAAa,GAAE;EACpH;EACA,wBAAwB;GACtB,SAAS;GACT,sFAAoF;EACtF;EACA,sBAAsB;GACpB,SAAS;GACT,sFAAoF;EACtF;EACA,sBAAsB;GACpB,SAAS;GACT,2FAAyF;EAC3F;EACA,oBAAoB;GAClB,SAAS;GACT,2FAAyF;EAC3F;CACF;AACF,CAAC"}

package/dist/utils/style/item-styles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 列表行的外观：菜单项、下拉选项、侧边导航项、表格行共用的悬停、高亮、选中、当前、危险、不可用。
+ * 各组件只在这些之上补自己的差别（导航项的字重与内边距、菜单项的焦点环），状态的颜色只在这里定义。
+ *
+ *   sx: [itemStyles.row, itemStyles.hoverable, active && itemStyles.highlighted, disabled && itemStyles.disabled]
+ */
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+/** 列表行的布局与各状态的颜色 */
+export declare const itemStyles: Readonly<{
+    current: css.CompiledStyles;
+    danger: css.CompiledStyles;
+    disabled: css.CompiledStyles;
+    highlighted: css.CompiledStyles;
+    hoverable: css.CompiledStyles;
+    label: css.CompiledStyles;
+    row: css.CompiledStyles;
+    selected: css.CompiledStyles;
+}>;

package/dist/utils/style/item-styles.js

@@ -0,0 +1,79 @@
+import { t } from "../../config/theme/tokens.js";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/utils/style/item-styles.ts
+/**
+* 列表行的外观：菜单项、下拉选项、侧边导航项、表格行共用的悬停、高亮、选中、当前、危险、不可用。
+* 各组件只在这些之上补自己的差别（导航项的字重与内边距、菜单项的焦点环），状态的颜色只在这里定义。
+*
+*   sx: [itemStyles.row, itemStyles.hoverable, active && itemStyles.highlighted, disabled && itemStyles.disabled]
+*/
+/** 列表行的布局与各状态的颜色 */
+var itemStyles = css.create({
+	/** 一行：图标、文字、尾部内容横排；按钮、链接、div 都能用（去掉了按钮与链接的默认外观） */
+	row: {
+		boxSizing: "border-box",
+		display: "flex",
+		alignItems: "center",
+		gap: "_sm",
+		width: "_full",
+		minHeight: `max(${t.sizes.control}, ${t.sizes.minTarget})`,
+		margin: 0,
+		paddingBlock: "_xs",
+		paddingInline: "_sm",
+		borderWidth: 0,
+		borderRadius: "_sm",
+		backgroundColor: "transparent",
+		color: "_text",
+		fontFamily: "inherit",
+		fontSize: "inherit",
+		lineHeight: "_normal",
+		textAlign: "start",
+		textDecoration: "none",
+		cursor: "pointer",
+		userSelect: "none",
+		transition: `background-color ${t.durations.sm} ${t.easings.standard}, color ${t.durations.sm} ${t.easings.standard}`
+	},
+	/** 指针悬停时浅色底 */
+	hoverable: { backgroundColor: {
+		default: "transparent",
+		":hover": "_fillHover"
+	} },
+	/** 键盘高亮（aria-activedescendant 指着的选项）：与悬停同色 */
+	highlighted: { backgroundColor: "_fillHover" },
+	/** 已选（下拉选项）：品牌色文字 */
+	selected: { color: "_accentText" },
+	/** 当前（导航的当前页、表格的选中行）：品牌色浅底 */
+	current: {
+		backgroundColor: {
+			default: "_accentSoft",
+			":hover": "_accentSoftHover"
+		},
+		color: "_accentText"
+	},
+	/** 危险操作（删除）：红色文字，悬停浅红底 */
+	danger: {
+		color: "_dangerText",
+		backgroundColor: {
+			default: "transparent",
+			":hover": "_dangerSoft"
+		}
+	},
+	/** 不可用：不响应悬停（盖掉 hoverable、danger 的 :hover 底色；放在它们后面） */
+	disabled: {
+		opacity: "_disabled",
+		cursor: "not-allowed",
+		backgroundColor: "transparent"
+	},
+	/** 文字部分：占满剩余宽度，一行放不下时省略 */
+	label: {
+		flexGrow: 1,
+		minWidth: 0,
+		overflow: "hidden",
+		textOverflow: "ellipsis",
+		whiteSpace: "nowrap"
+	}
+});
+//#endregion
+export { itemStyles };
+
+//# sourceMappingURL=item-styles.js.map

package/dist/utils/style/item-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-styles.js","names":[],"sources":["../../../src/utils/style/item-styles.ts"],"sourcesContent":["/**\n * 列表行的外观：菜单项、下拉选项、侧边导航项、表格行共用的悬停、高亮、选中、当前、危险、不可用。\n * 各组件只在这些之上补自己的差别（导航项的字重与内边距、菜单项的焦点环），状态的颜色只在这里定义。\n *\n *   sx: [itemStyles.row, itemStyles.hoverable, active && itemStyles.highlighted, disabled && itemStyles.disabled]\n */\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { t } from '../../config/theme/tokens';\n\n/** 列表行的布局与各状态的颜色 */\nexport const itemStyles = css.create({\n  /** 一行：图标、文字、尾部内容横排；按钮、链接、div 都能用（去掉了按钮与链接的默认外观） */\n  row: {\n    boxSizing: 'border-box',\n    display: 'flex',\n    alignItems: 'center',\n    gap: '_sm',\n    width: '_full',\n    minHeight: `max(${t.sizes.control}, ${t.sizes.minTarget})`,\n    margin: 0,\n    paddingBlock: '_xs',\n    paddingInline: '_sm',\n    borderWidth: 0,\n    borderRadius: '_sm',\n    backgroundColor: 'transparent',\n    color: '_text',\n    fontFamily: 'inherit',\n    fontSize: 'inherit',\n    lineHeight: '_normal',\n    textAlign: 'start',\n    textDecoration: 'none',\n    cursor: 'pointer',\n    userSelect: 'none',\n    transition: `background-color ${t.durations.sm} ${t.easings.standard}, color ${t.durations.sm} ${t.easings.standard}`,\n  },\n  /** 指针悬停时浅色底 */\n  hoverable: { backgroundColor: { default: 'transparent', ':hover': '_fillHover' } },\n  /** 键盘高亮（aria-activedescendant 指着的选项）：与悬停同色 */\n  highlighted: { backgroundColor: '_fillHover' },\n  /** 已选（下拉选项）：品牌色文字 */\n  selected: { color: '_accentText' },\n  /** 当前（导航的当前页、表格的选中行）：品牌色浅底 */\n  current: {\n    backgroundColor: { default: '_accentSoft', ':hover': '_accentSoftHover' },\n    color: '_accentText',\n  },\n  /** 危险操作（删除）：红色文字，悬停浅红底 */\n  danger: {\n    color: '_dangerText',\n    backgroundColor: { default: 'transparent', ':hover': '_dangerSoft' },\n  },\n  /** 不可用：不响应悬停（盖掉 hoverable、danger 的 :hover 底色；放在它们后面） */\n  disabled: { opacity: '_disabled', cursor: 'not-allowed', backgroundColor: 'transparent' },\n  /** 文字部分：占满剩余宽度，一行放不下时省略 */\n  label: {\n    flexGrow: 1,\n    minWidth: 0,\n    overflow: 'hidden',\n    textOverflow: 'ellipsis',\n    whiteSpace: 'nowrap',\n  },\n});\n"],"mappings":";;;;;;;;;;AAUA,IAAa,aAAa,IAAI,OAAO;;CAEnC,KAAK;EACH,WAAW;EACX,SAAS;EACT,YAAY;EACZ,KAAK;EACL,OAAO;EACP,WAAW,OAAO,EAAE,MAAM,QAAO,IAAK,EAAE,MAAM,UAAS;EACvD,QAAQ;EACR,cAAc;EACd,eAAe;EACf,aAAa;EACb,cAAc;EACd,iBAAiB;EACjB,OAAO;EACP,YAAY;EACZ,UAAU;EACV,YAAY;EACZ,WAAW;EACX,gBAAgB;EAChB,QAAQ;EACR,YAAY;EACZ,YAAY,oBAAoB,EAAE,UAAU,GAAE,GAAI,EAAE,QAAQ,SAAQ,UAAW,EAAE,UAAU,GAAE,GAAI,EAAE,QAAQ;CAC7G;;CAEA,WAAW,EAAE,iBAAiB;EAAE,SAAS;EAAe,UAAU;CAAa,EAAE;;CAEjF,aAAa,EAAE,iBAAiB,aAAa;;CAE7C,UAAU,EAAE,OAAO,cAAc;;CAEjC,SAAS;EACP,iBAAiB;GAAE,SAAS;GAAe,UAAU;EAAmB;EACxE,OAAO;CACT;;CAEA,QAAQ;EACN,OAAO;EACP,iBAAiB;GAAE,SAAS;GAAe,UAAU;EAAc;CACrE;;CAEA,UAAU;EAAE,SAAS;EAAa,QAAQ;EAAe,iBAAiB;CAAc;;CAExF,OAAO;EACL,UAAU;EACV,UAAU;EACV,UAAU;EACV,cAAc;EACd,YAAY;CACd;AACF,CAAC"}

package/dist/utils/style/markers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 标记（defineMarker）：挂到祖先上，子元素按它的状态取样式，如 `css.when.ancestor(':hover', headingMarker)`。
+ */
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+/** 标题：悬停或内部聚焦时显示锚点链接 */
+export declare const headingMarker: css.Marker;

package/dist/utils/style/markers.js

@@ -0,0 +1,11 @@
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/utils/style/markers.ts
+/**
+* 标记（defineMarker）：挂到祖先上，子元素按它的状态取样式，如 `css.when.ancestor(':hover', headingMarker)`。
+*/
+/** 标题：悬停或内部聚焦时显示锚点链接 */
+var headingMarker = css.defineMarker("vtp-heading");
+//#endregion
+export { headingMarker };
+
+//# sourceMappingURL=markers.js.map

package/dist/utils/style/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","names":[],"sources":["../../../src/utils/style/markers.ts"],"sourcesContent":["/**\n * 标记（defineMarker）：挂到祖先上，子元素按它的状态取样式，如 `css.when.ancestor(':hover', headingMarker)`。\n */\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\n\n/** 标题：悬停或内部聚焦时显示锚点链接 */\nexport const headingMarker = css.defineMarker('vtp-heading');\n"],"mappings":";;;;;;AAMA,IAAa,gBAAgB,IAAI,aAAa,aAAa"}

package/dist/utils/style/shimmer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 骨架的扫光（同 Ant Design Skeleton 的 active、MUI Skeleton 的 wave）：一道光带从起始边扫到结束边，表示内容正在来。
+ * 光带画在元素的 ::after 上，用 transform 平移（同 MUI）：合成器就能跑，不必每帧重绘元素；
+ * 原来移动背景位置时，满屏骨架每帧都要重绘。元素因此 contain: paint。光带颜色见 shimmerVars.highlight。
+ *
+ *   sx: [shimmerStyles.wave, { backgroundColor: … }]
+ *   sx: [shimmerStyles.wave, shimmerStyles.delay(`${index * SHIMMER_STAGGER}ms`)]   多行依次扫过，像一道波
+ *   sx: loaded && shimmerStyles.reveal                                                 骨架换成内容时淡入
+ *
+ * 扫光只是装饰：减少动态效果时不扫（静止的占位已经说明在加载）；从右到左的语言里反向扫。
+ */
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+/** 多行骨架相邻两行的扫光间隔（毫秒）：一屏七八行时整道波约一秒扫完 */
+export declare const SHIMMER_STAGGER = 120;
+/** 骨架扫光：wave、delay、reveal */
+export declare const shimmerStyles: Readonly<{
+    readonly wave: css.CompiledStyles;
+    readonly delay: (delay: string) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly reveal: css.CompiledStyles;
+}>;

package/dist/utils/style/shimmer.js

@@ -0,0 +1,58 @@
+import { shimmerVars } from "./vars.js";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/utils/style/shimmer.ts
+/**
+* 骨架的扫光（同 Ant Design Skeleton 的 active、MUI Skeleton 的 wave）：一道光带从起始边扫到结束边，表示内容正在来。
+* 光带画在元素的 ::after 上，用 transform 平移（同 MUI）：合成器就能跑，不必每帧重绘元素；
+* 原来移动背景位置时，满屏骨架每帧都要重绘。元素因此 contain: paint。光带颜色见 shimmerVars.highlight。
+*
+*   sx: [shimmerStyles.wave, { backgroundColor: … }]
+*   sx: [shimmerStyles.wave, shimmerStyles.delay(`${index * SHIMMER_STAGGER}ms`)]   多行依次扫过，像一道波
+*   sx: loaded && shimmerStyles.reveal                                                 骨架换成内容时淡入
+*
+* 扫光只是装饰：减少动态效果时不扫（静止的占位已经说明在加载）；从右到左的语言里反向扫。
+*/
+/** 多行骨架相邻两行的扫光间隔（毫秒）：一屏七八行时整道波约一秒扫完 */
+var SHIMMER_STAGGER = 120;
+var sweep = css.keyframes({
+	"0%": { transform: "translateX(-100%)" },
+	"70%": { transform: "translateX(100%)" },
+	"100%": { transform: "translateX(100%)" }
+});
+var fadeIn = css.keyframes({ from: { opacity: 0 } });
+/** 骨架扫光：wave、delay、reveal */
+var shimmerStyles = css.create({
+	wave: {
+		position: "relative",
+		contain: "paint",
+		transform: {
+			default: null,
+			":dir(rtl)": "scaleX(-1)"
+		},
+		"::after": {
+			content: "\"\"",
+			position: "absolute",
+			inset: 0,
+			backgroundImage: `linear-gradient(90deg, transparent 15%, ${shimmerVars.highlight} 50%, transparent 85%)`,
+			transform: "translateX(-100%)",
+			animationName: {
+				default: sweep,
+				_reducedMotion: "none"
+			},
+			animationDuration: "2s",
+			animationTimingFunction: "ease-in-out",
+			animationIterationCount: "infinite",
+			animationDelay: "inherit"
+		}
+	},
+	delay: (delay) => ({ animationDelay: delay }),
+	reveal: {
+		animationName: fadeIn,
+		animationDuration: "_durations.lg",
+		animationTimingFunction: "_easings.enter"
+	}
+});
+//#endregion
+export { SHIMMER_STAGGER, shimmerStyles };
+
+//# sourceMappingURL=shimmer.js.map

package/dist/utils/style/shimmer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shimmer.js","names":[],"sources":["../../../src/utils/style/shimmer.ts"],"sourcesContent":["/**\n * 骨架的扫光（同 Ant Design Skeleton 的 active、MUI Skeleton 的 wave）：一道光带从起始边扫到结束边，表示内容正在来。\n * 光带画在元素的 ::after 上，用 transform 平移（同 MUI）：合成器就能跑，不必每帧重绘元素；\n * 原来移动背景位置时，满屏骨架每帧都要重绘。元素因此 contain: paint。光带颜色见 shimmerVars.highlight。\n *\n *   sx: [shimmerStyles.wave, { backgroundColor: … }]\n *   sx: [shimmerStyles.wave, shimmerStyles.delay(`${index * SHIMMER_STAGGER}ms`)]   多行依次扫过，像一道波\n *   sx: loaded && shimmerStyles.reveal                                                 骨架换成内容时淡入\n *\n * 扫光只是装饰：减少动态效果时不扫（静止的占位已经说明在加载）；从右到左的语言里反向扫。\n */\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { shimmerVars } from './vars';\n\n/** 多行骨架相邻两行的扫光间隔（毫秒）：一屏七八行时整道波约一秒扫完 */\nexport const SHIMMER_STAGGER = 120;\n\n// 光带与元素一样宽：从元素外的起始侧（-100%）扫到结束侧（100%）；后 30% 的时间停在外面，两次之间有个间隔\nconst sweep = css.keyframes({\n  '0%': { transform: 'translateX(-100%)' },\n  '70%': { transform: 'translateX(100%)' },\n  '100%': { transform: 'translateX(100%)' },\n});\n\nconst fadeIn = css.keyframes({ from: { opacity: 0 } });\n\n/** 骨架扫光：wave、delay、reveal */\nexport const shimmerStyles = css.create({\n  wave: {\n    position: 'relative',\n    // 用绘制包含裁掉移出去的光带（按圆角裁）：不用 overflow，行内的骨架仍按文字基线对齐\n    // （overflow 不是 visible 时 inline-block 的基线落到底边，WebKit 里 clip 也是）\n    contain: 'paint',\n    // 从右到左的语言里整个元素镜像，光带就反向扫；骨架包着的内容本来就看不见，镜像没有影响\n    transform: { default: null, ':dir(rtl)': 'scaleX(-1)' },\n    '::after': {\n      content: '\"\"',\n      position: 'absolute',\n      inset: 0,\n      backgroundImage: `linear-gradient(90deg, transparent 15%, ${shimmerVars.highlight} 50%, transparent 85%)`,\n      transform: 'translateX(-100%)',\n      animationName: { default: sweep, _reducedMotion: 'none' },\n      // 循环的装饰动画不取 durations（那是一次性过渡的时长，减少动态效果时为 0）：\n      // 2 秒一轮，其中 1.4 秒扫过、0.6 秒停顿，接近 Ant Design、MUI 的节奏，不催促也不显得卡住\n      animationDuration: '2s',\n      // 先慢后快再慢：光带像被推过去，而不是匀速平移\n      animationTimingFunction: 'ease-in-out',\n      animationIterationCount: 'infinite',\n      // 延迟写在元素上（delay），这里继承\n      animationDelay: 'inherit',\n    },\n  },\n  // 每一轮都保持同样的间隔：几行骨架的光带始终一前一后\n  delay: (delay: string) => ({ animationDelay: delay }),\n  // 骨架换成内容（或内容换成骨架）时淡入，不硬切；减少动态效果时 durations 为 0\n  reveal: {\n    animationName: fadeIn,\n    animationDuration: '_durations.lg',\n    animationTimingFunction: '_easings.enter',\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;AAeA,IAAa,kBAAkB;AAG/B,IAAM,QAAQ,IAAI,UAAU;CAC1B,MAAM,EAAE,WAAW,oBAAoB;CACvC,OAAO,EAAE,WAAW,mBAAmB;CACvC,QAAQ,EAAE,WAAW,mBAAmB;AAC1C,CAAC;AAED,IAAM,SAAS,IAAI,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;;AAGrD,IAAa,gBAAgB,IAAI,OAAO;CACtC,MAAM;EACJ,UAAU;EAGV,SAAS;EAET,WAAW;GAAE,SAAS;GAAM,aAAa;EAAa;EACtD,WAAW;GACT,SAAS;GACT,UAAU;GACV,OAAO;GACP,iBAAiB,2CAA2C,YAAY,UAAS;GACjF,WAAW;GACX,eAAe;IAAE,SAAS;IAAO,gBAAgB;GAAO;GAGxD,mBAAmB;GAEnB,yBAAyB;GACzB,yBAAyB;GAEzB,gBAAgB;EAClB;CACF;CAEA,QAAQ,WAAmB,EAAE,gBAAgB,MAAM;CAEnD,QAAQ;EACN,eAAe;EACf,mBAAmB;EACnB,yBAAyB;CAC3B;AACF,CAAC"}