create-react-admin-template 0.0.0-stage → 0.1.0

package/template/src/config/types.ts

@@ -0,0 +1,195 @@
+import type { TAppLocale } from '@/locale/types'
+
+/** 浏览器启动时加载的应用公开配置。不得包含密码、Token 或其他密钥。 */
+export interface IRuntimeConfig {
+  /** 运行时配置契约版本；不兼容变更时递增。 */
+  nSchemaVersion: 1
+  /** 应用品牌、运行模式和浏览器存储配置。 */
+  app: IRuntimeApplicationConfig
+  /** 后端 API 的浏览器运行时地址。 */
+  api: IRuntimeApiConfig
+  /** 登录、刷新和退出使用的公开认证参数。 */
+  auth: IRuntimeAuthConfig
+  /** 日志开关和部署环境；不包含供应商密钥。 */
+  observability: IRuntimeObservabilityConfig
+  /** 默认语言与统一时区。 */
+  locale: IRuntimeLocaleConfig
+}
+
+/** 应用默认语言与时区配置。 */
+export interface IRuntimeLocaleConfig {
+  /** 当前内建 BCP 47 语言标签。 */
+  strLocale: TAppLocale
+  /** 统一 IANA 时区，例如 `Asia/Shanghai`。 */
+  strTimeZone: string
+}
+
+/** 应用品牌、运行模式和浏览器存储配置。 */
+export interface IRuntimeApplicationConfig {
+  /** 稳定白标标识；只用于诊断和受控 CSS 作用域，不是租户权限标识。 */
+  strBrandId: string
+  /** 浏览器标题和应用内展示的产品名称。 */
+  strTitle: string
+  /** 页面描述和侧边栏展示的简短说明。 */
+  strDescription: string
+  /** `public/` 内的相对路径或受信任的 HTTP(S)/图片 Data URL。 */
+  strLogoPath: string
+  /** 深色主题 Logo；未声明时回退到 `strLogoPath`。 */
+  strDarkLogoPath: string
+  /** 浏览器页签图标的公开资产路径。 */
+  strFaviconPath: string
+  /** 受限的明暗品牌语义色；不能包含任意 CSS。 */
+  objTheme: IRuntimeBrandTheme
+  /** 隔离认证、主题和 UI 偏好的浏览器存储命名空间。 */
+  strStorageNamespace: string
+  /** `demo` 使用本地演示认证，`connected` 连接真实后端。 */
+  strMode: 'connected' | 'demo'
+}
+
+/** 单个明暗模式允许覆盖的品牌语义色。 */
+export interface IRuntimeBrandPalette {
+  /** 主要操作和品牌强调色，必须与主要前景色达到 WCAG AA。 */
+  strPrimaryColor: string
+  /** 主要操作上的文本和图标颜色。 */
+  strPrimaryForegroundColor: string
+  /** 次要操作和辅助强调色，必须与次要前景色达到 WCAG AA。 */
+  strSecondaryColor: string
+  /** 次要操作上的文本和图标颜色。 */
+  strSecondaryForegroundColor: string
+  /** 浏览器地址栏等宿主界面使用的主题颜色。 */
+  strBrowserThemeColor: string
+}
+
+/** 运行时白标的明暗品牌色组合。 */
+export interface IRuntimeBrandTheme {
+  /** 浅色模式品牌色。 */
+  objLight: IRuntimeBrandPalette
+  /** 深色模式品牌色。 */
+  objDark: IRuntimeBrandPalette
+}
+
+/** 后端 API 的浏览器运行时地址。 */
+export interface IRuntimeApiConfig {
+  /** API 基础地址；空字符串表示使用当前站点，同源部署时推荐留空。 */
+  strBaseUrl: string
+}
+
+/** 登录、刷新和退出使用的公开认证参数。 */
+export interface IRuntimeAuthConfig {
+  /** 认证服务校验的目标 Audience。 */
+  strAudience: string
+  /** 浏览器应用的公开 OAuth Client ID，不得在这里配置 Client Secret。 */
+  strClientId: string
+  /** 登录申请的 OAuth Scope，以空格分隔。 */
+  strScope: string
+  /** 会话保存位置；生产连接模式推荐使用 `memory`。 */
+  strSessionStorage: 'memory' | 'session'
+  /** 用户名密码登录端点，可使用相对路径或 HTTP(S) 地址。 */
+  strSignInPath: string
+  /** 刷新访问令牌端点，可使用相对路径或 HTTP(S) 地址。 */
+  strRefreshPath: string
+  /** 注销端点，可使用相对路径或 HTTP(S) 地址。 */
+  strSignOutPath: string
+}
+
+/** 浏览器可观测性的公开部署配置。 */
+export interface IRuntimeObservabilityConfig {
+  /** 是否允许向项目配置的 Adapter 发送脱敏事件。 */
+  bEnabled: boolean
+  /** 用于区分 local、test、staging、production 等部署环境。 */
+  strEnvironment: string
+}
+
+/** 经运行时配置转换后供应用模块消费的稳定配置。 */
+export interface IAppConfig {
+  /** 当前数据接入模式。 */
+  runtime: {
+    /** `demo` 使用演示适配器，`connected` 使用真实后端。 */
+    strMode: 'connected' | 'demo'
+  }
+  /** 应用品牌信息。 */
+  brand: {
+    /** 稳定白标标识，不参与授权。 */
+    strId: string
+    /** 应用显示名称。 */
+    strName: string
+    /** 应用简短描述。 */
+    strDescription: string
+    /** 已结合 Vite public path 解析的 Logo 地址。 */
+    strLogoUrl: string
+    /** 深色主题使用的已解析 Logo 地址。 */
+    strDarkLogoUrl: string
+    /** 已解析的浏览器页签图标地址。 */
+    strFaviconUrl: string
+    /** 已校验并冻结的明暗品牌语义色。 */
+    objTheme: IRuntimeBrandTheme
+  }
+  /** API 连接信息。 */
+  api: {
+    /** API 基础地址；空字符串表示当前站点。 */
+    strBaseUrl: string
+  }
+  /** 认证公开配置和端点。 */
+  auth: {
+    /** 认证 Audience。 */
+    strAudience: string
+    /** 浏览器应用的公开 Client ID。 */
+    strClientId: string
+    /** 登录申请的 Scope。 */
+    strScope: string
+    /** 会话保存位置。 */
+    strSessionStorage: 'memory' | 'session'
+    /** 登录端点。 */
+    strSignInPath: string
+    /** 刷新端点。 */
+    strRefreshPath: string
+    /** 注销端点。 */
+    strSignOutPath: string
+  }
+  /** 可观测性运行开关。 */
+  observability: {
+    /** 是否允许发送已经脱敏的诊断事件。 */
+    bEnabled: boolean
+  }
+  /** 应用统一语言与时区。 */
+  locale: {
+    /** 当前 BCP 47 语言标签。 */
+    strLocale: TAppLocale
+    /** 当前统一 IANA 时区。 */
+    strTimeZone: string
+  }
+  /** 当前构建及部署的公开版本上下文。 */
+  release: {
+    /** `package.json` 应用版本。 */
+    strVersion: string
+    /** 构建对应 Git Commit。 */
+    strCommit: string
+    /** 产生静态产物的 ISO 时间。 */
+    strBuildTime: string
+    /** 部署时配置的环境名称。 */
+    strEnvironment: string
+  }
+  /** 应用导航约定。 */
+  navigation: {
+    /** 认证成功后的默认页面。 */
+    strDefaultAuthenticatedPath: string
+  }
+  /** 带应用命名空间的浏览器存储 Key。 */
+  storage: {
+    /** 认证会话存储 Key。 */
+    strAuthSessionKey: string
+    /** 当前用户租户/工作空间选择的存储 Key。 */
+    strTenantWorkspaceKey: string
+    /** 主题偏好存储 Key。 */
+    strThemeKey: string
+    /** 其他 UI 偏好存储 Key。 */
+    strUiPreferenceKey: string
+  }
+}
+
+/** 运行时配置加载失败的稳定错误码。 */
+export type TRuntimeConfigErrorCode =
+  | 'invalid_config'
+  | 'invalid_json'
+  | 'load_failed'
+  | 'not_initialized'

