@veltra/utils 1.15.0 → 1.15.2

package/dist/ai/openai.d.ts

@@ -1,5 +1,4 @@
 import { AiMessage, AiStreamHandlers, AiTool } from "./types.js";
-//#region src/ai/openai.d.ts
 /** 请求体构造选项 */
 export interface OpenAIBodyOptions {
   /** 模型 id */
@@ -36,5 +35,4 @@ export declare function parseOpenAISSEStream(body: ReadableStream<Uint8Array>, s
  * 响应形状不含可解析文本时返回 undefined。
  */
 export declare function parseOpenAICompletionText(json: unknown): string | undefined;
-//#endregion
 //# sourceMappingURL=openai.d.ts.map

package/dist/ai/openai.js

@@ -1,4 +1,4 @@
-//#region src/ai/openai.ts
+// src/ai/openai.ts
 function toOpenAIMessages(messages, systemPrompt) {
 	const result = [];
 	if (systemPrompt) result.push({
@@ -205,7 +205,6 @@ function parseOpenAICompletionText(json) {
 	const message = isRecord(first) && isRecord(first.message) ? first.message : void 0;
 	return typeof message?.content === "string" ? message.content : void 0;
 }
-//#endregion
 export { buildOpenAIBody, parseOpenAICompletionText, parseOpenAISSEStream };
 
 //# sourceMappingURL=openai.js.map

package/dist/ai/request.d.ts

@@ -1,5 +1,4 @@
 import { AiStreamHandlers, AiTextRequestOptions } from "./types.js";
-//#region src/ai/request.d.ts
 /** OpenAI 兼容请求的发送选项（body 用 buildOpenAIBody 构造） */
 export interface OpenAIRequestOptions {
   /** OpenAI 兼容 chat/completions 完整请求地址 */
@@ -33,5 +32,4 @@ export declare function requestOpenAIStream(options: OpenAIRequestOptions, callb
  * 失败触发 onError；signal 中断不触发任何回调（静默）。
  */
 export declare function requestAiText(options: AiTextRequestOptions): Promise<void>;
-//#endregion
 //# sourceMappingURL=request.d.ts.map

package/dist/ai/request.js

@@ -1,5 +1,5 @@
 import { buildOpenAIBody, parseOpenAICompletionText, parseOpenAISSEStream } from "./openai.js";
-//#region src/ai/request.ts
+// src/ai/request.ts
 /**
 * 发送 OpenAI 兼容 POST 并统一错误处理。
 * 返回 null 表示失败（错误已报给 onError）或已中断（静默）。
@@ -106,7 +106,6 @@ async function requestAiText(options) {
 	}
 	onSuccess?.(text);
 }
-//#endregion
 export { requestAiText, requestOpenAIStream };
 
 //# sourceMappingURL=request.js.map

package/dist/ai/types.d.ts

@@ -1,4 +1,3 @@
-//#region src/ai/types.d.ts
 /**
  * AI 服务商配置（OpenAI 兼容 chat/completions）。
  * 组件实例 prop 与全局配置（useConfig 的 ai 键）字段级合并后使用。
@@ -105,5 +104,4 @@ export interface AiTextRequestOptions {
   /** 失败：网络错误、非 2xx 响应、流中断 */
   onError?(error: Error): void;
 }
-//#endregion
 //# sourceMappingURL=types.d.ts.map

package/dist/dom/class-name.d.ts

@@ -1,8 +1,6 @@
 import { BEMFactory } from "../helper/make-bem.js";
 import { CLS_PREFIX } from "../shared/constants.js";
-//#region src/dom/class-name.d.ts
 export declare const bem: BEMFactory<typeof CLS_PREFIX>;
 export declare function addClass(el: HTMLElement, className: string | string[]): void;
 export declare function removeClass(el: HTMLElement, className: string | string[]): void;
-//#endregion
 //# sourceMappingURL=class-name.d.ts.map

package/dist/dom/class-name.js

@@ -1,6 +1,6 @@
 import { makeBEM } from "../helper/make-bem.js";
 import "../shared/constants.js";
-//#region src/dom/class-name.ts
+// src/dom/class-name.ts
 const bem = makeBEM("u-");
 function addClass(el, className) {
 	if (Array.isArray(className)) className.forEach((c) => el.classList.add(c));
@@ -10,7 +10,6 @@ function removeClass(el, className) {
 	if (Array.isArray(className)) className.forEach((c) => el.classList.remove(c));
 	else el.classList.remove(className);
 }
-//#endregion
 export { addClass, bem, removeClass };
 
 //# sourceMappingURL=class-name.js.map

package/dist/dom/expand-transition.d.ts

@@ -1,4 +1,3 @@
-//#region src/dom/expand-transition.d.ts
 export interface ExpandTransitionOptions {
   transition?: string;
   enterTransition?: string;
@@ -27,5 +26,4 @@ export declare class ExpandTransition {
   private resetTransitionStyles;
   private resetTemporaryStyles;
 }
-//#endregion
 //# sourceMappingURL=expand-transition.d.ts.map

package/dist/dom/expand-transition.js

@@ -1,5 +1,5 @@
 import { removeStyles, setStyles } from "./style.js";
-//#region src/dom/expand-transition.ts
+// src/dom/expand-transition.ts
 function readVerticalPadding(el) {
 	const { paddingTop, paddingBottom } = getComputedStyle(el);
 	return {
@@ -151,7 +151,6 @@ var ExpandTransition = class {
 		]);
 	}
 };
-//#endregion
 export { ExpandTransition };
 
 //# sourceMappingURL=expand-transition.js.map

package/dist/dom/highlight.d.ts

@@ -1,4 +1,3 @@
-//#region src/dom/highlight.d.ts
 interface HighlightChunk {
   text: string;
   highlight: boolean;
@@ -9,6 +8,5 @@ interface HighlightChunk {
  * @param substrings 需要匹配的字串列表
  */
 export declare function getHighlightChunks(str: string, substrings: string[]): HighlightChunk[];
-//#endregion
 export {};
 //# sourceMappingURL=highlight.d.ts.map

package/dist/dom/highlight.js

@@ -1,4 +1,4 @@
-//#region src/dom/highlight.ts
+// src/dom/highlight.ts
 const escapeRegexp = (term) => term.replace(/[|\\{}()[\]^$+*?.-]/g, (char) => `\\${char}`);
 /**
 * 获取文本高亮片段
@@ -13,7 +13,6 @@ function getHighlightChunks(str, substrings) {
 		highlight: re.test(text)
 	}));
 }
-//#endregion
 export { getHighlightChunks };
 
 //# sourceMappingURL=highlight.js.map

package/dist/dom/position.d.ts

@@ -1,4 +1,3 @@
-//#region src/dom/position.d.ts
 /**
  * 获取可滚动的父级（纵向或横向可滚动均计入：overflow-x 容器如横向滚动条
  * 也是滚动父级，弹层需监听其 scroll 事件）
@@ -24,6 +23,5 @@ export declare function scrollIntoContainerView(el: HTMLElement, container: HTML
   block?: ScrollViewPosition;
   inline?: ScrollViewPosition;
 }): void;
-//#endregion
 export {};
 //# sourceMappingURL=position.d.ts.map

package/dist/dom/position.js

@@ -1,4 +1,4 @@
-//#region src/dom/position.ts
+// src/dom/position.ts
 /**
 * 获取可滚动的父级（纵向或横向可滚动均计入：overflow-x 容器如横向滚动条
 * 也是滚动父级，弹层需监听其 scroll 事件）
@@ -54,7 +54,6 @@ function scrollIntoContainerView(el, container, options) {
 		else if (inline === "end") container.scrollLeft = eOffsetLeft - cClientWidth + eOffsetWidth;
 	}
 }
-//#endregion
 export { getNearestScrollParent, getScrollParents, scrollIntoContainerView };
 
 //# sourceMappingURL=position.js.map

package/dist/dom/style.d.ts

@@ -1,5 +1,4 @@
 import { CSSProperties } from "vue";
-//#region src/dom/style.d.ts
 /**
  * 给数值加上单位
  * @param value 数值
@@ -19,5 +18,4 @@ export declare function setStyles(el: HTMLElement, styles: CSSProperties): void;
  * @param props 要移除的样式属性
  */
 export declare function removeStyles(el: HTMLElement, props: string[]): void;
-//#endregion
 //# sourceMappingURL=style.d.ts.map

package/dist/dom/style.js

@@ -1,5 +1,5 @@
 import { str } from "@cat-kit/core";
-//#region src/dom/style.ts
+// src/dom/style.ts
 /**
 * 给数值加上单位
 * @param value 数值
@@ -32,7 +32,6 @@ function removeStyles(el, props) {
 		el.style.removeProperty(key);
 	});
 }
-//#endregion
 export { removeStyles, setStyles, withUnit };
 
 //# sourceMappingURL=style.js.map

package/dist/dom/z-index.d.ts

@@ -1,8 +1,6 @@
-//#region src/dom/z-index.d.ts
 /**
  * z轴层级
  * 保证每个新打开的弹框的位置都处于上层
  */
 export declare const zIndex: () => number;
-//#endregion
 //# sourceMappingURL=z-index.d.ts.map

package/dist/dom/z-index.js

@@ -1,11 +1,10 @@
 import { createIncrease } from "../helper/create-increase.js";
-//#region src/dom/z-index.ts
+// src/dom/z-index.ts
 /**
 * z轴层级
 * 保证每个新打开的弹框的位置都处于上层
 */
 const zIndex = createIncrease(1e3);
-//#endregion
 export { zIndex };
 
 //# sourceMappingURL=z-index.js.map

package/dist/helper/create-increase.d.ts

@@ -1,9 +1,7 @@
-//#region src/helper/create-increase.d.ts
 /**
  * 创建一个自增函数
  * @param initial 初始值
  * @returns
  */
 export declare function createIncrease(initial?: number): () => number;
-//#endregion
 //# sourceMappingURL=create-increase.d.ts.map

package/dist/helper/create-increase.js

@@ -1,4 +1,4 @@
-//#region src/helper/create-increase.ts
+// src/helper/create-increase.ts
 /**
 * 创建一个自增函数
 * @param initial 初始值
@@ -11,7 +11,6 @@ function createIncrease(initial = 1e3) {
 	};
 	return increase;
 }
-//#endregion
 export { createIncrease };
 
 //# sourceMappingURL=create-increase.js.map

package/dist/helper/create-toggle.d.ts

@@ -1,4 +1,3 @@
-//#region src/helper/create-toggle.d.ts
 type Active = boolean | ((active: boolean) => boolean) | ((active: boolean) => Promise<boolean>);
 type ToggleReturn = [{
   value: boolean;
@@ -10,6 +9,5 @@ type ToggleReturn = [{
  * @returns
  */
 export declare function createToggle(initial?: boolean, onChange?: (active: boolean) => void): ToggleReturn;
-//#endregion
 export {};
 //# sourceMappingURL=create-toggle.d.ts.map

package/dist/helper/create-toggle.js

@@ -1,4 +1,4 @@
-//#region src/helper/create-toggle.ts
+// src/helper/create-toggle.ts
 /**
 * 创建一个toggle函数
 * @param initial 初始值
@@ -18,7 +18,6 @@ function createToggle(initial = false, onChange) {
 	}
 	return [state, toggle];
 }
-//#endregion
 export { createToggle };
 
 //# sourceMappingURL=create-toggle.js.map

package/dist/helper/frame.d.ts

@@ -1,8 +1,6 @@
-//#region src/helper/frame.d.ts
 /**
  * 下一帧运行
  * @param cb 回调
  */
 export declare function nextFrame(cb: () => void): void;
-//#endregion
 //# sourceMappingURL=frame.d.ts.map

package/dist/helper/frame.js

@@ -1,4 +1,4 @@
-//#region src/helper/frame.ts
+// src/helper/frame.ts
 /**
 * 下一帧运行
 * @param cb 回调
@@ -8,7 +8,6 @@ function nextFrame(cb) {
 		requestAnimationFrame(cb);
 	});
 }
-//#endregion
 export { nextFrame };
 
 //# sourceMappingURL=frame.js.map

package/dist/helper/make-bem.d.ts

@@ -1,4 +1,3 @@
-//#region src/helper/make-bem.d.ts
 /** BEM实例 */
 export type BEM<N extends string, P extends string = 'u-', B extends string = `${P}${N}`> = {
   /** BEM中的块 */
@@ -48,5 +47,4 @@ export interface BEMFactory<Prefix extends string> {
  * @param prefix 前缀
  */
 export declare function makeBEM<Prefix extends '' | `${string}-`>(prefix: Prefix): BEMFactory<Prefix>;
-//#endregion
 //# sourceMappingURL=make-bem.d.ts.map

package/dist/helper/make-bem.js

@@ -1,4 +1,4 @@
-//#region src/helper/make-bem.ts
+// src/helper/make-bem.ts
 /**
 * 创建一个bem函数
 * @param prefix 前缀
@@ -33,7 +33,6 @@ function makeBEM(prefix) {
 	bem.is = is;
 	return bem;
 }
-//#endregion
 export { makeBEM };
 
 //# sourceMappingURL=make-bem.js.map

package/dist/helper/overflow-nav.d.ts

@@ -1,4 +1,3 @@
-//#region src/helper/overflow-nav.d.ts
 /**
  * 水平溢出滚动导航的共享纯逻辑（tabs / toolbar 三处复制的收敛，见 #17）。
  * 只提供无 Vue 依赖的计算与副作用，事件绑定 / ResizeObserver / watch 由各
@@ -36,6 +35,5 @@ export declare function scrollElementIntoView(vp: HTMLElement, el: HTMLElement,
  * navActive = 导航按钮是否可见（内容未溢出时不消费滚轮）。
  */
 export declare function applyWheelHorizontalScroll(e: WheelEvent, vp: HTMLElement, navActive: boolean): void;
-//#endregion
 export {};
 //# sourceMappingURL=overflow-nav.d.ts.map

package/dist/helper/overflow-nav.js

@@ -1,4 +1,4 @@
-//#region src/helper/overflow-nav.ts
+// src/helper/overflow-nav.ts
 /** 依据视口与内容尺寸推导滚动按钮可用状态 */
 function computeOverflowNavState(vp) {
 	const overflowing = vp.scrollWidth - vp.clientWidth > 1;
@@ -39,7 +39,6 @@ function applyWheelHorizontalScroll(e, vp, navActive) {
 	e.preventDefault();
 	vp.scrollLeft += e.deltaY;
 }
-//#endregion
 export { applyWheelHorizontalScroll, computeOverflowNavState, scrollElementIntoView, scrollViewportByStep };
 
 //# sourceMappingURL=overflow-nav.js.map

package/dist/helper/tween.d.ts

@@ -1,4 +1,3 @@
-//#region src/helper/tween.d.ts
 /** 自 cat-kit 3.x Tween 行为对齐的轻量动画（原 `cat-kit/fe` 导出） */
 export interface AnimeConfig<State extends Record<string, number>> {
   duration?: number;
@@ -38,5 +37,4 @@ export declare class Tween<State extends Record<string, number> = Record<string,
     easeInOutBack: (p: number) => number;
   };
 }
-//#endregion
 //# sourceMappingURL=tween.d.ts.map

package/dist/helper/tween.js

@@ -1,4 +1,4 @@
-//#region src/helper/tween.ts
+// src/helper/tween.ts
 var Tween = class Tween {
 	state;
 	duration = 300;
@@ -83,7 +83,6 @@ var Tween = class Tween {
 		}
 	};
 };
-//#endregion
 export { Tween };
 
 //# sourceMappingURL=tween.js.map

package/dist/helper/vue.d.ts

@@ -1,5 +1,4 @@
 import { ShallowRef, VNode, VNodeArrayChildren } from "vue";
-//#region src/helper/vue.d.ts
 interface TextVNode extends VNode {
   children: string;
 }
@@ -50,6 +49,5 @@ export declare function fieldKey(key: string | null | undefined, fallback: strin
  */
 export declare function renderLabelTemplate(template: string | undefined, row: Record<string, any> | undefined | null): string | undefined;
 export declare function shallowComputed<T>(getter: () => T): ShallowRef<T>;
-//#endregion
 export {};
 //# sourceMappingURL=vue.d.ts.map

package/dist/helper/vue.js

@@ -1,6 +1,6 @@
 import { o } from "@cat-kit/core";
 import { Comment, Fragment, Text, createTextVNode, isVNode, shallowRef, watch } from "vue";
-//#region src/helper/vue.ts
+// src/helper/vue.ts
 /**
 * 是否为文本
 * @param node
@@ -85,7 +85,6 @@ function shallowComputed(getter) {
 	});
 	return result;
 }
-//#endregion
 export { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, renderLabelTemplate, shallowComputed };
 
 //# sourceMappingURL=vue.js.map

package/dist/reactive/proxy.d.ts

@@ -1,4 +1,3 @@
-//#region src/reactive/proxy.d.ts
 /**
  * 中间代理, 用于vue的reactive和shallowReactive方法的中间层
  * @param o 代理对象
@@ -14,5 +13,4 @@ export declare function middleProxy<O extends Record<string, any>>(o: O, handler
    */
   changed?: (fields: string[]) => void;
 }): O;
-//#endregion
 //# sourceMappingURL=proxy.d.ts.map

package/dist/reactive/proxy.js

@@ -1,4 +1,4 @@
-//#region src/reactive/proxy.ts
+// src/reactive/proxy.ts
 /**
 * 创建一个介于vue的reactive和shallowReactive对象的中间层
 * @description
@@ -51,7 +51,6 @@ function createMiddleProxy(o, handler, options) {
 function middleProxy(o, handler) {
 	return createMiddleProxy(o, handler);
 }
-//#endregion
 export { middleProxy };
 
 //# sourceMappingURL=proxy.js.map

package/dist/shared/constants.d.ts

@@ -1,9 +1,7 @@
-//#region src/shared/constants.d.ts
 /** 命名前缀 */
 export declare const NAME_SPACE = "U";
 /** 类前缀 */
 export declare const CLS_PREFIX: "u-";
 /** 表单空内容 */
 export declare const FORM_EMPTY_CONTENT = "-";
-//#endregion
 //# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.js

@@ -1,11 +1,10 @@
-//#region src/shared/constants.ts
+// src/shared/constants.ts
 /** 命名前缀 */
 const NAME_SPACE = "U";
 /** 类前缀 */
 const CLS_PREFIX = `${"U".toLowerCase()}-`;
 /** 表单空内容 */
 const FORM_EMPTY_CONTENT = "-";
-//#endregion
 export { CLS_PREFIX, FORM_EMPTY_CONTENT, NAME_SPACE };
 
 //# sourceMappingURL=constants.js.map

package/dist/types/component-common.d.ts

@@ -1,4 +1,3 @@
-//#region src/types/component-common.d.ts
 export type ComponentSize = 'small' | 'default' | 'large';
 export type ColorType = 'primary' | 'info' | 'success' | 'warning' | 'danger';
 /** 断点名称 */
@@ -56,5 +55,4 @@ export interface PropsWithServerQuery {
   /** 请求查询参数 */
   query?: Record<string, any>;
 }
-//#endregion
 //# sourceMappingURL=component-common.d.ts.map

package/dist/types/form-context.d.ts

@@ -1,5 +1,4 @@
 import { ComponentSize } from "./component-common.js";
-//#region src/types/form-context.d.ts
 export interface FormContextModel {
   errors: Map<any, string[] | undefined>;
   fields: Record<string, {
@@ -46,6 +45,5 @@ export declare function injectFormContext(): {
   /** 是否在表单中 */
   inForm: boolean;
 } & Partial<DIContext>;
-//#endregion
 export {};
 //# sourceMappingURL=form-context.d.ts.map

package/dist/types/form-context.js

@@ -1,5 +1,5 @@
 import { inject, provide } from "vue";
-//#region src/types/form-context.ts
+// src/types/form-context.ts
 const FormComponentDIKey = Symbol("FormComponentDIKey");
 function provideFormContext(context) {
 	provide(FormComponentDIKey, context);
@@ -11,7 +11,6 @@ function injectFormContext() {
 		...context
 	};
 }
-//#endregion
 export { injectFormContext, provideFormContext };
 
 //# sourceMappingURL=form-context.js.map

package/dist/types/helper.d.ts

@@ -1,5 +1,4 @@
 import { VNode } from "vue";
-//#region src/types/helper.d.ts
 export type Null<T> = null | T;
 export type Undef<T> = undefined | T;
 /** 自定义事件, 可以指定target类型 */
@@ -16,5 +15,4 @@ export type Index<Keys extends string, Val> = { [key in Keys]?: Val; };
  * 渲染函数返回内容
  */
 export type RenderReturn = (undefined | VNode | string | null | number)[] | undefined | VNode | string | null | number;
-//#endregion
 //# sourceMappingURL=helper.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/utils",
-  "version": "1.15.0",
+  "version": "1.15.2",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"