acai-ui 1.65.5

package/src/components/drawer/drawer-sidebar-helper.ts

@@ -0,0 +1,117 @@
+import type { SidebarRouteConfig, SidebarGroup, SidebarLeaf } from './acai-ui-drawer-interface'
+
+const isGroup = (n: SidebarRouteConfig): n is SidebarGroup => 'children' in n
+const isLeaf = (n: SidebarRouteConfig): n is SidebarLeaf => 'name' in n
+
+function collectNamesInGroups(items: SidebarRouteConfig[]): Set<string> {
+  const names = new Set<string>()
+  for (const item of items) {
+    if (isGroup(item)) {
+      for (const child of item.children) {
+        if (isLeaf(child)) names.add(child.name)
+        if (isGroup(child)) {
+          for (const sub of child.children) {
+            if (isLeaf(sub)) names.add(sub.name)
+          }
+        }
+      }
+    }
+  }
+  return names
+}
+
+function processGroupChildren(children: SidebarRouteConfig[]): SidebarRouteConfig[] {
+  const result: SidebarRouteConfig[] = []
+
+  for (const child of children) {
+    if (isGroup(child)) {
+      if (child.children.length === 0) continue
+      // Grupo de 1 filho é achatado, EXCETO se pediu keepExpansion
+      if (child.children.length === 1 && !child.keepExpansion) {
+        const sub = child.children[0]
+        if (sub && isLeaf(sub)) {
+          result.push(sub)
+          continue
+        }
+      }
+      result.push(child)
+      continue
+    }
+    result.push(child)
+  }
+
+  return result
+}
+
+export function processarSidebar(items: SidebarRouteConfig[]): SidebarRouteConfig[] {
+  const namesInGroups = collectNamesInGroups(items)
+  const result: SidebarRouteConfig[] = []
+
+  for (const item of items) {
+    if (isLeaf(item) && namesInGroups.has(item.name)) {
+      continue
+    }
+
+    if (isGroup(item)) {
+      const processedChildren = processGroupChildren(item.children)
+      if (processedChildren.length === 0) continue
+
+      // Grupo de 1 filho é achatado, EXCETO se pediu keepExpansion
+      if (processedChildren.length === 1 && !item.keepExpansion) {
+        const child = processedChildren[0]
+        if (child && isLeaf(child)) {
+          const icon = child.icon ?? item.iconExpansion
+          result.push(icon ? { ...child, icon } : child)
+          continue
+        }
+      }
+
+      result.push({ ...item, children: processedChildren })
+      continue
+    }
+
+    result.push(item)
+  }
+
+  return result
+}
+
+export function filtrarPorPerfil(
+  items: SidebarRouteConfig[],
+  userProfiles: readonly string[],
+  userWeight: number,
+): SidebarRouteConfig[] {
+  return items
+    .map((item) => {
+      if (isGroup(item)) {
+        if (item.profiles?.length && !hasPermission(userProfiles, item.profiles)) return null
+        if (!passesWeightFilter(item, userWeight)) return null
+        const filteredChildren = filtrarPorPerfil(item.children, userProfiles, userWeight)
+        if (filteredChildren.length === 0) return null
+        return { ...item, children: filteredChildren }
+      }
+
+      if (isLeaf(item)) {
+        if (item.hideForProfiles?.length && hasPermission(userProfiles, item.hideForProfiles)) return null
+        if (item.profiles?.length && !hasPermission(userProfiles, item.profiles)) return null
+        if (!passesWeightFilter(item, userWeight)) return null
+      }
+
+      return item
+    })
+    .filter((n): n is SidebarRouteConfig => n !== null)
+}
+
+function hasPermission(userProfiles: readonly string[], requiredProfiles: readonly string[]): boolean {
+  if (requiredProfiles.length === 0) return true
+  return requiredProfiles.some((p) => userProfiles.includes(p))
+}
+
+function passesWeightFilter(item: SidebarRouteConfig, userWeight: number): boolean {
+  if (!('minWeight' in item) && !('maxWeight' in item)) return true
+  const min = (item as { minWeight?: number }).minWeight
+  const max = (item as { maxWeight?: number }).maxWeight
+  if (min !== undefined && userWeight < min) return false
+  if (max !== undefined && userWeight > max) return false
+  return true
+}

package/src/components/dropdown/acai-ui-dropdown-interface.ts

