@ahoo-wang/wow-view-engine 10.0.0-alpha.6 → 10.0.0-alpha.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) hide show
  1. package/README.md +60 -16
  2. package/README.zh-CN.md +55 -16
  3. package/dist/{actions-CgaL6eEe.js → actions-BWlediub.js} +3992 -3957
  4. package/dist/actions-BWlediub.js.map +1 -0
  5. package/dist/analysis/additive.d.ts +2 -2
  6. package/dist/analysis/additive.d.ts.map +1 -1
  7. package/dist/analysis/boxplot.d.ts.map +1 -1
  8. package/dist/analysis/bucketChange.d.ts +1 -1
  9. package/dist/analysis/buckets.d.ts +5 -5
  10. package/dist/analysis/buckets.d.ts.map +1 -1
  11. package/dist/analysis/budget.d.ts.map +1 -1
  12. package/dist/analysis/candidates.d.ts +2 -1
  13. package/dist/analysis/candidates.d.ts.map +1 -1
  14. package/dist/analysis/candlestick.d.ts.map +1 -1
  15. package/dist/analysis/capability.d.ts.map +1 -1
  16. package/dist/analysis/cartesian.d.ts.map +1 -1
  17. package/dist/analysis/chartFamilies.d.ts +1 -1
  18. package/dist/analysis/chartOptions.d.ts +13 -2
  19. package/dist/analysis/chartOptions.d.ts.map +1 -1
  20. package/dist/analysis/chartSlots.d.ts.map +1 -1
  21. package/dist/analysis/compile.d.ts +1 -1
  22. package/dist/analysis/compile.d.ts.map +1 -1
  23. package/dist/analysis/currency.d.ts.map +1 -1
  24. package/dist/analysis/dangling.d.ts +2 -1
  25. package/dist/analysis/dangling.d.ts.map +1 -1
  26. package/dist/analysis/defaults.d.ts +10 -9
  27. package/dist/analysis/defaults.d.ts.map +1 -1
  28. package/dist/analysis/derived.d.ts +2 -2
  29. package/dist/analysis/derived.d.ts.map +1 -1
  30. package/dist/analysis/drill.d.ts +12 -6
  31. package/dist/analysis/drill.d.ts.map +1 -1
  32. package/dist/analysis/drillFilter.d.ts.map +1 -1
  33. package/dist/analysis/expand.d.ts +1 -1
  34. package/dist/analysis/expand.d.ts.map +1 -1
  35. package/dist/analysis/expressions.d.ts.map +1 -1
  36. package/dist/analysis/familyRules.d.ts +2 -2
  37. package/dist/analysis/familyRules.d.ts.map +1 -1
  38. package/dist/analysis/familySlots.d.ts +4 -4
  39. package/dist/analysis/fitCharts.d.ts +2 -2
  40. package/dist/analysis/fitCharts.d.ts.map +1 -1
  41. package/dist/analysis/formula.d.ts +10 -9
  42. package/dist/analysis/formula.d.ts.map +1 -1
  43. package/dist/analysis/granularity.d.ts +2 -2
  44. package/dist/analysis/granularity.d.ts.map +1 -1
  45. package/dist/analysis/having.d.ts +2 -1
  46. package/dist/analysis/having.d.ts.map +1 -1
  47. package/dist/analysis/logScale.d.ts +1 -1
  48. package/dist/analysis/metricCard.d.ts +2 -2
  49. package/dist/analysis/metricCard.d.ts.map +1 -1
  50. package/dist/analysis/metricCondition.d.ts +1 -1
  51. package/dist/analysis/metricCondition.d.ts.map +1 -1
  52. package/dist/analysis/metricFormat.d.ts +3 -2
  53. package/dist/analysis/metricFormat.d.ts.map +1 -1
  54. package/dist/analysis/metricOrder.d.ts +2 -2
  55. package/dist/analysis/metricOrder.d.ts.map +1 -1
  56. package/dist/analysis/metricWindow.d.ts.map +1 -1
  57. package/dist/analysis/project.d.ts +8 -3
  58. package/dist/analysis/project.d.ts.map +1 -1
  59. package/dist/analysis/serverLines.d.ts +5 -5
  60. package/dist/analysis/serverLines.d.ts.map +1 -1
  61. package/dist/analysis/splitOther.d.ts +1 -1
  62. package/dist/analysis/timeAxis.d.ts +3 -2
  63. package/dist/analysis/timeAxis.d.ts.map +1 -1
  64. package/dist/analysis/top.d.ts +1 -1
  65. package/dist/analysis/top.d.ts.map +1 -1
  66. package/dist/analysis/validateFamilies.d.ts.map +1 -1
  67. package/dist/analysis/validateGroups.d.ts.map +1 -1
  68. package/dist/analysis/validateLevels.d.ts.map +1 -1
  69. package/dist/analysis/validateMetrics.d.ts.map +1 -1
  70. package/dist/analysis/validateOffers.d.ts.map +1 -1
  71. package/dist/analysis/validateReferences.d.ts +2 -2
  72. package/dist/analysis/validateTop.d.ts +1 -1
  73. package/dist/analysis/validateTop.d.ts.map +1 -1
  74. package/dist/capabilities/aliases.d.ts.map +1 -1
  75. package/dist/capabilities/analysis.d.ts.map +1 -1
  76. package/dist/capabilities/cache.d.ts +3 -20
  77. package/dist/capabilities/cache.d.ts.map +1 -1
  78. package/dist/capabilities/fields.d.ts +2 -2
  79. package/dist/capabilities/fields.d.ts.map +1 -1
  80. package/dist/capabilities/match.d.ts +15 -5
  81. package/dist/capabilities/match.d.ts.map +1 -1
  82. package/dist/capabilities/narrow.d.ts.map +1 -1
  83. package/dist/capabilities/open.d.ts.map +1 -1
  84. package/dist/capabilities/record.d.ts.map +1 -1
  85. package/dist/{cartesianBrush-HLU12ig5.js → cartesianBrush-bgRuE6Ks.js} +3 -5
  86. package/dist/cartesianBrush-bgRuE6Ks.js.map +1 -0
  87. package/dist/dashboard/click.d.ts +9 -9
  88. package/dist/dashboard/click.d.ts.map +1 -1
  89. package/dist/dashboard/clickDraft.d.ts +1 -1
  90. package/dist/dashboard/edit.d.ts +6 -6
  91. package/dist/dashboard/filterEdit.d.ts +5 -6
  92. package/dist/dashboard/filterEdit.d.ts.map +1 -1
  93. package/dist/dashboard/filters.d.ts +9 -10
  94. package/dist/dashboard/filters.d.ts.map +1 -1
  95. package/dist/dashboard/index.d.ts +0 -1
  96. package/dist/dashboard/index.d.ts.map +1 -1
  97. package/dist/dashboard/layout.d.ts +2 -2
  98. package/dist/dashboard/merge.d.ts +2 -2
  99. package/dist/dashboard/panelLook.d.ts +1 -1
  100. package/dist/dashboard/panels.d.ts +1 -1
  101. package/dist/dashboard/timeBindings.d.ts +2 -12
  102. package/dist/dashboard/timeBindings.d.ts.map +1 -1
  103. package/dist/dashboard/validate.d.ts.map +1 -1
  104. package/dist/dashboard/validateFilters.d.ts +2 -2
  105. package/dist/dashboard/wiring.d.ts +5 -5
  106. package/dist/{echarts-HUGzxow7.js → echarts-rjTKpBsf.js} +3 -4
  107. package/dist/{echarts-HUGzxow7.js.map → echarts-rjTKpBsf.js.map} +1 -1
  108. package/dist/{echartsGeo-BWbXo9ef.js → echartsGeo-qZv2ZF9e.js} +2 -3
  109. package/dist/{echartsGeo-BWbXo9ef.js.map → echartsGeo-qZv2ZF9e.js.map} +1 -1
  110. package/dist/{echartsHierarchy-Cm-9-LN9.js → echartsHierarchy-DHNP9W4v.js} +2 -3
  111. package/dist/{echartsHierarchy-Cm-9-LN9.js.map → echartsHierarchy-DHNP9W4v.js.map} +1 -1
  112. package/dist/{echartsStatistics-Lq-BjHez.js → echartsStatistics-DCDWqvde.js} +2 -3
  113. package/dist/{echartsStatistics-Lq-BjHez.js.map → echartsStatistics-DCDWqvde.js.map} +1 -1
  114. package/dist/{echartsTime-gMH0oF0x.js → echartsTime-DIRSRMnr.js} +2 -3
  115. package/dist/{echartsTime-gMH0oF0x.js.map → echartsTime-DIRSRMnr.js.map} +1 -1
  116. package/dist/export-BCADqfu6.js +29 -0
  117. package/dist/export-BCADqfu6.js.map +1 -0
  118. package/dist/filter/describe.d.ts +6 -6
  119. package/dist/filter/describe.d.ts.map +1 -1
  120. package/dist/filter/kinds/array.d.ts.map +1 -1
  121. package/dist/filter/kinds/boolean.d.ts.map +1 -1
  122. package/dist/filter/kinds/dateTime.d.ts.map +1 -1
  123. package/dist/filter/kinds/deletion.d.ts +2 -2
  124. package/dist/filter/kinds/deletion.d.ts.map +1 -1
  125. package/dist/filter/kinds/duration.d.ts.map +1 -1
  126. package/dist/filter/kinds/elementMatch.d.ts.map +1 -1
  127. package/dist/filter/kinds/entries.d.ts.map +1 -1
  128. package/dist/filter/kinds/enum.d.ts.map +1 -1
  129. package/dist/filter/kinds/metadata.d.ts.map +1 -1
  130. package/dist/filter/kinds/number.d.ts.map +1 -1
  131. package/dist/filter/kinds/presence.d.ts +1 -0
  132. package/dist/filter/kinds/presence.d.ts.map +1 -1
  133. package/dist/filter/kinds/reference.d.ts +5 -0
  134. package/dist/filter/kinds/reference.d.ts.map +1 -1
  135. package/dist/filter/kinds/string.d.ts.map +1 -1
  136. package/dist/filter/operatorWords.d.ts +21 -0
  137. package/dist/filter/operatorWords.d.ts.map +1 -0
  138. package/dist/filter/search.d.ts.map +1 -1
  139. package/dist/filter/time.d.ts +2 -2
  140. package/dist/filter/time.d.ts.map +1 -1
  141. package/dist/filter/tree.d.ts.map +1 -1
  142. package/dist/filter/validate.d.ts.map +1 -1
  143. package/dist/filter/values.d.ts +6 -5
  144. package/dist/filter/values.d.ts.map +1 -1
  145. package/dist/index.d.ts +53 -89
  146. package/dist/index.d.ts.map +1 -1
  147. package/dist/index.js +224 -223
  148. package/dist/index.js.map +1 -1
  149. package/dist/model/analysis.d.ts +61 -59
  150. package/dist/model/analysis.d.ts.map +1 -1
  151. package/dist/model/chart.d.ts +16 -6
  152. package/dist/model/chart.d.ts.map +1 -1
  153. package/dist/model/config.d.ts +2 -2
  154. package/dist/model/dashboard.d.ts +28 -48
  155. package/dist/model/dashboard.d.ts.map +1 -1
  156. package/dist/model/definition.d.ts +17 -17
  157. package/dist/model/definition.d.ts.map +1 -1
  158. package/dist/model/field.d.ts +35 -5
  159. package/dist/model/field.d.ts.map +1 -1
  160. package/dist/model/filter.d.ts +5 -5
  161. package/dist/model/filter.d.ts.map +1 -1
  162. package/dist/model/index.d.ts +2 -0
  163. package/dist/model/index.d.ts.map +1 -1
  164. package/dist/model/limits.d.ts +29 -0
  165. package/dist/model/limits.d.ts.map +1 -1
  166. package/dist/model/record.d.ts +7 -6
  167. package/dist/model/record.d.ts.map +1 -1
  168. package/dist/model/text.d.ts +1 -1
  169. package/dist/model/values.d.ts +8 -0
  170. package/dist/model/values.d.ts.map +1 -0
  171. package/dist/model/wire.d.ts +32 -0
  172. package/dist/model/wire.d.ts.map +1 -0
  173. package/dist/react/actionRunner.d.ts +8 -1
  174. package/dist/react/actionRunner.d.ts.map +1 -1
  175. package/dist/react/analysisEditing.d.ts +79 -46
  176. package/dist/react/analysisEditing.d.ts.map +1 -1
  177. package/dist/react/analysisFields.d.ts +5 -5
  178. package/dist/react/analysisFields.d.ts.map +1 -1
  179. package/dist/react/engineContext.d.ts +17 -0
  180. package/dist/react/engineContext.d.ts.map +1 -0
  181. package/dist/react/index.d.ts +17 -15
  182. package/dist/react/index.d.ts.map +1 -1
  183. package/dist/react/issues.d.ts +0 -1
  184. package/dist/react/issues.d.ts.map +1 -1
  185. package/dist/react/manager/wording.d.ts +1 -1
  186. package/dist/react/manager/wording.d.ts.map +1 -1
  187. package/dist/react/recordColumns.d.ts +1 -1
  188. package/dist/react/recordColumns.d.ts.map +1 -1
  189. package/dist/react/recordDraft.d.ts.map +1 -1
  190. package/dist/react/recordEdits.d.ts.map +1 -1
  191. package/dist/react/referenceNames.d.ts +20 -0
  192. package/dist/react/referenceNames.d.ts.map +1 -0
  193. package/dist/react/useAnalysisEditor.d.ts +10 -9
  194. package/dist/react/useAnalysisEditor.d.ts.map +1 -1
  195. package/dist/react/useAnalysisResult.d.ts +17 -3
  196. package/dist/react/useAnalysisResult.d.ts.map +1 -1
  197. package/dist/react/useAutoRefresh.d.ts +8 -6
  198. package/dist/react/useAutoRefresh.d.ts.map +1 -1
  199. package/dist/react/useCreateViewEngine.d.ts +11 -0
  200. package/dist/react/useCreateViewEngine.d.ts.map +1 -0
  201. package/dist/react/useDashboard.d.ts +12 -5
  202. package/dist/react/useDashboard.d.ts.map +1 -1
  203. package/dist/react/useDatasets.d.ts +33 -21
  204. package/dist/react/useDatasets.d.ts.map +1 -1
  205. package/dist/react/useFilterEditor.d.ts.map +1 -1
  206. package/dist/react/{useViewEngine.d.ts → useOpenView.d.ts} +22 -36
  207. package/dist/react/useOpenView.d.ts.map +1 -0
  208. package/dist/react/usePanelFollowUps.d.ts +11 -2
  209. package/dist/react/usePanelFollowUps.d.ts.map +1 -1
  210. package/dist/react/useRecordActions.d.ts +14 -3
  211. package/dist/react/useRecordActions.d.ts.map +1 -1
  212. package/dist/react/useRecordDetail.d.ts +9 -6
  213. package/dist/react/useRecordDetail.d.ts.map +1 -1
  214. package/dist/react/useRecordExport.d.ts +5 -1
  215. package/dist/react/useRecordExport.d.ts.map +1 -1
  216. package/dist/react/useRecordKanban.d.ts +1 -1
  217. package/dist/react/useRecordTable.d.ts +2 -4
  218. package/dist/react/useRecordTable.d.ts.map +1 -1
  219. package/dist/react/useReferenceLabels.d.ts +9 -0
  220. package/dist/react/useReferenceLabels.d.ts.map +1 -0
  221. package/dist/react/useReshape.d.ts +2 -2
  222. package/dist/react/useSaveCommands.d.ts +3 -7
  223. package/dist/react/useSaveCommands.d.ts.map +1 -1
  224. package/dist/react/useValueCandidates.d.ts +17 -6
  225. package/dist/react/useValueCandidates.d.ts.map +1 -1
  226. package/dist/react/useViewList.d.ts +23 -11
  227. package/dist/react/useViewList.d.ts.map +1 -1
  228. package/dist/react/useViewManager.d.ts +6 -1
  229. package/dist/react/useViewManager.d.ts.map +1 -1
  230. package/dist/react/useViewRuntime.d.ts +23 -0
  231. package/dist/react/useViewRuntime.d.ts.map +1 -0
  232. package/dist/react/useWorkbench.d.ts +1 -1
  233. package/dist/react/useWorkbench.d.ts.map +1 -1
  234. package/dist/react/workbench/handOver.d.ts +10 -3
  235. package/dist/react/workbench/handOver.d.ts.map +1 -1
  236. package/dist/react/workbench/releaseDeleted.d.ts +13 -6
  237. package/dist/react/workbench/releaseDeleted.d.ts.map +1 -1
  238. package/dist/react-D1wSQhlr.js +4196 -0
  239. package/dist/react-D1wSQhlr.js.map +1 -0
  240. package/dist/react-router/index.d.ts +1 -0
  241. package/dist/react-router/index.d.ts.map +1 -1
  242. package/dist/react-router.js +1 -2
  243. package/dist/react-router.js.map +1 -1
  244. package/dist/react.js +1 -3
  245. package/dist/record/compile.d.ts.map +1 -1
  246. package/dist/record/kanban.d.ts +2 -2
  247. package/dist/record/kanban.d.ts.map +1 -1
  248. package/dist/record/paging.d.ts +11 -2
  249. package/dist/record/paging.d.ts.map +1 -1
  250. package/dist/record/project.d.ts +17 -1
  251. package/dist/record/project.d.ts.map +1 -1
  252. package/dist/record/summaryCurrency.d.ts.map +1 -1
  253. package/dist/record/validate.d.ts.map +1 -1
  254. package/dist/{routes-DvPNPlQP.js → routes-CMXKbAo2.js} +2 -3
  255. package/dist/{routes-DvPNPlQP.js.map → routes-CMXKbAo2.js.map} +1 -1
  256. package/dist/runtime/actions.d.ts +19 -7
  257. package/dist/runtime/actions.d.ts.map +1 -1
  258. package/dist/runtime/autoApply.d.ts +1 -1
  259. package/dist/runtime/capabilities.d.ts +2 -2
  260. package/dist/runtime/capabilities.d.ts.map +1 -1
  261. package/dist/runtime/dashboard/anchor.d.ts +2 -2
  262. package/dist/runtime/dashboard/anchor.d.ts.map +1 -1
  263. package/dist/runtime/dashboard/canonical.d.ts +2 -2
  264. package/dist/runtime/dashboard/commands.d.ts +2 -2
  265. package/dist/runtime/dashboard/commands.d.ts.map +1 -1
  266. package/dist/runtime/dashboard/contract.d.ts +6 -6
  267. package/dist/runtime/dashboard/contract.d.ts.map +1 -1
  268. package/dist/runtime/dashboard/editing.d.ts +2 -2
  269. package/dist/runtime/dashboard/filterCandidates.d.ts +1 -1
  270. package/dist/runtime/dashboard/filterValues.d.ts +16 -4
  271. package/dist/runtime/dashboard/filterValues.d.ts.map +1 -1
  272. package/dist/runtime/dashboard/grouping.d.ts +4 -4
  273. package/dist/runtime/dashboard/grouping.d.ts.map +1 -1
  274. package/dist/runtime/dashboard/panelRun.d.ts +2 -2
  275. package/dist/runtime/dashboard/panels.d.ts +1 -1
  276. package/dist/runtime/dashboard/press.d.ts +1 -1
  277. package/dist/runtime/dashboard/press.d.ts.map +1 -1
  278. package/dist/runtime/dashboard/references.d.ts +1 -1
  279. package/dist/runtime/dashboard/references.d.ts.map +1 -1
  280. package/dist/runtime/dashboardRuntime.d.ts +5 -2
  281. package/dist/runtime/dashboardRuntime.d.ts.map +1 -1
  282. package/dist/runtime/datasetResources.d.ts +57 -70
  283. package/dist/runtime/datasetResources.d.ts.map +1 -1
  284. package/dist/runtime/define/defineDataset.d.ts +1 -1
  285. package/dist/runtime/define/defineView.d.ts +1 -1
  286. package/dist/runtime/define/defineView.d.ts.map +1 -1
  287. package/dist/runtime/define/fields.d.ts +2 -2
  288. package/dist/runtime/define/fields.d.ts.map +1 -1
  289. package/dist/runtime/define/spec.d.ts +5 -1
  290. package/dist/runtime/define/spec.d.ts.map +1 -1
  291. package/dist/runtime/deprecated.d.ts.map +1 -1
  292. package/dist/runtime/environment.d.ts +95 -47
  293. package/dist/runtime/environment.d.ts.map +1 -1
  294. package/dist/runtime/execute.d.ts +2 -2
  295. package/dist/runtime/execute.d.ts.map +1 -1
  296. package/dist/runtime/exportRows.d.ts +10 -0
  297. package/dist/runtime/exportRows.d.ts.map +1 -1
  298. package/dist/runtime/failure/failures.d.ts +23 -11
  299. package/dist/runtime/failure/failures.d.ts.map +1 -1
  300. package/dist/runtime/failure/queryFailure.d.ts +1 -1
  301. package/dist/runtime/failure/queryFailure.d.ts.map +1 -1
  302. package/dist/runtime/failure/unavailable.d.ts +1 -1
  303. package/dist/runtime/fetchRecord.d.ts.map +1 -1
  304. package/dist/runtime/index.d.ts +5 -3
  305. package/dist/runtime/index.d.ts.map +1 -1
  306. package/dist/runtime/instanceWrites.d.ts +15 -9
  307. package/dist/runtime/instanceWrites.d.ts.map +1 -1
  308. package/dist/runtime/kanban.d.ts +1 -1
  309. package/dist/runtime/labelIds.d.ts +56 -0
  310. package/dist/runtime/labelIds.d.ts.map +1 -0
  311. package/dist/runtime/navigation.d.ts +6 -6
  312. package/dist/runtime/panelViews.d.ts +3 -5
  313. package/dist/runtime/panelViews.d.ts.map +1 -1
  314. package/dist/runtime/pending.d.ts +2 -2
  315. package/dist/runtime/permissions.d.ts +2 -2
  316. package/dist/runtime/preferences.d.ts +2 -2
  317. package/dist/runtime/preferences.d.ts.map +1 -1
  318. package/dist/runtime/queryWeight.d.ts.map +1 -1
  319. package/dist/runtime/recordRuntime.d.ts +10 -1
  320. package/dist/runtime/recordRuntime.d.ts.map +1 -1
  321. package/dist/runtime/referenceLabels.d.ts +170 -0
  322. package/dist/runtime/referenceLabels.d.ts.map +1 -0
  323. package/dist/runtime/resources.d.ts +31 -93
  324. package/dist/runtime/resources.d.ts.map +1 -1
  325. package/dist/runtime/restyle.d.ts +1 -1
  326. package/dist/runtime/runtimeFactory.d.ts +5 -4
  327. package/dist/runtime/runtimeFactory.d.ts.map +1 -1
  328. package/dist/runtime/source.d.ts +55 -48
  329. package/dist/runtime/source.d.ts.map +1 -1
  330. package/dist/runtime/summaries.d.ts +9 -1
  331. package/dist/runtime/summaries.d.ts.map +1 -1
  332. package/dist/runtime/tabMemory.d.ts +1 -1
  333. package/dist/runtime/validateFields.d.ts.map +1 -1
  334. package/dist/runtime/valueCandidates.d.ts.map +1 -1
  335. package/dist/runtime/viewEngine.d.ts +97 -105
  336. package/dist/runtime/viewEngine.d.ts.map +1 -1
  337. package/dist/runtime/viewEngineOptions.d.ts +79 -0
  338. package/dist/runtime/viewEngineOptions.d.ts.map +1 -0
  339. package/dist/runtime/viewRuntime.d.ts +6 -9
  340. package/dist/runtime/viewRuntime.d.ts.map +1 -1
  341. package/dist/runtime/viewRuntimeTypes.d.ts +39 -8
  342. package/dist/runtime/viewRuntimeTypes.d.ts.map +1 -1
  343. package/dist/store/MemoryViewStore.d.ts +16 -16
  344. package/dist/store/MemoryViewStore.d.ts.map +1 -1
  345. package/dist/store/ViewStore.d.ts +31 -19
  346. package/dist/store/ViewStore.d.ts.map +1 -1
  347. package/dist/testing/actions.d.ts +6 -4
  348. package/dist/testing/actions.d.ts.map +1 -1
  349. package/dist/testing/aggregate.d.ts +4 -2
  350. package/dist/testing/aggregate.d.ts.map +1 -1
  351. package/dist/testing/filter.d.ts +3 -3
  352. package/dist/testing/filter.d.ts.map +1 -1
  353. package/dist/testing/index.d.ts +2 -2
  354. package/dist/testing/index.d.ts.map +1 -1
  355. package/dist/testing/source.d.ts +4 -4
  356. package/dist/testing/source.d.ts.map +1 -1
  357. package/dist/testing.js +99 -96
  358. package/dist/testing.js.map +1 -1
  359. package/dist/theme-check.mjs +102 -127
  360. package/dist/ui/DashboardWorkbench.d.ts +2 -2
  361. package/dist/ui/DashboardWorkbench.d.ts.map +1 -1
  362. package/dist/ui/DataWorkbench.d.ts +2 -2
  363. package/dist/ui/DataWorkbench.d.ts.map +1 -1
  364. package/dist/ui/DatasetWorkbench.d.ts +11 -21
  365. package/dist/ui/DatasetWorkbench.d.ts.map +1 -1
  366. package/dist/ui/EmbeddedDashboard.d.ts +1 -1
  367. package/dist/ui/EmbeddedDashboard.d.ts.map +1 -1
  368. package/dist/ui/EmbeddedView.d.ts +1 -1
  369. package/dist/ui/ViewHost.d.ts +6 -6
  370. package/dist/ui/ViewHost.d.ts.map +1 -1
  371. package/dist/ui/actions/ActionSurface.d.ts.map +1 -1
  372. package/dist/ui/actions/BulkStatus.d.ts.map +1 -1
  373. package/dist/ui/actions/kanbanMove.d.ts +1 -1
  374. package/dist/ui/analysis/AnalysisTable.d.ts.map +1 -1
  375. package/dist/ui/analysis/AnalysisToolbar.d.ts +1 -1
  376. package/dist/ui/analysis/AnalysisToolbar.d.ts.map +1 -1
  377. package/dist/ui/analysis/AxesTab.d.ts +1 -1
  378. package/dist/ui/analysis/CardMenu.d.ts +1 -1
  379. package/dist/ui/analysis/ChartOptions.d.ts +1 -1
  380. package/dist/ui/analysis/ChartOptions.d.ts.map +1 -1
  381. package/dist/ui/analysis/ChartPicker.d.ts +1 -1
  382. package/dist/ui/analysis/CompositionOptions.d.ts +1 -1
  383. package/dist/ui/analysis/CurrencyStrip.d.ts.map +1 -1
  384. package/dist/ui/analysis/DataTab.d.ts +1 -1
  385. package/dist/ui/analysis/DimensionCard.d.ts.map +1 -1
  386. package/dist/ui/analysis/DisplayTab.d.ts +1 -1
  387. package/dist/ui/analysis/DisplayTab.d.ts.map +1 -1
  388. package/dist/ui/analysis/DrillMenu.d.ts +1 -1
  389. package/dist/ui/analysis/DroppedNotice.d.ts +1 -1
  390. package/dist/ui/analysis/ElementsSlot.d.ts +1 -1
  391. package/dist/ui/analysis/ExportMenu.d.ts +3 -3
  392. package/dist/ui/analysis/ExportMenu.d.ts.map +1 -1
  393. package/dist/ui/analysis/FormulaCard.d.ts.map +1 -1
  394. package/dist/ui/analysis/HavingRows.d.ts +1 -1
  395. package/dist/ui/analysis/HavingRows.d.ts.map +1 -1
  396. package/dist/ui/analysis/LevelOptions.d.ts +1 -1
  397. package/dist/ui/analysis/MapOptions.d.ts +1 -1
  398. package/dist/ui/analysis/MetricCard.d.ts +1 -1
  399. package/dist/ui/analysis/MetricCard.d.ts.map +1 -1
  400. package/dist/ui/analysis/MetricCondition.d.ts +1 -1
  401. package/dist/ui/analysis/MetricCondition.d.ts.map +1 -1
  402. package/dist/ui/analysis/MetricSlot.d.ts +1 -1
  403. package/dist/ui/analysis/MetricSlot.d.ts.map +1 -1
  404. package/dist/ui/analysis/RangeSlot.d.ts +1 -1
  405. package/dist/ui/analysis/ReferenceOptions.d.ts +1 -1
  406. package/dist/ui/analysis/TermTip.d.ts +1 -1
  407. package/dist/ui/analysis/TopRow.d.ts +1 -1
  408. package/dist/ui/analysis/TopRow.d.ts.map +1 -1
  409. package/dist/ui/analysis/Tray.d.ts +1 -1
  410. package/dist/ui/analysis/Tray.d.ts.map +1 -1
  411. package/dist/ui/analysis/VisualizationPanel.d.ts +2 -2
  412. package/dist/ui/analysis/VisualizationPanel.d.ts.map +1 -1
  413. package/dist/ui/analysis/editing.d.ts +2 -2
  414. package/dist/ui/analysis/editing.d.ts.map +1 -1
  415. package/dist/ui/analysis/exportOffer.d.ts +3 -3
  416. package/dist/ui/analysis/headerSort.d.ts.map +1 -1
  417. package/dist/ui/analysis/imageExport.d.ts +3 -3
  418. package/dist/ui/analysis/imageExport.d.ts.map +1 -1
  419. package/dist/ui/charts/EChart.d.ts +2 -2
  420. package/dist/ui/charts/GeoMap.d.ts +1 -1
  421. package/dist/ui/charts/Heatmap.d.ts +1 -1
  422. package/dist/ui/charts/MetricCard.d.ts.map +1 -1
  423. package/dist/ui/charts/PieSlices.d.ts +1 -1
  424. package/dist/ui/charts/ScatterPoints.d.ts +1 -1
  425. package/dist/ui/charts/ScatterPoints.d.ts.map +1 -1
  426. package/dist/ui/charts/axis.d.ts +2 -2
  427. package/dist/ui/charts/cartesianTooltip.d.ts +2 -2
  428. package/dist/ui/charts/dateTicks.d.ts +2 -2
  429. package/dist/ui/charts/dateTicks.d.ts.map +1 -1
  430. package/dist/ui/charts/family.d.ts +1 -1
  431. package/dist/ui/charts/family.d.ts.map +1 -1
  432. package/dist/ui/charts/familyViews.d.ts +1 -1
  433. package/dist/ui/charts/frameClass.d.ts +2 -2
  434. package/dist/ui/charts/highlight.d.ts +2 -2
  435. package/dist/ui/charts/image.d.ts +22 -6
  436. package/dist/ui/charts/image.d.ts.map +1 -1
  437. package/dist/ui/charts/maps.d.ts +1 -1
  438. package/dist/ui/charts/waterfallOption.d.ts +2 -2
  439. package/dist/ui/colorMode.d.ts +1 -2
  440. package/dist/ui/colorMode.d.ts.map +1 -1
  441. package/dist/ui/columns/ColumnSettings.d.ts +6 -1
  442. package/dist/ui/columns/ColumnSettings.d.ts.map +1 -1
  443. package/dist/ui/dashboard/AddMenu.d.ts +2 -2
  444. package/dist/ui/dashboard/Board.d.ts +1 -1
  445. package/dist/ui/dashboard/BoardDestination.d.ts +2 -2
  446. package/dist/ui/dashboard/BoardFilters.d.ts +1 -1
  447. package/dist/ui/dashboard/BoardWidth.d.ts +1 -1
  448. package/dist/ui/dashboard/ClickSettings.d.ts +4 -4
  449. package/dist/ui/dashboard/ContentEditor.d.ts +1 -1
  450. package/dist/ui/dashboard/DashboardArrange.d.ts +1 -1
  451. package/dist/ui/dashboard/DashboardGrid.d.ts +3 -3
  452. package/dist/ui/dashboard/DashboardGrid.d.ts.map +1 -1
  453. package/dist/ui/dashboard/{DashboardPanel.d.ts → DashboardPanelCard.d.ts} +3 -3
  454. package/dist/ui/dashboard/DashboardPanelCard.d.ts.map +1 -0
  455. package/dist/ui/dashboard/DashboardPanels.d.ts +4 -4
  456. package/dist/ui/dashboard/DashboardPanels.d.ts.map +1 -1
  457. package/dist/ui/dashboard/DashboardTabs.d.ts +1 -1
  458. package/dist/ui/dashboard/EditBar.d.ts +1 -1
  459. package/dist/ui/dashboard/FilterBar.d.ts +1 -1
  460. package/dist/ui/dashboard/FilterOrder.d.ts +1 -1
  461. package/dist/ui/dashboard/FilterReadings.d.ts +1 -1
  462. package/dist/ui/dashboard/FilterReadings.d.ts.map +1 -1
  463. package/dist/ui/dashboard/FilterSettings.d.ts +2 -2
  464. package/dist/ui/dashboard/FilterSettings.d.ts.map +1 -1
  465. package/dist/ui/dashboard/FilterSheet.d.ts +1 -1
  466. package/dist/ui/dashboard/FilterWiring.d.ts +2 -2
  467. package/dist/ui/dashboard/GridBlocksLayer.d.ts +1 -1
  468. package/dist/ui/dashboard/GroupingControl.d.ts +4 -4
  469. package/dist/ui/dashboard/GroupingControl.d.ts.map +1 -1
  470. package/dist/ui/dashboard/NewAnalysisDialog.d.ts +1 -1
  471. package/dist/ui/dashboard/NewAnalysisDialog.d.ts.map +1 -1
  472. package/dist/ui/dashboard/PanelBodies.d.ts +9 -8
  473. package/dist/ui/dashboard/PanelBodies.d.ts.map +1 -1
  474. package/dist/ui/dashboard/PanelExport.d.ts +3 -3
  475. package/dist/ui/dashboard/PanelMenu.d.ts +1 -1
  476. package/dist/ui/dashboard/PresentationDialog.d.ts +1 -1
  477. package/dist/ui/dashboard/PresentationDialog.d.ts.map +1 -1
  478. package/dist/ui/dashboard/ScrollCue.d.ts +1 -1
  479. package/dist/ui/dashboard/ViewPicker.d.ts +1 -1
  480. package/dist/ui/dashboard/ViewPicker.d.ts.map +1 -1
  481. package/dist/ui/dashboard/buildShell.d.ts +2 -2
  482. package/dist/ui/dashboard/building.d.ts +1 -1
  483. package/dist/ui/dashboard/building.d.ts.map +1 -1
  484. package/dist/ui/dashboard/commands.d.ts +4 -4
  485. package/dist/ui/dashboard/commands.d.ts.map +1 -1
  486. package/dist/ui/dashboard/extensions.d.ts +1 -1
  487. package/dist/ui/dashboard/filterModes.d.ts +3 -3
  488. package/dist/ui/dashboard/filterOutcome.d.ts.map +1 -1
  489. package/dist/ui/dashboard/findings.d.ts +1 -1
  490. package/dist/ui/dashboard/gridBlocks.d.ts +1 -1
  491. package/dist/ui/dashboard/panelFit.d.ts +2 -2
  492. package/dist/ui/dashboard/press.d.ts +2 -2
  493. package/dist/ui/dashboard/press.d.ts.map +1 -1
  494. package/dist/ui/dashboard/reveal.d.ts +1 -1
  495. package/dist/ui/dashboard/scrollMore.d.ts +1 -1
  496. package/dist/ui/datasetBindings.d.ts +3 -11
  497. package/dist/ui/datasetBindings.d.ts.map +1 -1
  498. package/dist/ui/embed/EmbedFrame.d.ts +1 -1
  499. package/dist/ui/embed/EmbedFrame.d.ts.map +1 -1
  500. package/dist/ui/embed/EmbedHead.d.ts +5 -5
  501. package/dist/ui/embed/EmbedHead.d.ts.map +1 -1
  502. package/dist/ui/embed/EmbeddedAnalysis.d.ts +4 -4
  503. package/dist/ui/embed/EmbeddedAnalysis.d.ts.map +1 -1
  504. package/dist/ui/embed/EmbeddedRecord.d.ts +1 -1
  505. package/dist/ui/embed/options.d.ts +4 -4
  506. package/dist/ui/embed/options.d.ts.map +1 -1
  507. package/dist/ui/filter/inputs/duration.d.ts.map +1 -1
  508. package/dist/ui/filter/inputs/remote.d.ts +3 -1
  509. package/dist/ui/filter/inputs/remote.d.ts.map +1 -1
  510. package/dist/ui/index.d.ts +6 -7
  511. package/dist/ui/index.d.ts.map +1 -1
  512. package/dist/ui/kit/ExportDialog.d.ts +2 -2
  513. package/dist/ui/kit/ExportDialog.d.ts.map +1 -1
  514. package/dist/ui/kit/IconButton.d.ts +1 -1
  515. package/dist/ui/kit/MessagesProvider.d.ts +3 -3
  516. package/dist/ui/kit/RenameInput.d.ts +2 -2
  517. package/dist/ui/kit/RenderBoundary.d.ts.map +1 -1
  518. package/dist/ui/kit/RowItem.d.ts +1 -1
  519. package/dist/ui/kit/ViewSurface.d.ts +16 -6
  520. package/dist/ui/kit/ViewSurface.d.ts.map +1 -1
  521. package/dist/ui/kit/alerts.d.ts +2 -2
  522. package/dist/ui/kit/alerts.d.ts.map +1 -1
  523. package/dist/ui/kit/chartFailure.d.ts +1 -3
  524. package/dist/ui/kit/chartFailure.d.ts.map +1 -1
  525. package/dist/ui/kit/datePart.d.ts +2 -2
  526. package/dist/ui/kit/datePart.d.ts.map +1 -1
  527. package/dist/ui/kit/display.d.ts +25 -6
  528. package/dist/ui/kit/display.d.ts.map +1 -1
  529. package/dist/ui/kit/dragPlugins.d.ts +3 -3
  530. package/dist/ui/kit/failureSink.d.ts +1 -1
  531. package/dist/ui/kit/failureSink.d.ts.map +1 -1
  532. package/dist/ui/kit/features.d.ts +2 -2
  533. package/dist/ui/kit/features.d.ts.map +1 -1
  534. package/dist/ui/kit/icon.d.ts +9 -0
  535. package/dist/ui/kit/icon.d.ts.map +1 -0
  536. package/dist/ui/kit/kinds.d.ts +4 -4
  537. package/dist/ui/kit/kinds.d.ts.map +1 -1
  538. package/dist/ui/kit/layout.d.ts +2 -2
  539. package/dist/ui/kit/messages.d.ts.map +1 -1
  540. package/dist/ui/kit/presets.d.ts +2 -2
  541. package/dist/ui/kit/summary.d.ts +8 -10
  542. package/dist/ui/kit/summary.d.ts.map +1 -1
  543. package/dist/ui/kit/surfaceContext.d.ts +4 -3
  544. package/dist/ui/kit/surfaceContext.d.ts.map +1 -1
  545. package/dist/ui/kit/surfaceKeys.d.ts +1 -1
  546. package/dist/ui/kit/toolbar.d.ts +21 -4
  547. package/dist/ui/kit/toolbar.d.ts.map +1 -1
  548. package/dist/ui/kit/variants.d.ts +5 -5
  549. package/dist/ui/manage/DatasetWordingForm.d.ts +2 -2
  550. package/dist/ui/messages/analysis.d.ts +61 -57
  551. package/dist/ui/messages/analysis.d.ts.map +1 -1
  552. package/dist/ui/messages/building.d.ts +1 -1
  553. package/dist/ui/messages/capabilities.d.ts +5 -1
  554. package/dist/ui/messages/capabilities.d.ts.map +1 -1
  555. package/dist/ui/messages/clicks.d.ts +1 -1
  556. package/dist/ui/messages/datasets.d.ts +3 -2
  557. package/dist/ui/messages/datasets.d.ts.map +1 -1
  558. package/dist/ui/messages/definition.d.ts +2 -1
  559. package/dist/ui/messages/definition.d.ts.map +1 -1
  560. package/dist/ui/messages/embed.d.ts +1 -1
  561. package/dist/ui/messages/en.d.ts +238 -221
  562. package/dist/ui/messages/en.d.ts.map +1 -1
  563. package/dist/ui/messages/export.d.ts +1 -1
  564. package/dist/ui/messages/filter.d.ts +98 -98
  565. package/dist/ui/messages/filter.d.ts.map +1 -1
  566. package/dist/ui/messages/filters.d.ts +1 -1
  567. package/dist/ui/messages/record.d.ts +20 -15
  568. package/dist/ui/messages/record.d.ts.map +1 -1
  569. package/dist/ui/messages/view.d.ts +51 -49
  570. package/dist/ui/messages/view.d.ts.map +1 -1
  571. package/dist/ui/messages/wireKey.d.ts +17 -0
  572. package/dist/ui/messages/wireKey.d.ts.map +1 -0
  573. package/dist/ui/messages/zh-CN.d.ts.map +1 -1
  574. package/dist/ui/record/CardSettings.d.ts.map +1 -1
  575. package/dist/ui/record/CardSummaries.d.ts +1 -1
  576. package/dist/ui/record/OffscreenSummary.d.ts +1 -1
  577. package/dist/ui/record/RecordDetail.d.ts +1 -2
  578. package/dist/ui/record/RecordDetail.d.ts.map +1 -1
  579. package/dist/ui/record/RecordKanban.d.ts +1 -1
  580. package/dist/ui/record/RecordPagination.d.ts +3 -1
  581. package/dist/ui/record/RecordPagination.d.ts.map +1 -1
  582. package/dist/ui/record/SelectionBar.d.ts +2 -2
  583. package/dist/ui/record/SortableHeader.d.ts.map +1 -1
  584. package/dist/ui/record/cells.d.ts.map +1 -1
  585. package/dist/ui/record/exportOffer.d.ts +1 -1
  586. package/dist/ui/record/exportOffer.d.ts.map +1 -1
  587. package/dist/ui/record/kanbanDrag.d.ts +2 -2
  588. package/dist/ui/record/offscreenSummaries.d.ts +2 -2
  589. package/dist/ui/record/overflow.d.ts +1 -1
  590. package/dist/ui/record/queryAnnouncement.d.ts.map +1 -1
  591. package/dist/ui/record/resultCount.d.ts +10 -0
  592. package/dist/ui/record/resultCount.d.ts.map +1 -0
  593. package/dist/ui/record/sticky.d.ts +1 -1
  594. package/dist/ui/record/useOffscreenColumns.d.ts +1 -1
  595. package/dist/ui/record/useSummaries.d.ts.map +1 -1
  596. package/dist/ui/sort/SortSettings.d.ts.map +1 -1
  597. package/dist/ui/theme/tokens.d.ts +1 -1
  598. package/dist/ui/viewNavigation.d.ts.map +1 -1
  599. package/dist/ui/workbench/AddToDashboardDialog.d.ts +1 -1
  600. package/dist/ui/workbench/AnalysisParts.d.ts +1 -1
  601. package/dist/ui/workbench/MoreViewActions.d.ts +1 -1
  602. package/dist/ui/workbench/OriginBar.d.ts +1 -1
  603. package/dist/ui/workbench/ResultBlock.d.ts +1 -1
  604. package/dist/ui/workbench/Sidebar.d.ts +2 -2
  605. package/dist/ui/workbench/StatusLine.d.ts +1 -1
  606. package/dist/ui/workbench/ViewEngineProvider.d.ts +0 -9
  607. package/dist/ui/workbench/ViewEngineProvider.d.ts.map +1 -1
  608. package/dist/ui/workbench/WorkbenchShell.d.ts +3 -3
  609. package/dist/ui/workbench/WorkbenchShell.d.ts.map +1 -1
  610. package/dist/ui/workbench/address.d.ts.map +1 -1
  611. package/dist/ui.js +13764 -13812
  612. package/dist/ui.js.map +1 -1
  613. package/dist/{viewRuntimeTypes-B3B6hbXr.js → viewRuntimeTypes-BCdG5xRp.js} +1950 -2122
  614. package/dist/viewRuntimeTypes-BCdG5xRp.js.map +1 -0
  615. package/package.json +13 -13
  616. package/dist/actions-CgaL6eEe.js.map +0 -1
  617. package/dist/cartesianBrush-HLU12ig5.js.map +0 -1
  618. package/dist/clickDraft-CdUtkL4y.js +0 -184
  619. package/dist/clickDraft-CdUtkL4y.js.map +0 -1
  620. package/dist/dashboard/migrate.d.ts +0 -33
  621. package/dist/dashboard/migrate.d.ts.map +0 -1
  622. package/dist/react/useViewEngine.d.ts.map +0 -1
  623. package/dist/react-BuHt29n6.js +0 -3855
  624. package/dist/react-BuHt29n6.js.map +0 -1
  625. package/dist/runtime/storedViews.d.ts +0 -10
  626. package/dist/runtime/storedViews.d.ts.map +0 -1
  627. package/dist/ui/dashboard/DashboardPanel.d.ts.map +0 -1
  628. package/dist/viewRuntimeTypes-B3B6hbXr.js.map +0 -1
