@wix/css-property-parser/commonjs/evaluators/white-space.cjs

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

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.parse = parse;
exports.toCSSValue = toCSSValue;
const shared_utils_1 = require('../utils/shared-utils.cjs');
const css_variable_1 = require('./css-variable.cjs');
const types_1 = require('../types.cjs');
/**
 * Parses CSS white-space property values
 *
 * Syntax: normal | nowrap | pre | pre-wrap | pre-line | break-spaces | inherit | initial | unset | revert
 *
 * @param value - The CSS white-space value to parse
 * @returns Parsed WhiteSpaceValue or null if invalid
 *
 * @example
 * ```typescript
 * parse('normal') // { type: 'keyword', keyword: 'normal' }
 * parse('nowrap') // { type: 'keyword', keyword: 'nowrap' }
 * parse('pre-wrap') // { type: 'keyword', keyword: 'pre-wrap' }
 * parse('inherit') // { type: 'keyword', keyword: 'inherit' }
 * parse('var(--my-whitespace)') // { type: 'css-variable', variable: 'my-whitespace' }
 * ```
 */
function parse(value) {
    if (!value || typeof value !== 'string') {
        return null;
    }
    const trimmed = value.trim();
    if (trimmed === '') {
        return null;
    }
    // CSS variables - parse and return directly
    if ((0, shared_utils_1.isCssVariable)(trimmed)) {
        return (0, css_variable_1.parse)(trimmed);
    }
    // Handle global keywords
    if ((0, shared_utils_1.isGlobalKeyword)(trimmed)) {
        return {
            type: 'keyword',
            keyword: trimmed.toLowerCase()
        };
    }
    // Handle white-space specific keywords
    const keywordResult = (0, shared_utils_1.getValidKeyword)(trimmed.toLowerCase(), types_1.WHITE_SPACE_KEYWORDS);
    if (keywordResult) {
        return {
            type: 'keyword',
            keyword: keywordResult
        };
    }
    return null;
}
/**
 * Converts a parsed WhiteSpaceValue back to its CSS string representation
 *
 * @param value - The parsed white-space value
 * @returns CSS string representation or null if invalid
 */
function toCSSValue(value) {
    if (!value) {
        return null;
    }
    // Handle CSS variables
    if (value.type === 'variable') {
        return (0, css_variable_1.toCSSValue)(value);
    }
    // Handle keyword values (both white-space-specific and global)
    if (value.type === 'keyword') {
        return value.keyword;
    }
    return null;
}