@@ -0,0 +1,41 @@
+import type { QItemProps, QBtnDropdown } from 'quasar'
+import type { MaterialIconValues } from '../../constants/lista-icons'
+
+export type DropdownItemProps = Pick<QItemProps, 'exact' | 'href' | 'onClick' | 'to' | 'active'> & {
+  id?: string | number
+  label: string
+  icon?: MaterialIconValues
+  disabled?: boolean
+  caption?: string
+  disabledTooltip?: string
+  color?: string
+}
+
+export interface DropdownProps {
+  label?: QBtnDropdown['label']
+  color?: QBtnDropdown['color']
+  items?: DropdownItemProps[]
+  /** Ícone do botão de abrir o dropdown. Default `more_vert`. Ignorado quando `tableStyle` (força `more_vert`). */
+  dropdownIcon?: MaterialIconValues
+  /**
+   * Anima o ícone ao abrir/fechar. Default `true`. Ignorado quando `tableStyle` (força `false`).
+   *
+   * O `| undefined` é OBRIGATÓRIO: o `withDefaults` passa `animation: undefined`
+   * para desligar o boolean casting do Vue, e sob `exactOptionalPropertyTypes`
+   * (que os consumidores usam) `animation?: boolean` significa "ausente OU
+   * boolean" — `undefined` não é nenhum dos dois. Props herdadas do Quasar já
+   * trazem o `| undefined`; as declaradas aqui precisam escrever à mão.
+   */
+  animation?: boolean | undefined
+  flat?: boolean
+  outline?: boolean
+  disable?: boolean
+  // `| undefined` pelo mesmo motivo do `animation` acima: sob
+  // `exactOptionalPropertyTypes` (que os consumidores usam) `buttonClass?:
+  // string` significa "ausente OU string", e `undefined` não é nenhum dos dois.
+  // Quem repassa uma prop opcional própria — o <acai-ui-actions>, por exemplo —
+  // entrega `string | undefined` e o typecheck quebrava no repasse.
+  buttonClass?: string | undefined
+  dense?: boolean | undefined
+  tableStyle?: boolean
+}

package/src/components/dropdown/acai-ui-dropdown-item.vue

@@ -0,0 +1,36 @@
+<template>
+  <q-item
+    :active="active || exact"
+    :disable="disabled"
+    :exact="exact"
+    :href="href"
+    :to="to"
+    clickable
+    v-close-popup
+    class="ds-dropdown__item"
+    @click="onClick"
+  >
+    <!-- Sem cor: ícone e label herdam o currentColor do item (--acai-text, que
+         adapta ao tema). Com `color`: aplica a brand color (ex.: negative). -->
+    <q-item-section v-if="icon" side>
+      <acai-ui-icon :name="icon" size="18px" :color="color" />
+    </q-item-section>
+    <q-item-section>
+      <q-item-label :class="color ? `text-${color}` : undefined">
+        <slot>{{ label }}</slot>
+      </q-item-label>
+      <q-item-label v-if="caption" caption class="ds-dropdown__caption">{{ caption }}</q-item-label>
+    </q-item-section>
+    <acai-ui-tooltip v-if="disabled && disabledTooltip">
+      {{ disabledTooltip }}
+    </acai-ui-tooltip>
+  </q-item>
+</template>
+
+<script setup lang="ts">
+import type { DropdownItemProps } from './acai-ui-dropdown-interface'
+import AcaiUiTooltip from '../tooltip/acai-ui-tooltip.vue'
+import AcaiUiIcon from '../icon/acai-ui-icon.vue'
+
+defineProps<DropdownItemProps>()
+</script>

package/src/components/dropdown/acai-ui-dropdown-styles.scss

