@courtifyai/docx-render 1.0.0 → 1.0.1

package/src/theme/theme-parser.ts

@@ -1,172 +0,0 @@
-/**
- * 主题解析器
- * 解析 DOCX 主题 XML（word/theme/theme1.xml）
- */
-
-import { ITheme, IColorScheme, IFontScheme, IFontInfo, IThemeColors } from '../types'
-
-/**
- * 解析主题 XML
- */
-export function parseTheme(root: Element): ITheme {
-  const theme: ITheme = {
-    colorScheme: { name: '', colors: {} },
-    fontScheme: { name: '', majorFont: {}, minorFont: {} },
-  }
-  
-  // 查找 a:themeElements
-  const themeElements = findElement(root, 'themeElements')
-  if (!themeElements) return theme
-  
-  // 遍历主题元素
-  for (const el of getChildElements(themeElements)) {
-    const localName = el.localName
-    
-    if (localName === 'clrScheme') {
-      theme.colorScheme = parseColorScheme(el)
-    } else if (localName === 'fontScheme') {
-      theme.fontScheme = parseFontScheme(el)
-    }
-  }
-  
-  return theme
-}
-
-/**
- * 解析颜色方案
- * <a:clrScheme name="Office">
- *   <a:dk1><a:sysClr val="windowText" lastClr="000000"/></a:dk1>
- *   <a:lt1><a:sysClr val="window" lastClr="FFFFFF"/></a:lt1>
- *   <a:accent1><a:srgbClr val="4472C4"/></a:accent1>
- *   ...
- * </a:clrScheme>
- */
-export function parseColorScheme(el: Element): IColorScheme {
-  const result: IColorScheme = {
-    name: el.getAttribute('name') || '',
-    colors: {},
-  }
-  
-  // 遍历每个颜色定义
-  for (const colorEl of getChildElements(el)) {
-    const colorName = colorEl.localName
-    const colorValue = extractColorValue(colorEl)
-    
-    if (colorValue) {
-      result.colors[colorName as keyof IThemeColors] = colorValue
-    }
-  }
-  
-  return result
-}
-
-/**
- * 提取颜色值
- * 支持 srgbClr 和 sysClr 两种格式
- */
-function extractColorValue(colorEl: Element): string | null {
-  // 尝试 srgbClr
-  const srgbClr = findElement(colorEl, 'srgbClr')
-  if (srgbClr) {
-    const val = srgbClr.getAttribute('val')
-    return val ? `#${val}` : null
-  }
-  
-  // 尝试 sysClr（系统颜色，取 lastClr 属性）
-  const sysClr = findElement(colorEl, 'sysClr')
-  if (sysClr) {
-    const lastClr = sysClr.getAttribute('lastClr')
-    return lastClr ? `#${lastClr}` : null
-  }
-  
-  return null
-}
-
-/**
- * 解析字体方案
- * <a:fontScheme name="Office">
- *   <a:majorFont>
- *     <a:latin typeface="Calibri Light"/>
- *     <a:ea typeface=""/>
- *     <a:cs typeface=""/>
- *   </a:majorFont>
- *   <a:minorFont>
- *     <a:latin typeface="Calibri"/>
- *     <a:ea typeface=""/>
- *     <a:cs typeface=""/>
- *   </a:minorFont>
- * </a:fontScheme>
- */
-export function parseFontScheme(el: Element): IFontScheme {
-  const result: IFontScheme = {
-    name: el.getAttribute('name') || '',
-    majorFont: {},
-    minorFont: {},
-  }
-  
-  for (const fontEl of getChildElements(el)) {
-    const localName = fontEl.localName
-    
-    if (localName === 'majorFont') {
-      result.majorFont = parseFontInfo(fontEl)
-    } else if (localName === 'minorFont') {
-      result.minorFont = parseFontInfo(fontEl)
-    }
-  }
-  
-  return result
-}
-
-/**
- * 解析字体信息
- */
-function parseFontInfo(el: Element): IFontInfo {
-  const result: IFontInfo = {}
-  
-  for (const child of getChildElements(el)) {
-    const localName = child.localName
-    const typeface = child.getAttribute('typeface')
-    
-    if (typeface) {
-      if (localName === 'latin') {
-        result.latin = typeface
-      } else if (localName === 'ea') {
-        result.ea = typeface
-      } else if (localName === 'cs') {
-        result.cs = typeface
-      }
-    }
-  }
-  
-  return result
-}
-
-/**
- * 查找子元素（忽略命名空间）
- */
-function findElement(parent: Element, localName: string): Element | null {
-  for (let i = 0; i < parent.childNodes.length; i++) {
-    const node = parent.childNodes[i]
-    if (node.nodeType === Node.ELEMENT_NODE) {
-      const el = node as Element
-      if (el.localName === localName) {
-        return el
-      }
-    }
-  }
-  return null
-}
-
-/**
- * 获取所有子元素
- */
-function getChildElements(parent: Element): Element[] {
-  const result: Element[] = []
-  for (let i = 0; i < parent.childNodes.length; i++) {
-    const node = parent.childNodes[i]
-    if (node.nodeType === Node.ELEMENT_NODE) {
-      result.push(node as Element)
-    }
-  }
-  return result
-}

