@wgalleti/primevue-components 0.5.0 → 0.6.0

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

@@ -3,13 +3,24 @@ interface ColumnMeta {
     field: string;
     header: string;
 }
+/** Filtro em cascata já resolvido (nome do parâmetro + valor atual). */
+interface DrilldownFilter {
+    field: string;
+    value: unknown;
+    required?: boolean;
+}
 type __VLS_Props = {
     modelValue: string | number | Record<string, unknown> | null;
     endpoint: string;
     endpointParams?: Record<string, string | number | boolean>;
+    /** Filtro(s) em cascata resolvido(s): aplicado(s) como parâmetro na busca. Com
+     *  `required` (default true), a busca só ocorre quando o valor estiver preenchido. */
+    drilldown?: DrilldownFilter | DrilldownFilter[];
     optionLabel?: string;
     optionValue?: string;
     placeholder?: string;
+    /** Placeholder exibido enquanto uma cascata obrigatória não estiver preenchida. */
+    blockedPlaceholder?: string;
     disabled?: boolean;
     showClear?: boolean;
     forceSelection?: boolean;

package/dist/types/crud.d.ts

@@ -18,6 +18,19 @@ export type FieldType = 'text' | 'email' | 'password' | 'number' | 'currency' |
 export interface SelectOption {
     [key: string]: unknown;
 }
+/**
+ * Filtro em cascata (drill-down) de um campo FK: torna a busca dependente do valor
+ * de outro campo do formulário, aplicando-o como filtro na requisição à API.
+ */
+export interface FieldDependency {
+    /** Campo do formulário cujo valor alimenta o filtro (ex.: 'unidade_producao'). */
+    field: string;
+    /** Nome do parâmetro enviado à API. Default: o próprio `field`. */
+    param?: string;
+    /** Se true, a busca só ocorre quando o valor de origem estiver preenchido
+     *  (cascata obrigatória). Default: true. */
+    required?: boolean;
+}
 export interface FieldDef {
     field: string;
     label: string;
@@ -44,6 +57,14 @@ export interface FieldDef {
     searchFields?: string[];
     endpoint?: string;
     endpointParams?: Record<string, string | number | boolean>;
+    /** Filtro em cascata: torna esta FK dependente do valor de outro(s) campo(s) do
+     *  formulário, aplicando-o(s) como filtro na busca da API (ex.: um "local" que só
+     *  lista os da "unidade_producao" selecionada). Com `required` (default true), a
+     *  busca só ocorre após o campo de origem estar preenchido. */
+    dependsOn?: FieldDependency | FieldDependency[];
+    /** Placeholder da FK enquanto uma cascata obrigatória (`dependsOn`) não estiver
+     *  preenchida — ex.: "Selecione a unidade primeiro". */
+    blockedPlaceholder?: string;
     crudFields?: FieldDef[];
     crudColumns?: ColumnDef[];
     min?: number;

package/dist/types/types/crud.d.ts

@@ -18,6 +18,19 @@ export type FieldType = 'text' | 'email' | 'password' | 'number' | 'currency' |
 export interface SelectOption {
     [key: string]: unknown;
 }
+/**
+ * Filtro em cascata (drill-down) de um campo FK: torna a busca dependente do valor
+ * de outro campo do formulário, aplicando-o como filtro na requisição à API.
+ */
+export interface FieldDependency {
+    /** Campo do formulário cujo valor alimenta o filtro (ex.: 'unidade_producao'). */
+    field: string;
+    /** Nome do parâmetro enviado à API. Default: o próprio `field`. */
+    param?: string;
+    /** Se true, a busca só ocorre quando o valor de origem estiver preenchido
+     *  (cascata obrigatória). Default: true. */
+    required?: boolean;
+}
 export interface FieldDef {
     field: string;
     label: string;
@@ -44,6 +57,14 @@ export interface FieldDef {
     searchFields?: string[];
     endpoint?: string;
     endpointParams?: Record<string, string | number | boolean>;
+    /** Filtro em cascata: torna esta FK dependente do valor de outro(s) campo(s) do
+     *  formulário, aplicando-o(s) como filtro na busca da API (ex.: um "local" que só
+     *  lista os da "unidade_producao" selecionada). Com `required` (default true), a
+     *  busca só ocorre após o campo de origem estar preenchido. */
+    dependsOn?: FieldDependency | FieldDependency[];
+    /** Placeholder da FK enquanto uma cascata obrigatória (`dependsOn`) não estiver
+     *  preenchida — ex.: "Selecione a unidade primeiro". */
+    blockedPlaceholder?: string;
     crudFields?: FieldDef[];
     crudColumns?: ColumnDef[];
     min?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wgalleti/primevue-components",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {