@veltra/utils 1.0.0

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

@@ -0,0 +1,52 @@
+//#region src/helper/make-bem.d.ts
+/** BEM实例 */
+type BEM<N extends string, P extends string = 'u-', B extends string = `${P}${N}`> = {
+  /** BEM中的块 */b: B;
+  /**
+   * BEM中的元素(E)
+   * @param name 元素名称
+   * @returns
+   */
+  e<const E extends string>(name: E): `${B}__${E}`;
+  /**
+   * 基于当前bem创建一个新的bem
+   * @param block 块名称
+   */
+  create<const Block extends string>(block: Block): BEM<`${N}-${Block}`, P>;
+  /**
+   * BEM中的修饰符(M)
+   * @param m 修饰符名
+   * @returns 修饰符
+   */
+  m<const M extends string>(m: M): `${B}--${M}`;
+  /**
+   * BEM中的元素与修饰符(E--M)
+   * @param e 元素名
+   * @param m 修饰符名
+   * @returns
+   */
+  em<const E extends string, const M extends string>(e: E, m: M): `${B}__${E}--${M}`;
+};
+/** BEM工厂 */
+interface BEMFactory<Prefix extends string> {
+  <N extends string>(name: N): BEM<N, Prefix>;
+  /**
+   * 生成is辅助类
+   * @param name 辅助类名称
+   */
+  is<const N extends string>(name: N): `is-${N}`;
+  /**
+   * 生成is辅助类
+   * @param name 辅助类名称
+   * @param condition 辅助类显示条件
+   */
+  is<const N extends string, C extends boolean | undefined>(name: N, condition: C): C extends true ? `is-${N}` : '';
+}
+/**
+ * 创建一个bem函数
+ * @param prefix 前缀
+ */
+declare function makeBEM<Prefix extends '' | `${string}-`>(prefix: Prefix): BEMFactory<Prefix>;
+//#endregion
+export { BEM, BEMFactory, makeBEM };
+//# sourceMappingURL=make-bem.d.ts.map

package/dist/helper/make-bem.js

@@ -0,0 +1,39 @@
+//#region src/helper/make-bem.ts
+/**
+* 创建一个bem函数
+* @param prefix 前缀
+*/
+function makeBEM(prefix) {
+	/**
+	* css类命名辅助
+	* @param name 类block名称
+	*/
+	function bem(name) {
+		const b = `${prefix}${name}`;
+		return {
+			b,
+			e(name) {
+				return `${b}__${name}`;
+			},
+			create(block) {
+				return bem(`${name}-${block}`);
+			},
+			m(m) {
+				return `${b}--${m}`;
+			},
+			em(e, m) {
+				return `${b}__${e}--${m}`;
+			}
+		};
+	}
+	function is(name, condition) {
+		if (arguments.length < 2) return `is-${name}`;
+		return condition !== true ? "" : `is-${name}`;
+	}
+	bem.is = is;
+	return bem;
+}
+//#endregion
+export { makeBEM };
+
+//# sourceMappingURL=make-bem.js.map

package/dist/helper/make-bem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-bem.js","names":[],"sources":["../../src/helper/make-bem.ts"],"sourcesContent":["/** BEM实例 */\nexport type BEM<N extends string, P extends string = 'u-', B extends string = `${P}${N}`> = {\n  /** BEM中的块 */\n  b: B\n\n  /**\n   * BEM中的元素(E)\n   * @param name 元素名称\n   * @returns\n   */\n  e<const E extends string>(name: E): `${B}__${E}`\n\n  /**\n   * 基于当前bem创建一个新的bem\n   * @param block 块名称\n   */\n  create<const Block extends string>(block: Block): BEM<`${N}-${Block}`, P>\n\n  /**\n   * BEM中的修饰符(M)\n   * @param m 修饰符名\n   * @returns 修饰符\n   */\n  m<const M extends string>(m: M): `${B}--${M}`\n\n  /**\n   * BEM中的元素与修饰符(E--M)\n   * @param e 元素名\n   * @param m 修饰符名\n   * @returns\n   */\n  em<const E extends string, const M extends string>(e: E, m: M): `${B}__${E}--${M}`\n}\n\n/** BEM工厂 */\nexport interface BEMFactory<Prefix extends string> {\n  <N extends string>(name: N): BEM<N, Prefix>\n  /**\n   * 生成is辅助类\n   * @param name 辅助类名称\n   */\n  is<const N extends string>(name: N): `is-${N}`\n  /**\n   * 生成is辅助类\n   * @param name 辅助类名称\n   * @param condition 辅助类显示条件\n   */\n  is<const N extends string, C extends boolean | undefined>(\n    name: N,\n    condition: C\n  ): C extends true ? `is-${N}` : ''\n}\n\n/**\n * 创建一个bem函数\n * @param prefix 前缀\n */\nexport function makeBEM<Prefix extends '' | `${string}-`>(prefix: Prefix): BEMFactory<Prefix> {\n  /**\n   * css类命名辅助\n   * @param name 类block名称\n   */\n  function bem<N extends string>(name: N): BEM<N, Prefix> {\n    const b = `${prefix}${name}` as BEM<N, Prefix>['b']\n    return {\n      b,\n\n      e(name) {\n        return `${b}__${name}`\n      },\n\n      create(block) {\n        return bem(`${name}-${block}`)\n      },\n\n      m(m) {\n        return `${b}--${m}`\n      },\n\n      em(e, m) {\n        return `${b}__${e}--${m}`\n      }\n    }\n  }\n\n  /**\n   * 生成is辅助类\n   * @param name 辅助类名称\n   */\n  function is<const N extends string>(name: N): `is-${N}`\n  /**\n   * 生成is辅助类\n   * @param name 辅助类名称\n   * @param condition 辅助类显示条件\n   */\n  function is<const N extends string, C extends boolean | undefined>(\n    name: N,\n    condition: C\n  ): C extends true ? `is-${N}` : ''\n\n  function is<N extends string>(name: N, condition?: boolean) {\n    if (arguments.length < 2) return `is-${name}`\n    return condition !== true ? '' : (`is-${name}` as const)\n  }\n\n  bem.is = is\n\n  return bem\n}\n"],"mappings":";;;;;AAyDA,SAAgB,QAA0C,QAAoC;;;;;CAK5F,SAAS,IAAsB,MAAyB;EACtD,MAAM,IAAI,GAAG,SAAS;AACtB,SAAO;GACL;GAEA,EAAE,MAAM;AACN,WAAO,GAAG,EAAE,IAAI;;GAGlB,OAAO,OAAO;AACZ,WAAO,IAAI,GAAG,KAAK,GAAG,QAAQ;;GAGhC,EAAE,GAAG;AACH,WAAO,GAAG,EAAE,IAAI;;GAGlB,GAAG,GAAG,GAAG;AACP,WAAO,GAAG,EAAE,IAAI,EAAE,IAAI;;GAEzB;;CAkBH,SAAS,GAAqB,MAAS,WAAqB;AAC1D,MAAI,UAAU,SAAS,EAAG,QAAO,MAAM;AACvC,SAAO,cAAc,OAAO,KAAM,MAAM;;AAG1C,KAAI,KAAK;AAET,QAAO"}

