acai-ui 1.65.5

package/dist/utils/scroll-elemento.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-elemento.d.ts","sourceRoot":"","sources":["../../src/utils/scroll-elemento.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,2BAA2B,CAAA;AAE/D,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,gBAAgB,GAAE,MAAgC,EAClD,aAAa,GAAE,cAAyB,GACvC,IAAI,CAaN"}

package/dist/utils/validar-campo.d.ts

@@ -0,0 +1,7 @@
+export declare const estaVazio: (v: unknown) => boolean;
+export declare const temValor: (v: unknown) => boolean;
+export declare const temTexto: (v?: string) => boolean;
+export declare const temIdValido: (v?: number) => boolean;
+export declare const ehArquivo: (v: unknown) => v is File;
+export declare const ehObjeto: (v: unknown) => v is Record<string, unknown>;
+//# sourceMappingURL=validar-campo.d.ts.map

package/dist/utils/validar-campo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validar-campo.d.ts","sourceRoot":"","sources":["../../src/utils/validar-campo.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,OACsC,CAAA;AAE7E,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,OAKrC,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAAuD,CAAA;AAE7F,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,OAAyC,CAAA;AAIlF,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,IAO3C,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAC5B,CAAA"}

package/dist/utils/validar-documentos.d.ts

@@ -0,0 +1,12 @@
+type Regra = (val: unknown) => true | string;
+export declare const regraRgNumero: Regra;
+export declare const regraCnhNumero: Regra;
+export declare const regraTituloNumero: Regra;
+export declare const regraTituloZona: Regra;
+export declare const regraTituloSecao: Regra;
+export declare const regraCtpsNumero: Regra;
+export declare const regraCtpsSerie: Regra;
+export declare const regraPis: Regra;
+export declare const regraReservista: Regra;
+export {};
+//# sourceMappingURL=validar-documentos.d.ts.map

package/dist/utils/validar-documentos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validar-documentos.d.ts","sourceRoot":"","sources":["../../src/utils/validar-documentos.ts"],"names":[],"mappings":"AAAA,KAAK,KAAK,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,CAAA;AAmC5C,eAAO,MAAM,aAAa,EAAE,KAM3B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAM5B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAG/B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAG7B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAG9B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAI7B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAG5B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAGtB,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,KAG7B,CAAA"}

package/dist/utils/vnode-slot.d.ts

@@ -0,0 +1,43 @@
+import { VNode } from 'vue';
+/**
+ * Leitura de vnodes vindos de slot — para quem precisa INSPECIONAR o que o
+ * consumidor escreveu antes de decidir como renderizar.
+ *
+ * Dois componentes fazem isso hoje:
+ *
+ * - `<acai-ui-tabs>` lê a config de cada `<acai-ui-tab>` (label, ícone,
+ *   keep-alive) sem que o `<acai-ui-tab>` chegue a montar;
+ * - `<acai-ui-actions>` converte cada `<acai-ui-button>` do slot num
+ *   `<acai-ui-dropdown-item>` quando recolhe as ações no celular.
+ *
+ * Nos dois casos o vnode NÃO passou pela normalização que o Vue só faz ao
+ * montar o componente de verdade — e é por isso que estas funções existem. Elas
+ * nasceram dentro do `acai-ui-tabs`, cada uma pagando um bug; ficam aqui pra
+ * não divergirem quando o segundo consumidor aparecer (apareceu).
+ *
+ * Interno de propósito: **não** é exportado no `utils/index.ts`. É detalhe de
+ * implementação da lib, não API de consumidor.
+ */
+/**
+ * `vnode.props` guarda o atributo COMO ESCRITO no template — o Vue só
+ * camelCase-ifica ao resolver `instance.props`, o que exige montar. Sem isto,
+ * `<acai-ui-button icon-right="download">` chega com a chave `'icon-right'` e
+ * `p.iconRight` dá `undefined`.
+ */
+export declare function normalizarProps(props: Record<string, unknown> | null | undefined): Record<string, unknown>;
+/**
+ * Boolean casting do Vue (o mesmo do `resolvePropValue`): atributo booleano sem
+ * valor — `<acai-ui-button disable>`, que é como se escreve de verdade — chega
+ * no vnode como `''`, e `Boolean('')` é `false`. Aqui `''` significa `true`.
+ */
+export declare function lerBooleano(valor: unknown): boolean;
+/**
+ * Achata o que o slot devolveu até a lista de vnodes que interessam.
+ *
+ * - **Fragment** é o que `v-for` e `v-if` produzem; a recursão cobre o caso
+ *   aninhado (um `v-for` dentro de um `v-if` gera Fragment dentro de Fragment).
+ * - **Comment** é o que sobra de um `v-if` falso — não é conteúdo.
+ * - **Text só de espaço** é a quebra de linha do template, não conteúdo.
+ */
+export declare function achatarSlot(children: ReadonlyArray<VNode> | undefined | null): VNode[];
+//# sourceMappingURL=vnode-slot.d.ts.map

