zcw-shared 1.10.5 → 1.11.1

package/README.md

@@ -510,4 +510,146 @@ playground/           # 功能验证环境（用于测试shared包功能，有
 - [ ] JSDoc 文档完整
 - [ ] 遵循命名规范
 - [ ] 通过 playground 验证
-- [ ] 符合项目架构原则
+- [ ] 符合项目架构原则
+
+## Git Commit 规范
+
+### 12. Commit 消息格式要求
+
+#### 12.1 基本格式
+
+所有 commit 消息必须遵循以下格式：
+
+```
+<type>(<scope>): <description> - <changed_files>
+
+[optional body]
+
+[optional footer]
+```
+
+**必填字段**:
+- `type`: 变更类型（见下方类型说明）
+- `scope`: 影响范围（可选，但推荐）
+- `description`: 简短描述变更内容
+- `changed_files`: **必须包含所有变更的文件名**
+
+#### 12.2 变更类型 (type)
+
+- **feat**: 新功能
+- **fix**: 修复 bug
+- **docs**: 文档变更
+- **style**: 代码格式变更（不影响功能）
+- **refactor**: 重构（既不是新功能也不是修复）
+- **test**: 测试相关变更
+- **chore**: 构建过程或辅助工具的变更
+- **perf**: 性能优化
+- **ci**: CI/CD 相关变更
+
+#### 12.3 影响范围 (scope)
+
+推荐使用以下范围标识：
+- **functions**: 函数相关变更
+- **types**: 类型定义变更
+- **constants**: 常量定义变更
+- **build**: 构建配置变更
+- **docs**: 文档变更
+- **test**: 测试相关变更
+
+#### 12.4 文件名要求
+
+**必须在 commit 消息中包含所有变更的文件名**，格式如下：
+
+- 单个文件：`- convertColor.ts`
+- 多个文件：`- convertColor.ts, convertColor.test.ts`
+- 新增文件：`- add: newFunction.ts`
+- 删除文件：`- remove: oldFunction.ts`
+- 重命名文件：`- rename: oldName.ts -> newName.ts`
+
+#### 12.5 Commit 示例
+
+**修复示例**:
+```
+fix(functions): 修复 includeAlpha 参数强制透明度功能 - convertColor.ts, convertColor.test.ts
+
+- 修复 formatHex 函数中 includeAlpha 逻辑
+- 更新 ColorFormatters 中 rgb 和 hsl 格式化器
+- 添加 includeAlpha 强制透明度测试用例
+```
+
+**新功能示例**:
+```
+feat(functions): 添加图像压缩功能 - add: compressImage.ts, imageTypes.ts
+
+- 实现基于 Sharp 的图像压缩功能
+- 支持 JPEG、PNG、WebP 格式
+- 添加压缩质量和尺寸控制选项
+```
+
+**文档更新示例**:
+```
+docs: 添加 commit 规范要求 - README.md
+
+- 添加 commit 消息格式要求
+- 明确文件名包含规则
+- 说明版本发布策略
+```
+
+### 13. 版本发布策略
+
+#### 13.1 版本类型选择
+
+根据变更类型选择合适的版本发布命令：
+
+**Patch 版本 (x.x.X)**:
+- **使用场景**: 修复 bug、文档更新、代码格式调整
+- **发布命令**: `npm run publish:patch`
+- **对应 commit 类型**: `fix`, `docs`, `style`, `chore`
+
+**Minor 版本 (x.X.x)**:
+- **使用场景**: 新功能添加、API 扩展（向后兼容）
+- **发布命令**: `npm run publish:minor`
+- **对应 commit 类型**: `feat`, `perf`
+
+**Major 版本 (X.x.x)**:
+- **使用场景**: 破坏性变更、API 重构
+- **发布命令**: `npm run publish:major`
+- **对应 commit 类型**: 带有 `BREAKING CHANGE` 的任何类型
+
+#### 13.2 发布流程
+
+1. **提交变更**: 确保 commit 消息符合规范
+2. **选择版本**: 根据变更类型选择合适的版本
+3. **执行发布**: 运行对应的发布命令
+4. **验证发布**: 确认新版本已成功发布到 npm
+
+#### 13.3 发布检查清单
+
+发布前请确保：
+- [ ] 所有测试通过
+- [ ] 代码符合编码规范
+- [ ] Commit 消息包含变更文件名
+- [ ] 选择了正确的版本类型
+- [ ] 更新了相关文档（如需要）
+
+#### 13.4 版本发布示例
+
+**修复发布**:
+```bash
+# 1. 提交修复
+git add .
+git commit -m "fix(functions): 修复颜色转换精度问题 - convertColor.ts, colorUtils.ts"
+
+# 2. 发布 patch 版本
+npm run publish:patch
+```
+
+**新功能发布**:
+```bash
+# 1. 提交新功能
+git add .
+git commit -m "feat(functions): 添加图像水印功能 - add: addWatermark.ts, watermarkTypes.ts"
+
+# 2. 发布 minor 版本
+npm run publish:minor
+```

package/dist/functions/color/deduplicateColors.d.ts

@@ -1,4 +1,4 @@
-import type { ColorReference } from '../../../types/color.d';
+import type { ColorReference } from '../../../types/design-system.d';
 export declare function deduplicateColors(colors: ColorReference[]): ColorReference[];
 export declare function deduplicateColorsByValue(colors: ColorReference[]): ColorReference[];
 export declare function deduplicateColorsByStandardizedValue(colors: ColorReference[], standardizeColor: (color: string) => string): ColorReference[];

package/dist/functions/color/extractColors.d.ts

@@ -1,5 +1,5 @@
-import type { ColorReference } from '../../../types/color.d';
+import type { ColorReference } from '../../../types/design-system.d';
 export declare function extractColors(text: string, filePath?: string, options?: {
     validOnly?: boolean;
 }): ColorReference[];
-export declare function extractColorsFromLine(line: string, lineNumber: number, filePath: string): ColorReference[];
+export declare function extractColorsFromLine(line: string, lineNumber: number, filePath: string, validOnly?: boolean): ColorReference[];

package/dist/functions/color/extractColors.js

@@ -1,4 +1,5 @@
 import { COLOR_PATTERNS } from '../../constants/colorPatterns';
+import { detectColorFormat } from './detectColorFormat';
 export function extractColors(text, filePath = '', options = {}) {
     const { validOnly = true } = options;
     if (!text || typeof text !== 'string') {
@@ -7,12 +8,12 @@ export function extractColors(text, filePath = '', options = {}) {
     const colors = [];
     const lines = text.split('\n');
     lines.forEach((line, lineIndex) => {
-        const lineColors = extractColorsFromLine(line, lineIndex + 1, filePath);
+        const lineColors = extractColorsFromLine(line, lineIndex + 1, filePath, validOnly);
         colors.push(...lineColors);
     });
     return colors;
 }
-export function extractColorsFromLine(line, lineNumber, filePath) {
+export function extractColorsFromLine(line, lineNumber, filePath, validOnly = true) {
     const colors = [];
     const allMatches = [];
     Object.entries(COLOR_PATTERNS).forEach(([format, pattern]) => {
@@ -25,7 +26,15 @@ export function extractColorsFromLine(line, lineNumber, filePath) {
     allMatches.forEach(match => {
         const existingMatches = allMatches.filter(m => colors.some(c => c.originalValue === m.value));
         if (!isOverlapping(match, existingMatches)) {
-            colors.push(createColorReference(match.value, match.format, lineNumber - 1, filePath, line.trim()));
+            if (validOnly) {
+                const validation = detectColorFormat(match.value);
+                if (validation.isValid) {
+                    colors.push(createColorReference(match.value, match.format, lineNumber, filePath, line.trim()));
+                }
+            }
+            else {
+                colors.push(createColorReference(match.value, match.format, lineNumber, filePath, line.trim()));
+            }
         }
     });
     return colors;
@@ -50,11 +59,11 @@ function isOverlapping(match, otherMatches) {
             (match.start <= other.start && match.end >= other.end));
     });
 }
-function createColorReference(colorValue, format, lineIndex, filePath, context) {
+function createColorReference(colorValue, format, lineNumber, filePath, context) {
     return {
         originalValue: colorValue,
         format,
-        line: lineIndex + 1,
+        line: lineNumber,
         file: filePath,
         context
     };

package/dist/functions/color/extractColors.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractColors.js","sourceRoot":"","sources":["../../../src/functions/color/extractColors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extractColors.js","sourceRoot":"","sources":["../../../src/functions/color/extractColors.ts"],"names":[],"mappings":"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"}

package/dist/functions/css/extractCssVariables.d.ts

@@ -1,9 +1,5 @@
-import type { ColorReference } from '../../../types/color.d';
-export interface CssVariableExtractionOptions {
-    validOnly?: boolean;
-    cssVariables?: Record<string, string>;
-}
-export declare function extractCssVariables(text: string, filePath: string, options?: CssVariableExtractionOptions): ColorReference[];
+import type { DesignToken } from '../../../types/design-system.d';
+export declare function extractCssVariables(text: string, filePath: string): DesignToken[];
 export declare function extractCssVariableDefinitions(text: string): Array<{
     variableName: string;
     value: string;

package/dist/functions/css/extractCssVariables.js

@@ -1,27 +1,21 @@
-export function extractCssVariables(text, filePath, options = {}) {
-    const { validOnly = true, cssVariables = {} } = options;
+export function extractCssVariables(text, filePath) {
     if (!text || typeof text !== 'string') {
         return [];
     }
     const variables = [];
     const lines = text.split('\n');
-    const cssVarPattern = /var\(\s*(--[\w-]+)(?:\s*,\s*([^)]+))?\s*\)/g;
+    const cssVarPattern = /var\(\s*(--[\w-]+)(?:\s*,\s*([^)]*))?\s*\)/g;
     lines.forEach((line, lineIndex) => {
         let match;
         while ((match = cssVarPattern.exec(line)) !== null) {
-            const [fullMatch, variableName, fallback] = match;
-            const variableValue = cssVariables[variableName];
-            if (validOnly && !variableValue && !fallback) {
-                continue;
-            }
+            const [fullMatch, variableName, fallbackValue] = match;
             variables.push({
-                originalValue: fullMatch,
-                format: 'css-variable',
+                name: variableName,
+                value: fullMatch,
+                type: 'color',
                 line: lineIndex + 1,
                 file: filePath,
-                context: line.trim(),
-                isVariableReference: true,
-                variableName
+                context: line.trim()
             });
         }
         cssVarPattern.lastIndex = 0;
@@ -34,7 +28,7 @@ export function extractCssVariableDefinitions(text) {
     }
     const definitions = [];
     const lines = text.split('\n');
-    const cssVarDefPattern = /--(\w[\w-]*?)\s*:\s*([^;]+);/g;
+    const cssVarDefPattern = /^\s*--((?:[a-zA-Z_\u0080-\uFFFF])(?:[a-zA-Z0-9_\u0080-\uFFFF-])*)\s*:\s*([^;]+);/gm;
     lines.forEach((line, lineIndex) => {
         let match;
         while ((match = cssVarDefPattern.exec(line)) !== null) {

package/dist/functions/css/extractCssVariables.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractCssVariables.js","sourceRoot":"","sources":["../../../src/functions/css/extractCssVariables.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAAgB,EAChB,UAAwC,EAAE;IAE1C,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;IAEvD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,SAAS,GAAqB,EAAE,CAAA;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAG9B,MAAM,aAAa,GAAG,6CAA6C,CAAA;IAEnE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAA;YACjD,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,CAAA;YAGhD,IAAI,SAAS,IAAI,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC7C,SAAQ;YACV,CAAC;YAED,SAAS,CAAC,IAAI,CAAC;gBACb,aAAa,EAAE,SAAS;gBACxB,MAAM,EAAE,cAA6B;gBACrC,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;gBACpB,mBAAmB,EAAE,IAAI;gBACzB,YAAY;aACb,CAAC,CAAA;QACJ,CAAC;QAGD,aAAa,CAAC,SAAS,GAAG,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAA;AAClB,CAAC;AASD,MAAM,UAAU,6BAA6B,CAC3C,IAAY;IAOZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAKZ,EAAE,CAAA;IAEP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAG9B,MAAM,gBAAgB,GAAG,+BAA+B,CAAA;IAExD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;YAErC,WAAW,CAAC,IAAI,CAAC;gBACf,YAAY,EAAE,KAAK,YAAY,EAAE;gBACjC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;gBACnB,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;aACrB,CAAC,CAAA;QACJ,CAAC;QAGD,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}
+{"version":3,"file":"extractCssVariables.js","sourceRoot":"","sources":["../../../src/functions/css/extractCssVariables.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,QAAgB;IAEhB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,SAAS,GAAkB,EAAE,CAAA;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAI9B,MAAM,aAAa,GAAG,6CAA6C,CAAA;IAEnE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC,GAAG,KAAK,CAAA;YAEtD,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;aACrB,CAAC,CAAA;QACJ,CAAC;QAGD,aAAa,CAAC,SAAS,GAAG,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;IAEF,OAAO,SAAS,CAAA;AAClB,CAAC;AASD,MAAM,UAAU,6BAA6B,CAC3C,IAAY;IAOZ,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAKZ,EAAE,CAAA;IAEP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAM9B,MAAM,gBAAgB,GAAG,oFAAoF,CAAA;IAE7G,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QAChC,IAAI,KAAK,CAAA;QACT,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACtD,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;YAErC,WAAW,CAAC,IAAI,CAAC;gBACf,YAAY,EAAE,KAAK,YAAY,EAAE;gBACjC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;gBACnB,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;aACrB,CAAC,CAAA;QACJ,CAAC;QAGD,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/functions/vue/extractColorsFromVueFile.d.ts

@@ -1,3 +1,3 @@
-import type { ColorReference } from '../../../types/color.d';
+import type { ColorReference } from '../../../types/design-system.d';
 import type { VueProcessingOptions } from '../../../types/vue.d';
 export declare function extractColorsFromVueFile(code: string, filePath: string, options?: VueProcessingOptions): ColorReference[];

package/dist/functions/vue/extractColorsFromVueSection.d.ts

@@ -1,3 +1,3 @@
-import type { ColorReference } from '../../../types/color.d';
+import type { ColorReference } from '../../../types/design-system.d';
 import type { VueSection, VueProcessingOptions } from '../../../types/vue.d';
 export declare function extractColorsFromVueSection(section: VueSection, filePath: string, options?: VueProcessingOptions): ColorReference[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.10.5",
+  "version": "1.11.1",
   "files": [
     "references",
     "dist",
@@ -113,6 +113,7 @@
     "./types/altool": "./types/altool.d.ts",
     "./types/android-build": "./types/android-build.d.ts",
     "./types/color": "./types/color.d.ts",
+    "./types/design-system": "./types/design-system.d.ts",
     "./types/geometry": "./types/geometry.d.ts",
     "./types/platform": "./types/platform.d.ts",
     "./types/software": "./types/software.d.ts",

package/types/color.d.ts

@@ -37,37 +37,4 @@ export interface HslColor {
  */
 export interface HslaColor extends HslColor {
   a: number
-}
-
-/**
- * 颜色引用信息
- * 用于记录在代码中发现的颜色值及其位置信息
- */
-export interface ColorReference {
-  /** 原始颜色值 */
-  originalValue: string
-  /** 颜色格式 */
-  format: ColorFormat | 'css-variable' | 'third-party-variable'
-  /** 文件路径 */
-  file: string
-  /** 行号 */
-  line: number
-  /** 上下文代码 */
-  context: string
-  /** 是否为变量引用 */
-  isVariableReference?: boolean
-  /** 变量名称（如果是变量引用） */
-  variableName?: string
-}
-
-/**
- * 颜色提取选项
- */
-export interface ColorExtractionOptions {
-  /** 是否只提取有效的颜色值 */
-  validOnly?: boolean
-  /** CSS变量映射 */
-  cssVariables?: Record<string, string>
-  /** 第三方变量映射 */
-  thirdPartyVariables?: Record<string, string>
 }

package/types/design-system.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 设计系统相关类型定义
+ */
+
+/**
+ * 设计令牌接口
+ * 用于表示设计系统中的各种令牌（颜色、间距、字体等）
+ */
+export interface DesignToken {
+  /** 令牌名称 */
+  name: string
+  /** 令牌值 */
+  value: string
+  /** 令牌类型 */
+  type: 'color' | 'spacing' | 'typography' | 'border' | 'shadow' | 'animation'
+  /** 文件路径 */
+  file: string
+  /** 行号 */
+  line: number
+  /** 上下文代码 */
+  context: string
+}
+
+/**
+ * 颜色引用信息
+ * 用于记录在代码中发现的颜色值及其位置信息
+ */
+export interface ColorReference {
+  /** 原始颜色值 */
+  originalValue: string
+  /** 颜色格式 */
+  format: 'hex' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'named'
+  /** 文件路径 */
+  file: string
+  /** 行号 */
+  line: number
+  /** 上下文代码 */
+  context: string
+}

package/types/vue.d.ts

@@ -1,4 +1,4 @@
-import type { ColorReference, ColorExtractionOptions } from './color.d'
+import type { ColorReference } from './design-system.d'
 
 /**
  * Vue文件section类型
@@ -22,7 +22,9 @@ export interface VueSection {
 /**
  * Vue文件处理选项
  */
-export interface VueProcessingOptions extends ColorExtractionOptions {
+export interface VueProcessingOptions {
+  /** 是否只提取有效的颜色值 */
+  validOnly?: boolean
   /** 是否只处理特定的section类型 */
   includeSections?: VueSectionType[]
   /** 是否排除特定的section类型 */