Saltar al contenido

De Figma al código

Completar la exportación

Por qué la exportación de Figma no se puede usar tal cual y cómo se completa: los alias recuperados, el tipo deducido del scope, las unidades y la opacidad. Un paso que se detiene antes que adivinar.

Última revisión:

La exportación de Figma es casi DTCG. Le faltan las referencias de los alias entre colecciones, las unidades y algunos tipos. En esta lección verás qué hace DesignToken101 con cada token antes de generar el CSS, y por qué cada cambio sale de una decisión que tomaste en Figma.

En esta página

Por qué no se usa tal cual

Las cuatro diferencias entre la exportación y DTCG las viste en Figma exporta casi DTCG: alias resueltos, tamaños sin unidad, la familia como string y el peso como number.

Lo que dice la fuente: una herramienta no puede arreglarlas por su cuenta. El Format Module prohíbe deducir el tipo de un token a partir de su valor (Format Module: Type). Un 16 puede ser un tamaño, un peso o un número de columnas, y la herramienta no tiene derecho a decidirlo.

Lo que comprobamos: con la exportación tal cual, Style Dictionary 5.5.5 y Terrazzo 2.7.1 escriben --t101-space-100: 4, sin unidad, que no es CSS válido, y escriben el valor resuelto de cada alias en vez de var() (octubre de 2026).

Recomendación

En DesignToken101, un paso propio prepara la exportación antes de la herramienta de traducción. Lo llamamos normalización: lee tokens/figma/, escribe DTCG estricto en tokens/dtcg/ y no toca los archivos de Figma. Si vuelves a exportar, se repite el paso y tokens/dtcg/ se genera de nuevo.

Cada token pasa por los cambios que necesita. No son pasos en orden: un alias de tamaño, por ejemplo, recupera su referencia y cambia de tipo a la vez.

Recuperar los alias

El destino del alias está en com.figma.aliasData, con el nombre de la variable de Figma. La normalización lo convierte en una referencia DTCG: cambia cada / por un punto y pone el resultado entre llaves (Format Module: Aliases / References).

En la exportaciónDespués de normalizar
$value: #101A15, y targetVariableName: color/neutral/900$value: "{color.neutral.900}"

El valor resuelto desaparece: lo calculará la herramienta siguiendo la referencia. Así, en el CSS, el semántico apunta al primitivo con var() y la capa de alias sigue viva.

La conversión funciona porque el nombre de Figma y la ruta del token en DTCG son el mismo nombre escrito de dos formas (Un nombre en Figma, DTCG y CSS). Con tu convención de nombres, la referencia sale sola.

Un alias dentro de la misma colección ya sale de Figma como referencia DTCG en $value (Qué sale de Figma). La normalización lo deja como está y solo le pone el tipo que le corresponde. Sin esa comprobación, un alias de tamaño acabaría como { "value": "{space.100}", "unit": "px" }, que no es DTCG válido: lo vimos en una versión anterior del script, que no daba ningún error (octubre de 2026).

El tipo sale del scope

Un número de Figma no dice qué es. Su scope sí: es la lista de propiedades en las que se puede aplicar la variable, una decisión de diseño que tomaste al crearla (Para qué sirve el scope). La normalización usa esa decisión para elegir el tipo DTCG:

Scope en la exportaciónPropiedad en FigmaTipo DTCG
GAPGap y padding de auto layoutdimension
CORNER_RADIUSRadiodimension
STROKE_FLOATGrosor del trazodimension
FONT_SIZETamaño de fuentedimension
WIDTH_HEIGHTAncho y altodimension
FONT_STYLE (en una variable de número)Peso tipográficofontWeight
FONT_FAMILY (con $type string)Familia tipográficafontFamily

Los colores ya salen como color, un tipo DTCG, y no cambian.

Dos detalles de esta tabla:

  • La exportación no escribe el scope del peso con su nombre. En Figma, los pesos de DesignToken101 tienen el scope de peso tipográfico, que la API de plugins llama FONT_WEIGHT (Plugin API: VariableScope). La exportación lo escribe como FONT_STYLE, el nombre que la API reserva para el estilo de las variables de texto (comprobado con la API de plugins y la exportación de esta web, octubre de 2026). Por eso la normalización busca FONT_STYLE en una variable number. Con los bordes pasa algo parecido: STROKE_COLOR en Figma, STROKE en la exportación. Los colores no cambian de tipo, así que ese nombre no afecta a la normalización.
  • El peso es un number en Figma porque lo creamos como variable Number, no como String (Tipografía). En DTCG, fontWeight admite números del 1 al 1000 (Format Module: Font weight): el valor no cambia; cambia el tipo.

