@nocobase/client-v2 2.1.0-beta.21 → 2.1.0-beta.23

package/src/flow/index.ts

@@ -0,0 +1,108 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { FlowModel } from '@nocobase/flow-engine';
+import { IconPicker } from '../flow-compat';
+import { Plugin, type PluginOptions } from '..';
+import type { BaseApplication } from '../BaseApplication';
+import * as actions from './actions';
+import { DefaultValue } from './components/DefaultValue';
+import FlowRoute from './components/FlowRoute';
+import { FlowModelRepository } from './FlowModelRepository';
+import * as models from './models';
+import * as filterFormActions from './models/blocks/filter-manager/flow-actions';
+import { DynamicFlowsIcon } from './components/DynamicFlowsIcon';
+import { Markdown } from './common/Markdown/Markdown';
+import { LiquidEngine } from './common/Liquid';
+import type { PreviewRunJSResult } from './components/code-editor/runjsDiagnostics';
+import { TextAreaWithContextSelector } from './components/TextAreaWithContextSelector';
+
+export class PluginFlowEngine<TApp extends BaseApplication<any> = BaseApplication<any>> extends Plugin<
+  PluginOptions<any>,
+  TApp
+> {
+  async load() {
+    this.app.addComponents({ FlowRoute });
+    this.app.flowEngine.setModelRepository(new FlowModelRepository(this.app));
+    const filteredModels = Object.fromEntries(
+      Object.entries(models).filter(
+        ([, ModelClass]) => typeof ModelClass === 'function' && ModelClass.prototype instanceof FlowModel,
+      ),
+    ) as Record<string, typeof FlowModel>;
+    this.flowEngine.registerModels(filteredModels);
+    this.flowEngine.registerActions(actions);
+    this.flowEngine.registerActions(filterFormActions as any);
+    this.flowEngine.flowSettings.registerComponents({
+      IconPicker,
+      DefaultValue,
+      FlowSettingsVariableTextArea: TextAreaWithContextSelector,
+    });
+
+    // 动态流编辑入口
+    this.flowEngine.flowSettings.addToolbarItem({
+      key: 'dynamic-flows-editor',
+      component: DynamicFlowsIcon,
+      visible(model) {
+        return model.getEvents().size > 0;
+      },
+      sort: 0,
+    });
+    // 实例化一个全局 Markdown 解析器
+    const markdownInstance = new Markdown();
+    this.flowEngine.context.defineProperty('markdown', {
+      get: () => markdownInstance,
+    });
+
+    // 创建全局实例
+    const liquidInstance = new LiquidEngine({ ctx: this.flowEngine.context });
+
+    // 注册到全局上下文
+    this.flowEngine.context.defineProperty('liquid', {
+      get: () => liquidInstance,
+    });
+
+    this.flowEngine.context.defineMethod(
+      'previewRunJS',
+      async function (this: any, code: string, version?: string): Promise<PreviewRunJSResult> {
+        const mod = await import('./components/code-editor/runjsDiagnostics');
+        return await mod.previewRunJS(String(code ?? ''), this, { version });
+      },
+      {
+        description: 'Preview/diagnose a RunJS snippet (lint + sandbox execution).',
+        detail: '(code: string, version?: string) => Promise<{ success: boolean; message: string }>',
+        params: [
+          { name: 'code', type: 'string', description: 'RunJS code to preview.' },
+          { name: 'version', type: 'string', description: 'RunJS version override (e.g. v1/v2).' },
+        ],
+        returns: { type: 'Promise<PreviewRunJSResult>', description: 'Preview result.' },
+        completion: { insertText: "await ctx.previewRunJS('console.log(1)', 'v2')" },
+      },
+    );
+  }
+}
+
+// Export all models for external use
+export * from './components/filter';
+export * from './components/code-editor';
+export { default as FlowRoute } from './components/FlowRoute';
+export * from './components/TextAreaWithContextSelector';
+export * from './components/SkeletonFallback';
+export * from './FlowModelRepository';
+export * from './FlowPage';
+export * from './models';
+export * from './utils';
+export * from './actions';
+export * from './system-settings';
+export * from './admin-shell/admin-layout';
+export * from './admin-shell/AdminLayoutRouteCoordinator';
+export * from '../settings-center';
+export { openViewFlow } from './flows/openViewFlow';
+export { editMarkdownFlow } from './flows/editMarkdownFlow';
+
+export { TextAreaWithContextSelector } from './components/TextAreaWithContextSelector';