package/README.md CHANGED
@@ -28,6 +28,11 @@ Peer dependencies: `@ahoo-wang/wow-client` (and the fetcher packages it needs);
28
28
  <!-- typecheck: file=orders.ts -->
29
29
 
30
30
  ```ts
31
+ import {
32
+ AggregationFunction,
33
+ FilterOperator,
34
+ SortDirection,
35
+ } from '@ahoo-wang/wow-client/dsl';
31
36
  import type { ViewDefinition } from '@ahoo-wang/wow-view-engine';
32
37
 
33
38
  export const orders: ViewDefinition = {
@@ -51,7 +56,7 @@ export const orders: ViewDefinition = {
51
56
  name: 'amount',
52
57
  label: 'Amount',
53
58
  kind: 'number',
54
- summary: ['SUM', 'AVG'],
59
+ summary: [AggregationFunction.SUM, AggregationFunction.AVG],
55
60
  },
56
61
  { name: 'createdAt', label: 'Created', kind: 'datetime', sortable: true },
57
62
  ],
@@ -71,13 +76,19 @@ export const orders: ViewDefinition = {
71
76
  // `enum` is a closed set, so it offers IN and NOT_IN rather than EQ:
72
77
  // one condition covers "any of these", and switching between the two
73
78
  // keeps the selection.
74
- children: [{ field: 'status', operator: 'IN', value: ['PENDING'] }],
79
+ children: [
80
+ {
81
+ field: 'status',
82
+ operator: FilterOperator.IN,
83
+ value: ['PENDING'],
84
+ },
85
+ ],
75
86
  },
76
87
  filterMode: 'simple',
77
88
  refresh: { interval: null },
78
- sort: [{ field: 'createdAt', direction: 'DESC' }],
89
+ sort: [{ field: 'createdAt', direction: SortDirection.DESC }],
79
90
  pageSize: 20,
80
- summaries: [{ field: 'amount', fn: 'SUM' }],
91
+ summaries: [{ field: 'amount', fn: AggregationFunction.SUM }],
81
92
  layout: 'table',
82
93
  table: {
83
94
  columns: [
@@ -106,7 +117,7 @@ import { MemoryViewStore, ViewEngine } from '@ahoo-wang/wow-view-engine';
106
117
 
107
118
  const engine = new ViewEngine({
108
119
  store: new MemoryViewStore(),
109
- // A ViewSource; viewSourceOf of @ahoo-wang/wow-view-store puts a Wow query route here
120
+ // A ViewSource: a Wow query route's client (a generated …SnapshotQueryClient) as it is
110
121
  resources: [{ definition: orders, source: sources.orders }],
111
122
  });
112
123
  ```