package/template/src/context/ThemeProvider.tsx

@@ -0,0 +1,84 @@
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useState,
+  type ReactNode,
+} from 'react'
+import { fnApplyAppBrandTheme, objAppConfig } from '@/config/appConfig'
+import type { TTheme } from './types'
+
+export type { TTheme } from './types'
+
+type TThemeProviderProps = {
+  children: ReactNode
+}
+
+type TThemeContextValue = {
+  strTheme: TTheme
+  bIsDarkTheme: boolean
+  fnSetTheme: (strTheme: TTheme) => void
+}
+
+const strThemeStorageKey = objAppConfig.storage.strThemeKey
+const fnThemeContext = createContext<TThemeContextValue | null>(null)
+
+function fnGetStoredTheme(): TTheme {
+  try {
+    const strStoredTheme = localStorage.getItem(strThemeStorageKey)
+    return strStoredTheme === 'light' ||
+      strStoredTheme === 'dark' ||
+      strStoredTheme === 'system'
+      ? strStoredTheme
+      : 'system'
+  } catch {
+    return 'system'
+  }
+}
+
+export function ThemeProvider({ children: objChildren }: TThemeProviderProps) {
+  const [strTheme, fnSetTheme] = useState<TTheme>(fnGetStoredTheme)
+  const [bSystemDarkTheme, fnSetSystemDarkTheme] = useState(
+    () => window.matchMedia('(prefers-color-scheme: dark)').matches
+  )
+  const bIsDarkTheme =
+    strTheme === 'dark' || (strTheme === 'system' && bSystemDarkTheme)
+
+  useEffect(() => {
+    const objSystemTheme = window.matchMedia('(prefers-color-scheme: dark)')
+    const fnHandleSystemThemeChange = (objEvent: MediaQueryListEvent) =>
+      fnSetSystemDarkTheme(objEvent.matches)
+    objSystemTheme.addEventListener('change', fnHandleSystemThemeChange)
+    return () =>
+      objSystemTheme.removeEventListener('change', fnHandleSystemThemeChange)
+  }, [])
+
+  useEffect(() => {
+    const objRoot = window.document.documentElement
+    try {
+      localStorage.setItem(strThemeStorageKey, strTheme)
+    } catch {
+      // 受限存储环境仍应允许主题在当前页面生效。
+    }
+    objRoot.classList.toggle('dark', bIsDarkTheme)
+    objRoot.style.colorScheme = bIsDarkTheme ? 'dark' : 'light'
+    fnApplyAppBrandTheme(bIsDarkTheme)
+  }, [bIsDarkTheme, strTheme])
+
+  return (
+    <fnThemeContext.Provider value={{ strTheme, bIsDarkTheme, fnSetTheme }}>
+      {objChildren}
+    </fnThemeContext.Provider>
+  )
+}
+
+// eslint-disable-next-line react-refresh/only-export-components
+export function useTheme() {
+  const objContext = useContext(fnThemeContext)
+
+  if (!objContext) {
+    throw new Error('useTheme 必须在 ThemeProvider 内使用')
+  }
+
+  return objContext
+}