package/src/flow/internal/components/Markdown/DisplayMarkdown.tsx

@@ -0,0 +1,85 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import React, { useRef, useState, useEffect } from 'react';
+import { useParseMarkdown, convertToText } from './util';
+import { useMarkdownStyles } from './style';
+import { Tooltip } from 'antd';
+
+export const DisplayMarkdown = (props) => {
+  const { textOnly, overflowMode, style } = props;
+  const markdownClass = useMarkdownStyles();
+  const { html = '' } = useParseMarkdown(props.value);
+  const text: any = convertToText(html);
+  const isEllipsis = overflowMode === 'ellipsis';
+
+  const contentRef = useRef<HTMLDivElement>(null);
+  const [isOverflowed, setIsOverflowed] = useState(false);
+
+  // 检测内容是否溢出
+  useEffect(() => {
+    if (contentRef.current) {
+      const el = contentRef.current;
+      const overflowed = el.scrollWidth > el.clientWidth || el.scrollHeight > el.clientHeight;
+      setIsOverflowed(overflowed);
+    }
+  }, [html, style, overflowMode]);
+
+  // 通用样式（用于 ellipsis 模式）
+  const baseStyle: React.CSSProperties = {
+    ...(style || {}),
+    ...(isEllipsis
+      ? {
+          display: '-webkit-box',
+          WebkitLineClamp: 1, // 可改为多行省略
+          WebkitBoxOrient: 'vertical',
+          overflow: 'hidden',
+          textOverflow: 'ellipsis',
+          whiteSpace: 'normal',
+          wordBreak: 'break-word',
+          cursor: 'default',
+        }
+      : {}),
+  };
+
+  const content = (
+    <div
+      ref={contentRef}
+      className={`${markdownClass} nb-markdown`}
+      dangerouslySetInnerHTML={{ __html: textOnly ? text : html }}
+      style={baseStyle}
+    />
+  );
+
+  return isEllipsis && isOverflowed ? (
+    <Tooltip
+      title={
+        <div
+          dangerouslySetInnerHTML={{ __html: html }}
+          style={{
+            maxHeight: 500,
+            overflowY: 'auto',
+            padding: 10,
+            color: '#000',
+          }}
+        />
+      }
+      overlayInnerStyle={{
+        background: '#fff',
+        color: '#000',
+        boxShadow: '0 2px 8px rgba(0,0,0,0.15)',
+      }}
+      color="#fff"
+    >
+      {content}
+    </Tooltip>
+  ) : (
+    content
+  );
+};

package/src/flow/internal/components/Markdown/markdown-it-plugins/mermaidPlugin.ts

