@ncukondo/search-hub 0.13.0 → 0.15.0

package/dist/query/validator.d.ts

@@ -29,9 +29,10 @@ export declare const operatorSchema: z.ZodEnum<{
     OR: "OR";
 }>;
 /**
- * Schema for query block.
+ * Schema for query block (with required id).
  */
 export declare const queryBlockSchema: z.ZodObject<{
+    id: z.ZodString;
     field: z.ZodEnum<{
         title: "title";
         abstract: "abstract";
@@ -71,6 +72,8 @@ export declare const filtersSchema: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodOb
         include: z.ZodOptional<z.ZodArray<z.ZodString>>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>>>, z.ZodTransform<{
     yearFrom: number | undefined;
     yearTo: number | undefined;
@@ -79,6 +82,8 @@ export declare const filtersSchema: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodOb
         include?: string[] | undefined;
         exclude?: string[] | undefined;
     } | undefined;
+    categories: string[] | undefined;
+    sourceTypes: string[] | undefined;
 }, {
     year_from?: number | undefined;
     year_to?: number | undefined;
@@ -87,44 +92,6 @@ export declare const filtersSchema: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodOb
         include?: string[] | undefined;
         exclude?: string[] | undefined;
     } | undefined;
-}>>;
-/**
- * Schema for override block (YAML input format).
- */
-export declare const overrideBlockSchema: z.ZodPipe<z.ZodObject<{
-    filters: z.ZodOptional<z.ZodObject<{
-        year_from: z.ZodOptional<z.ZodNumber>;
-        year_to: z.ZodOptional<z.ZodNumber>;
-        language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        publication_types: z.ZodOptional<z.ZodObject<{
-            include: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>, z.ZodTransform<{
-    filters: {
-        yearFrom: number | undefined;
-        yearTo: number | undefined;
-        languages: string[] | undefined;
-        publicationTypes: {
-            include?: string[] | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
-    } | undefined;
-    categories: string[] | undefined;
-    sourceTypes: string[] | undefined;
-}, {
-    filters?: {
-        year_from?: number | undefined;
-        year_to?: number | undefined;
-        language?: string[] | undefined;
-        publication_types?: {
-            include?: string[] | undefined;
-            exclude?: string[] | undefined;
-        } | undefined;
-    } | undefined;
     categories?: string[] | undefined;
     source_types?: string[] | undefined;
 }>>;
@@ -139,6 +106,65 @@ export declare const providerNameSchema: z.ZodEnum<{
     wos: "wos";
     embase: "embase";
 }>;
+/**
+ * Schema for provider section with replaces and adds.
+ */
+export declare const providerSectionSchema: z.ZodObject<{
+    replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        field: z.ZodEnum<{
+            title: "title";
+            abstract: "abstract";
+            title_abstract: "title_abstract";
+            author: "author";
+            keyword: "keyword";
+            all: "all";
+        }>;
+        terms: z.ZodObject<{
+            keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        operator: z.ZodEnum<{
+            AND: "AND";
+            OR: "OR";
+        }>;
+    }, z.core.$strip>>>;
+    adds: z.ZodOptional<z.ZodObject<{
+        filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+            year_from: z.ZodOptional<z.ZodNumber>;
+            year_to: z.ZodOptional<z.ZodNumber>;
+            language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            publication_types: z.ZodOptional<z.ZodObject<{
+                include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            yearFrom: number | undefined;
+            yearTo: number | undefined;
+            languages: string[] | undefined;
+            publicationTypes: {
+                include?: string[] | undefined;
+                exclude?: string[] | undefined;
+            } | undefined;
+            categories: string[] | undefined;
+            sourceTypes: string[] | undefined;
+        }, {
+            year_from?: number | undefined;
+            year_to?: number | undefined;
+            language?: string[] | undefined;
+            publication_types?: {
+                include?: string[] | undefined;
+                exclude?: string[] | undefined;
+            } | undefined;
+            categories?: string[] | undefined;
+            source_types?: string[] | undefined;
+        }>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Schema for the complete query file (YAML input format).
  * Transforms to QueryAST for internal use.
@@ -147,6 +173,7 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     query: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
         field: z.ZodEnum<{
             title: "title";
             abstract: "abstract";
@@ -175,6 +202,8 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
             include: z.ZodOptional<z.ZodArray<z.ZodString>>;
             exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>, z.ZodTransform<{
         yearFrom: number | undefined;
         yearTo: number | undefined;
@@ -183,6 +212,8 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
             include?: string[] | undefined;
             exclude?: string[] | undefined;
         } | undefined;
+        categories: string[] | undefined;
+        sourceTypes: string[] | undefined;
     }, {
         year_from?: number | undefined;
         year_to?: number | undefined;
@@ -191,235 +222,352 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
             include?: string[] | undefined;
             exclude?: string[] | undefined;
         } | undefined;
+        categories?: string[] | undefined;
+        source_types?: string[] | undefined;
     }>>;
-    overrides: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        pubmed: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        pubmed: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
-        scopus: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        scopus: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
-        eric: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        eric: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
-        arxiv: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        arxiv: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
-        wos: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        wos: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
-        embase: z.ZodOptional<z.ZodPipe<z.ZodObject<{
-            filters: z.ZodOptional<z.ZodObject<{
-                year_from: z.ZodOptional<z.ZodNumber>;
-                year_to: z.ZodOptional<z.ZodNumber>;
-                language: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                publication_types: z.ZodOptional<z.ZodObject<{
-                    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        embase: z.ZodOptional<z.ZodObject<{
+            replaces: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                field: z.ZodEnum<{
+                    title: "title";
+                    abstract: "abstract";
+                    title_abstract: "title_abstract";
+                    author: "author";
+                    keyword: "keyword";
+                    all: "all";
+                }>;
+                terms: z.ZodObject<{
+                    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    mesh: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    emtree: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    eric: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                }, z.core.$strip>>;
+                }, z.core.$strip>;
+                operator: z.ZodEnum<{
+                    AND: "AND";
+                    OR: "OR";
+                }>;
+            }, z.core.$strip>>>;
+            adds: z.ZodOptional<z.ZodObject<{
+                filters: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+                    year_from: z.ZodOptional<z.ZodNumber>;
+                    year_to: z.ZodOptional<z.ZodNumber>;
+                    language: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    publication_types: z.ZodOptional<z.ZodObject<{
+                        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>, z.ZodTransform<{
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
+                }, {
+                    year_from?: number | undefined;
+                    year_to?: number | undefined;
+                    language?: string[] | undefined;
+                    publication_types?: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories?: string[] | undefined;
+                    source_types?: string[] | undefined;
+                }>>>;
             }, z.core.$strip>>;
-            categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            source_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>, z.ZodTransform<{
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
-        }, {
-            filters?: {
-                year_from?: number | undefined;
-                year_to?: number | undefined;
-                language?: string[] | undefined;
-                publication_types?: {
-                    include?: string[] | undefined;
-                    exclude?: string[] | undefined;
-                } | undefined;
-            } | undefined;
-            categories?: string[] | undefined;
-            source_types?: string[] | undefined;
-        }>>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodTransform<{
     name: string;
     description: string | undefined;
     blocks: {
+        id: string;
         field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
         terms: {
             keywords?: string[] | undefined;
@@ -438,90 +586,171 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
             include?: string[] | undefined;
             exclude?: string[] | undefined;
         } | undefined;
+        categories: string[] | undefined;
+        sourceTypes: string[] | undefined;
     };
-    overrides: {
+    providers: {
         pubmed?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         scopus?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         eric?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         arxiv?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         wos?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         embase?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
     };
 }, {
     name: string;
     query: {
+        id: string;
         field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
         terms: {
             keywords?: string[] | undefined;
@@ -540,85 +769,165 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
             include?: string[] | undefined;
             exclude?: string[] | undefined;
         } | undefined;
+        categories: string[] | undefined;
+        sourceTypes: string[] | undefined;
     };
-    overrides: {
+    providers: {
         pubmed?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         scopus?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         eric?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         arxiv?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         wos?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
         embase?: {
-            filters: {
-                yearFrom: number | undefined;
-                yearTo: number | undefined;
-                languages: string[] | undefined;
-                publicationTypes: {
-                    include?: string[] | undefined;
+            replaces?: Record<string, {
+                field: "title" | "abstract" | "title_abstract" | "author" | "keyword" | "all";
+                terms: {
+                    keywords?: string[] | undefined;
+                    mesh?: string[] | undefined;
+                    emtree?: string[] | undefined;
+                    eric?: string[] | undefined;
                     exclude?: string[] | undefined;
+                };
+                operator: "AND" | "OR";
+            }> | undefined;
+            adds?: {
+                filters?: {
+                    yearFrom: number | undefined;
+                    yearTo: number | undefined;
+                    languages: string[] | undefined;
+                    publicationTypes: {
+                        include?: string[] | undefined;
+                        exclude?: string[] | undefined;
+                    } | undefined;
+                    categories: string[] | undefined;
+                    sourceTypes: string[] | undefined;
                 } | undefined;
             } | undefined;
-            categories: string[] | undefined;
-            sourceTypes: string[] | undefined;
         } | undefined;
     };
     description?: string | undefined;
@@ -626,6 +935,8 @@ export declare const queryFileSchema: z.ZodPipe<z.ZodObject<{
 /**
  * Validate a parsed YAML object against the query schema.
  * Returns a validated QueryAST.
+ *
+ * @throws Error if the input contains the old `overrides` key (migration message provided)
  */
 export declare function validateQueryFile(data: unknown): QueryAST;
 /**