/** * CSS class resolution utilities for composing class definitions. * * Provides the `resolve_composes` helper to recursively resolve class names * to their combined CSS declarations. * * @internal * * @module */ import type { InterpreterDiagnostic } from './diagnostics.js'; import type { CssClassDefinition, CssClassDefinitionStatic } from './css_class_definitions.js'; /** * Result from resolving a `composes` array to combined declarations. */ export type ResolveComposesResult = { ok: true; declaration: string; warnings: Array | null; } | { ok: false; error: InterpreterDiagnostic; }; /** * Resolves a class definition's declaration, handling `composes` composition. * * If the definition has a `composes` property, resolves those classes recursively * and combines with any explicit `declaration`. If no `composes`, returns the * explicit `declaration` directly. * * @param def - the class definition to resolve * @param class_name - the name of the class being resolved (for error messages) * @param definitions - record of all known class definitions * @param css_properties - set of valid CSS properties for literal validation, or null to skip * @returns combined declaration or an error */ export declare const resolve_class_definition: (def: CssClassDefinitionStatic, class_name: string, definitions: Record, css_properties?: Set | null) => ResolveComposesResult; /** * Resolves an array of class names to their combined CSS declarations. * * Recursively resolves nested `composes` arrays and combines all declarations. * Validates that referenced classes exist and are resolvable (not rulesets or interpreters). * Supports unmodified CSS literals (e.g., `text-align:center`) in the composes array. * * Deduplication behavior: * - Diamond dependencies (class reached via different composition branches) are silently skipped * - Redundant listings (class already included by an earlier sibling in this array) emit a warning * * @param class_names - array of class names to resolve * @param definitions - record of all known class definitions * @param resolution_stack - set of class names currently being resolved (for cycle detection) * @param visited - set of all class names already resolved (for deduplication) * @param original_class_name - the class name being defined (for error messages) * @param css_properties - set of valid CSS properties for literal validation, or null to skip * @returns combined declarations or an error * @mutates `resolution_stack` - temporarily adds/removes names during recursion * @mutates `visited` - adds resolved class names for deduplication */ export declare const resolve_composes: (class_names: Array, definitions: Record, resolution_stack: Set, visited: Set, original_class_name: string, css_properties?: Set | null) => ResolveComposesResult; //# sourceMappingURL=css_class_resolution.d.ts.map