# Cobalt Design System

> Prolibu Cobalt Web Components (co-*) and design tokens (--co-*).

Notas para interpretar esta documentación:

- Los componentes son Web Components con prefijo `co-` (Stencil, shadow DOM). Hay wrappers oficiales para Vue 3 (`@prolibu-suite/cobalt-vue`) y React (`@prolibu-suite/cobalt-react`); en Vue se usan los wrappers (`CoButton`…), no los tags crudos.
- El theming se hace exclusivamente con design tokens CSS `--co-*` (`@prolibu-suite/cobalt-tokens`): nunca colores ni tipografías hardcodeadas. Preferir tokens semánticos (`--co-semantic-*`) que adaptan a dark mode.
- Iconos: Phosphor Icons en kebab-case vía `<co-icon name="magnifying-glass">`.
- Runtime vanilla sin bundler: `https://dev10.prolibu.com/ui/static/cobalt/cobalt/cobalt.esm.js` + tokens en `https://dev10.prolibu.com/ui/static/cobalt/tokens/tokens.css`.
- La documentación fuente es en español, con espejo en inglés bajo `/en/`.

## Documentation Sets

- [Abridged documentation](https://dev10.prolibu.com/ui/static/cobalt-docs/llms-small.txt): a compact version of the documentation for Cobalt Design System, with non-essential content removed
- [Complete documentation](https://dev10.prolibu.com/ui/static/cobalt-docs/llms-full.txt): the full documentation for Cobalt Design System
- [Componentes](https://dev10.prolibu.com/ui/static/cobalt-docs/_llms-txt/componentes.txt): referencia de cada Web Component co-*: props, eventos, slots, CSS parts y ejemplos
- [Formularios](https://dev10.prolibu.com/ui/static/cobalt-docs/_llms-txt/formularios.txt): sistema de formularios schema-driven: <co-form>, useForm, validación AJV, ref fields y theming
- [Guias y theming](https://dev10.prolibu.com/ui/static/cobalt-docs/_llms-txt/guias-y-theming.txt): instalación (npm y CDN), design tokens, colores, tipografía, espaciado y dark mode

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [Demos vanilla (CDN)](https://dev10.prolibu.com/ui/static/cobalt-form-demo/index.html): 5 ejemplos HTML consumiendo Cobalt desde CDN, de stock a totalmente custom
- [Runtime CDN (cobalt.esm.js)](https://dev10.prolibu.com/ui/static/cobalt/cobalt/cobalt.esm.js): Web Components co-* listos para <script type="module"> sin build
- [Paquetes npm](https://www.npmjs.com/package/@prolibu-suite/cobalt-core): Releases versionados (@prolibu-suite/cobalt-*)