package/dist/utils/vnode-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vnode-slot.d.ts","sourceRoot":"","sources":["../../src/utils/vnode-slot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,KAAK,EAAE,MAAM,KAAK,CAAA;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,EAAE,CAkBtF"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "acai-ui",
+  "version": "1.65.5",
+  "description": "Açaí UI — Componentes Vue 3 + Quasar 2 para projetos DETRAN-PA",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "vue": "./src/index.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./styles": "./dist/acai-ui.css",
+    "./scss/api": "./dist/scss/api.scss",
+    "./scss/api.scss": "./dist/scss/api.scss",
+    "./scss/tokens": "./dist/scss/tokens.scss",
+    "./scss/tokens.scss": "./dist/scss/tokens.scss",
+    "./scss/*": "./dist/scss/*",
+    "./scss/*.scss": "./dist/scss/*.scss"
+  },
+  "sideEffects": [
+    "*.css",
+    "*.scss"
+  ],
+  "files": [
+    "dist",
+    "src/**/*.vue",
+    "src/**/*.ts",
+    "src/**/*.scss",
+    "!src/**/*.spec.ts",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/para-springboot/packages.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && npm run copy:scss && npm run rewrite:vue-dts && npm run smoke:ssr",
+    "rewrite:vue-dts": "node scripts/rewrite-vue-dts.mjs",
+    "build:clean": "rm -rf dist && npm run build",
+    "copy:scss": "cp -r src/scss dist/scss",
+    "typecheck": "vue-tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:patch": "standard-version --release-as patch",
+    "smoke:ssr": "node scripts/smoke-ssr.mjs"
+  },
+  "peerDependencies": {
+    "@quasar/extras": "^1.16.0",
+    "quasar": "^2.17.0",
+    "vue": "^3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@quasar/extras": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@quasar/vite-plugin": "^1.11.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.1",
+    "@vitejs/plugin-vue": "^5.2.0",
+    "@vue/test-utils": "^2.4.11",
+    "axios": "^1.13.0",
+    "conventional-changelog-conventionalcommits": "^4.6.3",
+    "happy-dom": "^15.11.7",
+    "pinia": "^2.2.8",
+    "quasar": "^2.17.7",
+    "sass-embedded": "^1.86.0",
+    "semantic-release": "^25.0.3",
+    "semantic-release-monorepo": "^8.0.2",
+    "standard-version": "^9.5.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.0",
+    "vitest": "^3.2.7",
+    "vue": "^3.5.13",
+    "vue-router": "^4.6.4",
+    "vue-tsc": "^2.2.0"
+  },
+  "license": "UNLICENSED",
+  "engines": {
+    "node": "^20 || ^22 || ^24"
+  }
+}

package/src/components/actions/acai-ui-actions.vue

