Token Families
Cada token de este sistema pertenece exactamente a una familia — una
agrupación pilar / capa / familia, por ejemplo
paper / semantic / financial-report-layout. Esta página nombra la taxonomía para
que un archivo productor pueda encontrar la familia correcta antes de adivinar un nombre de
token, en lugar de redactar un casi-duplicado porque el token real no fue fácil de encontrar.
La forma: pilar / capa / familia
El id canónico de un token es su pilar y su ruta DTCG
completa, unidos textualmente — sin capa de traducción entre el id, la propiedad
personalizada CSS, y lo que get_token compara (ver
MCP y API de máquina). Una familia es la
agrupación un nivel arriba: todo token que comparte el mismo pilar, capa, y nombre de
nivel superior.
Pilar
El nivel superior: primitive, theme, paper,
writing.
Capa
Solo paper y writing realmente anidan bajo un envoltorio
primitive/semantic antes de que comiencen sus grupos reales — así
que solo esos dos pilares llevan una capa. La capa de cualquier otro pilar es
null; su primer segmento de ruta es la familia directamente.
Familia
El grupo nombrado en sí — una familia de documento como
financial-report-layout, un grupo de oficio como rhythm, o una
categoría primitiva como color. Todo token hoja de una familia comparte el
mismo prefijo de id.
Ejemplo trabajado: el token
--ps-paper-semantic-financial-report-layout-header-rule tiene pilar
paper, capa semantic, familia
financial-report-layout — legible directamente desde la cadena del id, ya que
el id es la ruta pilar/capa/familia sin re-formateo ni re-delimitación.
Los cuatro pilares
Cada fila es un pilar real en la exportación actual, no una lista aspiracional — los conteos son en vivo, misma fuente que el panel de estadísticas arriba.
| Pilar | Capa | Qué contiene | Familias de ejemplo |
|---|---|---|---|
primitive | — | Valores crudos, neutrales al arrendatario: color, espaciado, tipografía, movimiento, bordes, viewport, foco, duración. | color (60), typography (14), size (13) |
theme | — | El tema propio de referencia/predeterminado de PointSav — mapeos de rol semántico sobre primitivos, más una variante de modo oscuro. El tema de referencia del proveedor, no una bifurcación de arrendatario (ver la nota de pilar abajo). | semantic (53), dark (28), accessibility (5) |
paper | primitive / semantic | Sustrato de formato de impresión/documento — geometría de página, grosores de regla, escalas tipográficas, y una familia semántica por registro de documento (acuerdos legales, informes financieros, navegación de encuadernador PDF, fideicomiso/prospecto FIBRA de México, diagramas de organigrama para impresión, …). | mx-fibra-prospectus (49), legal-subscription-agreement (30), financial-report-layout (25) |
writing | primitive / semantic | Tokens de gobernanza de prosa — voz, ritmo, uso de mayúsculas, escala de registro, plantillas de descargo de responsabilidad, y patrones de contenido nombrados para una familia de documento específica. | register (7), rhythm (7), pattern (4) |
theme contiene solo el tema de referencia propio de PointSav —
no es un objetivo de bifurcación multi-arrendatario. Los valores de token específicos de
marca de un arrendatario adoptante (por ejemplo, la paleta de Woodfine) viven en el propio
repositorio de activos de medios de ese arrendatario, superpuestos mediante anulación de
propiedad personalizada CSS, no dentro de este pilar. Ver
.agent/rules/design-tokens.md en el archivo project-design para la
justificación completa.
paper.primitive.color.org-chart-role-warm-gray-* /
paper.semantic.org-chart.role-warm-gray-*, junto al resto de los tokens
de la familia de documentos de organigrama. Los nombres de los pilares retirados
incorporaban directamente la marca de un producto de terceros en los nombres de
propiedades personalizadas CSS distribuidas, algo que este registro ya no hace en
ningún lugar.
Encontrar la familia correcta antes de redactar una nueva
El modo de falla que esta taxonomía existe para prevenir: un archivo productor no puede encontrar una familia existente, asume que no existe, y redacta un casi-duplicado bajo un nombre nuevo. Dos verificaciones, en orden:
1. ¿Es una variación de familia de documento?
Un nuevo documento de cumplimiento, registro de impresión, o instrumento legal casi
siempre compone paper.primitive.* existente y añade un nuevo grupo
paper.semantic.<familia>.* — rara vez necesita primitivos nuevos.
Revise la tabla de familias Paper arriba y en Tokens — nivel
Paper antes de asumir que ninguna de las diez familias de documento existentes está
lo suficientemente cerca para extenderla.
2. ¿Es un valor genuinamente nuevo, o una bifurcación de marca de un arrendatario?
Un valor literal de color/tamaño/tipo reutilizable en cualquier marca adoptante
pertenece a primitive o a una familia Paper/Writing. Un valor que codifica la
identidad de marca de un arrendatario específico no pertenece a este repositorio en
absoluto — ver la nota de pilar arriba.
list_token_families(pillar?)
La forma legible por máquina de esta página. Devuelve cada
familia — las mismas filas que la tabla arriba — como JSON, opcionalmente filtrado a un
pilar, obtenido del mismo registro generado token-families.json que leen
tanto get_token como esta página. Ver
MCP y API de máquina para la lista completa de
herramientas y la forma de llamada.
[
{ "pillar": "paper", "layer": "semantic", "family": "financial-report-layout", "member_count": 25 }
// … 44 más
]Información Importante
Divulgación del sistema de diseño
Este sitio proporciona tokens de diseño de código abierto, documentación y software autoalojable publicado por Woodfine Capital Projects Inc. La información aquí es solo para referencia general y no constituye una oferta, garantía ni garantía de idoneidad para ningún propósito particular. Las declaraciones sobre características futuras planeadas, previstas o proyectadas son prospectivas y están sujetas a cambios sin previo aviso; no se asume la obligación de actualizarlas excepto cuando lo exija la ley.