@orangesys/ui 0.0.0-stage → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 llypeDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @orangesys/ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Componentes React acessíveis do **Orange**, um design system open source: geométrico, de cantos retos,
+com um único acento laranja e WCAG 2.2 AA desde o primeiro componente.
+
+- 103 componentes (formulários, sobreposições, navegação, exibição de dados, layout, gráficos)
+- Temas escuro, claro e de alto contraste (`dark-hc`, `light-hc`), com suporte a `forced-colors`
+- Textos internos em português e inglês, motion que respeita `prefers-reduced-motion`
+- CSS puro com tokens — sem CSS-in-JS
+
+**Documentação:** https://orange.llypedev.com.br · **Storybook:** https://orange.llypedev.com.br/storybook/
+
+## Instalação
+
+```bash
+pnpm add @orangesys/ui
+```
+
+Requer `react` e `react-dom` 18.2 ou 19.
+
+## Uso
+
+```tsx
+import '@orangesys/ui/styles.css'
+import { Button, OrangeProvider } from '@orangesys/ui'
+
+export function App() {
+  return (
+    <OrangeProvider defaultTheme="system" locale="pt-BR">
+      <Button variant="primary">Salvar</Button>
+    </OrangeProvider>
+  )
+}
+```
+
+O `OrangeProvider` aplica o tema (`dark`, `light`, `dark-hc`, `light-hc` ou `system`) e o idioma das
+mensagens internas. O guia completo está em
+[Começando](https://orange.llypedev.com.br/pt/getting-started).
+
+## Versionamento
+
+Segue SemVer, com a política de depreciação descrita em
+[Versionamento e depreciação](https://orange.llypedev.com.br/pt/usage/versioning). As mudanças de cada
+versão estão no `CHANGELOG.md`.
+
+## Licença
+
+MIT