@wgalleti/primevue-components 2.0.1 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/components/charts/WChart.vue.d.ts +1 -1
  2. package/dist/components/crud/WCrudView.vue.d.ts +19 -18
  3. package/dist/components/crud/WEditableTable.vue.d.ts +31 -18
  4. package/dist/components/form/WAutoCompleteFK.vue.d.ts +2 -2
  5. package/dist/components/form/WDatePicker.vue.d.ts +1 -1
  6. package/dist/components/form/WDateRange.vue.d.ts +1 -1
  7. package/dist/components/form/WFileUpload.vue.d.ts +1 -1
  8. package/dist/components/form/WFormRenderer.vue.d.ts +4 -4
  9. package/dist/components/form/WImageCropper.vue.d.ts +2 -2
  10. package/dist/components/form/WMoneyInput.vue.d.ts +4 -0
  11. package/dist/components/form/WTreeSelect.vue.d.ts +3 -3
  12. package/dist/components/index.d.ts +7 -0
  13. package/dist/components/ui/WAvatar.vue.d.ts +1 -1
  14. package/dist/components/ui/WButton.vue.d.ts +45 -0
  15. package/dist/components/ui/WEmptyState.vue.d.ts +1 -1
  16. package/dist/components/ui/WGroupedSelectList.vue.d.ts +20 -5
  17. package/dist/components/ui/WKpiGrid.vue.d.ts +1 -1
  18. package/dist/components/ui/WMapSelect.vue.d.ts +2 -2
  19. package/dist/components/ui/WMenu.vue.d.ts +28 -0
  20. package/dist/components/ui/WNotice.vue.d.ts +32 -0
  21. package/dist/components/ui/WPermissionMatrix.vue.d.ts +64 -0
  22. package/dist/components/ui/WPopover.vue.d.ts +20 -0
  23. package/dist/components/ui/WProgress.vue.d.ts +16 -0
  24. package/dist/components/ui/WSectionAccordion.vue.d.ts +1 -1
  25. package/dist/components/ui/WSegmented.vue.d.ts +36 -0
  26. package/dist/components/ui/WSkeleton.vue.d.ts +14 -3
  27. package/dist/components/ui/WStatusTag.vue.d.ts +9 -1
  28. package/dist/components/ui/WStepFlow.vue.d.ts +1 -1
  29. package/dist/components-64mrDK9F.cjs +25 -0
  30. package/dist/components-64mrDK9F.cjs.map +1 -0
  31. package/dist/components-DhBXIjIY.js +10299 -0
  32. package/dist/components-DhBXIjIY.js.map +1 -0
  33. package/dist/components.cjs +1 -1
  34. package/dist/components.js +1 -1
  35. package/dist/{composables-B2_3FVLB.js → composables-DbmYTwL7.js} +3 -2
  36. package/dist/composables-DbmYTwL7.js.map +1 -0
  37. package/dist/composables-rF6oNCGV.cjs +2 -0
  38. package/dist/composables-rF6oNCGV.cjs.map +1 -0
  39. package/dist/composables.cjs +1 -1
  40. package/dist/composables.js +1 -1
  41. package/dist/connect.cjs +1 -1
  42. package/dist/connect.cjs.map +1 -1
  43. package/dist/connect.js +1 -1
  44. package/dist/connect.js.map +1 -1
  45. package/dist/index.cjs +1 -1
  46. package/dist/index.cjs.map +1 -1
  47. package/dist/index.d.ts +3 -2
  48. package/dist/index.js +29 -28
  49. package/dist/index.js.map +1 -1
  50. package/dist/primevue-components.css +1 -1
  51. package/dist/routeTabs-BnVpnSeJ.cjs.map +1 -1
  52. package/dist/routeTabs-C86S8jNU.js.map +1 -1
  53. package/dist/types/action.d.ts +12 -0
  54. package/dist/types/button.d.ts +10 -0
  55. package/dist/types/field.d.ts +31 -3
  56. package/dist/types/index.d.ts +3 -1
  57. package/dist/types/manager.d.ts +5 -2
  58. package/dist/types/permissionMatrix.d.ts +9 -0
  59. package/dist/types/plugin.d.ts +7 -0
  60. package/dist/utils/tabOverlay.d.ts +20 -0
  61. package/dist/utils/warnOnce.d.ts +4 -0
  62. package/package.json +1 -1
  63. package/dist/components-BrB2KsHr.js +0 -9399
  64. package/dist/components-BrB2KsHr.js.map +0 -1
  65. package/dist/components-DfgWnHbO.cjs +0 -25
  66. package/dist/components-DfgWnHbO.cjs.map +0 -1
  67. package/dist/composables-B2_3FVLB.js.map +0 -1
  68. package/dist/composables-qoAinVWS.cjs +0 -2
  69. package/dist/composables-qoAinVWS.cjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"routeTabs-BnVpnSeJ.cjs","names":["inject","vue","W_AXIOS_KEY","W_DATA_PROVIDER_KEY","W_CONFIG_KEY","W_TAB_HOST_KEY","useTabHost"],"sources":["../src/types/plugin.ts","../src/types/routeTabs.ts"],"sourcesContent":["import type { AxiosInstance } from 'axios'\nimport type { DataProvider } from './dataProvider'\n\nexport interface WPluginOptions {\n axios?: AxiosInstance\n dataProvider?: DataProvider\n defaultPageSize?: number\n dateFormat?: string\n dateTimeFormat?: string\n locale?: string\n currency?: string\n registerComponents?: boolean\n /**\n * Corrige o `Dialog`/`Drawer` do PrimeVue 4 para o Esc fechar só o overlay\n * do topo (nativo fecha todos os empilhados). Default: `true`.\n */\n patchDialogEscape?: boolean\n /**\n * Padrão do app para a navegação por teclado no formulário do CRUD (foca o 1º campo, Enter\n * avança). A tela que declara `keyboardNav` no `useCrudManager` vence. Default: `false`.\n */\n keyboardNav?: boolean\n}\n\nexport interface WPluginConfig {\n axios?: AxiosInstance\n dataProvider: DataProvider\n defaultPageSize: number\n dateFormat: string\n dateTimeFormat: string\n locale: string\n currency: string\n keyboardNav: boolean\n}\n\nexport const W_AXIOS_KEY = Symbol('w-axios')\nexport const W_DATA_PROVIDER_KEY = Symbol('w-data-provider')\nexport const W_CONFIG_KEY = Symbol('w-config')\n","import { inject, type Component, type InjectionKey, type Ref } from 'vue'\nimport type { RouteLocationNormalizedLoaded, Router } from 'vue-router'\n\n/**\n * Navegação por abas (estilo browser/ERP): cada rota vira uma aba viva, com\n * fechar/recarregar e estado preservado ao alternar. O estado mora no\n * composable `useRouteTabs`; `WTabNav` (barra) e `WTabViewport` (painéis)\n * apenas o recebem via prop — nenhum componente guarda estado global.\n */\n\n/** Meta de apresentação de uma aba, resolvida a partir da rota. */\nexport interface RouteTabMeta {\n title: string\n /** Ícone PrimeIcons (ex.: 'pi pi-file'). */\n icon?: string\n /** `false` esconde o X e ignora fechar (ex.: dashboard fixo). */\n closable?: boolean\n /**\n * Grupo da aba (ex.: o módulo do menu — \"Sementes\", \"Estoque\"). Abas do\n * mesmo grupo ficam juntas na barra, com o rótulo do grupo antes do bloco.\n */\n group?: string\n /**\n * Cor do grupo (qualquer cor CSS). Sem ela, o WTabNav deriva uma cor estável\n * do nome do grupo — informe só para fixar a cor de um módulo.\n */\n color?: string\n}\n\n/** Uma aba aberta. `key` identifica (path com params); `fullPath` navega. */\nexport interface RouteTab {\n key: string\n /** Último fullPath visitado (query inclusa) — usado no push e no restore. */\n fullPath: string\n title: string\n icon?: string\n closable: boolean\n /** Grupo (módulo) da aba — abas do mesmo grupo ficam contíguas na barra. */\n group?: string\n /** Cor do grupo fixada pela rota (`RouteTabMeta.color`); ausente = derivada. */\n color?: string\n /**\n * `false` = aba restaurada do storage, ainda sem componente montado.\n * Hidrata na primeira ativação (o router resolve o lazy no caminho).\n */\n hydrated: boolean\n /** Contador de remontagem: `reload()` incrementa e o pane troca o `:key`. */\n remount: number\n}\n\n/**\n * Lado não serializável de uma aba hidratada — componente resolvido, snapshot\n * de rota e os registros feitos pela tela via `useTabHost`. Consumido pelo\n * WTabViewport; não persiste.\n */\nexport interface RouteTabRuntime {\n component: Component | null\n props: Record<string, unknown>\n /**\n * Snapshot reativo da rota, provido ao pane sob a `routeLocationKey` do\n * vue-router: `useRoute()` da tela enxerga ESTA rota, congelada — só é\n * atualizada quando a aba é a ativa. É o que impede um pane oculto de\n * reagir à navegação global (o bug clássico de sistemas de abas).\n */\n route: RouteLocationNormalizedLoaded\n closeGuards: Array<() => boolean | Promise<boolean>>\n activatedHooks: Array<() => void>\n deactivatedHooks: Array<() => void>\n /** Título default da rota, para `setTitle(null)` restaurar. */\n defaultTitle: string\n}\n\nexport interface UseRouteTabsOptions {\n router: Router\n /**\n * Modo de uso — o parâmetro que define o que é \"uma aba\":\n * - `'screen'` (default): cada tela é uma aba. Identidade = `route.path`\n * (params contam, query não): NF 123 e NF 456 são abas distintas.\n * - `'module'`: uma aba por entrada de menu. Identidade = `moduleRoot(route)`;\n * navegar entre telas do mesmo módulo acontece DENTRO da aba (a view\n * remonta, título/ícone voltam aos da rota nova e os close guards valem\n * também nessa troca).\n */\n mode?: 'screen' | 'module'\n /**\n * Raiz do módulo da rota (ex.: path da listagem) — identidade da aba no modo\n * `'module'`. Obrigatório nesse modo; retornar falsy cai em `route.path`.\n */\n moduleRoot?: (route: RouteLocationNormalizedLoaded) => string | null | undefined\n /**\n * Modo `'module'`: trocar de path dentro da aba remonta a view. Devolva `false`\n * para uma troca que é a MESMA tela mudando de identidade — o caso clássico é\n * `/pedidos/novo` → `/pedidos/<id>` quando o rascunho nasce: a view fica viva e\n * recebe os `props` novos, sem remontar, sem animação de entrada, sem reler o\n * documento. Default: sempre remonta.\n */\n shouldRemount?: (\n from: RouteLocationNormalizedLoaded,\n to: RouteLocationNormalizedLoaded,\n ) => boolean\n /** Título/ícone/closable da aba. O que faltar cai em defaults sensatos. */\n resolveTabMeta?: (route: RouteLocationNormalizedLoaded) => Partial<RouteTabMeta>\n /** Quais rotas viram aba. Default: todas. */\n isTabRoute?: (route: RouteLocationNormalizedLoaded) => boolean\n /** Onde persistir. Default: `localStorage`; `null` desliga a persistência. */\n storage?: Storage | null\n /** Chave no storage. Função permite chave por usuário avaliada tarde. */\n storageKey?: string | (() => string)\n /** Destino ao fechar a última aba. Default: `/`. */\n homePath?: string\n /** Acima disso, a aba mais antiga não-ativa é fechada (guards respeitados). */\n maxTabs?: number\n}\n\nexport interface RouteTabsApi {\n tabs: Ref<RouteTab[]>\n activeKey: Ref<string | null>\n /** Ativa a aba (navega para o fullPath dela). */\n activate: (key: string) => Promise<void>\n /** Fecha respeitando os close guards da aba. `false` = algum guard vetou. */\n close: (key: string) => Promise<boolean>\n closeOthers: (key: string) => Promise<void>\n closeAll: () => Promise<void>\n /** Remonta o componente da aba (o estado da tela é descartado). */\n reload: (key: string) => void\n /** Título dinâmico (\"NF 000123\"). `null` volta ao título default da rota. */\n setTitle: (key: string, title: string | null | undefined) => void\n /** A rota já tem aba hidratada? (ex.: para pular overlay de navegação). */\n isLive: (target: RouteLocationNormalizedLoaded | string) => boolean\n /** Runtime interno da aba. Uso do WTabViewport; não persiste. */\n runtime: (key: string) => RouteTabRuntime | undefined\n}\n\n/**\n * Contexto que o pane fornece à tela (e aos dialogs dela). Injete com\n * `useTabHost()` — fora de abas retorna `null` e tudo degrada para o\n * comportamento padrão (dialog no body, título no breadcrumb etc.).\n */\nexport interface TabHostContext {\n /** Container do pane — alvo de `appendTo` para o dialog viver NA aba. */\n hostEl: Ref<HTMLElement | null>\n active: Ref<boolean>\n /** Título dinâmico da aba; `null` restaura o default da rota. */\n setTitle: (title: string | null | undefined) => void\n /** Chamado ao voltar para a aba (equivalente a onActivated). */\n onTabActivated: (fn: () => void) => void\n /** Chamado ao sair da aba (equivalente a onDeactivated). */\n onTabDeactivated: (fn: () => void) => void\n /** Veta o fechar da aba (ex.: alterações não salvas). `false` = não fecha. */\n registerCloseGuard: (guard: () => boolean | Promise<boolean>) => void\n}\n\nexport const W_TAB_HOST_KEY: InjectionKey<TabHostContext> = Symbol('w-tab-host')\n\n/** Contexto da aba que envolve o componente atual, ou `null` fora de abas. */\nexport function useTabHost(): TabHostContext | null {\n return inject(W_TAB_HOST_KEY, null)\n}\n"],"mappings":"A,qBAmCA,IAAaE,EAAc,OAAO,SAAS,EAC9BC,EAAsB,OAAO,iBAAiB,EAC9CC,EAAe,OAAO,UAAU,ECmHhCC,EAA+C,OAAO,YAAY,EAG/E,SAAgBC,GAAoC,CAClD,OAAA,EAAON,EAAAA,OAAAA,CAAOK,EAAgB,IAAI,CACpC,C"}
