Function buildTokens

packages/dev/s2-docs/scripts/generateMarkdownDocs.mjs:845–886

  // Type categories like `baseSpacing` are emitted as aliases; their full value sets
  // are documented once in the Value Sets section at the top of the page.
  const buildTokens = propertyName => {
    const def = definitions[propertyName] || {};
    const values = Array.isArray(def.values) ? def.values : [];
    const additionalTypes = Array.isArray(def.additionalTypes) ? def.additionalTypes : [];
    const tokens = [];
    const seen = new Set();

    const addToken = token => {
      if (!token || seen.has(token)) {
        return;
      }
      seen.add(token);
      tokens.push(token);
    };

    const formatValue = value => {
      if (typeof value === 'number') {
        return `\`${value}\``;
      }
      const str = String(value);
      if (BARE_VALUE_TOKENS.has(str) || str.includes('${')) {
        return `\`${str}\``;
      }
      return `\`'${str}'\``;
    };

    values.forEach(value => {
      if (value === undefined || value === null) {
        return;
      }
      addToken(formatValue(value));
    });

    additionalTypes.forEach(typeName => {
      if (!typeName) {
        return;
      }
      addToken(`\`${String(typeName)}\``);
    });

    return tokens;
  };

  // Group properties by identical token signatures so shared value sets collapse into one row.
  // Example: margin/marginTop/marginBottom/... all share the same tokens and merge to one row.