publico/_comuns
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Compare commits

base: publico:master
Branches Tags
publico:master
publico:master-biome-ia
publico:master-dayjs
publico:compatibilidade
publico:feat--ajustes
publico:nuxt
publico:nux
publico:bbun
publico:v3.0.0
publico:v.3
publico:v3
publico:v.1
..
compare: publico:master-dayjs
Branches Tags
publico:master
publico:master-biome-ia
publico:master-dayjs
publico:compatibilidade
publico:feat--ajustes
publico:nuxt
publico:nux
publico:bbun
publico:v3.0.0
publico:v.3
publico:v3
publico:v.1

No commits in common. "master" and "master-dayjs" have entirely different histories.
master ... master-day

32 changed files with 1084 additions and 1849 deletions
Download patch file Download diff file Expand all files Collapse all files

23
.vscode/settings.json vendored
View file

@ -4,10 +4,8 @@
"source.fixAll.biome": "always" "source.fixAll.biome": "always"
}, },
"editor.defaultFormatter": "biomejs.biome", "editor.defaultFormatter": "biomejs.biome",
"editor.formatOnSave": true,
"[javascript]": { "[javascript]": {
"editor.defaultFormatter": "biomejs.biome" "editor.defaultFormatter": "vscode.typescript-language-features"
}, },
"[javascriptreact]": { "[javascriptreact]": {
"editor.defaultFormatter": "biomejs.biome" "editor.defaultFormatter": "biomejs.biome"
@ -25,21 +23,6 @@
"editor.defaultFormatter": "biomejs.biome" "editor.defaultFormatter": "biomejs.biome"
}, },
"[vue]": { "[vue]": {
"editor.defaultFormatter": "biomejs.biome" "editor.defaultFormatter": "esbenp.prettier-vscode"
}, }
"[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
} }

234
AGENTS.md
View file

@ -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)

106
Documentos/biome.json
View file

@ -6,20 +6,12 @@
"enabled": true, "enabled": true,
"rules": { "rules": {
"recommended": true, "recommended": true,
"correctness": { "correctness": {
"noUnusedVariables": "error", "noUnusedVariables": "error",
"noUnusedImports": "error", "noUnusedImports": "error",
"noEmptyPattern": "off", "noEmptyPattern": "off",
"useExhaustiveDependencies": "off", "useExhaustiveDependencies": "off"
"noVoidTypeReturn": "error",
"noVueDataObjectDeclaration": "error",
"noVueDuplicateKeys": "error",
"noVueReservedKeys": "error",
"noVueReservedProps": "error",
"noVueSetupPropsReactivityLoss": "warn"
}, },
"style": { "style": {
"noParameterAssign": "error", "noParameterAssign": "error",
"useAsConstAssertion": "error", "useAsConstAssertion": "error",
@ -29,124 +21,44 @@
"useSingleVarDeclarator": "error", "useSingleVarDeclarator": "error",
"noUnusedTemplateLiteral": "error", "noUnusedTemplateLiteral": "error",
"useNumberNamespace": "error", "useNumberNamespace": "error",
"noInferrableTypes": "error", "noInferrableTypes": "error"
"useArrayLiterals": "error",
"useConsistentArrayType": {
"level": "error",
"options": { "syntax": "shorthand" }
},
"useShorthandAssign": "error",
"noNonNullAssertion": "warn"
}, },
"suspicious": { "suspicious": {
"noDebugger": "off", "noDebugger": "off",
"noDoubleEquals": "off", "noDoubleEquals": "off",
"noExplicitAny": "off", "noExplicitAny": "off",
"noApproximativeNumericConstant": "off", "noApproximativeNumericConstant": "off",
"noAsyncPromiseExecutor": "off", "noAsyncPromiseExecutor": "off"
"noEmptyBlockStatements": "off",
"noConsole": "off",
"noArrayIndexKey": "warn"
}, },
"complexity": { "complexity": {
"noUselessConstructor": "off", "noUselessConstructor": "off",
"noBannedTypes": "off", "noBannedTypes": "off",
"useLiteralKeys": "off", "useLiteralKeys": "off",
"useArrowFunction": "error", "useArrowFunction": "warn",
"useDateNow": "off", "useDateNow": "off",
"noUselessFragments": "off", "noUselessFragments": "off"
"noExcessiveCognitiveComplexity": "off"
}, },
"performance": { "performance": {
"noAccumulatingSpread": "off", "noAccumulatingSpread": "off"
"noDelete": "off"
}, },
"a11y": { "a11y": {
"useSemanticElements": "off", "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"
} }
} }
}, },
"formatter": { "formatter": {
"enabled": true, "enabled": true,
"indentStyle": "space", "indentStyle": "space",
"indentWidth": 2, "indentWidth": 2
"lineWidth": 100,
"lineEnding": "lf"
}, },
"javascript": { "javascript": {
"globals": [
"defineProps",
"defineEmits",
"defineExpose",
"withDefaults",
"defineModel",
"defineOptions",
"defineSlots"
],
"parser": {
"unsafeParameterDecoratorsEnabled": true
},
"formatter": { "formatter": {
"enabled": true, "enabled": true,
"semicolons": "asNeeded", "semicolons": "asNeeded",
"arrowParentheses": "always", "arrowParentheses": "always",
"bracketSameLine": false, "bracketSameLine": false,
"trailingCommas": "all", "trailingCommas": "all",
"attributePosition": "multiline", "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
} }
} }
} }

