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

package/dist/utils/request/use-request.d.ts

@@ -0,0 +1,37 @@
+/** useRequest 的选项 */
+export interface RequestOptions<P, T> {
+    /** 请求参数：读到的响应式值变了、且内容确实不同时重新请求；不写时只在开始与 refresh 时请求 */
+    params?: () => P;
+    /** 参数变了以后等多久再请求（毫秒），默认 0；refresh 不等 */
+    debounce?: number;
+    /** 一开始就请求，默认 true；false 时等调用 refresh（或参数变化） */
+    immediate?: boolean;
+    /** 重新请求时保留上一次的数据，默认 true；false 时请求一开始就清空 */
+    keepPrevious?: boolean;
+    /**
+     * 自动请求的开关（弹层打开时才请求这类）：为 false 时 immediate 与参数变化都不请求，refresh 照常。
+     * 变回 true 时不自动补一次，需要时调用 refresh
+     */
+    enabled?: () => boolean;
+    /** 成功后调用 */
+    onSuccess?: (data: T, params: P) => void;
+    /** 失败后调用（取消的不算） */
+    onError?: (error: unknown, params: P) => void;
+}
+/** useRequest 的返回值 */
+export interface RequestState<T> {
+    /** 最后一次成功的结果 */
+    readonly data: T | undefined;
+    /** 最后一次失败的原因；成功后清空 */
+    readonly error: unknown;
+    /** 正在请求（防抖等待时还不算） */
+    readonly loading: boolean;
+    /** 按当前参数立即请求，取消进行中的；返回结果，失败或被后来的请求顶掉时为 undefined */
+    refresh(): Promise<T | undefined>;
+    /** 取消进行中的请求与等着的防抖 */
+    cancel(): void;
+    /** 直接改数据（乐观更新、本地删掉一行），不发请求 */
+    mutate(data: T | undefined): void;
+}
+/** 请求的状态（在 setup 里调用；见文件开头） */
+export declare function useRequest<T, P = undefined>(fetcher: (params: P, signal: AbortSignal) => Promise<T>, options?: RequestOptions<P, T>): RequestState<T>;

package/dist/utils/request/use-request.js

@@ -0,0 +1,90 @@
+import { sameValue } from "../data/equality.js";
+import { isAbortError } from "./http.js";
+import { onScopeDispose, shallowRef, watch } from "vue";
+//#region src/utils/request/use-request.ts
+/**
+* 一个请求的状态（参考 TanStack Query、alova 的 useWatcher）：只采用最后一次的结果，发新请求时取消上一次，
+* 参数变化防抖，重新请求时保留旧数据（表格不闪成空的）。
+*
+*   const http = useHttp();
+*   const users = useRequest(
+*     ({ keyword, page }, signal) => http.request<Page<User>>({ url: '/users', query: { keyword, page }, signal }),
+*     { params: () => ({ keyword, page }), debounce: 300 },
+*   );
+*   users.data?.rows; users.loading; users.error; users.refresh();
+*
+* 只在浏览器里自动请求：服务端渲染时 data 留空，等页面在浏览器里接管后再请求。
+*/
+/** 请求的状态（在 setup 里调用；见文件开头） */
+function useRequest(fetcher, options = {}) {
+	const { params, debounce = 0, immediate = true, keepPrevious = true } = options;
+	const data = shallowRef();
+	const error = shallowRef();
+	const loading = shallowRef(false);
+	let controller;
+	let timer;
+	let latest = 0;
+	const readParams = () => params?.();
+	let last = params ? readParams() : void 0;
+	function cancel() {
+		clearTimeout(timer);
+		latest++;
+		controller?.abort();
+		controller = void 0;
+		loading.value = false;
+	}
+	async function run(current) {
+		cancel();
+		last = current;
+		const id = latest;
+		const own = controller = new AbortController();
+		loading.value = true;
+		if (!keepPrevious) data.value = void 0;
+		try {
+			const result = await fetcher(current, own.signal);
+			if (id !== latest) return void 0;
+			data.value = result;
+			error.value = void 0;
+			options.onSuccess?.(result, current);
+			return result;
+		} catch (reason) {
+			if (id !== latest || isAbortError(reason)) return void 0;
+			error.value = reason;
+			options.onError?.(reason, current);
+			return;
+		} finally {
+			if (id === latest) {
+				loading.value = false;
+				controller = void 0;
+			}
+		}
+	}
+	if (params) watch(readParams, (next) => {
+		if (options.enabled?.() === false) return;
+		if (sameValue(next, last)) return;
+		last = next;
+		clearTimeout(timer);
+		if (debounce > 0) timer = setTimeout(() => void run(next), debounce);
+		else run(next);
+	});
+	if (immediate && options.enabled?.() !== false && typeof window !== "undefined") run(readParams());
+	onScopeDispose(cancel);
+	return {
+		get data() {
+			return data.value;
+		},
+		get error() {
+			return error.value;
+		},
+		get loading() {
+			return loading.value;
+		},
+		refresh: () => run(readParams()),
+		cancel,
+		mutate: (value) => data.value = value
+	};
+}
+//#endregion
+export { useRequest };
+
+//# sourceMappingURL=use-request.js.map

package/dist/utils/request/use-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-request.js","names":[],"sources":["../../../src/utils/request/use-request.ts"],"sourcesContent":["/**\n * 一个请求的状态（参考 TanStack Query、alova 的 useWatcher）：只采用最后一次的结果，发新请求时取消上一次，\n * 参数变化防抖，重新请求时保留旧数据（表格不闪成空的）。\n *\n *   const http = useHttp();\n *   const users = useRequest(\n *     ({ keyword, page }, signal) => http.request<Page<User>>({ url: '/users', query: { keyword, page }, signal }),\n *     { params: () => ({ keyword, page }), debounce: 300 },\n *   );\n *   users.data?.rows; users.loading; users.error; users.refresh();\n *\n * 只在浏览器里自动请求：服务端渲染时 data 留空，等页面在浏览器里接管后再请求。\n */\nimport { onScopeDispose, shallowRef, watch } from 'vue';\nimport { sameValue } from '../data/equality';\nimport { isAbortError } from './http';\n\n/** useRequest 的选项 */\nexport interface RequestOptions<P, T> {\n  /** 请求参数：读到的响应式值变了、且内容确实不同时重新请求；不写时只在开始与 refresh 时请求 */\n  params?: () => P;\n  /** 参数变了以后等多久再请求（毫秒），默认 0；refresh 不等 */\n  debounce?: number;\n  /** 一开始就请求，默认 true；false 时等调用 refresh（或参数变化） */\n  immediate?: boolean;\n  /** 重新请求时保留上一次的数据，默认 true；false 时请求一开始就清空 */\n  keepPrevious?: boolean;\n  /**\n   * 自动请求的开关（弹层打开时才请求这类）：为 false 时 immediate 与参数变化都不请求，refresh 照常。\n   * 变回 true 时不自动补一次，需要时调用 refresh\n   */\n  enabled?: () => boolean;\n  /** 成功后调用 */\n  onSuccess?: (data: T, params: P) => void;\n  /** 失败后调用（取消的不算） */\n  onError?: (error: unknown, params: P) => void;\n}\n\n/** useRequest 的返回值 */\nexport interface RequestState<T> {\n  /** 最后一次成功的结果 */\n  readonly data: T | undefined;\n  /** 最后一次失败的原因；成功后清空 */\n  readonly error: unknown;\n  /** 正在请求（防抖等待时还不算） */\n  readonly loading: boolean;\n  /** 按当前参数立即请求，取消进行中的；返回结果，失败或被后来的请求顶掉时为 undefined */\n  refresh(): Promise<T | undefined>;\n  /** 取消进行中的请求与等着的防抖 */\n  cancel(): void;\n  /** 直接改数据（乐观更新、本地删掉一行），不发请求 */\n  mutate(data: T | undefined): void;\n}\n\n/** 请求的状态（在 setup 里调用；见文件开头） */\nexport function useRequest<T, P = undefined>(\n  fetcher: (params: P, signal: AbortSignal) => Promise<T>,\n  options: RequestOptions<P, T> = {},\n): RequestState<T> {\n  const { params, debounce = 0, immediate = true, keepPrevious = true } = options;\n  const data = shallowRef<T>();\n  const error = shallowRef<unknown>();\n  const loading = shallowRef(false);\n  let controller: AbortController | undefined;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  // 每次请求一个编号：结果回来时不是最后一次的就丢掉（fetcher 没理会 signal 时也不会覆盖）\n  let latest = 0;\n  const readParams = () => params?.() as P;\n  // 上一次请求（或开始时）的参数：参数变了但与它相同时不再请求（refresh 之后侦听器又看到同一组参数）\n  let last = params ? readParams() : undefined;\n\n  function cancel() {\n    clearTimeout(timer);\n    latest++;\n    controller?.abort();\n    controller = undefined;\n    loading.value = false;\n  }\n\n  async function run(current: P): Promise<T | undefined> {\n    cancel();\n    last = current;\n    const id = latest;\n    const own = (controller = new AbortController());\n    loading.value = true;\n    if (!keepPrevious) data.value = undefined;\n    try {\n      const result = await fetcher(current, own.signal);\n      if (id !== latest) return undefined;\n      data.value = result;\n      error.value = undefined;\n      options.onSuccess?.(result, current);\n      return result;\n    } catch (reason) {\n      if (id !== latest || isAbortError(reason)) return undefined;\n      error.value = reason;\n      options.onError?.(reason, current);\n      return undefined;\n    } finally {\n      if (id === latest) {\n        loading.value = false;\n        controller = undefined;\n      }\n    }\n  }\n\n  if (params) {\n    watch(readParams, (next) => {\n      if (options.enabled?.() === false) return;\n      if (sameValue(next, last)) return;\n      last = next;\n      clearTimeout(timer);\n      if (debounce > 0) timer = setTimeout(() => void run(next), debounce);\n      else void run(next);\n    });\n  }\n  if (immediate && options.enabled?.() !== false && typeof window !== 'undefined') {\n    void run(readParams());\n  }\n  onScopeDispose(cancel);\n\n  return {\n    get data() {\n      return data.value;\n    },\n    get error() {\n      return error.value;\n    },\n    get loading() {\n      return loading.value;\n    },\n    refresh: () => run(readParams()),\n    cancel,\n    mutate: (value) => (data.value = value),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAuDA,SAAgB,WACd,SACA,UAAgC,CAAC,GAChB;CACjB,MAAM,EAAE,QAAQ,WAAW,GAAG,YAAY,MAAM,eAAe,SAAS;CACxE,MAAM,OAAO,WAAc;CAC3B,MAAM,QAAQ,WAAoB;CAClC,MAAM,UAAU,WAAW,KAAK;CAChC,IAAI;CACJ,IAAI;CAEJ,IAAI,SAAS;CACb,MAAM,mBAAmB,SAAS;CAElC,IAAI,OAAO,SAAS,WAAW,IAAI,KAAA;CAEnC,SAAS,SAAS;EAChB,aAAa,KAAK;EAClB;EACA,YAAY,MAAM;EAClB,aAAa,KAAA;EACb,QAAQ,QAAQ;CAClB;CAEA,eAAe,IAAI,SAAoC;EACrD,OAAO;EACP,OAAO;EACP,MAAM,KAAK;EACX,MAAM,MAAO,aAAa,IAAI,gBAAgB;EAC9C,QAAQ,QAAQ;EAChB,IAAI,CAAC,cAAc,KAAK,QAAQ,KAAA;EAChC,IAAI;GACF,MAAM,SAAS,MAAM,QAAQ,SAAS,IAAI,MAAM;GAChD,IAAI,OAAO,QAAQ,OAAO,KAAA;GAC1B,KAAK,QAAQ;GACb,MAAM,QAAQ,KAAA;GACd,QAAQ,YAAY,QAAQ,OAAO;GACnC,OAAO;EACT,SAAS,QAAQ;GACf,IAAI,OAAO,UAAU,aAAa,MAAM,GAAG,OAAO,KAAA;GAClD,MAAM,QAAQ;GACd,QAAQ,UAAU,QAAQ,OAAO;GACjC;EACF,UAAU;GACR,IAAI,OAAO,QAAQ;IACjB,QAAQ,QAAQ;IAChB,aAAa,KAAA;GACf;EACF;CACF;CAEA,IAAI,QACF,MAAM,aAAa,SAAS;EAC1B,IAAI,QAAQ,UAAU,MAAM,OAAO;EACnC,IAAI,UAAU,MAAM,IAAI,GAAG;EAC3B,OAAO;EACP,aAAa,KAAK;EAClB,IAAI,WAAW,GAAG,QAAQ,iBAAiB,KAAK,IAAI,IAAI,GAAG,QAAQ;OAC9D,IAAS,IAAI;CACpB,CAAC;CAEH,IAAI,aAAa,QAAQ,UAAU,MAAM,SAAS,OAAO,WAAW,aAClE,IAAS,WAAW,CAAC;CAEvB,eAAe,MAAM;CAErB,OAAO;EACL,IAAI,OAAO;GACT,OAAO,KAAK;EACd;EACA,IAAI,QAAQ;GACV,OAAO,MAAM;EACf;EACA,IAAI,UAAU;GACZ,OAAO,QAAQ;EACjB;EACA,eAAe,IAAI,WAAW,CAAC;EAC/B;EACA,SAAS,UAAW,KAAK,QAAQ;CACnC;AACF"}

package/dist/utils/request/wire.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 线上的 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）。
+ */
+import { CalendarDate, CalendarDateTime, Time, ZonedDateTime } from '@internationalized/date';
+import type Decimal from 'decimal.js';
+/** 线上要还原的值的种类 */
+export type WireType = 'bigint' | 'decimal' | 'double' | 'date' | 'time' | 'timestamp' | 'timestamptz' | 'bytes';
+/** 根对象上的类型表：路径 → 种类 */
+export type WireTypes = Record<string, WireType>;
+/** 能写成线上文字的单个值（地址栏参数、表头筛选） */
+export type WireScalar = string | number | boolean | bigint | Decimal | CalendarDate | CalendarDateTime | ZonedDateTime | Time | Date | null | undefined;
+/** fromWire 怎样还原 */
+export interface WireReviveOptions {
+    /** 还原 decimal 用的构造函数（decimal.js 的 Decimal 或它 clone 出来的）；不给时 decimal 留作十进制文字 */
+    decimal?: new (text: string) => Decimal;
+    /** 日期与时间：'iso' 留作 ISO 文字（默认），'objects' 还原成 CalendarDate、Time、CalendarDateTime、ZonedDateTime */
+    dates?: 'iso' | 'objects';
+    /** 'objects' 时 timestamptz 还原到哪个时区，默认浏览器的时区 */
+    timeZone?: string;
+}
+/**
+ * 一个值写成线上的文字：地址栏参数、表头筛选都用它。Decimal 不用科学计数法，日期与时间是 ISO 写法，
+ * 带时区的时刻换算成 UTC；null、undefined 是空字符串
+ */
+export declare function wireText(value: WireScalar): string;
+/**
+ * 把值写成线上的 JSON：要还原的值写成文字，根对象上加 `$types`；没有这样的值时就是普通 JSON。
+ * 对象取自身可枚举的属性（undefined 与函数跳过），有 toJSON 的先调用它；同一路径上既有文字又有 Decimal 这类值时报错
+ */
+export declare function toWire(value: unknown): unknown;
+/**
+ * 读线上的 JSON：按根上的 `$types` 还原（见文件开头的默认值），去掉 `$types`，`{ $value, $types }` 拆成里面的值；
+ * 没有 `$types` 时原样返回。就地改写传入的对象（通常刚由 JSON.parse 得到）
+ */
+export declare function fromWire<T = unknown>(json: unknown, options?: WireReviveOptions): T;

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;
+}>;