Skip to content

An open source design system that's fully customizable and agent ready

TypeScript
2.1 KB
Raw Blame
// Copyright (c) Meta Platforms, Inc. and affiliates.

import {themeDataAttributeName} from './themeProps';

/** Escape a value for a double-quoted CSS attribute selector string. */
function escapeAttributeValue(value: string): string {
  let escaped = '';
  for (const char of value) {
    const codePoint = char.codePointAt(0) ?? 0;
    if (
      char === '"' ||
      char === '\\' ||
      codePoint < 0x20 ||
      codePoint === 0x7f
    ) {
      escaped += `\\${(codePoint === 0 ? 0xfffd : codePoint).toString(16)} `;
    } else {
      escaped += char;
    }
  }
  return escaped;
}

/**
 * Parse a component style key into a CSS data-attribute selector suffix.
 *
 * Used by the shared theme compiler so semantic authoring keys match the
 * attributes emitted by `themeProps()`:
 *
 * - `prop:value` selects `[data-prop="value"]`.
 * - A bare state selects `[data-state="state"]`.
 * - `+` combines selectors on the same stable `astryx-*` target.
 *
 * Keeping the axis name in the selector prevents collisions between equal
 * values on different props, such as Grid's `align="center"` and
 * `justify="center"`.
 *
 * <!-- SYNC: packages/core/src/utils/themeProps.ts -->
 *
 * @example
 * ```ts
 * parseStyleKey('base')                        // ''
 * parseStyleKey('checked')                     // '[data-checked="checked"]'
 * parseStyleKey('checked+disabled')            // '[data-checked="checked"][data-disabled="disabled"]'
 * parseStyleKey('variant:secondary')           // '[data-variant="secondary"]'
 * parseStyleKey('level:1')                     // '[data-level="1"]'
 * parseStyleKey('variant:destructive+size:sm') // '[data-variant="destructive"][data-size="sm"]'
 * ```
 */
export function parseStyleKey(key: string): string {
  if (key === 'base') {
    return '';
  }

  return key
    .split('+')
    .map(part => {
      const separator = part.indexOf(':');
      const prop = separator === -1 ? part : part.slice(0, separator);
      const value = separator === -1 ? part : part.slice(separator + 1);
      return `[${themeDataAttributeName(prop)}="${escapeAttributeValue(value)}"]`;
    })
    .join('');
}