package/template/src/context/UnsavedChangesProvider.tsx

@@ -0,0 +1,123 @@
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useId,
+  useMemo,
+  useRef,
+  useState,
+  type ReactNode,
+} from 'react'
+import { useBlocker } from '@tanstack/react-router'
+import { useSharedMessage } from '@/locale'
+import { AppDialog } from '@/components/AppDialog'
+import type { IUnsavedChangesRegistration } from './types'
+
+interface IUnsavedChangesContextValue {
+  fnSetDirty: (strRegistrationId: string, bIsDirty: boolean) => void
+  fnRemove: (strRegistrationId: string) => void
+}
+
+const fnUnsavedChangesContext =
+  createContext<IUnsavedChangesContextValue | null>(null)
+
+/**
+ * 汇总当前路由子树中的草稿状态，并统一处理 SPA 导航和浏览器离开。
+ *
+ * 注册表只保存“哪些消费者当前为 dirty”，不复制表单或表格草稿数据。
+ */
+export function UnsavedChangesProvider({
+  children: objChildren,
+}: {
+  children: ReactNode
+}) {
+  const objDirtyRegistrationsRef = useRef(new Map<string, true>())
+  const [nDirtyCount, fnSetDirtyCount] = useState(0)
+  const bHasUnsavedChanges = nDirtyCount > 0
+  const fnSetDirty = useCallback(
+    (strRegistrationId: string, bIsDirty: boolean) => {
+      const objRegistrations = objDirtyRegistrationsRef.current
+      const bWasDirty = objRegistrations.has(strRegistrationId)
+      if (bWasDirty === bIsDirty) return
+      if (bIsDirty) objRegistrations.set(strRegistrationId, true)
+      else objRegistrations.delete(strRegistrationId)
+      fnSetDirtyCount(objRegistrations.size)
+    },
+    []
+  )
+  const fnRemove = useCallback((strRegistrationId: string) => {
+    const objRegistrations = objDirtyRegistrationsRef.current
+    if (!objRegistrations.delete(strRegistrationId)) return
+    fnSetDirtyCount(objRegistrations.size)
+  }, [])
+  const objContext = useMemo(
+    () => ({ fnSetDirty, fnRemove }),
+    [fnRemove, fnSetDirty]
+  )
+  const fnShouldBlock = useCallback(
+    () => bHasUnsavedChanges,
+    [bHasUnsavedChanges]
+  )
+  const objBlocker = useBlocker({
+    shouldBlockFn: fnShouldBlock,
+    enableBeforeUnload: fnShouldBlock,
+    disabled: !bHasUnsavedChanges,
+    withResolver: true,
+  })
+  const strTitle = useSharedMessage('unsavedChanges.title')
+  const strDescription = useSharedMessage('unsavedChanges.description')
+  const strStay = useSharedMessage('unsavedChanges.stay')
+  const strLeave = useSharedMessage('unsavedChanges.leave')
+
+  useEffect(() => {
+    if (!bHasUnsavedChanges && objBlocker.status === 'blocked') {
+      objBlocker.proceed()
+    }
+  }, [bHasUnsavedChanges, objBlocker])
+
+  return (
+    <fnUnsavedChangesContext.Provider value={objContext}>
+      {objChildren}
+      <AppDialog
+        bOpen={objBlocker.status === 'blocked'}
+        fnOnOpenChange={(bOpen) => {
+          if (!bOpen && objBlocker.status === 'blocked') objBlocker.reset()
+        }}
+        strTitle={strTitle}
+        strSize='sm'
+        strCancelText={strStay}
+        strConfirmText={strLeave}
+        strConfirmVariant='destructive'
+        fnOnCancel={() => {
+          if (objBlocker.status === 'blocked') objBlocker.reset()
+        }}
+        fnOnConfirm={() => {
+          if (objBlocker.status === 'blocked') objBlocker.proceed()
+        }}
+      >
+        <p>{strDescription}</p>
+      </AppDialog>
+    </fnUnsavedChangesContext.Provider>
+  )
+}
+
+/** 注册共享组件的 dirty 状态；未挂载 Provider 时保持组件可独立使用。 */
+// eslint-disable-next-line react-refresh/only-export-components
+export function useUnsavedChangesRegistration({
+  bIsDirty,
+  bEnabled = true,
+}: IUnsavedChangesRegistration) {
+  const objContext = useContext(fnUnsavedChangesContext)
+  const strRegistrationId = useId()
+
+  useEffect(() => {
+    if (!objContext) return
+    objContext.fnSetDirty(strRegistrationId, bEnabled && bIsDirty)
+  }, [bEnabled, bIsDirty, objContext, strRegistrationId])
+
+  useEffect(
+    () => () => objContext?.fnRemove(strRegistrationId),
+    [objContext, strRegistrationId]
+  )
+}

