prototipo-cls-ui 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 T-Cloud
+
+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

@@ -0,0 +1,199 @@
+# prototipo-cls-ui
+
+Prototipo de framework CSS para o projeto TCloud da TOTVS, com proposta semelhante a frameworks como Bootstrap, porem focado nas necessidades de design system, padronizacao visual e escalabilidade do ecossistema TCloud.
+
+Repositorio oficial: https://github.com/tcloud-dev/prototipo-cls-ui.git
+
+## Contexto do Projeto
+
+Este projeto esta no inicio e, neste momento, ainda nao possui implementacao da nova framework CSS.
+
+Atualmente, o repositorio contem apenas o diretorio de referencia `reference/tcloud-ui`, que representa a base anterior a ser estudada e evoluida.
+
+## Finalidade
+
+A finalidade deste repositorio e construir uma grande evolucao da solucao anterior, criando uma nova fundacao para estilos, utilitarios e componentes CSS do TCloud.
+
+Objetivos desta fase inicial:
+
+- Definir a base arquitetural da nova framework CSS.
+- Identificar pontos de melhoria da referencia atual.
+- Estabelecer padroes de nomenclatura, organizacao e manutencao.
+- Evoluir consistencia visual, produtividade e escalabilidade.
+
+## Estrutura Atual
+
+- `reference/tcloud-ui`: referencia do projeto anterior.
+- `README.md`: documentacao inicial do prototipo.
+
+## Como Clonar
+
+Clone do projeto com submodulos:
+
+```bash
+git clone --recurse-submodules https://github.com/tcloud-dev/prototipo-cls-ui.git
+cd prototipo-cls-ui
+```
+
+Se ja clonou sem submodulos:
+
+```bash
+git submodule update --init --recursive
+```
+
+## Como Usar
+
+### Instalação Inicial
+
+Após clonar o projeto, instale as dependências:
+
+```bash
+npm install
+```
+
+### Desenvolvimento
+
+Execute o build em modo watch para desenvolvimento:
+
+```bash
+npm run dev
+```
+
+Este comando irá monitorar alterações no diretório `src/` e recompilar automaticamente.
+
+### Build para Produção
+
+Para gerar o build final no diretório `dist/`:
+
+```bash
+npm run build
+```
+
+O build gera:
+- **ESM** (ES Modules): `dist/index.mjs`
+- **CJS** (CommonJS): `dist/index.js`
+- **Types**: `dist/index.d.ts`
+- **Source Maps**: arquivos `.map`
+
+### Scripts Disponíveis
+
+- `npm run dev` - Build em modo watch para desenvolvimento
+- `npm run build` - Build de produção (ESM + CJS + tipos)
+- `npm run clean` - Limpa o diretório dist/
+- `npm test` - Executa testes
+- `npm run lint` - Executa linting do código
+- `npm run format` - Formata código com Prettier
+- `npm run docs` - Gera documentação em /docs
+- `npm run docs:serve` - Gera e serve documentação localmente
+
+### Gerar Documentação
+
+Para gerar a documentação técnica do projeto:
+
+```bash
+npm run docs
+```
+
+Para visualizar a documentação localmente:
+
+```bash
+npm run docs:serve
+```
+
+A documentação será gerada no diretório `/docs` e pode ser publicada automaticamente no GitHub Pages.
+
+### Publicar no NPM
+
+#### Via GitHub Actions (Recomendado)
+
+1. Acesse o repositório no GitHub
+2. Vá em **Actions** > **NPM Publish**
+3. Clique em **Run workflow**
+4. Selecione a tag desejada (latest, beta ou alpha)
+5. Confirme a execução
+
+#### Via Linha de Comando (Manual)
+
+```bash
+npm publish --tag latest --access public
+```
+
+## Sobre a Documentação
+
+Este projeto utiliza **TypeDoc** para gerar documentação técnica automaticamente a partir dos comentários no código.
+
+### Por que TypeDoc?
+
+- ✅ **Nativo para TypeScript** - Suporte completo a tipos e interfaces
+- ✅ **Geração Automática** - Cria documentação a partir dos comentários JSDoc
+- ✅ **Site Estático** - Gera páginas HTML navegáveis e pesquisáveis
+- ✅ **GitHub Pages** - Integração fácil para publicação online
+- ✅ **Temas Personalizáveis** - Suporta customização visual
+- ✅ **Exportação de Tipos** - Documenta toda a API pública
+
+### Como Documentar o Código
+
+Use comentários JSDoc no código TypeScript:
+
+```typescript
+/**
+ * Componente de botão do Claus UI
+ * @public
+ */
+export interface ButtonProps {
+  /** Texto do botão */
+  label: string;
+  /** Variante visual */
+  variant?: 'primary' | 'secondary' | 'tertiary';
+  /** Estado desabilitado */
+  disabled?: boolean;
+}
+
+/**
+ * Classe do componente Button
+ * @example
+ * ```typescript
+ * const button = new Button({ 
+ *   label: 'Clique aqui', 
+ *   variant: 'primary' 
+ * });
+ * ```
+ */
+export class Button {
+  constructor(private props: ButtonProps) {}
+  
+  render(): HTMLButtonElement {
+    // implementação
+  }
+}
+```
+
+### Visualizar Documentação
+
+A documentação é publicada automaticamente no GitHub Pages a cada push na branch principal.
+
+Acesse em: `https://tcloud-dev.github.io/prototipo-cls-ui/`
+
+## Diretorio de Referencia
+
+O diretorio `reference/tcloud-ui` deve ser utilizado como referencia tecnica para comparacao e apoio durante a evolucao do novo prototipo.
+
+Para atualizar o conteudo da referencia quando necessario:
+
+```bash
+git submodule update --remote --merge
+```
+
+## Status Atual
+
+Projeto em fase de bootstrap inicial.
+
+- Sem implementacao funcional da nova framework CSS ate o momento.
+- Estrutura inicial preparada para evolucao incremental.
+
+## Proximos Passos Sugeridos
+
+- Definir design tokens (cores, tipografia, espacamento, sombras).
+- Definir convencoes de classes e arquitetura CSS.
+- Criar os primeiros modulos base (layout, grid, tipografia, botoes, formularios e utilitarios).
+- Estruturar documentacao tecnica e exemplos de uso.

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var r=class{constructor(t){this.props=t;}render(){let t=document.createElement("button");return t.textContent=this.props.label,t.className=`cls-button cls-button--${this.props.variant||"primary"}`,t.disabled=this.props.disabled||false,this.props.onClick&&t.addEventListener("click",this.props.onClick),t}};var i="0.0.1";exports.Button=r;exports.VERSION=i;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Button/Button.ts","../src/index.ts"],"names":["Button","props","button","VERSION"],"mappings":"aAsBO,IAAMA,CAAAA,CAAN,KAAa,CAClB,WAAA,CAAoBC,EAAoB,CAApB,IAAA,CAAA,KAAA,CAAAA,EAAqB,CAEzC,MAAA,EAA4B,CAC1B,IAAMC,CAAAA,CAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA,CAC9C,OAAAA,EAAO,WAAA,CAAc,IAAA,CAAK,KAAA,CAAM,KAAA,CAChCA,CAAAA,CAAO,SAAA,CAAY,0BAA0B,IAAA,CAAK,KAAA,CAAM,OAAA,EAAW,SAAS,CAAA,CAAA,CAC5EA,CAAAA,CAAO,SAAW,IAAA,CAAK,KAAA,CAAM,QAAA,EAAY,KAAA,CAErC,IAAA,CAAK,KAAA,CAAM,SACbA,CAAAA,CAAO,gBAAA,CAAiB,OAAA,CAAS,IAAA,CAAK,KAAA,CAAM,OAAO,EAG9CA,CACT,CACF,EC5BO,IAAMC,CAAAA,CAAU","file":"index.cjs","sourcesContent":["/**\n * Componente de botão do Claus UI\n * @public\n */\nexport interface ButtonProps {\n  /** Texto do botão */\n  label: string;\n  /** Variante visual */\n  variant?: 'primary' | 'secondary' | 'tertiary';\n  /** Estado desabilitado */\n  disabled?: boolean;\n  /** Callback de click */\n  onClick?: () => void;\n}\n\n/**\n * Classe do componente Button\n * @example\n * ```typescript\n * const button = new Button({ label: 'Clique aqui', variant: 'primary' });\n * ```\n */\nexport class Button {\n  constructor(private props: ButtonProps) {}\n\n  render(): HTMLButtonElement {\n    const button = document.createElement('button');\n    button.textContent = this.props.label;\n    button.className = `cls-button cls-button--${this.props.variant || 'primary'}`;\n    button.disabled = this.props.disabled || false;\n    \n    if (this.props.onClick) {\n      button.addEventListener('click', this.props.onClick);\n    }\n\n    return button;\n  }\n}","/**\n * Claus UI - Design System para T-Cloud\n * @packageDocumentation\n */\n\n// Exemplo de componente inicial\nexport * from './components';\n\n// Versão do pacote\nexport const VERSION = '0.0.1';"]}

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Componente de botão do Claus UI
+ * @public
+ */
+interface ButtonProps {
+    /** Texto do botão */
+    label: string;
+    /** Variante visual */
+    variant?: 'primary' | 'secondary' | 'tertiary';
+    /** Estado desabilitado */
+    disabled?: boolean;
+    /** Callback de click */
+    onClick?: () => void;
+}
+/**
+ * Classe do componente Button
+ * @example
+ * ```typescript
+ * const button = new Button({ label: 'Clique aqui', variant: 'primary' });
+ * ```
+ */
+declare class Button {
+    private props;
+    constructor(props: ButtonProps);
+    render(): HTMLButtonElement;
+}
+
+/**
+ * Claus UI - Design System para T-Cloud
+ * @packageDocumentation
+ */
+
+declare const VERSION = "0.0.1";
+
+export { Button, type ButtonProps, VERSION };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Componente de botão do Claus UI
+ * @public
+ */
+interface ButtonProps {
+    /** Texto do botão */
+    label: string;
+    /** Variante visual */
+    variant?: 'primary' | 'secondary' | 'tertiary';
+    /** Estado desabilitado */
+    disabled?: boolean;
+    /** Callback de click */
+    onClick?: () => void;
+}
+/**
+ * Classe do componente Button
+ * @example
+ * ```typescript
+ * const button = new Button({ label: 'Clique aqui', variant: 'primary' });
+ * ```
+ */
+declare class Button {
+    private props;
+    constructor(props: ButtonProps);
+    render(): HTMLButtonElement;
+}
+
+/**
+ * Claus UI - Design System para T-Cloud
+ * @packageDocumentation
+ */
+
+declare const VERSION = "0.0.1";
+
+export { Button, type ButtonProps, VERSION };