@@ -0,0 +1,225 @@
+<template>
+  <!--
+    Ações do consumidor que se recolhem no celular.
+
+    Desktop: exatamente o que o consumidor escreveu, solto — o componente some
+    do caminho (o `<slot>` é a raiz, não há wrapper extra pra atrapalhar o
+    `flex` de quem hospeda).
+
+    Celular (≤600px): vira menu de verdade. O motivo é aritmético e vale pra
+    qualquer cabeçalho da lib — card, section, formulário: rótulos de ação
+    ("Exportar", "Imprimir", "Nova cobrança") custam 90–120px cada, e ao lado de
+    um título ou de uma ação principal não sobra largura em 360px. A linha
+    quebrava em duas ou três e empurrava o conteúdo pra baixo.
+
+    Interno de propósito: não é exportado no `index.ts`. Quem monta cabeçalho
+    próprio usa `useTela` direto.
+  -->
+  <slot v-if="!ehMobile || !collapse" />
+
+  <template v-else>
+    <!--
+      NÃO RECONHECIDOS FICAM FORA DO MENU.
+
+      Só um `<acai-ui-button>` pode virar linha de menu com honestidade: é dele
+      que se sabe ler rótulo, ícone, cor, estado e clique. Um `<q-btn>` cru, um
+      componente do próprio consumidor ou uma `<div>` não têm contrato nenhum
+      pra ler — e adivinhar renderiza item errado.
+
+      Ficam soltos, exatamente como ficariam no desktop: a ação continua
+      clicável e visível. Sumir com ela seria trocar um problema de layout por
+      perda de funcionalidade, que é pior. O `console.warn` (só em DEV) diz ao
+      dev o que fazer.
+    -->
+    <component :is="v" v-for="(v, i) in soltos" :key="`solto-${i}`" />
+
+    <acai-ui-dropdown
+      v-if="itens.length > 0"
+      outline
+      :dense="dense"
+      :label="label"
+      :button-class="buttonClass"
+    >
+      <!--
+        Item de menu DE VERDADE, não botão fingindo de item. É daqui que sai
+        tudo o que o botão dentro do menu não tinha: `v-close-popup` (o menu
+        fechar ao escolher a ação), `role="listitem"` válido dentro do
+        `role="list"` do `<q-list>`, navegação por seta do QMenu, e o visual de
+        linha de menu sem CSS desfazendo cara de botão.
+      -->
+      <acai-ui-dropdown-item
+        v-for="(item, i) in itens"
+        :key="item.id ?? i"
+        v-bind="item"
+      />
+    </acai-ui-dropdown>
+  </template>
+</template>
+
+<script setup lang="ts">
+import { computed, useSlots, type VNode } from 'vue'
+import AcaiUiDropdown from '../dropdown/acai-ui-dropdown.vue'
+import AcaiUiDropdownItem from '../dropdown/acai-ui-dropdown-item.vue'
+import AcaiUiButton from '../button/acai-ui-button.vue'
+import type { DropdownItemProps } from '../dropdown/acai-ui-dropdown-interface'
+import type { MaterialIconValues } from '../../constants/lista-icons'
+import { achatarSlot, lerBooleano, normalizarProps } from '../../utils/vnode-slot'
+import { useTela } from '../../hooks/use-tela'
+
+// O `| undefined` é OBRIGATÓRIO em todas: os consumidores compilam com
+// `exactOptionalPropertyTypes: true`, onde `label?: string` significa "ausente
+// OU string" — e `undefined` não é nenhum dos dois. Quem hospeda repassa o
+// próprio `actionsLabel`, que o TS enxerga como `string | undefined`, e sem o
+// `| undefined` aqui o typecheck quebra no host. Mesma convenção já documentada
+// no `acai-ui-dropdown-interface.ts`.
+withDefaults(
+  defineProps<{
+    /** Rótulo do botão que agrupa as ações no celular. */
+    label?: string | undefined
+    /** Classe aplicada ao botão do dropdown — o `<acai-ui-dropdown>` tem
+     *  `inheritAttrs: false`, então uma `class` solta não chegaria nele. */
+    buttonClass?: string | undefined
+    dense?: boolean | undefined
+    /**
+     * Recolher no celular? Default `true`.
+     *
+     * Existe porque recolher NÃO é sempre ganho: ações **só de ícone** cabem
+     * numa linha mesmo em 360px, e no menu viram uma lista de rótulos onde o
+     * desenho era a informação. Quem tem um cabeçalho assim passa
+     * `:collapse-actions="false"` e mantém os ícones onde estavam.
+     */
+    collapse?: boolean | undefined
+  }>(),
+  { label: 'Ações', buttonClass: '', dense: false, collapse: true },
+)
+
+/**
+ * ≤600px (`$bp-sm` — o mesmo ponto da folha do drawer e do mixin `ate-mobile`).
+ *
+ * É `useTela` e não media query porque a mudança é de ESTRUTURA: as ações
+ * deixam de ser botões e viram itens de menu. CSS não troca componente.
+ */
+const { ehMobile } = useTela()
+
+const slots = useSlots() as { default?: () => VNode[] }
+
+/** Nome do SFC (o compilador infere do arquivo) — fallback da checagem por identidade. */
+const NOME_BOTAO = 'acai-ui-button'
+
+/**
+ * O consumidor pode resolver o `<acai-ui-button>` por outro caminho de módulo
+ * (a lib tem a condition `vue` apontando pro source além do `dist`), e aí a
+ * comparação por identidade falha mesmo sendo o mesmo componente. O `__name`
+ * é a rede de segurança.
+ */
+function ehBotaoAcai(v: VNode): boolean {
+  if (v.type === AcaiUiButton) return true
+  const tipo = v.type as { __name?: string; name?: string } | null | undefined
+  return tipo?.__name === NOME_BOTAO || tipo?.name === NOME_BOTAO
+}
+
+/**
+ * `@click` pode chegar como função ou como ARRAY de funções, quando mais de um
+ * listener é mesclado no mesmo vnode. O array quebraria silenciosamente.
+ */
+function normalizarClique(valor: unknown): ((evento: Event) => void) | undefined {
+  if (typeof valor === 'function') return valor as (evento: Event) => void
+  if (Array.isArray(valor)) {
+    return (evento: Event) => {
+      for (const fn of valor) if (typeof fn === 'function') fn(evento)
+    }
+  }
+  return undefined
+}
+
+/**
+ * Converte um `<acai-ui-button>` em `DropdownItemProps`, ou devolve `null` se
+ * não der pra nomear a linha.
+ *
+ * O NOME é o ponto: `label` é required no item, e uma linha de menu sem texto é
+ * um retângulo vazio — que era justamente o sintoma de antes com ação só de
+ * ícone. A ordem de busca aproveita que o botão já é obrigado a ter nome
+ * acessível quando é icon-only (eMAG 4.2), então `tooltip`/`ariaLabel` quase
+ * sempre existem. Botão sem nenhum dos três não vira item: fica solto e leva
+ * aviso, porque ali o problema não é o menu, é o botão sem nome acessível.
+ */
+function converter(v: VNode): DropdownItemProps | null {
+  const p = normalizarProps(v.props)
+
+  const label = String(p.label ?? '').trim()
+  const nomeAcessivel = String(p.ariaLabel ?? p.tooltip ?? '').trim()
+  const texto = label || nomeAcessivel
+  if (!texto) return null
+
+  // `iconRight` só entra se não houver `icon`: o item tem uma posição de ícone
+  // só, e perder o desenho é pior que mudá-lo de lado.
+  const icone = (p.icon ?? p.iconRight) as MaterialIconValues | undefined
+  const desabilitado = p.disable ?? p.disabled
+  const clique = normalizarClique(p.onClick)
+
+  // Spreads condicionais em vez de `undefined` explícito: o tsconfig do template
+  // do CLI usa `exactOptionalPropertyTypes: true`, onde passar `undefined` numa
+  // prop opcional é erro de tipo.
+  return {
+    label: texto,
+    ...(v.key != null ? { id: v.key as string | number } : {}),
+    ...(icone ? { icon: icone } : {}),
+    ...(p.color ? { color: String(p.color) } : {}),
+    ...(desabilitado !== undefined ? { disabled: lerBooleano(desabilitado) } : {}),
+    // O tooltip do botão não sobrevive dentro do menu (não há hover no celular),
+    // mas o do estado desabilitado sim — é o que explica por que a ação não pode
+    // ser usada, e o `<acai-ui-dropdown-item>` mostra esse.
+    ...(label && p.tooltip ? { disabledTooltip: String(p.tooltip) } : {}),
+    ...(p.to ? { to: p.to as DropdownItemProps['to'] } : {}),
+    ...(p.href ? { href: String(p.href) } : {}),
+    ...(p.exact !== undefined ? { exact: lerBooleano(p.exact) } : {}),
+    ...(clique ? { onClick: clique } : {}),
+  }
+}
+
+/** Avisa uma vez por motivo — o computed reavalia a cada update do host. */
+const jaAvisado = new Set<string>()
+
+function avisar(motivo: string): void {
+  if (!import.meta.env.DEV) return
+  if (jaAvisado.has(motivo)) return
+  jaAvisado.add(motivo)
+  console.warn(
+    `[acai-ui-actions] ${motivo} Essa ação continua no cabeçalho em vez de entrar ` +
+      `no menu "Ações" do celular.`,
+  )
+}
+
+/**
+ * Chamar `slots.default()` DENTRO do computed é o que mantém isto reativo: a
+ * chamada registra no computed as dependências que o host lê ao renderizar o
+ * slot, então um `v-if` do consumidor sobre uma ação reavalia a lista. É o
+ * mesmo mecanismo do `<acai-ui-tabs>`.
+ */
+const analise = computed<{ itens: DropdownItemProps[]; soltos: VNode[] }>(() => {
+  const itens: DropdownItemProps[] = []
+  const soltos: VNode[] = []
+
+  for (const v of achatarSlot(slots.default?.())) {
+    if (!ehBotaoAcai(v)) {
+      soltos.push(v)
+      avisar('Só <acai-ui-button> vira item de menu — o slot #actions recebeu outra coisa.')
+      continue
+    }
+
+    const item = converter(v)
+    if (item === null) {
+      soltos.push(v)
+      avisar('<acai-ui-button> sem `label`, `aria-label` nem `tooltip`: não há texto pro item.')
+      continue
+    }
+
+    itens.push(item)
+  }
+
+  return { itens, soltos }
+})
+
+const itens = computed(() => analise.value.itens)
+const soltos = computed(() => analise.value.soltos)
+</script>