@@ -0,0 +1,85 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+/* istanbul ignore file -- @preserve */
+// 因为这里有 commonjs，在 vitest 下会报错，所以忽略这个文件
+
+import MarkdownIt from 'markdown-it';
+import Mermaid from 'mermaid';
+
+/**
+ * from https://github.com/agoose77/markdown-it-mermaid
+ */
+
+// Define interface to await readiness of import
+export default function mermaidPlugin(md: MarkdownIt, options: any) {
+  // Setup Mermaid
+  Mermaid.initialize({
+    securityLevel: 'loose',
+    ...options,
+  });
+
+  function getLangName(info: string): string {
+    return info.split(/\s+/g)[0];
+  }
+
+  // Store reference to original renderer.
+  const defaultFenceRenderer = md.renderer.rules.fence;
+
+  // Render custom code types as SVGs, letting the fence parser do all the heavy lifting.
+  function customFenceRenderer(tokens: any[], idx: number, options: any, env: any, slf: any) {
+    const token = tokens[idx];
+    const info = token.info.trim();
+    const langName = info ? getLangName(info) : '';
+
+    if (['mermaid', '{mermaid}'].indexOf(langName) === -1) {
+      if (defaultFenceRenderer !== undefined) {
+        return defaultFenceRenderer(tokens, idx, options, env, slf);
+      }
+      // Missing fence renderer!
+      return '';
+    }
+
+    let imageHTML = '';
+    const imageAttrs: string[][] = [];
+
+    // Create element to render into
+    const element = document.createElement('div');
+    document.body.appendChild(element);
+
+    // Render with Mermaid
+    try {
+      const container_id = 'mermaid-container';
+      Mermaid.mermaidAPI.render(
+        container_id,
+        token.content,
+        (html: string) => {
+          // We need to forcibly extract the max-width/height attributes to set on img tag
+          const svg = document.getElementById(container_id);
+          if (svg !== null) {
+            imageAttrs.push(['style', `max-width:${svg.style.maxWidth};max-height:${svg.style.maxHeight}`]);
+          }
+          // Store HTML
+          imageHTML = html;
+        },
+        element,
+      );
+    } catch (e) {
+      return `<div class="alert alert-danger">${e}</div>`;
+    } finally {
+      element.remove();
+    }
+
+    // Store encoded image data
+    imageAttrs.push(['src', `data:image/svg+xml,${encodeURIComponent(imageHTML)}`]);
+    return `<img ${slf.renderAttrs({ attrs: imageAttrs })}>`;
+  }
+
+  md.renderer.rules.fence = customFenceRenderer;
+}

package/src/flow/internal/components/Markdown/md.ts

@@ -0,0 +1,24 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import MarkdownIt from 'markdown-it';
+import markdownItHighlightjs from 'markdown-it-highlightjs';
+import mermaidPlugin from './markdown-it-plugins/mermaidPlugin';
+
+const md = new MarkdownIt({
+  html: true,
+  linkify: true,
+  typographer: true,
+  breaks: true,
+});
+
+md.use(markdownItHighlightjs);
+md.use(mermaidPlugin);
+
+export default md;

package/src/flow/internal/components/Markdown/style.ts