145
README.md
View file

@ -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 pnpm up p-comuns
```
--- ---
### 2. Instalar o Biome ### 2. Instalar o Biome com `pnpm`
```bash ```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. > 🎯 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 ```json
{ {
"$schema": "node_modules/@biomejs/biome/configuration_schema.json", "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
"extends": ["node_modules/p-comuns/Documentos/biome.json"], "extends": ["./node_modules/p-comuns/Documentos/biome.json"],
"vcs": {
"enabled": true,
"clientKind": "git",
"useIgnoreFile": true
},
"files": { "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 ```json
{ {
"scripts": { "scripts": {
"biome": "pnpm exec biome check --write", "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 ```json
"includes": ["**/*.{js,ts,jsx,tsx}"]
```
adicionar em .vscode/settings.json
{ {
"editor.defaultFormatter": "biomejs.biome", "editor.defaultFormatter": "biomejs.biome",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports.biome": "always",
"source.fixAll.biome": "always"
},
"[javascript]": { "editor.defaultFormatter": "biomejs.biome" }, "[javascript]": { "editor.defaultFormatter": "biomejs.biome" },
"[javascriptreact]": { "editor.defaultFormatter": "biomejs.biome" }, "[javascriptreact]": { "editor.defaultFormatter": "biomejs.biome" },
"[typescript]": { "editor.defaultFormatter": "biomejs.biome" }, "[typescript]": { "editor.defaultFormatter": "biomejs.biome" },
"[typescriptreact]": { "editor.defaultFormatter": "biomejs.biome" }, "[typescriptreact]": { "editor.defaultFormatter": "biomejs.biome" },
"[vue]": { "editor.defaultFormatter": "biomejs.biome" },
"[css]": { "editor.defaultFormatter": "biomejs.biome" },
"[json]": { "editor.defaultFormatter": "biomejs.biome" }, "[json]": { "editor.defaultFormatter": "biomejs.biome" },
"[jsonc]": { "editor.defaultFormatter": "biomejs.biome" }, "[jsonc]": { "editor.defaultFormatter": "biomejs.biome" },
"editor.rulers": [100], "[vue]": {"editor.defaultFormatter": "octref.vetur"},
"files.eol": "\n", "editor.codeActionsOnSave": {
"files.trimTrailingWhitespace": true, "source.organizeImports.biome": "always",
"files.insertFinalNewline": true "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`. 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:** **Principais características:**
- Tipagem forte e segura (TypeScript) - Tipagem forte e segura (Typescript)
- Suporte a aninhamento de objetos - Suporte a aninhamento de objetos
- Operadores lógicos `E` (AND) e `OU` (OR) - Operadores lógicos `E` (AND) e `OU` (OR)
- Validação de operadores permitidos por tipo de dado (string, number, boolean) - Validação de operadores permitidos por tipo de dado (string, number, boolean)
### Estrutura do Filtro ### 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 #### 1. Campos Simples
```typescript ```typescript
{ idade: { ">=": 18 } } {
idade: { ">=": 18 }
}
``` ```
#### 2. Campos Aninhados #### 2. Campos Aninhados
```typescript ```typescript
{ carro: { ano: { "=": 2020 } } } {
carro: {
ano: { "=": 2020 }
}
}
``` ```
#### 3. Operadores Lógicos #### 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 ```typescript
{ {
idade: { ">=": 18 }, idade: { ">=": 18 },
@ -180,23 +161,21 @@ O sistema `tipoFiltro26` foi projetado para gerar automaticamente a tipagem de f
### Operadores Suportados (`operadores26`) ### Operadores Suportados (`operadores26`)
- **Number**: `=`, `!=`, `>`, `>=`, `<`, `<=`, `in` Os operadores são fornecidos pelo enum `operadores26` e são restritos pelo tipo do campo:
- **String**: `=`, `!=`, `like`, `in`
- **Boolean**: `=`, `!=`, `in` * **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) ### 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 ```typescript
import { zFiltro26 } from "p-comuns" import { zFiltro26 } from './tipoFiltro.26';
// Valida a estrutura (não checa existência de colunas no DB) // 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
biome.json
View file

@ -2,6 +2,6 @@
"$schema": "node_modules/@biomejs/biome/configuration_schema.json", "$schema": "node_modules/@biomejs/biome/configuration_schema.json",
"extends": ["Documentos/biome.json"], "extends": ["Documentos/biome.json"],
"files": { "files": {
"includes": ["src/**/*.{js,ts,jsx,tsx,vue}"] "includes": ["src/**/*.{js,ts,jsx,tsx}"]
} }
} }

16
dist-back/auditoria.js
View file

@ -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);

12
dist-back/consulta.js
View file

@ -46,7 +46,17 @@ var operadores = /* @__PURE__ */ ((operadores2) => {
operadores2["isNull"] = "isNull"; operadores2["isNull"] = "isNull";
return operadores2; return operadores2;
})(operadores || {}); })(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({ const zFiltro = import_zod.default.object({
coluna: import_zod.default.string(), coluna: import_zod.default.string(),
valor: import_zod.default.any(), valor: import_zod.default.any(),

49
dist-back/dayjs26.js
View file

@ -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
});

6
dist-back/index.js
View file

@ -16,11 +16,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
var index_exports = {}; var index_exports = {};
module.exports = __toCommonJS(index_exports); module.exports = __toCommonJS(index_exports);
__reExport(index_exports, require("./aleatorio"), module.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("./cacheMemoria"), module.exports);
__reExport(index_exports, require("./constantes"), module.exports); __reExport(index_exports, require("./constantes"), module.exports);
__reExport(index_exports, require("./consulta"), 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("./ecosistema"), module.exports);
__reExport(index_exports, require("./extensoes"), module.exports); __reExport(index_exports, require("./extensoes"), 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: // Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = { 0 && (module.exports = {
...require("./aleatorio"), ...require("./aleatorio"),
...require("./auditoria"),
...require("./cacheMemoria"), ...require("./cacheMemoria"),
...require("./constantes"), ...require("./constantes"),
...require("./consulta"), ...require("./consulta"),
...require("./dayjs26"), ...require("./dayjs"),
...require("./ecosistema"), ...require("./ecosistema"),
...require("./extensoes"), ...require("./extensoes"),
...require("./extensoes"), ...require("./extensoes"),

4
dist-back/tipagemRotas.js
View file

@ -97,7 +97,9 @@ class TipagemRotas {
let queryObj = Object.fromEntries(query.entries()); let queryObj = Object.fromEntries(query.entries());
const hash = url.hash; const hash = url.hash;
if (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 }; queryObj = { ...queryObj, ...hashObj };
} }
for (const chave in queryObj) { for (const chave in queryObj) {

4
dist-back/variaveisComuns.js
View file

@ -22,7 +22,9 @@ __export(variaveisComuns_exports, {
nomeVariavel: () => nomeVariavel nomeVariavel: () => nomeVariavel
}); });
module.exports = __toCommonJS(variaveisComuns_exports); 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("/"); const nomeVariavel = (v) => Object.keys(v).join("/");
// Annotate the CommonJS export names for ESM import in node: // Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = { 0 && (module.exports = {

99
dist-front/index.d.mts
View file

@ -1,41 +1,10 @@
import z, { z as z$1 } from 'zod'; import z, { z as z$1 } from 'zod';
import _dayjs from 'dayjs'; import dayjs from 'dayjs';
export { Dayjs, ManipulateType } 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'; import { v4 } from 'uuid';
declare const aleatorio: (tamanho?: number) => string; 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 */ /** gerar uma função de cache para uso em memoria */
declare const cacheM: <T>(chave: any, valor?: T, validadeSeg?: number) => T | undefined; declare const cacheM: <T>(chave: any, valor?: T, validadeSeg?: number) => T | undefined;
declare const verCacheM: () => { declare const verCacheM: () => {
@ -124,69 +93,7 @@ declare const zFiltro: z.ZodObject<{
ou: z.ZodOptional<z.ZodBoolean>; ou: z.ZodOptional<z.ZodBoolean>;
}, z.core.$strip>; }, z.core.$strip>;
/** declare const definirDayjsbr: (dayjsEntrada: typeof dayjs) => typeof dayjs;
* 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 link_paiol = "https://paiol.idz.one"; declare const link_paiol = "https://paiol.idz.one";
@ -560,4 +467,4 @@ declare const nomeVariavel: (v: {
[key: string]: any; [key: string]: any;
}) => string; }) => 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 };

2
dist-front/index.mjs
View file

File diff suppressed because one or more lines are too long

89
package.json
View file

@ -1,46 +1,47 @@
{ {
"name": "p-comuns", "name": "p-comuns",
"version": "0.335.0", "version": "0.314.0",
"description": "", "description": "",
"main": "./dist-front/index.mjs", "main": "./dist-front/index.mjs",
"module": "./dist-front/index.mjs", "module": "./dist-front/index.mjs",
"types": "./dist-front/index.d.mts", "types": "./dist-front/index.d.mts",
"exports": { "exports": {
".": { ".": {
"types": "./dist-front/index.d.mts", "types": "./dist-front/index.d.mts",
"import": "./dist-front/index.mjs", "import": "./dist-front/index.mjs",
"require": "./dist-back/index.js" "require": "./dist-back/index.js"
} }
}, },
"scripts": { "scripts": {
"biome": "pnpm exec biome check --write", "biome": "pnpm exec biome check --write",
"check": "pnpm run biome && npx tsc --noEmit", "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", "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", "teste": "npx vitest run src/testes/TipagemRotas.test.ts",
"pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz", "pacote": "npm pack && npm pack && mv $(npm pack --silent) pacote.tgz"
"postinstall": "node ./scripts/atualizar-biome.js" },
}, "author": {
"author": { "name": "AZTECA SOFTWARE LTDA",
"name": "AZTECA SOFTWARE LTDA", "email": "ti@e-licencie.com.br",
"email": "ti@e-licencie.com.br", "url": "https://e-licencie.com.br"
"url": "https://e-licencie.com.br" },
}, "license": "ISC",
"license": "ISC", "dependencies": {},
"dependencies": {}, "devDependencies": {
"devDependencies": { "cross-fetch": "4.1.0",
"uuid": "^11.1.0", "uuid": "^11.1.0",
"zod": "4.3.6", "zod": "4.1.4",
"dayjs": "^1.11.18", "dayjs": "^1.11.18",
"@biomejs/biome": "2.4.12", "@biomejs/biome": "2.4.0",
"@types/node": "^22", "@types/node": "^20.19.22",
"tsup": "8.5.1", "tsup": "8.5.0",
"typescript": "^6", "typescript": "~5.9.3",
"unbuild": "^3.6.1", "unbuild": "^3.6.1",
"vitest": "^3.2.4" "vitest": "^3.2.4"
}, },
"peerDependencies": { "peerDependencies": {
"dayjs": "^1.11.18", "cross-fetch": "4.1.0",
"uuid": "^11.1.0", "dayjs": "^1.11.18",
"zod": "4.3.6" "uuid": "^11.1.0",
} "zod": "4.1.4"
}
} }

BIN
pacote.tgz
View file

Binary file not shown.

1824
pnpm-lock.yaml generated
View file

File diff suppressed because it is too large Load diff

96
scripts/atualizar-biome.js
View file

@ -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}`);
}

31
src/auditoria.ts
View file

@ -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
}

6
src/cacheMemoria.ts
View file

@ -12,7 +12,11 @@ const _cache: {
;(globalThis as any).cacheMemoria_cache = _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 // converte a chave e string
const txChave: string = const txChave: string =
typeof chave == "string" typeof chave == "string"

12
src/consulta.ts
View file

@ -30,7 +30,17 @@ export type interfaceConsulta = {
apenasContagem?: boolean apenasContagem?: boolean
} }
export const zOperadores = z.enum(["=", "!=", ">", ">=", "<", "<=", "like", "in", "isNull"]) export const zOperadores = z.enum([
"=",
"!=",
">",
">=",
"<",
"<=",
"like",
"in",
"isNull",
])
export const zFiltro = z.object({ export const zFiltro = z.object({
coluna: z.string(), coluna: z.string(),

106
src/dayjs26.ts
View file

@ -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 }

4
src/extensoes.ts
View file

@ -162,7 +162,9 @@ export const extensoes: {
* @param nomeArquivo * @param nomeArquivo
* @returns * @returns
*/ */
export const tipoArquivo = (nomeArquivo: string | null | undefined): tiposArquivo => { export const tipoArquivo = (
nomeArquivo: string | null | undefined,
): tiposArquivo => {
// extenssão do arquivo // extenssão do arquivo
const extArquivo = String(nomeArquivo || "") const extArquivo = String(nomeArquivo || "")
.toLocaleLowerCase() .toLocaleLowerCase()

3
src/index.ts
View file

@ -1,9 +1,8 @@
export * from "./aleatorio" export * from "./aleatorio"
export * from "./auditoria"
export * from "./cacheMemoria" export * from "./cacheMemoria"
export * from "./constantes" export * from "./constantes"
export * from "./consulta" export * from "./consulta"
export * from "./dayjs26" export * from "./dayjs"
export * from "./ecosistema" export * from "./ecosistema"
export * from "./extensoes" export * from "./extensoes"
export * from "./extensoes" export * from "./extensoes"

13
src/local/index.ts
View file

@ -2,11 +2,18 @@
* LocalStorage Tipado * LocalStorage Tipado
* Lê ou grava um valor no localStorage, mantendo o tipo genérico <T>. * 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 => { export const localValor = <T>(
const localStorage = "localStorage" in globalThis ? (globalThis as any).localStorage : undefined chave_: string | any,
valor?: T | null,
): T | null => {
const localStorage =
"localStorage" in globalThis ? (globalThis as any).localStorage : undefined
if (typeof localStorage == "undefined") return null 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 { try {
// Grava valor se fornecido // Grava valor se fornecido

4
src/postgres.ts
View file

@ -14,7 +14,9 @@ export const paraObjetoRegistroPg = (entrada: {
k, k,
v === undefined || v == null v === undefined || v == null
? v ? v
: typeof v == "string" || typeof v == "number" || typeof v == "boolean" : typeof v == "string" ||
typeof v == "number" ||
typeof v == "boolean"
? v ? v
: JSON.stringify(v, null, 2), : JSON.stringify(v, null, 2),
]), ]),

12
src/tipagemRotas.ts
View file

@ -63,7 +63,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
*/ */
endereco(query: T, usarComoHash?: boolean) { 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") const url = new URL(win ? win.location.href : "http://localhost")
url.pathname = this.caminho url.pathname = this.caminho
@ -94,7 +96,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
if (this._acaoIr) { if (this._acaoIr) {
this._acaoIr(this.endereco({ ...query })) this._acaoIr(this.endereco({ ...query }))
} else { } else {
const win = (typeof globalThis !== "undefined" && (globalThis as any).window) || undefined const win =
(typeof globalThis !== "undefined" && (globalThis as any).window) ||
undefined
if (win) { if (win) {
win.location.href = this.endereco({ ...query }) win.location.href = this.endereco({ ...query })
} }
@ -120,7 +124,9 @@ export class TipagemRotas<T extends { [q: string]: any }> {
// pegar hash // pegar hash
const hash = url.hash const hash = url.hash
if (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 queryObj = { ...queryObj, ...hashObj } as T
} }

4
src/tipoFiltro.26.ts
View file

@ -164,7 +164,9 @@ type IsPlainObject<T> = T extends object
============================================================================= */ ============================================================================= */
type FiltroCampos<T> = { 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]>
} }
/* ============================================================================= /* =============================================================================

3
src/uuid.ts
View file

@ -6,7 +6,8 @@ import { NIL, v3, v4 } from "uuid"
* @param valor - A string que será validada. * @param valor - A string que será validada.
* @returns booleano indicando se é um UUID válido. * @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) => { export const validarUuid = (uuid: string | number | undefined | null) => {
const retorno = erUuid.test(String(uuid || "")) const retorno = erUuid.test(String(uuid || ""))

7
src/variaveisComuns.ts
View file

@ -1,5 +1,7 @@
export const esperar = (ms: number): Promise<true> => 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 * Usado para retronat o no de uma variável, deve ser usado dentro de um objeto
* const nomex = {a: 1, b: 2} * const nomex = {a: 1, b: 2}
@ -7,4 +9,5 @@ export const esperar = (ms: number): Promise<true> =>
* @param v * @param v
* @returns * @returns
*/ */
export const nomeVariavel = (v: { [key: string]: any }) => Object.keys(v).join("/") export const nomeVariavel = (v: { [key: string]: any }) =>
Object.keys(v).join("/")

9
tsconfig.json
View file

@ -6,15 +6,13 @@
/* Linguagem e Ambiente */ /* Linguagem e Ambiente */
"target": "ES2020" /* Define a versão do JavaScript para o código emitido. */, "target": "ES2020" /* Define a versão do JavaScript para o código emitido. */,
"lib": [ "lib": [
"ES2020", "dom.iterable"
"DOM",
"DOM.Iterable"
] /* Especifica as bibliotecas padrão a serem incluídas, como DOM para iteradores. */, ] /* Especifica as bibliotecas padrão a serem incluídas, como DOM para iteradores. */,
"experimentalDecorators": true /* Habilita o suporte experimental a decoradores. */, "experimentalDecorators": true /* Habilita o suporte experimental a decoradores. */,
"emitDecoratorMetadata": true /* Emite metadados de tipos de design para declarações decoradas. */, "emitDecoratorMetadata": true /* Emite metadados de tipos de design para declarações decoradas. */,
/* Módulos */ /* 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. */, "rootDir": "./src" /* Define a pasta raiz para os arquivos de origem. */,
/* Emissão */ /* Emissão */
@ -25,8 +23,7 @@
/* Verificação de Tipos */ /* Verificação de Tipos */
"strict": true /* Habilita todas as opções de verificação estrita 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. */, "skipLibCheck": true /* Ignora a verificação de tipos em arquivos de declaração de bibliotecas. */
"ignoreDeprecations": "6.0"
}, },
"include": [ "include": [
"src/**/*" "src/**/*"

4
tsup/tsup.config.back.ts
View file

@ -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 minify: false, // Geralmente não minificamos o código do backend em produção, mas você pode mudar
platform: "node", platform: "node",
outExtension: () => ({ js: ".js" }), outExtension: () => ({ js: ".js" }),
loader: {
".svg": "text",
".md": "text",
},
} }
// Exporta a configuração padrão usando defineConfig // Exporta a configuração padrão usando defineConfig

4
tsup/tsup.config.front.ts
View file

@ -19,10 +19,6 @@ export const tsup_config_front: Options = {
external: ['dayjs', 'cross-fetch', 'uuid', 'zod'], external: ['dayjs', 'cross-fetch', 'uuid', 'zod'],
outExtension: () => ({ js: ".mjs" }), outExtension: () => ({ js: ".mjs" }),
shims: false, shims: false,
loader: {
".svg": "text",
".md": "text",
},
} }
// Exporta a configuração padrão usando defineConfig // Exporta a configuração padrão usando defineConfig