package/dist/helper/tween.d.ts

@@ -0,0 +1,43 @@
+//#region src/helper/tween.d.ts
+/** 自 cat-kit 3.x Tween 行为对齐的轻量动画（原 `cat-kit/fe` 导出） */
+interface AnimeConfig<State extends Record<string, number>> {
+  duration?: number;
+  easingFunction?: (progress: number) => number;
+  onComplete?(state: State): void;
+}
+interface TweenConfig<State extends Record<string, number>> {
+  duration?: number;
+  onUpdate?(state: State): void;
+  onComplete?(state: State): void;
+  easingFunction?: (progress: number) => number;
+}
+declare class Tween<State extends Record<string, number> = Record<string, number>> {
+  readonly state: State;
+  protected duration: number;
+  protected onUpdate?: (state: State) => void;
+  protected onComplete?: (state: State) => void;
+  protected frameId?: number;
+  protected easingFunction: (progress: number) => number;
+  private defaultState;
+  constructor(state: State, config?: TweenConfig<State>);
+  protected raf(options: {
+    onComplete: () => void;
+    duration: number;
+    tick: (p: number) => void;
+  }): void;
+  to(state: Partial<State>, config?: AnimeConfig<State>): void;
+  back(config?: AnimeConfig<State>): void;
+  private stop;
+  static readonly easing: {
+    linear: (p: number) => number;
+    easeInQuad: (p: number) => number;
+    easeOutQuad: (p: number) => number;
+    easeInOutQuad: (p: number) => number;
+    easeInBack: (p: number) => number;
+    easeOutBack: (p: number) => number;
+    easeInOutBack: (p: number) => number;
+  };
+}
+//#endregion
+export { AnimeConfig, Tween, TweenConfig };
+//# sourceMappingURL=tween.d.ts.map

package/dist/helper/tween.js

@@ -0,0 +1,89 @@
+//#region src/helper/tween.ts
+var Tween = class Tween {
+	state;
+	duration = 300;
+	onUpdate;
+	onComplete;
+	frameId;
+	easingFunction;
+	defaultState;
+	constructor(state, config) {
+		this.state = state;
+		this.defaultState = { ...state };
+		const { duration, onUpdate, onComplete, easingFunction } = config || {};
+		if (duration !== void 0) this.duration = duration;
+		if (onUpdate !== void 0) this.onUpdate = onUpdate;
+		if (onComplete !== void 0) this.onComplete = onComplete;
+		this.easingFunction = easingFunction ?? Tween.easing.linear;
+	}
+	raf(options) {
+		const start = performance.now();
+		const { onComplete, tick, duration } = options;
+		const update = (timestamp) => {
+			const elapsed = timestamp - start;
+			const progress = Math.min(elapsed / duration, 1);
+			tick(progress);
+			if (progress < 1) this.frameId = requestAnimationFrame(update);
+			else {
+				tick(progress);
+				this.stop();
+				onComplete();
+			}
+		};
+		this.frameId = requestAnimationFrame(update);
+	}
+	to(state, config) {
+		this.stop();
+		const prevState = { ...this.state };
+		const stateDistance = Object.keys(state).reduce((acc, key) => {
+			const k = key;
+			const sv = state[k];
+			const pv = prevState[k];
+			if ((sv || sv === 0) && (pv || pv === 0)) acc[key] = sv - pv;
+			return acc;
+		}, {});
+		const duration = config?.duration || this.duration;
+		const easingFunction = config?.easingFunction || this.easingFunction;
+		const onComplete = config?.onComplete || this.onComplete;
+		this.raf({
+			duration,
+			onComplete: () => {
+				for (const key in state) if (key in this.state) this.state[key] = state[key];
+				this.onUpdate?.(this.state);
+				onComplete?.(this.state);
+			},
+			tick: (progress) => {
+				for (const key in stateDistance) {
+					const target = prevState[key] + easingFunction(progress) * stateDistance[key];
+					this.state[key] = target;
+				}
+				this.onUpdate?.(this.state);
+			}
+		});
+	}
+	back(config) {
+		this.to(this.defaultState, config);
+	}
+	stop() {
+		if (!this.frameId) return false;
+		cancelAnimationFrame(this.frameId);
+		this.frameId = void 0;
+		return true;
+	}
+	static easing = {
+		linear: (p) => p,
+		easeInQuad: (p) => p * p,
+		easeOutQuad: (p) => p * (2 - p),
+		easeInOutQuad: (p) => p < .5 ? 2 * p * p : -1 + (4 - 2 * p) * p,
+		easeInBack: (p) => p * p * (3.70158 * p - 1),
+		easeOutBack: (p) => 1 + 2.70158 * Math.pow(p - 1, 3) + 1.70158 * Math.pow(p - 1, 2),
+		easeInOutBack: (p) => {
+			const c2 = 1.70158 * 1.525;
+			return p < .5 ? Math.pow(2 * p, 2) * ((c2 + 1) * 2 * p - c2) / 2 : (Math.pow(2 * p - 2, 2) * ((c2 + 1) * (p * 2 - 2) + c2) + 2) / 2;
+		}
+	};
+};
+//#endregion
+export { Tween };
+
+//# sourceMappingURL=tween.js.map

