bundle: update (2026-01-16)

extensions/botbox3000/deps/tinycss2/serializer.py

@@ -0,0 +1,146 @@
+import re
+
+
+def serialize(nodes):
+    """Serialize nodes to CSS syntax.
+
+    This should be used for :term:`component values`
+    instead of just :meth:`tinycss2.ast.Node.serialize` on each node
+    as it takes care of corner cases such as ``;`` between declarations,
+    and consecutive identifiers
+    that would otherwise parse back as the same token.
+
+    :type nodes: :term:`iterable`
+    :param nodes: An iterable of :class:`tinycss2.ast.Node` objects.
+    :returns: A :obj:`string <str>` representing the nodes.
+
+    """
+    chunks = []
+    _serialize_to(nodes, chunks.append)
+    return ''.join(chunks)
+
+
+def serialize_identifier(value):
+    """Serialize any string as a CSS identifier
+
+    :type value: :obj:`str`
+    :param value: A string representing a CSS value.
+    :returns:
+        A :obj:`string <str>` that would parse as an
+        :class:`tinycss2.ast.IdentToken` whose
+        :attr:`tinycss2.ast.IdentToken.value` attribute equals the passed
+        ``value`` argument.
+
+    """
+    if value == '-':
+        return r'\-'
+
+    if value[:2] == '--':
+        return '--' + serialize_name(value[2:])
+
+    if value[0] == '-':
+        result = '-'
+        value = value[1:]
+    else:
+        result = ''
+    c = value[0]
+    result += (
+        c if c in ('abcdefghijklmnopqrstuvwxyz_'
+                   'ABCDEFGHIJKLMNOPQRSTUVWXYZ') or ord(c) > 0x7F else
+        r'\A ' if c == '\n' else
+        r'\D ' if c == '\r' else
+        r'\C ' if c == '\f' else
+        '\\%X ' % ord(c) if c in '0123456789' else
+        '\\' + c
+    )
+    result += serialize_name(value[1:])
+    return result
+
+
+def serialize_name(value):
+    return ''.join(
+        c if c in ('abcdefghijklmnopqrstuvwxyz-_0123456789'
+                   'ABCDEFGHIJKLMNOPQRSTUVWXYZ') or ord(c) > 0x7F else
+        r'\A ' if c == '\n' else
+        r'\D ' if c == '\r' else
+        r'\C ' if c == '\f' else
+        '\\' + c
+        for c in value
+    )
+
+
+_replacement_string_value = {
+    '"': r'\"',
+    '\\': r'\\',
+    '\n': r'\A ',
+    '\r': r'\D ',
+    '\f': r'\C ',
+}
+_re_string_value = ''.join(re.escape(char) for char in _replacement_string_value)
+_re_string_value = re.compile(f'[{_re_string_value}]', re.MULTILINE)
+def _serialize_string_value_match(match):
+    return _replacement_string_value[match.group(0)]
+def serialize_string_value(value):
+    return _re_string_value.sub(_serialize_string_value_match, value)
+
+
+def serialize_url(value):
+    return ''.join(
+        r"\'" if c == "'" else
+        r'\"' if c == '"' else
+        r'\\' if c == '\\' else
+        r'\ ' if c == ' ' else
+        r'\9 ' if c == '\t' else
+        r'\A ' if c == '\n' else
+        r'\D ' if c == '\r' else
+        r'\C ' if c == '\f' else
+        r'\(' if c == '(' else
+        r'\)' if c == ')' else
+        c
+        for c in value
+    )
+
+
+# https://drafts.csswg.org/css-syntax/#serialization-tables
+def _serialize_to(nodes, write):
+    """Serialize an iterable of nodes to CSS syntax.
+
+    White chunks as a string by calling the provided :obj:`write` callback.
+
+    """
+    bad_pairs = BAD_PAIRS
+    previous_type = None
+    for node in nodes:
+        serialization_type = (node.type if node.type != 'literal'
+                              else node.value)
+        if (previous_type, serialization_type) in bad_pairs:
+            write('/**/')
+        elif previous_type == '\\' and not (
+                serialization_type == 'whitespace' and
+                node.value.startswith('\n')):
+            write('\n')
+        node._serialize_to(write)
+        if serialization_type == 'declaration':
+            write(';')
+        previous_type = serialization_type
+
+
+BAD_PAIRS = set(
+    [(a, b)
+        for a in ('ident', 'at-keyword', 'hash', 'dimension', '#', '-', 'number')
+        for b in ('ident', 'function', 'url', 'number', 'percentage',
+                  'dimension', 'unicode-range')] +
+    [(a, b)
+        for a in ('ident', 'at-keyword', 'hash', 'dimension')
+        for b in ('-', '-->')] +
+    [(a, b)
+        for a in ('#', '-', 'number', '@')
+        for b in ('ident', 'function', 'url')] +
+    [(a, b)
+        for a in ('unicode-range', '.', '+')
+        for b in ('number', 'percentage', 'dimension')] +
+    [('@', b) for b in ('ident', 'function', 'url', 'unicode-range', '-')] +
+    [('unicode-range', b) for b in ('ident', 'function', '?')] +
+    [(a, '=') for a in '$*^~|'] +
+    [('ident', '() block'), ('|', '|'), ('/', '*')]
+)