package/template/src/context/applicationScope.ts

@@ -0,0 +1,39 @@
+import type {
+  IApplicationMetadataScopeOverride,
+  IApplicationScope,
+  IApplicationScopeInput,
+} from './types'
+
+/** 创建不可变的应用运行作用域。 */
+export function fnCreateApplicationScope(
+  objInput: IApplicationScopeInput
+): IApplicationScope {
+  return Object.freeze({ ...objInput })
+}
+
+/** 为枚举和全局参数派生一致的目录作用域。 */
+export function fnResolveApplicationMetadataScope(
+  objScope: IApplicationScope,
+  objOverride: IApplicationMetadataScopeOverride = {}
+) {
+  return Object.freeze({
+    ...objOverride,
+    nSessionGeneration: objScope.nSessionGeneration,
+    strTenantId: objOverride.strTenantId ?? objScope.strTenantId,
+    strWorkspaceId: objOverride.strWorkspaceId ?? objScope.strWorkspaceId,
+  })
+}
+
+/** 为服务端查询派生包含显式匿名身份的缓存作用域。 */
+export function fnResolveApplicationQueryScope(
+  objScope: IApplicationScope,
+  strWorkspaceId = objScope.strWorkspaceId
+) {
+  return Object.freeze({
+    nSessionGeneration: objScope.nSessionGeneration,
+    strLocale: objScope.strLocale,
+    strTenantId: objScope.strTenantId,
+    strUserId: objScope.strUserId ?? 'anonymous',
+    strWorkspaceId,
+  })
+}