@@ -0,0 +1,165 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { TinyColor } from '@ctrl/tinycolor';
+import { css } from '@emotion/css';
+import { useFlowContext } from '@nocobase/flow-engine';
+import { theme } from 'antd';
+
+export const useMarkdownStyles = () => {
+  const flowCtx = useFlowContext();
+  const { token } = theme.useToken();
+  const isDarkTheme = !!flowCtx.isDarkTheme;
+
+  const colorFillAlterSolid = new TinyColor(token.colorFillAlter)
+    .onBackground(token.colorBgContainer)
+    .toHexShortString();
+
+  const defaultStyle: any = {
+    lineHeight: 'inherit',
+    // default style of markdown
+    '&.nb-markdown-default': {
+      'pre code.hljs': { display: 'block', overflowX: 'auto', padding: '1em' },
+      'code.hljs': { padding: '3px 5px' },
+      ':not(pre) code': {
+        padding: '2px 5px',
+        color: '#d56161',
+        background: token.colorFillQuaternary,
+        border: `1px solid ${token.colorBorder}`,
+        borderRadius: token.borderRadiusSM,
+      },
+      blockquote: {
+        borderLeft: '4px solid #ccc',
+        paddingLeft: '20px',
+        marginLeft: '0',
+        color: '#666',
+        fontStyle: 'italic',
+      },
+      img: { maxWidth: '100%' },
+      '.hljs': { background: '#f8f8f8', color: '#444' },
+      '.hljs-comment': { color: '#697070' },
+      '.hljs-punctuation,.hljs-tag': { color: '#444a' },
+      '.hljs-tag .hljs-attr,.hljs-tag .hljs-name': { color: '#444' },
+      '.hljs-attribute,.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-name,.hljs-selector-tag': {
+        fontWeight: 700,
+      },
+      '.hljs-deletion,.hljs-number,.hljs-quote,.hljs-selector-class,.hljs-selector-id,.hljs-string,.hljs-template-tag,.hljs-type':
+        {
+          color: '#800',
+        },
+      '.hljs-section,.hljs-title': { color: '#800', fontWeight: 700 },
+      '.hljs-link,.hljs-operator,.hljs-regexp,.hljs-selector-attr,.hljs-selector-pseudo,.hljs-symbol,.hljs-template-variable,.hljs-variable':
+        {
+          color: '#ab5656',
+        },
+      '.hljs-literal': { color: '#695' },
+      '.hljs-addition,.hljs-built_in,.hljs-bullet,.hljs-code': {
+        color: '#397300',
+      },
+      '.hljs-meta': { color: '#1f7199' },
+      '.hljs-meta .hljs-string': { color: '#38a' },
+      '.hljs-emphasis': { fontStyle: 'italic' },
+      '.hljs-strong': { fontWeight: 700 },
+    },
+
+    // table style of markdown
+    '&.nb-markdown-table': {
+      table: {
+        borderCollapse: 'collapse',
+        width: '100%',
+        fontFamily: 'Arial, sans-serif',
+        marginBottom: '1.5rem',
+      },
+      'th, td': {
+        borderBottom: `1px solid ${token.colorBorderSecondary}`,
+        padding: `${token.paddingContentVertical}px ${token.paddingContentHorizontal}px`,
+        textAlign: 'left',
+      },
+      th: {
+        backgroundColor: colorFillAlterSolid,
+        fontWeight: 'bold',
+        color: token.colorText,
+      },
+      'tr:hover': { backgroundColor: token.colorFillTertiary },
+      'tr:last-child td': { borderBottom: 'none' },
+      'tr:first-child th': { borderTop: 'none' },
+    },
+  };
+
+  const darkStyle: any = {
+    // default style of markdown
+    '&.nb-markdown-default': {
+      'pre code.hljs': { display: 'block', overflowX: 'auto', padding: '1em' },
+      'code.hljs': { padding: '3px 5px' },
+      ':not(pre) code': {
+        padding: '2px 5px',
+        color: '#d56161',
+        background: token.colorFillQuaternary,
+        border: `1px solid ${token.colorBorder}`,
+        borderRadius: token.borderRadiusSM,
+      },
+      '.hljs': { color: '#adbac7', background: '#22272e' },
+      '.hljs-doctag,.hljs-keyword,.hljs-meta .hljs-keyword,.hljs-template-tag,.hljs-template-variable,.hljs-type,.hljs-variable.language_':
+        {
+          color: '#f47067',
+        },
+      '.hljs-title,.hljs-title.class_,.hljs-title.class_.inherited__,.hljs-title.function_': {
+        color: '#dcbdfb',
+      },
+      '.hljs-attr,.hljs-attribute,.hljs-literal,.hljs-meta,.hljs-number,.hljs-operator,.hljs-selector-attr,.hljs-selector-class,.hljs-selector-id,.hljs-variable':
+        {
+          color: '#6cb6ff',
+        },
+      '.hljs-meta .hljs-string,.hljs-regexp,.hljs-string': { color: '#96d0ff' },
+      '.hljs-built_in,.hljs-symbol': { color: '#f69d50' },
+      '.hljs-code,.hljs-comment,.hljs-formula': { color: '#768390' },
+      '.hljs-name,.hljs-quote,.hljs-selector-pseudo,.hljs-selector-tag': {
+        color: '#8ddb8c',
+      },
+      '.hljs-subst': { color: '#adbac7' },
+      '.hljs-section': { color: '#316dca', fontWeight: 700 },
+      '.hljs-bullet': { color: '#eac55f' },
+      '.hljs-emphasis': { color: '#adbac7', fontStyle: 'italic' },
+      '.hljs-strong': { color: '#adbac7', fontWeight: 700 },
+      '.hljs-addition': { color: '#b4f1b4', backgroundColor: '#1b4721' },
+      '.hljs-deletion': { color: '#ffd8d3', backgroundColor: '#78191b' },
+    },
+
+    // table style of markdown
+    '&.nb-markdown-table': {
+      table: {
+        borderCollapse: 'collapse',
+        width: '100%',
+        fontFamily: 'Arial, sans-serif',
+        marginBottom: '1.5rem',
+      },
+      'th, td': {
+        borderBottom: `1px solid ${token.colorBorderSecondary}`,
+        padding: `${token.paddingContentVertical}px ${token.paddingContentHorizontal}px`,
+        textAlign: 'left',
+      },
+      th: {
+        backgroundColor: colorFillAlterSolid,
+        fontWeight: 'bold',
+        color: token.colorText,
+      },
+      'tr:hover': { backgroundColor: token.colorFillTertiary },
+      'tr:last-child td': { borderBottom: 'none' },
+      'tr:first-child th': { borderTop: 'none' },
+    },
+  };
+  return css({
+    lineHeight: token.lineHeight,
+    '& > *:last-child': { marginBottom: '0' },
+    '.ant-description-textarea, .ant-description-input': { lineHeight: token.lineHeight },
+    '.field-interface-datetime': { minWidth: '100px' },
+    img: { maxWidth: '100%' },
+    ...(isDarkTheme ? darkStyle : defaultStyle),
+  });
+};

