zcw-shared 1.2.0 → 1.3.0

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

@@ -0,0 +1,16 @@
+import type { ColorReference, ColorFormat, ColorPatterns } from '../../../types/color.d';
+export interface ColorExtractorDependencies {
+    getColorPatterns: () => ColorPatterns;
+    standardizeColor: (color: string) => string;
+    detectColorFormat: (color: string) => ColorFormat | null;
+    isColorValue: (value: string) => {
+        isValid: boolean;
+        format?: ColorFormat;
+    };
+}
+export interface ColorExtractionOptions {
+    cssVariables?: Record<string, string>;
+    thirdPartyVariables?: Record<string, string>;
+}
+export declare function extractColors(code: string, filePath: string, dependencies: ColorExtractorDependencies, options?: ColorExtractionOptions): ColorReference[];
+export declare function extractColorsFromLine(line: string, filePath: string, lineNumber: number, dependencies: ColorExtractorDependencies, options?: ColorExtractionOptions): ColorReference[];

package/dist/functions/color-converter/extractColors.js

@@ -0,0 +1,111 @@
+export function extractColors(code, filePath, dependencies, options = {}) {
+    const { cssVariables = {}, thirdPartyVariables = {} } = options;
+    const colors = [];
+    const lines = code.split('\n');
+    const parsedCssVariables = parseCssVariables(code, filePath, dependencies);
+    const allCssVariables = { ...cssVariables, ...parsedCssVariables };
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        const lineNumber = lineIndex + 1;
+        colors.push(...extractColorsFromLine(line, filePath, lineNumber, dependencies, { cssVariables: allCssVariables, thirdPartyVariables }));
+    }
+    return colors;
+}
+export function extractColorsFromLine(line, filePath, lineNumber, dependencies, options = {}) {
+    const { cssVariables = {}, thirdPartyVariables = {} } = options;
+    const colors = [];
+    const patterns = dependencies.getColorPatterns();
+    colors.push(...extractHexColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractRgbColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractRgbaColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractHslColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractHslaColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractNamedColors(line, filePath, lineNumber, patterns, dependencies));
+    colors.push(...extractCssVariableReferences(line, filePath, lineNumber, patterns, cssVariables));
+    colors.push(...extractThirdPartyVariableReferences(line, filePath, lineNumber, patterns, thirdPartyVariables));
+    return colors;
+}
+function extractHexColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.hex, 'hex', dependencies);
+}
+function extractRgbColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.rgb, 'rgb', dependencies);
+}
+function extractRgbaColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.rgba, 'rgba', dependencies);
+}
+function extractHslColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.hsl, 'hsl', dependencies);
+}
+function extractHslaColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.hsla, 'hsla', dependencies);
+}
+function extractNamedColors(line, filePath, lineNumber, patterns, dependencies) {
+    return extractColorsGeneric(line, filePath, lineNumber, patterns.namedColors, 'named', dependencies);
+}
+function extractCssVariableReferences(line, filePath, lineNumber, patterns, cssVariables) {
+    const colors = [];
+    const cssVarPattern = /var\(\s*--([\w-]+)\s*\)/g;
+    const matches = line.matchAll(cssVarPattern);
+    for (const match of matches) {
+        const variableName = match[1];
+        const variableValue = cssVariables[variableName];
+        if (variableValue) {
+            colors.push(createColorReference(variableValue, 'css-variable', filePath, lineNumber, line, variableValue, true, variableName));
+        }
+    }
+    return colors;
+}
+function extractThirdPartyVariableReferences(line, filePath, lineNumber, patterns, thirdPartyVariables) {
+    const colors = [];
+    const thirdPartyPattern = /\$([\w-]+)/g;
+    const matches = line.matchAll(thirdPartyPattern);
+    for (const match of matches) {
+        const variableName = match[1];
+        const variableValue = thirdPartyVariables[variableName];
+        if (variableValue) {
+            colors.push(createColorReference(variableValue, 'third-party-variable', filePath, lineNumber, line, variableName, true, variableName));
+        }
+    }
+    return colors;
+}
+function extractColorsGeneric(line, filePath, lineNumber, pattern, format, dependencies) {
+    const colors = [];
+    const matches = line.matchAll(new RegExp(pattern.source, 'g'));
+    for (const match of matches) {
+        const originalColor = match[0];
+        const standardizedColor = dependencies.standardizeColor(originalColor);
+        colors.push(createColorReference(standardizedColor, format, filePath, lineNumber, line, originalColor));
+    }
+    return colors;
+}
+function parseCssVariables(code, filePath, dependencies) {
+    const variables = {};
+    const lines = code.split('\n');
+    const cssVarDefPattern = /--([\w-]+)\s*:\s*([^;]+);/g;
+    for (const line of lines) {
+        const matches = line.matchAll(cssVarDefPattern);
+        for (const match of matches) {
+            const [, variableName, variableValue] = match;
+            const trimmedValue = variableValue.trim();
+            const validation = dependencies.isColorValue(trimmedValue);
+            if (validation.isValid) {
+                const standardizedValue = dependencies.standardizeColor(trimmedValue);
+                variables[variableName] = standardizedValue;
+            }
+        }
+    }
+    return variables;
+}
+function createColorReference(value, format, file, line, context, originalValue, isVariableReference = false, variableName) {
+    return {
+        originalValue,
+        format,
+        file,
+        line,
+        context: context.trim(),
+        isVariableReference,
+        variableName
+    };
+}
+//# sourceMappingURL=extractColors.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "files": [
     "references",
     "dist",
@@ -34,6 +34,7 @@
     "./functions/base64/strToBase64": "./dist/functions/base64/strToBase64.js",
     "./functions/color-converter/convertColor": "./dist/functions/color-converter/convertColor.js",
     "./functions/color-converter/detectColorFormat": "./dist/functions/color-converter/detectColorFormat.js",
+    "./functions/color-converter/extractColors": "./dist/functions/color-converter/extractColors.js",
     "./functions/color-converter/getColorPatterns": "./dist/functions/color-converter/getColorPatterns.js",
     "./functions/color-converter/getNamedColorMap": "./dist/functions/color-converter/getNamedColorMap.js",
     "./functions/color-converter/hueToRgb": "./dist/functions/color-converter/hueToRgb.js",

package/types/color.d.ts

@@ -112,4 +112,25 @@ export interface ColorConversionOptions {
   alphaValue?: number
   /** 是否使用8位十六进制格式 */
   use8BitHex?: boolean
+}
+
+/**
+ * 颜色引用信息
+ * 用于描述在代码中发现的颜色值及其上下文信息
+ */
+export interface ColorReference {
+  /** 原始颜色值 */
+  originalValue: string
+  /** 颜色格式类型 */
+  format: ColorFormat | 'css-variable' | 'third-party-variable'
+  /** 文件路径 */
+  file: string
+  /** 行号 */
+  line: number
+  /** 上下文代码 */
+  context: string
+  /** 是否为变量引用 */
+  isVariableReference?: boolean
+  /** 变量名称（当isVariableReference为true时） */
+  variableName?: string
 }