package/template/src/context/types.ts

@@ -0,0 +1,41 @@
+import type { TAppLocale } from '@/locale'
+
+export type TTheme = 'light' | 'dark' | 'system'
+
+/** 构建应用运行作用域所需的唯一身份输入。 */
+export interface IApplicationScopeInput {
+  /** 登录、退出或授权上下文变化时递增的会话版本。 */
+  readonly nSessionGeneration: number
+  /** 当前应用语言。 */
+  readonly strLocale: TAppLocale
+  /** 当前租户稳定标识。 */
+  readonly strTenantId?: string
+  /** 当前认证用户稳定标识。 */
+  readonly strUserId?: string
+  /** 当前组织、项目或工作空间稳定标识。 */
+  readonly strWorkspaceId?: string
+}
+
+/** 认证、租户、工作空间和语言组成的统一应用运行作用域。 */
+export interface IApplicationScope extends IApplicationScopeInput {
+  /** 同时作为授权相关资源的缓存版本。 */
+  readonly nSessionGeneration: number
+}
+
+/** 枚举和全局参数允许覆盖的附加作用域。 */
+export interface IApplicationMetadataScopeOverride {
+  /** 后端目录命名空间。 */
+  readonly strNamespace?: string
+  /** 显式租户；省略时使用当前应用租户。 */
+  readonly strTenantId?: string
+  /** 显式工作空间；省略时使用当前应用工作空间。 */
+  readonly strWorkspaceId?: string
+}
+
+/** 共享组件向应用级离开保护器注册草稿状态的参数。 */
+export interface IUnsavedChangesRegistration {
+  /** 当前组件是否持有尚未持久化的用户修改。 */
+  bIsDirty: boolean
+  /** 是否启用路由与浏览器离开保护；默认启用。 */
+  bEnabled?: boolean
+}

package/template/src/dataMasking/index.ts

@@ -0,0 +1,14 @@
+export {
+  fnMaskSensitiveText,
+  fnResolveSensitiveDataMaskedText,
+  objDataMaskingPresets,
+} from './masking'
+export {
+  SensitiveDataError,
+  type IDataMaskingPolicy,
+  type TSensitiveDataClipboardAdapter,
+  type TSensitiveDataCopyPolicy,
+  type TSensitiveDataRevealAdapter,
+  type TSensitiveDataRevealPolicy,
+  type TSensitiveDataValue,
+} from './types'

package/template/src/dataMasking/masking.ts

