jvs-ppt-ui 0.0.11 → 0.0.14

package/src/components/canvas/elements/CanvasTextElement.vue

@@ -4,7 +4,7 @@ import { getFontVariantStyle } from '../../../configs/fonts'
 import { useSlides } from '../../../composables/useSlides'
 import { createTextSelectionOverlay, type TextSelectionOverlayHandle } from '../textSelectionOverlay'
 
-const { shapeFormatPainter } = useSlides()
+const { shapeFormatPainter, isReadonly } = useSlides()
 const isTextPaintActive = computed(() => !!(shapeFormatPainter.value && shapeFormatPainter.value.mode === 'text-range'))
 const isTextSelectable = computed(() => (props.isEditingText && props.element.id === props.selectedElementId) || isTextPaintActive.value)
 
@@ -176,7 +176,7 @@ function handleMaskMouseDown(e: MouseEvent) {
   >
     <!-- Sibling Table Edit Mask -->
     <div
-      v-if="element.id === selectedElementId && isTable(element) && !isEditingText"
+      v-if="!isReadonly && element.id === selectedElementId && isTable(element) && !isEditingText"
       class="table-edit-mask"
       @mousemove="handleMaskMouseMove"
       @mousedown="handleMaskMouseDown"
@@ -187,7 +187,7 @@ function handleMaskMouseDown(e: MouseEvent) {
 
     <!-- Sibling Formula Edit Mask -->
     <div
-      v-if="element.id === selectedElementId && element.latex && !isEditingText"
+      v-if="!isReadonly && element.id === selectedElementId && element.latex && !isEditingText"
       class="formula-edit-mask"
       @dblclick.stop="emit('formulaDblClick')"
     ></div>
@@ -203,7 +203,7 @@ function handleMaskMouseDown(e: MouseEvent) {
       @focusout="emit('focusout', $event)"
       @input="emit('input', $event)"
       @keydown="emit('keydown', $event)"
-      @dblclick.stop="isTextSelectable ? null : emit('dblclick', $event)"
+      @dblclick.stop="isReadonly ? null : (isTextSelectable ? null : emit('dblclick', $event))"
       @mousemove="emit('mousemove', $event)"
       @mouseleave="emit('mouseleave', $event)"
       :class="{

package/src/composables/canvas/useCanvasShortcuts.ts

@@ -36,6 +36,7 @@ export interface ShortcutsOptions {
   shapeFormatPainter?: Ref<any>
   notify: (msg: string) => void
   addHistorySnapshot?: () => void
+  isReadonly?: Ref<boolean>
 }
 
 export function useCanvasShortcuts(options: ShortcutsOptions) {
@@ -73,7 +74,8 @@ export function useCanvasShortcuts(options: ShortcutsOptions) {
     getElementPixels,
     shapeFormatPainter,
     notify,
-    addHistorySnapshot
+    addHistorySnapshot,
+    isReadonly
   } = options
 
   let historyDebounceTimer: any = null
@@ -89,6 +91,53 @@ export function useCanvasShortcuts(options: ShortcutsOptions) {
   function handleGlobalKeyDown(e: KeyboardEvent) {
     if (e.defaultPrevented) return
 
+    if (isReadonly?.value) {
+      if (e.key === 'F5') {
+        e.preventDefault()
+        if (!isPresenting.value) {
+          if (e.shiftKey) {
+            startPresentation()
+          } else {
+            activeIndex.value = 0
+            startPresentation()
+          }
+        }
+        return
+      }
+      if ((e.ctrlKey || e.metaKey) && e.key.toLowerCase() === 'f') {
+        showSearchPanel.value = !showSearchPanel.value
+        if (showSearchPanel.value) {
+          activeSearchTab.value = 'find'
+        }
+        e.preventDefault()
+        return
+      }
+      if (e.key === 'Escape') {
+        selectedElementId.value = null
+        selectedElementIds.value = []
+        return
+      }
+      if (e.key === 'ArrowUp' || e.key === 'PageUp') {
+        if (activeIndex.value > 0) activeIndex.value--
+        e.preventDefault()
+        return
+      }
+      if (e.key === 'ArrowDown' || e.key === 'PageDown') {
+        if (activeIndex.value < slides.value.length - 1) activeIndex.value++
+        e.preventDefault()
+        return
+      }
+      if ((e.ctrlKey || e.metaKey) && (e.key === 'c' || e.key === 'C')) {
+        copySelectedSlides()
+        return
+      }
+      if (['Delete', 'Backspace'].includes(e.key) || ((e.ctrlKey || e.metaKey) && ['d', 'g', 'z', 'y', 'v', 'x'].includes(e.key.toLowerCase()))) {
+        e.preventDefault()
+        e.stopPropagation()
+      }
+      return
+    }
+
     // Ctrl + D (Duplicate / 快速复制副本) - 拦截防止浏览器添加书签
     if ((e.ctrlKey || e.metaKey) && (e.key === 'd' || e.key === 'D')) {
       e.preventDefault()

package/src/composables/canvas/useCanvasTable.ts

@@ -12,6 +12,7 @@ export interface TableOptions {
   getOverlayHeight?: (el: any) => string
   selectedElementWidth?: Ref<string>
   selectedElementHeight?: Ref<string>
+  isReadonly?: Ref<boolean>
 }
 
 interface TableMeasure {
@@ -57,7 +58,8 @@ export function useCanvasTable(options: TableOptions) {
     getOverlayWidth = (el: any) => el?.style?.width || '500px',
     getOverlayHeight = (el: any) => el?.style?.height || '200px',
     selectedElementWidth,
-    selectedElementHeight
+    selectedElementHeight,
+    isReadonly
   } = options
 
   const selectedCellCount = ref(0)
@@ -461,7 +463,7 @@ export function useCanvasTable(options: TableOptions) {
   }
 
   function selectColumnCells(el: any, colIdx: number) {
-    if (!el || !el.id) return
+    if (isReadonly?.value || !el || !el.id) return
     selectedElementId.value = el.id
     if (!selectedElementIds.value.includes(el.id)) {
       selectedElementIds.value = [el.id]
@@ -508,7 +510,7 @@ export function useCanvasTable(options: TableOptions) {
   }
 
   function selectRowCells(el: any, rowIdx: number) {
-    if (!el || !el.id) return
+    if (isReadonly?.value || !el || !el.id) return
     selectedElementId.value = el.id
     if (!selectedElementIds.value.includes(el.id)) {
       selectedElementIds.value = [el.id]
@@ -1297,6 +1299,7 @@ export function useCanvasTable(options: TableOptions) {
   }
 
   function startTableColResize(e: MouseEvent, el: any, targetColIdx: number) {
+    if (isReadonly?.value) return
     e.preventDefault()
     e.stopPropagation()
 
@@ -1401,6 +1404,7 @@ export function useCanvasTable(options: TableOptions) {
   }
 
   function startTableRowResize(e: MouseEvent, el: any, targetRowIdx: number) {
+    if (isReadonly?.value) return
     e.preventDefault()
     e.stopPropagation()
 
@@ -1613,6 +1617,7 @@ export function useCanvasTable(options: TableOptions) {
   }
 
   function handleTableDblClick(e: MouseEvent, el: any) {
+    if (isReadonly?.value) return
     e.stopPropagation()
     const targetEl = el || selectedElement.value
     if (!targetEl) return

package/src/composables/canvas/useCanvasText.ts

@@ -25,6 +25,7 @@ export interface TextOptions {
   renderLatexToSvg: (latex: string) => string
   sanitizeNbspInHtml: (html: string) => string
   updateTextFontScale: (el: any) => void
+  isReadonly?: Ref<boolean>
 }
 
 export function useCanvasText(options: TextOptions) {
@@ -48,7 +49,8 @@ export function useCanvasText(options: TextOptions) {
     applyTextStyleToHtml,
     renderLatexToSvg,
     sanitizeNbspInHtml,
-    updateTextFontScale
+    updateTextFontScale,
+    isReadonly
   } = options
 
   const isEditingText = ref(false)
@@ -56,7 +58,7 @@ export function useCanvasText(options: TextOptions) {
   const editingPlaceholderOriginalValue = ref<{ [key: string]: string }>({})
 
   function updateElementContent(id: string, text: string) {
-    if (!activeSlide.value) return
+    if (isReadonly?.value || !activeSlide.value) return
     const el = activeSlide.value.elements.find((item: any) => item.id === id)
     if (el) {
       if (el.type === 'shape') {
@@ -198,6 +200,7 @@ export function useCanvasText(options: TextOptions) {
   }
 
   function startEditingShapeText(elOrId: any, mouseEvent?: MouseEvent) {
+    if (isReadonly?.value) return
     const elId = typeof elOrId === 'string' ? elOrId : elOrId?.id
     const el = typeof elOrId === 'string'
       ? (findElementInSlide(elOrId) || activeSlide.value?.elements.find((x: any) => x.id === elOrId))
@@ -255,6 +258,7 @@ export function useCanvasText(options: TextOptions) {
   }
 
   function startEditingTextElement(elId: string, mouseEvent?: MouseEvent) {
+    if (isReadonly?.value || !elId) return
     selectedElementId.value = elId
     selectedElementIds.value = [elId]
     isEditingText.value = true
@@ -406,7 +410,7 @@ export function useCanvasText(options: TextOptions) {
   }
 
   function handleFormulaDblClick(el: any) {
-    if (!el.latex) return
+    if (isReadonly?.value || !el.latex) return
     currentEditingFormulaEl.value = el
     formulaDialogVisible.value = true
   }

package/src/composables/sidebar/useSidebarElementTransform.ts

@@ -1,6 +1,7 @@
 import { computed, type Ref, type ComputedRef } from 'vue'
 import { shapeFormulas } from '../../utils/pptxShapesLazy'
 import { useSlides } from '../useSlides'
+import { applyGroupGeometryFlip } from '../../utils/groupFlip'
 
 export function useSidebarElementTransform(
   selectedElement: ComputedRef<any>,
@@ -65,10 +66,16 @@ export function useSidebarElementTransform(
     if (selectedElementIds.value.length > 1 && activeSlide.value) {
       activeSlide.value.elements.forEach((el: any) => {
         if (selectedElementIds.value.includes(el.id)) {
-          if (!el.style) el.style = {}
-          el.style.flipH = !el.style.flipH
+          if (el.type === 'group') {
+            applyGroupGeometryFlip(el, true, false)
+          } else {
+            if (!el.style) el.style = {}
+            el.style.flipH = !el.style.flipH
+          }
         }
       })
+    } else if (selectedElement.value && selectedElement.value.type === 'group') {
+      applyGroupGeometryFlip(selectedElement.value, true, false)
     } else {
       getStyle().flipH = !getStyle().flipH
     }
@@ -79,10 +86,16 @@ export function useSidebarElementTransform(
     if (selectedElementIds.value.length > 1 && activeSlide.value) {
       activeSlide.value.elements.forEach((el: any) => {
         if (selectedElementIds.value.includes(el.id)) {
-          if (!el.style) el.style = {}
-          el.style.flipV = !el.style.flipV
+          if (el.type === 'group') {
+            applyGroupGeometryFlip(el, false, true)
+          } else {
+            if (!el.style) el.style = {}
+            el.style.flipV = !el.style.flipV
+          }
         }
       })
+    } else if (selectedElement.value && selectedElement.value.type === 'group') {
+      applyGroupGeometryFlip(selectedElement.value, false, true)
     } else {
       getStyle().flipV = !getStyle().flipV
     }

package/src/composables/useSlides.ts

@@ -12,6 +12,7 @@ import {
   inferElementTextType,
   normalizeTextType
 } from '../utils/textTypes'
+import { applyGroupGeometryFlip } from '../utils/groupFlip'
 import type { CustomUploadHandler, UploadResourceContext, UploadResourceType } from '../types'
 
 export type { SlideTextType }
@@ -340,15 +341,15 @@ function setAiConfig(config?: { apiUrl?: string; headers?: Record<string, string
   }
 }
 
-// 素材库配置状态（支持获取分类树/首页、分页查询、获取单独类型、素材保存 API）
-export const DEFAULT_MATERIAL_API_URL = '/jvs-dam/api/dam/material/tree'
-export const DEFAULT_MATERIAL_PAGE_API_URL = '/jvs-dam/api/dam/material/page'
+// 素材库配置状态（公网免版权素材检索 stock/search、单页模板、素材保存 API）
+export const DEFAULT_MATERIAL_API_URL = '/jvs-dam/stock/search'
+export const DEFAULT_MATERIAL_PAGE_API_URL = '/jvs-dam/stock/search'
 
 const defaultEnvMaterialUrl = (typeof import.meta !== 'undefined' && (import.meta as any).env) 
-  ? String((import.meta as any).env?.VITE_MATERIAL_TREE_API_URL || (import.meta as any).env?.VITE_MATERIAL_API_URL || (import.meta as any).env?.VITE_MATERIAL_LIST_API_URL || DEFAULT_MATERIAL_API_URL) 
+  ? String((import.meta as any).env?.VITE_MATERIAL_STOCK_API_URL || (import.meta as any).env?.VITE_MATERIAL_API_URL || (import.meta as any).env?.VITE_MATERIAL_LIST_API_URL || (import.meta as any).env?.VITE_MATERIAL_TREE_API_URL || DEFAULT_MATERIAL_API_URL) 
   : DEFAULT_MATERIAL_API_URL
 const defaultEnvMaterialPageUrl = (typeof import.meta !== 'undefined' && (import.meta as any).env) 
-  ? String((import.meta as any).env?.VITE_MATERIAL_PAGE_API_URL || DEFAULT_MATERIAL_PAGE_API_URL) 
+  ? String((import.meta as any).env?.VITE_MATERIAL_PAGE_API_URL || (import.meta as any).env?.VITE_MATERIAL_STOCK_API_URL || DEFAULT_MATERIAL_PAGE_API_URL) 
   : DEFAULT_MATERIAL_PAGE_API_URL
 const defaultEnvMaterialTypeUrl = (typeof import.meta !== 'undefined' && (import.meta as any).env?.VITE_MATERIAL_TYPE_API_URL) 
   ? String((import.meta as any).env.VITE_MATERIAL_TYPE_API_URL) 
@@ -357,11 +358,11 @@ const defaultEnvMaterialSaveUrl = (typeof import.meta !== 'undefined' && (import
   ? String((import.meta as any).env.VITE_MATERIAL_SAVE_API_URL) 
   : ''
 
-/** 素材库获取所有内容/首页分类树的 API 地址 */
+/** 素材库检索公网素材/所有内容的 API 地址 */
 const materialApiUrl = ref<string>(defaultEnvMaterialUrl)
-/** 素材库首页分类树 API 地址 */
+/** 素材库首页/分类检索 API 地址 */
 const materialTreeApiUrl = ref<string>(defaultEnvMaterialUrl)
-/** 素材库分页查询 API 地址 */
+/** 素材库分页/关键词检索 API 地址 */
 const materialPageApiUrl = ref<string>(defaultEnvMaterialPageUrl)
 /** 素材库按类型获取单独分类素材的 API 地址 */
 const materialTypeApiUrl = ref<string>(defaultEnvMaterialTypeUrl)
@@ -2497,6 +2498,7 @@ watch(formulaDialogVisible, (visible) => {
   }
 })
 const isPresenting = ref(false)
+const isReadonly = ref(false)
 const showNotification = ref(false)
 const notificationMsg = ref('')
 const shapeFormatPainter = ref<any>(null)
@@ -2958,6 +2960,7 @@ function applyHistoryEntry<T>(entryStrs: string[], currentStrs: string[], list:
 }
 
 function undo() {
+  if (isReadonly.value) return
   if (isMasterEditingView.value) {
     // 先落盘防抖中的快照：编辑后 350ms 内撤销不再丢最后一步编辑
     flushPendingMasterHistorySnapshot()
@@ -3009,6 +3012,7 @@ function undo() {
 }
 
 function redo() {
+  if (isReadonly.value) return
   if (isMasterEditingView.value) {
     flushPendingMasterHistorySnapshot()
     if (masterHistoryIndex.value < masterHistoryStack.value.length - 1) {
@@ -3183,6 +3187,7 @@ function escapeRegExp(string: string) {
 }
 
 function addSlide() {
+  if (isReadonly.value) return
   const newId = Date.now().toString()
   const insertIndex = slides.value.length > 0 ? activeIndex.value + 1 : 0
   const curSlide = slides.value[activeIndex.value]
@@ -3202,6 +3207,7 @@ function addSlide() {
 }
 
 function deleteSlide(index: number) {
+  if (isReadonly.value) return
   const isLastSlide = slides.value.length === 1
   if (isLastSlide) {
     const newSlide = {
@@ -3232,7 +3238,7 @@ function deleteSlide(index: number) {
 }
 
 function pasteSlideData(targetSlideData: any, afterIndex = activeIndex.value, isCut = false) {
-  if (!targetSlideData) return
+  if (isReadonly.value || !targetSlideData) return
 
   if (Array.isArray(targetSlideData)) {
     if (targetSlideData.length === 0) return
@@ -3445,7 +3451,7 @@ function scaleElementIfNeeded(el: any, sX: number, sY: number) {
 }
 
 function pasteElementsData(elementsArray: any[], options?: { sourceWidth?: number; sourceHeight?: number }) {
-  if (!activeSlide.value || !elementsArray || !Array.isArray(elementsArray) || elementsArray.length === 0) return
+  if (isReadonly.value || !activeSlide.value || !elementsArray || !Array.isArray(elementsArray) || elementsArray.length === 0) return
   const pastedIds: string[] = []
   const oldIdToNewId = new Map<string, string>()
   const oldGroupIdToNewGroupId = new Map<string, string>()
@@ -3889,7 +3895,7 @@ function selectAllSlides() {
 }
 
 function deleteSelectedSlides() {
-  if (!slides.value || slides.value.length === 0) return
+  if (isReadonly.value || !slides.value || slides.value.length === 0) return
   const sortedIndexes = [...selectedSlideIndexes.value].filter(i => i >= 0 && i < slides.value.length).sort((a, b) => b - a)
   if (sortedIndexes.length === 0) {
     deleteSlide(activeIndex.value)
@@ -3942,12 +3948,14 @@ function copySelectedSlides() {
 }
 
 function cutSelectedSlides() {
+  if (isReadonly.value) return
   copySelectedSlides()
   deleteSelectedSlides()
   notify('已剪切选中的幻灯片')
 }
 
 function duplicateSelectedSlides() {
+  if (isReadonly.value) return
   const indexes = [...selectedSlideIndexes.value].filter(i => i >= 0 && i < slides.value.length).sort((a, b) => a - b)
   if (indexes.length === 0) indexes.push(activeIndex.value)
   const lastIndex = indexes[indexes.length - 1]
@@ -3976,6 +3984,7 @@ function duplicateSelectedSlides() {
 }
 
 function applyBackground(bg: string) {
+  if (isReadonly.value) return
   if (activeSlide.value) {
     activeSlide.value.background = bg
     activeSlide.value.bgType = 'gradient'
@@ -4009,7 +4018,7 @@ function addElement(
   initialDimensions?: { width?: number; height?: number; left?: number; top?: number },
   extraOptions?: { textType?: SlideTextType; name?: string; [key: string]: any }
 ) {
-  if (!activeSlide.value) return
+  if (isReadonly.value || !activeSlide.value) return
 
   const recipe = getActiveSlideThemeRecipe(activeSlide.value)
 
@@ -4824,7 +4833,7 @@ function updateGroupBounds(groupEl: SlideElement) {
 
 // Delete Element from current slide
 function deleteElement(id: string, silent = false) {
-  if (!activeSlide.value) return
+  if (isReadonly.value || !activeSlide.value) return
   const hasTopLevel = activeSlide.value.elements.some(item => item.id === id)
   if (hasTopLevel) {
     activeSlide.value.elements = activeSlide.value.elements.filter(item => item.id !== id)
@@ -6582,7 +6591,7 @@ function convertPPTistToLocalIfNeed(newSlides: any): Slide[] {
         const grpFlipH = !!(el.flipH || el.isFlipH || el.style?.flipH)
         const grpFlipV = !!(el.flipV || el.isFlipV || el.style?.flipV)
 
-        return {
+        const groupObj: any = {
           id: el.id || 'group_' + Date.now().toString(36) + Math.random().toString(36).substring(2, 7),
           type: 'group',
           name: el.name || '组合',
@@ -6601,6 +6610,12 @@ function convertPPTistToLocalIfNeed(newSlides: any): Slide[] {
           isFlipV: grpFlipV,
           elements: el.elements.map((child: any) => convertChildRecursive(child, topW, topH))
         }
+
+        if (grpFlipH || grpFlipV) {
+          applyGroupGeometryFlip(groupObj, grpFlipH, grpFlipV)
+        }
+
+        return groupObj
       }
 
       const elemPattern = extractPatternFromFill(el)
@@ -7283,6 +7298,9 @@ function preprocessImportedSlides(slides: any[]) {
           }
           processEl(child, grpW, grpH)
         })
+        if (el.flipH || el.isFlipH || el.style?.flipH || el.flipV || el.isFlipV || el.style?.flipV) {
+          applyGroupGeometryFlip(el)
+        }
       }
     }
     for (const el of slide.elements) {
@@ -9255,6 +9273,7 @@ export function useSlides() {
     selectedElementIds,
     croppingElementId,
     isPresenting,
+    isReadonly,
     showNotification,
     notificationMsg,
     notify,

package/src/utils/groupFlip.ts

@@ -0,0 +1,108 @@
+/**
+ * 组合 (Group) 翻转与几何镜像计算工具函数
+ * 
+ * 遵循微软 PowerPoint / DrawingML 规范标准：
+ * 当对组合执行水平/垂直翻转时：
+ * 1. 组合内部子元素的相对几何位置镜像对调（left / top 沿中心线镜像）；
+ * 2. 子元素若是形状/图片，其自身的翻转状态联动反转；
+ * 3. 子元素若是纯文本（Text），文字字形永远保持正向可读（Text is never mirrored），禁止倒影；
+ * 4. 几何镜像处理完成后，Group 容器自身不再需要使用 CSS scale(-1) 进行整体物理镜像。
+ */
+
+export function applyGroupGeometryFlip(group: any, forceFlipH?: boolean, forceFlipV?: boolean) {
+  if (!group || !Array.isArray(group.elements) || group.elements.length === 0) return
+
+  const flipH = forceFlipH !== undefined ? forceFlipH : Boolean(group.flipH || group.isFlipH || group.style?.flipH)
+  const flipV = forceFlipV !== undefined ? forceFlipV : Boolean(group.flipV || group.isFlipV || group.style?.flipV)
+
+  if (!flipH && !flipV) return
+
+  const grpW = typeof group.width === 'number' && group.width > 0 ? group.width : (parseFloat(group.style?.width) || 0)
+  const grpH = typeof group.height === 'number' && group.height > 0 ? group.height : (parseFloat(group.style?.height) || 0)
+
+  for (const child of group.elements) {
+    if (!child) continue
+
+    // 1. 水平翻转：镜像相对水平位置
+    if (flipH) {
+      if (typeof child.style?.left === 'string' && child.style.left.endsWith('%')) {
+        const lPct = parseFloat(child.style.left) || 0
+        const wPct = parseFloat(child.style.width) || 0
+        child.style.left = `${+(100 - lPct - wPct).toFixed(4)}%`
+      } else if (typeof child.left === 'number' && grpW > 0) {
+        const cW = typeof child.width === 'number' ? child.width : (parseFloat(child.style?.width) || 0)
+        child.left = +(grpW - child.left - cW).toFixed(4)
+      }
+    }
+
+    // 2. 垂直翻转：镜像相对垂直位置
+    if (flipV) {
+      if (typeof child.style?.top === 'string' && child.style.top.endsWith('%')) {
+        const tPct = parseFloat(child.style.top) || 0
+        const hPct = parseFloat(child.style.height) || 0
+        child.style.top = `${+(100 - tPct - hPct).toFixed(4)}%`
+      } else if (typeof child.top === 'number' && grpH > 0) {
+        const cH = typeof child.height === 'number' ? child.height : (parseFloat(child.style?.height) || 0)
+        child.top = +(grpH - child.top - cH).toFixed(4)
+      }
+    }
+
+    // 3. 子元素自身翻转状态更新：纯文本和连线永不翻转，形状/图片等反转
+    const is2DArrow = /^(?:rightArrow|leftArrow|upArrow|downArrow|leftRightArrow|upDownArrow|quadArrow|leftRightUpArrow|bentArrow|uturnArrow|leftUpArrow|bentUpArrow|curvedRightArrow|curvedLeftArrow|curvedUpArrow|curvedDownArrow|stripedRightArrow|notchedRightArrow|pentagon|chevron|circularArrow|swooshArrow|.*ArrowCallout)$/i.test(String(child.shapType || ''))
+    const isConnector = !is2DArrow && (
+      child.type === 'line' ||
+      Boolean(child.startConnection || child.endConnection) ||
+      Boolean(child.borderTailEnd || child.borderHeadEnd) ||
+      /^(?:line|straightConnector\d*|bentConnector\d*|curvedConnector\d*)$/i.test(String(child.shapType || '')) ||
+      (/连接符/i.test(String(child.name || '')) && !is2DArrow)
+    )
+    const isPureText = child.type === 'text' || isConnector
+
+    if (isPureText) {
+      child.flipH = false
+      child.isFlipH = false
+      if (child.style) child.style.flipH = false
+      child.flipV = false
+      child.isFlipV = false
+      if (child.style) child.style.flipV = false
+    } else if (child.type === 'group') {
+      applyGroupGeometryFlip(child, flipH, flipV)
+    } else {
+      if (flipH) {
+        const curH = Boolean(child.flipH || child.isFlipH || child.style?.flipH)
+        child.flipH = !curH
+        child.isFlipH = !curH
+        if (child.style) child.style.flipH = !curH
+      }
+      if (flipV) {
+        const curV = Boolean(child.flipV || child.isFlipV || child.style?.flipV)
+        child.flipV = !curV
+        child.isFlipV = !curV
+        if (child.style) child.style.flipV = !curV
+      }
+    }
+  }
+
+  // 4. 子元素全部完成几何镜像后，Group 容器自身无需再 scale 镜像，避免将内部文本整体反转为倒影字
+  group.flipH = false
+  group.isFlipH = false
+  if (group.style) {
+    group.style.flipH = false
+    group.style.flipV = false
+  }
+  group.flipV = false
+  group.isFlipV = false
+}
+
+/**
+ * 判断一个元素是否为包含文本的组合元素（或纯文本元素），
+ * 渲染层用此判断避免在外层容器施加 scale(-1) 导致内部文字倒影。
+ */
+export function isTextContainingElement(el: any): boolean {
+  if (!el) return false
+  if (el.type === 'text' || el.type === 'line') return true
+  if (el.type === 'group' && Array.isArray(el.elements)) {
+    return el.elements.some((child: any) => isTextContainingElement(child))
+  }
+  return false
+}