chaincss 2.1.37 → 2.1.39

package/dist/core/compiler.d.ts

@@ -1,5 +1,6 @@
 import type { ChainCSSConfig, CompileResult, StyleDefinition } from './types.js';
 import { AtomicOptimizer } from '../compiler/atomic-optimizer.js';
+import type { GraphCompileOptions } from '../compiler/style-graph.js';
 export declare class ChainCSSCompiler {
     private config;
     private prefixer;
@@ -18,6 +19,17 @@ export declare class ChainCSSCompiler {
     private compileQueue;
     private lruList;
     constructor(config: ChainCSSConfig);
+    /**
+   * Compile using the style graph compiler for advanced optimizations.
+   *
+   * @example
+   * const result = compiler.compileWithGraph(styles, {
+   *   eliminateDead: true,
+   *   knownSelectors: ['.header', '.footer'],
+   *   mergeIdentical: true
+   * });
+   */
+    compileWithGraph(styles: Record<string, import('./types.js').StyleDefinition>, options?: GraphCompileOptions): import('./types.js').GraphCompileResult;
     hasStyles(): boolean;
     private processStyleObject;
     private addToCache;

package/dist/core/types.d.ts

@@ -199,3 +199,148 @@ export declare function isStyleDefinition(value: any): value is StyleDefinition;
 export declare function isAtRule(value: any): value is AtRule;
 export declare function isAtomicClass(value: any): value is AtomicClass;
 export declare function isCompileResult(value: any): value is CompileResult;
+export type CSSUnit = 'px' | 'rem' | 'em' | '%' | 'vw' | 'vh' | 'vmin' | 'vmax' | 'ch' | 'ex' | 'cm' | 'mm' | 'in' | 'pt' | 'pc' | 'deg' | 'rad' | 'turn' | 'grad' | 's' | 'ms' | 'dpi' | 'dpcm' | 'dppx';
+export interface CSSMathValue {
+    value: number;
+    unit: CSSUnit;
+}
+export interface MathContext {
+    rootFontSize?: number;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    parentFontSize?: number;
+    dpi?: number;
+    elementWidth?: number;
+    elementHeight?: number;
+}
+export interface MathResult {
+    value: number;
+    unit: CSSUnit | 'calc' | 'mixed';
+    expression: string;
+    resolved: CSSMathValue | null;
+    explanations: string[];
+    toString(): string;
+    toCalc(): string;
+}
+export interface FluidTypeConfig {
+    minSize: number;
+    maxSize: number;
+    minWidth?: number;
+    maxWidth?: number;
+    unit?: 'px' | 'rem';
+    rootFontSize?: number;
+}
+export interface IntentRule {
+    input: string | RegExp;
+    output: string | ((match: RegExpMatchArray) => string);
+    defaults?: Record<string, string | number>;
+    confidence: number;
+    description: string;
+}
+export interface CorrectionResult {
+    original: string;
+    property: string;
+    corrected: string;
+    defaults: Record<string, string | number>;
+    confidence: number;
+    intent: string;
+    explanation: string;
+}
+export interface IntentContext {
+    property?: string;
+    value?: string;
+    selector?: string;
+    parentStyles?: Record<string, any>;
+    mediaContext?: string;
+    themeContext?: string;
+}
+export type HealMode = 'strict' | 'dev' | 'smart';
+export interface HealResult {
+    fixed: Record<string, any>;
+    corrections: CorrectionResult[];
+    warnings: string[];
+    mode: HealMode;
+}
+export interface StyleGraphNode {
+    id: string;
+    selector: string;
+    properties: Record<string, string | number>;
+    specificity: number;
+    dependencies: string[];
+    dependents: string[];
+    mediaQuery?: string;
+    isDead: boolean;
+    hash: string;
+    sourceComponent?: string;
+}
+export interface StyleGraphEdge {
+    from: string;
+    to: string;
+    type: 'extends' | 'overrides' | 'references';
+}
+export interface StyleGraph {
+    nodes: Map<string, StyleGraphNode>;
+    edges: StyleGraphEdge[];
+    rootNodes: string[];
+    leafNodes: string[];
+}
+export interface GraphCompileOptions {
+    eliminateDead?: boolean;
+    knownSelectors?: string[];
+    mergeIdentical?: boolean;
+    mergeThreshold?: number;
+    sortOutput?: 'specificity' | 'source-order' | 'topological';
+    verbose?: boolean;
+}
+export interface GraphCompileResult extends CompileResult {
+    graph: StyleGraph;
+    eliminatedDead: number;
+    mergedRules: number;
+    optimizationTime: number;
+    preOptimizationSize: number;
+    postOptimizationSize: number;
+}
+export type DiagnosticSeverity = 'error' | 'warning' | 'info' | 'hint';
+export interface StyleDiagnostic {
+    property: string;
+    value?: string;
+    selector?: string;
+    severity: DiagnosticSeverity;
+    message: string;
+    suggestion?: string;
+    code?: string;
+    source?: string;
+    range?: {
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+}
+export interface StyleAnalysis {
+    diagnostics: StyleDiagnostic[];
+    conflicts: StyleDiagnostic[];
+    breakpoints: BreakpointConfig[];
+    unusedSelectors: string[];
+    deadStyles: string[];
+    duplicationWarnings: StyleDiagnostic[];
+    optimizationSuggestions: StyleDiagnostic[];
+    stats: {
+        totalProperties: number;
+        totalSelectors: number;
+        shorthandOpportunities: number;
+        animationSuggestions: number;
+        responsiveIssues: number;
+    };
+}
+export interface BreakpointInference {
+    selector: string;
+    property: string;
+    currentValue: string;
+    suggestedBreakpoint: string;
+    suggestedValue: string;
+    reason: string;
+}
+export declare function isMathResult(value: any): value is MathResult;
+export declare function isCorrectionResult(value: any): value is CorrectionResult;
+export declare function isGraphCompileResult(value: any): value is GraphCompileResult;

package/dist/index.d.ts

@@ -55,3 +55,11 @@ export type ResponsiveValue<T> = T | {
 };
 export type StyleWithTokens<T = any> = T | ((tokens: DesignTokens) => T);
 import { DesignTokens } from './compiler/tokens.js';
+export { math, add, subtract, multiply, divide, fluidType, convert, toPx, scale } from './compiler/math-engine.js';
+export type { CSSUnit, CSSMathValue, MathContext, MathResult, FluidTypeConfig } from './compiler/math-engine.js';
+export { intent, correct, heal, validate as validateValue, getIntent } from './compiler/intent-engine.js';
+export type { CorrectionResult, HealMode, HealResult, IntentContext } from './compiler/intent-engine.js';
+export { StyleGraphCompiler, compileGraph } from './compiler/style-graph.js';
+export type { StyleGraph, StyleGraphNode, StyleGraphEdge, GraphCompileOptions, GraphCompileResult } from './compiler/style-graph.js';
+export { StyleAnalyzer, analyze as analyzeStyle } from './compiler/analyzer.js';
+export type { StyleDiagnostic, StyleAnalysis, BreakpointInference, DiagnosticSeverity } from './compiler/analyzer.js';