@@ -0,0 +1,139 @@
+import type {
+  IDataMaskingPolicy,
+  TDataMaskingPreset,
+  TSensitiveDataValue,
+} from './types'
+
+interface IResolvedSegmentPolicy {
+  readonly nMaskLength?: number
+  readonly nVisibleEnd: number
+  readonly nVisibleStart: number
+  readonly strMaskCharacter: string
+}
+
+/** 内建策略默认值；业务可在字段级覆盖首尾可见位数和固定遮罩长度。 */
+export const objDataMaskingPresets: Readonly<
+  Record<TDataMaskingPreset, Readonly<IResolvedSegmentPolicy>>
+> = Object.freeze({
+  bankCard: Object.freeze({
+    nMaskLength: 12,
+    nVisibleEnd: 4,
+    nVisibleStart: 0,
+    strMaskCharacter: '*',
+  }),
+  email: Object.freeze({
+    nMaskLength: 3,
+    nVisibleEnd: 0,
+    nVisibleStart: 1,
+    strMaskCharacter: '*',
+  }),
+  identity: Object.freeze({
+    nMaskLength: 8,
+    nVisibleEnd: 4,
+    nVisibleStart: 3,
+    strMaskCharacter: '*',
+  }),
+  name: Object.freeze({
+    nVisibleEnd: 0,
+    nVisibleStart: 1,
+    strMaskCharacter: '*',
+  }),
+  phone: Object.freeze({
+    nMaskLength: 4,
+    nVisibleEnd: 4,
+    nVisibleStart: 3,
+    strMaskCharacter: '*',
+  }),
+  segment: Object.freeze({
+    nVisibleEnd: 0,
+    nVisibleStart: 0,
+    strMaskCharacter: '*',
+  }),
+})
+
+function fnNormalizeCount(nValue: number | undefined, nFallback: number) {
+  if (!Number.isFinite(nValue)) return nFallback
+  return Math.max(0, Math.trunc(nValue ?? nFallback))
+}
+
+function fnResolveMaskCharacter(strValue: string | undefined) {
+  const arrCharacters = Array.from(strValue ?? '')
+  if (arrCharacters.length !== 1 || /^\s$/u.test(arrCharacters[0])) return '*'
+  return arrCharacters[0]
+}
+
+function fnResolveSegmentPolicy(
+  objPolicy: IDataMaskingPolicy
+): IResolvedSegmentPolicy {
+  const objPreset = objDataMaskingPresets[objPolicy.strPreset]
+  return {
+    nMaskLength:
+      objPolicy.nMaskLength === undefined
+        ? objPreset.nMaskLength
+        : fnNormalizeCount(objPolicy.nMaskLength, 1),
+    nVisibleEnd: fnNormalizeCount(objPolicy.nVisibleEnd, objPreset.nVisibleEnd),
+    nVisibleStart: fnNormalizeCount(
+      objPolicy.nVisibleStart,
+      objPreset.nVisibleStart
+    ),
+    strMaskCharacter: fnResolveMaskCharacter(
+      objPolicy.strMaskCharacter ?? objPreset.strMaskCharacter
+    ),
+  }
+}
+
+function fnMaskSegment(strValue: string, objPolicy: IResolvedSegmentPolicy) {
+  const arrCharacters = Array.from(strValue)
+  if (arrCharacters.length === 0) return ''
+
+  const nVisibleStart = Math.min(
+    objPolicy.nVisibleStart,
+    arrCharacters.length - 1
+  )
+  const nVisibleEnd = Math.min(
+    objPolicy.nVisibleEnd,
+    arrCharacters.length - nVisibleStart - 1
+  )
+  const nHiddenLength = arrCharacters.length - nVisibleStart - nVisibleEnd
+  const nMaskLength = Math.max(1, objPolicy.nMaskLength ?? nHiddenLength)
+  const strStart = arrCharacters.slice(0, nVisibleStart).join('')
+  const strEnd = nVisibleEnd ? arrCharacters.slice(-nVisibleEnd).join('') : ''
+
+  return `${strStart}${objPolicy.strMaskCharacter.repeat(nMaskLength)}${strEnd}`
+}
+
+function fnMaskEmail(strValue: string, objPolicy: IResolvedSegmentPolicy) {
+  const nSeparatorIndex = strValue.lastIndexOf('@')
+  if (nSeparatorIndex <= 0 || nSeparatorIndex === strValue.length - 1) {
+    return fnMaskSegment(strValue, objPolicy)
+  }
+
+  const strLocalPart = strValue.slice(0, nSeparatorIndex)
+  const strDomain = strValue.slice(nSeparatorIndex)
+  return `${fnMaskSegment(strLocalPart, objPolicy)}${strDomain}`
+}
+
+/** 按预设和字段级覆盖生成展示脱敏文本，始终至少隐藏一个字符。 */
+export function fnMaskSensitiveText(
+  strValue: string,
+  objPolicy: IDataMaskingPolicy
+) {
+  if (!strValue) return objPolicy.strEmptyText ?? '—'
+
+  const objResolvedPolicy = fnResolveSegmentPolicy(objPolicy)
+  return objPolicy.strPreset === 'email'
+    ? fnMaskEmail(strValue, objResolvedPolicy)
+    : fnMaskSegment(strValue, objResolvedPolicy)
+}
+
+/** 优先使用后端脱敏结果，仅在已授权原值存在时执行前端展示脱敏。 */
+export function fnResolveSensitiveDataMaskedText(
+  objValue: TSensitiveDataValue,
+  objPolicy: IDataMaskingPolicy
+) {
+  if (objValue.strState === 'masked') {
+    return objValue.strMaskedValue || objPolicy.strEmptyText || '—'
+  }
+  if (objValue.strMaskedValue) return objValue.strMaskedValue
+  return fnMaskSensitiveText(objValue.strValue, objPolicy)
+}