package/dist/helper/tween.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tween.js","names":[],"sources":["../../src/helper/tween.ts"],"sourcesContent":["/** 自 cat-kit 3.x Tween 行为对齐的轻量动画（原 `cat-kit/fe` 导出） */\n\nexport interface AnimeConfig<State extends Record<string, number>> {\n  duration?: number\n  easingFunction?: (progress: number) => number\n  onComplete?(state: State): void\n}\n\nexport interface TweenConfig<State extends Record<string, number>> {\n  duration?: number\n  onUpdate?(state: State): void\n  onComplete?(state: State): void\n  easingFunction?: (progress: number) => number\n}\n\nexport class Tween<State extends Record<string, number> = Record<string, number>> {\n  readonly state: State\n  protected duration = 300\n  protected onUpdate?: (state: State) => void\n  protected onComplete?: (state: State) => void\n  protected frameId?: number\n  protected easingFunction: (progress: number) => number\n  private defaultState: State\n\n  constructor(state: State, config?: TweenConfig<State>) {\n    this.state = state\n    this.defaultState = { ...state }\n    const { duration, onUpdate, onComplete, easingFunction } = config || {}\n    if (duration !== undefined) this.duration = duration\n    if (onUpdate !== undefined) this.onUpdate = onUpdate\n    if (onComplete !== undefined) this.onComplete = onComplete\n    this.easingFunction = easingFunction ?? Tween.easing.linear\n  }\n\n  protected raf(options: {\n    onComplete: () => void\n    duration: number\n    tick: (p: number) => void\n  }): void {\n    const start = performance.now()\n    const { onComplete, tick, duration } = options\n    const update = (timestamp: number) => {\n      const elapsed = timestamp - start\n      const progress = Math.min(elapsed / duration, 1)\n      tick(progress)\n      if (progress < 1) {\n        this.frameId = requestAnimationFrame(update)\n      } else {\n        tick(progress)\n        this.stop()\n        onComplete()\n      }\n    }\n    this.frameId = requestAnimationFrame(update)\n  }\n\n  to(state: Partial<State>, config?: AnimeConfig<State>): void {\n    this.stop()\n    const prevState = { ...this.state }\n    const stateDistance = Object.keys(state).reduce(\n      (acc, key) => {\n        const k = key as keyof State\n        const sv = state[k] as number\n        const pv = prevState[k] as number\n        if ((sv || sv === 0) && (pv || pv === 0)) {\n          acc[key] = sv - pv\n        }\n        return acc\n      },\n      {} as Record<string, number>\n    )\n    const duration = config?.duration || this.duration\n    const easingFunction = config?.easingFunction || this.easingFunction\n    const onComplete = config?.onComplete || this.onComplete\n    this.raf({\n      duration,\n      onComplete: () => {\n        for (const key in state) {\n          if (key in this.state) {\n            ;(this.state as Record<string, number>)[key] = state[key as keyof State] as number\n          }\n        }\n        this.onUpdate?.(this.state)\n        onComplete?.(this.state)\n      },\n      tick: (progress) => {\n        for (const key in stateDistance) {\n          const pk = key as keyof State\n          const target = (prevState[pk] as number) + easingFunction(progress) * stateDistance[key]!\n          ;(this.state as Record<string, number>)[key] = target\n        }\n        this.onUpdate?.(this.state)\n      }\n    })\n  }\n\n  back(config?: AnimeConfig<State>): void {\n    this.to(this.defaultState as Partial<State>, config)\n  }\n\n  private stop(): boolean {\n    if (!this.frameId) return false\n    cancelAnimationFrame(this.frameId)\n    this.frameId = undefined\n    return true\n  }\n\n  static readonly easing = {\n    linear: (p: number) => p,\n    easeInQuad: (p: number) => p * p,\n    easeOutQuad: (p: number) => p * (2 - p),\n    easeInOutQuad: (p: number) => (p < 0.5 ? 2 * p * p : -1 + (4 - 2 * p) * p),\n    easeInBack: (p: number) => p * p * ((2.70158 + 1) * p - 1),\n    easeOutBack: (p: number) => 1 + 2.70158 * Math.pow(p - 1, 3) + 1.70158 * Math.pow(p - 1, 2),\n    easeInOutBack: (p: number) => {\n      const c1 = 1.70158\n      const c2 = c1 * 1.525\n      return p < 0.5\n        ? (Math.pow(2 * p, 2) * ((c2 + 1) * 2 * p - c2)) / 2\n        : (Math.pow(2 * p - 2, 2) * ((c2 + 1) * (p * 2 - 2) + c2) + 2) / 2\n    }\n  }\n}\n"],"mappings":";AAeA,IAAa,QAAb,MAAa,MAAqE;CAChF;CACA,WAAqB;CACrB;CACA;CACA;CACA;CACA;CAEA,YAAY,OAAc,QAA6B;AACrD,OAAK,QAAQ;AACb,OAAK,eAAe,EAAE,GAAG,OAAO;EAChC,MAAM,EAAE,UAAU,UAAU,YAAY,mBAAmB,UAAU,EAAE;AACvE,MAAI,aAAa,KAAA,EAAW,MAAK,WAAW;AAC5C,MAAI,aAAa,KAAA,EAAW,MAAK,WAAW;AAC5C,MAAI,eAAe,KAAA,EAAW,MAAK,aAAa;AAChD,OAAK,iBAAiB,kBAAkB,MAAM,OAAO;;CAGvD,IAAc,SAIL;EACP,MAAM,QAAQ,YAAY,KAAK;EAC/B,MAAM,EAAE,YAAY,MAAM,aAAa;EACvC,MAAM,UAAU,cAAsB;GACpC,MAAM,UAAU,YAAY;GAC5B,MAAM,WAAW,KAAK,IAAI,UAAU,UAAU,EAAE;AAChD,QAAK,SAAS;AACd,OAAI,WAAW,EACb,MAAK,UAAU,sBAAsB,OAAO;QACvC;AACL,SAAK,SAAS;AACd,SAAK,MAAM;AACX,gBAAY;;;AAGhB,OAAK,UAAU,sBAAsB,OAAO;;CAG9C,GAAG,OAAuB,QAAmC;AAC3D,OAAK,MAAM;EACX,MAAM,YAAY,EAAE,GAAG,KAAK,OAAO;EACnC,MAAM,gBAAgB,OAAO,KAAK,MAAM,CAAC,QACtC,KAAK,QAAQ;GACZ,MAAM,IAAI;GACV,MAAM,KAAK,MAAM;GACjB,MAAM,KAAK,UAAU;AACrB,QAAK,MAAM,OAAO,OAAO,MAAM,OAAO,GACpC,KAAI,OAAO,KAAK;AAElB,UAAO;KAET,EAAE,CACH;EACD,MAAM,WAAW,QAAQ,YAAY,KAAK;EAC1C,MAAM,iBAAiB,QAAQ,kBAAkB,KAAK;EACtD,MAAM,aAAa,QAAQ,cAAc,KAAK;AAC9C,OAAK,IAAI;GACP;GACA,kBAAkB;AAChB,SAAK,MAAM,OAAO,MAChB,KAAI,OAAO,KAAK,MACZ,MAAK,MAAiC,OAAO,MAAM;AAGzD,SAAK,WAAW,KAAK,MAAM;AAC3B,iBAAa,KAAK,MAAM;;GAE1B,OAAO,aAAa;AAClB,SAAK,MAAM,OAAO,eAAe;KAE/B,MAAM,SAAU,UADL,OACgC,eAAe,SAAS,GAAG,cAAc;AAClF,UAAK,MAAiC,OAAO;;AAEjD,SAAK,WAAW,KAAK,MAAM;;GAE9B,CAAC;;CAGJ,KAAK,QAAmC;AACtC,OAAK,GAAG,KAAK,cAAgC,OAAO;;CAGtD,OAAwB;AACtB,MAAI,CAAC,KAAK,QAAS,QAAO;AAC1B,uBAAqB,KAAK,QAAQ;AAClC,OAAK,UAAU,KAAA;AACf,SAAO;;CAGT,OAAgB,SAAS;EACvB,SAAS,MAAc;EACvB,aAAa,MAAc,IAAI;EAC/B,cAAc,MAAc,KAAK,IAAI;EACrC,gBAAgB,MAAe,IAAI,KAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,KAAK;EACxE,aAAa,MAAc,IAAI,KAAM,UAAe,IAAI;EACxD,cAAc,MAAc,IAAI,UAAU,KAAK,IAAI,IAAI,GAAG,EAAE,GAAG,UAAU,KAAK,IAAI,IAAI,GAAG,EAAE;EAC3F,gBAAgB,MAAc;GAE5B,MAAM,KADK,UACK;AAChB,UAAO,IAAI,KACN,KAAK,IAAI,IAAI,GAAG,EAAE,KAAK,KAAK,KAAK,IAAI,IAAI,MAAO,KAChD,KAAK,IAAI,IAAI,IAAI,GAAG,EAAE,KAAK,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,KAAK;;EAEtE"}

package/dist/helper/vue.d.ts

@@ -0,0 +1,44 @@
+import { ShallowRef, VNode, VNodeArrayChildren } from "vue";
+
+//#region src/helper/vue.d.ts
+interface TextVNode extends VNode {
+  children: string;
+}
+/**
+ * 是否为文本
+ * @param node
+ * @returns
+ */
+declare function isTextNode(node: VNode): node is TextVNode;
+/**
+ * 是否为片段
+ * @param node
+ * @returns
+ */
+declare function isFragment(node: any): node is VNode;
+interface CommentVNode extends VNode {
+  children: string;
+}
+/**
+ * 是否为注释
+ * @param node
+ * @returns
+ */
+declare function isComment(node: VNode): node is CommentVNode;
+/**
+ * 是否为模板
+ * @param node
+ * @returns
+ */
+declare function isTemplate(node: unknown): node is VNode;
+/**
+ * 提取常规虚拟节点(移除type为fragment、template的节点)
+ * @param nodes VNodeArrayChildren
+ * @param results 虚拟节点
+ * @returns
+ */
+declare function extractNormalVNodes(nodes: VNodeArrayChildren, results?: VNode[]): VNode[];
+declare function shallowComputed<T>(getter: () => T): ShallowRef<T>;
+//#endregion
+export { extractNormalVNodes, isComment, isFragment, isTemplate, isTextNode, shallowComputed };
+//# sourceMappingURL=vue.d.ts.map