package/src/components/async-select/acai-ui-async-select-interface.ts

@@ -0,0 +1,49 @@
+import type { MaterialIconValues } from '../../constants/lista-icons'
+
+/** Acessor de um campo do item: chave do objeto (string) ou função `(item) => string`. */
+export type OptionAccessor<T> = keyof T | ((item: T) => string)
+
+export interface AsyncSelectProps<T = Record<string, unknown>> {
+  /**
+   * Função de busca. Recebe o termo digitado e retorna os itens. O componente
+   * cuida de debounce, loading e do popup de resultados. Pode ser async.
+   */
+  search: (term: string) => Promise<T[]> | T[]
+  /**
+   * Como exibir o item selecionado no campo (e como rótulo de cada linha da lista).
+   * Chave do objeto ou função. Ex.: `'nome'` ou `(p) => p.pessoal?.nome ?? ''`.
+   */
+  optionLabel?: OptionAccessor<T>
+  /** Legenda secundária (caption) de cada item na lista. Chave ou função. */
+  optionCaption?: OptionAccessor<T>
+  /** Chave única do item (para `:key` da lista). Chave ou função. Default: `'id'`. */
+  optionKey?: OptionAccessor<T>
+  /** Rótulo do campo. */
+  label?: string
+  /** Dica abaixo do campo. */
+  hint?: string
+  placeholder?: string
+  /** Ícone à direita do campo. Default: `'search'`. */
+  iconRight?: MaterialIconValues
+  disable?: boolean
+  readonly?: boolean
+  dense?: boolean
+  outlined?: boolean
+  filled?: boolean
+  clearable?: boolean
+  required?: boolean
+  /** Mensagem de erro externa (ex.: validação do form). Tem prioridade sobre a interna. */
+  errorMessage?: string | null
+  /** Loading externo (combina com o loading interno da busca). */
+  loading?: boolean
+  /** Debounce da busca, em ms. Default: `500`. */
+  debounce?: number
+  /** Mínimo de caracteres para disparar a busca. Default: `1`. */
+  minChars?: number
+  /** Se a busca retornar exatamente 1 item, seleciona-o automaticamente. Default: `false`. */
+  autoSelectSingle?: boolean
+  /** Texto do estado "nenhum resultado". Default: `'Nenhum resultado'`. */
+  emptyLabel?: string
+  /** Altura máxima do popup (qualquer unidade CSS). Default: `'260px'`. */
+  popupMaxHeight?: string
+}