package/src/theme/theme-utils.ts

@@ -1,148 +0,0 @@
-/**
- * 主题颜色工具函数
- * 提供主题颜色解析和转换能力
- */
-
-import { ITheme, IThemeColorRef, IThemeColors } from '../types'
-
-/**
- * 主题颜色名称到标准名称的映射
- * Word 使用的属性名和 theme.xml 中的元素名可能不同
- */
-const THEME_COLOR_MAP: Record<string, keyof IThemeColors> = {
-  // 标准映射
-  dark1: 'dk1',
-  dark2: 'dk2',
-  light1: 'lt1',
-  light2: 'lt2',
-  accent1: 'accent1',
-  accent2: 'accent2',
-  accent3: 'accent3',
-  accent4: 'accent4',
-  accent5: 'accent5',
-  accent6: 'accent6',
-  hyperlink: 'hlink',
-  followedHyperlink: 'folHlink',
-  // 直接映射（XML 中的原始名称）
-  dk1: 'dk1',
-  dk2: 'dk2',
-  lt1: 'lt1',
-  lt2: 'lt2',
-  hlink: 'hlink',
-  folHlink: 'folHlink',
-  // 文本颜色别名
-  text1: 'dk1',
-  text2: 'dk2',
-  background1: 'lt1',
-  background2: 'lt2',
-}
-
-/**
- * 解析主题颜色引用，返回实际颜色值
- * 
- * @param theme - 主题对象
- * @param colorRef - 主题颜色引用
- * @returns 解析后的颜色值（如 #RRGGBB）或 undefined
- */
-export function resolveThemeColor(
-  theme: ITheme | undefined,
-  colorRef: IThemeColorRef
-): string | undefined {
-  if (!theme?.colorScheme?.colors) return undefined
-  
-  const themeColorName = colorRef.themeColor
-  const mappedName = THEME_COLOR_MAP[themeColorName] || themeColorName
-  const baseColor = theme.colorScheme.colors[mappedName]
-  
-  if (!baseColor) return undefined
-  
-  // 如果有 tint 或 shade，需要调整颜色
-  if (colorRef.themeTint !== undefined || colorRef.themeShade !== undefined) {
-    return applyTintShade(baseColor, colorRef.themeTint, colorRef.themeShade)
-  }
-  
-  return baseColor
-}
-
-/**
- * 应用色调（tint）和阴影（shade）调整
- * 
- * tint: 向白色混合（0 = 原色，255 = 纯白）
- * shade: 向黑色混合（0 = 原色，255 = 纯黑）
- * 
- * @param color - 基础颜色（#RRGGBB 格式）
- * @param tint - 色调值（0-255）
- * @param shade - 阴影值（0-255）
- * @returns 调整后的颜色
- */
-export function applyTintShade(
-  color: string,
-  tint?: number,
-  shade?: number
-): string {
-  // 解析颜色
-  const hex = color.replace('#', '')
-  const r = parseInt(hex.substr(0, 2), 16)
-  const g = parseInt(hex.substr(2, 2), 16)
-  const b = parseInt(hex.substr(4, 2), 16)
-  
-  let finalR = r
-  let finalG = g
-  let finalB = b
-  
-  // 应用 tint（向白色混合）
-  // OOXML 规范: result = color + (255 - color) * tint / 255
-  if (tint !== undefined && tint > 0) {
-    const tintFactor = tint / 255
-    finalR = Math.round(r + (255 - r) * tintFactor)
-    finalG = Math.round(g + (255 - g) * tintFactor)
-    finalB = Math.round(b + (255 - b) * tintFactor)
-  }
-  
-  // 应用 shade（向黑色混合）
-  // OOXML 规范: result = color * (1 - shade / 255)
-  if (shade !== undefined && shade > 0) {
-    const shadeFactor = 1 - shade / 255
-    finalR = Math.round(finalR * shadeFactor)
-    finalG = Math.round(finalG * shadeFactor)
-    finalB = Math.round(finalB * shadeFactor)
-  }
-  
-  // 确保在有效范围内
-  finalR = Math.max(0, Math.min(255, finalR))
-  finalG = Math.max(0, Math.min(255, finalG))
-  finalB = Math.max(0, Math.min(255, finalB))
-  
-  // 转回 hex
-  return `#${toHex(finalR)}${toHex(finalG)}${toHex(finalB)}`
-}
-
-/**
- * 数字转两位十六进制
- */
-function toHex(n: number): string {
-  const hex = n.toString(16)
-  return hex.length === 1 ? '0' + hex : hex
-}
-
-/**
- * 获取主题字体
- * 
- * @param theme - 主题对象
- * @param fontType - 字体类型（major/minor）
- * @param script - 文字类型（latin/ea/cs）
- * @returns 字体名称或 undefined
- */
-export function resolveThemeFont(
-  theme: ITheme | undefined,
-  fontType: 'major' | 'minor',
-  script: 'latin' | 'ea' | 'cs' = 'latin'
-): string | undefined {
-  if (!theme?.fontScheme) return undefined
-  
-  const fontInfo = fontType === 'major' 
-    ? theme.fontScheme.majorFont 
-    : theme.fontScheme.minorFont
-  
-  return fontInfo[script]
-}