@visactor/vbi 0.4.15 → 0.4.16

package/dist/index.cjs

@@ -24,22 +24,28 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    preorderTraverse: ()=>vseed_namespaceObject.preorderTraverse,
+    HavingFilterBuilder: ()=>HavingFilterBuilder,
+    WhereFilterBuilder: ()=>WhereFilterBuilder,
     isVBIHavingGroup: ()=>isVBIHavingGroup,
+    VBIBuilder: ()=>VBIBuilder,
+    VBI: ()=>VBI,
+    isVBIHavingFilter: ()=>isVBIHavingFilter,
+    findTreeNodesBy: ()=>vseed_namespaceObject.findTreeNodesBy,
+    ThemeBuilder: ()=>ThemeBuilder,
+    id: ()=>id_id,
     MeasuresBuilder: ()=>MeasuresBuilder,
+    LimitBuilder: ()=>LimitBuilder,
     DimensionsBuilder: ()=>DimensionsBuilder,
-    VBIBuilder: ()=>VBIBuilder,
     ChartTypeBuilder: ()=>ChartTypeBuilder,
     isVBIFilter: ()=>isVBIFilter,
-    VBI: ()=>VBI,
     isVBIWhereGroup: ()=>isVBIWhereGroup,
-    isVBIHavingFilter: ()=>isVBIHavingFilter,
+    preorderTraverse: ()=>vseed_namespaceObject.preorderTraverse,
     buildVQuery: ()=>buildVQuery,
-    findTreeNodesBy: ()=>vseed_namespaceObject.findTreeNodesBy,
-    id: ()=>id_id
+    LocaleBuilder: ()=>LocaleBuilder,
+    UndoManager: ()=>UndoManager
 });
 const external_yjs_namespaceObject = require("yjs");
