Compare commits
No commits in common. "master" and "master-dayjs" have entirely different histories.
master
...
master-day
32 changed files with 1084 additions and 1849 deletions
23
.vscode/settings.json
vendored
23
.vscode/settings.json
vendored
|
|
@ -4,10 +4,8 @@
|
|||
"source.fixAll.biome": "always"
|
||||
},
|
||||
"editor.defaultFormatter": "biomejs.biome",
|
||||
"editor.formatOnSave": true,
|
||||
|
||||
"[javascript]": {
|
||||
"editor.defaultFormatter": "biomejs.biome"
|
||||
"editor.defaultFormatter": "vscode.typescript-language-features"
|
||||
},
|
||||
"[javascriptreact]": {
|
||||
"editor.defaultFormatter": "biomejs.biome"
|
||||
|
|
@ -25,21 +23,6 @@
|
|||
"editor.defaultFormatter": "biomejs.biome"
|
||||
},
|
||||
"[vue]": {
|
||||
"editor.defaultFormatter": "biomejs.biome"
|
||||
},
|
||||
"[css]": {
|
||||
"editor.defaultFormatter": "biomejs.biome"
|
||||
},
|
||||
"[html]": {
|
||||
"editor.defaultFormatter": "biomejs.biome"
|
||||
},
|
||||
|
||||
"typescript.preferences.importModuleSpecifier": "relative",
|
||||
"typescript.suggest.autoImports": true,
|
||||
"typescript.updateImportsOnFileMove.enabled": "always",
|
||||
|
||||
"editor.rulers": [100],
|
||||
"files.eol": "\n",
|
||||
"files.trimTrailingWhitespace": true,
|
||||
"files.insertFinalNewline": true
|
||||
"editor.defaultFormatter": "esbenp.prettier-vscode"
|
||||
}
|
||||
}
|
||||
234
AGENTS.md
234
AGENTS.md
|
|
@ -1,234 +0,0 @@
|
|||
# AGENTS.md — Guia para Assistentes de IA
|
||||
|
||||
> **Este arquivo descreve os padrões, convenções e arquitetura do projeto `p-comuns`.**
|
||||
> Leia este arquivo antes de sugerir ou gerar qualquer código.
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ Visão Geral do Projeto
|
||||
|
||||
`p-comuns` é um **pacote compartilhado** (npm monorepo-like) usado como dependência em todos os subprojetos da plataforma **e-licencie**. Ele provê:
|
||||
|
||||
- Tipos TypeScript compartilhados (rotas, filtros, situações, UUIDs...)
|
||||
- Utilitários de back-end (postgres, cache em memória, dayjs...)
|
||||
- Utilitários de front-end (Vue 3 + TSX)
|
||||
- Constantes e enums globais
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Stack Tecnológica
|
||||
|
||||
| Camada | Tecnologia | Versão |
|
||||
|--------|-----------|--------|
|
||||
| Linguagem | TypeScript | ~5.9.x |
|
||||
| Runtime (back) | Node.js | ≥20 |
|
||||
| Framework (front) | Vue 3 | Composition API + `<script setup>` |
|
||||
| JSX/TSX | Vue TSX / React-like TSX | via `jsxRuntime` |
|
||||
| Linter/Formatter | Biome | 2.4.x |
|
||||
| Bundler | tsup | 8.x |
|
||||
| Package manager | pnpm | com workspaces |
|
||||
| Validação | Zod | 4.x |
|
||||
| Utilitários de data | dayjs | 1.11.x |
|
||||
|
||||
---
|
||||
|
||||
## 📁 Estrutura do `src/`
|
||||
|
||||
```
|
||||
src/
|
||||
├── index.ts # Entry point — exporta tudo que é público
|
||||
├── constantes.ts # Constantes globais (enums, valores fixos)
|
||||
├── situacoes.ts # Status/situações dos processos
|
||||
├── tipagemRotas.ts # Tipagem forte de rotas da API
|
||||
├── tipoFiltro.26.ts # Sistema de filtros tipados (operadores PG)
|
||||
├── uuid.ts # Geração e validação de UUIDs
|
||||
├── dayjs26.ts # Wrapper do dayjs com locale e plugins
|
||||
├── extensoes.ts # Extensões de tipos nativos
|
||||
├── texto_busca.ts # Utilitários de busca em texto
|
||||
├── variaveisComuns.ts # Variáveis de ambiente compartilhadas
|
||||
├── postgres.ts # Cliente PostgreSQL base
|
||||
├── cacheMemoria.ts # Cache em memória (Map com TTL)
|
||||
├── aleatorio.ts # Utilitários de aleatoriedade
|
||||
├── consulta.ts # Helpers de consulta SQL
|
||||
├── instalarAmbiente.ts # Setup de ambiente (dev/prod)
|
||||
├── graficosPilao.ts # Tipos para gráficos do PILÃO
|
||||
├── ecosistema/ # Tipos do ecossistema de módulos
|
||||
└── testes/ # Testes unitários (Vitest)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📐 Convenções de Código
|
||||
|
||||
### TypeScript
|
||||
|
||||
- **Strict mode** SEMPRE ligado (`"strict": true`)
|
||||
- **Sem `any` explícito** — use tipos genéricos ou `unknown`
|
||||
- **Sem `!` (non-null assertion)** — trate o `null`/`undefined` explicitamente
|
||||
- **Arrays**: usar `T[]` em vez de `Array<T>` (shorthand)
|
||||
- **Imports** ordenados automaticamente pelo Biome
|
||||
- **Enums** sempre com inicializadores explícitos
|
||||
- **Parâmetros** não podem ser reatribuídos
|
||||
|
||||
### Nomenclatura
|
||||
|
||||
```typescript
|
||||
// Tipos e interfaces: PascalCase
|
||||
type TipoUsuario = { ... }
|
||||
interface IRepositorio { ... }
|
||||
|
||||
// Constantes: camelCase (sem SCREAMING_SNAKE_CASE, exceto enums legados)
|
||||
const configuracaoBase = { ... }
|
||||
|
||||
// Funções: camelCase, verbos
|
||||
const calcularTotal = (itens: Item[]) => { ... }
|
||||
const buscarUsuarioPorId = async (id: UUID) => { ... }
|
||||
|
||||
// Arquivos: camelCase para utilitários, PascalCase para componentes Vue
|
||||
// ✅ tipoFiltro.ts, variaveisComuns.ts
|
||||
// ✅ MeuComponente.vue, BotaoAcao.vue
|
||||
```
|
||||
|
||||
### Vue 3 (Composition API)
|
||||
|
||||
```vue
|
||||
<script setup lang="ts">
|
||||
// Sempre usar <script setup lang="ts">
|
||||
// Macros globais disponíveis (sem import): defineProps, defineEmits,
|
||||
// defineExpose, withDefaults, defineModel, defineOptions, defineSlots
|
||||
|
||||
const props = defineProps<{
|
||||
titulo: string
|
||||
itens: Item[]
|
||||
}>()
|
||||
|
||||
const emit = defineEmits<{
|
||||
selecionar: [item: Item]
|
||||
fechar: []
|
||||
}>()
|
||||
</script>
|
||||
```
|
||||
|
||||
- **Sem Vue Options API** — sempre Composition API
|
||||
- **Props não devem ser desestruturadas** (quebra reatividade Vue 3)
|
||||
- **`v-for` sempre com `:key`** — use o ID do item, nunca o índice!
|
||||
- **`v-if` e `v-for` nunca no mesmo elemento** — use `<template v-for>`
|
||||
- **Atributos em multiline** quando há mais de 2 props
|
||||
|
||||
### TSX (componentes em `.tsx`)
|
||||
|
||||
```tsx
|
||||
// Componente funcional Vue em TSX
|
||||
import { defineComponent, ref } from "vue"
|
||||
|
||||
export const MeuComponente = defineComponent({
|
||||
props: {
|
||||
titulo: { type: String, required: true },
|
||||
},
|
||||
setup(props) {
|
||||
const contador = ref(0)
|
||||
return () => (
|
||||
<div class="meu-componente">
|
||||
<h1>{props.titulo}</h1>
|
||||
<button onClick={() => contador.value++}>{contador.value}</button>
|
||||
</div>
|
||||
)
|
||||
},
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Biome — Regras de Lint Importantes
|
||||
|
||||
### Erros (bloqueiam o build)
|
||||
|
||||
| Regra | Descrição |
|
||||
|-------|-----------|
|
||||
| `noUnusedVariables` | Variáveis definidas e não usadas |
|
||||
| `noUnusedImports` | Imports não utilizados |
|
||||
| `noVoidTypeReturn` | Função `void` retornando valor |
|
||||
| `noVueDataObjectDeclaration` | Vue 2 `data: {}` — usar função |
|
||||
| `noVueDuplicateKeys` | Chaves duplicadas em objetos Vue |
|
||||
| `noVueSetupPropsReactivityLoss` | Desestruturar `props` em `setup()` |
|
||||
| `noVueVIfWithVFor` | `v-if` + `v-for` no mesmo elemento |
|
||||
| `useVueVForKey` | `v-for` sem `:key` |
|
||||
| `useVueValidTemplateRoot` | Template sem raiz única (Vue 2) |
|
||||
|
||||
### Warnings (code smells — corrija quando possível)
|
||||
|
||||
| Regra | Descrição |
|
||||
|-------|-----------|
|
||||
| `useArrowFunction` | **Sempre use arrow function** — `function` é erro |
|
||||
| `noNonNullAssertion` | Evite `!` — trate o null |
|
||||
| `noDelete` | `delete obj.prop` é lento |
|
||||
| `noEmptyBlockStatements` | Blocos `{}` vazios |
|
||||
| `noArrayIndexKey` | `:key` com índice do array |
|
||||
| `noDangerouslySetInnerHtml` | `innerHTML` perigoso |
|
||||
| `noExcessiveCognitiveComplexity` | Função muito complexa (max: 20) |
|
||||
|
||||
---
|
||||
|
||||
## 📦 Como Outros Projetos Consomem Este Pacote
|
||||
|
||||
```json
|
||||
// biome.json do subprojeto (ex: PILAO-FRONT)
|
||||
{
|
||||
"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
|
||||
"extends": ["./node_modules/p-comuns/Documentos/biome.json"],
|
||||
"files": {
|
||||
"includes": ["src/**/*.{js,ts,jsx,tsx,vue}"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```json
|
||||
// .vscode/settings.json do subprojeto
|
||||
{
|
||||
"editor.defaultFormatter": "biomejs.biome",
|
||||
"editor.formatOnSave": true,
|
||||
"editor.codeActionsOnSave": {
|
||||
"source.organizeImports.biome": "always",
|
||||
"source.fixAll.biome": "always"
|
||||
},
|
||||
"[vue]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[typescript]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[typescriptreact]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"editor.rulers": [100],
|
||||
"files.eol": "\n"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Scripts
|
||||
|
||||
```bash
|
||||
pnpm biome # Formata + lint com auto-fix
|
||||
pnpm check # biome + tsc --noEmit (sem emitir arquivos)
|
||||
pnpm build # Bump de versão + biome + tsup + pack
|
||||
pnpm teste # Vitest (testes unitários)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ O que NÃO fazer
|
||||
|
||||
- ❌ Não use `eslint` — o projeto usa Biome
|
||||
- ❌ Não use `prettier` — o projeto usa Biome
|
||||
- ❌ Não use `function` nomeada — sempre arrow function (`const fn = () => {}`)
|
||||
- ❌ Não use Vue Options API — sempre Composition API
|
||||
- ❌ Não desestrure `props` diretamente (quebra reatividade)
|
||||
- ❌ Não use `any` — use `unknown` + type narrowing
|
||||
- ❌ Não use índice como `:key` no `v-for`
|
||||
- ❌ Não quebre linhas com mais de 100 caracteres
|
||||
- ❌ Não use ponto-e-vírgula no final (Biome removerá)
|
||||
|
||||
---
|
||||
|
||||
## 📚 Referências
|
||||
|
||||
- [Biome 2.x Docs](https://biomejs.dev)
|
||||
- [Vue 3 Composition API](https://vuejs.org/guide/composition-api)
|
||||
- [Zod v4](https://zod.dev)
|
||||
- [tsup](https://tsup.egoist.dev)
|
||||
|
|
@ -6,20 +6,12 @@
|
|||
"enabled": true,
|
||||
"rules": {
|
||||
"recommended": true,
|
||||
|
||||
"correctness": {
|
||||
"noUnusedVariables": "error",
|
||||
"noUnusedImports": "error",
|
||||
"noEmptyPattern": "off",
|
||||
"useExhaustiveDependencies": "off",
|
||||
"noVoidTypeReturn": "error",
|
||||
"noVueDataObjectDeclaration": "error",
|
||||
"noVueDuplicateKeys": "error",
|
||||
"noVueReservedKeys": "error",
|
||||
"noVueReservedProps": "error",
|
||||
"noVueSetupPropsReactivityLoss": "warn"
|
||||
"useExhaustiveDependencies": "off"
|
||||
},
|
||||
|
||||
"style": {
|
||||
"noParameterAssign": "error",
|
||||
"useAsConstAssertion": "error",
|
||||
|
|
@ -29,124 +21,44 @@
|
|||
"useSingleVarDeclarator": "error",
|
||||
"noUnusedTemplateLiteral": "error",
|
||||
"useNumberNamespace": "error",
|
||||
"noInferrableTypes": "error",
|
||||
"useArrayLiterals": "error",
|
||||
"useConsistentArrayType": {
|
||||
"level": "error",
|
||||
"options": { "syntax": "shorthand" }
|
||||
},
|
||||
"useShorthandAssign": "error",
|
||||
"noNonNullAssertion": "warn"
|
||||
"noInferrableTypes": "error"
|
||||
},
|
||||
|
||||
"suspicious": {
|
||||
"noDebugger": "off",
|
||||
"noDoubleEquals": "off",
|
||||
"noExplicitAny": "off",
|
||||
"noApproximativeNumericConstant": "off",
|
||||
"noAsyncPromiseExecutor": "off",
|
||||
"noEmptyBlockStatements": "off",
|
||||
"noConsole": "off",
|
||||
"noArrayIndexKey": "warn"
|
||||
"noAsyncPromiseExecutor": "off"
|
||||
},
|
||||
|
||||
"complexity": {
|
||||
"noUselessConstructor": "off",
|
||||
"noBannedTypes": "off",
|
||||
"useLiteralKeys": "off",
|
||||
"useArrowFunction": "error",
|
||||
"useArrowFunction": "warn",
|
||||
"useDateNow": "off",
|
||||
"noUselessFragments": "off",
|
||||
"noExcessiveCognitiveComplexity": "off"
|
||||
"noUselessFragments": "off"
|
||||
},
|
||||
|
||||
"performance": {
|
||||
"noAccumulatingSpread": "off",
|
||||
"noDelete": "off"
|
||||
"noAccumulatingSpread": "off"
|
||||
},
|
||||
|
||||
"a11y": {
|
||||
"useSemanticElements": "off",
|
||||
"useAltText": "warn",
|
||||
"useButtonType": "warn"
|
||||
},
|
||||
|
||||
"security": {
|
||||
"noDangerouslySetInnerHtml": "warn"
|
||||
},
|
||||
|
||||
"nursery": {
|
||||
"noVueArrowFuncInWatch": "warn",
|
||||
"noVueVIfWithVFor": "error",
|
||||
"useVueConsistentDefinePropsDeclaration": "warn",
|
||||
"useVueConsistentVBindStyle": "warn",
|
||||
"useVueConsistentVOnStyle": "warn",
|
||||
"useVueDefineMacrosOrder": "warn",
|
||||
"useVueVForKey": "error",
|
||||
"useVueValidTemplateRoot": "error",
|
||||
"useVueValidVBind": "error",
|
||||
"useVueValidVIf": "error",
|
||||
"useVueValidVElse": "error",
|
||||
"useVueValidVElseIf": "error",
|
||||
"useVueValidVOn": "warn",
|
||||
"useVueValidVHtml": "warn"
|
||||
"useSemanticElements": "off"
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"formatter": {
|
||||
"enabled": true,
|
||||
"indentStyle": "space",
|
||||
"indentWidth": 2,
|
||||
"lineWidth": 100,
|
||||
"lineEnding": "lf"
|
||||
"indentWidth": 2
|
||||
},
|
||||
|
||||
"javascript": {
|
||||
"globals": [
|
||||
"defineProps",
|
||||
"defineEmits",
|
||||
"defineExpose",
|
||||
"withDefaults",
|
||||
"defineModel",
|
||||
"defineOptions",
|
||||
"defineSlots"
|
||||
],
|
||||
"parser": {
|
||||
"unsafeParameterDecoratorsEnabled": true
|
||||
},
|
||||
"formatter": {
|
||||
"enabled": true,
|
||||
"semicolons": "asNeeded",
|
||||
"arrowParentheses": "always",
|
||||
"bracketSameLine": false,
|
||||
"trailingCommas": "all",
|
||||
"attributePosition": "multiline",
|
||||
"quoteStyle": "double",
|
||||
"jsxQuoteStyle": "double",
|
||||
"bracketSpacing": true
|
||||
}
|
||||
},
|
||||
|
||||
"css": {
|
||||
"formatter": {
|
||||
"enabled": true,
|
||||
"indentStyle": "space",
|
||||
"indentWidth": 2,
|
||||
"lineWidth": 100,
|
||||
"quoteStyle": "double"
|
||||
},
|
||||
"linter": {
|
||||
"enabled": true
|
||||
}
|
||||
},
|
||||
|
||||
"html": {
|
||||
"formatter": {
|
||||
"enabled": true,
|
||||
"indentStyle": "space",
|
||||
"indentWidth": 2,
|
||||
"lineWidth": 100
|
||||
"attributePosition": "multiline"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
145
README.md
145
README.md
|
|
@ -1,120 +1,93 @@
|
|||
# `p-comuns` — Pacote Compartilhado e-licencie
|
||||
## ✅ Uso do BiomeJS para Autoformatação
|
||||
|
||||
Pacote de tipos, utilitários e configurações compartilhadas entre todos os subprojetos da plataforma **e-licencie** (back-end Node.js, front-end Vue 3 / TSX).
|
||||
Este guia mostra como configurar o [BiomeJS](https://biomejs.dev) para formatar e analisar código JavaScript/TypeScript no seu projeto.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Configuração do BiomeJS nos Subprojetos
|
||||
### 1. Incluir o pacote de configuração comum
|
||||
|
||||
Este guia mostra como usar a configuração base do Biome disponível neste pacote (`Documentos/biome.json`). Todos os subprojetos herdam essas regras via `extends`.
|
||||
Certifique-se de que o pacote `p-comuns` (ou outro com a configuração compartilhada) esteja disponível no seu projeto. Ele deve conter o arquivo `Documentos/biome.json`.
|
||||
|
||||
### 1. Adicionar o `p-comuns` como dependência
|
||||
|
||||
```bash
|
||||
pnpm add --save-dev p-comuns
|
||||
# ou atualizar se já existir:
|
||||
pnpm up p-comuns
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Instalar o Biome
|
||||
### 2. Instalar o Biome com `pnpm`
|
||||
|
||||
```bash
|
||||
pnpm add --save-dev --save-exact @biomejs/biome@2.4.0
|
||||
pnpm add --save-dev --save-exact @biomejs/biome@2.1.4
|
||||
```
|
||||
|
||||
> 🎯 Use `--save-exact` para garantir consistência de versões entre ambientes.
|
||||
|
||||
---
|
||||
|
||||
### 3. Criar `biome.json` na raiz do subprojeto
|
||||
### 3. Criar o arquivo de configuração na raiz do projeto
|
||||
|
||||
Crie um arquivo chamado `biome.json` com o seguinte conteúdo:
|
||||
|
||||
```json
|
||||
{
|
||||
"$schema": "node_modules/@biomejs/biome/configuration_schema.json",
|
||||
"extends": ["node_modules/p-comuns/Documentos/biome.json"],
|
||||
"vcs": {
|
||||
"enabled": true,
|
||||
"clientKind": "git",
|
||||
"useIgnoreFile": true
|
||||
},
|
||||
"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
|
||||
"extends": ["./node_modules/p-comuns/Documentos/biome.json"],
|
||||
"files": {
|
||||
"includes": ["**/*.{ts,tsx,vue}"]
|
||||
"includes": ["src/**/*.{js,ts,jsx,tsx}"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
> `vcs.useIgnoreFile: true` faz o Biome respeitar o `.gitignore` automaticamente — arquivos como `dist/`, `node_modules/` etc. são ignorados sem configuração adicional.
|
||||
> ⚠️ Verifique o caminho correto do `extends` relativo à raiz do seu projeto. Use `./` sempre que possível para evitar erros de resolução.
|
||||
|
||||
---
|
||||
|
||||
### 4. Adicionar scripts no `package.json`
|
||||
### 4. Adicionar script no `package.json`
|
||||
|
||||
Inclua o comando abaixo em `"scripts"`:
|
||||
|
||||
```json
|
||||
{
|
||||
"scripts": {
|
||||
"biome": "pnpm exec biome check --write",
|
||||
"check": "pnpm run biome && npx tsc --noEmit"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Isso permite executar:
|
||||
|
||||
```bash
|
||||
pnpm biome
|
||||
```
|
||||
|
||||
> O comando irá **formatar e aplicar as regras de lint** nos arquivos do diretório `src/`.
|
||||
|
||||
---
|
||||
|
||||
### 5. Configurar o VS Code (`.vscode/settings.json`)
|
||||
### ✅ Dica extra: formatar todos os arquivos
|
||||
|
||||
Se quiser aplicar o Biome a todo o projeto (não só `src/`), altere o include:
|
||||
|
||||
```json
|
||||
"includes": ["**/*.{js,ts,jsx,tsx}"]
|
||||
```
|
||||
|
||||
|
||||
|
||||
adicionar em .vscode/settings.json
|
||||
|
||||
{
|
||||
"editor.defaultFormatter": "biomejs.biome",
|
||||
"editor.formatOnSave": true,
|
||||
"editor.codeActionsOnSave": {
|
||||
"source.organizeImports.biome": "always",
|
||||
"source.fixAll.biome": "always"
|
||||
},
|
||||
"[javascript]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[javascriptreact]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[typescript]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[typescriptreact]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[vue]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[css]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[json]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"[jsonc]": { "editor.defaultFormatter": "biomejs.biome" },
|
||||
"editor.rulers": [100],
|
||||
"files.eol": "\n",
|
||||
"files.trimTrailingWhitespace": true,
|
||||
"files.insertFinalNewline": true
|
||||
"[vue]": {"editor.defaultFormatter": "octref.vetur"},
|
||||
"editor.codeActionsOnSave": {
|
||||
"source.organizeImports.biome": "always",
|
||||
"source.fixAll.biome": "always"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
> 💡 **Biome formata Vue `.vue` nativamente desde a v2.3** — não precisa do Prettier ou Vetur para formatação!
|
||||
|
||||
---
|
||||
|
||||
## 🔑 Regras da configuração base (Documentos/biome.json)
|
||||
|
||||
### O que está ativado:
|
||||
|
||||
| Categoria | Regras notáveis |
|
||||
|-----------|----------------|
|
||||
| **Correctness** | `noUnusedVariables`, `noUnusedImports`, `noVueSetupPropsReactivityLoss` |
|
||||
| **Vue 3 específico** | `noVueVIfWithVFor`, `useVueVForKey`, `noVueDuplicateKeys`, `noVueReservedKeys` |
|
||||
| **Style** | `useAsConstAssertion`, `useSelfClosingElements`, `useConsistentArrayType` (shorthand `T[]`) |
|
||||
| **Nursery Vue** | `noVueArrowFuncInWatch`, `useVueDefineMacrosOrder`, `useVueConsistentVBindStyle` |
|
||||
| **Security** | `noDangerouslySetInnerHtml` (warn) |
|
||||
|
||||
### Globals do Vue (sem necessidade de importar):
|
||||
|
||||
`defineProps`, `defineEmits`, `defineExpose`, `withDefaults`, `defineModel`, `defineOptions`, `defineSlots`
|
||||
|
||||
### Formatação:
|
||||
|
||||
- Indentação: **2 espaços**
|
||||
- Linha máxima: **100 caracteres**
|
||||
- Aspas: **duplas**
|
||||
- Ponto-e-vírgula: **apenas quando necessário**
|
||||
- Trailing comma: **sempre**
|
||||
- Line ending: **LF (`\n`)**
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -123,21 +96,29 @@ pnpm add --save-dev --save-exact @biomejs/biome@2.4.0
|
|||
O sistema `tipoFiltro26` foi projetado para gerar automaticamente a tipagem de filtros compatíveis com operadores padrão do PostgreSQL, a partir de um tipo base `T`.
|
||||
|
||||
**Principais características:**
|
||||
- Tipagem forte e segura (TypeScript)
|
||||
- Tipagem forte e segura (Typescript)
|
||||
- Suporte a aninhamento de objetos
|
||||
- Operadores lógicos `E` (AND) e `OU` (OR)
|
||||
- Validação de operadores permitidos por tipo de dado (string, number, boolean)
|
||||
|
||||
### Estrutura do Filtro
|
||||
|
||||
O filtro segue uma estrutura onde chaves representam campos (simples ou aninhados) e valores representam condições com operadores específicos.
|
||||
|
||||
#### 1. Campos Simples
|
||||
```typescript
|
||||
{ idade: { ">=": 18 } }
|
||||
{
|
||||
idade: { ">=": 18 }
|
||||
}
|
||||
```
|
||||
|
||||
#### 2. Campos Aninhados
|
||||
```typescript
|
||||
{ carro: { ano: { "=": 2020 } } }
|
||||
{
|
||||
carro: {
|
||||
ano: { "=": 2020 }
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 3. Operadores Lógicos
|
||||
|
|
@ -162,7 +143,7 @@ O sistema `tipoFiltro26` foi projetado para gerar automaticamente a tipagem de f
|
|||
}
|
||||
```
|
||||
|
||||
#### 4. Exemplo Complexo Completo
|
||||
#### 4. Exemplo Complexo Complet
|
||||
```typescript
|
||||
{
|
||||
idade: { ">=": 18 },
|
||||
|
|
@ -180,23 +161,21 @@ O sistema `tipoFiltro26` foi projetado para gerar automaticamente a tipagem de f
|
|||
|
||||
### Operadores Suportados (`operadores26`)
|
||||
|
||||
- **Number**: `=`, `!=`, `>`, `>=`, `<`, `<=`, `in`
|
||||
- **String**: `=`, `!=`, `like`, `in`
|
||||
- **Boolean**: `=`, `!=`, `in`
|
||||
Os operadores são fornecidos pelo enum `operadores26` e são restritos pelo tipo do campo:
|
||||
|
||||
* **Number**: `=`, `!=`, `>`, `>=`, `<`, `<=`, `in`
|
||||
* **String**: `=`, `!=`, `like`, `in`
|
||||
* **Boolean**: `=`, `!=`, `in`
|
||||
|
||||
> **Nota:** Atualmente não há suporte automático para `null`, `date`, `jsonb` ou `arrays` como tipos de campo raiz (exceto arrays dentro do operador `in`).
|
||||
|
||||
### Validação em Tempo de Execução (Zod)
|
||||
|
||||
O sistema inclui um validador Zod `zFiltro26` para validação estrutural dos objetos de filtro recebidos (ex: via API).
|
||||
|
||||
```typescript
|
||||
import { zFiltro26 } from "p-comuns"
|
||||
import { zFiltro26 } from './tipoFiltro.26';
|
||||
|
||||
// Valida a estrutura (não checa existência de colunas no DB)
|
||||
zFiltro26.parse(objetoFiltro)
|
||||
zFiltro26.parse(objetoFiltro);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📚 Veja também
|
||||
|
||||
- [`AGENTS.md`](./AGENTS.md) — Guia para assistentes de IA (padrões, convenções, arquitetura)
|
||||
- [Biome 2.x Docs](https://biomejs.dev)
|
||||
- [Vue 3 Composition API](https://vuejs.org/guide/composition-api)
|
||||
|
|
|
|||
|
|
@ -2,6 +2,6 @@
|
|||
"$schema": "node_modules/@biomejs/biome/configuration_schema.json",
|
||||
"extends": ["Documentos/biome.json"],
|
||||
"files": {
|
||||
"includes": ["src/**/*.{js,ts,jsx,tsx,vue}"]
|
||||
"includes": ["src/**/*.{js,ts,jsx,tsx}"]
|
||||
}
|
||||
}
|
||||
|
|
|
|||
|
|
@ -1,16 +0,0 @@
|
|||
"use strict";
|
||||
var __defProp = Object.defineProperty;
|
||||
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
||||
var __getOwnPropNames = Object.getOwnPropertyNames;
|
||||
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
||||
var __copyProps = (to, from, except, desc) => {
|
||||
if (from && typeof from === "object" || typeof from === "function") {
|
||||
for (let key of __getOwnPropNames(from))
|
||||
if (!__hasOwnProp.call(to, key) && key !== except)
|
||||
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
||||
}
|
||||
return to;
|
||||
};
|
||||
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
||||
var auditoria_exports = {};
|
||||
module.exports = __toCommonJS(auditoria_exports);
|
||||
|
|
@ -46,7 +46,17 @@ var operadores = /* @__PURE__ */ ((operadores2) => {
|
|||
operadores2["isNull"] = "isNull";
|
||||
return operadores2;
|
||||
})(operadores || {});
|
||||
const zOperadores = import_zod.default.enum(["=", "!=", ">", ">=", "<", "<=", "like", "in", "isNull"]);
|
||||
const zOperadores = import_zod.default.enum([
|
||||
"=",
|
||||
"!=",
|
||||
">",
|
||||
">=",
|
||||
"<",
|
||||
"<=",
|
||||
"like",
|
||||
"in",
|
||||
"isNull"
|
||||
]);
|
||||
const zFiltro = import_zod.default.object({
|
||||
coluna: import_zod.default.string(),
|
||||
valor: import_zod.default.any(),
|
||||
|
|
|
|||
|
|
@ -1,49 +0,0 @@
|
|||
"use strict";
|
||||
var __defProp = Object.defineProperty;
|
||||
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
||||
var __getOwnPropNames = Object.getOwnPropertyNames;
|
||||
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
||||
var __export = (target, all) => {
|
||||
for (var name in all)
|
||||
__defProp(target, name, { get: all[name], enumerable: true });
|
||||
};
|
||||
var __copyProps = (to, from, except, desc) => {
|
||||
if (from && typeof from === "object" || typeof from === "function") {
|
||||
for (let key of __getOwnPropNames(from))
|
||||
if (!__hasOwnProp.call(to, key) && key !== except)
|
||||
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
||||
}
|
||||
return to;
|
||||
};
|
||||
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
||||
var dayjs26_exports = {};
|
||||
__export(dayjs26_exports, {
|
||||
defineDayjsBr: () => defineDayjsBr
|
||||
});
|
||||
module.exports = __toCommonJS(dayjs26_exports);
|
||||
const defineDayjsBr = ({
|
||||
dayjs,
|
||||
duration,
|
||||
isSameOrAfter,
|
||||
isSameOrBefore,
|
||||
minMax,
|
||||
relativeTime,
|
||||
timezone,
|
||||
utc,
|
||||
weekOfYear
|
||||
}) => {
|
||||
dayjs.extend(utc);
|
||||
dayjs.extend(timezone);
|
||||
dayjs.extend(weekOfYear);
|
||||
dayjs.extend(isSameOrBefore);
|
||||
dayjs.extend(isSameOrAfter);
|
||||
dayjs.extend(minMax);
|
||||
dayjs.extend(relativeTime);
|
||||
dayjs.extend(duration);
|
||||
dayjs.locale("pt-br");
|
||||
return dayjs;
|
||||
};
|
||||
// Annotate the CommonJS export names for ESM import in node:
|
||||
0 && (module.exports = {
|
||||
defineDayjsBr
|
||||
});
|
||||
|
|
@ -16,11 +16,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|||
var index_exports = {};
|
||||
module.exports = __toCommonJS(index_exports);
|
||||
__reExport(index_exports, require("./aleatorio"), module.exports);
|
||||
__reExport(index_exports, require("./auditoria"), module.exports);
|
||||
__reExport(index_exports, require("./cacheMemoria"), module.exports);
|
||||
__reExport(index_exports, require("./constantes"), module.exports);
|
||||
__reExport(index_exports, require("./consulta"), module.exports);
|
||||
__reExport(index_exports, require("./dayjs26"), module.exports);
|
||||
__reExport(index_exports, require("./dayjs"), module.exports);
|
||||
__reExport(index_exports, require("./ecosistema"), module.exports);
|
||||
__reExport(index_exports, require("./extensoes"), module.exports);
|
||||
__reExport(index_exports, require("./extensoes"), module.exports);
|
||||
|
|
@ -39,11 +38,10 @@ __reExport(index_exports, require("./variaveisComuns"), module.exports);
|
|||
// Annotate the CommonJS export names for ESM import in node:
|
||||
0 && (module.exports = {
|
||||
...require("./aleatorio"),
|
||||
...require("./auditoria"),
|
||||
...require("./cacheMemoria"),
|
||||
...require("./constantes"),
|
||||
...require("./consulta"),
|
||||
...require("./dayjs26"),
|
||||
...require("./dayjs"),
|
||||
...require("./ecosistema"),
|
||||
...require("./extensoes"),
|
||||
...require("./extensoes"),
|
||||
|
|
|
|||
|
|
@ -97,7 +97,9 @@ class TipagemRotas {
|
|||
let queryObj = Object.fromEntries(query.entries());
|
||||
const hash = url.hash;
|
||||
if (hash) {
|
||||
const hashObj = Object.fromEntries(new URLSearchParams(hash.slice(1)).entries());
|
||||
const hashObj = Object.fromEntries(
|
||||
new URLSearchParams(hash.slice(1)).entries()
|
||||
);
|
||||
queryObj = { ...queryObj, ...hashObj };
|
||||
}
|
||||
for (const chave in queryObj) {
|
||||
|
|
|
|||
|
|
@ -22,7 +22,9 @@ __export(variaveisComuns_exports, {
|
|||
nomeVariavel: () => nomeVariavel
|
||||
});
|
||||
module.exports = __toCommonJS(variaveisComuns_exports);
|
||||
const esperar = (ms) => new Promise((resolve) => setTimeout(() => resolve(true), ms));
|
||||
const esperar = (ms) => new Promise(
|
||||
(resolve) => setTimeout(() => resolve(true), ms)
|
||||
);
|
||||
const nomeVariavel = (v) => Object.keys(v).join("/");
|
||||
// Annotate the CommonJS export names for ESM import in node:
|
||||
0 && (module.exports = {
|
||||
|
|
|
|||
|
|
@ -1,41 +1,10 @@
|
|||
import z, { z as z$1 } from 'zod';
|
||||
import _dayjs from 'dayjs';
|
||||
import dayjs from 'dayjs';
|
||||
export { Dayjs, ManipulateType } from 'dayjs';
|
||||
import _duration from 'dayjs/plugin/duration';
|
||||
import _isSameOrAfter from 'dayjs/plugin/isSameOrAfter';
|
||||
import _isSameOrBefore from 'dayjs/plugin/isSameOrBefore';
|
||||
import _minMax from 'dayjs/plugin/minMax';
|
||||
import _relativeTime from 'dayjs/plugin/relativeTime';
|
||||
import _timezone from 'dayjs/plugin/timezone';
|
||||
import _utc from 'dayjs/plugin/utc';
|
||||
import _weekOfYear from 'dayjs/plugin/weekOfYear';
|
||||
import { v4 } from 'uuid';
|
||||
|
||||
declare const aleatorio: (tamanho?: number) => string;
|
||||
|
||||
type TipoPayloadAuditoria = {
|
||||
/** UUID do registro de auditoria */
|
||||
codigo?: string | null;
|
||||
/** UUID do usuario da acao (pode ser null se for processo do sistema que não registrou) */
|
||||
usuario_criacao: string | null;
|
||||
/** Timestamp ou data de criacao / execucao */
|
||||
data_criacao: string | Date;
|
||||
/** Nome exato da tabela no banco que originou o registro */
|
||||
tabela_origem: string;
|
||||
/** Código único (UUID) do registro na tabela original */
|
||||
codigo_origem: string;
|
||||
/** JSON contendo o snapshot das colunas novas / editadas */
|
||||
novo: Record<string, any>;
|
||||
/** JSON contendo o snapshot das colunas antes da edição */
|
||||
anterior: Record<string, any>;
|
||||
/** Hash ou controle de versao do item, usualmente preenchido por new.ver_seg */
|
||||
__versao: string;
|
||||
/** Tipo de operação que gerou a auditoria */
|
||||
acao: "criar" | "atualizar" | "deletar" | string;
|
||||
/** Versão do sistema no momento em que a ação ocorreu */
|
||||
versao_sistema: string;
|
||||
};
|
||||
|
||||
/** gerar uma função de cache para uso em memoria */
|
||||
declare const cacheM: <T>(chave: any, valor?: T, validadeSeg?: number) => T | undefined;
|
||||
declare const verCacheM: () => {
|
||||
|
|
@ -124,69 +93,7 @@ declare const zFiltro: z.ZodObject<{
|
|||
ou: z.ZodOptional<z.ZodBoolean>;
|
||||
}, z.core.$strip>;
|
||||
|
||||
/**
|
||||
* Utilitário de configuração do Dayjs focado em compatibilidade com SSR.
|
||||
*
|
||||
* PROBLEMA:
|
||||
* A importação direta do `dayjs` e seus plugins frequentemente causa conflitos em ambientes
|
||||
* de Renderização do Lado do Servidor (SSR), como Nuxt ou Next.js, devido a discrepâncias
|
||||
* na resolução de módulos (ESM vs CJS) e instabilidades de importação.
|
||||
*
|
||||
* SOLUÇÃO:
|
||||
* Este módulo utiliza o padrão de Injeção de Dependência. Ele expõe apenas tipagens e
|
||||
* uma função de configuração (`defineDayjsBr`). A responsabilidade de importar as
|
||||
* bibliotecas "vivas" é delegada à aplicação consumidora (o cliente da função).
|
||||
*
|
||||
* Isso permite que o bundler da aplicação principal (Vite, Webpack, etc.) gerencie as
|
||||
* instâncias, garantindo consistência e evitando erros de "module not found" ou
|
||||
* instâncias duplicadas/não inicializadas adequadamente.
|
||||
*/
|
||||
|
||||
/**
|
||||
* Inicializa e configura o Dayjs com o locale 'pt-br' e plugins essenciais.
|
||||
*
|
||||
* MODO DE USO:
|
||||
* Importe os pacotes reais na sua aplicação e passe-os para esta função.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* // Em seu arquivo de configuração (ex: plugins/dayjs.ts):
|
||||
* import dayjs from "dayjs"
|
||||
* import duration from "dayjs/plugin/duration"
|
||||
* import isSameOrAfter from "dayjs/plugin/isSameOrAfter"
|
||||
* import isSameOrBefore from "dayjs/plugin/isSameOrBefore"
|
||||
* import minMax from "dayjs/plugin/minMax"
|
||||
* import relativeTime from "dayjs/plugin/relativeTime"
|
||||
* import timezone from "dayjs/plugin/timezone"
|
||||
* import utc from "dayjs/plugin/utc"
|
||||
* import weekOfYear from "dayjs/plugin/weekOfYear"
|
||||
* import { defineDayjsBr } from "p-comuns"
|
||||
* import "dayjs/locale/pt-br" // Importante: importar o locale!
|
||||
|
||||
* export const dayjsbr = defineDayjsBr({
|
||||
* dayjs,
|
||||
* duration,
|
||||
* isSameOrAfter,
|
||||
* isSameOrBefore,
|
||||
* minMax,
|
||||
* relativeTime,
|
||||
* timezone,
|
||||
* utc,
|
||||
* weekOfYear,
|
||||
* })
|
||||
* ```
|
||||
*/
|
||||
declare const defineDayjsBr: ({ dayjs, duration, isSameOrAfter, isSameOrBefore, minMax, relativeTime, timezone, utc, weekOfYear, }: {
|
||||
dayjs: typeof _dayjs;
|
||||
duration: typeof _duration;
|
||||
isSameOrAfter: typeof _isSameOrAfter;
|
||||
isSameOrBefore: typeof _isSameOrBefore;
|
||||
minMax: typeof _minMax;
|
||||
relativeTime: typeof _relativeTime;
|
||||
timezone: typeof _timezone;
|
||||
utc: typeof _utc;
|
||||
weekOfYear: typeof _weekOfYear;
|
||||
}) => typeof _dayjs;
|
||||
declare const definirDayjsbr: (dayjsEntrada: typeof dayjs) => typeof dayjs;
|
||||
|
||||
declare const link_paiol = "https://paiol.idz.one";
|
||||
|
||||
|
|
@ -560,4 +467,4 @@ declare const nomeVariavel: (v: {
|
|||
[key: string]: any;
|
||||
}) => string;
|
||||
|
||||
export { Produtos, TipagemRotas, type TipoPayloadAuditoria, agrupadores26, aleatorio, cacheM, cacheMFixo, cacheMemoria, camposComuns, criarFiltro26, defineDayjsBr, erUuid, esperar, extensoes, type interfaceConsulta, link_paiol, localValor, nomeVariavel, objetoPg, operadores, operadores26, paraObjetoRegistroPg, pgObjeto, siglas_unidades_medida, texto_busca, tipoArquivo, type tipoFiltro, type tipoFiltro26, tipoUsuarioResiduos, tiposSituacoesElicencie, tx, umaFuncao, umaVariavel, unidades_medida, uuid, uuidV3, uuidV4, uuid_null, validarUuid, verCacheM, zFiltro, zFiltro26, zOperadores };
|
||||
export { Produtos, TipagemRotas, agrupadores26, aleatorio, cacheM, cacheMFixo, cacheMemoria, camposComuns, criarFiltro26, definirDayjsbr, erUuid, esperar, extensoes, type interfaceConsulta, link_paiol, localValor, nomeVariavel, objetoPg, operadores, operadores26, paraObjetoRegistroPg, pgObjeto, siglas_unidades_medida, texto_busca, tipoArquivo, type tipoFiltro, type tipoFiltro26, tipoUsuarioResiduos, tiposSituacoesElicencie, tx, umaFuncao, umaVariavel, unidades_medida, uuid, uuidV3, uuidV4, uuid_null, validarUuid, verCacheM, zFiltro, zFiltro26, zOperadores };
|
||||
|
|
|
|||
File diff suppressed because one or more lines are too long
89
package.json
89
package.json
|
|
@ -1,46 +1,47 @@
|
|||
{
|
||||
"name": "p-comuns",
|
||||
"version": "0.335.0",
|
||||
"description": "",
|
||||
"main": "./dist-front/index.mjs",
|
||||
"module": "./dist-front/index.mjs",
|
||||
"types": "./dist-front/index.d.mts",
|
||||
"exports": {
|
||||
".": {
|
||||
"types": "./dist-front/index.d.mts",
|
||||
"import": "./dist-front/index.mjs",
|
||||
"require": "./dist-back/index.js"
|
||||
}
|
||||
},
|
||||
"scripts": {
|
||||
"biome": "pnpm exec biome check --write",
|
||||
"check": "pnpm run biome && npx tsc --noEmit",
|
||||
"build": "npm --no-git-tag-version version minor && pnpm run biome && tsup --config ./tsup/tsup.config.ts && pnpm run pacote",
|
||||
"teste": "npx vitest run src/testes/TipagemRotas.test.ts",
|
||||
"pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz",
|
||||
"postinstall": "node ./scripts/atualizar-biome.js"
|
||||
},
|
||||
"author": {
|
||||
"name": "AZTECA SOFTWARE LTDA",
|
||||
"email": "ti@e-licencie.com.br",
|
||||
"url": "https://e-licencie.com.br"
|
||||
},
|
||||
"license": "ISC",
|
||||
"dependencies": {},
|
||||
"devDependencies": {
|
||||
"uuid": "^11.1.0",
|
||||
"zod": "4.3.6",
|
||||
"dayjs": "^1.11.18",
|
||||
"@biomejs/biome": "2.4.12",
|
||||
"@types/node": "^22",
|
||||
"tsup": "8.5.1",
|
||||
"typescript": "^6",
|
||||
"unbuild": "^3.6.1",
|
||||
"vitest": "^3.2.4"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"dayjs": "^1.11.18",
|
||||
"uuid": "^11.1.0",
|
||||
"zod": "4.3.6"
|
||||
}
|
||||
"name": "p-comuns",
|
||||
"version": "0.314.0",
|
||||
"description": "",
|
||||
"main": "./dist-front/index.mjs",
|
||||
"module": "./dist-front/index.mjs",
|
||||
"types": "./dist-front/index.d.mts",
|
||||
"exports": {
|
||||
".": {
|
||||
"types": "./dist-front/index.d.mts",
|
||||
"import": "./dist-front/index.mjs",
|
||||
"require": "./dist-back/index.js"
|
||||
}
|
||||
},
|
||||
"scripts": {
|
||||
"biome": "pnpm exec biome check --write",
|
||||
"check": "pnpm run biome && npx tsc --noEmit",
|
||||
"build": "npm --no-git-tag-version version minor && pnpm run biome && tsup --config ./tsup/tsup.config.ts && pnpm run pacote",
|
||||
"teste": "npx vitest run src/testes/TipagemRotas.test.ts",
|
||||
"pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz"
|
||||
},
|
||||
"author": {
|
||||
"name": "AZTECA SOFTWARE LTDA",
|
||||
"email": "ti@e-licencie.com.br",
|
||||
"url": "https://e-licencie.com.br"
|
||||
},
|
||||
"license": "ISC",
|
||||
"dependencies": {},
|
||||
"devDependencies": {
|
||||
"cross-fetch": "4.1.0",
|
||||
"uuid": "^11.1.0",
|
||||
"zod": "4.1.4",
|
||||
"dayjs": "^1.11.18",
|
||||
"@biomejs/biome": "2.4.0",
|
||||
"@types/node": "^20.19.22",
|
||||
"tsup": "8.5.0",
|
||||
"typescript": "~5.9.3",
|
||||
"unbuild": "^3.6.1",
|
||||
"vitest": "^3.2.4"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"cross-fetch": "4.1.0",
|
||||
"dayjs": "^1.11.18",
|
||||
"uuid": "^11.1.0",
|
||||
"zod": "4.1.4"
|
||||
}
|
||||
}
|
||||
|
|
|
|||
BIN
pacote.tgz
BIN
pacote.tgz
Binary file not shown.
1824
pnpm-lock.yaml
generated
1824
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load diff
|
|
@ -1,96 +0,0 @@
|
|||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
|
||||
const initCwd = process.env.INIT_CWD;
|
||||
|
||||
// Se não tiver INIT_CWD, não foi chamado pelo npm/pnpm install
|
||||
if (!initCwd) {
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// O próprio p-comuns não precisa se atualizar na sua pasta interna
|
||||
if (initCwd === process.cwd()) {
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
const me = require('../package.json');
|
||||
const biomeVersion = me.devDependencies && me.devDependencies['@biomejs/biome'];
|
||||
|
||||
if (!biomeVersion) {
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
/**
|
||||
* Lê os arquivos do diretório em busca de package.json
|
||||
*/
|
||||
function findPackageJson(dir) {
|
||||
let results = [];
|
||||
try {
|
||||
const list = fs.readdirSync(dir);
|
||||
for (const file of list) {
|
||||
const filePath = path.join(dir, file);
|
||||
const stat = fs.statSync(filePath);
|
||||
if (stat && stat.isDirectory()) {
|
||||
// Ignora pastas que não devemos varrer
|
||||
if (
|
||||
![
|
||||
'node_modules',
|
||||
'.git',
|
||||
'dist',
|
||||
'build',
|
||||
'.nuxt',
|
||||
'.output',
|
||||
'.vscode',
|
||||
'.idea',
|
||||
].includes(file)
|
||||
) {
|
||||
results = results.concat(findPackageJson(filePath));
|
||||
}
|
||||
} else if (file === 'package.json') {
|
||||
results.push(filePath);
|
||||
}
|
||||
}
|
||||
} catch (err) {
|
||||
// ignora pastas sem acesso
|
||||
}
|
||||
return results;
|
||||
}
|
||||
|
||||
const files = findPackageJson(initCwd);
|
||||
let updated = 0;
|
||||
|
||||
for (const file of files) {
|
||||
try {
|
||||
const content = fs.readFileSync(file, 'utf8');
|
||||
// Detecta se usa tab ou espaço
|
||||
const indent = content.match(/^[ \t]+/m) ? content.match(/^[ \t]+/m)[0] : '\t';
|
||||
|
||||
const json = JSON.parse(content);
|
||||
let changed = false;
|
||||
|
||||
const updateDeps = (tipo) => {
|
||||
if (json[tipo] && json[tipo]['@biomejs/biome']) {
|
||||
if (json[tipo]['@biomejs/biome'] !== biomeVersion) {
|
||||
json[tipo]['@biomejs/biome'] = biomeVersion;
|
||||
changed = true;
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
updateDeps('dependencies');
|
||||
updateDeps('devDependencies');
|
||||
updateDeps('peerDependencies');
|
||||
|
||||
if (changed) {
|
||||
fs.writeFileSync(file, JSON.stringify(json, null, indent) + '\n', 'utf8');
|
||||
updated++;
|
||||
console.log(`[p-comuns] @biomejs/biome atualizado para ${biomeVersion} em: ${path.relative(initCwd, file)}`);
|
||||
}
|
||||
} catch (e) {
|
||||
console.error(`[p-comuns] Erro ao atualizar ${file}: ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (updated > 0) {
|
||||
console.log(`[p-comuns] Total de package.json atualizados: ${updated}`);
|
||||
}
|
||||
|
|
@ -1,31 +0,0 @@
|
|||
export type TipoPayloadAuditoria = {
|
||||
/** UUID do registro de auditoria */
|
||||
codigo?: string | null
|
||||
|
||||
/** UUID do usuario da acao (pode ser null se for processo do sistema que não registrou) */
|
||||
usuario_criacao: string | null
|
||||
|
||||
/** Timestamp ou data de criacao / execucao */
|
||||
data_criacao: string | Date
|
||||
|
||||
/** Nome exato da tabela no banco que originou o registro */
|
||||
tabela_origem: string
|
||||
|
||||
/** Código único (UUID) do registro na tabela original */
|
||||
codigo_origem: string
|
||||
|
||||
/** JSON contendo o snapshot das colunas novas / editadas */
|
||||
novo: Record<string, any>
|
||||
|
||||
/** JSON contendo o snapshot das colunas antes da edição */
|
||||
anterior: Record<string, any>
|
||||
|
||||
/** Hash ou controle de versao do item, usualmente preenchido por new.ver_seg */
|
||||
__versao: string
|
||||
|
||||
/** Tipo de operação que gerou a auditoria */
|
||||
acao: "criar" | "atualizar" | "deletar" | string
|
||||
|
||||
/** Versão do sistema no momento em que a ação ocorreu */
|
||||
versao_sistema: string
|
||||
}
|
||||
|
|
@ -12,7 +12,11 @@ const _cache: {
|
|||
|
||||
;(globalThis as any).cacheMemoria_cache = _cache
|
||||
|
||||
export const cacheM = <T>(chave: any, valor?: T, validadeSeg?: number): T | undefined => {
|
||||
export const cacheM = <T>(
|
||||
chave: any,
|
||||
valor?: T,
|
||||
validadeSeg?: number,
|
||||
): T | undefined => {
|
||||
// converte a chave e string
|
||||
const txChave: string =
|
||||
typeof chave == "string"
|
||||
|
|
|
|||
|
|
@ -30,7 +30,17 @@ export type interfaceConsulta = {
|
|||
apenasContagem?: boolean
|
||||
}
|
||||
|
||||
export const zOperadores = z.enum(["=", "!=", ">", ">=", "<", "<=", "like", "in", "isNull"])
|
||||
export const zOperadores = z.enum([
|
||||
"=",
|
||||
"!=",
|
||||
">",
|
||||
">=",
|
||||
"<",
|
||||
"<=",
|
||||
"like",
|
||||
"in",
|
||||
"isNull",
|
||||
])
|
||||
|
||||
export const zFiltro = z.object({
|
||||
coluna: z.string(),
|
||||
|
|
|
|||
106
src/dayjs26.ts
106
src/dayjs26.ts
|
|
@ -1,106 +0,0 @@
|
|||
/**
|
||||
* Utilitário de configuração do Dayjs focado em compatibilidade com SSR.
|
||||
*
|
||||
* PROBLEMA:
|
||||
* A importação direta do `dayjs` e seus plugins frequentemente causa conflitos em ambientes
|
||||
* de Renderização do Lado do Servidor (SSR), como Nuxt ou Next.js, devido a discrepâncias
|
||||
* na resolução de módulos (ESM vs CJS) e instabilidades de importação.
|
||||
*
|
||||
* SOLUÇÃO:
|
||||
* Este módulo utiliza o padrão de Injeção de Dependência. Ele expõe apenas tipagens e
|
||||
* uma função de configuração (`defineDayjsBr`). A responsabilidade de importar as
|
||||
* bibliotecas "vivas" é delegada à aplicação consumidora (o cliente da função).
|
||||
*
|
||||
* Isso permite que o bundler da aplicação principal (Vite, Webpack, etc.) gerencie as
|
||||
* instâncias, garantindo consistência e evitando erros de "module not found" ou
|
||||
* instâncias duplicadas/não inicializadas adequadamente.
|
||||
*/
|
||||
|
||||
import type _dayjs from "dayjs"
|
||||
import type { Dayjs } from "dayjs"
|
||||
|
||||
export type { ManipulateType } from "dayjs"
|
||||
|
||||
// Importação apenas de TIPOS para evitar bundling indesejado neste arquivo
|
||||
import type _duration from "dayjs/plugin/duration"
|
||||
import type _isSameOrAfter from "dayjs/plugin/isSameOrAfter"
|
||||
import type _isSameOrBefore from "dayjs/plugin/isSameOrBefore"
|
||||
import type _minMax from "dayjs/plugin/minMax"
|
||||
import type _relativeTime from "dayjs/plugin/relativeTime"
|
||||
import type _timezone from "dayjs/plugin/timezone"
|
||||
import type _utc from "dayjs/plugin/utc"
|
||||
import type _weekOfYear from "dayjs/plugin/weekOfYear"
|
||||
|
||||
/**
|
||||
* Inicializa e configura o Dayjs com o locale 'pt-br' e plugins essenciais.
|
||||
*
|
||||
* MODO DE USO:
|
||||
* Importe os pacotes reais na sua aplicação e passe-os para esta função.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* // Em seu arquivo de configuração (ex: plugins/dayjs.ts):
|
||||
* import dayjs from "dayjs"
|
||||
* import duration from "dayjs/plugin/duration"
|
||||
* import isSameOrAfter from "dayjs/plugin/isSameOrAfter"
|
||||
* import isSameOrBefore from "dayjs/plugin/isSameOrBefore"
|
||||
* import minMax from "dayjs/plugin/minMax"
|
||||
* import relativeTime from "dayjs/plugin/relativeTime"
|
||||
* import timezone from "dayjs/plugin/timezone"
|
||||
* import utc from "dayjs/plugin/utc"
|
||||
* import weekOfYear from "dayjs/plugin/weekOfYear"
|
||||
* import { defineDayjsBr } from "p-comuns"
|
||||
* import "dayjs/locale/pt-br" // Importante: importar o locale!
|
||||
|
||||
* export const dayjsbr = defineDayjsBr({
|
||||
* dayjs,
|
||||
* duration,
|
||||
* isSameOrAfter,
|
||||
* isSameOrBefore,
|
||||
* minMax,
|
||||
* relativeTime,
|
||||
* timezone,
|
||||
* utc,
|
||||
* weekOfYear,
|
||||
* })
|
||||
* ```
|
||||
*/
|
||||
const defineDayjsBr = ({
|
||||
dayjs,
|
||||
duration,
|
||||
isSameOrAfter,
|
||||
isSameOrBefore,
|
||||
minMax,
|
||||
relativeTime,
|
||||
timezone,
|
||||
utc,
|
||||
weekOfYear,
|
||||
}: {
|
||||
dayjs: typeof _dayjs
|
||||
duration: typeof _duration
|
||||
isSameOrAfter: typeof _isSameOrAfter
|
||||
isSameOrBefore: typeof _isSameOrBefore
|
||||
minMax: typeof _minMax
|
||||
relativeTime: typeof _relativeTime
|
||||
timezone: typeof _timezone
|
||||
utc: typeof _utc
|
||||
weekOfYear: typeof _weekOfYear
|
||||
}) => {
|
||||
// Extensão da biblioteca com os plugins fornecidos
|
||||
dayjs.extend(utc)
|
||||
dayjs.extend(timezone)
|
||||
dayjs.extend(weekOfYear)
|
||||
dayjs.extend(isSameOrBefore)
|
||||
dayjs.extend(isSameOrAfter)
|
||||
dayjs.extend(minMax)
|
||||
dayjs.extend(relativeTime)
|
||||
dayjs.extend(duration)
|
||||
|
||||
// Definição do locale global
|
||||
dayjs.locale("pt-br")
|
||||
|
||||
return dayjs
|
||||
}
|
||||
|
||||
export type { Dayjs }
|
||||
export { defineDayjsBr }
|
||||
|
|
@ -162,7 +162,9 @@ export const extensoes: {
|
|||
* @param nomeArquivo
|
||||
* @returns
|
||||
*/
|
||||
export const tipoArquivo = (nomeArquivo: string | null | undefined): tiposArquivo => {
|
||||
export const tipoArquivo = (
|
||||
nomeArquivo: string | null | undefined,
|
||||
): tiposArquivo => {
|
||||
// extenssão do arquivo
|
||||
const extArquivo = String(nomeArquivo || "")
|
||||
.toLocaleLowerCase()
|
||||
|
|
|
|||
|
|
@ -1,9 +1,8 @@
|
|||
export * from "./aleatorio"
|
||||
export * from "./auditoria"
|
||||
export * from "./cacheMemoria"
|
||||
export * from "./constantes"
|
||||
export * from "./consulta"
|
||||
export * from "./dayjs26"
|
||||
export * from "./dayjs"
|
||||
export * from "./ecosistema"
|
||||
export * from "./extensoes"
|
||||
export * from "./extensoes"
|
||||
|
|
|
|||
|
|
@ -2,11 +2,18 @@
|
|||
* LocalStorage Tipado
|
||||
* Lê ou grava um valor no localStorage, mantendo o tipo genérico <T>.
|
||||
*/
|
||||
export const localValor = <T>(chave_: string | any, valor?: T | null): T | null => {
|
||||
const localStorage = "localStorage" in globalThis ? (globalThis as any).localStorage : undefined
|
||||
export const localValor = <T>(
|
||||
chave_: string | any,
|
||||
valor?: T | null,
|
||||
): T | null => {
|
||||
const localStorage =
|
||||
"localStorage" in globalThis ? (globalThis as any).localStorage : undefined
|
||||
if (typeof localStorage == "undefined") return null
|
||||
|
||||
const chave = typeof chave_ === "string" ? chave_ : encodeURIComponent(JSON.stringify(chave_))
|
||||
const chave =
|
||||
typeof chave_ === "string"
|
||||
? chave_
|
||||
: encodeURIComponent(JSON.stringify(chave_))
|
||||
|
||||
try {
|
||||
// Grava valor se fornecido
|
||||
|
|
|
|||
|
|
@ -14,7 +14,9 @@ export const paraObjetoRegistroPg = (entrada: {
|
|||
k,
|
||||
v === undefined || v == null
|
||||
? v
|
||||
: typeof v == "string" || typeof v == "number" || typeof v == "boolean"
|
||||
: typeof v == "string" ||
|
||||
typeof v == "number" ||
|
||||
typeof v == "boolean"
|
||||
? v
|
||||
: JSON.stringify(v, null, 2),
|
||||
]),
|
||||
|
|
|
|||
|
|
@ -63,7 +63,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
|
|||
*/
|
||||
|
||||
endereco(query: T, usarComoHash?: boolean) {
|
||||
const win = (typeof globalThis !== "undefined" && (globalThis as any).window) || undefined
|
||||
const win =
|
||||
(typeof globalThis !== "undefined" && (globalThis as any).window) ||
|
||||
undefined
|
||||
const url = new URL(win ? win.location.href : "http://localhost")
|
||||
|
||||
url.pathname = this.caminho
|
||||
|
|
@ -94,7 +96,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
|
|||
if (this._acaoIr) {
|
||||
this._acaoIr(this.endereco({ ...query }))
|
||||
} else {
|
||||
const win = (typeof globalThis !== "undefined" && (globalThis as any).window) || undefined
|
||||
const win =
|
||||
(typeof globalThis !== "undefined" && (globalThis as any).window) ||
|
||||
undefined
|
||||
if (win) {
|
||||
win.location.href = this.endereco({ ...query })
|
||||
}
|
||||
|
|
@ -120,7 +124,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
|
|||
// pegar hash
|
||||
const hash = url.hash
|
||||
if (hash) {
|
||||
const hashObj = Object.fromEntries(new URLSearchParams(hash.slice(1)).entries())
|
||||
const hashObj = Object.fromEntries(
|
||||
new URLSearchParams(hash.slice(1)).entries(),
|
||||
)
|
||||
queryObj = { ...queryObj, ...hashObj } as T
|
||||
}
|
||||
|
||||
|
|
|
|||
|
|
@ -164,7 +164,9 @@ type IsPlainObject<T> = T extends object
|
|||
============================================================================= */
|
||||
|
||||
type FiltroCampos<T> = {
|
||||
[K in keyof T]?: IsPlainObject<T[K]> extends true ? tipoFiltro26<T[K]> : PgOpsFor<T[K]>
|
||||
[K in keyof T]?: IsPlainObject<T[K]> extends true
|
||||
? tipoFiltro26<T[K]>
|
||||
: PgOpsFor<T[K]>
|
||||
}
|
||||
|
||||
/* =============================================================================
|
||||
|
|
|
|||
|
|
@ -6,7 +6,8 @@ import { NIL, v3, v4 } from "uuid"
|
|||
* @param valor - A string que será validada.
|
||||
* @returns booleano indicando se é um UUID válido.
|
||||
*/
|
||||
export const erUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
|
||||
export const erUuid =
|
||||
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
|
||||
|
||||
export const validarUuid = (uuid: string | number | undefined | null) => {
|
||||
const retorno = erUuid.test(String(uuid || ""))
|
||||
|
|
|
|||
|
|
@ -1,5 +1,7 @@
|
|||
export const esperar = (ms: number): Promise<true> =>
|
||||
new Promise((resolve: (r: true) => void) => setTimeout(() => resolve(true), ms))
|
||||
new Promise((resolve: (r: true) => void) =>
|
||||
setTimeout(() => resolve(true), ms),
|
||||
)
|
||||
/**
|
||||
* Usado para retronat o no de uma variável, deve ser usado dentro de um objeto
|
||||
* const nomex = {a: 1, b: 2}
|
||||
|
|
@ -7,4 +9,5 @@ export const esperar = (ms: number): Promise<true> =>
|
|||
* @param v
|
||||
* @returns
|
||||
*/
|
||||
export const nomeVariavel = (v: { [key: string]: any }) => Object.keys(v).join("/")
|
||||
export const nomeVariavel = (v: { [key: string]: any }) =>
|
||||
Object.keys(v).join("/")
|
||||
|
|
|
|||
|
|
@ -6,15 +6,13 @@
|
|||
/* Linguagem e Ambiente */
|
||||
"target": "ES2020" /* Define a versão do JavaScript para o código emitido. */,
|
||||
"lib": [
|
||||
"ES2020",
|
||||
"DOM",
|
||||
"DOM.Iterable"
|
||||
"dom.iterable"
|
||||
] /* Especifica as bibliotecas padrão a serem incluídas, como DOM para iteradores. */,
|
||||
"experimentalDecorators": true /* Habilita o suporte experimental a decoradores. */,
|
||||
"emitDecoratorMetadata": true /* Emite metadados de tipos de design para declarações decoradas. */,
|
||||
|
||||
/* Módulos */
|
||||
"moduleResolution": "bundler" /* Define como o TypeScript resolve módulos. */,
|
||||
"moduleResolution": "node" /* Define como o TypeScript resolve módulos. */,
|
||||
"rootDir": "./src" /* Define a pasta raiz para os arquivos de origem. */,
|
||||
|
||||
/* Emissão */
|
||||
|
|
@ -25,8 +23,7 @@
|
|||
|
||||
/* Verificação de Tipos */
|
||||
"strict": true /* Habilita todas as opções de verificação estrita de tipos. */,
|
||||
"skipLibCheck": true /* Ignora a verificação de tipos em arquivos de declaração de bibliotecas. */,
|
||||
"ignoreDeprecations": "6.0"
|
||||
"skipLibCheck": true /* Ignora a verificação de tipos em arquivos de declaração de bibliotecas. */
|
||||
},
|
||||
"include": [
|
||||
"src/**/*"
|
||||
|
|
|
|||
|
|
@ -18,10 +18,6 @@ export const tsup_config_back: Options = {
|
|||
minify: false, // Geralmente não minificamos o código do backend em produção, mas você pode mudar
|
||||
platform: "node",
|
||||
outExtension: () => ({ js: ".js" }),
|
||||
loader: {
|
||||
".svg": "text",
|
||||
".md": "text",
|
||||
},
|
||||
}
|
||||
|
||||
// Exporta a configuração padrão usando defineConfig
|
||||
|
|
|
|||
|
|
@ -19,10 +19,6 @@ export const tsup_config_front: Options = {
|
|||
external: ['dayjs', 'cross-fetch', 'uuid', 'zod'],
|
||||
outExtension: () => ({ js: ".mjs" }),
|
||||
shims: false,
|
||||
loader: {
|
||||
".svg": "text",
|
||||
".md": "text",
|
||||
},
|
||||
}
|
||||
|
||||
// Exporta a configuração padrão usando defineConfig
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue