# Índice de Especificaciones

Esta carpeta contiene especificaciones de producto e interfaz para funcionalidades de la documentación de SISASS.

## Cómo usar esta carpeta

- Lee el archivo de spec que corresponda a la funcionalidad que vas a cambiar.
- Usa la spec como fuente de verdad para alcance, comportamiento y criterios de aceptación.
- Añade un nuevo archivo de spec aquí cuando una funcionalidad necesite su propia definición.
- Mantén cada spec enfocada en una sola funcionalidad o en un conjunto muy relacionado.

## Especificaciones existentes

| Archivo | Propósito |
| --- | --- |
| [theme_toggle_button.md](./theme_toggle_button.md) | Define el botón para cambiar la documentación entre modo claro y modo oscuro. |
| [rgb_alpha.md](./rgb_alpha.md) | Define la documentación de la función `rgb-alpha` en la sección base. |
| [pb.md](./pb.md) | Define la función `pb`, su cálculo inverso respecto a `bp` y su documentación en la sección base. |
| [installer_structure.md](./installer_structure.md) | Define la reorganización lógica de `files/` y la creación de la estructura de instalación por parte de `install.js`. |
| [sisass_installation_article.md](./sisass_installation_article.md) | Define el artículo para instalar SISASS en proyectos HTML, SQHTML, SQHTML2, React y React con Vite. |
| [mediaqueries_modernization.md](./mediaqueries_modernization.md) | Define la modernización de los mixins de media queries, sus APIs secuenciales y map, las nuevas condiciones y su documentación. |
| [mediaqueries_classification.md](./mediaqueries_classification.md) | Define la tabla y los títulos que clasifican los mixins públicos de media queries dentro de la documentación. |
| [container_query.md](./container_query.md) | Define el mixin `container-query`, sus interfaces posicional y map, las consultas admitidas y su documentación. |
| [page_menu.md](./page_menu.md) | Define el menú de navegación de la página actual generado desde encabezados seleccionados explícitamente. |
| [search_dropdown.md](./search_dropdown.md) | Define el desplegable de búsqueda global con resultados enriquecidos, navegación por teclado y listado completo con espacio de scroll reservado. |
| [new_article_versions.md](./new_article_versions.md) | Define el historial de versiones del artículo de novedades en una única página. |
| [nested_maps.md](./nested_maps.md) | Define el artículo conceptual sobre mapas anidados, sus patrones de uso y las APIs públicas de SISASS que los admiten. |
| [buttons.md](./buttons.md) | Define la página de referencia de `src/sisass_components/_buttons.scss`, sus tres mixins y sus ejemplos visuales. |
| [interactive_component_builder.md](./interactive_component_builder.md) | Define el constructor interactivo de `button_simple` dentro de la documentación de botones. |
| [schema_driven_interactive_builders.md](./schema_driven_interactive_builders.md) | Define la arquitectura de constructores de mixins basada en esquemas JSON, un núcleo común y adapters opcionales. |

## Convenciones

- Escribe las specs en español, salvo que se requiera explícitamente otro idioma.
- Usa enunciados funcionales claros, no notas de implementación, salvo que la implementación afecte el comportamiento del usuario.
- Mantén separadas las asunciones de los requisitos confirmados.
- Referencia archivos existentes solo cuando sean relevantes para la funcionalidad que se está especificando.

## Mantenimiento

- Actualiza la spec correspondiente antes de cambiar el comportamiento de la funcionalidad.
- Si una funcionalidad crece más allá de una sola spec, sepárala en archivos más pequeños y actualiza este índice.