package/dist/helper/vue.js

@@ -0,0 +1,62 @@
+import { Comment, Fragment, Text, createTextVNode, isVNode, shallowRef, watch } from "vue";
+//#region src/helper/vue.ts
+/**
+* 是否为文本
+* @param node
+* @returns
+*/
+function isTextNode(node) {
+	return node.type === Text;
+}
+/**
+* 是否为片段
+* @param node
+* @returns
+*/
+function isFragment(node) {
+	return node && node.type === Fragment;
+}
+/**
+* 是否为注释
+* @param node
+* @returns
+*/
+function isComment(node) {
+	return node.type === Comment;
+}
+/**
+* 是否为模板
+* @param node
+* @returns
+*/
+function isTemplate(node) {
+	return isVNode(node) && node.type === "template";
+}
+/**
+* 提取常规虚拟节点(移除type为fragment、template的节点)
+* @param nodes VNodeArrayChildren
+* @param results 虚拟节点
+* @returns
+*/
+function extractNormalVNodes(nodes, results = []) {
+	nodes.forEach((node) => {
+		if (!isVNode(node)) {
+			if (typeof node === "string" || typeof node === "number") results.push(createTextVNode(String(node)));
+			return;
+		}
+		if ((isFragment(node) || isTemplate(node)) && Array.isArray(node.children)) extractNormalVNodes(node.children, results);
+		else results.push(node);
+	});
+	return results;
+}
+function shallowComputed(getter) {
+	const result = shallowRef(getter());
+	watch(getter, (value) => {
+		result.value = value;
+	});
+	return result;
+}
+//#endregion
+export { extractNormalVNodes, isComment, isFragment, isTemplate, isTextNode, shallowComputed };
+
+//# sourceMappingURL=vue.js.map

