@ngcorex/css 0.1.5 → 0.1.7

package/README.md

@@ -1,6 +1,6 @@
 # @ngcorex/css
 
-![NPM Version](https://img.shields.io/npm/v/%40ngcorex%2Fcss?style=flat-square&logo=npm&labelColor=%23D50100&color=%23000) ![NPM License](https://img.shields.io/npm/l/%40ngcorex%2Fcss?style=flat-square) ![Static Badge](https://img.shields.io/badge/Github-Repo-blue?style=flat-square&logo=github) ![NPM Downloads](https://img.shields.io/npm/dm/%40ngcorex%2Fcss?style=flat-square&logo=npm&logoColor=%23ffffff&labelColor=%23D50100&color=%23000)
+![NPM Version](https://img.shields.io/npm/v/%40ngcorex%2Fcss?style=flat-square&logo=npm&labelColor=%23D50100&color=%23000) ![NPM License](https://img.shields.io/npm/l/%40ngcorex%2Fcss?style=flat-square) ![Static Badge](https://img.shields.io/badge/Github-Repo-blue?style=flat-square&logo=github) ![NPM Downloads](https://img.shields.io/npm/dm/%40ngcorex%2Fcss?style=flat-square&logo=npm&logoColor=%23ffffff&labelColor=%23D50100&color=%23000) ![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/arkdezin/ngcorex)
 
 Core engine for **ngCorex**.
 
@@ -19,6 +19,27 @@ It is intended to be used via the ngCorex CLI, not directly in applications.
 npm install @ngcorex/css
 ````
 
+## Supported Token Categories
+
+ngCorex supports the following design token categories:
+
+| Category | Description | Example Values |
+| ---------- | ------------- | ---------------- |
+| `spacing` | Spacing scale for margins, padding, gaps | `"4px"`, `"1rem"`, `"0.5em"` |
+| `colors` | Color palette with nested shades | `"#f3f4f6"`, `"rgb(37, 99, 235)"` |
+| `radius` | Border radius values | `"4px"`, `"8px"`, `"16px"`, `"full"` |
+| `zIndex` | Z-index layer values | `"1000"`, `"2000"`, `"3000"` |
+| `typography` | Font properties (fontSize, fontWeight, lineHeight) | See below |
+| `shadows` | Box shadow values | `"0 1px 2px 0 rgba(0,0,0,0.05)"` |
+
+### Typography Sub-categories
+
+| Sub-category | Description | Example Values |
+| ------------- | ------------- | ---------------- |
+| `fontSize` | Font size values | `"0.75rem"`, `"16px"`, `"1.25em"` |
+| `fontWeight` | Font weight values | `"400"`, `"500"`, `"bold"`, `"700"` |
+| `lineHeight` | Line height values | `"1.25"`, `"1.5"`, `"1.75"` |
+
 ## Token Source
 
 Tokens can be provided either inline via configuration or from an external `tokens.json` file when using the ngCorex CLI.

package/dist/config/schema.d.ts

@@ -12,16 +12,45 @@ export interface ConstraintConfig {
         format?: ConstraintLevel;
         shadeKey?: ConstraintLevel;
     };
+    radius?: {
+        unit?: ConstraintLevel;
+        format?: ConstraintLevel;
+        type?: ConstraintLevel;
+    };
+    zIndex?: {
+        format?: ConstraintLevel;
+        type?: ConstraintLevel;
+    };
+    typography?: {
+        fontSize?: {
+            format?: ConstraintLevel;
+            type?: ConstraintLevel;
+        };
+        fontWeight?: {
+            format?: ConstraintLevel;
+            type?: ConstraintLevel;
+        };
+        lineHeight?: {
+            format?: ConstraintLevel;
+            type?: ConstraintLevel;
+        };
+    };
+    shadows?: {
+        format?: ConstraintLevel;
+        type?: ConstraintLevel;
+    };
 }
 export interface TokensConfig {
     spacing?: TokenScale;
     colors?: NestedTokenScale;
     radius?: TokenScale;
+    zIndex?: TokenScale;
     typography?: {
         fontSize?: TokenScale;
         fontWeight?: TokenScale;
         lineHeight?: TokenScale;
     };
+    shadows?: TokenScale;
 }
 export interface UtilitiesConfig {
     spacing?: {

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,IAAI,CAAC,EAAE,eAAe,CAAC;KACxB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B,CAAC;CACH;AAGD,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,UAAU,CAAC;QACtB,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,UAAU,CAAC,EAAE,UAAU,CAAC;KAC3B,CAAC;CACL;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,GAAG,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACL;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAC9B,qBAAqB,CAAC,EAAE;QACpB,QAAQ,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,gBAAgB,CAAC,EAAE;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,kBAAkB,CAAC;KAChC,CAAC;IACF,yBAAyB,CAAC,EAAE;QACxB,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,kBAAkB,CAAC;KAChC,CAAC;CACL;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACzB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

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/constraints/radius.d.ts

@@ -0,0 +1,6 @@
+import type { ConstraintConfig } from '../config/schema.js';
+/**
+ * Validate border radius token constraints
+ */
+export declare function validateRadiusConstraints(radius: Record<string, string>, config?: ConstraintConfig['radius']): void;
+//# sourceMappingURL=radius.d.ts.map

package/dist/constraints/radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radius.d.ts","sourceRoot":"","sources":["../../src/constraints/radius.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,IAAI,CAqCN"}

package/dist/constraints/radius.js

@@ -0,0 +1,33 @@
+import { constraintViolation } from './constraint-error.js';
+import { resolveConstraintLevel } from './resolve-level.js';
+/**
+ * Validate border radius token constraints
+ */
+export function validateRadiusConstraints(radius, config) {
+    for (const key in radius) {
+        const value = radius[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'radius.type', `Token radius.${key} is not a string.`, `Change radius.${key} to a string value like "4px" or "0.5rem".`);
+            return;
+        }
+        if (isUnitlessNumber(value)) {
+            radius[key] = `${value}px`;
+            constraintViolation(resolveConstraintLevel(config?.unit, 'warning'), 'radius.unit', `Token radius.${key} had no unit. Defaulted to "${radius[key]}".`, `Explicitly add a unit (e.g. "px", "rem", "em", "%") to radius.${key}.`);
+            continue;
+        }
+        if (isValidRadiusValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'radius.format', `Token radius.${key} has invalid value "${value}".`, `Use a numeric value with a unit (px, rem, em, %) or the "full" keyword.`);
+    }
+}
+function isUnitlessNumber(value) {
+    return /^-?\d*\.?\d+$/.test(value);
+}
+function isValidRadiusValue(value) {
+    // Allow units: px, rem, em, %
+    // Also allow special values like 'full'
+    const unitPattern = /^\d*\.?\d+(px|rem|em|%)$/;
+    const specialValues = /^(full|none|inherit|initial|revert|unset)$/;
+    return unitPattern.test(value) || specialValues.test(value);
+}

package/dist/constraints/run-constraints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-constraints.d.ts","sourceRoot":"","sources":["../../src/constraints/run-constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAI3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAa1D"}
+{"version":3,"file":"run-constraints.d.ts","sourceRoot":"","sources":["../../src/constraints/run-constraints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQ3E,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA6B1D"}

package/dist/constraints/run-constraints.js

@@ -1,5 +1,9 @@
 import { validateSpacingConstraints } from './spacing.js';
 import { validateColorConstraints } from './colors.js';
+import { validateRadiusConstraints } from './radius.js';
+import { validateZIndexConstraints } from './z-index.js';
+import { validateTypographyConstraints } from './typography.js';
+import { validateShadowConstraints } from './shadows.js';
 export function runConstraints(config) {
     const tokens = config.tokens;
     const rules = config.constraints;
@@ -11,4 +15,16 @@ export function runConstraints(config) {
     if (tokens.colors) {
         validateColorConstraints(tokens.colors, rules?.colors);
     }
+    if (tokens.radius) {
+        validateRadiusConstraints(tokens.radius, rules?.radius);
+    }
+    if (tokens.zIndex) {
+        validateZIndexConstraints(tokens.zIndex, rules?.zIndex);
+    }
+    if (tokens.typography) {
+        validateTypographyConstraints(tokens.typography, rules?.typography);
+    }
+    if (tokens.shadows) {
+        validateShadowConstraints(tokens.shadows, rules?.shadows);
+    }
 }

package/dist/constraints/shadows.d.ts

@@ -0,0 +1,6 @@
+import type { ConstraintConfig } from '../config/schema.js';
+/**
+ * Validate shadow token constraints
+ */
+export declare function validateShadowConstraints(shadows: Record<string, string>, config?: ConstraintConfig['shadows']): void;
+//# sourceMappingURL=shadows.d.ts.map

package/dist/constraints/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../src/constraints/shadows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACnC,IAAI,CAyBN"}

package/dist/constraints/shadows.js

@@ -0,0 +1,118 @@
+import { constraintViolation } from './constraint-error.js';
+import { resolveConstraintLevel } from './resolve-level.js';
+/**
+ * Validate shadow token constraints
+ */
+export function validateShadowConstraints(shadows, config) {
+    for (const key in shadows) {
+        const value = shadows[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'shadows.type', `Token shadows.${key} is not a string.`, `Change shadows.${key} to a string value like "0 1px 3px 0 rgba(0,0,0,0.1)".`);
+            return;
+        }
+        if (isValidShadowValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'shadows.format', `Token shadows.${key} has invalid value "${value}".`, `Use a valid box-shadow syntax: "offset-x offset-y blur-radius spread-radius color".`);
+    }
+}
+/**
+ * Validate box-shadow syntax
+ * Format: offset-x offset-y blur-radius spread-radius color
+ * Examples:
+ * - "0 1px 3px 0 rgba(0,0,0,0.1)"
+ * - "0 4px 6px -1px rgba(0,0,0,0.1)"
+ * - "0 0 0 1px rgba(0,0,0,0.1)"
+ * - "none"
+ * - "inherit"
+ */
+function isValidShadowValue(value) {
+    const specialValues = /^(none|inherit|initial|revert|unset)$/;
+    if (specialValues.test(value)) {
+        return true;
+    }
+    function splitShadowList(value) {
+        const result = [];
+        let current = '';
+        let depth = 0;
+        for (const char of value) {
+            if (char === '(')
+                depth++;
+            if (char === ')')
+                depth--;
+            if (char === ',' && depth === 0) {
+                result.push(current.trim());
+                current = '';
+                continue;
+            }
+            current += char;
+        }
+        if (current.trim()) {
+            result.push(current.trim());
+        }
+        return result;
+    }
+    const shadowParts = splitShadowList(value);
+    for (const shadow of shadowParts) {
+        if (!isValidSingleShadow(shadow)) {
+            return false;
+        }
+    }
+    return true;
+}
+function isValidSingleShadow(shadow) {
+    // A single box-shadow has the following components:
+    // offset-x (required)
+    // offset-y (required)
+    // blur-radius (optional)
+    // spread-radius (optional)
+    // color (optional)
+    // inset (optional, at the beginning)
+    const tokens = shadow.split(/\s+/);
+    // Must have at least offset-x and offset-y
+    if (tokens.length < 2) {
+        return false;
+    }
+    let hasInset = false;
+    let offsetCount = 0;
+    let blurRadius = false;
+    let spreadRadius = false;
+    let color = false;
+    for (const token of tokens) {
+        if (token === 'inset') {
+            hasInset = true;
+        }
+        else if (isLengthValue(token)) {
+            offsetCount++;
+            if (offsetCount > 2) {
+                if (!blurRadius) {
+                    blurRadius = true;
+                }
+                else if (!spreadRadius) {
+                    spreadRadius = true;
+                }
+            }
+        }
+        else if (isColorValue(token)) {
+            color = true;
+        }
+    }
+    // Must have at least offset-x and offset-y
+    return offsetCount >= 2;
+}
+function isLengthValue(value) {
+    // Check for px, rem, em, %, or unitless (0)
+    const lengthPattern = /^-?\d*\.?\d+(px|rem|em|%|vh|vw|vmin|vmax|cm|mm|in|pt|pc|ex|ch)?$/;
+    return lengthPattern.test(value);
+}
+function isColorValue(value) {
+    // Hex colors
+    const hex = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+    // rgb/rgba - handle spaces and decimals properly
+    const rgb = /^rgba?\(\s*\d+\s*,\s*\d+\s*,\s*\d+(\s*,\s*[\d.]+)?\s*\)/;
+    // hsl/hsla
+    const hsl = /^hsla?\(\s*\d+(\.\d+)?\s*(deg|rad|turn)?\s*,\s*\d+%?\s*,\s*\d+%?(\s*,\s*[\d.]+)?\s*\)/;
+    // Named colors (basic check) - must be after other checks
+    const namedColor = /^[a-zA-Z]+$/;
+    return hex.test(value) || rgb.test(value) || hsl.test(value) || namedColor.test(value);
+}

package/dist/constraints/typography.d.ts

@@ -0,0 +1,11 @@
+import type { ConstraintConfig } from '../config/schema.js';
+export interface TypographyTokens {
+    fontSize?: Record<string, string>;
+    fontWeight?: Record<string, string>;
+    lineHeight?: Record<string, string>;
+}
+/**
+ * Validate typography token constraints
+ */
+export declare function validateTypographyConstraints(typography: TypographyTokens, config?: ConstraintConfig['typography']): void;
+//# sourceMappingURL=typography.d.ts.map

package/dist/constraints/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../src/constraints/typography.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,GACtC,IAAI,CAYN"}

package/dist/constraints/typography.js

@@ -0,0 +1,84 @@
+import { constraintViolation } from './constraint-error.js';
+import { resolveConstraintLevel } from './resolve-level.js';
+/**
+ * Validate typography token constraints
+ */
+export function validateTypographyConstraints(typography, config) {
+    if (typography.fontSize) {
+        validateFontSizeConstraints(typography.fontSize, config?.fontSize);
+    }
+    if (typography.fontWeight) {
+        validateFontWeightConstraints(typography.fontWeight, config?.fontWeight);
+    }
+    if (typography.lineHeight) {
+        validateLineHeightConstraints(typography.lineHeight, config?.lineHeight);
+    }
+}
+/**
+ * Validate font size constraints
+ */
+function validateFontSizeConstraints(fontSize, config) {
+    for (const key in fontSize) {
+        const value = fontSize[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'typography.fontSize.type', `Token typography.fontSize.${key} is not a string.`, `Change typography.fontSize.${key} to a string value like "16px" or "1rem".`);
+            return;
+        }
+        if (isValidFontSizeValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'typography.fontSize.format', `Token typography.fontSize.${key} has invalid value "${value}".`, `Use a numeric value with a unit (px, rem, em, %).`);
+    }
+}
+/**
+ * Validate font weight constraints
+ */
+function validateFontWeightConstraints(fontWeight, config) {
+    for (const key in fontWeight) {
+        const value = fontWeight[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'typography.fontWeight.type', `Token typography.fontWeight.${key} is not a string.`, `Change typography.fontWeight.${key} to a string value like "400" or "bold".`);
+            return;
+        }
+        if (isValidFontWeightValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'typography.fontWeight.format', `Token typography.fontWeight.${key} has invalid value "${value}".`, `Use a numeric weight (100-900) or a named weight (normal, bold, etc.).`);
+    }
+}
+/**
+ * Validate line height constraints
+ */
+function validateLineHeightConstraints(lineHeight, config) {
+    for (const key in lineHeight) {
+        const value = lineHeight[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'typography.lineHeight.type', `Token typography.lineHeight.${key} is not a string.`, `Change typography.lineHeight.${key} to a string value like "1.5" or "24px".`);
+            return;
+        }
+        if (isValidLineHeightValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'typography.lineHeight.format', `Token typography.lineHeight.${key} has invalid value "${value}".`, `Use a unitless number, or a value with a unit (px, rem, em, %).`);
+    }
+}
+function isValidFontSizeValue(value) {
+    const unitPattern = /^\d*\.?\d+(px|rem|em|%)$/;
+    return unitPattern.test(value);
+}
+function isValidFontWeightValue(value) {
+    // Numeric weights: 100, 200, ..., 900
+    const numericPattern = /^[1-9]00$/;
+    // Named weights
+    const namedWeights = /^(normal|bold|bolder|lighter|100|200|300|400|500|600|700|800|900)$/;
+    return numericPattern.test(value) || namedWeights.test(value);
+}
+function isValidLineHeightValue(value) {
+    // Unitless number (most common for line-height)
+    const unitlessPattern = /^\d*\.?\d+$/;
+    // With units
+    const unitPattern = /^\d*\.?\d+(px|rem|em|%)$/;
+    // Special CSS values
+    const specialValues = /^(normal|inherit|initial|revert|unset)$/;
+    return unitlessPattern.test(value) || unitPattern.test(value) || specialValues.test(value);
+}

