@wgalleti/primevue-components 0.9.6 → 0.11.0

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

@@ -0,0 +1,78 @@
+import { EditableColumnDef, EditableRow } from '../../types/editableTable';
+/**
+ * Tabela editável sobre ESTADO LOCAL — o oposto do WCrudView, que conversa com a
+ * API a cada operação. Aqui nada é persistido: o consumidor mantém o array e
+ * salva em bloco quando quiser (o caso "documento com filhos", em que salvar
+ * linha a linha criaria registro órfão).
+ *
+ * As linhas nunca são mutadas no lugar: toda edição emite um array NOVO com a
+ * linha trocada (`update:modelValue`), então `v-model` funciona igual em `ref`,
+ * `reactive` ou prop vinda de cima.
+ *
+ * A subtabela de insumos do design é este mesmo componente dentro do slot
+ * `#expansion` — não existe componente separado para "tabela filha".
+ */
+type __VLS_Props = {
+    /** Linhas (`v-model`). */
+    modelValue?: EditableRow[];
+    columns?: EditableColumnDef[];
+    /** Liga a coluna de expansão e o slot `#expansion`. */
+    expandable?: boolean;
+    /** Rótulo do botão de adicionar. Omitido = sem botão (só o slot `#toolbar`). */
+    addLabel?: string;
+    /** Liga a coluna da lixeira. */
+    removable?: boolean;
+    emptyMessage?: string;
+    /** Rótulo da primeira célula do rodapé de totais. */
+    footerLabel?: string;
+    /** Trava todos os editores (a tabela vira leitura). */
+    disabled?: boolean;
+    /** Campo usado como `key` das linhas. Sem ele, a chave é o índice. */
+    rowKey?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: Partial<Record<`cell-${string}`, (_: {
+        row: EditableRow;
+        index: number;
+        value: unknown;
+        column: EditableColumnDef;
+    }) => any>> & Partial<Record<`footer-${string}`, (_: {
+        rows: EditableRow[];
+        column: EditableColumnDef;
+    }) => any>> & {
+        toolbar?(_: {}): any;
+        empty?(_: {}): any;
+        expansion?(_: {
+            row: EditableRow;
+            index: number;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (rows: EditableRow[]) => any;
+    remove: (row: EditableRow, index: number) => any;
+    add: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((rows: EditableRow[]) => any) | undefined;
+    onRemove?: ((row: EditableRow, index: number) => any) | undefined;
+    onAdd?: (() => any) | undefined;
+}>, {
+    modelValue: EditableRow[];
+    disabled: boolean;
+    columns: EditableColumnDef[];
+    expandable: boolean;
+    emptyMessage: string;
+    removable: boolean;
+    footerLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -1,4 +1,4 @@
-import { FieldDef } from '../../types/field';
+import { FieldDef, FieldSubRowsFetch } from '../../types/field';
 import { ColumnDef } from '../../types/column';
 interface ColumnMeta {
     field: string;
@@ -26,6 +26,10 @@ type __VLS_Props = {
      *  (0 = mostrar todos). Útil em campo estreito, tipo filtro de painel. */
     maxChips?: number;
     optionLabel?: string;
+    /** Chave de uma segunda linha, em texto de apoio, dentro de cada sugestão — para
+     *  o dado que **decide** a escolha aparecer antes dela (ex.: saldo em estoque).
+     *  Vazia ou ausente na linha, a sugestão volta a ter uma linha só. */
+    optionDescription?: string;
     optionValue?: string;
     placeholder?: string;
     /** Placeholder exibido enquanto uma cascata obrigatória não estiver preenchida. */
@@ -41,6 +45,10 @@ type __VLS_Props = {
     canDelete?: boolean;
     crudFields?: FieldDef[];
     crudColumns?: ColumnDef[];
+    /** Sub-linhas do grid do modal: recebe as linhas da página e devolve o mapa
+     *  `id → sub-linhas` + as colunas (dinâmicas) do mini-grid. Linha com entrada
+     *  no mapa abre expandida — ex.: lote (linha) com suas análises (sub-linhas). */
+    subRows?: FieldSubRowsFetch;
     dialogWidth?: string;
     /** Foca o campo ao montar. Marca o input com o atributo nativo `autofocus`
      *  para que o `focus()` do PrimeVue Dialog (em onAfterEnter) o encontre e

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

@@ -0,0 +1,124 @@
+import { TreeSelectId, TreeSelectNode, TreeSelectOption } from '../../utils/treeSelect';
+/**
+ * Seleção múltipla em árvore com checkbox, alimentada por uma lista PLANA + um
+ * campo de agrupamento. O `v-model` é um array de ids de FOLHA — nunca o mapa de
+ * chaves do PrimeVue, e nunca com id de grupo dentro (grupo é só visual).
+ *
+ * ---------------------------------------------------------------------------
+ * POR QUE A SELEÇÃO É DERIVADA AQUI E NÃO DELEGADA AO `Tree` — NÃO "SIMPLIFIQUE"
+ * ---------------------------------------------------------------------------
+ * O `Tree` com `selectionMode="checkbox"` sabe manter sozinho o mapa
+ * `{ chave: { checked, partialChecked } }`, propagando para pais e filhos. Trocar
+ * o que está aqui por um `v-model:selectionKeys` parece uma simplificação óbvia.
+ * Não é: existe um bug ABERTO que quebra exatamente a combinação que usamos
+ * (checkbox + filtro).
+ *
+ *   https://github.com/primefaces/primevue/issues/6928  (aberta, "Help Wanted")
+ *
+ * Com o filtro ativo, o `partialChecked` dos ancestrais passa a se referir à
+ * árvore FILTRADA em vez da árvore inteira. O mecanismo está no código do
+ * PrimeVue 4.5: `TreeNode.propagateUp()` conta `this.node.children`, e sob filtro
+ * `this.node` é uma CÓPIA que o `findFilteredNodes()` produziu contendo só os
+ * filhos que casaram com a busca. Um grupo com 12 telas, 3 marcadas e filtro
+ * mostrando só essas 3 aparece como totalmente marcado — e ao salvar o usuário
+ * marca o que não queria.
+ *
+ * O repositório do PrimeVue foi arquivado em junho/2026 e está read-only: não vai
+ * ser corrigido upstream.
+ *
+ * Por isso, aqui:
+ *  1. a fonte da verdade é o `modelValue` (ids de folha) — sem estado espelhado;
+ *  2. o `selectionKeys` é DERIVADO sobre a árvore INTEIRA (`fullTree`), nunca
+ *     sobre a visão filtrada, então é correto por construção;
+ *  3. o `Tree` recebe `:selection-keys` como prop CONTROLADA (não `v-model:`) —
+ *     o mapa que ele calcularia é simplesmente descartado.
+ *
+ * Escolha do evento: `node-select` / `node-unselect`, e não `update:selectionKeys`.
+ * Os dois saem do mesmo `onCheckboxChange` do `Tree`, mas carregam coisas
+ * diferentes: `update:selectionKeys` entrega o mapa JÁ PROPAGADO (o resultado do
+ * `propagateUp` bugado), enquanto `node-select`/`node-unselect` entregam só o nó
+ * clicado e a direção do clique — a intenção crua do usuário, que nenhuma conta
+ * do PrimeVue tocou. É o único ponto estável da API para este caso.
+ *
+ * Detalhe que fecha o cerco: sob filtro o nó do evento é uma cópia podada, então
+ * ler `event.node.children` alternaria só as folhas VISÍVEIS. Resolvemos o nó
+ * pela `key` dentro do índice da árvore inteira (`fullIndex`) e alternamos todas
+ * as folhas dele — o mesmo resultado com ou sem filtro na tela.
+ */
+type __VLS_Props = {
+    /** Ids das folhas selecionadas (`v-model`). Nunca contém id de grupo. */
+    modelValue?: TreeSelectId[];
+    /** Lista PLANA de registros. O agrupamento é feito aqui, por `groupBy`. */
+    options?: TreeSelectOption[];
+    /** Campo do id da folha (default: `id`). */
+    optionValue?: string;
+    /** Campo do rótulo visível (default: `nome`). */
+    optionLabel?: string;
+    /** Campo que agrupa os registros. Sem ele, a lista sai rasa. */
+    groupBy?: string;
+    /** Rótulo do nó-pai a partir do valor bruto do agrupamento. */
+    groupLabel?: (chave: string) => string;
+    /** Campo de busca interno. */
+    filter?: boolean;
+    filterPlaceholder?: string;
+    /** Campos extras do registro considerados na busca (além do rótulo). */
+    filterFields?: string[];
+    loading?: boolean;
+    disabled?: boolean;
+    /** Texto quando não há nenhuma opção. */
+    emptyMessage?: string;
+    /** Texto quando a busca não encontrou nada. */
+    filterEmptyMessage?: string;
+    /** Contador `N de M selecionados` acima da árvore. */
+    showCount?: boolean;
+    /** Atalhos "Marcar todos" / "Limpar". */
+    showToggleAll?: boolean;
+    /** Abre todos os grupos na montagem. */
+    defaultExpanded?: boolean;
+    ariaLabel?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        header?(_: {
+            selectedCount: number;
+            total: number;
+        }): any;
+        node?(_: {
+            node: TreeSelectNode;
+        }): any;
+        empty?(_: {
+            filtering: boolean;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (ids: TreeSelectId[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((ids: TreeSelectId[]) => any) | undefined;
+}>, {
+    filter: boolean;
+    modelValue: TreeSelectId[];
+    optionLabel: string;
+    optionValue: string;
+    disabled: boolean;
+    loading: boolean;
+    options: TreeSelectOption[];
+    filterPlaceholder: string;
+    filterFields: string[];
+    emptyMessage: string;
+    filterEmptyMessage: string;
+    showCount: boolean;
+    showToggleAll: boolean;
+    defaultExpanded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/index.d.ts

@@ -1,6 +1,7 @@
 export { default as WCrudView } from './crud/WCrudView.vue';
 export { default as WCrudFormDialog } from './crud/WCrudFormDialog.vue';
 export { default as WCrudColumnRenderer } from './crud/WCrudColumnRenderer.vue';
+export { default as WEditableTable } from './crud/WEditableTable.vue';
 export { default as WAutoCompleteFK } from './form/WAutoCompleteFK.vue';
 export { default as WFormRenderer } from './form/WFormRenderer.vue';
 export { default as WImageCropper } from './form/WImageCropper.vue';
@@ -9,6 +10,7 @@ export { default as WDateRange } from './form/WDateRange.vue';
 export { default as WFileUpload } from './form/WFileUpload.vue';
 export { default as WMoneyInput } from './form/WMoneyInput.vue';
 export { default as WTransferList } from './form/WTransferList.vue';
+export { default as WTreeSelect } from './form/WTreeSelect.vue';
 export { default as WStatusTag } from './ui/WStatusTag.vue';
 export { default as WPageHeader } from './ui/WPageHeader.vue';
 export { default as WEmptyState } from './ui/WEmptyState.vue';
@@ -20,3 +22,7 @@ export { default as WSectionHeader } from './ui/WSectionHeader.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';
+export { default as WStepFlow } from './ui/WStepFlow.vue';
+export { default as WStepSection } from './ui/WStepSection.vue';
+export { default as WCheckList } from './ui/WCheckList.vue';
+export { default as WMapSelect } from './ui/WMapSelect.vue';

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

@@ -0,0 +1,36 @@
+import { CheckListItem } from '../../types/checkList';
+/**
+ * Lista de verificações de um documento (o aside "Verificações"): um ícone por
+ * nível e o contador `N/M` de quantas passaram, no cabeçalho.
+ *
+ * A avaliação é sempre do backend/serviço — o componente só desenha o que
+ * recebe. Ele não conhece regra de negócio nenhuma.
+ */
+type __VLS_Props = {
+    title?: string;
+    items?: CheckListItem[];
+    /** Esconde o contador `N/M` do cabeçalho. */
+    showCount?: boolean;
+    emptyMessage?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    emptyMessage: string;
+    showCount: boolean;
+    items: CheckListItem[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -2,10 +2,20 @@ export interface InfoField {
     label: string;
     value: string | number | null | undefined;
     format?: 'currency' | 'date' | 'datetime' | 'number' | 'text';
+    /** Unidade colada ao valor — usada na variante `metric` (ex.: `ha`, `kg`, `L`). */
+    suffix?: string;
+    /** Casas decimais do `format: 'number'` (default 2). */
+    decimals?: number;
 }
 type __VLS_Props = {
     title?: string;
     fields: InfoField[];
+    /** `default`: grade de rótulo em cima e valor embaixo.
+     *  `metric`: uma linha por campo — rótulo à esquerda, número grande à
+     *  direita, divisória entre as linhas (o aside "Resumo" de um documento). */
+    variant?: 'default' | 'metric';
 };
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: "default" | "metric";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

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

@@ -0,0 +1,133 @@
+import { MapSelectFeature, MapSelectGeometry, MapSelectId, MapSelectPolygonStyle } from '../../types/mapSelect';
+/**
+ * Seleção múltipla de polígonos num mapa de satélite, com painel lateral de busca.
+ *
+ * O componente NÃO é dono da seleção: `modelValue` é a fonte da verdade e todo
+ * clique (no polígono ou na lista) sai como `update:modelValue`. Isso mantém o
+ * mapa e a lista sempre coerentes — os dois leem o mesmo array.
+ *
+ * O Leaflet entra por `import()` dinâmico: o mapa costuma viver dentro de um
+ * Dialog, e carregar ~150 kB de biblioteca de mapa no bundle de quem só abre um
+ * CRUD é desperdício. Se o `import()` falhar (offline, CSP), o mapa é substituído
+ * por um aviso e o painel lateral continua funcionando — selecionar talhão pela
+ * lista nunca depende do mapa ter subido.
+ *
+ * `layout` só troca POSICIONAMENTO (CSS): a marcação é a mesma nos dois modos.
+ * No `'sobreposto'` o mapa ocupa tudo e o painel/rodapé flutuam por cima em
+ * vidro. Eles continuam FORA do container do Leaflet (irmãos, não filhos), então
+ * o mapa nunca vê os cliques do painel e o painel nunca precisa de
+ * `L.DomEvent.disableClickPropagation` — arrastar/zoom por baixo segue intacto.
+ */
+type __VLS_Props = {
+    /** Ids selecionados (`v-model`). */
+    modelValue?: MapSelectId[];
+    /** Itens selecionáveis. Sem `geometria` o item some do mapa, não da lista. */
+    features?: MapSelectFeature[];
+    /** Geometria do escopo (ex.: o setor) usada no `fitBounds` inicial.
+     *  Sem ela, o enquadramento é a união das geometrias das `features`. */
+    scopeGeometry?: MapSelectGeometry | null;
+    /** Tiles. Default: satélite World_Imagery (ArcGIS/Esri). */
+    tileUrl?: string;
+    tileAttribution?: string;
+    /** Zoom máximo do tile layer (o World_Imagery vai até 19). */
+    maxZoom?: number;
+    searchPlaceholder?: string;
+    /** Rótulo do rodapé, à esquerda da área somada. */
+    areaLabel?: string;
+    /** Unidade da área, no rodapé e no tooltip do polígono. */
+    areaSuffix?: string;
+    /** Casas decimais da área. */
+    areaDecimals?: number;
+    /** Altura do mapa (qualquer unidade CSS). */
+    height?: string;
+    /** Arranjo do componente.
+     *  - `'lado-a-lado'`: mapa à esquerda, painel de 300 px à direita, rodapé embaixo.
+     *  - `'sobreposto'`: o mapa ocupa tudo; painel e rodapé flutuam sobre ele em vidro. */
+    layout?: 'lado-a-lado' | 'sobreposto';
+    /** Texto do contador. Default em pt-BR: "N talhões selecionados". */
+    selectionLabel?: (count: number) => string;
+    clearLabel?: string;
+    /** `layout="sobreposto"`: rótulo acessível do botão que recolhe o painel. */
+    collapseLabel?: string;
+    /** `layout="sobreposto"`: rótulo acessível do botão que reabre o painel. */
+    expandLabel?: string;
+    /** Selo sobre o mapa (canto superior direito). `''` esconde. */
+    badgeLabel?: string;
+    emptyMessage?: string;
+    /** Mensagem quando o Leaflet não carregou. */
+    mapErrorMessage?: string;
+    disabled?: boolean;
+    /** Estilo do polígono não selecionado. */
+    polygonStyle?: MapSelectPolygonStyle;
+    /** Estilo do polígono selecionado. */
+    polygonSelectedStyle?: MapSelectPolygonStyle;
+};
+declare function setCollapsed(value: boolean): void;
+/** O mapa costuma nascer escondido (dentro de um Dialog): sem isto o Leaflet
+ *  calcula 0×0 e desenha só um pedaço quando o container aparece. */
+declare function refreshSize(): void;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        item?(_: {
+            feature: MapSelectFeature;
+            selected: boolean;
+        }): any;
+        empty?(_: {}): any;
+        footer?(_: {
+            area: number;
+            features: MapSelectFeature[];
+        }): any;
+    };
+    refs: {
+        root: HTMLDivElement;
+        container: HTMLDivElement;
+        footer: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
+    refreshSize: typeof refreshSize;
+    /** Painel flutuante recolhido? (só faz sentido no `layout="sobreposto"`.) */
+    collapsed: Readonly<import('vue').Ref<boolean, boolean>>;
+    setCollapsed: typeof setCollapsed;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (ids: MapSelectId[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((ids: MapSelectId[]) => any) | undefined;
+}>, {
+    modelValue: MapSelectId[];
+    disabled: boolean;
+    height: string;
+    emptyMessage: string;
+    features: MapSelectFeature[];
+    scopeGeometry: MapSelectGeometry | null;
+    tileUrl: string;
+    tileAttribution: string;
+    maxZoom: number;
+    searchPlaceholder: string;
+    areaLabel: string;
+    areaSuffix: string;
+    areaDecimals: number;
+    layout: "lado-a-lado" | "sobreposto";
+    selectionLabel: (count: number) => string;
+    clearLabel: string;
+    collapseLabel: string;
+    expandLabel: string;
+    badgeLabel: string;
+    mapErrorMessage: string;
+    polygonStyle: MapSelectPolygonStyle;
+    polygonSelectedStyle: MapSelectPolygonStyle;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    root: HTMLDivElement;
+    container: HTMLDivElement;
+    footer: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,51 @@
+import { StepFlowOrientation } from '../../utils/stepFlow';
+/**
+ * Etapas numeradas e colapsáveis (a espinha do editor de documento).
+ * Diferente do WProgressFlow, que só ILUSTRA o progresso: aqui cada etapa é um
+ * bloco de conteúdo que abre e fecha, e o `v-model` diz qual está aberta.
+ *
+ * `0` = todas fechadas. É estado do consumidor de propósito: "continuar para a
+ * próxima etapa" é uma decisão da tela, não do componente.
+ */
+type __VLS_Props = {
+    /** Número da etapa aberta (`v-model`). `0` fecha todas. */
+    modelValue?: number;
+    /**
+     * `vertical` empilha as etapas numa coluna (cada uma é um card).
+     * `horizontal` põe os cabeçalhos lado a lado numa régua e abre só o corpo da
+     * etapa ativa embaixo, na largura inteira — abaixo de 768px cai sozinho
+     * para o empilhamento vertical (a régua não cabe).
+     */
+    orientation?: StepFlowOrientation;
+    /** Trava o clique no cabeçalho de todas as etapas. */
+    disabled?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        root: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (step: number) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((step: number) => any) | undefined;
+}>, {
+    modelValue: number;
+    disabled: boolean;
+    orientation: StepFlowOrientation;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    root: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -0,0 +1,49 @@
+/**
+ * Uma etapa do WStepFlow: badge numerada + linha conectora, cabeçalho clicável
+ * (título, contador e resumo) e corpo colapsável com rodapé de ação.
+ *
+ * A orientação NÃO é prop daqui: vem do contexto do flow. Na vertical a etapa é
+ * um card na coluna; na horizontal o cabeçalho vira um trecho da régua e só o
+ * corpo da etapa ativa é desenhado, embaixo, na largura inteira.
+ *
+ * Fora de um WStepFlow o componente ainda funciona: ele cai num estado local
+ * aberto (e em vertical), para poder ser usado como card colapsável avulso.
+ */
+type __VLS_Props = {
+    /** Número da etapa (1-based) — é o valor que o `v-model` do flow carrega. */
+    step: number;
+    title: string;
+    /** Texto à direita do título (o "resumo" da etapa fechada). */
+    summary?: string;
+    /** Badge de contagem entre o título e o resumo. */
+    count?: number | string;
+    disabled?: boolean;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        actions?(_: {
+            open: boolean;
+        }): any;
+        actions?(_: {
+            open: boolean;
+        }): any;
+        default?(_: {}): any;
+        default?(_: {}): any;
+        footer?(_: {}): any;
+        footer?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    disabled: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./WProgressFlow.vue_vue_type_script_setup_true_lang-Cc0DJRIy.cjs"),e=require("vue"),m=require("primevue/button"),g={class:"w-fileupload",style:{display:"flex","flex-direction":"column",gap:"0.5rem"}},W=["accept","multiple"],v={key:0,style:{"list-style":"none",margin:"0",padding:"0",display:"flex","flex-direction":"column",gap:"0.35rem"}},k={style:{flex:"1",overflow:"hidden","text-overflow":"ellipsis","white-space":"nowrap"}},B={style:{opacity:"0.6"}},x=e.defineComponent({__name:"WFileUpload",props:{modelValue:{default:null},multiple:{type:Boolean,default:!1},accept:{default:void 0},maxSize:{default:10485760},disabled:{type:Boolean,default:!1},chooseLabel:{default:"Selecionar arquivo"}},emits:["update:modelValue","error"],setup(a,{emit:p}){const o=a,s=p,d=e.ref(null),c=e.computed(()=>{const l=o.modelValue;return l?Array.isArray(l)?l:[l]:[]});function f(){var l;(l=d.value)==null||l.click()}function _(l){const n=l.target,r=Array.from(n.files||[]);n.value="";const i=[];for(const u of r){if(u.size>o.maxSize){s("error",`"${u.name}" acima do limite de ${(o.maxSize/1048576).toFixed(1)}MB.`);continue}i.push(u)}i.length&&s("update:modelValue",o.multiple?[...c.value,...i]:i[0])}function y(l){if(!o.multiple){s("update:modelValue",null);return}const n=c.value.slice();n.splice(l,1),s("update:modelValue",n.length?n:null)}function $(l){return l<1024?`${l} B`:l<1048576?`${(l/1024).toFixed(0)} KB`:`${(l/1048576).toFixed(1)} MB`}return(l,n)=>(e.openBlock(),e.createElementBlock("div",g,[e.createElementVNode("div",null,[e.createVNode(e.unref(m),{type:"button",label:a.chooseLabel,icon:"pi pi-upload",outlined:"",size:"small",disabled:a.disabled,onClick:f},null,8,["label","disabled"])]),e.createElementVNode("input",{ref_key:"input",ref:d,type:"file",accept:a.accept,multiple:a.multiple,style:{display:"none"},onChange:_},null,40,W),c.value.length?(e.openBlock(),e.createElementBlock("ul",v,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(c.value,(r,i)=>(e.openBlock(),e.createElementBlock("li",{key:`${r.name}-${i}`,style:{display:"flex","align-items":"center",gap:"0.5rem","font-size":"0.85rem"}},[n[0]||(n[0]=e.createElementVNode("i",{class:"pi pi-file",style:{opacity:"0.6"}},null,-1)),e.createElementVNode("span",k,e.toDisplayString(r.name),1),e.createElementVNode("span",B,e.toDisplayString($(r.size)),1),e.createVNode(e.unref(m),{type:"button",icon:"pi pi-times",text:"",rounded:"",size:"small",severity:"danger",disabled:a.disabled,onClick:u=>y(i)},null,8,["disabled","onClick"])]))),128))])):e.renderSlot(l.$slots,"empty",{},()=>[n[1]||(n[1]=e.createElementVNode("span",{style:{"font-size":"0.8rem",opacity:"0.6"}},"Nenhum arquivo selecionado",-1))],void 0,1)]))}});exports.WActionBar=t._sfc_main;exports.WAutoCompleteFK=t._sfc_main$1;exports.WCrudColumnRenderer=t._sfc_main$2;exports.WCrudFormDialog=t._sfc_main$3;exports.WCrudView=t._sfc_main$4;exports.WDatePicker=t._sfc_main$5;exports.WDateRange=t._sfc_main$6;exports.WDetailHeader=t._sfc_main$7;exports.WEmptyState=t._sfc_main$8;exports.WFormRenderer=t._sfc_main$9;exports.WFormSection=t._sfc_main$10;exports.WImageCropper=t.WImageCropper;exports.WInfoCard=t._sfc_main$11;exports.WKpiCard=t._sfc_main$12;exports.WKpiGrid=t._sfc_main$13;exports.WMoneyInput=t._sfc_main$14;exports.WPageHeader=t._sfc_main$15;exports.WProgressFlow=t._sfc_main$16;exports.WSectionHeader=t._sfc_main$17;exports.WStatusTag=t._sfc_main$18;exports.WTransferList=t._sfc_main$19;exports.WFileUpload=x;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("./WMapSelect.vue_vue_type_script_setup_true_lang-BkZhQ_LO.cjs");exports.WActionBar=_._sfc_main;exports.WAutoCompleteFK=_._sfc_main$1;exports.WCheckList=_._sfc_main$2;exports.WCrudColumnRenderer=_._sfc_main$3;exports.WCrudFormDialog=_._sfc_main$4;exports.WCrudView=_._sfc_main$5;exports.WDatePicker=_._sfc_main$6;exports.WDateRange=_._sfc_main$7;exports.WDetailHeader=_._sfc_main$8;exports.WEditableTable=_._sfc_main$9;exports.WEmptyState=_._sfc_main$10;exports.WFileUpload=_._sfc_main$11;exports.WFormRenderer=_._sfc_main$12;exports.WFormSection=_._sfc_main$13;exports.WImageCropper=_.WImageCropper;exports.WInfoCard=_._sfc_main$14;exports.WKpiCard=_._sfc_main$15;exports.WKpiGrid=_._sfc_main$16;exports.WMapSelect=_._sfc_main$17;exports.WMoneyInput=_._sfc_main$18;exports.WPageHeader=_._sfc_main$19;exports.WProgressFlow=_._sfc_main$20;exports.WSectionHeader=_._sfc_main$21;exports.WStatusTag=_._sfc_main$22;exports.WStepFlow=_._sfc_main$23;exports.WStepSection=_._sfc_main$24;exports.WTransferList=_._sfc_main$25;exports.WTreeSelect=_._sfc_main$26;
 //# sourceMappingURL=components.cjs.map

package/dist/components.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"components.cjs","sources":["../src/components/form/WFileUpload.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport { ref, computed } from 'vue'\nimport Button from 'primevue/button'\n\n/**\n * Upload de arquivo(s) genérico (single ou multiple), sem dependência pesada.\n * O `v-model` guarda `File` (single) ou `File[]` (multiple). Valida tamanho por\n * arquivo e emite `error` para os que excederem.\n */\nconst props = withDefaults(\n  defineProps<{\n    modelValue?: File | File[] | null\n    multiple?: boolean\n    accept?: string\n    /** Tamanho máximo por arquivo em bytes (default 10MB). */\n    maxSize?: number\n    disabled?: boolean\n    chooseLabel?: string\n  }>(),\n  {\n    modelValue: null,\n    multiple: false,\n    accept: undefined,\n    maxSize: 10_485_760,\n    disabled: false,\n    chooseLabel: 'Selecionar arquivo',\n  },\n)\n\nconst emit = defineEmits<{\n  'update:modelValue': [value: File | File[] | null]\n  error: [message: string]\n}>()\n\nconst input = ref<HTMLInputElement | null>(null)\nconst files = computed<File[]>(() => {\n  const v = props.modelValue\n  if (!v) return []\n  return Array.isArray(v) ? v : [v]\n})\n\nfunction open() {\n  input.value?.click()\n}\n\nfunction onChange(e: Event) {\n  const el = e.target as HTMLInputElement\n  const picked = Array.from(el.files || [])\n  el.value = ''\n  const valid: File[] = []\n  for (const f of picked) {\n    if (f.size > props.maxSize) {\n      emit('error', `\"${f.name}\" acima do limite de ${(props.maxSize / 1_048_576).toFixed(1)}MB.`)\n      continue\n    }\n    valid.push(f)\n  }\n  if (!valid.length) return\n  emit('update:modelValue', props.multiple ? [...files.value, ...valid] : valid[0])\n}\n\nfunction removeAt(i: number) {\n  if (!props.multiple) {\n    emit('update:modelValue', null)\n    return\n  }\n  const next = files.value.slice()\n  next.splice(i, 1)\n  emit('update:modelValue', next.length ? next : null)\n}\n\nfunction fmtSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`\n  if (bytes < 1_048_576) return `${(bytes / 1024).toFixed(0)} KB`\n  return `${(bytes / 1_048_576).toFixed(1)} MB`\n}\n</script>\n\n<template>\n  <div class=\"w-fileupload\" style=\"display: flex; flex-direction: column; gap: 0.5rem\">\n    <div>\n      <Button\n        type=\"button\"\n        :label=\"chooseLabel\"\n        icon=\"pi pi-upload\"\n        outlined\n        size=\"small\"\n        :disabled=\"disabled\"\n        @click=\"open\"\n      />\n    </div>\n    <input\n      ref=\"input\"\n      type=\"file\"\n      :accept=\"accept\"\n      :multiple=\"multiple\"\n      style=\"display: none\"\n      @change=\"onChange\"\n    />\n    <ul\n      v-if=\"files.length\"\n      style=\"\n        list-style: none;\n        margin: 0;\n        padding: 0;\n        display: flex;\n        flex-direction: column;\n        gap: 0.35rem;\n      \"\n    >\n      <li\n        v-for=\"(f, i) in files\"\n        :key=\"`${f.name}-${i}`\"\n        style=\"display: flex; align-items: center; gap: 0.5rem; font-size: 0.85rem\"\n      >\n        <i class=\"pi pi-file\" style=\"opacity: 0.6\" />\n        <span style=\"flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap\">\n          {{ f.name }}\n        </span>\n        <span style=\"opacity: 0.6\">{{ fmtSize(f.size) }}</span>\n        <Button\n          type=\"button\"\n          icon=\"pi pi-times\"\n          text\n          rounded\n          size=\"small\"\n          severity=\"danger\"\n          :disabled=\"disabled\"\n          @click=\"removeAt(i)\"\n        />\n      </li>\n    </ul>\n    <slot v-else name=\"empty\">\n      <span style=\"font-size: 0.8rem; opacity: 0.6\">Nenhum arquivo selecionado</span>\n    </slot>\n  </div>\n</template>\n"],"names":["props","__props","emit","__emit","input","ref","files","computed","v","open","_a","onChange","e","el","picked","valid","f","removeAt","i","next","fmtSize","bytes","_openBlock","_createElementBlock","_hoisted_1","_createElementVNode","_createVNode","_unref","Button","_hoisted_3","_Fragment","_renderList","_hoisted_4","_toDisplayString","_hoisted_5","$event","_renderSlot","_ctx","_cache"],"mappings":"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"}
+{"version":3,"file":"components.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}