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"
|
"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
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,
|
"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
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
|
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,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}"]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -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";
|
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(),
|
||||||
|
|
|
||||||
|
|
@ -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 = {};
|
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"),
|
||||||
|
|
|
||||||
|
|
@ -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) {
|
||||||
|
|
|
||||||
|
|
@ -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 = {
|
||||||
|
|
|
||||||
|
|
@ -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 };
|
||||||
|
|
|
||||||
File diff suppressed because one or more lines are too long
19
package.json
19
package.json
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"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",
|
||||||
|
|
@ -17,8 +17,7 @@
|
||||||
"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",
|
||||||
|
|
@ -28,19 +27,21 @@
|
||||||
"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": {
|
||||||
|
"cross-fetch": "4.1.0",
|
||||||
"dayjs": "^1.11.18",
|
"dayjs": "^1.11.18",
|
||||||
"uuid": "^11.1.0",
|
"uuid": "^11.1.0",
|
||||||
"zod": "4.3.6"
|
"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
|
;(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"
|
||||||
|
|
|
||||||
|
|
@ -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
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
|
* @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()
|
||||||
|
|
|
||||||
|
|
@ -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"
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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),
|
||||||
]),
|
]),
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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]>
|
||||||
}
|
}
|
||||||
|
|
||||||
/* =============================================================================
|
/* =============================================================================
|
||||||
|
|
|
||||||
|
|
@ -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 || ""))
|
||||||
|
|
|
||||||
|
|
@ -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("/")
|
||||||
|
|
|
||||||
|
|
@ -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/**/*"
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue