@veltra/utils 1.12.1 → 1.13.0

package/dist/helper/vue.d.ts

@@ -39,6 +39,16 @@ export declare function isTemplate(node: unknown): node is VNode;
 export declare function extractNormalVNodes(nodes: VNodeArrayChildren, results?: VNode[]): VNode[];
 /** 字段名：空串 / null / undefined 时回退默认值 */
 export declare function fieldKey(key: string | null | undefined, fallback: string): string;
+/**
+ * 按 labelTemplate 渲染选项展示文案
+ * @description `{fieldKey}` 占位符按行字段取值（链式取值，支持嵌套路径），
+ * 取不到值（字段缺失 / null / 空串）的占位符按空串处理；
+ * 只要有字段未命中即返回 undefined，由调用方回退 `row[labelKey]`，
+ * 避免「文本（）」这类残缺展示。渲染期格式化，不改写行数据。
+ * @param template 模板串，如 `{label}（{code}）`；空值直接返回 undefined
+ * @param row 选项行数据
+ */
+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
 //# sourceMappingURL=vue.d.ts.map

package/dist/helper/vue.js

@@ -1,3 +1,4 @@
+import { o } from "@cat-kit/core";
 import { Comment, Fragment, Text, createTextVNode, isVNode, shallowRef, watch } from "vue";
 //#region src/helper/vue.ts
 /**
@@ -53,6 +54,30 @@ function extractNormalVNodes(nodes, results = []) {
 function fieldKey(key, fallback) {
 	return key ? key : fallback;
 }
+/** labelTemplate 占位符：{fieldKey}，支持嵌套路径 */
+const LABEL_TEMPLATE_RE = /\{([^{}]+)\}/g;
+/**
+* 按 labelTemplate 渲染选项展示文案
+* @description `{fieldKey}` 占位符按行字段取值（链式取值，支持嵌套路径），
+* 取不到值（字段缺失 / null / 空串）的占位符按空串处理；
+* 只要有字段未命中即返回 undefined，由调用方回退 `row[labelKey]`，
+* 避免「文本（）」这类残缺展示。渲染期格式化，不改写行数据。
+* @param template 模板串，如 `{label}（{code}）`；空值直接返回 undefined
+* @param row 选项行数据
+*/
+function renderLabelTemplate(template, row) {
+	if (!template || !row) return void 0;
+	let missing = false;
+	const text = template.replace(LABEL_TEMPLATE_RE, (_, key) => {
+		const value = o(row).get(key);
+		if (value === void 0 || value === null || value === "") {
+			missing = true;
+			return "";
+		}
+		return String(value);
+	});
+	return missing ? void 0 : text;
+}
 function shallowComputed(getter) {
 	const result = shallowRef(getter());
 	watch(getter, (value) => {
@@ -61,6 +86,6 @@ function shallowComputed(getter) {
 	return result;
 }
 //#endregion
-export { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, shallowComputed };
+export { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, renderLabelTemplate, shallowComputed };
 
 //# sourceMappingURL=vue.js.map

package/dist/helper/vue.js.map

@@ -1 +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\n/** 字段名：空串 / null / undefined 时回退默认值 */\nexport function fieldKey(key: string | null | undefined, fallback: string): string {\n  return key ? key : fallback\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;CACzD,OAAO,KAAK,SAAS;AACvB;;;;;;AAOA,SAAgB,WAAW,MAA0B;CACnD,OAAO,QAAQ,KAAK,SAAS;AAC/B;;;;;;AAWA,SAAgB,UAAU,MAAmC;CAC3D,OAAO,KAAK,SAAS;AACvB;;;;;;AAOA,SAAgB,WAAW,MAA8B;CACvD,OAAO,QAAQ,IAAI,KAAK,KAAK,SAAS;AACxC;;;;;;;AAQA,SAAgB,oBAAoB,OAA2B,UAAmB,CAAC,GAAY;CAC7F,MAAM,SAAS,SAAS;EACtB,IAAI,CAAC,QAAQ,IAAI,GAAG;GAClB,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAC9C,QAAQ,KAAK,gBAAgB,OAAO,IAAI,CAAC,CAAC;GAE5C;EACF;EACA,KAAK,WAAW,IAAI,KAAK,WAAW,IAAI,MAAM,MAAM,QAAQ,KAAK,QAAQ,GACvE,oBAAoB,KAAK,UAAU,OAAO;OAE1C,QAAQ,KAAK,IAAI;CAErB,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,SAAS,KAAgC,UAA0B;CACjF,OAAO,MAAM,MAAM;AACrB;AAEA,SAAgB,gBAAmB,QAAgC;CACjE,MAAM,SAAS,WAAc,OAAO,CAAC;CACrC,MAAM,SAAS,UAAU;EACvB,OAAO,QAAQ;CACjB,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"vue.js","names":[],"sources":["../../src/helper/vue.ts"],"sourcesContent":["import { o } from '@cat-kit/core'\nimport {\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\n/** 字段名：空串 / null / undefined 时回退默认值 */\nexport function fieldKey(key: string | null | undefined, fallback: string): string {\n  return key ? key : fallback\n}\n\n/** labelTemplate 占位符：{fieldKey}，支持嵌套路径 */\nconst LABEL_TEMPLATE_RE = /\\{([^{}]+)\\}/g\n\n/**\n * 按 labelTemplate 渲染选项展示文案\n * @description `{fieldKey}` 占位符按行字段取值（链式取值，支持嵌套路径），\n * 取不到值（字段缺失 / null / 空串）的占位符按空串处理；\n * 只要有字段未命中即返回 undefined，由调用方回退 `row[labelKey]`，\n * 避免「文本（）」这类残缺展示。渲染期格式化，不改写行数据。\n * @param template 模板串，如 `{label}（{code}）`；空值直接返回 undefined\n * @param row 选项行数据\n */\nexport function renderLabelTemplate(\n  template: string | undefined,\n  row: Record<string, any> | undefined | null\n): string | undefined {\n  if (!template || !row) return undefined\n\n  let missing = false\n  const text = template.replace(LABEL_TEMPLATE_RE, (_, key: string) => {\n    const value = o(row).get(key)\n    if (value === undefined || value === null || value === '') {\n      missing = true\n      return ''\n    }\n    return String(value)\n  })\n\n  return missing ? undefined : text\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":";;;;;;;;AAuBA,SAAgB,WAAW,MAAgC;CACzD,OAAO,KAAK,SAAS;AACvB;;;;;;AAOA,SAAgB,WAAW,MAA0B;CACnD,OAAO,QAAQ,KAAK,SAAS;AAC/B;;;;;;AAWA,SAAgB,UAAU,MAAmC;CAC3D,OAAO,KAAK,SAAS;AACvB;;;;;;AAOA,SAAgB,WAAW,MAA8B;CACvD,OAAO,QAAQ,IAAI,KAAK,KAAK,SAAS;AACxC;;;;;;;AAQA,SAAgB,oBAAoB,OAA2B,UAAmB,CAAC,GAAY;CAC7F,MAAM,SAAS,SAAS;EACtB,IAAI,CAAC,QAAQ,IAAI,GAAG;GAClB,IAAI,OAAO,SAAS,YAAY,OAAO,SAAS,UAC9C,QAAQ,KAAK,gBAAgB,OAAO,IAAI,CAAC,CAAC;GAE5C;EACF;EACA,KAAK,WAAW,IAAI,KAAK,WAAW,IAAI,MAAM,MAAM,QAAQ,KAAK,QAAQ,GACvE,oBAAoB,KAAK,UAAU,OAAO;OAE1C,QAAQ,KAAK,IAAI;CAErB,CAAC;CACD,OAAO;AACT;;AAGA,SAAgB,SAAS,KAAgC,UAA0B;CACjF,OAAO,MAAM,MAAM;AACrB;;AAGA,MAAM,oBAAoB;;;;;;;;;;AAW1B,SAAgB,oBACd,UACA,KACoB;CACpB,IAAI,CAAC,YAAY,CAAC,KAAK,OAAO,KAAA;CAE9B,IAAI,UAAU;CACd,MAAM,OAAO,SAAS,QAAQ,oBAAoB,GAAG,QAAgB;EACnE,MAAM,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG;EAC5B,IAAI,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,IAAI;GACzD,UAAU;GACV,OAAO;EACT;EACA,OAAO,OAAO,KAAK;CACrB,CAAC;CAED,OAAO,UAAU,KAAA,IAAY;AAC/B;AAEA,SAAgB,gBAAmB,QAAgC;CACjE,MAAM,SAAS,WAAc,OAAO,CAAC;CACrC,MAAM,SAAS,UAAU;EACvB,OAAO,QAAQ;CACjB,CAAC;CAED,OAAO;AACT"}

package/dist/index.d.ts

@@ -14,10 +14,10 @@ import { createToggle } from "./helper/create-toggle.js";
 import { AnimeConfig, Tween, TweenConfig } from "./helper/tween.js";
 import { nextFrame } from "./helper/frame.js";
 import { OverflowNavState, OverflowNavViewport, applyWheelHorizontalScroll, computeOverflowNavState, scrollElementIntoView, scrollViewportByStep } from "./helper/overflow-nav.js";
-import { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, shallowComputed } from "./helper/vue.js";
+import { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, renderLabelTemplate, 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, PresetRule, PropsWithServerQuery, ValidateRule } from "./types/component-common.js";
 import { FormContextModel, FormContextProps, FormFieldItem, injectFormContext, provideFormContext } from "./types/form-context.js";
 import "./types/index.js";
-export { AiMessage, AiProviderConfig, AiStreamHandlers, AiTextRequestOptions, AiTokenUsage, AiTool, AiToolCall, AnimeConfig, BEM, BEMFactory, BreakpointName, CLS_PREFIX, ColorType, ComponentProps, ComponentSize, DeconstructValue, DefineEvent, ExpandTransition, ExpandTransitionOptions, FORM_EMPTY_CONTENT, FormComponentProps, FormContextModel, FormContextProps, FormFieldItem, Index, NAME_SPACE, Null, OpenAIBodyOptions, OpenAIRequestOptions, OpenAIStreamCallbacks, OverflowNavState, OverflowNavViewport, PresetRule, PropsWithServerQuery, RenderReturn, Tween, TweenConfig, Undef, ValidateRule, addClass, applyWheelHorizontalScroll, bem, buildOpenAIBody, computeOverflowNavState, createIncrease, createToggle, extractNormalVNodes, fieldKey, getHighlightChunks, getNearestScrollParent, getScrollParents, injectFormContext, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, parseOpenAICompletionText, parseOpenAISSEStream, provideFormContext, removeClass, removeStyles, requestAiText, requestOpenAIStream, scrollElementIntoView, scrollIntoContainerView, scrollViewportByStep, setStyles, shallowComputed, withUnit, zIndex };
+export { AiMessage, AiProviderConfig, AiStreamHandlers, AiTextRequestOptions, AiTokenUsage, AiTool, AiToolCall, AnimeConfig, BEM, BEMFactory, BreakpointName, CLS_PREFIX, ColorType, ComponentProps, ComponentSize, DeconstructValue, DefineEvent, ExpandTransition, ExpandTransitionOptions, FORM_EMPTY_CONTENT, FormComponentProps, FormContextModel, FormContextProps, FormFieldItem, Index, NAME_SPACE, Null, OpenAIBodyOptions, OpenAIRequestOptions, OpenAIStreamCallbacks, OverflowNavState, OverflowNavViewport, PresetRule, PropsWithServerQuery, RenderReturn, Tween, TweenConfig, Undef, ValidateRule, addClass, applyWheelHorizontalScroll, bem, buildOpenAIBody, computeOverflowNavState, createIncrease, createToggle, extractNormalVNodes, fieldKey, getHighlightChunks, getNearestScrollParent, getScrollParents, injectFormContext, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, parseOpenAICompletionText, parseOpenAISSEStream, provideFormContext, removeClass, removeStyles, renderLabelTemplate, requestAiText, requestOpenAIStream, scrollElementIntoView, scrollIntoContainerView, scrollViewportByStep, setStyles, shallowComputed, withUnit, zIndex };

package/dist/index.js

@@ -13,7 +13,7 @@ import { createToggle } from "./helper/create-toggle.js";
 import { Tween } from "./helper/tween.js";
 import { nextFrame } from "./helper/frame.js";
 import { applyWheelHorizontalScroll, computeOverflowNavState, scrollElementIntoView, scrollViewportByStep } from "./helper/overflow-nav.js";
-import { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, shallowComputed } from "./helper/vue.js";
+import { extractNormalVNodes, fieldKey, isComment, isFragment, isTemplate, isTextNode, renderLabelTemplate, shallowComputed } from "./helper/vue.js";
 import { middleProxy } from "./reactive/proxy.js";
 import { injectFormContext, provideFormContext } from "./types/form-context.js";
-export { CLS_PREFIX, ExpandTransition, FORM_EMPTY_CONTENT, NAME_SPACE, Tween, addClass, applyWheelHorizontalScroll, bem, buildOpenAIBody, computeOverflowNavState, createIncrease, createToggle, extractNormalVNodes, fieldKey, getHighlightChunks, getNearestScrollParent, getScrollParents, injectFormContext, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, parseOpenAICompletionText, parseOpenAISSEStream, provideFormContext, removeClass, removeStyles, requestAiText, requestOpenAIStream, scrollElementIntoView, scrollIntoContainerView, scrollViewportByStep, setStyles, shallowComputed, withUnit, zIndex };
+export { CLS_PREFIX, ExpandTransition, FORM_EMPTY_CONTENT, NAME_SPACE, Tween, addClass, applyWheelHorizontalScroll, bem, buildOpenAIBody, computeOverflowNavState, createIncrease, createToggle, extractNormalVNodes, fieldKey, getHighlightChunks, getNearestScrollParent, getScrollParents, injectFormContext, isComment, isFragment, isTemplate, isTextNode, makeBEM, middleProxy, nextFrame, parseOpenAICompletionText, parseOpenAISSEStream, provideFormContext, removeClass, removeStyles, renderLabelTemplate, requestAiText, requestOpenAIStream, scrollElementIntoView, scrollIntoContainerView, scrollViewportByStep, setStyles, shallowComputed, withUnit, zIndex };

package/package.json

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

package/src/helper/vue.ts

@@ -1,3 +1,4 @@
+import { o } from '@cat-kit/core'
 import {
   Text,
   Fragment,
@@ -83,6 +84,37 @@ export function fieldKey(key: string | null | undefined, fallback: string): stri
   return key ? key : fallback
 }
 
+/** labelTemplate 占位符：{fieldKey}，支持嵌套路径 */
+const LABEL_TEMPLATE_RE = /\{([^{}]+)\}/g
+
+/**
+ * 按 labelTemplate 渲染选项展示文案
+ * @description `{fieldKey}` 占位符按行字段取值（链式取值，支持嵌套路径），
+ * 取不到值（字段缺失 / null / 空串）的占位符按空串处理；
+ * 只要有字段未命中即返回 undefined，由调用方回退 `row[labelKey]`，
+ * 避免「文本（）」这类残缺展示。渲染期格式化，不改写行数据。
+ * @param template 模板串，如 `{label}（{code}）`；空值直接返回 undefined
+ * @param row 选项行数据
+ */
+export function renderLabelTemplate(
+  template: string | undefined,
+  row: Record<string, any> | undefined | null
+): string | undefined {
+  if (!template || !row) return undefined
+
+  let missing = false
+  const text = template.replace(LABEL_TEMPLATE_RE, (_, key: string) => {
+    const value = o(row).get(key)
+    if (value === undefined || value === null || value === '') {
+      missing = true
+      return ''
+    }
+    return String(value)
+  })
+
+  return missing ? undefined : text
+}
+
 export function shallowComputed<T>(getter: () => T): ShallowRef<T> {
   const result = shallowRef<T>(getter())
   watch(getter, (value) => {