@guandata/guanvis 0.1.18 → 0.1.19

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## @guandata/guanvis 0.1.19 - 2026-05-26
+
+- 筛选器默认值校验增强，日历筛选器会校验绑定字段类型，避免非日期字段误配日期默认值。
+- 增强来源动态字段、联动筛选器和默认值映射的校验，提前发现无法可靠发布的配置。
+- 补充相关测试覆盖和 builder 参考文档说明，提升复杂筛选器配置的可诊断性。
+
 ## @guandata/guanvis 0.1.18 - 2026-05-25
 
 - 新增 Tab 布局能力，支持通过 `createTab()` / `addPanel()` 组织同页多组可切换内容。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guanvis",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "观远 BI Card/Page 生成工具 - 通过 JS DSL 创建图表和仪表板",
   "bin": {
     "guanvis": "bin/run.js"

package/skills/guanvis/references/builder-reference.md

@@ -223,6 +223,7 @@ registerPage(page.build());
 | `.setDefaultType(type)` | 默认值类型：`SelectorDefaultType.FIRST_PICK`（默认）、`FIXED_VALUE` 或 `ALL` |
 | `.setDefaultAll()` | 设置默认"全部"（不筛选），等价于 `setDefaultType(SelectorDefaultType.ALL)` |
 | `.setDefaultValue(values, displayValues?)` | 设置固定默认值，自动切换为 FIXED_VALUE 类型 |
+| `.setDefaultDateRange(start, end, displayValues?)` | 设置 `CALENDAR` 日期区间默认值，自动切换为 FIXED_VALUE；比手写数组更不容易漏填区间端点 |
 | `.setFirstPickLink(bool)` | FIRST_PICK 模式下是否联动刷新（默认 false） |
 | `.setDisplayType(type)` | 展示类型（仅 `DS_ELEMENTS` 使用）：`SelectorDisplay.SEARCH_LIST`（单选下拉）、`SEARCH_BOX`（多选下拉）、`CHECKBOX`（复选框）、`RADIO`（单选框）、`BUTTON_GROUP`（按钮组）。不设置时根据 multiSelect 自动选择。`DS_INTERVAL` 类型不需要此设置 |
 | `.setShowSelectAll(bool)` | 是否显示"全选"（默认 true） |
@@ -257,6 +258,21 @@ registerSelector(sel);
 // 也可设置 .setFilterType("EQ") 单值等于，或 "GT"/"LT" 等比较
 ```
 
+```javascript
+// selector_03_date.js — 日期范围（CALENDAR）
+var sel = createSelector("日期筛选")
+    .setId("abc123def456abc123def456")
+    .setSelectorType(SelectorType.CALENDAR)
+    .bindField(f("订单日期"))
+    .setDefaultDateRange("2026-01-01", "2026-01-31")
+    .linkToAll()
+    .build();
+registerSelector(sel);
+// CALENDAR 默认 filterType="BT"（区间），固定默认值必须是 2 个日期值。
+// 支持 "2026-01-15"、"2026-01"、"2026-Q1"、"2026-W03"、"2026" 等格式。
+// 同一个默认值数组必须使用同一粒度；未显式 setGranularity 时会从默认值格式推断粒度。
+```
+
 ```javascript
 // selector_03_timemacro.js — 快捷日期（TIME_MACRO）
 var sel = createSelector("快捷日期")