Aviso

Una variable de número sin scope, o con el scope de todas las propiedades (ALL_SCOPES), no se normaliza hasta que decides su tipo: no hay ninguna decisión de la que deducirlo. Los scopes que pusiste en los módulos 2 a 5 ordenan los selectores de Figma y, además, deciden el tipo en código.

Las unidades

Figma guarda los tamaños en píxeles y los exporta sin unidad: "$value": 16. La importación de Figma admite dimension únicamente en px (Figma: Modes for variables), así que la normalización escribe px:

"$value": { "value": 16, "unit": "px" }

DTCG admite dos unidades para dimension, px y rem (Format Module: Dimension). El paso a rem no se hace aquí: es una decisión del CSS, y la verás en Las variables CSS.

La opacidad en float32

Los dos fondos con transparencia de DesignToken101 muestran un detalle de la exportación (Cuando un semántico no es alias). Figma escribe la opacidad como un número de coma flotante de 32 bits (float32). Un 50 % es exacto en ese formato; un 90 %, no:

Escrito en FigmaEn la exportación
50 %"alpha": 0.5
90 %"alpha": 0.8999999761581421

0.8999999761581421 es el float32 más cercano a 0.9. Es lo que devuelve Math.fround(0.9) en JavaScript, el método que da la representación float32 de un número (MDN: Math.fround).

La diferencia parece despreciable, pero cae justo en un redondeo. En un color hexadecimal, la opacidad es un número de 0 a 255:

  • 0,9 × 255 = 229,5, que se redondea a 230: e6.
  • 0,8999999761581421 × 255 = 229,49999…, que se redondea a 229: e5, un 89,8 %.

Sin corregir, el fondo de la cabecera en Dark saldría #050c09e5 en vez de #050c09e6. El de Light, al 96 %, no tiene el problema: 0,96 × 255 = 244,8, lejos del medio, y da f5 con float32 o sin él.

Recomendación

La normalización sustituye el alpha por el decimal más corto que da el mismo float32: 0.9. No es una aproximación, es el valor que se escribió en Figma. Si el alpha no es un float32, lo deja como está. Así el CSS coincide con lo que dice la especificación del sistema.

Detenerse antes que adivinar

Si la normalización encuentra un token sin un tipo decidido, no escribe nada y dice todos los casos de una vez, con cuántos tokens tiene cada uno. Un token no tiene tipo decidido si su scope no está en el mapa del script, si no tiene scope o tiene ALL_SCOPES, o si tiene dos scopes que darían tipos distintos. Hace lo mismo con una referencia cuyo destino no está en los archivos. No elige un tipo por su cuenta: es la regla del Format Module aplicada al propio script.

Lo comprobamos el 2026-10-08 con Node.js 22.22.0, sobre una copia de la exportación: añadimos una variable Number con el scope ALL_SCOPES y el script paró con este mensaje:

No se ha escrito nada en tokens/dtcg/.

Tokens sin tipo DTCG decidido:
- number con ALL_SCOPES: 1 token (size.test)

Decide el tipo de cada uno y añádelo a SCOPE_TYPES, al principio de este archivo. Por ejemplo:
  number: { 'ALL_SCOPES': 'dimension' | 'number' | 'fontWeight' | 'exclude' }

La decisión es tuya y queda escrita en el propio script, en el mapa SCOPE_TYPES. exclude deja el token fuera de la salida. Con esta misma regla detectamos, al preparar la primera exportación (2026-10-03), que la exportación escribe el scope de los pesos como FONT_STYLE.

Si no quieres instalar nada, Normalizar la exportación hace lo mismo en tu navegador, con este script, y te pide el tipo de los scopes que no conoce.

Lo que te llevas

  • La exportación no se usa tal cual: una herramienta no puede deducir el tipo por el valor, y sin preparar da CSS inválido y pierde los alias.
  • La normalización recupera las referencias, deduce el tipo del scope, añade la unidad y devuelve la opacidad al valor escrito.
  • Ante un caso que no conoce, el paso se detiene: sin scope no hay tipo.

Fuentes