package/dist/constraints/z-index.d.ts

@@ -0,0 +1,6 @@
+import type { ConstraintConfig } from '../config/schema.js';
+/**
+ * Validate z-index token constraints
+ */
+export declare function validateZIndexConstraints(zIndex: Record<string, string>, config?: ConstraintConfig['zIndex']): void;
+//# sourceMappingURL=z-index.d.ts.map

package/dist/constraints/z-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z-index.d.ts","sourceRoot":"","sources":["../../src/constraints/z-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,IAAI,CAyBN"}

package/dist/constraints/z-index.js

@@ -0,0 +1,25 @@
+import { constraintViolation } from './constraint-error.js';
+import { resolveConstraintLevel } from './resolve-level.js';
+/**
+ * Validate z-index token constraints
+ */
+export function validateZIndexConstraints(zIndex, config) {
+    for (const key in zIndex) {
+        const value = zIndex[key];
+        if (typeof value !== 'string') {
+            constraintViolation(resolveConstraintLevel(config?.type, 'error'), 'zIndex.type', `Token zIndex.${key} is not a string.`, `Change zIndex.${key} to a string value like "1000" or "auto".`);
+            return;
+        }
+        if (isValidZIndexValue(value)) {
+            continue;
+        }
+        constraintViolation(resolveConstraintLevel(config?.format, 'error'), 'zIndex.format', `Token zIndex.${key} has invalid value "${value}".`, `Use a positive integer string (e.g., "1000", "2000") or the "auto" keyword.`);
+    }
+}
+function isValidZIndexValue(value) {
+    // Allow positive integers
+    const integerPattern = /^\d+$/;
+    // Allow special CSS values
+    const specialValues = /^(auto|inherit|initial|revert|unset)$/;
+    return integerPattern.test(value) || specialValues.test(value);
+}