package/dist/helper/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":[],"sources":["../../src/helper/vue.ts"],"sourcesContent":["import {\n  Text,\n  Fragment,\n  Comment,\n  type VNode,\n  isVNode,\n  createTextVNode,\n  type VNodeArrayChildren,\n  shallowRef,\n  watch,\n  type ShallowRef\n} from 'vue'\n\ninterface TextVNode extends VNode {\n  children: string\n}\n\n/**\n * 是否为文本\n * @param node\n * @returns\n */\nexport function isTextNode(node: VNode): node is TextVNode {\n  return node.type === Text\n}\n\n/**\n * 是否为片段\n * @param node\n * @returns\n */\nexport function isFragment(node: any): node is VNode {\n  return node && node.type === Fragment\n}\n\ninterface CommentVNode extends VNode {\n  children: string\n}\n\n/**\n * 是否为注释\n * @param node\n * @returns\n */\nexport function isComment(node: VNode): node is CommentVNode {\n  return node.type === Comment\n}\n\n/**\n * 是否为模板\n * @param node\n * @returns\n */\nexport function isTemplate(node: unknown): node is VNode {\n  return isVNode(node) && node.type === 'template'\n}\n\n/**\n * 提取常规虚拟节点(移除type为fragment、template的节点)\n * @param nodes VNodeArrayChildren\n * @param results 虚拟节点\n * @returns\n */\nexport function extractNormalVNodes(nodes: VNodeArrayChildren, results: VNode[] = []): VNode[] {\n  nodes.forEach((node) => {\n    if (!isVNode(node)) {\n      if (typeof node === 'string' || typeof node === 'number') {\n        results.push(createTextVNode(String(node)))\n      }\n      return\n    }\n    if ((isFragment(node) || isTemplate(node)) && Array.isArray(node.children)) {\n      extractNormalVNodes(node.children, results)\n    } else {\n      results.push(node)\n    }\n  })\n  return results\n}\n\nexport function shallowComputed<T>(getter: () => T): ShallowRef<T> {\n  const result = shallowRef<T>(getter())\n  watch(getter, (value) => {\n    result.value = value\n  })\n\n  return result\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,WAAW,MAAgC;AACzD,QAAO,KAAK,SAAS;;;;;;;AAQvB,SAAgB,WAAW,MAA0B;AACnD,QAAO,QAAQ,KAAK,SAAS;;;;;;;AAY/B,SAAgB,UAAU,MAAmC;AAC3D,QAAO,KAAK,SAAS;;;;;;;AAQvB,SAAgB,WAAW,MAA8B;AACvD,QAAO,QAAQ,KAAK,IAAI,KAAK,SAAS;;;;;;;;AASxC,SAAgB,oBAAoB,OAA2B,UAAmB,EAAE,EAAW;AAC7F,OAAM,SAAS,SAAS;AACtB,MAAI,CAAC,QAAQ,KAAK,EAAE;AAClB,OAAI,OAAO,SAAS,YAAY,OAAO,SAAS,SAC9C,SAAQ,KAAK,gBAAgB,OAAO,KAAK,CAAC,CAAC;AAE7C;;AAEF,OAAK,WAAW,KAAK,IAAI,WAAW,KAAK,KAAK,MAAM,QAAQ,KAAK,SAAS,CACxE,qBAAoB,KAAK,UAAU,QAAQ;MAE3C,SAAQ,KAAK,KAAK;GAEpB;AACF,QAAO;;AAGT,SAAgB,gBAAmB,QAAgC;CACjE,MAAM,SAAS,WAAc,QAAQ,CAAC;AACtC,OAAM,SAAS,UAAU;AACvB,SAAO,QAAQ;GACf;AAEF,QAAO"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { BEM, BEMFactory, makeBEM } from "./helper/make-bem.js";
+import { CLS_PREFIX, FORM_EMPTY_CONTENT, NAME_SPACE } from "./shared/constants.js";
+import { addClass, bem, removeClass } from "./dom/class-name.js";
+import { getHighlightChunks } from "./dom/highlight.js";
+import { getNearestScrollParent, getScrollParents, scrollIntoContainerView } from "./dom/position.js";
+import { removeStyles, setStyles, withUnit } from "./dom/style.js";
+import { zIndex } from "./dom/z-index.js";
+import { Data, PresetRule, ValidateRule, ValidatorConfig } from "./types/utils/form/validate.js";
+import { Validator } from "./form/validate.js";
+import { createIncrease } from "./helper/create-increase.js";
+import { createToggle } from "./helper/create-toggle.js";
+import { AnimeConfig, Tween, TweenConfig } from "./helper/tween.js";
+import { nextFrame } from "./helper/frame.js";
+import { extractNormalVNodes, isComment, isFragment, isTemplate, isTextNode, shallowComputed } from "./helper/vue.js";
+import { middleProxy } from "./reactive/proxy.js";
+import { DeconstructValue, DefineEvent, Index, Null, RenderReturn, Undef } from "./types/helper.js";
+import { BreakpointName, ColorType, ComponentProps, ComponentSize, FormComponentProps, PropsWithServerQuery } from "./types/component-common.js";
+import { FormContextInjectProps } from "./types/form-context.js";
+export { AnimeConfig, BEM, BEMFactory, BreakpointName, CLS_PREFIX, ColorType, ComponentProps, ComponentSize, Data, DeconstructValue, DefineEvent, FORM_EMPTY_CONTENT, FormComponentProps, FormContextInjectProps, Index, NAME_SPACE, Null, PresetRule, PropsWithServerQuery, RenderReturn, Tween, TweenConfig, Undef, ValidateRule, Validator, ValidatorConfig, addClass, bem, createIncrease, createToggle, extractNormalVNodes, getHighlightChunks, getNearestScrollParent, getScrollParents, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, removeClass, removeStyles, scrollIntoContainerView, setStyles, shallowComputed, withUnit, zIndex };

package/dist/index.js

@@ -0,0 +1,15 @@
+import { makeBEM } from "./helper/make-bem.js";
+import { CLS_PREFIX, FORM_EMPTY_CONTENT, NAME_SPACE } from "./shared/constants.js";
+import { addClass, bem, removeClass } from "./dom/class-name.js";
+import { getHighlightChunks } from "./dom/highlight.js";
+import { getNearestScrollParent, getScrollParents, scrollIntoContainerView } from "./dom/position.js";
+import { removeStyles, setStyles, withUnit } from "./dom/style.js";
+import { createIncrease } from "./helper/create-increase.js";
+import { zIndex } from "./dom/z-index.js";
+import { Validator } from "./form/validate.js";
+import { createToggle } from "./helper/create-toggle.js";
+import { Tween } from "./helper/tween.js";
+import { nextFrame } from "./helper/frame.js";
+import { extractNormalVNodes, isComment, isFragment, isTemplate, isTextNode, shallowComputed } from "./helper/vue.js";
+import { middleProxy } from "./reactive/proxy.js";
+export { CLS_PREFIX, FORM_EMPTY_CONTENT, NAME_SPACE, Tween, Validator, addClass, bem, createIncrease, createToggle, extractNormalVNodes, getHighlightChunks, getNearestScrollParent, getScrollParents, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, removeClass, removeStyles, scrollIntoContainerView, setStyles, shallowComputed, withUnit, zIndex };

package/dist/reactive/proxy.d.ts

@@ -0,0 +1,19 @@
+//#region src/reactive/proxy.d.ts
+/**
+ * 中间代理, 用于vue的reactive和shallowReactive方法的中间层
+ * @param o 代理对象
+ * @param config 代理配置
+ * @returns
+ */
+declare function middleProxy<O extends Record<string, any>>(o: O, handler?: {
+  set?: (field: string, val: any) => void;
+  get?: (field: string) => any;
+  /**
+   * 数值变更回调，传入的参数是本次模型值变更的所有字段
+   * @param fields 变更的字段
+   */
+  changed?: (fields: string[]) => void;
+}): O;
+//#endregion
+export { middleProxy };
+//# sourceMappingURL=proxy.d.ts.map

package/dist/reactive/proxy.js

@@ -0,0 +1,57 @@
+//#region src/reactive/proxy.ts
+/**
+* 创建一个介于vue的reactive和shallowReactive对象的中间层
+* @description
+* 如果对象含有嵌套对象，则**递归**进行中间代理
+*
+* @param o 代理对象
+* @param handler 处理函数
+* @param options 代理配置
+* @returns 中间代理对象
+*/
+function createMiddleProxy(o, handler, options) {
+	let { weakMap, parentsField, changedFields = [] } = options || {};
+	if (!weakMap) weakMap = /* @__PURE__ */ new WeakMap();
+	return new Proxy(o, {
+		set(target, field, val) {
+			const changedField = parentsField ? `${parentsField}.${field}` : field;
+			handler?.set?.(changedField, val);
+			target[field] = val;
+			changedFields.push(changedField);
+			Promise.resolve().then(() => {
+				if (!changedFields.length) return;
+				handler?.changed?.([...changedFields]);
+				changedFields.splice(0);
+			});
+			return true;
+		},
+		get(target, field) {
+			handler?.get?.(field);
+			const val = target[field];
+			if (val !== null && typeof val === "object" && !(val instanceof Date) && !(val instanceof RegExp)) {
+				if (weakMap.has(val)) return weakMap.get(val);
+				const valProxy = createMiddleProxy(val, handler, {
+					weakMap,
+					parentsField: parentsField ? `${parentsField}.${field}` : field,
+					changedFields
+				});
+				weakMap.set(val, valProxy);
+				return valProxy;
+			}
+			return val;
+		}
+	});
+}
+/**
+* 中间代理, 用于vue的reactive和shallowReactive方法的中间层
+* @param o 代理对象
+* @param config 代理配置
+* @returns
+*/
+function middleProxy(o, handler) {
+	return createMiddleProxy(o, handler);
+}
+//#endregion
+export { middleProxy };
+
+//# sourceMappingURL=proxy.js.map

package/dist/reactive/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","names":[],"sources":["../../src/reactive/proxy.ts"],"sourcesContent":["/**\n * 创建一个介于vue的reactive和shallowReactive对象的中间层\n * @description\n * 如果对象含有嵌套对象，则**递归**进行中间代理\n *\n * @param o 代理对象\n * @param handler 处理函数\n * @param options 代理配置\n * @returns 中间代理对象\n */\nfunction createMiddleProxy(\n  o: Record<string, any>,\n  handler?: {\n    set?: (field: string, val: any) => void\n    get?: (field: string) => any\n    changed?: (fields: string[]) => void\n  },\n  options?: {\n    weakMap?: WeakMap<Record<string, any>, any>\n    parentsField?: string\n    changedFields?: string[]\n  }\n) {\n  let { weakMap, parentsField, changedFields = [] } = options || {}\n  if (!weakMap) {\n    weakMap = new WeakMap()\n  }\n\n  return new Proxy(o, {\n    set(target, field: string, val) {\n      const changedField = parentsField ? `${parentsField}.${field}` : field\n      handler?.set?.(changedField, val)\n      target[field] = val\n\n      changedFields.push(changedField)\n      Promise.resolve().then(() => {\n        if (!changedFields.length) return\n        handler?.changed?.([...changedFields])\n        changedFields.splice(0)\n      })\n\n      return true\n    },\n\n    get(target, field: string) {\n      handler?.get?.(field)\n\n      const val = target[field]\n      if (\n        val !== null &&\n        typeof val === 'object' &&\n        !(val instanceof Date) &&\n        !(val instanceof RegExp)\n      ) {\n        if (weakMap.has(val)) return weakMap.get(val)\n        const valProxy = createMiddleProxy(val, handler, {\n          weakMap,\n          parentsField: parentsField ? `${parentsField}.${field}` : field,\n          changedFields\n        })\n        weakMap.set(val, valProxy)\n\n        return valProxy\n      }\n\n      return val\n    }\n  })\n}\n\n/**\n * 中间代理, 用于vue的reactive和shallowReactive方法的中间层\n * @param o 代理对象\n * @param config 代理配置\n * @returns\n */\nexport function middleProxy<O extends Record<string, any>>(\n  o: O,\n  handler?: {\n    set?: (field: string, val: any) => void\n    get?: (field: string) => any\n    /**\n     * 数值变更回调，传入的参数是本次模型值变更的所有字段\n     * @param fields 变更的字段\n     */\n    changed?: (fields: string[]) => void\n  }\n): O {\n  return createMiddleProxy(o, handler) as O\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAS,kBACP,GACA,SAKA,SAKA;CACA,IAAI,EAAE,SAAS,cAAc,gBAAgB,EAAE,KAAK,WAAW,EAAE;AACjE,KAAI,CAAC,QACH,2BAAU,IAAI,SAAS;AAGzB,QAAO,IAAI,MAAM,GAAG;EAClB,IAAI,QAAQ,OAAe,KAAK;GAC9B,MAAM,eAAe,eAAe,GAAG,aAAa,GAAG,UAAU;AACjE,YAAS,MAAM,cAAc,IAAI;AACjC,UAAO,SAAS;AAEhB,iBAAc,KAAK,aAAa;AAChC,WAAQ,SAAS,CAAC,WAAW;AAC3B,QAAI,CAAC,cAAc,OAAQ;AAC3B,aAAS,UAAU,CAAC,GAAG,cAAc,CAAC;AACtC,kBAAc,OAAO,EAAE;KACvB;AAEF,UAAO;;EAGT,IAAI,QAAQ,OAAe;AACzB,YAAS,MAAM,MAAM;GAErB,MAAM,MAAM,OAAO;AACnB,OACE,QAAQ,QACR,OAAO,QAAQ,YACf,EAAE,eAAe,SACjB,EAAE,eAAe,SACjB;AACA,QAAI,QAAQ,IAAI,IAAI,CAAE,QAAO,QAAQ,IAAI,IAAI;IAC7C,MAAM,WAAW,kBAAkB,KAAK,SAAS;KAC/C;KACA,cAAc,eAAe,GAAG,aAAa,GAAG,UAAU;KAC1D;KACD,CAAC;AACF,YAAQ,IAAI,KAAK,SAAS;AAE1B,WAAO;;AAGT,UAAO;;EAEV,CAAC;;;;;;;;AASJ,SAAgB,YACd,GACA,SASG;AACH,QAAO,kBAAkB,GAAG,QAAQ"}

package/dist/shared/constants.d.ts

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

package/dist/shared/constants.js

@@ -0,0 +1,11 @@
+//#region 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/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/shared/constants.ts"],"sourcesContent":["/** 命名前缀 */\nexport const NAME_SPACE = 'U'\n\n/** 类前缀 */\nexport const CLS_PREFIX = `${NAME_SPACE.toLowerCase()}-` as 'u-'\n\n/** 表单空内容 */\nexport const FORM_EMPTY_CONTENT = '-'\n"],"mappings":";;AACA,MAAa,aAAa;;AAG1B,MAAa,aAAa,GAAA,IAAc,aAAa,CAAC;;AAGtD,MAAa,qBAAqB"}

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

@@ -0,0 +1,37 @@
+//#region src/types/component-common.d.ts
+type ComponentSize = 'small' | 'default' | 'large';
+type ColorType = 'primary' | 'info' | 'success' | 'warning' | 'danger';
+/** 断点名称 */
+type BreakpointName = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** 组件通用属性 */
+interface ComponentProps {
+  /** 组件尺寸 */
+  size?: ComponentSize;
+}
+/** 表单组件通用属性 */
+interface FormComponentProps extends ComponentProps {
+  /** 在表单控件内时的提示 */
+  tips?: string;
+  /** 所占列的大小 */
+  span?: number | 'full' | ({ [key in BreakpointName]?: 'full' | number } & {
+    default: number | 'full';
+  });
+  /** 表单标签文字 */
+  label?: string;
+  /** 表单项字段 */
+  field?: string;
+  /** 是否禁用 */
+  disabled?: boolean;
+  /** 是否只读 */
+  readonly?: boolean;
+}
+/** 带有服务端交互功能的组件属性 */
+interface PropsWithServerQuery {
+  /** 请求接口地址 */
+  api?: string;
+  /** 请求查询参数 */
+  query?: Record<string, any>;
+}
+//#endregion
+export { BreakpointName, ColorType, ComponentProps, ComponentSize, FormComponentProps, PropsWithServerQuery };
+//# sourceMappingURL=component-common.d.ts.map

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

@@ -0,0 +1,6 @@
+//#region src/types/form-context.d.ts
+/** 表单 provide/inject 上下文（完整 props 见 @veltra/desktop/types/form） */
+type FormContextInjectProps = Record<string, unknown>;
+//#endregion
+export { FormContextInjectProps };
+//# sourceMappingURL=form-context.d.ts.map

package/dist/types/helper.d.ts

@@ -0,0 +1,22 @@
+import { VNode } from "vue";
+
+//#region src/types/helper.d.ts
+type Null<T> = null | T;
+type Undef<T> = undefined | T;
+/** 自定义事件, 可以指定target类型 */
+interface DefineEvent<T = HTMLElement> extends Omit<Event, 'target'> {
+  target: T;
+}
+/** 解构VueExpose中被引用的实例 */
+type DeconstructValue<E extends Record<string, any>> = { [K in keyof E]: E[K] extends {
+  value: infer V;
+} ? V : E[K] };
+/** 索引类型 */
+type Index<Keys extends string, Val> = { [key in Keys]?: Val };
+/**
+ * 渲染函数返回内容
+ */
+type RenderReturn = (undefined | VNode | string | null | number)[] | undefined | VNode | string | null | number;
+//#endregion
+export { DeconstructValue, DefineEvent, Index, Null, RenderReturn, Undef };
+//# sourceMappingURL=helper.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+import { Data, PresetRule, ValidateRule, ValidatorConfig } from "./utils/form/validate.js";
+import { DeconstructValue, DefineEvent, Index, Null, RenderReturn, Undef } from "./helper.js";
+import { BreakpointName, ColorType, ComponentProps, ComponentSize, FormComponentProps, PropsWithServerQuery } from "./component-common.js";
+import { FormContextInjectProps } from "./form-context.js";
+export { BreakpointName, ColorType, ComponentProps, ComponentSize, Data, DeconstructValue, DefineEvent, FormComponentProps, FormContextInjectProps, Index, Null, PresetRule, PropsWithServerQuery, RenderReturn, Undef, ValidateRule, ValidatorConfig };

package/dist/types/utils/form/validate.d.ts

@@ -0,0 +1,34 @@
+//#region src/types/utils/form/validate.d.ts
+type Data = Record<string, any>;
+type PresetRule = 'email' | 'phone' | 'num' | 'url' | 'idCard';
+/** 字段校验规则 */
+interface ValidateRule {
+  /** 是否必填 */
+  required?: boolean | string;
+  /** 长度单位 */
+  length?: number | [number, string];
+  /** 最小值 */
+  min?: number | [number, string];
+  /** 最大值 */
+  max?: number | [number, string];
+  /** 最小长度 */
+  minLen?: number | [number, string];
+  /** 最大长度 */
+  maxLen?: number | [number, string];
+  /** 匹配 */
+  match?: RegExp | [RegExp, string] | string;
+  /** 预设 */
+  preset?: PresetRule;
+  /** 自定义校验 */
+  validator?: (value: any, data: Data) => Promise<string> | string;
+}
+interface ValidatorConfig {
+  /**
+   * 是否懒校验，为true时在任意一个字段的的任意规则校验不通过时立马结束校验，性能稍微高一点，但是不能得出所有的错误
+   * @default true
+   */
+  lazy?: boolean;
+}
+//#endregion
+export { Data, PresetRule, ValidateRule, ValidatorConfig };
+//# sourceMappingURL=validate.d.ts.map