package/src/flow/internal/components/Markdown/util.ts

@@ -0,0 +1,45 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import _ from 'lodash';
+import { useEffect, useState } from 'react';
+
+export const parseMarkdown = _.memoize(async (text: string) => {
+  if (!text) {
+    return text;
+  }
+  const m = await import('./md');
+  return m.default.render(text);
+});
+
+export function useParseMarkdown(text: string) {
+  const [html, setHtml] = useState<any>('');
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    setLoading(true);
+    parseMarkdown(text)
+      .then((r) => {
+        setHtml(r);
+        setLoading(false);
+      })
+      .catch((error) => console.log(error));
+  }, [text]);
+
+  return { html, loading };
+}
+
+export function convertToText(markdownText: string) {
+  const content = markdownText;
+  let temp = document.createElement('div');
+  temp.innerHTML = content;
+  const text = temp.innerText;
+  temp = null;
+  return text?.replace(/[\n\r]/g, '') || '';
+}

package/src/flow/internal/constants/HeightMode.ts

@@ -0,0 +1,14 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+export const HeightMode = {
+  DEFAULT: 'defaultHeight',
+  SPECIFY_VALUE: 'specifyValue',
+  FULL_HEIGHT: 'fullHeight',
+};

package/src/flow/internal/index.ts

@@ -0,0 +1,16 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+// Internal components, utils and constants
+// These are only for internal use within the flow module
+// and are not exported to external modules to avoid naming conflicts
+
+export * from './components/Markdown/DisplayMarkdown';
+export * from './utils/dateTimeUtils';
+export * from './constants/HeightMode';

package/src/flow/internal/utils/__tests__/associationValueCoercion.test.ts