@@ -131,6 +142,37 @@ export function OrdersPage() {
131
142
 
132
143
  Around the pages of a real application goes one `ViewHost`, which bridges the engine, your router, language, theme and commands: see [fitting the engine into a host](https://wow.ahoo.me/typescript/view-engine/host).
133
144
 
145
+ ### Sorting and searching a reference
146
+
147
+ A `reference` field with a `remote` holds ids and shows names, read from the host's options. The server sorts by the stored id and searches stored text, never by the name shown, so such a field sorts only with `sortable: true` — by id, and its header and the sort editor say "by id" — and it is never a search field: admission refuses a saved sort on it (`record.sort.reference-label`) and a search naming it (`definition.search.reference-label`). To sort or search by the name, denormalize it into the read model and use that field:
148
+
149
+ ```ts
150
+ import type { FieldDefinition } from '@ahoo-wang/wow-view-engine';
151
+
152
+ export const customerFields: FieldDefinition[] = [
153
+ // Stored as the customer's id, shown as its name.
154
+ {
155
+ name: 'customerId',
156
+ label: 'Customer',
157
+ kind: 'reference',
158
+ remote: 'customers',
159
+ },
160
+ // The name, kept in the read model: what rows are sorted and searched by.
161
+ {
162
+ name: 'customerName',
163
+ label: 'Customer name',
164
+ kind: 'string',
165
+ sortable: true,
166
+ },
167
+ {
168
+ name: 'q',
169
+ label: 'Search',
170
+ kind: 'search',
171
+ searchFields: ['customerName'],
172
+ },
173
+ ];
174
+ ```
175
+
134
176
  ## Documentation
135
177
 
136
178
  | To | Read |
@@ -149,17 +191,19 @@ The design — the model, the kernels, the runtime and the UI decisions — is i
149
191
 
150
192
  ## Entries
151
193
 
152
- | Entry | Exports |
153
- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
154
- | `@ahoo-wang/wow-view-engine` | Model types and constants; the four pure kernels (`validate*` / `compile*` / `project*` and the readings beside them); from the runtime, what a host holds and nothing it is built from — `ViewEngine`, `validateDefinition`, the runtime contracts `ViewRuntime`, `RecordViewRuntime`, `DashboardRuntime` and `AnyViewRuntime` with every type their signatures name, `hasResult`, `hasAsked`, `isRecordRuntime`, `actions` with the declared actions' types, the write errors `ViewWriteError` and `ViewCommandError`, `ExportCancelledError`, `RuntimeEnvironment`, `defaultRuntimeEnvironment`, `ViewSource`, `OptionSource`; the `ViewStore` port, `MemoryViewStore` and `localStorageSnapshot` |
155
- | `/react` | Hooks and headless controllers with the types they return: `useViewEngine`, `useOpenView`, `useViewRuntime`, `useViewList`, `useViewManager`, `useWorkbench`, `useLeaveGuard`, `useFilterEditor`, `useRecordTable`, `useAnalysisEditor`, `useAnalysisResult`, `useDashboard`, `useSaveCommands`, `useRecordActions` (the declared actions of one record surface: what each record and the selection are offered, the question or form waiting, the one runner), `RecordActionSlots`, and the two write-outcome types the save commands report (`SettledWrite`, `RecoveredWrite`) |
156
- | `/ui` | Default components, views and workbenches with their props: `DataWorkbench`, `DashboardWorkbench`, `DashboardEditExtensions`, `useDashboardExtensions`, `EmbeddedView`, `EmbeddedDashboard`, `ViewHost`, `bind`, `useEngine`, `useViewNavigation`, `useColorMode`, `ViewHeader`, `SaveActions`, `ViewManager`, `LeaveDialog`, `EditorBand`, `FilterPanel`, `StatusStrip`, `AppliedBar`, `ResultToolbar`, `RowActions`, `RecordTable`, `RecordCards`, `RecordPagination`, `AnalysisTable`, `AnalysisChart`, `DashboardGrid`, `HeadingPanel`, `MarkdownPanel`, `ImagePanel`, `LinksPanel`, `MessagesProvider`; the catalogues `en` and `zhCN`; the reading of a value, `cellValue`, `cellText` and `displayValue` |
157
- | `/testing` | `memorySource` and `matches`: an in-memory `ViewSource` with Wow's query semantics; `resolveNavigation`: the engine's own routing of a way off through your bindings, for your routing tests; `admit`: a host's declarations admitted over its committed descriptors; `actionHarness`: a host's declared actions read by the engine's rules, without a screen — for a host's tests ([testing a host](https://wow.ahoo.me/typescript/view-engine/host#testing)) |
158
- | `/react-router` | `useReactRouter`: React Router as the router port a host hands its view host. React Router is an optional peer, and this is the one entry that loads it |
159
- | `/styles.css` | The theme. Import it explicitly; no JavaScript entry imports CSS, and nothing in it paints outside the two style boundaries `.fve-root` and `.fve-tokens` (preflight and the base are scoped at build time at no extra weight, and every utility is `fve:`-prefixed, so it never shares a name with yours and your import order does not matter) — bar the preset reset, which only empties the `--fvp-*` layer where a preset is named — all checked by `scripts/verify-package.mjs` on every build. |
160
- | `/themes.css` | The presets, optional: only `--fvp-*` assignments keyed by `data-fve-preset` ([Presets](https://wow.ahoo.me/typescript/view-engine/theming#presets)), checked by the same script. |
161
- | `/themes/<name>.css` | One preset alone, for a host that wears one: the same block `themes.css` holds for it ([Presets](https://wow.ahoo.me/typescript/view-engine/theming#presets)). |
162
- | `/shadcn-bridge.css` | Optional: a host's shadcn tokens read into the `--fvp-*` variables, bar `input`, `ring`, the status and the chart colours and the shadows, and only while no preset is named ([the bridge](https://wow.ahoo.me/typescript/view-engine/theming#the-shadcn-bridge)), checked by the same script. |
194
+ | Entry | Exports |
195
+ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
196
+ | `@ahoo-wang/wow-view-engine` | Model types and the constants a definition names; the pure kernels, one entry per kind and stage — `validateRecord` / `compileRecord` / `projectRecord`, `validateAnalysis` / `compileAnalysis` / `projectAnalysis`, `validateFilter` / `compileFilter`, `validateDashboard`; the helpers a host writes definitions with (`defineView`, `defineDataset`, `text`, the field-kind registry); from the runtime, what a host holds and nothing it is built from — `ViewEngine`, `validateDefinition`, the runtime contracts `ViewRuntime`, `RecordViewRuntime`, `DashboardRuntime` and `AnyViewRuntime` with every type their signatures name, `hasResult`, `hasAsked`, `isRecordRuntime`, `actions` with the declared actions' types, the write errors `ViewWriteError` and `ViewCommandError`, `ExportCancelledError`, `RuntimeEnvironment`, `defaultRuntimeEnvironment`, `ViewSource`, `OptionSource`; the `ViewStore` port, `MemoryViewStore` and `localStorageSnapshot` |
197
+ | `/react` | Hooks and headless controllers with the types they return: `useCreateViewEngine`, `useEngine`, `useOpenView`, `useViewRuntime`, `useViewList`, `useViewManager`, `useWorkbench`, `useLeaveGuard`, `useFilterEditor`, `useRecordTable`, `useAnalysisEditor`, `useAnalysisResult`, `useDashboard`, `useSaveCommands`, `useRecordActions` (the declared actions of one record surface: what each record and the selection are offered, the question or form waiting, the one runner), `RecordActionSlots`, and the two write-outcome types the save commands report (`SettledWrite`, `RecoveredWrite`) |
198
+ | `/ui` | Default components, views and workbenches with their props: `DataWorkbench`, `DashboardWorkbench`, `DashboardEditExtensions`, `useDashboardExtensions`, `EmbeddedView`, `EmbeddedDashboard`, `ViewHost`, `bind`, `useViewNavigation`, `useColorMode`, `ViewHeader`, `SaveActions`, `ViewManager`, `LeaveDialog`, `EditorBand`, `FilterPanel`, `StatusStrip`, `AppliedBar`, `ResultToolbar`, `RowActions`, `RecordTable`, `RecordCards`, `RecordPagination`, `AnalysisTable`, `AnalysisChart`, `DashboardGrid`, `HeadingPanel`, `MarkdownPanel`, `ImagePanel`, `LinksPanel`, `MessagesProvider`; the catalogues `en` and `zhCN`; the reading of a value, `cellValue`, `cellText` and `displayValue` |
199
+ | `/testing` | `memorySource` and `matches`: an in-memory `ViewSource` with Wow's query semantics; `resolveNavigation`: the engine's own routing of a way off through your bindings, for your routing tests; `admit`: a host's declarations admitted over its committed descriptors; `actionHarness`: a host's declared actions read by the engine's rules, without a screen — for a host's tests ([testing a host](https://wow.ahoo.me/typescript/view-engine/host#testing)) |
200
+ | `/react-router` | `useReactRouter`: React Router as the router port a host hands its view host. React Router is an optional peer, and this is the one entry that loads it |
201
+ | `/styles.css` | The theme. Import it explicitly; no JavaScript entry imports CSS, and nothing in it paints outside the two style boundaries `.fve-root` and `.fve-tokens` (preflight and the base are scoped at build time at no extra weight, and every utility is `fve:`-prefixed, so it never shares a name with yours and your import order does not matter) — bar the preset reset, which only empties the `--fvp-*` layer where a preset is named — all checked by `scripts/verify-package.mjs` on every build. |
202
+ | `/themes.css` | The presets, optional: only `--fvp-*` assignments keyed by `data-fve-preset` ([Presets](https://wow.ahoo.me/typescript/view-engine/theming#presets)), checked by the same script. |
203
+ | `/themes/<name>.css` | One preset alone, for a host that wears one: the same block `themes.css` holds for it ([Presets](https://wow.ahoo.me/typescript/view-engine/theming#presets)). |
204
+ | `/shadcn-bridge.css` | Optional: a host's shadcn tokens read into the `--fvp-*` variables, bar `input`, `ring`, the status and the chart colours and the shadows, and only while no preset is named ([the bridge](https://wow.ahoo.me/typescript/view-engine/theming#the-shadcn-bridge)), checked by the same script. |
205
+
206
+ A value is exported from one entry only, so a bundle never holds two copies of it; a type a secondary entry's own API names is also exported there (`/react-router` exports `ViewRouter`, `/testing` exports `ViewDestination`), so a host importing that entry alone can write its signatures.
163
207
 
164
208
  That is the public surface, and it is kept name by name. Each entry writes every name it exports, grouped by the file that declares it; none re-exports a whole module (`test/architecture.test.ts`), so an `export` a file writes for its neighbours never becomes public by accident. Each code entry's complete list — every name, and whether it is a type or a value — is in `test/surface/` (`root.txt`, `react.txt`, `ui.txt`, `testing.txt`, `react-router.txt`): `test/publicSurface.test.ts` fails when an entry exports a name its list does not hold or stops exporting one it does, and `scripts/verify-package.mjs` holds each built JavaScript entry to the same list. A name added to a list or taken off one is a change to the public surface and is reviewed as one. The command is surface too: `test/surface/bin.txt` lists the `bin` (`wow-view-engine`) and each subcommand it answers ([`theme-check`](https://wow.ahoo.me/typescript/view-engine/theming#checking-a-theme)).
165
209
 
package/README.zh-CN.md CHANGED
@@ -28,6 +28,11 @@ Peer 依赖:`@ahoo-wang/wow-client`(以及它需要的 fetcher 包);`rea
28
28
  <!-- typecheck: file=orders.ts -->
29
29
 
30
30
  ```ts
31
+ import {
32
+ AggregationFunction,
33
+ FilterOperator,
34
+ SortDirection,
35
+ } from '@ahoo-wang/wow-client/dsl';
31
36
  import type { ViewDefinition } from '@ahoo-wang/wow-view-engine';
32
37
 
33
38
  export const orders: ViewDefinition = {
@@ -51,7 +56,7 @@ export const orders: ViewDefinition = {
51
56
  name: 'amount',
52
57
  label: 'Amount',
53
58
  kind: 'number',
54
- summary: ['SUM', 'AVG'],
59
+ summary: [AggregationFunction.SUM, AggregationFunction.AVG],
55
60
  },
56
61
  { name: 'createdAt', label: 'Created', kind: 'datetime', sortable: true },
57
62
  ],
@@ -68,13 +73,19 @@ export const orders: ViewDefinition = {
68
73
  op: 'and',
69
74
  // enum 是封闭集合,因此提供 IN 与 NOT_IN 而不是 EQ:
70
75
  // 一个条件即表达“取其中之一”,两者互换时保留已选项。
71
- children: [{ field: 'status', operator: 'IN', value: ['PENDING'] }],
76
+ children: [
77
+ {
78
+ field: 'status',
79
+ operator: FilterOperator.IN,
80
+ value: ['PENDING'],
81
+ },
82
+ ],
72
83
  },
73
84
  filterMode: 'simple',
74
85
  refresh: { interval: null },
75
- sort: [{ field: 'createdAt', direction: 'DESC' }],
86
+ sort: [{ field: 'createdAt', direction: SortDirection.DESC }],
76
87
  pageSize: 20,
77
- summaries: [{ field: 'amount', fn: 'SUM' }],
88
+ summaries: [{ field: 'amount', fn: AggregationFunction.SUM }],
78
89
  layout: 'table',
79
90
  table: {
80
91
  columns: [
@@ -103,7 +114,7 @@ import { MemoryViewStore, ViewEngine } from '@ahoo-wang/wow-view-engine';
103
114
 
104
115
  const engine = new ViewEngine({
105
116
  store: new MemoryViewStore(),
106
- // 一个 ViewSource;@ahoo-wang/wow-view-store 的 viewSourceOf 把 Wow 的查询路由接到这里
117
+ // 一个 ViewSource:Wow 查询路由的客户端(生成的 …SnapshotQueryClient)本身就是
107
118
  resources: [{ definition: orders, source: sources.orders }],
108
119
  });
109
120
  ```
@@ -128,6 +139,32 @@ export function OrdersPage() {
128
139
 
129
140
  真实应用的页面外面套一层 `ViewHost`,把引擎、你的路由、语言、主题与命令接起来:见[把引擎放进宿主](https://wow.ahoo.me/zh/typescript/view-engine/host)。
130
141
 
142
+ ### 引用字段的排序与搜索
143
+
144
+ 带 `remote` 的 `reference` 字段存的是 id、显示的是名称(由宿主的选项读出)。服务端按存储的 id 排序、在存储的文本里搜索,从不按显示的名称,所以这样的字段只有写了 `sortable: true` 才排序——按 id,表头和排序编辑器都会标明「按 ID」——而且不能作为搜索字段:准入会拒绝保存在它上面的排序(`record.sort.reference-label`)和点名它的搜索(`definition.search.reference-label`)。要按名称排序或搜索,把名称冗余进读模型,用那个字段:
145
+
146
+ ```ts
147
+ import type { FieldDefinition } from '@ahoo-wang/wow-view-engine';
148
+
149
+ export const customerFields: FieldDefinition[] = [
150
+ // 存客户的 id,显示它的名称。
151
+ {
152
+ name: 'customerId',
153
+ label: '客户',
154
+ kind: 'reference',
155
+ remote: 'customers',
156
+ },
157
+ // 冗余在读模型里的名称:行按它排序、在它里面搜索。
158
+ {
159
+ name: 'customerName',
160
+ label: '客户名称',
161
+ kind: 'string',
162
+ sortable: true,
163
+ },
164
+ { name: 'q', label: '搜索', kind: 'search', searchFields: ['customerName'] },
165
+ ];
166
+ ```
167
+
131
168
  ## 文档
132
169
 
133
170
  | 想做的事 | 读 |
@@ -146,17 +183,19 @@ export function OrdersPage() {
146
183
 
147
184
  ## 入口
148
185
 
149
- | 入口 | 导出 |
150
- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
151
- | `@ahoo-wang/wow-view-engine` | 模型类型与常量;四个纯内核(`validate*` / `compile*` / `project*` 及其旁边的读法);运行时只导出宿主要握的,不导出它由什么搭成——`ViewEngine`、`validateDefinition`、运行时合同 `ViewRuntime`、`RecordViewRuntime`、`DashboardRuntime`、`AnyViewRuntime` 连同它们签名里出现的每一个类型、`hasResult`、`hasAsked`、`isRecordRuntime`、`actions` 连同声明式操作的类型、写入错误 `ViewWriteError` 与 `ViewCommandError`、`ExportCancelledError`、`RuntimeEnvironment`、`defaultRuntimeEnvironment`、`ViewSource`、`OptionSource`;`ViewStore` 端口、`MemoryViewStore` 与 `localStorageSnapshot` |
152
- | `/react` | 钩子与无样式控制器,连同它们交出的类型:`useViewEngine`、`useOpenView`、`useViewRuntime`、`useViewList`、`useViewManager`、`useWorkbench`、`useLeaveGuard`、`useFilterEditor`、`useRecordTable`、`useAnalysisEditor`、`useAnalysisResult`、`useDashboard`、`useSaveCommands`、`useRecordActions`(一个记录面上的声明式操作:每条记录与选中的能做什么、等读者回答的确认或表单、唯一的执行器)、`RecordActionSlots`,以及保存命令报告的两个写入结局类型(`SettledWrite`、`RecoveredWrite`) |
153
- | `/ui` | 默认组件、视图与工作台,连同它们的 props:`DataWorkbench`、`DashboardWorkbench`、`DashboardEditExtensions`、`useDashboardExtensions`、`EmbeddedView`、`EmbeddedDashboard`、`ViewHost`、`bind`、`useEngine`、`useViewNavigation`、`useColorMode`、`ViewHeader`、`SaveActions`、`ViewManager`、`LeaveDialog`、`EditorBand`、`FilterPanel`、`StatusStrip`、`AppliedBar`、`ResultToolbar`、`RowActions`、`RecordTable`、`RecordCards`、`RecordPagination`、`AnalysisTable`、`AnalysisChart`、`DashboardGrid`、`HeadingPanel`、`MarkdownPanel`、`ImagePanel`、`LinksPanel`、`MessagesProvider`;措辞目录 `en` 与 `zhCN`;一个值的读法 `cellValue`、`cellText`、`displayValue` |
154
- | `/testing` | `memorySource` 与 `matches`:带 Wow 查询语义的内存 `ViewSource`;`resolveNavigation`:引擎自己按宿主绑定解析离开的路,供宿主测路由;`admit`:按提交的描述符准入宿主的声明;`actionHarness`:按引擎的规则读宿主声明的操作,不画界面——供宿主测试使用([测试宿主](https://wow.ahoo.me/zh/typescript/view-engine/host#testing)) |
155
- | `/react-router` | `useReactRouter`:把 React Router 接成视图宿主的路由端口。React Router 是可选 peer,只有这个入口加载它 |
156
- | `/styles.css` | 主题。显式导入;任何 JS 入口都不会引入 CSS,产物也不会在 `.fve-root`/`.fve-tokens` 两个样式边界之外绘制任何东西(preflight 与 base 在构建时收进边界内、不加权重,工具类一律带 `fve:` 前缀、与宿主的不同名,所以宿主的导入次序无关)——预设的复位规则除外,它只在挂了预设的元素上清空 `--fvp-*` 层——`scripts/verify-package.mjs` 在每次构建时逐条核对。 |
157
- | `/themes.css` | 预设,可选:只有按 `data-fve-preset` 选中的 `--fvp-*` 赋值([预设](https://wow.ahoo.me/zh/typescript/view-engine/theming#预设)),由同一个脚本核对。 |
158
- | `/themes/<名>.css` | 单独一套预设,给只用一套的宿主:就是 `themes.css` 里它那一块([预设](https://wow.ahoo.me/zh/typescript/view-engine/theming#预设))。 |
159
- | `/shadcn-bridge.css` | 可选:把宿主的 shadcn token 读进 `--fvp-*` 变量,`input`、`ring`、状态色、图表色与阴影除外,且只在没挂预设时生效([桥接](https://wow.ahoo.me/zh/typescript/view-engine/theming#shadcn-桥接)),由同一个脚本核对。 |
186
+ | 入口 | 导出 |
187
+ | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
188
+ | `@ahoo-wang/wow-view-engine` | 模型类型与定义要用的常量;纯内核,每个种类、每个阶段一个入口——`validateRecord` / `compileRecord` / `projectRecord`、`validateAnalysis` / `compileAnalysis` / `projectAnalysis`、`validateFilter` / `compileFilter`、`validateDashboard`;宿主写定义用的辅助(`defineView`、`defineDataset`、`text`、字段种类注册表);运行时只导出宿主要握的,不导出它由什么搭成——`ViewEngine`、`validateDefinition`、运行时合同 `ViewRuntime`、`RecordViewRuntime`、`DashboardRuntime`、`AnyViewRuntime` 连同它们签名里出现的每一个类型、`hasResult`、`hasAsked`、`isRecordRuntime`、`actions` 连同声明式操作的类型、写入错误 `ViewWriteError` 与 `ViewCommandError`、`ExportCancelledError`、`RuntimeEnvironment`、`defaultRuntimeEnvironment`、`ViewSource`、`OptionSource`;`ViewStore` 端口、`MemoryViewStore` 与 `localStorageSnapshot` |
189
+ | `/react` | 钩子与无样式控制器,连同它们交出的类型:`useCreateViewEngine`、`useEngine`、`useOpenView`、`useViewRuntime`、`useViewList`、`useViewManager`、`useWorkbench`、`useLeaveGuard`、`useFilterEditor`、`useRecordTable`、`useAnalysisEditor`、`useAnalysisResult`、`useDashboard`、`useSaveCommands`、`useRecordActions`(一个记录面上的声明式操作:每条记录与选中的能做什么、等读者回答的确认或表单、唯一的执行器)、`RecordActionSlots`,以及保存命令报告的两个写入结局类型(`SettledWrite`、`RecoveredWrite`) |
190
+ | `/ui` | 默认组件、视图与工作台,连同它们的 props:`DataWorkbench`、`DashboardWorkbench`、`DashboardEditExtensions`、`useDashboardExtensions`、`EmbeddedView`、`EmbeddedDashboard`、`ViewHost`、`bind`、`useViewNavigation`、`useColorMode`、`ViewHeader`、`SaveActions`、`ViewManager`、`LeaveDialog`、`EditorBand`、`FilterPanel`、`StatusStrip`、`AppliedBar`、`ResultToolbar`、`RowActions`、`RecordTable`、`RecordCards`、`RecordPagination`、`AnalysisTable`、`AnalysisChart`、`DashboardGrid`、`HeadingPanel`、`MarkdownPanel`、`ImagePanel`、`LinksPanel`、`MessagesProvider`;措辞目录 `en` 与 `zhCN`;一个值的读法 `cellValue`、`cellText`、`displayValue` |
191
+ | `/testing` | `memorySource` 与 `matches`:带 Wow 查询语义的内存 `ViewSource`;`resolveNavigation`:引擎自己按宿主绑定解析离开的路,供宿主测路由;`admit`:按提交的描述符准入宿主的声明;`actionHarness`:按引擎的规则读宿主声明的操作,不画界面——供宿主测试使用([测试宿主](https://wow.ahoo.me/zh/typescript/view-engine/host#testing)) |
192
+ | `/react-router` | `useReactRouter`:把 React Router 接成视图宿主的路由端口。React Router 是可选 peer,只有这个入口加载它 |
193
+ | `/styles.css` | 主题。显式导入;任何 JS 入口都不会引入 CSS,产物也不会在 `.fve-root`/`.fve-tokens` 两个样式边界之外绘制任何东西(preflight 与 base 在构建时收进边界内、不加权重,工具类一律带 `fve:` 前缀、与宿主的不同名,所以宿主的导入次序无关)——预设的复位规则除外,它只在挂了预设的元素上清空 `--fvp-*` 层——`scripts/verify-package.mjs` 在每次构建时逐条核对。 |
194
+ | `/themes.css` | 预设,可选:只有按 `data-fve-preset` 选中的 `--fvp-*` 赋值([预设](https://wow.ahoo.me/zh/typescript/view-engine/theming#预设)),由同一个脚本核对。 |
195
+ | `/themes/<名>.css` | 单独一套预设,给只用一套的宿主:就是 `themes.css` 里它那一块([预设](https://wow.ahoo.me/zh/typescript/view-engine/theming#预设))。 |
196
+ | `/shadcn-bridge.css` | 可选:把宿主的 shadcn token 读进 `--fvp-*` 变量,`input`、`ring`、状态色、图表色与阴影除外,且只在没挂预设时生效([桥接](https://wow.ahoo.me/zh/typescript/view-engine/theming#shadcn-桥接)),由同一个脚本核对。 |
197
+
198
+ 一个值只从一个入口导出,打包时就不会出现它的两份副本;次级入口自己的 API 用到的类型也从那里导出(`/react-router` 导出 `ViewRouter`,`/testing` 导出 `ViewDestination`),只导入那个入口的宿主也能写出签名。
160
199
 
161
200
  这就是公开面,而且逐个名字守着。每个入口把它导出的名字逐个写出,按声明它的文件分组,不整模块转出(`test/architecture.test.ts`),所以文件为包内邻居写的 `export` 不会意外变成公开的。每个代码入口的完整清单——每一个名字,以及它是类型还是值——在 `test/surface/`(`root.txt`、`react.txt`、`ui.txt`、`testing.txt`、`react-router.txt`):入口多导出了清单上没有的名字、或不再导出清单上有的名字,`test/publicSurface.test.ts` 就失败;`scripts/verify-package.mjs` 再拿同一份清单核对构建出的每个 JS 入口。往清单里加一个名字或拿掉一个,就是改公开面,按改公开面来审。命令也是公开面:`test/surface/bin.txt` 列出 `bin`(`wow-view-engine`)与它认的每个子命令([`theme-check`](https://wow.ahoo.me/zh/typescript/view-engine/theming#检查一套主题))。
162
201