-class DimensionNodeBuilder {
+class MeasureNodeBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
@@ -51,71 +57,83 @@ class DimensionNodeBuilder {
         this.yMap.set('alias', alias);
         return this;
     }
-    toJson() {
+    setEncoding(encoding) {
+        this.yMap.set('encoding', encoding);
+        return this;
+    }
+    setAggregate(aggregate) {
+        this.yMap.set('aggregate', aggregate);
+        return this;
+    }
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class DimensionsBuilder {
+class MeasuresBuilder {
     dsl;
     constructor(_doc, dsl){
         this.dsl = dsl;
     }
     add(field, callback) {
-        const dimension = {
+        const measure = {
             alias: field,
-            field
+            field,
+            encoding: 'yAxis',
+            aggregate: {
+                func: 'sum'
+            }
         };
         const yMap = new external_yjs_namespaceObject.Map();
-        for (const [key, value] of Object.entries(dimension))yMap.set(key, value);
-        this.dsl.get('dimensions').push([
+        for (const [key, value] of Object.entries(measure))yMap.set(key, value);
+        this.dsl.get('measures').push([
             yMap
         ]);
-        const node = new DimensionNodeBuilder(yMap);
+        const node = new MeasureNodeBuilder(yMap);
         callback(node);
         return this;
     }
     remove(field) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 !== index) this.dsl.get('dimensions').delete(index, 1);
+        const measures = this.dsl.get('measures');
+        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
+        if (-1 !== index) this.dsl.get('measures').delete(index, 1);
         return this;
     }
     update(field, callback) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) throw new Error(`Dimension with field "${field}" not found`);
-        const dimensionYMap = dimensions.get(index);
-        const node = new DimensionNodeBuilder(dimensionYMap);
+        const measures = this.dsl.get('measures');
+        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
+        if (-1 === index) throw new Error(`Measure with field "${field}" not found`);
+        const measureYMap = measures.get(index);
+        const node = new MeasureNodeBuilder(measureYMap);
         callback(node);
         return this;
     }
     find(field) {
-        const dimensions = this.dsl.get('dimensions');
-        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
+        const measures = this.dsl.get('measures');
+        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
         if (-1 === index) return;
-        return new DimensionNodeBuilder(dimensions.get(index));
+        return new MeasureNodeBuilder(measures.get(index));
     }
     findAll() {
-        const dimensions = this.dsl.get('dimensions');
-        return dimensions.toArray().map((yMap)=>new DimensionNodeBuilder(yMap));
+        const measures = this.dsl.get('measures');
+        return measures.toArray().map((yMap)=>new MeasureNodeBuilder(yMap));
     }
-    toJson() {
-        return this.dsl.get('dimensions').toJSON();
+    toJSON() {
+        return this.dsl.get('measures').toJSON();
     }
     observe(callback) {
-        this.dsl.get('dimensions').observe(callback);
+        this.dsl.get('measures').observe(callback);
         return ()=>{
-            this.dsl.get('dimensions').unobserve(callback);
+            this.dsl.get('measures').unobserve(callback);
         };
     }
-    static isDimensionNode(node) {
-        return 'alias' in node && !('children' in node);
+    static isMeasureNode(node) {
+        return 'encoding' in node || 'aggregate' in node;
     }
-    static isDimensionGroup(node) {
+    static isMeasureGroup(node) {
         return 'children' in node;
     }
 }
-class MeasureNodeBuilder {
+class DimensionNodeBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
@@ -127,88 +145,163 @@ class MeasureNodeBuilder {
         this.yMap.set('alias', alias);
         return this;
     }
-    setEncoding(encoding) {
-        this.yMap.set('encoding', encoding);
-        return this;
-    }
-    setAggregate(aggregate) {
-        this.yMap.set('aggregate', aggregate);
-        return this;
-    }
-    toJson() {
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class MeasuresBuilder {
+class DimensionsBuilder {
     dsl;
     constructor(_doc, dsl){
         this.dsl = dsl;
     }
     add(field, callback) {
-        const measure = {
+        const dimension = {
             alias: field,
-            field,
-            encoding: 'yAxis',
-            aggregate: {
-                func: 'sum'
-            }
+            field
         };
         const yMap = new external_yjs_namespaceObject.Map();
-        for (const [key, value] of Object.entries(measure))yMap.set(key, value);
-        this.dsl.get('measures').push([
+        for (const [key, value] of Object.entries(dimension))yMap.set(key, value);
+        this.dsl.get('dimensions').push([
             yMap
         ]);
-        const node = new MeasureNodeBuilder(yMap);
+        const node = new DimensionNodeBuilder(yMap);
         callback(node);
         return this;
     }
     remove(field) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 !== index) this.dsl.get('measures').delete(index, 1);
+        const dimensions = this.dsl.get('dimensions');
+        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
+        if (-1 !== index) this.dsl.get('dimensions').delete(index, 1);
         return this;
     }
     update(field, callback) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
-        if (-1 === index) throw new Error(`Measure with field "${field}" not found`);
-        const measureYMap = measures.get(index);
-        const node = new MeasureNodeBuilder(measureYMap);
+        const dimensions = this.dsl.get('dimensions');
+        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
+        if (-1 === index) throw new Error(`Dimension with field "${field}" not found`);
+        const dimensionYMap = dimensions.get(index);
+        const node = new DimensionNodeBuilder(dimensionYMap);
         callback(node);
         return this;
     }
     find(field) {
-        const measures = this.dsl.get('measures');
-        const index = measures.toArray().findIndex((item)=>item.get('field') === field);
+        const dimensions = this.dsl.get('dimensions');
+        const index = dimensions.toArray().findIndex((item)=>item.get('field') === field);
         if (-1 === index) return;
-        return new MeasureNodeBuilder(measures.get(index));
+        return new DimensionNodeBuilder(dimensions.get(index));
     }
     findAll() {
-        const measures = this.dsl.get('measures');
-        return measures.toArray().map((yMap)=>new MeasureNodeBuilder(yMap));
+        const dimensions = this.dsl.get('dimensions');
+        return dimensions.toArray().map((yMap)=>new DimensionNodeBuilder(yMap));
     }
-    toJson() {
-        return this.dsl.get('measures').toJSON();
+    toJSON() {
+        return this.dsl.get('dimensions').toJSON();
     }
     observe(callback) {
-        this.dsl.get('measures').observe(callback);
+        this.dsl.get('dimensions').observe(callback);
         return ()=>{
-            this.dsl.get('measures').unobserve(callback);
+            this.dsl.get('dimensions').unobserve(callback);
         };
     }
-    static isMeasureNode(node) {
-        return 'encoding' in node || 'aggregate' in node;
+    static isDimensionNode(node) {
+        return 'alias' in node && !('children' in node);
     }
-    static isMeasureGroup(node) {
+    static isDimensionGroup(node) {
         return 'children' in node;
     }
 }
 const vseed_namespaceObject = require("@visactor/vseed");
+class ChartTypeBuilder {
+    dsl;
+    constructor(_doc, dsl){
+        this.dsl = dsl;
+    }
+    observe(callback) {
+        const wrapper = (e, trans)=>{
+            if (e.keysChanged.has('chartType')) callback(e, trans);
+        };
+        this.dsl.observe(wrapper);
+        return ()=>{
+            this.dsl.unobserve(wrapper);
+        };
+    }
+    changeChartType(chartType) {
+        this.dsl.set('chartType', chartType);
+    }
+    getChartType() {
+        return this.dsl.get('chartType') || 'table';
+    }
+    toJSON() {
+        return this.dsl.get('chartType') || 'table';
+    }
+    getAvailableChartTypes() {
+        return [
+            vseed_namespaceObject.ChartTypeEnum.Table,
+            vseed_namespaceObject.ChartTypeEnum.PivotTable,
+            vseed_namespaceObject.ChartTypeEnum.Line,
+            vseed_namespaceObject.ChartTypeEnum.Column,
+            vseed_namespaceObject.ChartTypeEnum.ColumnPercent,
+            vseed_namespaceObject.ChartTypeEnum.ColumnParallel,
+            vseed_namespaceObject.ChartTypeEnum.BarPercent,
+            vseed_namespaceObject.ChartTypeEnum.BarParallel,
+            vseed_namespaceObject.ChartTypeEnum.Area,
+            vseed_namespaceObject.ChartTypeEnum.AreaPercent,
+            vseed_namespaceObject.ChartTypeEnum.DualAxis,
+            vseed_namespaceObject.ChartTypeEnum.Scatter,
+            vseed_namespaceObject.ChartTypeEnum.Rose,
+            vseed_namespaceObject.ChartTypeEnum.RoseParallel,
+            vseed_namespaceObject.ChartTypeEnum.Pie,
+            vseed_namespaceObject.ChartTypeEnum.Donut,
+            vseed_namespaceObject.ChartTypeEnum.Radar,
+            vseed_namespaceObject.ChartTypeEnum.Funnel,
+            vseed_namespaceObject.ChartTypeEnum.Heatmap,
+            vseed_namespaceObject.ChartTypeEnum.Boxplot,
+            vseed_namespaceObject.ChartTypeEnum.Histogram
+        ];
+    }
+}
 const external_uuid_namespaceObject = require("uuid");
 const id_id = {
     uuid: ()=>(0, external_uuid_namespaceObject.v4)()
 };
-class HavingFiltersNodeBuilder {
+function isVBIFilter(clause) {
+    return 'field' in clause;
+}
+function isVBIWhereGroup(clause) {
+    return 'conditions' in clause;
+}
+function isVBIHavingFilter(clause) {
+    return 'field' in clause;
+}
+function isVBIHavingGroup(clause) {
+    return 'conditions' in clause;
+}
+function createWhereGroup(op = 'and', groupId = 'root') {
+    const yMap = new external_yjs_namespaceObject.Map();
+    yMap.set('id', groupId);
+    yMap.set('op', op);
+    yMap.set('conditions', new external_yjs_namespaceObject.Array());
+    return yMap;
+}
+function isWhereGroup(yMap) {
+    return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
+}
+function findEntry(collection, entryId) {
+    const items = collection.toArray();
+    for(let index = 0; index < items.length; index++){
+        const item = items[index];
+        if (item.get('id') === entryId) return {
+            collection,
+            index,
+            item
+        };
+        if (isWhereGroup(item)) {
+            const nestedCollection = item.get('conditions');
+            const nestedMatch = findEntry(nestedCollection, entryId);
+            if (nestedMatch) return nestedMatch;
+        }
+    }
+}
+class WhereFilterNodeBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
@@ -219,26 +312,33 @@ class HavingFiltersNodeBuilder {
     getField() {
         return this.yMap.get('field');
     }
+    setField(field) {
+        this.yMap.set('field', field);
+        return this;
+    }
     getOperator() {
         return this.yMap.get('op');
     }
-    setValue(value) {
-        this.yMap.set('value', value);
-        return this;
-    }
     setOperator(operator) {
         this.yMap.set('op', operator);
         return this;
     }
-    toJson() {
+    setValue(value) {
+        this.yMap.set('value', value);
+        return this;
+    }
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class HavingGroupBuilder {
+class WhereGroupBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
     }
+    getConditions() {
+        return this.yMap.get('conditions');
+    }
     getId() {
         return this.yMap.get('id');
     }
@@ -253,29 +353,24 @@ class HavingGroupBuilder {
         const yMap = new external_yjs_namespaceObject.Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
-        const conditions = this.yMap.get('conditions');
-        conditions.push([
+        this.getConditions().push([
             yMap
         ]);
-        const node = new HavingFiltersNodeBuilder(yMap);
+        const node = new WhereFilterNodeBuilder(yMap);
         callback(node);
         return this;
     }
     addGroup(op, callback) {
-        const yMap = new external_yjs_namespaceObject.Map();
-        yMap.set('id', id_id.uuid());
-        yMap.set('op', op);
-        yMap.set('conditions', new external_yjs_namespaceObject.Array());
-        const conditions = this.yMap.get('conditions');
-        conditions.push([
+        const yMap = createWhereGroup(op, id_id.uuid());
+        this.getConditions().push([
             yMap
         ]);
-        const group = new HavingGroupBuilder(yMap);
+        const group = new WhereGroupBuilder(yMap);
         callback(group);
         return this;
     }
     remove(idOrIndex) {
-        const conditions = this.yMap.get('conditions');
+        const conditions = this.getConditions();
         if ('number' == typeof idOrIndex) {
             if (idOrIndex >= 0 && idOrIndex < conditions.length) conditions.delete(idOrIndex, 1);
         } else {
@@ -285,154 +380,138 @@ class HavingGroupBuilder {
         return this;
     }
     clear() {
-        const conditions = this.yMap.get('conditions');
+        const conditions = this.getConditions();
         conditions.delete(0, conditions.length);
         return this;
     }
-    toJson() {
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class HavingFiltersBuilder {
-    dsl;
-    doc;
+class WhereFilterBuilder {
+    whereFilter;
     constructor(doc, dsl){
-        this.doc = doc;
-        this.dsl = dsl;
-        if (!this.dsl.get('havingFilters')) this.doc.transact(()=>{
-            this.dsl.set('havingFilters', new external_yjs_namespaceObject.Array());
+        doc.transact(()=>{
+            const existingWhereFilter = dsl.get('whereFilter');
+            if (existingWhereFilter instanceof external_yjs_namespaceObject.Map) this.whereFilter = existingWhereFilter;
+            else {
+                this.whereFilter = createWhereGroup();
+                dsl.set('whereFilter', this.whereFilter);
+            }
+            if (!(this.whereFilter.get('conditions') instanceof external_yjs_namespaceObject.Array)) this.whereFilter.set('conditions', new external_yjs_namespaceObject.Array());
+            if (!this.whereFilter.get('id')) this.whereFilter.set('id', 'root');
+            if (!this.whereFilter.get('op')) this.whereFilter.set('op', 'and');
         });
     }
+    getConditions() {
+        return this.whereFilter.get('conditions');
+    }
     add(field, callback) {
         const yMap = new external_yjs_namespaceObject.Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
-        this.dsl.get('havingFilters').push([
+        this.getConditions().push([
             yMap
         ]);
-        const node = new HavingFiltersNodeBuilder(yMap);
+        const node = new WhereFilterNodeBuilder(yMap);
         callback(node);
         return this;
     }
     addGroup(op, callback) {
-        const yMap = new external_yjs_namespaceObject.Map();
-        yMap.set('id', id_id.uuid());
-        yMap.set('op', op);
-        yMap.set('conditions', new external_yjs_namespaceObject.Array());
-        this.dsl.get('havingFilters').push([
+        const yMap = createWhereGroup(op, id_id.uuid());
+        this.getConditions().push([
             yMap
         ]);
-        const group = new HavingGroupBuilder(yMap);
+        const group = new WhereGroupBuilder(yMap);
         callback(group);
         return this;
     }
     update(id, callback) {
-        const havingFilters = this.dsl.get('havingFilters');
-        const index = havingFilters.toArray().findIndex((item)=>item.get('id') === id);
-        if (-1 === index) throw new Error(`Having filter with id ${id} not found`);
-        const filterYMap = havingFilters.get(index);
-        const node = new HavingFiltersNodeBuilder(filterYMap);
+        const conditions = this.getConditions();
+        const match = findEntry(conditions, id);
+        if (!match) throw new Error(`Where filter with id ${id} not found`);
+        if (!WhereFilterBuilder.isNode(match.item)) throw new Error(`Item with id ${id} is not a filter`);
+        const filterYMap = match.item;
+        const node = new WhereFilterNodeBuilder(filterYMap);
         callback(node);
         return this;
     }
     updateGroup(id, callback) {
-        const havingFilters = this.dsl.get('havingFilters');
-        const index = havingFilters.toArray().findIndex((item)=>item.get('id') === id);
-        if (-1 === index) throw new Error(`Having group with id ${id} not found`);
-        const yMap = havingFilters.get(index);
-        if (!HavingFiltersBuilder.isGroup(yMap)) throw new Error(`Item with id ${id} is not a group`);
-        const group = new HavingGroupBuilder(yMap);
+        const conditions = this.getConditions();
+        const match = findEntry(conditions, id);
+        if (!match) throw new Error(`Where group with id ${id} not found`);
+        const yMap = match.item;
+        if (!WhereFilterBuilder.isGroup(yMap)) throw new Error(`Item with id ${id} is not a group`);
+        const group = new WhereGroupBuilder(yMap);
         callback(group);
         return this;
     }
     remove(idOrIndex) {
-        const havingFilters = this.dsl.get('havingFilters');
+        const conditions = this.getConditions();
         if ('number' == typeof idOrIndex) {
-            if (idOrIndex >= 0 && idOrIndex < havingFilters.length) havingFilters.delete(idOrIndex, 1);
+            if (idOrIndex >= 0 && idOrIndex < conditions.length) conditions.delete(idOrIndex, 1);
         } else {
-            const index = havingFilters.toArray().findIndex((item)=>item.get('id') === idOrIndex);
-            if (-1 !== index) havingFilters.delete(index, 1);
+            const match = findEntry(conditions, idOrIndex);
+            if (match) match.collection.delete(match.index, 1);
         }
         return this;
     }
     find(id) {
-        const havingFilters = this.dsl.get('havingFilters');
-        const yMap = havingFilters.toArray().find((item)=>item.get('id') === id);
+        const conditions = this.getConditions();
+        const match = findEntry(conditions, id);
+        const yMap = match?.item;
         if (!yMap) return;
-        if (HavingFiltersBuilder.isGroup(yMap)) return new HavingGroupBuilder(yMap);
-        return new HavingFiltersNodeBuilder(yMap);
+        if (WhereFilterBuilder.isGroup(yMap)) return new WhereGroupBuilder(yMap);
+        return new WhereFilterNodeBuilder(yMap);
     }
     clear() {
-        const havingFilters = this.dsl.get('havingFilters');
-        havingFilters.delete(0, havingFilters.length);
+        const conditions = this.getConditions();
+        conditions.delete(0, conditions.length);
         return this;
     }
-    toJson() {
-        return this.dsl.get('havingFilters').toJSON();
+    toJSON() {
+        return this.whereFilter.toJSON();
     }
     observe(callback) {
-        this.dsl.get('havingFilters').observe(callback);
+        this.whereFilter.observeDeep(callback);
         return ()=>{
-            this.dsl.get('havingFilters').unobserve(callback);
+            this.whereFilter.unobserveDeep(callback);
         };
     }
     static isGroup(yMap) {
-        return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
+        return isWhereGroup(yMap);
     }
     static isNode(yMap) {
         return void 0 !== yMap.get('field');
     }
 }
-class ChartTypeBuilder {
-    dsl;
-    constructor(_doc, dsl){
-        this.dsl = dsl;
-    }
-    observe(callback) {
-        const wrapper = (e, trans)=>{
-            if (e.keysChanged.has('chartType')) callback(e, trans);
-        };
-        this.dsl.observe(wrapper);
-        return ()=>{
-            this.dsl.unobserve(wrapper);
+function createHavingGroup(op = 'and', groupId = 'root') {
+    const yMap = new external_yjs_namespaceObject.Map();
+    yMap.set('id', groupId);
+    yMap.set('op', op);
+    yMap.set('conditions', new external_yjs_namespaceObject.Array());
+    return yMap;
+}
+function isHavingGroup(yMap) {
+    return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
+}
+function having_utils_findEntry(collection, entryId) {
+    const items = collection.toArray();
+    for(let index = 0; index < items.length; index++){
+        const item = items[index];
+        if (item.get('id') === entryId) return {
+            collection,
+            index,
+            item
         };
-    }
-    changeChartType(chartType) {
-        this.dsl.set('chartType', chartType);
-    }
-    getChartType() {
-        return this.dsl.get('chartType') || 'table';
-    }
-    toJson() {
-        return this.dsl.get('chartType') || 'table';
-    }
-    getAvailableChartTypes() {
-        return [
-            vseed_namespaceObject.ChartTypeEnum.Table,
-            vseed_namespaceObject.ChartTypeEnum.PivotTable,
-            vseed_namespaceObject.ChartTypeEnum.Line,
-            vseed_namespaceObject.ChartTypeEnum.Column,
-            vseed_namespaceObject.ChartTypeEnum.ColumnPercent,
-            vseed_namespaceObject.ChartTypeEnum.ColumnParallel,
-            vseed_namespaceObject.ChartTypeEnum.BarPercent,
-            vseed_namespaceObject.ChartTypeEnum.BarParallel,
-            vseed_namespaceObject.ChartTypeEnum.Area,
-            vseed_namespaceObject.ChartTypeEnum.AreaPercent,
-            vseed_namespaceObject.ChartTypeEnum.DualAxis,
-            vseed_namespaceObject.ChartTypeEnum.Scatter,
-            vseed_namespaceObject.ChartTypeEnum.Rose,
-            vseed_namespaceObject.ChartTypeEnum.RoseParallel,
-            vseed_namespaceObject.ChartTypeEnum.Pie,
-            vseed_namespaceObject.ChartTypeEnum.Donut,
-            vseed_namespaceObject.ChartTypeEnum.Radar,
-            vseed_namespaceObject.ChartTypeEnum.Funnel,
-            vseed_namespaceObject.ChartTypeEnum.Heatmap,
-            vseed_namespaceObject.ChartTypeEnum.Boxplot,
-            vseed_namespaceObject.ChartTypeEnum.Histogram
-        ];
+        if (isHavingGroup(item)) {
+            const nestedCollection = item.get('conditions');
+            const nestedMatch = having_utils_findEntry(nestedCollection, entryId);
+            if (nestedMatch) return nestedMatch;
+        }
     }
 }
-class WhereFilterNodeBuilder {
+class HavingFilterNodeBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
@@ -446,23 +525,26 @@ class WhereFilterNodeBuilder {
     getOperator() {
         return this.yMap.get('op');
     }
-    setOperator(operator) {
-        this.yMap.set('op', operator);
-        return this;
-    }
     setValue(value) {
         this.yMap.set('value', value);
         return this;
     }
-    toJson() {
+    setOperator(operator) {
+        this.yMap.set('op', operator);
+        return this;
+    }
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class WhereGroupBuilder {
+class HavingGroupBuilder {
     yMap;
     constructor(yMap){
         this.yMap = yMap;
     }
+    getConditions() {
+        return this.yMap.get('conditions');
+    }
     getId() {
         return this.yMap.get('id');
     }
@@ -477,29 +559,24 @@ class WhereGroupBuilder {
         const yMap = new external_yjs_namespaceObject.Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
-        const conditions = this.yMap.get('conditions');
-        conditions.push([
+        this.getConditions().push([
             yMap
         ]);
-        const node = new WhereFilterNodeBuilder(yMap);
+        const node = new HavingFilterNodeBuilder(yMap);
         callback(node);
         return this;
     }
     addGroup(op, callback) {
-        const yMap = new external_yjs_namespaceObject.Map();
-        yMap.set('id', id_id.uuid());
-        yMap.set('op', op);
-        yMap.set('conditions', new external_yjs_namespaceObject.Array());
-        const conditions = this.yMap.get('conditions');
-        conditions.push([
+        const yMap = createHavingGroup(op, id_id.uuid());
+        this.getConditions().push([
             yMap
         ]);
-        const group = new WhereGroupBuilder(yMap);
+        const group = new HavingGroupBuilder(yMap);
         callback(group);
         return this;
     }
     remove(idOrIndex) {
-        const conditions = this.yMap.get('conditions');
+        const conditions = this.getConditions();
         if ('number' == typeof idOrIndex) {
             if (idOrIndex >= 0 && idOrIndex < conditions.length) conditions.delete(idOrIndex, 1);
         } else {
@@ -509,104 +586,183 @@ class WhereGroupBuilder {
         return this;
     }
     clear() {
-        const conditions = this.yMap.get('conditions');
+        const conditions = this.getConditions();
         conditions.delete(0, conditions.length);
         return this;
     }
-    toJson() {
+    toJSON() {
         return this.yMap.toJSON();
     }
 }
-class WhereFiltersBuilder {
-    dsl;
-    doc;
+class HavingFilterBuilder {
+    havingFilter;
     constructor(doc, dsl){
-        this.doc = doc;
-        this.dsl = dsl;
-        if (!this.dsl.get('whereFilters')) this.doc.transact(()=>{
-            this.dsl.set('whereFilters', new external_yjs_namespaceObject.Array());
+        doc.transact(()=>{
+            const existingHavingFilter = dsl.get('havingFilter');
+            if (existingHavingFilter instanceof external_yjs_namespaceObject.Map) this.havingFilter = existingHavingFilter;
+            else {
+                this.havingFilter = createHavingGroup();
+                dsl.set('havingFilter', this.havingFilter);
+            }
+            if (!(this.havingFilter.get('conditions') instanceof external_yjs_namespaceObject.Array)) this.havingFilter.set('conditions', new external_yjs_namespaceObject.Array());
+            if (!this.havingFilter.get('id')) this.havingFilter.set('id', 'root');
+            if (!this.havingFilter.get('op')) this.havingFilter.set('op', 'and');
         });
     }
+    getConditions() {
+        return this.havingFilter.get('conditions');
+    }
     add(field, callback) {
         const yMap = new external_yjs_namespaceObject.Map();
         yMap.set('id', id_id.uuid());
         yMap.set('field', field);
-        this.dsl.get('whereFilters').push([
+        this.getConditions().push([
             yMap
         ]);
-        const node = new WhereFilterNodeBuilder(yMap);
+        const node = new HavingFilterNodeBuilder(yMap);
         callback(node);
         return this;
     }
     addGroup(op, callback) {
-        const yMap = new external_yjs_namespaceObject.Map();
-        yMap.set('id', id_id.uuid());
-        yMap.set('op', op);
-        yMap.set('conditions', new external_yjs_namespaceObject.Array());
-        this.dsl.get('whereFilters').push([
+        const yMap = createHavingGroup(op, id_id.uuid());
+        this.getConditions().push([
             yMap
         ]);
-        const group = new WhereGroupBuilder(yMap);
+        const group = new HavingGroupBuilder(yMap);
         callback(group);
         return this;
     }
     update(id, callback) {
-        const whereFilters = this.dsl.get('whereFilters');
-        const index = whereFilters.toArray().findIndex((item)=>item.get('id') === id);
-        if (-1 === index) throw new Error(`Where filter with id ${id} not found`);
-        const filterYMap = whereFilters.get(index);
-        const node = new WhereFilterNodeBuilder(filterYMap);
+        const conditions = this.getConditions();
+        const match = having_utils_findEntry(conditions, id);
+        if (!match) throw new Error(`Having filter with id ${id} not found`);
+        if (!HavingFilterBuilder.isNode(match.item)) throw new Error(`Item with id ${id} is not a filter`);
+        const filterYMap = match.item;
+        const node = new HavingFilterNodeBuilder(filterYMap);
         callback(node);
         return this;
     }
     updateGroup(id, callback) {
-        const whereFilters = this.dsl.get('whereFilters');
-        const index = whereFilters.toArray().findIndex((item)=>item.get('id') === id);
-        if (-1 === index) throw new Error(`Where group with id ${id} not found`);
-        const yMap = whereFilters.get(index);
-        if (!WhereFiltersBuilder.isGroup(yMap)) throw new Error(`Item with id ${id} is not a group`);
-        const group = new WhereGroupBuilder(yMap);
+        const conditions = this.getConditions();
+        const match = having_utils_findEntry(conditions, id);
+        if (!match) throw new Error(`Having group with id ${id} not found`);
+        const yMap = match.item;
+        if (!HavingFilterBuilder.isGroup(yMap)) throw new Error(`Item with id ${id} is not a group`);
+        const group = new HavingGroupBuilder(yMap);
         callback(group);
         return this;
     }
     remove(idOrIndex) {
-        const whereFilters = this.dsl.get('whereFilters');
+        const conditions = this.getConditions();
         if ('number' == typeof idOrIndex) {
-            if (idOrIndex >= 0 && idOrIndex < whereFilters.length) whereFilters.delete(idOrIndex, 1);
+            if (idOrIndex >= 0 && idOrIndex < conditions.length) conditions.delete(idOrIndex, 1);
         } else {
-            const index = whereFilters.toArray().findIndex((item)=>item.get('id') === idOrIndex);
-            if (-1 !== index) whereFilters.delete(index, 1);
+            const match = having_utils_findEntry(conditions, idOrIndex);
+            if (match) match.collection.delete(match.index, 1);
         }
         return this;
     }
     find(id) {
-        const whereFilters = this.dsl.get('whereFilters');
-        const yMap = whereFilters.toArray().find((item)=>item.get('id') === id);
+        const conditions = this.getConditions();
+        const match = having_utils_findEntry(conditions, id);
+        const yMap = match?.item;
         if (!yMap) return;
-        if (WhereFiltersBuilder.isGroup(yMap)) return new WhereGroupBuilder(yMap);
-        return new WhereFilterNodeBuilder(yMap);
+        if (HavingFilterBuilder.isGroup(yMap)) return new HavingGroupBuilder(yMap);
+        return new HavingFilterNodeBuilder(yMap);
     }
     clear() {
-        const whereFilters = this.dsl.get('whereFilters');
-        whereFilters.delete(0, whereFilters.length);
+        const conditions = this.getConditions();
+        conditions.delete(0, conditions.length);
         return this;
     }
-    toJson() {
-        return this.dsl.get('whereFilters').toJSON();
+    toJSON() {
+        return this.havingFilter.toJSON();
     }
     observe(callback) {
-        this.dsl.get('whereFilters').observe(callback);
+        this.havingFilter.observeDeep(callback);
         return ()=>{
-            this.dsl.get('whereFilters').unobserve(callback);
+            this.havingFilter.unobserveDeep(callback);
         };
     }
     static isGroup(yMap) {
-        return void 0 !== yMap.get('op') && void 0 !== yMap.get('conditions');
+        return isHavingGroup(yMap);
     }
     static isNode(yMap) {
         return void 0 !== yMap.get('field');
     }
 }
+class ThemeBuilder {
+    dsl;
+    constructor(_doc, dsl){
+        this.dsl = dsl;
+    }
+    observe(callback) {
+        const wrapper = (e, trans)=>{
+            if (e.keysChanged.has('theme')) callback(e, trans);
+        };
+        this.dsl.observe(wrapper);
+        return ()=>{
+            this.dsl.unobserve(wrapper);
+        };
+    }
+    setTheme(theme) {
+        this.dsl.set('theme', theme);
+    }
+    getTheme() {
+        return this.dsl.get('theme') || 'light';
+    }
+    toJSON() {
+        return this.getTheme();
+    }
+}
+class LocaleBuilder {
+    dsl;
+    constructor(_doc, dsl){
+        this.dsl = dsl;
+    }
+    observe(callback) {
+        const wrapper = (e, trans)=>{
+            if (e.keysChanged.has('locale')) callback(e, trans);
+        };
+        this.dsl.observe(wrapper);
+        return ()=>{
+            this.dsl.unobserve(wrapper);
+        };
+    }
+    setLocale(locale) {
+        this.dsl.set('locale', locale);
+    }
+    getLocale() {
+        return this.dsl.get('locale') || 'zh-CN';
+    }
+    toJSON() {
+        return this.getLocale();
+    }
+}
+class LimitBuilder {
+    dsl;
+    constructor(_doc, dsl){
+        this.dsl = dsl;
+    }
+    observe(callback) {
+        const wrapper = (e, trans)=>{
+            if (e.keysChanged.has('limit')) callback(e, trans);
+        };
+        this.dsl.observe(wrapper);
+        return ()=>{
+            this.dsl.unobserve(wrapper);
+        };
+    }
+    setLimit(limit) {
+        this.dsl.set('limit', limit);
+    }
+    getLimit() {
+        return this.dsl.get('limit');
+    }
+    toJSON() {
+        return this.getLimit();
+    }
+}
 class UndoManager {
     manager;
     constructor(scope){
@@ -662,22 +818,19 @@ const buildGroupBy = (queryDSL, context)=>{
 };
 const buildWhere = (queryDSL, context)=>{
     const { vbiDSL } = context;
-    const whereFilters = vbiDSL.whereFilters || [];
-    if (0 === whereFilters.length) return queryDSL;
+    const whereFilter = vbiDSL.whereFilter;
+    if (!whereFilter || 0 === whereFilter.conditions.length) return queryDSL;
     const result = {
         ...queryDSL
     };
-    result.where = {
-        op: 'and',
-        conditions: whereFilters.flatMap(mapClauseToCondition)
-    };
+    result.where = mapGroupToCondition(whereFilter);
     return result;
 };
-function isWhereGroup(clause) {
+function buildWhere_isWhereGroup(clause) {
     return 'op' in clause && 'conditions' in clause;
 }
 function mapClauseToCondition(clause) {
-    if (isWhereGroup(clause)) return [
+    if (buildWhere_isWhereGroup(clause)) return [
         mapGroupToCondition(clause)
     ];
     return mapFilterToCondition(clause);
@@ -689,23 +842,62 @@ function mapGroupToCondition(group) {
     };
 }
 function mapFilterToCondition(filter) {
-    if ('between' === filter.op) return handleBetweenFilter(filter);
+    if ('between' === filter.op || 'not between' === filter.op) return handleBetweenFilter(filter);
     return handleSimpleFilter(filter);
 }
 function handleBetweenFilter(filter) {
-    const conditions = [];
-    const value = filter.value;
-    if (void 0 !== value.min && null !== value.min && '' !== value.min) conditions.push({
+    const value = normalizeBetweenValue(filter.value);
+    const lowerCondition = void 0 !== value.min && null !== value.min && '' !== value.min ? {
         field: filter.field,
         op: '<' === value.leftOp ? '>' : '>=',
         value: value.min
-    });
-    if (void 0 !== value.max && null !== value.max && '' !== value.max) conditions.push({
+    } : void 0;
+    const upperCondition = void 0 !== value.max && null !== value.max && '' !== value.max ? {
         field: filter.field,
         op: '<' === value.rightOp ? '<' : '<=',
         value: value.max
-    });
-    return conditions;
+    } : void 0;
+    if ('not between' === filter.op) {
+        const outsideConditions = [
+            lowerCondition && invertLowerBound(lowerCondition),
+            upperCondition && invertUpperBound(upperCondition)
+        ].filter(Boolean);
+        if (outsideConditions.length <= 1) return outsideConditions;
+        return [
+            {
+                op: 'or',
+                conditions: outsideConditions
+            }
+        ];
+    }
+    return [
+        lowerCondition,
+        upperCondition
+    ].filter(Boolean);
+}
+function normalizeBetweenValue(value) {
+    if (Array.isArray(value)) return {
+        min: value[0],
+        max: value[1],
+        leftOp: '<=',
+        rightOp: '<='
+    };
+    if ('object' == typeof value && null !== value) return value;
+    return {};
+}
+function invertLowerBound(condition) {
+    return {
+        field: condition.field,
+        op: '>' === condition.op ? '<=' : '<',
+        value: condition.value
+    };
+}
+function invertUpperBound(condition) {
+    return {
+        field: condition.field,
+        op: '<' === condition.op ? '>=' : '>',
+        value: condition.value
+    };
 }
 function handleSimpleFilter(filter) {
     let mappedOp = filter.op ?? '=';
@@ -724,22 +916,22 @@ function handleSimpleFilter(filter) {
 }
 const buildHaving = (queryDSL, context)=>{
     const { vbiDSL } = context;
-    const havingFilters = vbiDSL.havingFilters || [];
-    if (0 === havingFilters.length) return queryDSL;
+    const havingFilter = vbiDSL.havingFilter;
+    if (!havingFilter || 0 === havingFilter.conditions.length) return queryDSL;
     const result = {
         ...queryDSL
     };
     result.having = {
-        op: 'and',
-        conditions: havingFilters.flatMap(buildHaving_mapClauseToCondition)
+        op: havingFilter.op,
+        conditions: havingFilter.conditions.flatMap(buildHaving_mapClauseToCondition)
     };
     return result;
 };
-function isHavingGroup(clause) {
+function buildHaving_isHavingGroup(clause) {
     return 'op' in clause && 'conditions' in clause;
 }
 function buildHaving_mapClauseToCondition(clause) {
-    if (isHavingGroup(clause)) return [
+    if (buildHaving_isHavingGroup(clause)) return [
         buildHaving_mapGroupToCondition(clause)
     ];
     return buildHaving_mapFilterToCondition(clause);
@@ -792,8 +984,11 @@ class VBIBuilder {
     chartType;
     measures;
     dimensions;
-    havingFilters;
-    whereFilters;
+    havingFilter;
+    whereFilter;
+    theme;
+    locale;
+    limit;
     constructor(doc){
         this.doc = doc;
         this.dsl = doc.getMap('dsl');
@@ -801,8 +996,11 @@ class VBIBuilder {
         this.chartType = new ChartTypeBuilder(doc, this.dsl);
         this.measures = new MeasuresBuilder(doc, this.dsl);
         this.dimensions = new DimensionsBuilder(doc, this.dsl);
-        this.havingFilters = new HavingFiltersBuilder(doc, this.dsl);
-        this.whereFilters = new WhereFiltersBuilder(doc, this.dsl);
+        this.havingFilter = new HavingFilterBuilder(doc, this.dsl);
+        this.whereFilter = new WhereFilterBuilder(doc, this.dsl);
+        this.theme = new ThemeBuilder(doc, this.dsl);
+        this.locale = new LocaleBuilder(doc, this.dsl);
+        this.limit = new LimitBuilder(doc, this.dsl);
     }
     applyUpdate(update) {
         external_yjs_namespaceObject.applyUpdate(this.doc, update);
@@ -839,18 +1037,6 @@ class VBIBuilder {
         const result = await con.discoverSchema();
         return result;
     };
-    setLimit(limit) {
-        this.dsl.set('limit', limit);
-        return this;
-    }
-    setLocale(locale) {
-        this.dsl.set('locale', locale);
-        return this;
-    }
-    setTheme(theme) {
-        this.dsl.set('theme', theme);
-        return this;
-    }
 }
 const createVBI = ()=>({
         connectorMap: connectorMap,
@@ -861,8 +1047,16 @@ const createVBI = ()=>({
                 chartType: 'table',
                 measures: [],
                 dimensions: [],
-                whereFilters: [],
-                havingFilters: [],
+                whereFilter: {
+                    id: 'root',
+                    op: 'and',
+                    conditions: []
+                },
+                havingFilter: {
+                    id: 'root',
+                    op: 'and',
+                    conditions: []
+                },
                 theme: 'light',
                 locale: 'zh-CN',
                 version: 0
@@ -876,7 +1070,7 @@ const createVBI = ()=>({
                 if (vbi.theme) dsl.set('theme', vbi.theme);
                 if (vbi.limit) dsl.set('limit', vbi.limit);
                 if (vbi.locale) dsl.set('locale', vbi.locale);
-                if (vbi.version) dsl.set('version', vbi.version);
+                if (void 0 !== vbi.version) dsl.set('version', vbi.version);
                 const toYMap = (obj, ensureId = false)=>{
                     const yMap = new external_yjs_namespaceObject.Map();
                     if (ensureId && !obj.id) yMap.set('id', id_id.uuid());
@@ -914,8 +1108,38 @@ const createVBI = ()=>({
                     });
                     return yArr;
                 };
-                dsl.set('whereFilters', ensureYArray(vbi.whereFilters, true));
-                dsl.set('havingFilters', ensureYArray(vbi.havingFilters, true));
+                const whereFilter = vbi.whereFilter ?? {
+                    id: 'root',
+                    op: 'and',
+                    conditions: []
+                };
+                const whereGroup = whereFilter instanceof external_yjs_namespaceObject.Map ? whereFilter : createWhereGroup();
+                if (whereFilter instanceof external_yjs_namespaceObject.Map) {
+                    if (!(whereGroup.get('conditions') instanceof external_yjs_namespaceObject.Array)) whereGroup.set('conditions', new external_yjs_namespaceObject.Array());
+                    if (!whereGroup.get('id')) whereGroup.set('id', 'root');
+                    if (!whereGroup.get('op')) whereGroup.set('op', 'and');
+                } else {
+                    whereGroup.set('id', whereFilter.id ?? 'root');
+                    whereGroup.set('op', whereFilter.op ?? 'and');
+                    whereGroup.set('conditions', ensureYArray(whereFilter.conditions, true));
+                }
+                dsl.set('whereFilter', whereGroup);
+                const havingFilter = vbi.havingFilter ?? {
+                    id: 'root',
+                    op: 'and',
+                    conditions: []
+                };
+                const havingGroup = havingFilter instanceof external_yjs_namespaceObject.Map ? havingFilter : createHavingGroup();
+                if (havingFilter instanceof external_yjs_namespaceObject.Map) {
+                    if (!(havingGroup.get('conditions') instanceof external_yjs_namespaceObject.Array)) havingGroup.set('conditions', new external_yjs_namespaceObject.Array());
+                    if (!havingGroup.get('id')) havingGroup.set('id', 'root');
+                    if (!havingGroup.get('op')) havingGroup.set('op', 'and');
+                } else {
+                    havingGroup.set('id', havingFilter.id ?? 'root');
+                    havingGroup.set('op', havingFilter.op ?? 'and');
+                    havingGroup.set('conditions', ensureYArray(havingFilter.conditions, true));
+                }
+                dsl.set('havingFilter', havingGroup);
                 dsl.set('measures', ensureYArray(vbi.measures));
                 dsl.set('dimensions', ensureYArray(vbi.dimensions));
             });
@@ -923,60 +1147,17 @@ const createVBI = ()=>({
         }
     });
 const VBI = createVBI();
-const external_zod_namespaceObject = require("zod");
-const zVBIFilter = external_zod_namespaceObject.z.object({
-    id: external_zod_namespaceObject.z.string(),
-    field: external_zod_namespaceObject.z.string(),
-    op: external_zod_namespaceObject.z.string().optional(),
-    value: external_zod_namespaceObject.z.any().optional()
-});
-const zVBIWhereGroup = external_zod_namespaceObject.z.lazy(()=>external_zod_namespaceObject.z.object({
-        id: external_zod_namespaceObject.z.string(),
-        op: external_zod_namespaceObject.z["enum"]([
-            'and',
-            'or'
-        ]),
-        conditions: external_zod_namespaceObject.z.array(zVBIWhereClause)
-    }));
-const zVBIWhereClause = external_zod_namespaceObject.z.lazy(()=>external_zod_namespaceObject.z.union([
-        zVBIFilter,
-        zVBIWhereGroup
-    ]));
-function isVBIFilter(clause) {
-    return 'field' in clause;
-}
-function isVBIWhereGroup(clause) {
-    return 'conditions' in clause;
-}
-const zVBIHavingFilter = external_zod_namespaceObject.z.object({
-    id: external_zod_namespaceObject.z.string(),
-    field: external_zod_namespaceObject.z.string(),
-    op: external_zod_namespaceObject.z.string().optional(),
-    value: external_zod_namespaceObject.z.any().optional()
-});
-const zVBIHavingGroup = external_zod_namespaceObject.z.lazy(()=>external_zod_namespaceObject.z.object({
-        id: external_zod_namespaceObject.z.string(),
-        op: external_zod_namespaceObject.z["enum"]([
-            'and',
-            'or'
-        ]),
-        conditions: external_zod_namespaceObject.z.array(zVBIHavingClause)
-    }));
-const zVBIHavingClause = external_zod_namespaceObject.z.lazy(()=>external_zod_namespaceObject.z.union([
-        zVBIHavingFilter,
-        zVBIHavingGroup
-    ]));
-function isVBIHavingFilter(clause) {
-    return 'field' in clause;
-}
-function isVBIHavingGroup(clause) {
-    return 'conditions' in clause;
-}
 exports.ChartTypeBuilder = __webpack_exports__.ChartTypeBuilder;
 exports.DimensionsBuilder = __webpack_exports__.DimensionsBuilder;
+exports.HavingFilterBuilder = __webpack_exports__.HavingFilterBuilder;
+exports.LimitBuilder = __webpack_exports__.LimitBuilder;
+exports.LocaleBuilder = __webpack_exports__.LocaleBuilder;
 exports.MeasuresBuilder = __webpack_exports__.MeasuresBuilder;
+exports.ThemeBuilder = __webpack_exports__.ThemeBuilder;
+exports.UndoManager = __webpack_exports__.UndoManager;
 exports.VBI = __webpack_exports__.VBI;
 exports.VBIBuilder = __webpack_exports__.VBIBuilder;
+exports.WhereFilterBuilder = __webpack_exports__.WhereFilterBuilder;
 exports.buildVQuery = __webpack_exports__.buildVQuery;
 exports.findTreeNodesBy = __webpack_exports__.findTreeNodesBy;
 exports.id = __webpack_exports__.id;
@@ -988,9 +1169,15 @@ exports.preorderTraverse = __webpack_exports__.preorderTraverse;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "ChartTypeBuilder",
     "DimensionsBuilder",
+    "HavingFilterBuilder",
+    "LimitBuilder",
+    "LocaleBuilder",
     "MeasuresBuilder",
+    "ThemeBuilder",
+    "UndoManager",
     "VBI",
     "VBIBuilder",
+    "WhereFilterBuilder",
     "buildVQuery",
     "findTreeNodesBy",
     "id",