@@ -0,0 +1,57 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { coerceForToOneField, isToManyAssociation } from '../associationValueCoercion';
+
+describe('associationValueCoercion', () => {
+  const mkField = (opts: any) => ({
+    isAssociationField: () => !!opts.association,
+    type: opts.type,
+    interface: opts.interface,
+  });
+
+  it('isToManyAssociation returns true for to-many', () => {
+    expect(isToManyAssociation(mkField({ association: true, type: 'hasMany' }))).toBe(true);
+    expect(isToManyAssociation(mkField({ association: true, type: 'belongsToMany' }))).toBe(true);
+    expect(isToManyAssociation(mkField({ association: true, type: 'belongsToArray' }))).toBe(true);
+  });
+
+  it('isToManyAssociation returns false for to-one or non-association', () => {
+    expect(isToManyAssociation(mkField({ association: true, type: 'belongsTo', interface: 'm2o' }))).toBe(false);
+    expect(isToManyAssociation(mkField({ association: true, type: 'hasOne' }))).toBe(false);
+    expect(isToManyAssociation(mkField({ association: false, type: 'string', interface: 'input' }))).toBe(false);
+    expect(isToManyAssociation(undefined as any)).toBe(false);
+  });
+
+  it('coerceForToOneField keeps original value for to-many association', () => {
+    const field = mkField({ association: true, type: 'hasMany' });
+    const val = [1, 2];
+    expect(coerceForToOneField(field, val)).toBe(val);
+  });
+
+  it('coerceForToOneField extracts first element for to-one association when value is array', () => {
+    const field = mkField({ association: true, type: 'belongsTo', interface: 'm2o' });
+    expect(coerceForToOneField(field, [1, 2])).toBe(1);
+    expect(coerceForToOneField(field, [])).toBeUndefined();
+  });
+
+  it('coerceForToOneField keeps scalar values unchanged for to-one association', () => {
+    const field = mkField({ association: true, type: 'belongsTo' });
+    expect(coerceForToOneField(field, 123)).toBe(123);
+    const obj = { id: 9 };
+    expect(coerceForToOneField(field, obj)).toBe(obj);
+  });
+
+  it('coerceForToOneField keeps any value unchanged for non-association', () => {
+    const field = mkField({ association: false, type: 'string', interface: 'input' });
+    const arr = [1, 2, 3];
+    expect(coerceForToOneField(field, arr)).toBe(arr);
+  });
+});

package/src/flow/internal/utils/__tests__/enumOptionsUtils.test.ts

@@ -0,0 +1,58 @@
+/**
+ * This file is part of the NocoBase (R) project.
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
+ * Authors: NocoBase Team.
+ *
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
+ * For more information, please refer to: https://www.nocobase.com/agreement.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { enumToOptions, translateOptions } from '../enumOptionsUtils';
+
+// 一个极简的 t：
+// - 直接返回传入 key；
+// - 支持形如 {{t('Yes')}} 的模板，提取 'Yes' 并给出模拟翻译。
+function mockT(input: string) {
+  const tpl = /\{\{\s*t\s*\(\s*['"](.+?)['"][^)]*\)\s*\}\}/;
+  const m = input?.match?.(tpl);
+  const key = m ? m[1] : input;
+  if (key === 'Yes') return '是';
+  if (key === 'No') return '否';
+  if (key === 'Draft') return '草稿';
+  return key;
+}
+
+describe('enumOptions utils', () => {
+  it('enumToOptions: converts primitive enum and translates labels', () => {
+    const uiEnum = ['{{t("Yes")}}', '{{t("No")}}'];
+    const options = enumToOptions(uiEnum as any, mockT)!;
+    expect(options).toHaveLength(2);
+    expect(options[0]).toEqual({ label: '是', value: '{{t("Yes")}}' });
+    expect(options[1]).toEqual({ label: '否', value: '{{t("No")}}' });
+  });
+
+  it('enumToOptions: keeps object value and translates object label', () => {
+    const uiEnum = [
+      { label: '{{t("Yes")}}', value: true },
+      { label: '{{t("No")}}', value: false },
+    ];
+    const options = enumToOptions(uiEnum as any, mockT)!;
+    expect(options).toEqual([
+      { label: '是', value: true },
+      { label: '否', value: false },
+    ]);
+  });
+
+  it('translateOptions: maps given options labels through t()', () => {
+    const options = [
+      { label: '{{t("Draft")}}', value: 'draft' },
+      { label: 'No', value: false },
+    ];
+    const out = translateOptions(options as any, mockT);
+    expect(out).toEqual([
+      { label: '草稿', value: 'draft' },
+      { label: '否', value: false },
+    ]);
+  });
+});