@wix/css-property-parser/dist/evaluators/word-break.js

A comprehensive TypeScript library for parsing and serializing CSS property values with full MDN specification compliance

import { isCssVariable, isGlobalKeyword, getValidKeyword } from '../utils/shared-utils.js';
import { parse as parseCSSVariable, toCSSValue as cssVariableToCSSValue } from './css-variable.js';
import { WORD_BREAK_KEYWORDS } from '../types.js';
/**
 * Parses CSS word-break property values
 *
 * Syntax: normal | break-all | keep-all | break-word | inherit | initial | unset | revert
 *
 * @param value - The CSS word-break value to parse
 * @returns Parsed WordBreakValue or null if invalid
 *
 * @example
 * ```typescript
 * parse('normal') // { type: 'keyword', keyword: 'normal' }
 * parse('break-all') // { type: 'keyword', keyword: 'break-all' }
 * parse('keep-all') // { type: 'keyword', keyword: 'keep-all' }
 * ```
 */
export function parse(value) {
    if (!value || typeof value !== 'string') {
        return null;
    }
    const trimmed = value.trim();
    if (trimmed === '') {
        return null;
    }
    // Handle CSS variables
    if (isCssVariable(trimmed)) {
        return parseCSSVariable(trimmed);
    }
    // Handle global keywords
    if (isGlobalKeyword(trimmed)) {
        return {
            type: 'keyword',
            keyword: trimmed.toLowerCase()
        };
    }
    // Handle word-break specific keywords
    const keyword = getValidKeyword(trimmed, WORD_BREAK_KEYWORDS);
    if (keyword) {
        return {
            type: 'keyword',
            keyword: keyword
        };
    }
    return null;
}
/**
 * Converts a parsed WordBreakValue back to a CSS string
 *
 * @param parsed - The parsed WordBreakValue to convert
 * @returns CSS string representation or null if invalid
 *
 * @example
 * ```typescript
 * toCSSValue({ type: 'keyword', keyword: 'normal' }) // 'normal'
 * toCSSValue({ type: 'keyword', keyword: 'break-all' }) // 'break-all'
 * toCSSValue({ type: 'keyword', keyword: 'keep-all' }) // 'keep-all'
 * ```
 */
export function toCSSValue(parsed) {
    if (!parsed) {
        return null;
    }
    // Handle CSS variables
    if ('variable' in parsed || 'CSSvariable' in parsed) {
        return cssVariableToCSSValue(parsed);
    }
    // Handle keywords
    if ('keyword' in parsed) {
        return parsed.keyword;
    }
    return null;
}