@wgalleti/primevue-components 0.29.0 → 0.31.0

package/README.md

@@ -5,10 +5,10 @@ Biblioteca de componentes Vue 3 + PrimeVue 4 para padronizar componentes reutili
 ## Instalação
 
 ```bash
-# Via git (recomendado para projetos internos)
-yarn add git+https://github.com/wgalleti/wPrimeVueComponents.git
+# Pacote público no npm — fixe versão exata (sem ^), o mesmo número em todos os projetos
+yarn add @wgalleti/primevue-components@<versão> --exact
 
-# Ou npm link para desenvolvimento local
+# Desenvolvimento local da própria suíte
 cd wPrimeVueComponents && yarn link
 cd seu-projeto && yarn link @wgalleti/primevue-components
 ```
@@ -18,10 +18,10 @@ cd seu-projeto && yarn link @wgalleti/primevue-components
 Certifique-se de ter instalado no seu projeto:
 
 ```bash
-yarn add vue@^3.4 primevue@^4.0 dayjs@^1.11
+yarn add vue@^3.4 primevue@^4.2 dayjs@^1.11 vue-router
 ```
 
-Se o projeto usar a camada Axios padrao, instale tambem `axios@^1.0`.
+Se o projeto usar a camada Axios padrão (o data provider default), instale também `axios@^1.0`.
 
 ## Setup
 

package/dist/components/crud/WCrudFormDialog.vue.d.ts