1
+ {"version":3,"file":"routeTabs-BnVpnSeJ.cjs","names":["inject","vue","W_AXIOS_KEY","W_DATA_PROVIDER_KEY","W_CONFIG_KEY","W_TAB_HOST_KEY","useTabHost"],"sources":["../src/types/plugin.ts","../src/types/routeTabs.ts"],"sourcesContent":["import type { AxiosInstance } from 'axios'\nimport type { DataProvider } from './dataProvider'\nimport type { CepLookup } from './field'\n\nexport interface WPluginOptions {\n axios?: AxiosInstance\n dataProvider?: DataProvider\n defaultPageSize?: number\n dateFormat?: string\n dateTimeFormat?: string\n locale?: string\n currency?: string\n registerComponents?: boolean\n /**\n * Corrige o `Dialog`/`Drawer` do PrimeVue 4 para o Esc fechar só o overlay\n * do topo (nativo fecha todos os empilhados). Default: `true`.\n */\n patchDialogEscape?: boolean\n /**\n * Padrão do app para a navegação por teclado no formulário do CRUD (foca o 1º campo, Enter\n * avança). A tela que declara `keyboardNav` no `useCrudManager` vence. Default: `false`.\n */\n keyboardNav?: boolean\n /**\n * Consulta de CEP dos campos `type: 'cep'` (ex.: um endpoint da própria API). O campo pode\n * trocar a sua com `FieldDef.cepLookup`. Default: ViaCEP direto do navegador.\n */\n cepLookup?: CepLookup\n}\n\nexport interface WPluginConfig {\n axios?: AxiosInstance\n dataProvider: DataProvider\n defaultPageSize: number\n dateFormat: string\n dateTimeFormat: string\n locale: string\n currency: string\n keyboardNav: boolean\n cepLookup: CepLookup\n}\n\nexport const W_AXIOS_KEY = Symbol('w-axios')\nexport const W_DATA_PROVIDER_KEY = Symbol('w-data-provider')\nexport const W_CONFIG_KEY = Symbol('w-config')\n","import { inject, type Component, type InjectionKey, type Ref } from 'vue'\nimport type { RouteLocationNormalizedLoaded, Router } from 'vue-router'\n\n/**\n * Navegação por abas (estilo browser/ERP): cada rota vira uma aba viva, com\n * fechar/recarregar e estado preservado ao alternar. O estado mora no\n * composable `useRouteTabs`; `WTabNav` (barra) e `WTabViewport` (painéis)\n * apenas o recebem via prop — nenhum componente guarda estado global.\n */\n\n/** Meta de apresentação de uma aba, resolvida a partir da rota. */\nexport interface RouteTabMeta {\n title: string\n /** Ícone PrimeIcons (ex.: 'pi pi-file'). */\n icon?: string\n /** `false` esconde o X e ignora fechar (ex.: dashboard fixo). */\n closable?: boolean\n /**\n * Grupo da aba (ex.: o módulo do menu — \"Sementes\", \"Estoque\"). Abas do\n * mesmo grupo ficam juntas na barra, com o rótulo do grupo antes do bloco.\n */\n group?: string\n /**\n * Cor do grupo (qualquer cor CSS). Sem ela, o WTabNav deriva uma cor estável\n * do nome do grupo — informe só para fixar a cor de um módulo.\n */\n color?: string\n}\n\n/** Uma aba aberta. `key` identifica (path com params); `fullPath` navega. */\nexport interface RouteTab {\n key: string\n /** Último fullPath visitado (query inclusa) — usado no push e no restore. */\n fullPath: string\n title: string\n icon?: string\n closable: boolean\n /** Grupo (módulo) da aba — abas do mesmo grupo ficam contíguas na barra. */\n group?: string\n /** Cor do grupo fixada pela rota (`RouteTabMeta.color`); ausente = derivada. */\n color?: string\n /**\n * `false` = aba restaurada do storage, ainda sem componente montado.\n * Hidrata na primeira ativação (o router resolve o lazy no caminho).\n */\n hydrated: boolean\n /** Contador de remontagem: `reload()` incrementa e o pane troca o `:key`. */\n remount: number\n}\n\n/**\n * Lado não serializável de uma aba hidratada — componente resolvido, snapshot\n * de rota e os registros feitos pela tela via `useTabHost`. Consumido pelo\n * WTabViewport; não persiste.\n */\nexport interface RouteTabRuntime {\n component: Component | null\n props: Record<string, unknown>\n /**\n * Snapshot reativo da rota, provido ao pane sob a `routeLocationKey` do\n * vue-router: `useRoute()` da tela enxerga ESTA rota, congelada — só é\n * atualizada quando a aba é a ativa. É o que impede um pane oculto de\n * reagir à navegação global (o bug clássico de sistemas de abas).\n */\n route: RouteLocationNormalizedLoaded\n closeGuards: Array<() => boolean | Promise<boolean>>\n activatedHooks: Array<() => void>\n deactivatedHooks: Array<() => void>\n /** Título default da rota, para `setTitle(null)` restaurar. */\n defaultTitle: string\n}\n\nexport interface UseRouteTabsOptions {\n router: Router\n /**\n * Modo de uso — o parâmetro que define o que é \"uma aba\":\n * - `'screen'` (default): cada tela é uma aba. Identidade = `route.path`\n * (params contam, query não): NF 123 e NF 456 são abas distintas.\n * - `'module'`: uma aba por entrada de menu. Identidade = `moduleRoot(route)`;\n * navegar entre telas do mesmo módulo acontece DENTRO da aba (a view\n * remonta, título/ícone voltam aos da rota nova e os close guards valem\n * também nessa troca).\n */\n mode?: 'screen' | 'module'\n /**\n * Raiz do módulo da rota (ex.: path da listagem) — identidade da aba no modo\n * `'module'`. Obrigatório nesse modo; retornar falsy cai em `route.path`.\n */\n moduleRoot?: (route: RouteLocationNormalizedLoaded) => string | null | undefined\n /**\n * Modo `'module'`: trocar de path dentro da aba remonta a view. Devolva `false`\n * para uma troca que é a MESMA tela mudando de identidade — o caso clássico é\n * `/pedidos/novo` → `/pedidos/<id>` quando o rascunho nasce: a view fica viva e\n * recebe os `props` novos, sem remontar, sem animação de entrada, sem reler o\n * documento. Default: sempre remonta.\n */\n shouldRemount?: (\n from: RouteLocationNormalizedLoaded,\n to: RouteLocationNormalizedLoaded,\n ) => boolean\n /** Título/ícone/closable da aba. O que faltar cai em defaults sensatos. */\n resolveTabMeta?: (route: RouteLocationNormalizedLoaded) => Partial<RouteTabMeta>\n /** Quais rotas viram aba. Default: todas. */\n isTabRoute?: (route: RouteLocationNormalizedLoaded) => boolean\n /** Onde persistir. Default: `localStorage`; `null` desliga a persistência. */\n storage?: Storage | null\n /** Chave no storage. Função permite chave por usuário avaliada tarde. */\n storageKey?: string | (() => string)\n /** Destino ao fechar a última aba. Default: `/`. */\n homePath?: string\n /** Acima disso, a aba mais antiga não-ativa é fechada (guards respeitados). */\n maxTabs?: number\n}\n\nexport interface RouteTabsApi {\n tabs: Ref<RouteTab[]>\n activeKey: Ref<string | null>\n /** Ativa a aba (navega para o fullPath dela). */\n activate: (key: string) => Promise<void>\n /** Fecha respeitando os close guards da aba. `false` = algum guard vetou. */\n close: (key: string) => Promise<boolean>\n closeOthers: (key: string) => Promise<void>\n closeAll: () => Promise<void>\n /** Remonta o componente da aba (o estado da tela é descartado). */\n reload: (key: string) => void\n /** Título dinâmico (\"NF 000123\"). `null` volta ao título default da rota. */\n setTitle: (key: string, title: string | null | undefined) => void\n /** A rota já tem aba hidratada? (ex.: para pular overlay de navegação). */\n isLive: (target: RouteLocationNormalizedLoaded | string) => boolean\n /** Runtime interno da aba. Uso do WTabViewport; não persiste. */\n runtime: (key: string) => RouteTabRuntime | undefined\n}\n\n/**\n * Contexto que o pane fornece à tela (e aos dialogs dela). Injete com\n * `useTabHost()` — fora de abas retorna `null` e tudo degrada para o\n * comportamento padrão (dialog no body, título no breadcrumb etc.).\n */\nexport interface TabHostContext {\n /** Container do pane — alvo de `appendTo` para o dialog viver NA aba. */\n hostEl: Ref<HTMLElement | null>\n active: Ref<boolean>\n /** Título dinâmico da aba; `null` restaura o default da rota. */\n setTitle: (title: string | null | undefined) => void\n /** Chamado ao voltar para a aba (equivalente a onActivated). */\n onTabActivated: (fn: () => void) => void\n /** Chamado ao sair da aba (equivalente a onDeactivated). */\n onTabDeactivated: (fn: () => void) => void\n /** Veta o fechar da aba (ex.: alterações não salvas). `false` = não fecha. */\n registerCloseGuard: (guard: () => boolean | Promise<boolean>) => void\n}\n\nexport const W_TAB_HOST_KEY: InjectionKey<TabHostContext> = Symbol('w-tab-host')\n\n/** Contexto da aba que envolve o componente atual, ou `null` fora de abas. */\nexport function useTabHost(): TabHostContext | null {\n return inject(W_TAB_HOST_KEY, null)\n}\n"],"mappings":"A,qBA0CA,IAAaE,EAAc,OAAO,SAAS,EAC9BC,EAAsB,OAAO,iBAAiB,EAC9CC,EAAe,OAAO,UAAU,EC4GhCC,EAA+C,OAAO,YAAY,EAG/E,SAAgBC,GAAoC,CAClD,OAAA,EAAON,EAAAA,OAAAA,CAAOK,EAAgB,IAAI,CACpC,C"}
@@ -1 +1 @@
1
- {"version":3,"file":"routeTabs-C86S8jNU.js","names":["W_AXIOS_KEY","W_DATA_PROVIDER_KEY","W_CONFIG_KEY","W_TAB_HOST_KEY","useTabHost","inject"],"sources":["../src/types/plugin.ts","../src/types/routeTabs.ts"],"sourcesContent":["import type { AxiosInstance } from 'axios'\nimport type { DataProvider } from './dataProvider'\n\nexport interface WPluginOptions {\n axios?: AxiosInstance\n dataProvider?: DataProvider\n defaultPageSize?: number\n dateFormat?: string\n dateTimeFormat?: string\n locale?: string\n currency?: string\n registerComponents?: boolean\n /**\n * Corrige o `Dialog`/`Drawer` do PrimeVue 4 para o Esc fechar só o overlay\n * do topo (nativo fecha todos os empilhados). Default: `true`.\n */\n patchDialogEscape?: boolean\n /**\n * Padrão do app para a navegação por teclado no formulário do CRUD (foca o 1º campo, Enter\n * avança). A tela que declara `keyboardNav` no `useCrudManager` vence. Default: `false`.\n */\n keyboardNav?: boolean\n}\n\nexport interface WPluginConfig {\n axios?: AxiosInstance\n dataProvider: DataProvider\n defaultPageSize: number\n dateFormat: string\n dateTimeFormat: string\n locale: string\n currency: string\n keyboardNav: boolean\n}\n\nexport const W_AXIOS_KEY = Symbol('w-axios')\nexport const W_DATA_PROVIDER_KEY = Symbol('w-data-provider')\nexport const W_CONFIG_KEY = Symbol('w-config')\n","import { inject, type Component, type InjectionKey, type Ref } from 'vue'\nimport type { RouteLocationNormalizedLoaded, Router } from 'vue-router'\n\n/**\n * Navegação por abas (estilo browser/ERP): cada rota vira uma aba viva, com\n * fechar/recarregar e estado preservado ao alternar. O estado mora no\n * composable `useRouteTabs`; `WTabNav` (barra) e `WTabViewport` (painéis)\n * apenas o recebem via prop — nenhum componente guarda estado global.\n */\n\n/** Meta de apresentação de uma aba, resolvida a partir da rota. */\nexport interface RouteTabMeta {\n title: string\n /** Ícone PrimeIcons (ex.: 'pi pi-file'). */\n icon?: string\n /** `false` esconde o X e ignora fechar (ex.: dashboard fixo). */\n closable?: boolean\n /**\n * Grupo da aba (ex.: o módulo do menu — \"Sementes\", \"Estoque\"). Abas do\n * mesmo grupo ficam juntas na barra, com o rótulo do grupo antes do bloco.\n */\n group?: string\n /**\n * Cor do grupo (qualquer cor CSS). Sem ela, o WTabNav deriva uma cor estável\n * do nome do grupo — informe só para fixar a cor de um módulo.\n */\n color?: string\n}\n\n/** Uma aba aberta. `key` identifica (path com params); `fullPath` navega. */\nexport interface RouteTab {\n key: string\n /** Último fullPath visitado (query inclusa) — usado no push e no restore. */\n fullPath: string\n title: string\n icon?: string\n closable: boolean\n /** Grupo (módulo) da aba — abas do mesmo grupo ficam contíguas na barra. */\n group?: string\n /** Cor do grupo fixada pela rota (`RouteTabMeta.color`); ausente = derivada. */\n color?: string\n /**\n * `false` = aba restaurada do storage, ainda sem componente montado.\n * Hidrata na primeira ativação (o router resolve o lazy no caminho).\n */\n hydrated: boolean\n /** Contador de remontagem: `reload()` incrementa e o pane troca o `:key`. */\n remount: number\n}\n\n/**\n * Lado não serializável de uma aba hidratada — componente resolvido, snapshot\n * de rota e os registros feitos pela tela via `useTabHost`. Consumido pelo\n * WTabViewport; não persiste.\n */\nexport interface RouteTabRuntime {\n component: Component | null\n props: Record<string, unknown>\n /**\n * Snapshot reativo da rota, provido ao pane sob a `routeLocationKey` do\n * vue-router: `useRoute()` da tela enxerga ESTA rota, congelada — só é\n * atualizada quando a aba é a ativa. É o que impede um pane oculto de\n * reagir à navegação global (o bug clássico de sistemas de abas).\n */\n route: RouteLocationNormalizedLoaded\n closeGuards: Array<() => boolean | Promise<boolean>>\n activatedHooks: Array<() => void>\n deactivatedHooks: Array<() => void>\n /** Título default da rota, para `setTitle(null)` restaurar. */\n defaultTitle: string\n}\n\nexport interface UseRouteTabsOptions {\n router: Router\n /**\n * Modo de uso — o parâmetro que define o que é \"uma aba\":\n * - `'screen'` (default): cada tela é uma aba. Identidade = `route.path`\n * (params contam, query não): NF 123 e NF 456 são abas distintas.\n * - `'module'`: uma aba por entrada de menu. Identidade = `moduleRoot(route)`;\n * navegar entre telas do mesmo módulo acontece DENTRO da aba (a view\n * remonta, título/ícone voltam aos da rota nova e os close guards valem\n * também nessa troca).\n */\n mode?: 'screen' | 'module'\n /**\n * Raiz do módulo da rota (ex.: path da listagem) — identidade da aba no modo\n * `'module'`. Obrigatório nesse modo; retornar falsy cai em `route.path`.\n */\n moduleRoot?: (route: RouteLocationNormalizedLoaded) => string | null | undefined\n /**\n * Modo `'module'`: trocar de path dentro da aba remonta a view. Devolva `false`\n * para uma troca que é a MESMA tela mudando de identidade — o caso clássico é\n * `/pedidos/novo` → `/pedidos/<id>` quando o rascunho nasce: a view fica viva e\n * recebe os `props` novos, sem remontar, sem animação de entrada, sem reler o\n * documento. Default: sempre remonta.\n */\n shouldRemount?: (\n from: RouteLocationNormalizedLoaded,\n to: RouteLocationNormalizedLoaded,\n ) => boolean\n /** Título/ícone/closable da aba. O que faltar cai em defaults sensatos. */\n resolveTabMeta?: (route: RouteLocationNormalizedLoaded) => Partial<RouteTabMeta>\n /** Quais rotas viram aba. Default: todas. */\n isTabRoute?: (route: RouteLocationNormalizedLoaded) => boolean\n /** Onde persistir. Default: `localStorage`; `null` desliga a persistência. */\n storage?: Storage | null\n /** Chave no storage. Função permite chave por usuário avaliada tarde. */\n storageKey?: string | (() => string)\n /** Destino ao fechar a última aba. Default: `/`. */\n homePath?: string\n /** Acima disso, a aba mais antiga não-ativa é fechada (guards respeitados). */\n maxTabs?: number\n}\n\nexport interface RouteTabsApi {\n tabs: Ref<RouteTab[]>\n activeKey: Ref<string | null>\n /** Ativa a aba (navega para o fullPath dela). */\n activate: (key: string) => Promise<void>\n /** Fecha respeitando os close guards da aba. `false` = algum guard vetou. */\n close: (key: string) => Promise<boolean>\n closeOthers: (key: string) => Promise<void>\n closeAll: () => Promise<void>\n /** Remonta o componente da aba (o estado da tela é descartado). */\n reload: (key: string) => void\n /** Título dinâmico (\"NF 000123\"). `null` volta ao título default da rota. */\n setTitle: (key: string, title: string | null | undefined) => void\n /** A rota já tem aba hidratada? (ex.: para pular overlay de navegação). */\n isLive: (target: RouteLocationNormalizedLoaded | string) => boolean\n /** Runtime interno da aba. Uso do WTabViewport; não persiste. */\n runtime: (key: string) => RouteTabRuntime | undefined\n}\n\n/**\n * Contexto que o pane fornece à tela (e aos dialogs dela). Injete com\n * `useTabHost()` — fora de abas retorna `null` e tudo degrada para o\n * comportamento padrão (dialog no body, título no breadcrumb etc.).\n */\nexport interface TabHostContext {\n /** Container do pane — alvo de `appendTo` para o dialog viver NA aba. */\n hostEl: Ref<HTMLElement | null>\n active: Ref<boolean>\n /** Título dinâmico da aba; `null` restaura o default da rota. */\n setTitle: (title: string | null | undefined) => void\n /** Chamado ao voltar para a aba (equivalente a onActivated). */\n onTabActivated: (fn: () => void) => void\n /** Chamado ao sair da aba (equivalente a onDeactivated). */\n onTabDeactivated: (fn: () => void) => void\n /** Veta o fechar da aba (ex.: alterações não salvas). `false` = não fecha. */\n registerCloseGuard: (guard: () => boolean | Promise<boolean>) => void\n}\n\nexport const W_TAB_HOST_KEY: InjectionKey<TabHostContext> = Symbol('w-tab-host')\n\n/** Contexto da aba que envolve o componente atual, ou `null` fora de abas. */\nexport function useTabHost(): TabHostContext | null {\n return inject(W_TAB_HOST_KEY, null)\n}\n"],"mappings":";;AAmCA,IAAaA,IAAc,OAAO,SAAS,GAC9BC,IAAsB,OAAO,iBAAiB,GAC9CC,IAAe,OAAO,UAAU,GCmHhCC,IAA+C,OAAO,YAAY;AAG/E,SAAgBC,IAAoC;CAClD,OAAOC,EAAOF,GAAgB,IAAI;AACpC"}
1
+ {"version":3,"file":"routeTabs-C86S8jNU.js","names":["W_AXIOS_KEY","W_DATA_PROVIDER_KEY","W_CONFIG_KEY","W_TAB_HOST_KEY","useTabHost","inject"],"sources":["../src/types/plugin.ts","../src/types/routeTabs.ts"],"sourcesContent":["import type { AxiosInstance } from 'axios'\nimport type { DataProvider } from './dataProvider'\nimport type { CepLookup } from './field'\n\nexport interface WPluginOptions {\n axios?: AxiosInstance\n dataProvider?: DataProvider\n defaultPageSize?: number\n dateFormat?: string\n dateTimeFormat?: string\n locale?: string\n currency?: string\n registerComponents?: boolean\n /**\n * Corrige o `Dialog`/`Drawer` do PrimeVue 4 para o Esc fechar só o overlay\n * do topo (nativo fecha todos os empilhados). Default: `true`.\n */\n patchDialogEscape?: boolean\n /**\n * Padrão do app para a navegação por teclado no formulário do CRUD (foca o 1º campo, Enter\n * avança). A tela que declara `keyboardNav` no `useCrudManager` vence. Default: `false`.\n */\n keyboardNav?: boolean\n /**\n * Consulta de CEP dos campos `type: 'cep'` (ex.: um endpoint da própria API). O campo pode\n * trocar a sua com `FieldDef.cepLookup`. Default: ViaCEP direto do navegador.\n */\n cepLookup?: CepLookup\n}\n\nexport interface WPluginConfig {\n axios?: AxiosInstance\n dataProvider: DataProvider\n defaultPageSize: number\n dateFormat: string\n dateTimeFormat: string\n locale: string\n currency: string\n keyboardNav: boolean\n cepLookup: CepLookup\n}\n\nexport const W_AXIOS_KEY = Symbol('w-axios')\nexport const W_DATA_PROVIDER_KEY = Symbol('w-data-provider')\nexport const W_CONFIG_KEY = Symbol('w-config')\n","import { inject, type Component, type InjectionKey, type Ref } from 'vue'\nimport type { RouteLocationNormalizedLoaded, Router } from 'vue-router'\n\n/**\n * Navegação por abas (estilo browser/ERP): cada rota vira uma aba viva, com\n * fechar/recarregar e estado preservado ao alternar. O estado mora no\n * composable `useRouteTabs`; `WTabNav` (barra) e `WTabViewport` (painéis)\n * apenas o recebem via prop — nenhum componente guarda estado global.\n */\n\n/** Meta de apresentação de uma aba, resolvida a partir da rota. */\nexport interface RouteTabMeta {\n title: string\n /** Ícone PrimeIcons (ex.: 'pi pi-file'). */\n icon?: string\n /** `false` esconde o X e ignora fechar (ex.: dashboard fixo). */\n closable?: boolean\n /**\n * Grupo da aba (ex.: o módulo do menu — \"Sementes\", \"Estoque\"). Abas do\n * mesmo grupo ficam juntas na barra, com o rótulo do grupo antes do bloco.\n */\n group?: string\n /**\n * Cor do grupo (qualquer cor CSS). Sem ela, o WTabNav deriva uma cor estável\n * do nome do grupo — informe só para fixar a cor de um módulo.\n */\n color?: string\n}\n\n/** Uma aba aberta. `key` identifica (path com params); `fullPath` navega. */\nexport interface RouteTab {\n key: string\n /** Último fullPath visitado (query inclusa) — usado no push e no restore. */\n fullPath: string\n title: string\n icon?: string\n closable: boolean\n /** Grupo (módulo) da aba — abas do mesmo grupo ficam contíguas na barra. */\n group?: string\n /** Cor do grupo fixada pela rota (`RouteTabMeta.color`); ausente = derivada. */\n color?: string\n /**\n * `false` = aba restaurada do storage, ainda sem componente montado.\n * Hidrata na primeira ativação (o router resolve o lazy no caminho).\n */\n hydrated: boolean\n /** Contador de remontagem: `reload()` incrementa e o pane troca o `:key`. */\n remount: number\n}\n\n/**\n * Lado não serializável de uma aba hidratada — componente resolvido, snapshot\n * de rota e os registros feitos pela tela via `useTabHost`. Consumido pelo\n * WTabViewport; não persiste.\n */\nexport interface RouteTabRuntime {\n component: Component | null\n props: Record<string, unknown>\n /**\n * Snapshot reativo da rota, provido ao pane sob a `routeLocationKey` do\n * vue-router: `useRoute()` da tela enxerga ESTA rota, congelada — só é\n * atualizada quando a aba é a ativa. É o que impede um pane oculto de\n * reagir à navegação global (o bug clássico de sistemas de abas).\n */\n route: RouteLocationNormalizedLoaded\n closeGuards: Array<() => boolean | Promise<boolean>>\n activatedHooks: Array<() => void>\n deactivatedHooks: Array<() => void>\n /** Título default da rota, para `setTitle(null)` restaurar. */\n defaultTitle: string\n}\n\nexport interface UseRouteTabsOptions {\n router: Router\n /**\n * Modo de uso — o parâmetro que define o que é \"uma aba\":\n * - `'screen'` (default): cada tela é uma aba. Identidade = `route.path`\n * (params contam, query não): NF 123 e NF 456 são abas distintas.\n * - `'module'`: uma aba por entrada de menu. Identidade = `moduleRoot(route)`;\n * navegar entre telas do mesmo módulo acontece DENTRO da aba (a view\n * remonta, título/ícone voltam aos da rota nova e os close guards valem\n * também nessa troca).\n */\n mode?: 'screen' | 'module'\n /**\n * Raiz do módulo da rota (ex.: path da listagem) — identidade da aba no modo\n * `'module'`. Obrigatório nesse modo; retornar falsy cai em `route.path`.\n */\n moduleRoot?: (route: RouteLocationNormalizedLoaded) => string | null | undefined\n /**\n * Modo `'module'`: trocar de path dentro da aba remonta a view. Devolva `false`\n * para uma troca que é a MESMA tela mudando de identidade — o caso clássico é\n * `/pedidos/novo` → `/pedidos/<id>` quando o rascunho nasce: a view fica viva e\n * recebe os `props` novos, sem remontar, sem animação de entrada, sem reler o\n * documento. Default: sempre remonta.\n */\n shouldRemount?: (\n from: RouteLocationNormalizedLoaded,\n to: RouteLocationNormalizedLoaded,\n ) => boolean\n /** Título/ícone/closable da aba. O que faltar cai em defaults sensatos. */\n resolveTabMeta?: (route: RouteLocationNormalizedLoaded) => Partial<RouteTabMeta>\n /** Quais rotas viram aba. Default: todas. */\n isTabRoute?: (route: RouteLocationNormalizedLoaded) => boolean\n /** Onde persistir. Default: `localStorage`; `null` desliga a persistência. */\n storage?: Storage | null\n /** Chave no storage. Função permite chave por usuário avaliada tarde. */\n storageKey?: string | (() => string)\n /** Destino ao fechar a última aba. Default: `/`. */\n homePath?: string\n /** Acima disso, a aba mais antiga não-ativa é fechada (guards respeitados). */\n maxTabs?: number\n}\n\nexport interface RouteTabsApi {\n tabs: Ref<RouteTab[]>\n activeKey: Ref<string | null>\n /** Ativa a aba (navega para o fullPath dela). */\n activate: (key: string) => Promise<void>\n /** Fecha respeitando os close guards da aba. `false` = algum guard vetou. */\n close: (key: string) => Promise<boolean>\n closeOthers: (key: string) => Promise<void>\n closeAll: () => Promise<void>\n /** Remonta o componente da aba (o estado da tela é descartado). */\n reload: (key: string) => void\n /** Título dinâmico (\"NF 000123\"). `null` volta ao título default da rota. */\n setTitle: (key: string, title: string | null | undefined) => void\n /** A rota já tem aba hidratada? (ex.: para pular overlay de navegação). */\n isLive: (target: RouteLocationNormalizedLoaded | string) => boolean\n /** Runtime interno da aba. Uso do WTabViewport; não persiste. */\n runtime: (key: string) => RouteTabRuntime | undefined\n}\n\n/**\n * Contexto que o pane fornece à tela (e aos dialogs dela). Injete com\n * `useTabHost()` — fora de abas retorna `null` e tudo degrada para o\n * comportamento padrão (dialog no body, título no breadcrumb etc.).\n */\nexport interface TabHostContext {\n /** Container do pane — alvo de `appendTo` para o dialog viver NA aba. */\n hostEl: Ref<HTMLElement | null>\n active: Ref<boolean>\n /** Título dinâmico da aba; `null` restaura o default da rota. */\n setTitle: (title: string | null | undefined) => void\n /** Chamado ao voltar para a aba (equivalente a onActivated). */\n onTabActivated: (fn: () => void) => void\n /** Chamado ao sair da aba (equivalente a onDeactivated). */\n onTabDeactivated: (fn: () => void) => void\n /** Veta o fechar da aba (ex.: alterações não salvas). `false` = não fecha. */\n registerCloseGuard: (guard: () => boolean | Promise<boolean>) => void\n}\n\nexport const W_TAB_HOST_KEY: InjectionKey<TabHostContext> = Symbol('w-tab-host')\n\n/** Contexto da aba que envolve o componente atual, ou `null` fora de abas. */\nexport function useTabHost(): TabHostContext | null {\n return inject(W_TAB_HOST_KEY, null)\n}\n"],"mappings":";;AA0CA,IAAaA,IAAc,OAAO,SAAS,GAC9BC,IAAsB,OAAO,iBAAiB,GAC9CC,IAAe,OAAO,UAAU,GC4GhCC,IAA+C,OAAO,YAAY;AAG/E,SAAgBC,IAAoC;CAClD,OAAOC,EAAOF,GAAgB,IAAI;AACpC"}
@@ -2,15 +2,27 @@ export interface RowAction<T = Record<string, unknown>> {
2
2
  action: string;
3
3
  icon: string;
4
4
  tooltip?: string;
5
+ /**
6
+ * Só `danger` muda o botão (vermelho); o resto vira `ghost` (linha) ou `primary` (lote).
7
+ * @deprecated `success`, `warn`, `info` e `contrast`: cor de status nunca é cor de botão; são
8
+ * ignorados e avisam em DEV.
9
+ */
5
10
  severity?: 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast';
6
11
  visible?: (data: T) => boolean;
7
12
  disabled?: (data: T) => boolean;
13
+ /** Motivo do bloqueio na linha (tooltip, `title` e `aria-label` do botão desabilitado). */
14
+ disabledReason?: (data: T) => string | undefined;
8
15
  handler?: (data: T) => void;
9
16
  }
10
17
  export interface BulkAction<T = Record<string, unknown>> {
11
18
  action: string;
12
19
  label: string;
13
20
  icon?: string;
21
+ /**
22
+ * Só `danger` muda o botão (vermelho); o resto vira `ghost` (linha) ou `primary` (lote).
23
+ * @deprecated `success`, `warn`, `info` e `contrast`: cor de status nunca é cor de botão; são
24
+ * ignorados e avisam em DEV.
25
+ */
14
26
  severity?: 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast';
15
27
  /** Desabilita a ação para a seleção atual. */
16
28
  disabled?: (items: T[]) => boolean;
@@ -0,0 +1,10 @@
1
+ /** Papel do botão: um `primary` por região; `danger` só para o destrutivo. */
2
+ export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
3
+ /**
4
+ * `md` é o tamanho do controle; `sm` cabe em linha de tabela, barra e painel.
5
+ * @deprecated `small`/`large`: sinônimos do PrimeVue aceitos por compatibilidade (`small` = `sm`,
6
+ * `large` = `md`) com aviso em DEV; use `sm` ou `md`.
7
+ */
8
+ export type ButtonSize = 'sm' | 'md' | 'small' | 'large';
9
+ /** `popup` abre ancorado no botão (`toggle(event)`); `context` abre no ponteiro (`show(event)`). */
10
+ export type MenuMode = 'popup' | 'context';
@@ -3,8 +3,23 @@ import { ColumnDef } from './column';
3
3
  import { CrudLabels } from './labels';
4
4
  export type FieldType = 'text' | 'email' | 'password' | 'number' | 'currency' | 'date' | 'datetime' | 'select' | 'autocomplete' | 'fk' | 'switch' | 'textarea' | 'color' | 'cpf_cnpj' | 'mask' | 'image' | 'cep' | 'transfer' | 'segmented' | 'choice' | 'chips';
5
5
  export interface SelectOption {
6
+ /** `select`/`choice` do FieldDef: opção visível mas não escolhível (ex.: plano indisponível). */
7
+ disabled?: boolean;
8
+ /** `select`/`choice` do FieldDef: segunda linha da opção — o que decide a escolha ou o
9
+ * motivo do bloqueio. A chave pode ser trocada por `FieldDef.optionDescription`. */
10
+ description?: string;
6
11
  [key: string]: unknown;
7
12
  }
13
+ /** Endereço devolvido pela consulta de CEP (formato do ViaCEP). */
14
+ export interface CepAddress {
15
+ logradouro?: string;
16
+ bairro?: string;
17
+ localidade?: string;
18
+ uf?: string;
19
+ complemento?: string;
20
+ }
21
+ /** Consulta de CEP: recebe os 8 dígitos e devolve o endereço, ou `null` se não achar. */
22
+ export type CepLookup = (cep: string) => Promise<CepAddress | null>;
8
23
  /**
9
24
  * Filtro em cascata (drill-down) de um campo FK: torna a busca dependente do valor
10
25
  * de outro campo do formulário, aplicando-o como filtro na requisição à API.
@@ -77,7 +92,8 @@ export interface FieldDef {
77
92
  /** Segunda linha da opção, em texto de apoio — para o dado que **decide** a escolha
78
93
  * aparecer antes dela, não depois (ex.: o saldo em estoque de um lote).
79
94
  * É uma **chave** do registro; formate no backend, como já se faz com `{fk}_nome`.
80
- * Só afeta a lista de sugestões: escolhido o item, o campo mostra `optionLabel`. */
95
+ * Só afeta a lista de sugestões: escolhido o item, o campo mostra `optionLabel`.
96
+ * Vale também no `select` e no `choice`, onde o default é `description`. */
81
97
  optionDescription?: string;
82
98
  optionValue?: string;
83
99
  showClear?: boolean;
@@ -121,8 +137,8 @@ export interface FieldDef {
121
137
  canEdit?: boolean;
122
138
  canDelete?: boolean;
123
139
  /** FK: quando a lista (com filtros/cascata atuais) tem um registro só, ele já entra
124
- * selecionado — ao abrir sem valor e ao preencher a cascata. Default `true`;
125
- * `false` desliga. */
140
+ * selecionado — ao abrir sem valor e ao preencher a cascata. Default `false`
141
+ * (opt-in): sem isso, filtro de listagem e formulário de criação não vêm preenchidos. */
126
142
  autoSelectSingle?: boolean;
127
143
  min?: number;
128
144
  max?: number;
@@ -146,6 +162,16 @@ export interface FieldDef {
146
162
  minDate?: string | Date;
147
163
  maxDate?: string | Date;
148
164
  mask?: string;
165
+ /** Limite de caracteres: vira `maxlength` no input (barra a digitação) e é conferido
166
+ * de novo no `validateAll` (valor que veio da API maior que o limite). */
167
+ maxLength?: number;
168
+ /** Mostra o contador "n/max" sob o campo (exige `maxLength`). Default: `true` no
169
+ * `textarea`, `false` nos demais. */
170
+ showCounter?: boolean;
171
+ /** Atributo `autocomplete` do input (ex.: `'new-password'`, `'off'`, `'email'`). */
172
+ autocomplete?: string;
173
+ /** Atributo `spellcheck` do input; omitido segue o navegador. */
174
+ spellcheck?: boolean;
149
175
  rows?: number;
150
176
  /** Ícone no chip selecionado do `type: 'choice'` (default `pi pi-check-circle`).
151
177
  * `''` desliga o ícone. */
@@ -164,6 +190,8 @@ export interface FieldDef {
164
190
  switchLabel?: string;
165
191
  feedback?: boolean;
166
192
  accept?: string;
193
+ /** Consulta própria do CEP deste campo; vence a `cepLookup` do plugin (padrão: ViaCEP). */
194
+ cepLookup?: CepLookup;
167
195
  /** For type 'cep' — maps ViaCEP response fields to form field names.
168
196
  * Keys are ViaCEP response names (logradouro, bairro, localidade, uf, complemento).
169
197
  * Values are the form field names to populate. Omit keys to skip fields. */
@@ -1,12 +1,13 @@
1
1
  export type { PaginatedResponse, PaginationState, SortState, UseApiOptions, UseApiReturn, } from './api';
2
2
  export type { ColumnDef, ColumnFilter, ColumnType, TagSeverity } from './column';
3
- export type { FieldDef, FieldType, FieldValidateContext, FkCrudConfig, SelectOption, FieldDependency, } from './field';
3
+ export type { FieldDef, FieldType, FieldValidateContext, FkCrudConfig, SelectOption, CepAddress, CepLookup, FieldDependency, } from './field';
4
4
  export type { EditableCardRole, EditableColumnDef, EditableColumnEditor, EditableRow, } from './editableTable';
5
5
  export type { CheckListItem, CheckListLevel } from './checkList';
6
6
  export type { FlipCardLabels, FlipCardSlotProps } from './flipCard';
7
7
  export type { AttentionItem, AttentionItemClickEvent, AttentionSeverity } from './attentionList';
8
8
  export type { CrudGroupScope } from './crudGroup';
9
9
  export type { GroupedSelectGroupScope, GroupedSelectKey } from './groupedSelectList';
10
+ export type { PermissionOperation, PermissionRow, PermissionValue } from './permissionMatrix';
10
11
  export type { CalendarEvent, CalendarEventState, CalendarMoveEvent } from './calendar';
11
12
  export type { KanbanColumn, KanbanMoveEvent } from './kanban';
12
13
  export type { MarkdownHeading, MarkdownRenderResult } from './markdown';
@@ -24,3 +25,4 @@ export type { DataProvider, DataProviderListParams, DataProviderListResponse, Da
24
25
  export type { RouteTab, RouteTabMeta, RouteTabRuntime, RouteTabsApi, TabHostContext, UseRouteTabsOptions, } from './routeTabs';
25
26
  export { W_TAB_HOST_KEY, useTabHost } from './routeTabs';
26
27
  export type { PaletteItem } from './commandPalette';
28
+ export type { ButtonSize, ButtonVariant, MenuMode } from './button';
@@ -7,7 +7,8 @@ import { CrudLabels } from './labels';
7
7
  export interface CrudManagerConfig<T> {
8
8
  endpoint: string;
9
9
  columns: ColumnDef[];
10
- form: FieldDef[];
10
+ /** Campos do formulário. Omitido (`[]`) numa tela somente leitura. */
11
+ form?: FieldDef[];
11
12
  /** Nº de colunas do grid do form dialog (default 2). Campos usam `colSpan`
12
13
  * para ocupar frações do grid; grupos podem sobrepor via `fieldGroup.columns`. */
13
14
  formColumns?: number;
@@ -125,5 +126,7 @@ export interface CrudManagerReturn<T> {
125
126
  setColumnFilter(param: string, value: unknown): void;
126
127
  /** Limpa todos os filtros de coluna e recarrega a lista. */
127
128
  clearColumnFilters(): void;
128
- config: CrudManagerConfig<T>;
129
+ config: CrudManagerConfig<T> & {
130
+ form: FieldDef[];
131
+ };
129
132
  }
@@ -0,0 +1,9 @@
1
+ /** Uma operação (coluna) da matriz: `key` é o que vai no valor, `label` o que se lê. */
2
+ export interface PermissionOperation {
3
+ key: string;
4
+ label: string;
5
+ }
6
+ /** Linha da matriz (ex.: uma tela do catálogo). */
7
+ export type PermissionRow = Record<string, unknown>;
8
+ /** Valor da matriz (`v-model`): id da linha → chaves das operações marcadas. */
9
+ export type PermissionValue = Record<string, string[]>;
@@ -1,5 +1,6 @@
1
1
  import { AxiosInstance } from 'axios';
2
2
  import { DataProvider } from './dataProvider';
3
+ import { CepLookup } from './field';
3
4
  export interface WPluginOptions {
4
5
  axios?: AxiosInstance;
5
6
  dataProvider?: DataProvider;
@@ -19,6 +20,11 @@ export interface WPluginOptions {
19
20
  * avança). A tela que declara `keyboardNav` no `useCrudManager` vence. Default: `false`.
20
21
  */
21
22
  keyboardNav?: boolean;
23
+ /**
24
+ * Consulta de CEP dos campos `type: 'cep'` (ex.: um endpoint da própria API). O campo pode
25
+ * trocar a sua com `FieldDef.cepLookup`. Default: ViaCEP direto do navegador.
26
+ */
27
+ cepLookup?: CepLookup;
22
28
  }
23
29
  export interface WPluginConfig {
24
30
  axios?: AxiosInstance;
@@ -29,6 +35,7 @@ export interface WPluginConfig {
29
35
  locale: string;
30
36
  currency: string;
31
37
  keyboardNav: boolean;
38
+ cepLookup: CepLookup;
32
39
  }
33
40
  export declare const W_AXIOS_KEY: unique symbol;
34
41
  export declare const W_DATA_PROVIDER_KEY: unique symbol;
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Âncora de overlay transiente (Popover, Menu, ContextMenu) na navegação por abas. Dentro de uma
3
+ * aba, o overlay pendura no pane dela (some com a aba, morre com ela); fora, `body`.
4
+ *
5
+ * O PrimeVue posiciona esses overlays em coordenadas do DOCUMENTO, mas o pane é `position:
6
+ * relative`: o deslocamento do pane é devolvido por `translate` (tabs.css, `.w-tab-overlay`)
7
+ * a partir de `--w-overlay-shift-*`, que `sync()` grava no pane antes de cada abertura.
8
+ */
9
+ export declare function useTabOverlay(): {
10
+ appendTo: import('vue').ComputedRef<HTMLElement | "body">;
11
+ sync: () => void;
12
+ fit: (el: HTMLElement, target: HTMLElement) => void;
13
+ };
14
+ /**
15
+ * O flip do PrimeVue (`absolutePosition`) mede contra o viewport e, quando o overlay não cabe
16
+ * em nenhum lado, prende o topo em 0 — cobre o gatilho e, numa aba, fica sob a barra de abas.
17
+ * Aqui: embaixo se couber; senão em cima se couber na área visível (topo do pane, não da
18
+ * janela); senão no lado com mais espaço, colado ao gatilho e com rolagem interna.
19
+ */
20
+ export declare function fitOverlay(el: HTMLElement, target: HTMLElement, host: HTMLElement | null): void;
@@ -0,0 +1,4 @@
1
+ /** Aviso de desenvolvimento emitido uma vez por `key` (some do build de produção). */
2
+ export declare function warnOnce(key: string, message: string): void;
3
+ /** Só para teste: esquece o que já foi avisado. */
4
+ export declare function resetWarnOnce(): void;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wgalleti/primevue-components",
3
- "version": "2.0.1",
3
+ "version": "2.2.0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "publishConfig": {