@ngcorex/css 0.1.6 → 0.1.7

package/dist/constraints/constraint-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constraint-error.d.ts","sourceRoot":"","sources":["../../src/constraints/constraint-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,IAAI,CAgBN"}
+{"version":3,"file":"constraint-error.d.ts","sourceRoot":"","sources":["../../src/constraints/constraint-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,IAAI,CAiBN"}

package/dist/constraints/constraint-error.js

@@ -1,10 +1,10 @@
-import { NgCorexError } from '../errors/ngcorex-error.js';
+import { NgCorexError, NgCorexErrorCode } from '../errors/ngcorex-error.js';
 export function constraintViolation(level, rule, message, fix) {
     if (level === 'off') {
         return;
     }
     if (level === 'error') {
-        throw new NgCorexError(`Constraint violation: ${rule}`, `${message}\n\nFix:\n${fix}`);
+        throw new NgCorexError(NgCorexErrorCode.CONSTRAINT_VIOLATION_STRING, `Constraint violation: ${rule}`, `${message}\n\nFix:\n${fix}`);
     }
     // warning
     console.warn(`ngCorex Warning: ${rule}\n\n${message}\n\nFix:\n${fix}\n`);

package/dist/engine/build-css.js

@@ -2,7 +2,7 @@ import { normalizeTokenScale } from '../tokens/normalize.js';
 import { normalizeColorTokens } from '../tokens/normalize-colors.js';
 import { generateCssVariables } from '../tokens/generate-css.js';
 import { presetRegistry } from '../presets/index.js';
-import { NgCorexError } from '../errors/ngcorex-error.js';
+import { NgCorexError, NgCorexErrorCode } from '../errors/ngcorex-error.js';
 import { deepMerge } from '../utils/deep-merge.js';
 import { runConstraints } from '../constraints/run-constraints.js';
 import { wrapCss } from '../output/wrap-css.js';
@@ -17,7 +17,7 @@ export function buildCssFromConfig(config) {
         for (const presetName of config.presets) {
             const preset = presetRegistry[presetName];
             if (!preset) {
-                throw new NgCorexError('Unknown preset', `Preset "${presetName}" does not exist.
+                throw new NgCorexError(NgCorexErrorCode.UNKNOWN_PRESET_STRING, `Preset "${presetName}" does not exist.
 
 Available presets:
 - ${Object.keys(presetRegistry).join('\n- ')}

package/dist/errors/ngcorex-error.d.ts

@@ -1,4 +1,71 @@
+/**
+ * Enhanced error class for ngCorex with improved developer experience
+ */
+/**
+ * Error codes for categorizing different types of errors
+ */
+export declare enum NgCorexErrorCode {
+    TOKEN_INVALID_FORMAT = "TOKEN_INVALID_FORMAT",
+    TOKEN_INVALID_TYPE = "TOKEN_INVALID_TYPE",
+    TOKEN_DUPLICATE = "TOKEN_DUPLICATE",
+    TOKEN_MISSING = "TOKEN_MISSING",
+    CONSTRAINT_VIOLATION = "CONSTRAINT_VIOLATION",
+    CONSTRAINT_INVALID_CONFIG = "CONSTRAINT_INVALID_CONFIG",
+    CONFIG_INVALID = "CONFIG_INVALID",
+    CONFIG_MISSING = "CONFIG_MISSING",
+    CONFIG_PARSE_ERROR = "CONFIG_PARSE_ERROR",
+    OUTPUT_WRITE_ERROR = "OUTPUT_WRITE_ERROR",
+    OUTPUT_INVALID_PATH = "OUTPUT_INVALID_PATH",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    CONSTRAINT_VIOLATION_STRING = "Constraint violation",
+    UNKNOWN_PRESET_STRING = "Unknown preset",
+    INVALID_COLOR_TOKEN_STRING = "Invalid color token",
+    INVALID_TOKEN_STRING = "Invalid"
+}
+/**
+ * Error location information
+ */
+export interface ErrorLocation {
+    file?: string;
+    line?: number;
+    column?: number;
+    path?: string;
+}
+/**
+ * Error suggestion for fixing the issue
+ */
+export interface ErrorSuggestion {
+    message: string;
+    code?: string;
+}
+/**
+ * Enhanced error class with error codes, location, and suggestions
+ */
 export declare class NgCorexError extends Error {
-    constructor(message: string, details?: string);
+    readonly code: NgCorexErrorCode;
+    readonly location?: ErrorLocation;
+    readonly suggestion?: ErrorSuggestion;
+    readonly docsLink?: string;
+    constructor(code: NgCorexErrorCode, message: string, details?: string, location?: ErrorLocation, suggestion?: ErrorSuggestion, docsLink?: string);
+    /**
+     * Get a formatted error message for display
+     */
+    getDisplayMessage(): string;
 }
+/**
+ * Helper function to create a token format error
+ */
+export declare function createTokenFormatError(tokenPath: string, value: unknown, expectedFormat: string, file?: string): NgCorexError;
+/**
+ * Helper function to create a token type error
+ */
+export declare function createTokenTypeError(tokenPath: string, actualType: string, expectedType: string, file?: string): NgCorexError;
+/**
+ * Helper function to create a duplicate token error
+ */
+export declare function createDuplicateTokenError(tokenName: string, locations: string[]): NgCorexError;
+/**
+ * Helper function to create a constraint violation error
+ */
+export declare function createConstraintViolationError(rule: string, message: string, fix: string): NgCorexError;
 //# sourceMappingURL=ngcorex-error.d.ts.map

package/dist/errors/ngcorex-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ngcorex-error.d.ts","sourceRoot":"","sources":["../../src/errors/ngcorex-error.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQ9C"}
+{"version":3,"file":"ngcorex-error.d.ts","sourceRoot":"","sources":["../../src/errors/ngcorex-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,gBAAgB;IAE1B,oBAAoB,yBAAyB;IAC7C,kBAAkB,uBAAuB;IACzC,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAG/B,oBAAoB,yBAAyB;IAC7C,yBAAyB,8BAA8B;IAGvD,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IAGzC,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAG3C,aAAa,kBAAkB;IAG/B,2BAA2B,yBAAyB;IACpD,qBAAqB,mBAAmB;IACxC,0BAA0B,wBAAwB;IAClD,oBAAoB,YAAY;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGzB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,aAAa,EACxB,UAAU,CAAC,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM;IAUnB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CA4B5B;AAuCD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAWd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAWd;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,YAAY,CAWd;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,YAAY,CAUd"}

package/dist/errors/ngcorex-error.js

@@ -1,8 +1,139 @@
+/**
+ * Enhanced error class for ngCorex with improved developer experience
+ */
+/**
+ * Error codes for categorizing different types of errors
+ */
+export var NgCorexErrorCode;
+(function (NgCorexErrorCode) {
+    // Token validation errors
+    NgCorexErrorCode["TOKEN_INVALID_FORMAT"] = "TOKEN_INVALID_FORMAT";
+    NgCorexErrorCode["TOKEN_INVALID_TYPE"] = "TOKEN_INVALID_TYPE";
+    NgCorexErrorCode["TOKEN_DUPLICATE"] = "TOKEN_DUPLICATE";
+    NgCorexErrorCode["TOKEN_MISSING"] = "TOKEN_MISSING";
+    // Constraint errors
+    NgCorexErrorCode["CONSTRAINT_VIOLATION"] = "CONSTRAINT_VIOLATION";
+    NgCorexErrorCode["CONSTRAINT_INVALID_CONFIG"] = "CONSTRAINT_INVALID_CONFIG";
+    // Config errors
+    NgCorexErrorCode["CONFIG_INVALID"] = "CONFIG_INVALID";
+    NgCorexErrorCode["CONFIG_MISSING"] = "CONFIG_MISSING";
+    NgCorexErrorCode["CONFIG_PARSE_ERROR"] = "CONFIG_PARSE_ERROR";
+    // Output errors
+    NgCorexErrorCode["OUTPUT_WRITE_ERROR"] = "OUTPUT_WRITE_ERROR";
+    NgCorexErrorCode["OUTPUT_INVALID_PATH"] = "OUTPUT_INVALID_PATH";
+    // General errors
+    NgCorexErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    // Additional error codes for existing code
+    NgCorexErrorCode["CONSTRAINT_VIOLATION_STRING"] = "Constraint violation";
+    NgCorexErrorCode["UNKNOWN_PRESET_STRING"] = "Unknown preset";
+    NgCorexErrorCode["INVALID_COLOR_TOKEN_STRING"] = "Invalid color token";
+    NgCorexErrorCode["INVALID_TOKEN_STRING"] = "Invalid";
+})(NgCorexErrorCode || (NgCorexErrorCode = {}));
+/**
+ * Enhanced error class with error codes, location, and suggestions
+ */
 export class NgCorexError extends Error {
-    constructor(message, details) {
-        super(details
-            ? `ngCorex Error: ${message}\n\n${details}`
-            : `ngCorex Error: ${message}`);
+    constructor(code, message, details, location, suggestion, docsLink) {
+        super(formatErrorMessage(code, message, details, location, suggestion));
         this.name = 'NgCorexError';
+        this.code = code;
+        this.location = location;
+        this.suggestion = suggestion;
+        this.docsLink = docsLink;
     }
+    /**
+     * Get a formatted error message for display
+     */
+    getDisplayMessage() {
+        let output = '';
+        output += `Error: ${this.code}\n`;
+        output += `Message: ${this.message}\n`;
+        if (this.location) {
+            const locParts = [];
+            if (this.location.file)
+                locParts.push(`file: ${this.location.file}`);
+            if (this.location.path)
+                locParts.push(`path: ${this.location.path}`);
+            if (this.location.line)
+                locParts.push(`line: ${this.location.line}`);
+            if (this.location.column)
+                locParts.push(`column: ${this.location.column}`);
+            output += `Location: ${locParts.join(', ')}\n`;
+        }
+        if (this.suggestion) {
+            output += `Suggestion: ${this.suggestion.message}\n`;
+            if (this.suggestion.code) {
+                output += `Example:\n${this.suggestion.code}\n`;
+            }
+        }
+        if (this.docsLink) {
+            output += `Documentation: ${this.docsLink}\n`;
+        }
+        return output;
+    }
+}
+/**
+ * Format error message for display
+ */
+function formatErrorMessage(code, message, details, location, suggestion) {
+    let output = `ngCorex Error [${code}]: ${message}`;
+    if (location) {
+        const locParts = [];
+        if (location.file)
+            locParts.push(`file: ${location.file}`);
+        if (location.path)
+            locParts.push(`path: ${location.path}`);
+        if (location.line)
+            locParts.push(`line: ${location.line}`);
+        if (location.column)
+            locParts.push(`column: ${location.column}`);
+        if (locParts.length > 0) {
+            output += `\nLocation: ${locParts.join(', ')}`;
+        }
+    }
+    if (details) {
+        output += `\n\nDetails:\n${details}`;
+    }
+    if (suggestion) {
+        output += `\n\n💡 Suggestion:\n${suggestion.message}`;
+        if (suggestion.code) {
+            output += `\n\nExample:\n${suggestion.code}`;
+        }
+    }
+    return output;
+}
+/**
+ * Helper function to create a token format error
+ */
+export function createTokenFormatError(tokenPath, value, expectedFormat, file) {
+    return new NgCorexError(NgCorexErrorCode.TOKEN_INVALID_FORMAT, `Invalid token format for "${tokenPath}"`, `Received value: ${JSON.stringify(value)}\nExpected format: ${expectedFormat}`, { file, path: tokenPath }, {
+        message: `Update the token value to match the expected format.`,
+        code: `// Example for ${tokenPath}:\n"${tokenPath}": "${expectedFormat}"`
+    });
+}
+/**
+ * Helper function to create a token type error
+ */
+export function createTokenTypeError(tokenPath, actualType, expectedType, file) {
+    return new NgCorexError(NgCorexErrorCode.TOKEN_INVALID_TYPE, `Invalid token type for "${tokenPath}"`, `Received type: ${actualType}\nExpected type: ${expectedType}`, { file, path: tokenPath }, {
+        message: `Update the token value to the correct type.`,
+        code: `// Example for ${tokenPath}:\n"${tokenPath}": <${expectedType}>`
+    });
+}
+/**
+ * Helper function to create a duplicate token error
+ */
+export function createDuplicateTokenError(tokenName, locations) {
+    return new NgCorexError(NgCorexErrorCode.TOKEN_DUPLICATE, `Duplicate token name found: "${tokenName}"`, `Token "${tokenName}" appears in multiple locations:\n${locations.map(l => `  - ${l}`).join('\n')}`, undefined, {
+        message: `Rename one of the tokens to avoid conflicts.`,
+        code: `// Example:\n// Change ${locations[0]} to "${tokenName}Alt"\n// or rename ${locations[1]} to "${tokenName}Alt"`
+    });
+}
+/**
+ * Helper function to create a constraint violation error
+ */
+export function createConstraintViolationError(rule, message, fix) {
+    return new NgCorexError(NgCorexErrorCode.CONSTRAINT_VIOLATION, `Constraint violation: ${rule}`, message, undefined, {
+        message: fix
+    });
 }

package/dist/index.d.ts

@@ -8,5 +8,7 @@ export { buildCssFromConfig } from './engine/build-css.js';
 export { presetRegistry } from './presets/index.js';
 export { NgCorexError } from './errors/ngcorex-error.js';
 export { runConstraints } from './constraints/run-constraints.js';
+export { runValidations, runValidationsWithoutInfo, getValidationSummary, printValidationResults, hasValidationResults, hasValidationErrors, hasValidationWarnings, hasValidationInfo } from './validation/index.js';
+export type { ValidationReport, ValidationResult, ValidationConfig, TokensForValidation, TokenLocation, DuplicateToken, ScaleConsistencyIssue, ColorFormatIssue, SpacingFormatIssue, ShadowFormatIssue, ZIndexLogicIssue } from './validation/types.js';
 export { wrapCss } from './output/wrap-css.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,UAAU,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,UAAU,EACV,eAAe,EACf,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -7,4 +7,6 @@ export { buildCssFromConfig } from './engine/build-css.js';
 export { presetRegistry } from './presets/index.js';
 export { NgCorexError } from './errors/ngcorex-error.js';
 export { runConstraints } from './constraints/run-constraints.js';
+// Validation API
+export { runValidations, runValidationsWithoutInfo, getValidationSummary, printValidationResults, hasValidationResults, hasValidationErrors, hasValidationWarnings, hasValidationInfo } from './validation/index.js';
 export { wrapCss } from './output/wrap-css.js';

package/dist/tokens/normalize-colors.js

@@ -1,4 +1,4 @@
-import { NgCorexError } from '../errors/ngcorex-error.js';
+import { NgCorexError, NgCorexErrorCode } from '../errors/ngcorex-error.js';
 const CSS_VAR_PREFIX = 'nx';
 /**
  * Normalize nested color tokens (e.g. primary.500)
@@ -10,7 +10,7 @@ export function normalizeColorTokens(colors) {
         for (const shade in palette) {
             const value = palette[shade];
             if (typeof value !== 'string') {
-                throw new NgCorexError('Invalid color token', `Token: colors.${paletteName}.${shade}
+                throw new NgCorexError(NgCorexErrorCode.INVALID_COLOR_TOKEN_STRING, `Token: colors.${paletteName}.${shade}
         Value: ${String(value)}
         Expected: string (e.g. "#ffffff")
 

package/dist/tokens/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/tokens/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMpF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,GAChB,oBAAoB,CA8BtB"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/tokens/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMpF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,GAChB,oBAAoB,CA+BtB"}

package/dist/tokens/normalize.js

@@ -1,4 +1,4 @@
-import { NgCorexError } from '../errors/ngcorex-error.js';
+import { NgCorexError, NgCorexErrorCode } from '../errors/ngcorex-error.js';
 const CSS_VAR_PREFIX = 'nx';
 /**
  * Normalize a single token scale (e.g. spacing, radius)
@@ -9,7 +9,7 @@ export function normalizeTokenScale(category, scale) {
         const value = scale[key];
         // Basic validation
         if (typeof value !== 'string') {
-            throw new NgCorexError(`Invalid ${category} token`, `Token: ${category}.${key}
+            throw new NgCorexError(NgCorexErrorCode.INVALID_TOKEN_STRING, `Invalid ${category} token`, `Token: ${category}.${key}
       Value: ${String(value)}
       Expected: string (e.g. "1rem")
 

package/dist/validation/color-format.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Color format validation
+ * Checks for valid CSS color formats and consistency
+ */
+import type { ValidationResult, TokensForValidation, ColorFormatIssue } from './types.js';
+/**
+ * Determine the color format type
+ */
+export declare function getColorFormat(value: string): string | null;
+/**
+ * Check if a color value is valid
+ */
+export declare function isValidColor(value: string): boolean;
+/**
+ * Validate all color formats
+ */
+export declare function validateColorFormat(tokens: TokensForValidation, severity?: 'info' | 'warning' | 'error'): ValidationResult[];
+/**
+ * Get a summary of color format issues
+ */
+export declare function getColorFormatSummary(issues: ColorFormatIssue[]): string;
+//# sourceMappingURL=color-format.d.ts.map

package/dist/validation/color-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-format.d.ts","sourceRoot":"","sources":["../../src/validation/color-format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA6BpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AA2LD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,GAAE,MAAM,GAAG,SAAS,GAAG,OAAmB,GACjD,gBAAgB,EAAE,CAsBpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAexE"}

package/dist/validation/color-format.js

@@ -0,0 +1,249 @@
+/**
+ * Color format validation
+ * Checks for valid CSS color formats and consistency
+ */
+/**
+ * Validation code for color format
+ */
+const COLOR_FORMAT_CODE = 'COLOR_FORMAT';
+/**
+ * Color format patterns
+ */
+const COLOR_PATTERNS = {
+    // Hex colors: #fff or #ffffff
+    hex3: /^#([0-9a-fA-F]{3})$/,
+    hex4: /^#([0-9a-fA-F]{4})$/,
+    hex6: /^#([0-9a-fA-F]{6})$/,
+    hex8: /^#([0-9a-fA-F]{8})$/,
+    // RGB/RGBA: rgb(r, g, b) or rgba(r, g, b, a)
+    rgb: /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/,
+    rgba: /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*([01]?\.?\d*)\s*\)$/,
+    // HSL/HSLA: hsl(h, s%, l%) or hsla(h, s%, l%, a)
+    hsl: /^hsl\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*\)$/,
+    hsla: /^hsla\(\s*(\d{1,3})\s*,\s*(\d{1,3})%\s*,\s*(\d{1,3})%\s*,\s*([01]?\.?\d*)\s*\)$/,
+    // Named colors
+    named: /^[a-zA-Z]+$/
+};
+/**
+ * Determine the color format type
+ */
+export function getColorFormat(value) {
+    if (COLOR_PATTERNS.hex3.test(value))
+        return 'hex3';
+    if (COLOR_PATTERNS.hex4.test(value))
+        return 'hex4';
+    if (COLOR_PATTERNS.hex6.test(value))
+        return 'hex6';
+    if (COLOR_PATTERNS.hex8.test(value))
+        return 'hex8';
+    if (COLOR_PATTERNS.rgb.test(value))
+        return 'rgb';
+    if (COLOR_PATTERNS.rgba.test(value))
+        return 'rgba';
+    if (COLOR_PATTERNS.hsl.test(value))
+        return 'hsl';
+    if (COLOR_PATTERNS.hsla.test(value))
+        return 'hsla';
+    if (COLOR_PATTERNS.named.test(value))
+        return 'named';
+    return null;
+}
+/**
+ * Check if a color value is valid
+ */
+export function isValidColor(value) {
+    return getColorFormat(value) !== null;
+}
+/**
+ * Validate RGB values
+ */
+function validateRgbValues(r, g, b) {
+    return r >= 0 && r <= 255 && g >= 0 && g <= 255 && b >= 0 && b <= 255;
+}
+/**
+ * Validate HSL hue value
+ */
+function validateHslHue(h) {
+    return h >= 0 && h <= 360;
+}
+/**
+ * Validate HSL saturation/lightness values
+ */
+function validateHslPercent(s, l) {
+    return s >= 0 && s <= 100 && l >= 0 && l <= 100;
+}
+/**
+ * Check for deprecated color formats
+ */
+function isDeprecatedFormat(format) {
+    // hex3 and hex4 are shorter but less precise
+    return format === 'hex3' || format === 'hex4';
+}
+/**
+ * Validate a single color value
+ */
+function validateColorValue(path, value, severity = 'warning') {
+    const format = getColorFormat(value);
+    if (!format) {
+        return {
+            severity: 'error',
+            code: COLOR_FORMAT_CODE,
+            message: `Invalid color format: "${value}"`,
+            path,
+            suggestion: 'Use a valid CSS color format: hex (#ffffff), rgb(255,255,255), rgba(255,255,255,1), hsl(0,0%,100%), or a named color.',
+            example: `// Examples:\n// "${path}": "#ffffff"\n// "${path}": "rgb(255, 255, 255)"`
+        };
+    }
+    // Check for deprecated formats
+    if (isDeprecatedFormat(format)) {
+        return {
+            severity: 'info',
+            code: COLOR_FORMAT_CODE,
+            message: `Using deprecated color format: "${format}"`,
+            path,
+            suggestion: 'Consider using the full 6-digit hex format for better precision and consistency.',
+            example: `// Change from:\n// "${path}": "${value}"\n// To:\n// "${path}": "${expandHex(value)}"`
+        };
+    }
+    // Validate RGB values if applicable
+    if (format === 'rgb' || format === 'rgba') {
+        const match = value.match(format === 'rgb' ? COLOR_PATTERNS.rgb : COLOR_PATTERNS.rgba);
+        if (match) {
+            const r = parseInt(match[1], 10);
+            const g = parseInt(match[2], 10);
+            const b = parseInt(match[3], 10);
+            if (!validateRgbValues(r, g, b)) {
+                return {
+                    severity: 'error',
+                    code: COLOR_FORMAT_CODE,
+                    message: `Invalid RGB values in color: "${value}"`,
+                    path,
+                    suggestion: 'RGB values must be between 0 and 255.',
+                    example: `// Example:\n// "${path}": "rgb(255, 255, 255)"`
+                };
+            }
+        }
+    }
+    // Validate HSL values if applicable
+    if (format === 'hsl' || format === 'hsla') {
+        const match = value.match(format === 'hsl' ? COLOR_PATTERNS.hsl : COLOR_PATTERNS.hsla);
+        if (match) {
+            const h = parseInt(match[1], 10);
+            const s = parseInt(match[2], 10);
+            const l = parseInt(match[3], 10);
+            if (!validateHslHue(h) || !validateHslPercent(s, l)) {
+                return {
+                    severity: 'error',
+                    code: COLOR_FORMAT_CODE,
+                    message: `Invalid HSL values in color: "${value}"`,
+                    path,
+                    suggestion: 'HSL hue must be 0-360, saturation and lightness must be 0-100%.',
+                    example: `// Example:\n// "${path}": "hsl(0, 0%, 100%)"`
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Expand a short hex color to full format
+ */
+function expandHex(hex) {
+    if (COLOR_PATTERNS.hex3.test(hex)) {
+        return '#' + hex.slice(1).split('').map(c => c + c).join('');
+    }
+    if (COLOR_PATTERNS.hex4.test(hex)) {
+        const chars = hex.slice(1).split('');
+        return '#' + chars[0] + chars[0] + chars[1] + chars[1] + chars[2] + chars[2];
+    }
+    return hex;
+}
+/**
+ * Collect all color values from tokens
+ */
+function collectColorValues(colors, path = 'colors') {
+    const results = [];
+    if (typeof colors === 'string') {
+        results.push({ path, value: colors });
+    }
+    else if (typeof colors === 'object' && colors !== null && !Array.isArray(colors)) {
+        for (const [key, value] of Object.entries(colors)) {
+            results.push(...collectColorValues(value, `${path}.${key}`));
+        }
+    }
+    return results;
+}
+/**
+ * Check for inconsistent color formats within a color family
+ */
+function checkColorFormatConsistency(colorValues, severity = 'warning') {
+    const results = [];
+    // Group by color family (e.g., gray, blue, red)
+    const families = new Map();
+    for (const { path, value } of colorValues) {
+        const format = getColorFormat(value);
+        if (!format)
+            continue;
+        const pathParts = path.split('.');
+        const family = pathParts[1] || 'default';
+        if (!families.has(family)) {
+            families.set(family, []);
+        }
+        families.get(family).push({ path, value, format });
+    }
+    // Check each family for format consistency
+    for (const [family, values] of families.entries()) {
+        if (values.length < 2)
+            continue;
+        const formats = new Set(values.map(v => v.format));
+        if (formats.size > 1) {
+            const formatList = Array.from(formats).sort().join(', ');
+            results.push({
+                severity,
+                code: COLOR_FORMAT_CODE,
+                message: `Inconsistent color formats in "${family}" family: ${formatList}`,
+                path: `colors.${family}`,
+                suggestion: 'Use consistent color formats within a color family for better maintainability.',
+                example: `// Example - use hex6 format:\n// "colors.${family}.100": "#f3f4f6"\n// "colors.${family}.900": "#111827"`
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Validate all color formats
+ */
+export function validateColorFormat(tokens, severity = 'warning') {
+    const results = [];
+    if (!tokens.colors) {
+        return results;
+    }
+    // Collect all color values
+    const colorValues = collectColorValues(tokens.colors);
+    // Validate each color value
+    for (const { path, value } of colorValues) {
+        const result = validateColorValue(path, value, severity);
+        if (result) {
+            results.push(result);
+        }
+    }
+    // Check for format consistency
+    results.push(...checkColorFormatConsistency(colorValues, severity));
+    return results;
+}
+/**
+ * Get a summary of color format issues
+ */
+export function getColorFormatSummary(issues) {
+    if (issues.length === 0) {
+        return 'No color format issues found.';
+    }
+    const summary = [];
+    summary.push(`Found ${issues.length} color format issue${issues.length > 1 ? 's' : ''}:`);
+    for (const issue of issues) {
+        summary.push(`  • ${issue.path}: ${issue.issue}`);
+        summary.push(`    ${issue.details}`);
+        summary.push(`    💡 ${issue.suggestion}`);
+    }
+    return summary.join('\n');
+}

package/dist/validation/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Main validation entry point
+ * Coordinates all non-blocking token validations
+ */
+import type { ValidationReport, ValidationConfig, TokensForValidation } from './types.js';
+/**
+ * Default validation configuration
+ */
+export declare const DEFAULT_VALIDATION_CONFIG: ValidationConfig;
+/**
+ * Run all enabled validations on tokens
+ */
+export declare function runValidations(tokens: TokensForValidation, config?: ValidationConfig): ValidationReport;
+/**
+ * Run validations and return only warnings and errors (filter out info)
+ */
+export declare function runValidationsWithoutInfo(tokens: TokensForValidation, config?: ValidationConfig): ValidationReport;
+/**
+ * Get a human-readable summary of the validation report
+ */
+export declare function getValidationSummary(report: ValidationReport): string;
+/**
+ * Print validation results grouped by severity
+ */
+export declare function printValidationResults(report: ValidationReport): void;
+/**
+ * Check if validation report has any results
+ */
+export declare function hasValidationResults(report: ValidationReport): boolean;
+/**
+ * Check if validation report has errors
+ */
+export declare function hasValidationErrors(report: ValidationReport): boolean;
+/**
+ * Check if validation report has warnings
+ */
+export declare function hasValidationWarnings(report: ValidationReport): boolean;
+/**
+ * Check if validation report has info messages
+ */
+export declare function hasValidationInfo(report: ValidationReport): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,gBAUvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,GAAE,gBAA4C,GACnD,gBAAgB,CA8DlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,GAAE,gBAA4C,GACnD,gBAAgB,CAalB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA2BrE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA8DrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAErE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEnE"}