@@ -0,0 +1,90 @@
+// Import explícito porque consumidores via source (docs, sandbox, etc.) não
+// têm o additionalData do vite.config.ts da lib — esse so funciona pro build interno.
+@import '../../scss/controls';
+
+// Estilo do botão de abrir o dropdown — herda dos mixins centralizados
+// em scss/_controls.scss (alinhado com AcaiUiButton size md).
+.ds-dropdown {
+  &.q-btn-dropdown {
+    @include control-base;
+    @include control-md;
+  }
+
+  // Em modo flat/dense (table-style) reseta para o look discreto de tabela
+  &.q-btn-dropdown.q-btn--dense.q-btn--flat {
+    min-height: unset;
+    padding: 4px 6px !important;
+    border: 0;
+
+    // Ícone more_vert (3 pontinhos): o color="grey-8" fixo do modo tabela some
+    // sobre a linha escura no dark. --acai-text-muted flipa (cinza no claro,
+    // claro no escuro); !important vence a classe text-grey-8 do Quasar.
+    color: var(--acai-text-muted, #{$color-gray-600}) !important;
+
+    .q-btn-dropdown__arrow,
+    .q-icon {
+      color: var(--acai-text-muted, #{$color-gray-600}) !important;
+    }
+  }
+
+  .q-btn-dropdown__arrow {
+    font-size: 1.125rem;
+  }
+
+  // Reset Quasar hover overlay (mesmo do AcaiUiButton).
+  // Bloco global (não-scoped, pois o menu é teleportado): seletor direto,
+  // sem :deep() — que aqui seria inválido e vaza warning no lightningcss.
+  .q-focus-helper {
+    display: none;
+  }
+}
+
+.ds-dropdown__list {
+  background: var(--acai-surface, #{$color-white-100});
+  border: 1px solid var(--acai-border, #{$color-gray-300});
+  border-radius: $radius-md;
+  min-width: 160px;
+  padding: $spacing-2xs 0;
+  box-shadow: $shadow-md;
+}
+
+.ds-dropdown__item {
+  min-height: 36px;
+  padding: $spacing-xs $spacing-md;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  color: var(--acai-text, #{$color-gray-800});
+  transition: background 150ms ease;
+
+  &:hover {
+    background: var(--acai-surface-hover, #{$color-gray-50});
+  }
+
+  &.q-item--active {
+    background: var(--acai-item-hover-bg, #{$color-primary-50});
+    color: var(--acai-item-hover-text, #{$primary});
+  }
+
+  .q-item__section--side {
+    min-width: 24px;
+    padding-right: $spacing-sm;
+  }
+
+  // Itens SEM cor própria caem nas classes utilitárias grey do Quasar
+  // (text-grey-9 no label, text-grey-6 no caption, text-grey-8 no ícone),
+  // que trazem `!important` e um tom FIXO. No dark, sobre --acai-surface
+  // escuro, esse texto/ícone somem. Reaponta só os greys default pros tokens
+  // de texto (claro segue o mesmo tom via fallback); cores por-item
+  // (item.color → text-negative, etc.) ficam intactas.
+  .q-item__label.text-grey-9 {
+    color: var(--acai-text, #{$color-gray-800}) !important;
+  }
+
+  .q-item__label.text-grey-6 {
+    color: var(--acai-text-muted, #{$color-gray-600}) !important;
+  }
+
+  .q-icon.text-grey-8 {
+    color: var(--acai-text-muted, #{$color-gray-600}) !important;
+  }
+}

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

@@ -0,0 +1,77 @@
+<template>
+  <q-btn-dropdown
+    :label="label"
+    :class="['ds-dropdown', buttonClass]"
+    :flat="flatComputed"
+    :outline="outline"
+    :disable="disable"
+    :dense="denseComputed"
+    :dropdown-icon="dropdownIconComputed"
+    :no-icon-animation="!animationComputed"
+    :color="colorComputed"
+    unelevated
+  >
+    <q-list class="ds-dropdown__list">
+      <template v-for="(item, idx) in items" :key="item.id ?? idx">
+        <q-item
+          :exact="item.exact"
+          :href="item.href"
+          :to="item.to"
+          :disable="item.disabled"
+          clickable
+          v-close-popup
+          class="ds-dropdown__item"
+          @click="item.onClick"
+        >
+          <q-item-section v-if="item.icon" side>
+            <acai-ui-icon :name="item.icon" size="18px" :color="item.color ?? 'grey-8'" />
+          </q-item-section>
+          <q-item-section>
+            <q-item-label :class="item.color ? `text-${item.color}` : 'text-grey-9'">{{ item.label }}</q-item-label>
+            <q-item-label v-if="item.caption" caption class="text-grey-6">{{ item.caption }}</q-item-label>
+          </q-item-section>
+          <acai-ui-tooltip v-if="item.disabled && item.disabledTooltip">
+            {{ item.disabledTooltip }}
+          </acai-ui-tooltip>
+        </q-item>
+        <q-separator v-if="idx < (items?.length ?? 0) - 1" />
+      </template>
+      <slot />
+    </q-list>
+  </q-btn-dropdown>
+</template>
+
+<script lang="ts" setup>
+import { computed } from 'vue'
+import type { DropdownProps } from './acai-ui-dropdown-interface'
+import AcaiUiTooltip from '../tooltip/acai-ui-tooltip.vue'
+import AcaiUiIcon from '../icon/acai-ui-icon.vue'
+
+defineOptions({ inheritAttrs: false })
+
+const props = withDefaults(defineProps<DropdownProps>(), {
+  items: () => [],
+  tableStyle: false,
+  // `undefined` explícito DESLIGA o boolean casting do Vue (prop booleana ausente
+  // vira `false`, não `undefined`). Sem isto o `?? true` do animationComputed
+  // nunca dispara — `false ?? true` devolve `false` — e o default documentado
+  // (animar) ficava inalcançável: só animava quem passasse `:animation="true"`.
+  animation: undefined,
+})
+
+const flatComputed = computed(() => props.tableStyle || (props.flat ?? false))
+const denseComputed = computed(() => props.tableStyle || (props.dense ?? false))
+const colorComputed = computed(() => props.tableStyle ? 'grey-8' : (props.color ?? 'primary'))
+// tableStyle força animation=false (padrão de tabela: ícone estático)
+const animationComputed = computed(() => props.tableStyle ? false : (props.animation ?? true))
+// tableStyle força more_vert (3 pontinhos verticais, padrão de ação de linha).
+// Fora de tableStyle (dropdown COM label, ex: "Ações") o padrão é a setinha do
+// dropdown — 3 pontinhos num botão rotulado não faz sentido.
+const dropdownIconComputed = computed(() =>
+  props.tableStyle ? 'more_vert' : (props.dropdownIcon ?? 'arrow_drop_down'),
+)
+</script>
+
+<style lang="scss">
+@import './acai-ui-dropdown-styles.scss';
+</style>

package/src/components/error-log/acai-ui-error-log-interface.ts

@@ -0,0 +1,59 @@
+/**
+ * Shape mínimo de um erro de requisição. É estruturalmente compatível com
+ * `AxiosError`, mas declarado aqui para a lib NÃO depender de axios.
+ * Um `AxiosError` pode ser passado direto na prop `error`.
+ */
+export interface ErroRequisicaoLike {
+  message?: string
+  code?: string
+  response?: {
+    status?: number
+    data?: unknown
+    headers?: unknown
+  }
+  config?: {
+    baseURL?: string
+    url?: string
+    method?: string
+    params?: unknown
+    data?: unknown
+  }
+}
+
+export interface ErrorLogProps {
+  /** Erro da requisição (compatível com `AxiosError`). */
+  error?: ErroRequisicaoLike | null
+  /**
+   * Título manual. Quando há `response.status` mapeado, o título amigável por
+   * status tem prioridade sobre este.
+   */
+  titulo?: string
+  /**
+   * Mensagem já resolvida pelo consumidor. Tem prioridade sobre TUDO que o
+   * componente extrairia do `error`.
+   *
+   * Ponto de extensão para regra de domínio que a lib não pode conhecer — o
+   * gestao, por exemplo, escolhe a mensagem pelo `tipo` do `ApiErroDto` e
+   * monta a lista de serviços fora do ar do `ApiErroIndisponibilidadelDto`.
+   * String vazia é ignorada (cai no fluxo normal), então um `computed` que
+   * às vezes não resolve nada pode ser passado direto.
+   */
+  mensagem?: string
+  /**
+   * Libera o bloco "Detalhes técnicos". Default: `import.meta.env.DEV`.
+   *
+   * Existe porque nem todo consumidor decide isso em build-time: o gestao usa
+   * `EH_DESENVOLVIMENTO`, derivado da env `AMBIENTE` em RUNTIME, e precisa dos
+   * detalhes num build de produção apontado para o ambiente de desenvolvimento.
+   */
+  ehDesenvolvimento?: boolean
+  /**
+   * Chaves ADICIONAIS a ocultar nos detalhes técnicos, além das que a lib já
+   * cobre (authorization, senha, password, token, secret, apiKey, cookie…).
+   *
+   * A comparação ignora caixa e separadores — `chave_acesso`, `chave-acesso` e
+   * `chaveAcesso` são a mesma coisa. Use para segredo com nome de domínio que
+   * a lib não teria como adivinhar.
+   */
+  camposSensiveis?: string[]
+}