package/dist/engine/build-css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-css.d.ts","sourceRoot":"","sources":["../../src/engine/build-css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAazD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA+DhE"}
+{"version":3,"file":"build-css.d.ts","sourceRoot":"","sources":["../../src/engine/build-css.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAazD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA6GhE"}

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- ')}
@@ -47,7 +47,31 @@ Use one of the available presets or remove it from ngcorex.config.ts`);
     if (tokens.colors) {
         Object.assign(allTokens, normalizeColorTokens(tokens.colors));
     }
-    // 5. Generate CSS
+    // 5. Normalize radius
+    if (tokens.radius) {
+        Object.assign(allTokens, normalizeTokenScale('radius', tokens.radius));
+    }
+    // 6. Normalize z-index
+    if (tokens.zIndex) {
+        Object.assign(allTokens, normalizeTokenScale('zIndex', tokens.zIndex));
+    }
+    // 7. Normalize typography
+    if (tokens.typography) {
+        if (tokens.typography.fontSize) {
+            Object.assign(allTokens, normalizeTokenScale('fontSize', tokens.typography.fontSize));
+        }
+        if (tokens.typography.fontWeight) {
+            Object.assign(allTokens, normalizeTokenScale('fontWeight', tokens.typography.fontWeight));
+        }
+        if (tokens.typography.lineHeight) {
+            Object.assign(allTokens, normalizeTokenScale('lineHeight', tokens.typography.lineHeight));
+        }
+    }
+    // 8. Normalize shadows
+    if (tokens.shadows) {
+        Object.assign(allTokens, normalizeTokenScale('shadows', tokens.shadows));
+    }
+    // 9. Generate CSS
     const css = generateCssVariables(allTokens);
     return wrapCss(css, config.output?.layer);
 }

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"}