@@ -21,6 +21,7 @@ declare var __VLS_23: `field-${string}`, __VLS_24: {
     field: FieldDef;
     formData: Record<string, unknown>;
     isEditing: boolean;
+    fieldId: string;
     setFormField: (f: string, v: unknown) => void;
 }, __VLS_28: `image-${string}`, __VLS_29: {
     field: FieldDef;

package/dist/components/crud/WCrudView.vue.d.ts

@@ -8,6 +8,9 @@ type __VLS_Props = {
     subtitle?: string;
     showSearch?: boolean;
     showHeader?: boolean;
+    /** Esconde a contagem total do filtro que acompanha o título ("32 registros").
+     *  Com `showHeader: false` a contagem vai para a toolbar. */
+    hideCount?: boolean;
     dialogWidth?: string;
     /** Nº de colunas do grid do form dialog (default: `formColumns` da config
      *  do useCrudManager, senão 2). */
@@ -80,6 +83,7 @@ declare var __VLS_1: {}, __VLS_10: {}, __VLS_47: {
     field: FieldDef;
     formData: Record<string, unknown>;
     isEditing: boolean;
+    fieldId: string;
     setFormField: (f: string, v: unknown) => void;
 }, __VLS_359: {
     item: Record<string, unknown> | null;
@@ -144,6 +148,7 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_PublicProps, {
     showHeader: boolean;
     contextMenu: boolean;
     showSearch: boolean;
+    hideCount: boolean;
     autoInit: boolean;
     showKpi: boolean;
     kpiIcon: string;

package/dist/components/form/WAutoCompleteFK.vue.d.ts

@@ -43,6 +43,10 @@ type __VLS_Props = {
     canCreate?: boolean;
     canEdit?: boolean;
     canDelete?: boolean;
+    /** Quando a lista (com os filtros/cascata atuais) tem **um** registro só, ele já
+     *  entra selecionado — ao montar sem valor e ao preencher a cascata. Só no modo
+     *  simples; limpar o campo não redispara. `false` desliga. */
+    autoSelectSingle?: boolean;
     crudFields?: FieldDef[];
     crudColumns?: ColumnDef[];
     /** Sub-linhas do grid do modal: recebe as linhas da página e devolve o mapa
@@ -54,6 +58,11 @@ type __VLS_Props = {
      *  para que o `focus()` do PrimeVue Dialog (em onAfterEnter) o encontre e
      *  não roube o foco para o botão de fechar. */
     autofocus?: boolean;
+    /** `id` do input de digitação — alvo do `<label for>` do formulário. */
+    inputId?: string;
+    /** Atributos extras no input de digitação (`aria-labelledby`, `aria-describedby`,
+     *  `aria-required`, `aria-invalid`…). Vão direto no `<input>`, não no wrapper. */
+    inputAttrs?: Record<string, unknown>;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: Record<string, unknown> | Record<string, unknown>[] | null) => any;
@@ -72,6 +81,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {
     canCreate: boolean;
     canEdit: boolean;
     canDelete: boolean;
+    autoSelectSingle: boolean;
     dialogWidth: string;
     autofocus: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/components/form/WDatePicker.vue.d.ts

@@ -21,6 +21,9 @@ type __VLS_Props = {
     placeholder?: string;
     invalid?: boolean;
     inputId?: string;
+    /** Atributos extras no `<input>` (`aria-labelledby`, `aria-describedby`,
+     *  `aria-required`…). */
+    inputAttrs?: Record<string, unknown>;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: string | Date | null) => any;

package/dist/components/form/WFormRenderer.vue.d.ts

@@ -23,6 +23,7 @@ declare var __VLS_2: `field-${string}`, __VLS_3: {
     field: FieldDef;
     formData: Record<string, unknown>;
     isEditing: boolean;
+    fieldId: string;
     setFormField: (f: string, v: unknown) => void;
 }, __VLS_27: `image-${string}`, __VLS_28: {
     field: FieldDef;

package/dist/components/form/WMoneyInput.vue.d.ts

@@ -14,6 +14,11 @@ type __VLS_Props = {
     disabled?: boolean;
     placeholder?: string;
     invalid?: boolean;
+    /** `id` do `<input>` — alvo do `<label for>` do formulário. */
+    inputId?: string;
+    /** Atributos extras no `<input>` (`aria-labelledby`, `aria-describedby`,
+     *  `aria-required`…). Sempre no input, mesmo quando há prefixo/sufixo. */
+    inputAttrs?: Record<string, unknown>;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: number | null) => any;

package/dist/components/form/WTreeSelect.vue.d.ts

@@ -107,8 +107,8 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {},
     filterPlaceholder: string;
     filterFields: string[];
     emptyMessage: string;
-    filterEmptyMessage: string;
     showCount: boolean;
+    filterEmptyMessage: string;
     showToggleAll: boolean;
     defaultExpanded: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/components/index.d.ts

@@ -20,7 +20,9 @@ export { default as WDetailHeader } from './ui/WDetailHeader.vue';
 export { default as WInfoCard } from './ui/WInfoCard.vue';
 export { default as WKpiCard } from './ui/WKpiCard.vue';
 export { default as WKpiGrid } from './ui/WKpiGrid.vue';
+export { default as WSectionAccordion } from './ui/WSectionAccordion.vue';
 export { default as WSectionHeader } from './ui/WSectionHeader.vue';
+export { default as WSectionPanel } from './ui/WSectionPanel.vue';
 export { default as WFormSection } from './ui/WFormSection.vue';
 export { default as WActionBar } from './ui/WActionBar.vue';
 export { default as WProgressFlow } from './ui/WProgressFlow.vue';

package/dist/components/ui/WSectionAccordion.vue.d.ts

@@ -0,0 +1,36 @@
+/**
+ * As seções de um editor master-detail como painéis de um acordeão único: uma
+ * moldura só, sem blocos "flutuando". Diferente do WStepFlow, aqui não há ordem
+ * nem etapa ativa — cada seção abre e fecha por conta própria e várias ficam
+ * abertas ao mesmo tempo (o padrão é TODAS abertas; o usuário recolhe o que não
+ * interessa no momento).
+ *
+ * O `v-model` é a lista de `value` das seções abertas. Sem `v-model` o
+ * componente é dono do próprio estado, começando com tudo aberto.
+ */
+type __VLS_Props = {
+    /** `value` das seções abertas (`v-model`). Omitido = estado interno, tudo aberto. */
+    modelValue?: string[];
+    /** Trava o clique no cabeçalho de todas as seções. */
+    disabled?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (open: string[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((open: string[]) => any) | undefined;
+}>, {
+    modelValue: string[];
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/ui/WSectionPanel.vue.d.ts

@@ -0,0 +1,40 @@
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: __VLS_WithSlots<import('vue').DefineComponent<{
+    /** Identificador da seção — é o que o `v-model` do acordeão carrega. */
+    value: string;
+    title: string;
+    /** Frase abaixo do título: o que a seção é e o que acontece com ela. */
+    description?: string;
+    /** Ícone PrimeIcons do tile à esquerda (ex.: `pi pi-list`). */
+    icon?: string;
+    /** Badge de contagem à direita (registros da seção). */
+    count?: number | string;
+    disabled?: boolean;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    /** Identificador da seção — é o que o `v-model` do acordeão carrega. */
+    value: string;
+    title: string;
+    /** Frase abaixo do título: o que a seção é e o que acontece com ela. */
+    description?: string;
+    /** Ícone PrimeIcons do tile à esquerda (ex.: `pi pi-list`). */
+    icon?: string;
+    /** Badge de contagem à direita (registros da seção). */
+    count?: number | string;
+    disabled?: boolean;
+}> & Readonly<{}>, {
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>, {
+    icon?: (props: {}) => any;
+} & {
+    actions?: (props: {
+        open: boolean;
+    }) => any;
+} & {
+    default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};