package/dist/index.js

@@ -0,0 +1,2 @@
+var r=class{constructor(t){this.props=t;}render(){let t=document.createElement("button");return t.textContent=this.props.label,t.className=`cls-button cls-button--${this.props.variant||"primary"}`,t.disabled=this.props.disabled||false,this.props.onClick&&t.addEventListener("click",this.props.onClick),t}};var i="0.0.1";export{r as Button,i as VERSION};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/Button/Button.ts","../src/index.ts"],"names":["Button","props","button","VERSION"],"mappings":"AAsBO,IAAMA,CAAAA,CAAN,KAAa,CAClB,WAAA,CAAoBC,EAAoB,CAApB,IAAA,CAAA,KAAA,CAAAA,EAAqB,CAEzC,MAAA,EAA4B,CAC1B,IAAMC,CAAAA,CAAS,QAAA,CAAS,aAAA,CAAc,QAAQ,CAAA,CAC9C,OAAAA,EAAO,WAAA,CAAc,IAAA,CAAK,KAAA,CAAM,KAAA,CAChCA,CAAAA,CAAO,SAAA,CAAY,0BAA0B,IAAA,CAAK,KAAA,CAAM,OAAA,EAAW,SAAS,CAAA,CAAA,CAC5EA,CAAAA,CAAO,SAAW,IAAA,CAAK,KAAA,CAAM,QAAA,EAAY,KAAA,CAErC,IAAA,CAAK,KAAA,CAAM,SACbA,CAAAA,CAAO,gBAAA,CAAiB,OAAA,CAAS,IAAA,CAAK,KAAA,CAAM,OAAO,EAG9CA,CACT,CACF,EC5BO,IAAMC,CAAAA,CAAU","file":"index.js","sourcesContent":["/**\n * Componente de botão do Claus UI\n * @public\n */\nexport interface ButtonProps {\n  /** Texto do botão */\n  label: string;\n  /** Variante visual */\n  variant?: 'primary' | 'secondary' | 'tertiary';\n  /** Estado desabilitado */\n  disabled?: boolean;\n  /** Callback de click */\n  onClick?: () => void;\n}\n\n/**\n * Classe do componente Button\n * @example\n * ```typescript\n * const button = new Button({ label: 'Clique aqui', variant: 'primary' });\n * ```\n */\nexport class Button {\n  constructor(private props: ButtonProps) {}\n\n  render(): HTMLButtonElement {\n    const button = document.createElement('button');\n    button.textContent = this.props.label;\n    button.className = `cls-button cls-button--${this.props.variant || 'primary'}`;\n    button.disabled = this.props.disabled || false;\n    \n    if (this.props.onClick) {\n      button.addEventListener('click', this.props.onClick);\n    }\n\n    return button;\n  }\n}","/**\n * Claus UI - Design System para T-Cloud\n * @packageDocumentation\n */\n\n// Exemplo de componente inicial\nexport * from './components';\n\n// Versão do pacote\nexport const VERSION = '0.0.1';"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "prototipo-cls-ui",
+  "version": "0.0.1",
+  "description": "Prototipo do Claus UI, um Design System para o projeto T-Cloud da TOTVS.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./styles": "./dist/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "docs": "typedoc",
+    "docs:serve": "npm run docs && npx serve docs",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tcloud-dev/prototipo-cls-ui.git"
+  },
+  "keywords": [
+    "Claus",
+    "UI",
+    "Totvs",
+    "Design System",
+    "TCloud",
+    "Web Components",
+    "TypeScript"
+  ],
+  "author": "Christian Martins",
+  "license": "ISC",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5",
+    "tsup": "^8.0.2",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "bugs": {
+    "url": "https://github.com/tcloud-dev/prototipo-cls-ui/issues"
+  },
+  "homepage": "https://github.com/tcloud-dev/prototipo-cls-ui#readme"
+}