CSS ruleset parser using Svelte's CSS parser.
Parses CSS rulesets to extract selectors and declarations with position information. Used for: - Phase 0a: Detecting single-selector rulesets that could be converted to declaration format - Phase 2: Modifying selectors for modifier support on composite classes
14 declarations
css_ruleset_parser.ts view source
(css: string, rules: ParsedRule[]): string | null Extracts the CSS comment from a ruleset (if any). Looks for comments before the first rule.
cssraw CSS string
stringrulesparsed rules
ParsedRule[]string | null comment text without delimiters, or null if no comment
css_ruleset_parser.ts view source
(selector: string, class_pos: number): number Finds the end position of the compound selector containing the class at class_pos. A compound selector is a sequence of simple selectors without combinators.
selectorthe CSS selector string
stringclass_posposition of the . in .class_name
numbernumber position where state modifiers should be inserted (before any pseudo-element)
css_ruleset_parser.ts view source
(original_ruleset: string, original_class: string, new_class_escaped: string, state_css: string, pseudo_element_css: string, media_wrapper: string | null, ancestor_wrapper: string | null): ModifiedRulesetResult Generates CSS for a modified ruleset with applied modifiers.
Conflict handling is per-selector within selector lists:
- For .plain:hover, .plain:active with hover: modifier, only .plain:hover skips
the :hover addition; .plain:active still gets :hover appended.
- For multiple states like :hover:focus, each is checked individually; conflicting
states are skipped while non-conflicting ones are still applied.
original_rulesetthe original CSS ruleset string
stringoriginal_classthe base class name
stringnew_class_escapedthe escaped new class name with modifiers
stringstate_cssstate modifier CSS (e.g., ":hover" or ":hover:focus")
stringpseudo_element_csspseudo-element modifier CSS (e.g., "::before")
stringmedia_wrappermedia query wrapper (e.g., "@media (width >= 48rem)")
string | nullancestor_wrapperancestor wrapper (e.g., ":root.dark")
string | nullModifiedRulesetResult result with generated CSS and information about skipped modifiers
css_ruleset_parser.ts view source
(rules: ParsedRule[], escaped_class_name: string): boolean Checks if a ruleset has only a single simple selector (just the class name). Used to detect rulesets that could be converted to declaration format.
rulesparsed rules from the ruleset
ParsedRule[]escaped_class_namethe CSS-escaped class name (e.g., "box" or "hover\\:card")
stringboolean true if there's exactly one rule with selector ".class_name"
css_ruleset_parser.ts view source
ModifiedRulesetResult Result from generating a modified ruleset.
Uses | null for skipped_modifiers to avoid allocating empty arrays.
Callers should use a guard pattern: if (result.skipped_modifiers) { ... }
cssThe generated CSS
stringskipped_modifiersInformation about modifiers that were skipped for certain rules, or null if none
Array<SkippedModifierInfo> | nullcss_ruleset_parser.ts view source
ModifiedSelectorGroupResult Result from modifying a selector group with conflict detection.
Uses | null for skipped_modifiers to avoid allocating empty arrays.
Callers should use a guard pattern: if (result.skipped_modifiers) { ... }
selectorThe modified selector list as a string
stringskipped_modifiersInformation about modifiers skipped for specific selectors, or null if none
Array<SkippedModifierInfo> | nullcss_ruleset_parser.ts view source
(selector_group: string, original_class: string, new_class_escaped: string, states_to_add: string[], pseudo_element_css: string): ModifiedSelectorGroupResult Modifies a selector list (comma-separated selectors) to add modifiers. Handles conflicts per-selector: if one selector in a list has a conflict, only that selector skips the modifier; other selectors still get it.
selector_groupCSS selector list (may contain commas)
stringoriginal_classthe base class name
stringnew_class_escapedthe escaped new class name
stringstates_to_addindividual state modifiers (e.g., [":hover", ":focus"])
string[]pseudo_element_csspseudo-element modifier CSS to insert (e.g., "::before")
stringModifiedSelectorGroupResult result with modified selector list and information about skipped modifiers
css_ruleset_parser.ts view source
(selector: string, original_class: string, new_class_escaped: string, state_css: string, pseudo_element_css: string): string Modifies a single CSS selector to add modifiers.
selectora single CSS selector (not a selector list)
stringoriginal_classthe base class name (e.g., "menuitem")
stringnew_class_escapedthe escaped new class name (e.g., "hover\\:menuitem")
stringstate_cssstate modifier CSS to insert (e.g., ":hover")
stringpseudo_element_csspseudo-element modifier CSS to insert (e.g., "::before")
stringstring modified selector
modify_single_selector('.menuitem', 'menuitem', 'hover\\:menuitem', ':hover', '')
// → '.hover\\:menuitem:hover'
modify_single_selector('.menuitem .icon', 'menuitem', 'hover\\:menuitem', ':hover', '')
// → '.hover\\:menuitem:hover .icon'
modify_single_selector('.menuitem.selected', 'menuitem', 'hover\\:menuitem', ':hover', '')
// → '.hover\\:menuitem.selected:hover'css_ruleset_parser.ts view source
(css: string): ParsedRuleset Parses a CSS ruleset string using Svelte's CSS parser.
cssraw CSS string (e.g., ".box { display: flex; }")
stringParsedRuleset ParsedRuleset with structured rule data and positions
css_ruleset_parser.ts view source
ParsedRule A parsed CSS rule with its components and positions.
selectorFull selector string (e.g., ".box", ".selectable:hover")
stringselector_startStart position of selector in original CSS (0-indexed)
numberselector_endEnd position of selector in original CSS
numberdeclarationsThe declarations block (without braces)
stringrule_startStart position of the entire rule
numberrule_endEnd position of the entire rule
numbercss_ruleset_parser.ts view source
ParsedRuleset Result of parsing a CSS ruleset.
rulesAll rules in the ruleset
Array<ParsedRule>css_ruleset_parser.ts view source
(rules: ParsedRule[], escaped_class_name: string): boolean Checks if any selector in the ruleset contains the expected class name. Used to validate that ruleset definitions match their key.
rulesparsed rules from the ruleset
ParsedRule[]escaped_class_namethe CSS-escaped class name (e.g., "clickable" or "hover\\:card")
stringboolean true if at least one selector contains ".class_name"
css_ruleset_parser.ts view source
SkippedModifierInfo Information about a modifier that was skipped for a selector during ruleset modification. The selector is still included in output, just without the conflicting modifier applied.
selectorThe specific selector where the modifier was skipped (not the full selector list)
stringreasonReason the modifier was skipped
'pseudo_element_conflict' | 'state_conflict'conflicting_modifierThe conflicting modifier that was not applied (e.g., "::before" or ":hover")
stringcss_ruleset_parser.ts view source
(selector_group: string): string[] Splits a selector list by commas, respecting parentheses, brackets, and quoted strings.
selector_groupstringstring[] split_selector_list('.a, .b') // → ['.a', '.b']
split_selector_list('.a:not(.b), .c') // → ['.a:not(.b)', '.c']
split_selector_list('.a[data-x="a,b"], .c') // → ['.a[data-x="a,b"]', '.c']