@10x-media/analytics 1.0.0-beta.9 → 4.0.0-alpha.1

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 (1273) hide show
  1. package/CHANGELOG.md +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"AnalyticsTrendWidget.js","names":[],"sources":["../../src/widgets/AnalyticsTrendWidget.tsx"],"sourcesContent":["import type { WidgetServerProps } from 'payload'\nimport { bucketByRange, bucketSeries, onPrimaryAxis } from '../charts/bucket'\nimport { TrendChart } from '../charts/TrendChart'\nimport type { MetricKey } from '../core/contract'\nimport { formatMetricValue } from '../fields/format'\nimport { requestTimezone } from '../plugin/runtime'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { METRIC_KEYS, TIMEFRAME_KEYS } from '../translations/metricKeys'\nimport { asTranslate } from '../translations/server'\nimport { ComparisonDelta } from './ComparisonDelta'\nimport { cardStyle, labelStyle } from './cardChrome'\nimport { captionWithFilter } from './filterCaption'\nimport { widgetFilters } from './filterField'\nimport { formatRangeCaption, resolveCustomRange } from './range'\nimport type { WidgetReadStatus } from './readForWidget'\nimport { readForWidgetSeries } from './readForWidgetSeries'\nimport type { MetricWidgetData } from './types'\nimport { type WidgetViewProps, widgetViewHref } from './viewLink'\nimport { WidgetViewLink } from './WidgetViewLink'\n\nconst STATE_KEY: Record<Exclude<WidgetReadStatus, 'ok'>, TranslationKey> = {\n\t'not-configured': keys.stateNotConfigured,\n\tunavailable: keys.stateUnavailable,\n\t'filter-unsupported': keys.stateFilterUnsupported,\n}\n\nexport default async function AnalyticsTrendWidget(props: WidgetServerProps & WidgetViewProps) {\n\tconst data = (props.widgetData ?? {}) as MetricWidgetData\n\tconst metric: MetricKey = data.metric ?? 'pageviews'\n\tconst rawTimeframe = data.timeframe ?? 'last30days'\n\t// Only a custom range needs the reporting timezone before the read; a preset window\n\t// resolves inside the read path, which resolves the timezone there as it always has.\n\tconst timezone = rawTimeframe === 'custom' ? await requestTimezone(props.req) : undefined\n\tconst customRange = timezone ? resolveCustomRange(rawTimeframe, data.range, timezone) : undefined\n\tconst timeframe: TimeframePreset = rawTimeframe === 'custom' ? 'last30days' : rawTimeframe\n\tconst t = asTranslate(props.req.i18n.t)\n\tconst locale = props.req.i18n.language ?? 'en-US'\n\tconst title = data.title?.trim() || t(METRIC_KEYS[metric])\n\n\tconst compare = data.compare === true\n\tconst filters = widgetFilters(data)\n\tconst result = await readForWidgetSeries({\n\t\treq: props.req,\n\t\tmetric,\n\t\ttimeframe,\n\t\tadapterId: data.dataSource,\n\t\tnow: new Date(),\n\t\trange: customRange,\n\t\tcompare,\n\t\tfilters,\n\t\t...(timezone ? { timezone } : {}),\n\t})\n\t// The adapter that answered, which on a scoped or runtime-provider install is not the\n\t// id the widget asked for.\n\tconst href = widgetViewHref(props.view, props.req, {\n\t\ttimeframe: rawTimeframe,\n\t\ttimezone: timezone ?? DEFAULT_TIMEZONE,\n\t\t...(customRange ? { range: customRange } : {}),\n\t\t...(result.adapterId ? { source: result.adapterId } : {}),\n\t\tmetric,\n\t\tcompare,\n\t\tfilters,\n\t})\n\n\tif (result.status !== 'ok') {\n\t\treturn (\n\t\t\t<div className=\"analytics-trend-widget\" style={cardStyle}>\n\t\t\t\t<span style={labelStyle}>{title}</span>\n\t\t\t\t<span style={{ color: 'var(--theme-elevation-400)' }}>{t(STATE_KEY[result.status])}</span>\n\t\t\t\t<WidgetViewLink href={href} label={t(keys.widgetOpenInView)} />\n\t\t\t</div>\n\t\t)\n\t}\n\n\tconst windowCaption =\n\t\tcustomRange && timezone\n\t\t\t? formatRangeCaption(customRange, locale, timezone)\n\t\t\t: t(TIMEFRAME_KEYS[timeframe])\n\tconst caption = captionWithFilter(windowCaption, filters[0], t)\n\tconst buckets = customRange\n\t\t? bucketByRange(result.points, customRange, result.timezone)\n\t\t: bucketSeries(result.points, timeframe, result.timezone)\n\tconst toPoints = (source: typeof buckets) =>\n\t\tsource.map((b) => ({ ...b, display: formatMetricValue(metric, b.value, locale) }))\n\tconst trendPoints = toPoints(buckets)\n\t// The comparison is re-dated onto the primary axis before bucketing: at week and month\n\t// units its own dates would fall on different boundaries.\n\tconst previousSeries =\n\t\tcompare && result.comparisonPoints\n\t\t\t? onPrimaryAxis(result.comparisonPoints, result.points)\n\t\t\t: undefined\n\tconst comparisonPoints = previousSeries\n\t\t? toPoints(\n\t\t\t\tcustomRange\n\t\t\t\t\t? bucketByRange(previousSeries, customRange, result.timezone)\n\t\t\t\t\t: bucketSeries(previousSeries, timeframe, result.timezone)\n\t\t\t)\n\t\t: undefined\n\treturn (\n\t\t<div className=\"analytics-trend-widget\" style={cardStyle}>\n\t\t\t<span style={labelStyle}>{title}</span>\n\t\t\t<span\n\t\t\t\tstyle={{\n\t\t\t\t\tfontSize: '1.75rem',\n\t\t\t\t\tfontWeight: 700,\n\t\t\t\t\tlineHeight: 1.1,\n\t\t\t\t\tcolor: 'var(--theme-elevation-800)',\n\t\t\t\t}}\n\t\t\t>\n\t\t\t\t{formatMetricValue(metric, result.total, locale)}\n\t\t\t</span>\n\t\t\t<TrendChart\n\t\t\t\tbuckets={trendPoints}\n\t\t\t\t{...(comparisonPoints && result.comparisonRange\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tcomparison: comparisonPoints,\n\t\t\t\t\t\t\tcomparisonLabel: t(keys.viewTrendPrevious),\n\t\t\t\t\t\t\tcomparisonRange: formatRangeCaption(result.comparisonRange, locale, result.timezone),\n\t\t\t\t\t\t\tlabel: title,\n\t\t\t\t\t\t}\n\t\t\t\t\t: {})}\n\t\t\t\tariaLabel={`${title} ${caption}`}\n\t\t\t\tminHeight={180}\n\t\t\t/>\n\t\t\t<span style={{ fontSize: '0.75rem', color: 'var(--theme-elevation-400)' }}>{caption}</span>\n\t\t\t{result.comparisonRange ? (\n\t\t\t\t<ComparisonDelta\n\t\t\t\t\tcurrent={result.total}\n\t\t\t\t\tprevious={result.previousTotal}\n\t\t\t\t\tmetric={metric}\n\t\t\t\t\tlocale={locale}\n\t\t\t\t\tt={t}\n\t\t\t\t/>\n\t\t\t) : null}\n\t\t\t{result.stale ? (\n\t\t\t\t<span style={{ fontSize: '0.6875rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t\t{t(keys.viewStale)}\n\t\t\t\t</span>\n\t\t\t) : null}\n\t\t\t{result.clamped ? (\n\t\t\t\t<span style={{ fontSize: '0.6875rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t\t{t(keys.stateClamped)}\n\t\t\t\t</span>\n\t\t\t) : null}\n\t\t\t{result.filtersUnapplied ? (\n\t\t\t\t<span style={{ fontSize: '0.6875rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t\t{t(keys.stateFiltersUnapplied)}\n\t\t\t\t</span>\n\t\t\t) : null}\n\t\t\t{result.sampled ? (\n\t\t\t\t<span style={{ fontSize: '0.6875rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t\t{t(keys.stateSampled)}\n\t\t\t\t</span>\n\t\t\t) : null}\n\t\t\t<WidgetViewLink href={href} label={t(keys.widgetOpenInView)} />\n\t\t</div>\n\t)\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"AnalyticsTrendWidget.js","names":[],"sources":["../../src/widgets/AnalyticsTrendWidget.tsx"],"sourcesContent":["import { labelSeries, unitForRange } from '../charts/bucket'\nimport { markInProgress } from '../charts/inProgress'\nimport { TrendChart, type TrendPoint } from '../charts/TrendChart'\nimport { currentDate } from '../core/clock'\nimport { formatMetricValue } from '../fields/format'\nimport { revenueCurrencyOf } from '../goals/currency'\nimport { requestCurrency } from '../plugin/runtime'\nimport { intlLocale } from '../translations/intl'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\nimport { ComparisonDelta } from './ComparisonDelta'\nimport { widgetFilters } from './filterField'\nimport { widgetNotice } from './notices'\nimport { formatRangeCaption } from './range'\nimport { readForWidgetSeries } from './readForWidgetSeries'\nimport { metricWidgetTitle, placeholderTitle } from './titleForecast'\nimport type { MetricWidgetData } from './types'\nimport { type AnalyticsWidgetProps, widgetLink } from './viewLink'\nimport { WidgetBody, WidgetCard, WidgetNote, WidgetValue } from './WidgetCard'\nimport { WidgetFrame, WidgetStateCard } from './WidgetFrame'\nimport { storedWidgetData } from './widgetData'\nimport { resolveWidgetWindow, widgetCaption, windowReadArgs } from './widgetWindow'\n\nconst CLASS_NAME = 'analytics-trend-widget'\n\nconst CHART_MIN_HEIGHT = 140\n\nconst dataOf = (props: AnalyticsWidgetProps): MetricWidgetData => storedWidgetData(props.widgetData)\n\n/**\n * The card's frame paints at once; its total and chart stream in when the read answers.\n *\n * @beta\n */\nexport default function AnalyticsTrendWidget(props: AnalyticsWidgetProps) {\n\treturn (\n\t\t<WidgetFrame\n\t\t\tclassName={CLASS_NAME}\n\t\t\tkind=\"trend\"\n\t\t\twidget={props}\n\t\t\t{...placeholderTitle(props.req, dataOf(props), { series: true })}\n\t\t>\n\t\t\t<TrendWidgetBody {...props} />\n\t\t</WidgetFrame>\n\t)\n}\n\nasync function TrendWidgetBody(props: AnalyticsWidgetProps) {\n\tconst data = dataOf(props)\n\tconst metric = data.metric ?? 'pageviews'\n\tconst t = asTranslate(props.req.i18n.t)\n\tconst locale = intlLocale(props.req.i18n.language)\n\tconst title = metricWidgetTitle(data, t)\n\tconst window = await resolveWidgetWindow(props.req, data)\n\tif (window.unreadable) {\n\t\treturn (\n\t\t\t<WidgetStateCard\n\t\t\t\tclassName={CLASS_NAME}\n\t\t\t\tlocale={locale}\n\t\t\t\tstatus=\"invalid\"\n\t\t\t\tt={t}\n\t\t\t\ttitle={title}\n\t\t\t/>\n\t\t)\n\t}\n\tconst reporting = await requestCurrency(props.req)\n\tconst compare = data.compare === true\n\tconst filters = widgetFilters(data)\n\tconst now = currentDate()\n\tconst result = await readForWidgetSeries({\n\t\treq: props.req,\n\t\tmetric,\n\t\tadapterId: data.dataSource,\n\t\tfallbackWhenUnreadable: true,\n\t\tnow,\n\t\tcompare,\n\t\tfilters,\n\t\t...windowReadArgs(window),\n\t})\n\tconst link = widgetLink(props, t, {\n\t\twindow,\n\t\tadapterId: result.adapterId,\n\t\tmetric,\n\t\tcompare,\n\t\tfilters,\n\t})\n\tif (result.status !== 'ok') {\n\t\treturn (\n\t\t\t<WidgetStateCard\n\t\t\t\tclassName={CLASS_NAME}\n\t\t\t\tlink={link}\n\t\t\t\tlocale={locale}\n\t\t\t\tretryAfterMs={result.retryAfterMs}\n\t\t\t\tstatus={result.status}\n\t\t\t\tt={t}\n\t\t\t\ttitle={title}\n\t\t\t/>\n\t\t)\n\t}\n\n\tconst currency = result.currency ?? revenueCurrencyOf(filters, reporting)\n\tconst caption = await widgetCaption(props.req, { window, filters, read: result, locale, t })\n\tconst notice = widgetNotice(result, { t, locale, now, timeZone: result.timezone })\n\t// A window charted by hour needs hourly rows; without them the headline total above is the\n\t// whole answer, and a one-point line under it would only look like a broken chart.\n\tconst chartable = unitForRange(result.dateRange) !== 'hour' || result.seriesGranularity === 'hour'\n\tconst format = (value: TrendPoint['value']): string =>\n\t\tformatMetricValue(metric, value, { locale, currency })\n\tconst trendPoints: TrendPoint[] = markInProgress(\n\t\tlabelSeries(result.points, {\n\t\t\tgranularity: result.seriesGranularity ?? 'day',\n\t\t\ttz: result.timezone,\n\t\t\tlocale,\n\t\t\tweekday: !window.range && window.timeframe === 'last7days',\n\t\t\tfrom: result.dateRange.start,\n\t\t}).map((bucket) => ({ ...bucket, display: format(bucket.value) })),\n\t\t{ now, end: result.dateRange.end, soFar: (period) => t(keys.chartSoFar, { period }) }\n\t)\n\t// The read aligned the previous window to these buckets by index, so it borrows their labels.\n\tconst comparisonPoints: TrendPoint[] | undefined =\n\t\tcompare && result.comparisonPoints\n\t\t\t? trendPoints.map((bucket, i) => {\n\t\t\t\t\tconst value = result.comparisonPoints?.[i]?.value ?? null\n\t\t\t\t\treturn { ...bucket, value, display: format(value) }\n\t\t\t\t})\n\t\t\t: undefined\n\t// An average with no reading on any day has no line to draw; the dash above says so.\n\tconst drawable = trendPoints.some((point) => point.value !== null)\n\treturn (\n\t\t<WidgetCard\n\t\t\tclassName={CLASS_NAME}\n\t\t\tcaption={caption}\n\t\t\tlink={link}\n\t\t\ttitle={metricWidgetTitle(data, t, result.visitorsSummed)}\n\t\t>\n\t\t\t<WidgetValue\n\t\t\t\tnoValueLabel={t(keys.stateNoValue)}\n\t\t\t\tvalue={formatMetricValue(metric, result.total, { locale, currency })}\n\t\t\t>\n\t\t\t\t{result.comparisonRange ? (\n\t\t\t\t\t<ComparisonDelta\n\t\t\t\t\t\tcurrent={result.total}\n\t\t\t\t\t\tprevious={result.previousTotal}\n\t\t\t\t\t\tmetric={metric}\n\t\t\t\t\t\tlocale={locale}\n\t\t\t\t\t\tt={t}\n\t\t\t\t\t/>\n\t\t\t\t) : null}\n\t\t\t</WidgetValue>\n\t\t\t{chartable && drawable ? (\n\t\t\t\t<WidgetBody>\n\t\t\t\t\t<TrendChart\n\t\t\t\t\t\tbuckets={trendPoints}\n\t\t\t\t\t\t{...(comparisonPoints && result.comparisonRange\n\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\tcomparison: comparisonPoints,\n\t\t\t\t\t\t\t\t\tcomparisonLabel: t(keys.viewTrendPrevious),\n\t\t\t\t\t\t\t\t\tcomparisonRange: formatRangeCaption(\n\t\t\t\t\t\t\t\t\t\tresult.comparisonRange,\n\t\t\t\t\t\t\t\t\t\tlocale,\n\t\t\t\t\t\t\t\t\t\tresult.timezone\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t: {})}\n\t\t\t\t\t\tariaLabel={`${title} ${caption}`}\n\t\t\t\t\t\tfill\n\t\t\t\t\t\tkeyboardHint={t(keys.chartKeyboardHint)}\n\t\t\t\t\t\tlabel={title}\n\t\t\t\t\t\tminHeight={CHART_MIN_HEIGHT}\n\t\t\t\t\t\tnoValueLabel={t(keys.stateNoValue)}\n\t\t\t\t\t\tperiodLabel={t(keys.viewTrendPeriod)}\n\t\t\t\t\t/>\n\t\t\t\t</WidgetBody>\n\t\t\t) : null}\n\t\t\t<WidgetNote>{notice}</WidgetNote>\n\t\t</WidgetCard>\n\t)\n}\n"],"mappings":"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"}
@@ -1,16 +1,21 @@
1
1
  import { keys } from "../translations/keys.js";
2
- import { computeDelta } from "./comparison.js";
2
+ import { computeDelta } from "../timeframe/comparison.js";
3
+ import { numberFormat } from "../translations/intl.js";
4
+ import "../ui/analytics.css";
3
5
  import { jsx, jsxs } from "react/jsx-runtime";
6
+ import { Pill } from "@payloadcms/ui";
4
7
  //#region src/widgets/ComparisonDelta.tsx
5
- const SUCCESS = "var(--theme-success-500, rgb(21, 135, 186))";
6
- const ERROR = "var(--theme-error-500, rgb(218, 75, 72))";
7
- const NEUTRAL = "var(--theme-elevation-400)";
8
8
  /** Metrics where a decrease is the good outcome, inverting the delta colors. */
9
9
  const LOWER_IS_BETTER = new Set(["bounceRate"]);
10
- const colorFor = (direction, metric) => {
11
- if (direction === "none") return NEUTRAL;
10
+ const toneFor = (direction, metric) => {
11
+ if (direction === "none") return "none";
12
12
  const goodWhenDown = metric !== void 0 && LOWER_IS_BETTER.has(metric);
13
- return direction === "up" !== goodWhenDown ? SUCCESS : ERROR;
13
+ return direction === "up" !== goodWhenDown ? "up" : "down";
14
+ };
15
+ const PILL_STYLE = {
16
+ up: "success",
17
+ down: "error",
18
+ none: "light-gray"
14
19
  };
15
20
  const DIRECTION_LABEL = {
16
21
  up: keys.comparisonIncrease,
@@ -19,62 +24,48 @@ const DIRECTION_LABEL = {
19
24
  };
20
25
  const DeltaArrow = ({ direction }) => /* @__PURE__ */ jsx("svg", {
21
26
  "aria-hidden": "true",
27
+ className: direction === "down" ? "analytics-delta__arrow analytics-delta__arrow--down" : "analytics-delta__arrow",
22
28
  focusable: "false",
23
29
  width: "8",
24
30
  height: "8",
25
31
  viewBox: "0 0 8 8",
26
- style: {
27
- flexShrink: 0,
28
- transform: direction === "down" ? "rotate(180deg)" : void 0
29
- },
30
32
  children: /* @__PURE__ */ jsx("path", {
31
33
  d: "M4 1.2 7.3 6.8H0.7Z",
32
34
  fill: "currentColor"
33
35
  })
34
36
  });
35
37
  /**
36
- * Period-over-period delta chip: a colored arrow, the percentage change, and a localized
37
- * "vs. previous period" caption. Renders nothing when there is no comparable previous
38
- * value; when the previous value is 0 (no percentage baseline) the localized direction
39
- * word stands in for the number. All text routes through typed translation keys; the
40
- * arrow is decorative and carried by an aria-label with the localized direction word.
38
+ * Period-over-period delta pill, tinted by whether the change is for the better. Renders
39
+ * nothing without a comparable previous value; a zero previous value shows the direction word.
41
40
  */
42
- function ComparisonDelta({ current, previous, metric, locale, t }) {
41
+ function ComparisonDelta({ current, previous, metric, locale, t, caption = true }) {
43
42
  const delta = computeDelta(current, previous);
44
43
  if (!delta) return null;
45
- const percentText = delta.percent === null ? null : new Intl.NumberFormat(locale, {
44
+ const percentText = delta.percent === null ? null : numberFormat(locale, {
46
45
  style: "percent",
47
46
  maximumFractionDigits: 1,
48
47
  signDisplay: "never"
49
48
  }).format(Math.abs(delta.percent) / 100);
50
- const visible = percentText ?? t(DIRECTION_LABEL[delta.direction]);
49
+ const direction = t(DIRECTION_LABEL[delta.direction]);
50
+ const visible = percentText ?? direction;
51
+ const ariaLabel = percentText === null || delta.direction === "none" ? t(keys.comparisonDirectionLabel, { direction }) : t(keys.comparisonChangeLabel, {
52
+ direction,
53
+ change: percentText
54
+ });
55
+ const tone = toneFor(delta.direction, metric);
51
56
  return /* @__PURE__ */ jsxs("span", {
57
+ "aria-label": ariaLabel,
58
+ className: "analytics-delta",
52
59
  role: "img",
53
- "aria-label": `${t(DIRECTION_LABEL[delta.direction])} ${percentText ?? ""} ${t(keys.comparisonVsPrevious)}`.replace(/\s+/g, " ").trim(),
54
- style: {
55
- display: "inline-flex",
56
- gap: "0.375rem",
57
- alignItems: "center",
58
- fontSize: "0.75rem",
59
- lineHeight: 1.25
60
- },
61
- children: [/* @__PURE__ */ jsxs("span", {
62
- style: {
63
- display: "inline-flex",
64
- alignItems: "center",
65
- gap: "0.25rem",
66
- color: colorFor(delta.direction, metric),
67
- fontWeight: 600,
68
- lineHeight: "inherit"
69
- },
60
+ children: [/* @__PURE__ */ jsxs(Pill, {
61
+ className: `analytics-delta__change analytics-delta__change--${tone}`,
62
+ pillStyle: PILL_STYLE[tone],
63
+ size: "medium",
70
64
  children: [delta.direction !== "none" ? /* @__PURE__ */ jsx(DeltaArrow, { direction: delta.direction }) : null, visible]
71
- }), /* @__PURE__ */ jsx("span", {
72
- style: {
73
- color: "var(--theme-elevation-400)",
74
- lineHeight: "inherit"
75
- },
65
+ }), caption ? /* @__PURE__ */ jsx("span", {
66
+ className: "analytics-delta__caption",
76
67
  children: t(keys.comparisonVsPrevious)
77
- })]
68
+ }) : null]
78
69
  });
79
70
  }
80
71
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"ComparisonDelta.js","names":[],"sources":["../../src/widgets/ComparisonDelta.tsx"],"sourcesContent":["import type { MetricKey } from '../core/contract'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { computeDelta, type DeltaDirection } from './comparison'\n\n// Payload's admin palette maps success to its blue ramp and error to its red ramp; the\n// fallbacks mirror @payloadcms/ui colors.scss so the chip renders identically outside\n// a themed admin shell.\nconst SUCCESS = 'var(--theme-success-500, rgb(21, 135, 186))'\nconst ERROR = 'var(--theme-error-500, rgb(218, 75, 72))'\nconst NEUTRAL = 'var(--theme-elevation-400)'\n\n/** Metrics where a decrease is the good outcome, inverting the delta colors. */\nconst LOWER_IS_BETTER: ReadonlySet<MetricKey> = new Set<MetricKey>(['bounceRate'])\n\nconst colorFor = (direction: DeltaDirection, metric?: MetricKey): string => {\n\tif (direction === 'none') {\n\t\treturn NEUTRAL\n\t}\n\tconst goodWhenDown = metric !== undefined && LOWER_IS_BETTER.has(metric)\n\tconst improved = (direction === 'up') !== goodWhenDown\n\treturn improved ? SUCCESS : ERROR\n}\n\nconst DIRECTION_LABEL: Record<DeltaDirection, TranslationKey> = {\n\tup: keys.comparisonIncrease,\n\tdown: keys.comparisonDecrease,\n\tnone: keys.comparisonNoChange,\n}\n\nconst DeltaArrow = ({ direction }: { direction: 'up' | 'down' }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tfocusable=\"false\"\n\t\twidth=\"8\"\n\t\theight=\"8\"\n\t\tviewBox=\"0 0 8 8\"\n\t\tstyle={{\n\t\t\tflexShrink: 0,\n\t\t\ttransform: direction === 'down' ? 'rotate(180deg)' : undefined,\n\t\t}}\n\t>\n\t\t<path d=\"M4 1.2 7.3 6.8H0.7Z\" fill=\"currentColor\" />\n\t</svg>\n)\n\nexport interface ComparisonDeltaProps {\n\tcurrent?: number\n\tprevious?: number\n\t/** Inverts good/bad coloring for metrics in {@link LOWER_IS_BETTER}. */\n\tmetric?: MetricKey\n\tlocale: string\n\tt: (key: TranslationKey) => string\n}\n\n/**\n * Period-over-period delta chip: a colored arrow, the percentage change, and a localized\n * \"vs. previous period\" caption. Renders nothing when there is no comparable previous\n * value; when the previous value is 0 (no percentage baseline) the localized direction\n * word stands in for the number. All text routes through typed translation keys; the\n * arrow is decorative and carried by an aria-label with the localized direction word.\n */\nexport function ComparisonDelta({ current, previous, metric, locale, t }: ComparisonDeltaProps) {\n\tconst delta = computeDelta(current, previous)\n\tif (!delta) {\n\t\treturn null\n\t}\n\tconst percentText =\n\t\tdelta.percent === null\n\t\t\t? null\n\t\t\t: new Intl.NumberFormat(locale, {\n\t\t\t\t\tstyle: 'percent',\n\t\t\t\t\tmaximumFractionDigits: 1,\n\t\t\t\t\tsignDisplay: 'never',\n\t\t\t\t}).format(Math.abs(delta.percent) / 100)\n\t// An unchanged value is a real 0%, so it reads as one; only a zero previous value\n\t// (no percentage exists to report) falls back to the direction word.\n\tconst visible = percentText ?? t(DIRECTION_LABEL[delta.direction])\n\tconst ariaLabel = `${t(DIRECTION_LABEL[delta.direction])} ${percentText ?? ''} ${t(\n\t\tkeys.comparisonVsPrevious\n\t)}`\n\t\t.replace(/\\s+/g, ' ')\n\t\t.trim()\n\treturn (\n\t\t<span\n\t\t\trole=\"img\"\n\t\t\taria-label={ariaLabel}\n\t\t\tstyle={{\n\t\t\t\tdisplay: 'inline-flex',\n\t\t\t\tgap: '0.375rem',\n\t\t\t\t// Not `baseline`: the value's own flex box takes its baseline from the arrow\n\t\t\t\t// glyph rather than its text, which lifts the value off the caption's line.\n\t\t\t\talignItems: 'center',\n\t\t\t\tfontSize: '0.75rem',\n\t\t\t\tlineHeight: 1.25,\n\t\t\t}}\n\t\t>\n\t\t\t<span\n\t\t\t\tstyle={{\n\t\t\t\t\tdisplay: 'inline-flex',\n\t\t\t\t\talignItems: 'center',\n\t\t\t\t\tgap: '0.25rem',\n\t\t\t\t\tcolor: colorFor(delta.direction, metric),\n\t\t\t\t\tfontWeight: 600,\n\t\t\t\t\tlineHeight: 'inherit',\n\t\t\t\t}}\n\t\t\t>\n\t\t\t\t{delta.direction !== 'none' ? <DeltaArrow direction={delta.direction} /> : null}\n\t\t\t\t{visible}\n\t\t\t</span>\n\t\t\t<span style={{ color: 'var(--theme-elevation-400)', lineHeight: 'inherit' }}>\n\t\t\t\t{t(keys.comparisonVsPrevious)}\n\t\t\t</span>\n\t\t</span>\n\t)\n}\n"],"mappings":";;;;AAOA,MAAM,UAAU;AAChB,MAAM,QAAQ;AACd,MAAM,UAAU;;AAGhB,MAAM,kBAA0C,IAAI,IAAe,CAAC,YAAY,CAAC;AAEjF,MAAM,YAAY,WAA2B,WAA+B;CAC3E,IAAI,cAAc,QACjB,OAAO;CAER,MAAM,eAAe,WAAW,KAAA,KAAa,gBAAgB,IAAI,MAAM;CAEvE,OADkB,cAAc,SAAU,eACxB,UAAU;AAC7B;AAEA,MAAM,kBAA0D;CAC/D,IAAI,KAAK;CACT,MAAM,KAAK;CACX,MAAM,KAAK;AACZ;AAEA,MAAM,cAAc,EAAE,gBACrB,oBAAC,OAAD;CACC,eAAY;CACZ,WAAU;CACV,OAAM;CACN,QAAO;CACP,SAAQ;CACR,OAAO;EACN,YAAY;EACZ,WAAW,cAAc,SAAS,mBAAmB,KAAA;CACtD;WAEA,oBAAC,QAAD;EAAM,GAAE;EAAsB,MAAK;CAAgB,CAAA;AAC/C,CAAA;;;;;;;;AAmBN,SAAgB,gBAAgB,EAAE,SAAS,UAAU,QAAQ,QAAQ,KAA2B;CAC/F,MAAM,QAAQ,aAAa,SAAS,QAAQ;CAC5C,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,cACL,MAAM,YAAY,OACf,OACA,IAAI,KAAK,aAAa,QAAQ;EAC9B,OAAO;EACP,uBAAuB;EACvB,aAAa;CACd,CAAC,EAAE,OAAO,KAAK,IAAI,MAAM,OAAO,IAAI,GAAG;CAG1C,MAAM,UAAU,eAAe,EAAE,gBAAgB,MAAM,UAAU;CAMjE,OACC,qBAAC,QAAD;EACC,MAAK;EACL,cARgB,GAAG,EAAE,gBAAgB,MAAM,UAAU,EAAE,GAAG,eAAe,GAAG,GAAG,EAChF,KAAK,oBACN,IACE,QAAQ,QAAQ,GAAG,EACnB,KAIoB;EACpB,OAAO;GACN,SAAS;GACT,KAAK;GAGL,YAAY;GACZ,UAAU;GACV,YAAY;EACb;YAXD,CAaC,qBAAC,QAAD;GACC,OAAO;IACN,SAAS;IACT,YAAY;IACZ,KAAK;IACL,OAAO,SAAS,MAAM,WAAW,MAAM;IACvC,YAAY;IACZ,YAAY;GACb;aARD,CAUE,MAAM,cAAc,SAAS,oBAAC,YAAD,EAAY,WAAW,MAAM,UAAY,CAAA,IAAI,MAC1E,OACI;MACN,oBAAC,QAAD;GAAM,OAAO;IAAE,OAAO;IAA8B,YAAY;GAAU;aACxE,EAAE,KAAK,oBAAoB;EACvB,CAAA,CACD;;AAER"}
1
+ {"version":3,"file":"ComparisonDelta.js","names":[],"sources":["../../src/widgets/ComparisonDelta.tsx"],"sourcesContent":["import { Pill } from '@payloadcms/ui'\nimport type { MetricKey, MetricValue } from '../core/contract'\nimport { computeDelta, type DeltaDirection } from '../timeframe/comparison'\nimport { numberFormat } from '../translations/intl'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport '../ui/analytics.css'\n\n/** Metrics where a decrease is the good outcome, inverting the delta colors. */\nconst LOWER_IS_BETTER: ReadonlySet<MetricKey> = new Set<MetricKey>(['bounceRate'])\n\n/** `up` is a change for the better whichever way the number moved, `down` one for the worse. */\ntype DeltaTone = 'up' | 'down' | 'none'\n\nconst toneFor = (direction: DeltaDirection, metric?: MetricKey): DeltaTone => {\n\tif (direction === 'none') {\n\t\treturn 'none'\n\t}\n\tconst goodWhenDown = metric !== undefined && LOWER_IS_BETTER.has(metric)\n\treturn (direction === 'up') !== goodWhenDown ? 'up' : 'down'\n}\n\nconst PILL_STYLE = { up: 'success', down: 'error', none: 'light-gray' } as const satisfies Record<\n\tDeltaTone,\n\tstring\n>\n\nconst DIRECTION_LABEL: Record<DeltaDirection, TranslationKey> = {\n\tup: keys.comparisonIncrease,\n\tdown: keys.comparisonDecrease,\n\tnone: keys.comparisonNoChange,\n}\n\nconst DeltaArrow = ({ direction }: { direction: 'up' | 'down' }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={\n\t\t\tdirection === 'down'\n\t\t\t\t? 'analytics-delta__arrow analytics-delta__arrow--down'\n\t\t\t\t: 'analytics-delta__arrow'\n\t\t}\n\t\tfocusable=\"false\"\n\t\twidth=\"8\"\n\t\theight=\"8\"\n\t\tviewBox=\"0 0 8 8\"\n\t>\n\t\t<path d=\"M4 1.2 7.3 6.8H0.7Z\" fill=\"currentColor\" />\n\t</svg>\n)\n\nexport interface ComparisonDeltaProps {\n\t/** `null` on either side is no data, and draws no delta at all. */\n\tcurrent?: MetricValue\n\tprevious?: MetricValue\n\t/** Inverts good/bad coloring for metrics in {@link LOWER_IS_BETTER}. */\n\tmetric?: MetricKey\n\tlocale: string\n\tt: (key: TranslationKey, vars?: Record<string, string>) => string\n\t/**\n\t * Shows \"vs. previous period\" beside the pill. A list of deltas leaves it out on each row and\n\t * says it once; the pill's own name always carries it.\n\t */\n\tcaption?: boolean\n}\n\n/**\n * Period-over-period delta pill, tinted by whether the change is for the better. Renders\n * nothing without a comparable previous value; a zero previous value shows the direction word.\n */\nexport function ComparisonDelta({\n\tcurrent,\n\tprevious,\n\tmetric,\n\tlocale,\n\tt,\n\tcaption = true,\n}: ComparisonDeltaProps) {\n\tconst delta = computeDelta(current, previous)\n\tif (!delta) {\n\t\treturn null\n\t}\n\tconst percentText =\n\t\tdelta.percent === null\n\t\t\t? null\n\t\t\t: numberFormat(locale, {\n\t\t\t\t\tstyle: 'percent',\n\t\t\t\t\tmaximumFractionDigits: 1,\n\t\t\t\t\tsignDisplay: 'never',\n\t\t\t\t}).format(Math.abs(delta.percent) / 100)\n\t// An unchanged value is a real 0%, so it reads as one; only a zero previous value\n\t// (no percentage exists to report) falls back to the direction word.\n\tconst direction = t(DIRECTION_LABEL[delta.direction])\n\tconst visible = percentText ?? direction\n\t// An unchanged value says so in words; its 0% would only repeat them.\n\tconst ariaLabel =\n\t\tpercentText === null || delta.direction === 'none'\n\t\t\t? t(keys.comparisonDirectionLabel, { direction })\n\t\t\t: t(keys.comparisonChangeLabel, { direction, change: percentText })\n\tconst tone = toneFor(delta.direction, metric)\n\treturn (\n\t\t<span aria-label={ariaLabel} className=\"analytics-delta\" role=\"img\">\n\t\t\t<Pill\n\t\t\t\tclassName={`analytics-delta__change analytics-delta__change--${tone}`}\n\t\t\t\tpillStyle={PILL_STYLE[tone]}\n\t\t\t\tsize=\"medium\"\n\t\t\t>\n\t\t\t\t{delta.direction !== 'none' ? <DeltaArrow direction={delta.direction} /> : null}\n\t\t\t\t{visible}\n\t\t\t</Pill>\n\t\t\t{caption ? (\n\t\t\t\t<span className=\"analytics-delta__caption\">{t(keys.comparisonVsPrevious)}</span>\n\t\t\t) : null}\n\t\t</span>\n\t)\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,kBAA0C,IAAI,IAAe,CAAC,YAAY,CAAC;AAKjF,MAAM,WAAW,WAA2B,WAAkC;CAC7E,IAAI,cAAc,QACjB,OAAO;CAER,MAAM,eAAe,WAAW,KAAA,KAAa,gBAAgB,IAAI,MAAM;CACvE,OAAQ,cAAc,SAAU,eAAe,OAAO;AACvD;AAEA,MAAM,aAAa;CAAE,IAAI;CAAW,MAAM;CAAS,MAAM;AAAa;AAKtE,MAAM,kBAA0D;CAC/D,IAAI,KAAK;CACT,MAAM,KAAK;CACX,MAAM,KAAK;AACZ;AAEA,MAAM,cAAc,EAAE,gBACrB,oBAAC,OAAD;CACC,eAAY;CACZ,WACC,cAAc,SACX,wDACA;CAEJ,WAAU;CACV,OAAM;CACN,QAAO;CACP,SAAQ;WAER,oBAAC,QAAD;EAAM,GAAE;EAAsB,MAAK;CAAgB,CAAA;AAC/C,CAAA;;;;;AAsBN,SAAgB,gBAAgB,EAC/B,SACA,UACA,QACA,QACA,GACA,UAAU,QACc;CACxB,MAAM,QAAQ,aAAa,SAAS,QAAQ;CAC5C,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,cACL,MAAM,YAAY,OACf,OACA,aAAa,QAAQ;EACrB,OAAO;EACP,uBAAuB;EACvB,aAAa;CACd,CAAC,EAAE,OAAO,KAAK,IAAI,MAAM,OAAO,IAAI,GAAG;CAG1C,MAAM,YAAY,EAAE,gBAAgB,MAAM,UAAU;CACpD,MAAM,UAAU,eAAe;CAE/B,MAAM,YACL,gBAAgB,QAAQ,MAAM,cAAc,SACzC,EAAE,KAAK,0BAA0B,EAAE,UAAU,CAAC,IAC9C,EAAE,KAAK,uBAAuB;EAAE;EAAW,QAAQ;CAAY,CAAC;CACpE,MAAM,OAAO,QAAQ,MAAM,WAAW,MAAM;CAC5C,OACC,qBAAC,QAAD;EAAM,cAAY;EAAW,WAAU;EAAkB,MAAK;YAA9D,CACC,qBAAC,MAAD;GACC,WAAW,oDAAoD;GAC/D,WAAW,WAAW;GACtB,MAAK;aAHN,CAKE,MAAM,cAAc,SAAS,oBAAC,YAAD,EAAY,WAAW,MAAM,UAAY,CAAA,IAAI,MAC1E,OACI;MACL,UACA,oBAAC,QAAD;GAAM,WAAU;aAA4B,EAAE,KAAK,oBAAoB;EAAQ,CAAA,IAC5E,IACC;;AAER"}
@@ -1,23 +1,43 @@
1
1
  import { RealtimePoint } from "./readForWidgetRealtime.js";
2
-
3
2
  //#region src/widgets/RealtimeCounter.d.ts
3
+ /** @beta */
4
4
  interface RealtimeCounterProps {
5
5
  endpoint: string;
6
6
  intervalMs: number;
7
7
  metric: string;
8
8
  windowMinutes: number;
9
9
  dataSource?: string;
10
+ /** Read another scope; the endpoint refuses any caller that may not. */
11
+ scope?: string;
10
12
  initialActiveNow: number;
11
13
  initialSeries: RealtimePoint[];
12
- /** Whether the reading it mounts with hit the source's event scan cap. */
14
+ /** Whether the reading it mounts with was counted from a sample. */
13
15
  initialSampled?: boolean;
14
16
  locale: string;
15
- caption: string;
17
+ /** Reporting timezone the minute labels read in, so server and browser agree. */
18
+ timezone: string;
19
+ /** Names the sparkline for assistive tech, as the metric's own name does. */
20
+ label: string;
21
+ /**
22
+ * Words beside the number, the same for every count. Left out, the plugin's own phrase for
23
+ * `metric`, worded for the count in the admin's language.
24
+ */
25
+ caption?: string;
16
26
  pausedLabel: string;
17
27
  /** Notice for a sampled reading; without it the counter renders none. */
18
28
  sampledLabel?: string;
29
+ /** Heads the minutes column of the sparkline's data table, which only assistive tech sees. */
30
+ periodLabel?: string;
31
+ /** Let the sparkline take the height its card has to spare, as a dashboard widget's does. */
32
+ fill?: boolean;
19
33
  }
34
+ /**
35
+ * A live count that mounts with a server-rendered reading and polls it fresh. A new server
36
+ * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.
37
+ *
38
+ * @beta
39
+ */
20
40
  declare function RealtimeCounter(props: RealtimeCounterProps): import("react/jsx-runtime").JSX.Element;
21
41
  //#endregion
22
- export { RealtimeCounter };
42
+ export { RealtimeCounter, RealtimeCounterProps };
23
43
  //# sourceMappingURL=RealtimeCounter.d.ts.map
@@ -1,85 +1,104 @@
1
1
  "use client";
2
+ import { numberFormat } from "../translations/intl.js";
2
3
  import { TrendChart } from "../charts/TrendChart.js";
4
+ import { useTranslation } from "../translations/useTranslation.js";
5
+ import { formatMinutes } from "../fields/format.js";
3
6
  import { buildPollPath, toRealtimePoints } from "./realtimePoll.js";
4
- import { useEffect, useState } from "react";
7
+ import { useRealtimePoll } from "../ui/hooks/useRealtimePoll.js";
8
+ import { plural, pluralParts } from "../translations/plural.js";
9
+ import { LiveAnnouncement } from "../ui/components/LiveAnnouncement.js";
10
+ import { WidgetBody, WidgetNote, WidgetValue } from "./WidgetCard.js";
11
+ import { useMemo } from "react";
5
12
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
13
  //#region src/widgets/RealtimeCounter.tsx
14
+ /**
15
+ * Three minutes on the axis, the window's first, middle and last: a counter sits in a narrow card,
16
+ * and a 12-hour clock's labels with the zone beside the last are wide.
17
+ */
18
+ const REALTIME_TICKS = 3;
19
+ const captionSpan = (text) => text === "" ? null : /* @__PURE__ */ jsx("span", {
20
+ className: "analytics-widget__value-caption",
21
+ children: text
22
+ });
23
+ /**
24
+ * A live reading: the number, large inside its phrase wherever the language places it, then a
25
+ * sparkline of its last minutes.
26
+ */
27
+ function RealtimeReadout({ reading, paused, locale, timezone, phrase, windowMinutes, label, caption, pausedLabel, sampledLabel, periodLabel, fill = false }) {
28
+ const translation = useTranslation();
29
+ const points = toRealtimePoints(reading.series, locale, timezone);
30
+ const counted = windowMinutes === void 0 ? phrase : {
31
+ name: phrase,
32
+ vars: { duration: formatMinutes(windowMinutes, locale) }
33
+ };
34
+ const parts = caption === void 0 ? pluralParts(translation, counted, reading.activeNow) : {
35
+ before: "",
36
+ count: numberFormat(locale).format(reading.activeNow),
37
+ after: caption
38
+ };
39
+ const spoken = caption === void 0 ? plural(translation, counted, reading.activeNow) : `${parts.count} ${caption}`;
40
+ return /* @__PURE__ */ jsxs(Fragment, { children: [
41
+ /* @__PURE__ */ jsx(WidgetValue, {
42
+ before: paused ? null : captionSpan(parts.before.trim()),
43
+ value: parts.count,
44
+ children: captionSpan(paused ? pausedLabel : parts.after.trim())
45
+ }),
46
+ /* @__PURE__ */ jsx(WidgetBody, { children: /* @__PURE__ */ jsx(TrendChart, {
47
+ ariaLabel: label,
48
+ buckets: points,
49
+ fill,
50
+ maxTicks: REALTIME_TICKS,
51
+ minHeight: fill ? 100 : 120,
52
+ ...periodLabel === void 0 ? {} : { periodLabel }
53
+ }) }),
54
+ reading.sampled && sampledLabel ? /* @__PURE__ */ jsx(WidgetNote, { children: sampledLabel }) : null,
55
+ /* @__PURE__ */ jsx(LiveAnnouncement, { message: paused ? pausedLabel : spoken })
56
+ ] });
57
+ }
58
+ /**
59
+ * A live count that mounts with a server-rendered reading and polls it fresh. A new server
60
+ * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.
61
+ *
62
+ * @beta
63
+ */
7
64
  function RealtimeCounter(props) {
8
- const { endpoint, intervalMs, metric, windowMinutes, dataSource, locale, caption, pausedLabel, sampledLabel } = props;
9
- const [activeNow, setActiveNow] = useState(props.initialActiveNow);
10
- const [series, setSeries] = useState(props.initialSeries);
11
- const [sampled, setSampled] = useState(props.initialSampled === true);
12
- const [paused, setPaused] = useState(false);
13
- useEffect(() => {
14
- let cancelled = false;
15
- const path = buildPollPath(endpoint, {
65
+ const { endpoint, intervalMs, metric, windowMinutes, dataSource, scope } = props;
66
+ const { initialActiveNow, initialSeries, initialSampled } = props;
67
+ const initial = useMemo(() => ({
68
+ activeNow: initialActiveNow,
69
+ series: initialSeries,
70
+ sampled: initialSampled === true
71
+ }), [
72
+ initialActiveNow,
73
+ initialSeries,
74
+ initialSampled
75
+ ]);
76
+ const poll = useRealtimePoll({
77
+ url: buildPollPath(endpoint, {
16
78
  metric,
17
79
  windowMinutes,
18
- dataSource
19
- });
20
- const tick = async () => {
21
- try {
22
- const res = await fetch(path, { credentials: "same-origin" });
23
- if (!res.ok) {
24
- if (!cancelled) setPaused(true);
25
- return;
26
- }
27
- const data = await res.json();
28
- if (cancelled || data.status !== "ok") return;
29
- setActiveNow(data.activeNow);
30
- setSeries(data.series);
31
- setSampled(data.sampled === true);
32
- setPaused(false);
33
- } catch {
34
- if (!cancelled) setPaused(true);
35
- }
36
- };
37
- const id = setInterval(tick, intervalMs);
38
- return () => {
39
- cancelled = true;
40
- clearInterval(id);
41
- };
42
- }, [
43
- endpoint,
80
+ ...dataSource === void 0 ? {} : { dataSource },
81
+ ...scope === void 0 ? {} : { scope }
82
+ }),
44
83
  intervalMs,
45
- metric,
84
+ initial
85
+ });
86
+ return /* @__PURE__ */ jsx(RealtimeReadout, {
87
+ ...props.caption === void 0 ? {} : { caption: props.caption },
88
+ ...props.fill === void 0 ? {} : { fill: props.fill },
89
+ label: props.label,
90
+ locale: props.locale,
91
+ phrase: metric === "pageviews" ? "livePageviews" : "liveVisitors",
46
92
  windowMinutes,
47
- dataSource
48
- ]);
49
- const nf = new Intl.NumberFormat(locale);
50
- const points = toRealtimePoints(series, locale);
51
- return /* @__PURE__ */ jsxs(Fragment, { children: [
52
- /* @__PURE__ */ jsx("span", {
53
- style: {
54
- fontSize: "2rem",
55
- fontWeight: 700,
56
- lineHeight: 1.1,
57
- color: "var(--theme-elevation-800)"
58
- },
59
- children: nf.format(activeNow)
60
- }),
61
- /* @__PURE__ */ jsx("span", {
62
- style: {
63
- fontSize: "0.75rem",
64
- color: "var(--theme-elevation-400)"
65
- },
66
- children: paused ? pausedLabel : caption
67
- }),
68
- sampled && sampledLabel ? /* @__PURE__ */ jsx("span", {
69
- style: {
70
- fontSize: "0.6875rem",
71
- color: "var(--theme-elevation-400)"
72
- },
73
- children: sampledLabel
74
- }) : null,
75
- /* @__PURE__ */ jsx(TrendChart, {
76
- buckets: points,
77
- ariaLabel: caption,
78
- minHeight: 120
79
- })
80
- ] });
93
+ paused: poll.paused,
94
+ pausedLabel: props.pausedLabel,
95
+ reading: poll.reading ?? initial,
96
+ ...props.sampledLabel === void 0 ? {} : { sampledLabel: props.sampledLabel },
97
+ ...props.periodLabel === void 0 ? {} : { periodLabel: props.periodLabel },
98
+ timezone: props.timezone
99
+ });
81
100
  }
82
101
  //#endregion
83
- export { RealtimeCounter };
102
+ export { RealtimeCounter, RealtimeReadout };
84
103
 
85
104
  //# sourceMappingURL=RealtimeCounter.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"RealtimeCounter.js","names":[],"sources":["../../src/widgets/RealtimeCounter.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useState } from 'react'\nimport { TrendChart } from '../charts/TrendChart'\nimport type { RealtimePoint } from './readForWidgetRealtime'\nimport { buildPollPath, toRealtimePoints } from './realtimePoll'\n\nexport interface RealtimeCounterProps {\n\tendpoint: string\n\tintervalMs: number\n\tmetric: string\n\twindowMinutes: number\n\tdataSource?: string\n\tinitialActiveNow: number\n\tinitialSeries: RealtimePoint[]\n\t/** Whether the reading it mounts with hit the source's event scan cap. */\n\tinitialSampled?: boolean\n\tlocale: string\n\tcaption: string\n\tpausedLabel: string\n\t/** Notice for a sampled reading; without it the counter renders none. */\n\tsampledLabel?: string\n}\n\nexport function RealtimeCounter(props: RealtimeCounterProps) {\n\tconst {\n\t\tendpoint,\n\t\tintervalMs,\n\t\tmetric,\n\t\twindowMinutes,\n\t\tdataSource,\n\t\tlocale,\n\t\tcaption,\n\t\tpausedLabel,\n\t\tsampledLabel,\n\t} = props\n\tconst [activeNow, setActiveNow] = useState(props.initialActiveNow)\n\tconst [series, setSeries] = useState(props.initialSeries)\n\tconst [sampled, setSampled] = useState(props.initialSampled === true)\n\tconst [paused, setPaused] = useState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\t\tconst path = buildPollPath(endpoint, { metric, windowMinutes, dataSource })\n\t\tconst tick = async () => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(path, { credentials: 'same-origin' })\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\tif (!cancelled) setPaused(true)\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tconst data = (await res.json()) as {\n\t\t\t\t\tstatus: string\n\t\t\t\t\tactiveNow: number\n\t\t\t\t\tseries: RealtimePoint[]\n\t\t\t\t\tsampled?: boolean\n\t\t\t\t}\n\t\t\t\tif (cancelled || data.status !== 'ok') return\n\t\t\t\tsetActiveNow(data.activeNow)\n\t\t\t\tsetSeries(data.series)\n\t\t\t\tsetSampled(data.sampled === true)\n\t\t\t\tsetPaused(false)\n\t\t\t} catch {\n\t\t\t\tif (!cancelled) setPaused(true)\n\t\t\t}\n\t\t}\n\t\tconst id = setInterval(tick, intervalMs)\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t\tclearInterval(id)\n\t\t}\n\t}, [endpoint, intervalMs, metric, windowMinutes, dataSource])\n\n\tconst nf = new Intl.NumberFormat(locale)\n\tconst points = toRealtimePoints(series, locale)\n\treturn (\n\t\t<>\n\t\t\t<span\n\t\t\t\tstyle={{\n\t\t\t\t\tfontSize: '2rem',\n\t\t\t\t\tfontWeight: 700,\n\t\t\t\t\tlineHeight: 1.1,\n\t\t\t\t\tcolor: 'var(--theme-elevation-800)',\n\t\t\t\t}}\n\t\t\t>\n\t\t\t\t{nf.format(activeNow)}\n\t\t\t</span>\n\t\t\t<span style={{ fontSize: '0.75rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t{paused ? pausedLabel : caption}\n\t\t\t</span>\n\t\t\t{sampled && sampledLabel ? (\n\t\t\t\t<span style={{ fontSize: '0.6875rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t\t{sampledLabel}\n\t\t\t\t</span>\n\t\t\t) : null}\n\t\t\t<TrendChart buckets={points} ariaLabel={caption} minHeight={120} />\n\t\t</>\n\t)\n}\n"],"mappings":";;;;;;AAwBA,SAAgB,gBAAgB,OAA6B;CAC5D,MAAM,EACL,UACA,YACA,QACA,eACA,YACA,QACA,SACA,aACA,iBACG;CACJ,MAAM,CAAC,WAAW,gBAAgB,SAAS,MAAM,gBAAgB;CACjE,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM,aAAa;CACxD,MAAM,CAAC,SAAS,cAAc,SAAS,MAAM,mBAAmB,IAAI;CACpE,MAAM,CAAC,QAAQ,aAAa,SAAS,KAAK;CAE1C,gBAAgB;EACf,IAAI,YAAY;EAChB,MAAM,OAAO,cAAc,UAAU;GAAE;GAAQ;GAAe;EAAW,CAAC;EAC1E,MAAM,OAAO,YAAY;GACxB,IAAI;IACH,MAAM,MAAM,MAAM,MAAM,MAAM,EAAE,aAAa,cAAc,CAAC;IAC5D,IAAI,CAAC,IAAI,IAAI;KACZ,IAAI,CAAC,WAAW,UAAU,IAAI;KAC9B;IACD;IACA,MAAM,OAAQ,MAAM,IAAI,KAAK;IAM7B,IAAI,aAAa,KAAK,WAAW,MAAM;IACvC,aAAa,KAAK,SAAS;IAC3B,UAAU,KAAK,MAAM;IACrB,WAAW,KAAK,YAAY,IAAI;IAChC,UAAU,KAAK;GAChB,QAAQ;IACP,IAAI,CAAC,WAAW,UAAU,IAAI;GAC/B;EACD;EACA,MAAM,KAAK,YAAY,MAAM,UAAU;EACvC,aAAa;GACZ,YAAY;GACZ,cAAc,EAAE;EACjB;CACD,GAAG;EAAC;EAAU;EAAY;EAAQ;EAAe;CAAU,CAAC;CAE5D,MAAM,KAAK,IAAI,KAAK,aAAa,MAAM;CACvC,MAAM,SAAS,iBAAiB,QAAQ,MAAM;CAC9C,OACC,qBAAA,UAAA,EAAA,UAAA;EACC,oBAAC,QAAD;GACC,OAAO;IACN,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,OAAO;GACR;aAEC,GAAG,OAAO,SAAS;EACf,CAAA;EACN,oBAAC,QAAD;GAAM,OAAO;IAAE,UAAU;IAAW,OAAO;GAA6B;aACtE,SAAS,cAAc;EACnB,CAAA;EACL,WAAW,eACX,oBAAC,QAAD;GAAM,OAAO;IAAE,UAAU;IAAa,OAAO;GAA6B;aACxE;EACI,CAAA,IACH;EACJ,oBAAC,YAAD;GAAY,SAAS;GAAQ,WAAW;GAAS,WAAW;EAAM,CAAA;CACjE,EAAA,CAAA;AAEJ"}
1
+ {"version":3,"file":"RealtimeCounter.js","names":[],"sources":["../../src/widgets/RealtimeCounter.tsx"],"sourcesContent":["'use client'\n\nimport { useMemo } from 'react'\nimport { TrendChart } from '../charts/TrendChart'\nimport { formatMinutes } from '../fields/format'\nimport { numberFormat } from '../translations/intl'\nimport type { PluralName } from '../translations/keys'\nimport { type PluralPhrase, plural, pluralParts } from '../translations/plural'\nimport { useTranslation } from '../translations/useTranslation'\nimport { LiveAnnouncement } from '../ui/components/LiveAnnouncement'\nimport { useRealtimePoll } from '../ui/hooks/useRealtimePoll'\nimport type { RealtimePoint } from './readForWidgetRealtime'\nimport { buildPollPath, type RealtimeReading, toRealtimePoints } from './realtimePoll'\nimport { WidgetBody, WidgetNote, WidgetValue } from './WidgetCard'\n\n/** @beta */\nexport interface RealtimeCounterProps {\n\tendpoint: string\n\tintervalMs: number\n\tmetric: string\n\twindowMinutes: number\n\tdataSource?: string\n\t/** Read another scope; the endpoint refuses any caller that may not. */\n\tscope?: string\n\tinitialActiveNow: number\n\tinitialSeries: RealtimePoint[]\n\t/** Whether the reading it mounts with was counted from a sample. */\n\tinitialSampled?: boolean\n\tlocale: string\n\t/** Reporting timezone the minute labels read in, so server and browser agree. */\n\ttimezone: string\n\t/** Names the sparkline for assistive tech, as the metric's own name does. */\n\tlabel: string\n\t/**\n\t * Words beside the number, the same for every count. Left out, the plugin's own phrase for\n\t * `metric`, worded for the count in the admin's language.\n\t */\n\tcaption?: string\n\tpausedLabel: string\n\t/** Notice for a sampled reading; without it the counter renders none. */\n\tsampledLabel?: string\n\t/** Heads the minutes column of the sparkline's data table, which only assistive tech sees. */\n\tperiodLabel?: string\n\t/** Let the sparkline take the height its card has to spare, as a dashboard widget's does. */\n\tfill?: boolean\n}\n\nexport interface RealtimeReadoutProps {\n\treading: RealtimeReading\n\tpaused: boolean\n\tlocale: string\n\ttimezone: string\n\t/** The phrase the count is worded in, chosen per count in the admin's language. */\n\tphrase: PluralName\n\t/** The minutes the count covers, which a phrase names as its `{{duration}}`. */\n\twindowMinutes?: number\n\t/** Names the sparkline for assistive tech. */\n\tlabel: string\n\t/** A fixed caption in place of the phrase, as a host's own counter may pass. */\n\tcaption?: string\n\tpausedLabel: string\n\tsampledLabel?: string\n\tperiodLabel?: string\n\tfill?: boolean\n}\n\n/**\n * Three minutes on the axis, the window's first, middle and last: a counter sits in a narrow card,\n * and a 12-hour clock's labels with the zone beside the last are wide.\n */\nconst REALTIME_TICKS = 3\n\nconst captionSpan = (text: string) =>\n\ttext === '' ? null : <span className=\"analytics-widget__value-caption\">{text}</span>\n\n/**\n * A live reading: the number, large inside its phrase wherever the language places it, then a\n * sparkline of its last minutes.\n */\nexport function RealtimeReadout({\n\treading,\n\tpaused,\n\tlocale,\n\ttimezone,\n\tphrase,\n\twindowMinutes,\n\tlabel,\n\tcaption,\n\tpausedLabel,\n\tsampledLabel,\n\tperiodLabel,\n\tfill = false,\n}: RealtimeReadoutProps) {\n\tconst translation = useTranslation()\n\tconst points = toRealtimePoints(reading.series, locale, timezone)\n\tconst counted: PluralPhrase =\n\t\twindowMinutes === undefined\n\t\t\t? phrase\n\t\t\t: { name: phrase, vars: { duration: formatMinutes(windowMinutes, locale) } }\n\tconst parts =\n\t\tcaption === undefined\n\t\t\t? pluralParts(translation, counted, reading.activeNow)\n\t\t\t: {\n\t\t\t\t\tbefore: '',\n\t\t\t\t\tcount: numberFormat(locale).format(reading.activeNow),\n\t\t\t\t\tafter: caption,\n\t\t\t\t}\n\tconst spoken =\n\t\tcaption === undefined\n\t\t\t? plural(translation, counted, reading.activeNow)\n\t\t\t: `${parts.count} ${caption}`\n\treturn (\n\t\t<>\n\t\t\t<WidgetValue before={paused ? null : captionSpan(parts.before.trim())} value={parts.count}>\n\t\t\t\t{captionSpan(paused ? pausedLabel : parts.after.trim())}\n\t\t\t</WidgetValue>\n\t\t\t<WidgetBody>\n\t\t\t\t<TrendChart\n\t\t\t\t\tariaLabel={label}\n\t\t\t\t\tbuckets={points}\n\t\t\t\t\tfill={fill}\n\t\t\t\t\tmaxTicks={REALTIME_TICKS}\n\t\t\t\t\tminHeight={fill ? 100 : 120}\n\t\t\t\t\t{...(periodLabel === undefined ? {} : { periodLabel })}\n\t\t\t\t/>\n\t\t\t</WidgetBody>\n\t\t\t{reading.sampled && sampledLabel ? <WidgetNote>{sampledLabel}</WidgetNote> : null}\n\t\t\t<LiveAnnouncement message={paused ? pausedLabel : spoken} />\n\t\t</>\n\t)\n}\n\n/**\n * A live count that mounts with a server-rendered reading and polls it fresh. A new server\n * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.\n *\n * @beta\n */\nexport function RealtimeCounter(props: RealtimeCounterProps) {\n\tconst { endpoint, intervalMs, metric, windowMinutes, dataSource, scope } = props\n\tconst { initialActiveNow, initialSeries, initialSampled } = props\n\tconst initial = useMemo<RealtimeReading>(\n\t\t() => ({\n\t\t\tactiveNow: initialActiveNow,\n\t\t\tseries: initialSeries,\n\t\t\tsampled: initialSampled === true,\n\t\t}),\n\t\t[initialActiveNow, initialSeries, initialSampled]\n\t)\n\tconst url = buildPollPath(endpoint, {\n\t\tmetric,\n\t\twindowMinutes,\n\t\t...(dataSource === undefined ? {} : { dataSource }),\n\t\t...(scope === undefined ? {} : { scope }),\n\t})\n\tconst poll = useRealtimePoll({ url, intervalMs, initial })\n\treturn (\n\t\t<RealtimeReadout\n\t\t\t{...(props.caption === undefined ? {} : { caption: props.caption })}\n\t\t\t{...(props.fill === undefined ? {} : { fill: props.fill })}\n\t\t\tlabel={props.label}\n\t\t\tlocale={props.locale}\n\t\t\tphrase={metric === 'pageviews' ? 'livePageviews' : 'liveVisitors'}\n\t\t\twindowMinutes={windowMinutes}\n\t\t\tpaused={poll.paused}\n\t\t\tpausedLabel={props.pausedLabel}\n\t\t\treading={poll.reading ?? initial}\n\t\t\t{...(props.sampledLabel === undefined ? {} : { sampledLabel: props.sampledLabel })}\n\t\t\t{...(props.periodLabel === undefined ? {} : { periodLabel: props.periodLabel })}\n\t\t\ttimezone={props.timezone}\n\t\t/>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsEA,MAAM,iBAAiB;AAEvB,MAAM,eAAe,SACpB,SAAS,KAAK,OAAO,oBAAC,QAAD;CAAM,WAAU;WAAmC;AAAW,CAAA;;;;;AAMpF,SAAgB,gBAAgB,EAC/B,SACA,QACA,QACA,UACA,QACA,eACA,OACA,SACA,aACA,cACA,aACA,OAAO,SACiB;CACxB,MAAM,cAAc,eAAe;CACnC,MAAM,SAAS,iBAAiB,QAAQ,QAAQ,QAAQ,QAAQ;CAChE,MAAM,UACL,kBAAkB,KAAA,IACf,SACA;EAAE,MAAM;EAAQ,MAAM,EAAE,UAAU,cAAc,eAAe,MAAM,EAAE;CAAE;CAC7E,MAAM,QACL,YAAY,KAAA,IACT,YAAY,aAAa,SAAS,QAAQ,SAAS,IACnD;EACA,QAAQ;EACR,OAAO,aAAa,MAAM,EAAE,OAAO,QAAQ,SAAS;EACpD,OAAO;CACR;CACH,MAAM,SACL,YAAY,KAAA,IACT,OAAO,aAAa,SAAS,QAAQ,SAAS,IAC9C,GAAG,MAAM,MAAM,GAAG;CACtB,OACC,qBAAA,UAAA,EAAA,UAAA;EACC,oBAAC,aAAD;GAAa,QAAQ,SAAS,OAAO,YAAY,MAAM,OAAO,KAAK,CAAC;GAAG,OAAO,MAAM;aAClF,YAAY,SAAS,cAAc,MAAM,MAAM,KAAK,CAAC;EAC1C,CAAA;EACb,oBAAC,YAAD,EAAA,UACC,oBAAC,YAAD;GACC,WAAW;GACX,SAAS;GACH;GACN,UAAU;GACV,WAAW,OAAO,MAAM;GACxB,GAAK,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY;EACpD,CAAA,EACU,CAAA;EACX,QAAQ,WAAW,eAAe,oBAAC,YAAD,EAAA,UAAa,aAAyB,CAAA,IAAI;EAC7E,oBAAC,kBAAD,EAAkB,SAAS,SAAS,cAAc,OAAS,CAAA;CAC1D,EAAA,CAAA;AAEJ;;;;;;;AAQA,SAAgB,gBAAgB,OAA6B;CAC5D,MAAM,EAAE,UAAU,YAAY,QAAQ,eAAe,YAAY,UAAU;CAC3E,MAAM,EAAE,kBAAkB,eAAe,mBAAmB;CAC5D,MAAM,UAAU,eACR;EACN,WAAW;EACX,QAAQ;EACR,SAAS,mBAAmB;CAC7B,IACA;EAAC;EAAkB;EAAe;CAAc,CACjD;CAOA,MAAM,OAAO,gBAAgB;EAAE,KANnB,cAAc,UAAU;GACnC;GACA;GACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;GACjD,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACxC,CACiC;EAAG;EAAY;CAAQ,CAAC;CACzD,OACC,oBAAC,iBAAD;EACC,GAAK,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,MAAM,QAAQ;EACjE,GAAK,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;EACxD,OAAO,MAAM;EACb,QAAQ,MAAM;EACd,QAAQ,WAAW,cAAc,kBAAkB;EACpC;EACf,QAAQ,KAAK;EACb,aAAa,MAAM;EACnB,SAAS,KAAK,WAAW;EACzB,GAAK,MAAM,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,MAAM,aAAa;EAChF,GAAK,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;EAC7E,UAAU,MAAM;CAChB,CAAA;AAEH"}
@@ -0,0 +1,80 @@
1
+ import { ReactNode } from "react";
2
+ //#region src/widgets/WidgetCard.d.ts
3
+ /** @beta */
4
+ interface WidgetCardProps {
5
+ /** The widget kind's own hook, beside the shared `analytics-widget`. */
6
+ className?: string;
7
+ title: string;
8
+ /** The window the card reads, on the title's line. Left out where there is nothing to read. */
9
+ caption?: string;
10
+ /** The value row, the body and the note, in that order. */
11
+ children?: ReactNode;
12
+ /** The footer link. No `href` renders no footer, which is how "the view is off" arrives. */
13
+ link?: {
14
+ href?: string;
15
+ label: string;
16
+ };
17
+ }
18
+ /**
19
+ * Dashboard card: title and window, content, and a footer link the title describes.
20
+ * Its only hook is `useId`, which server components may call, so any widget can compose it.
21
+ *
22
+ * @beta
23
+ */
24
+ declare function WidgetCard({
25
+ className,
26
+ title,
27
+ caption,
28
+ children,
29
+ link
30
+ }: WidgetCardProps): import("react/jsx-runtime").JSX.Element;
31
+ /**
32
+ * The big number with its qualifiers (delta, caption) beside it. `before` is what a language
33
+ * words ahead of the number; `noValueLabel` is read out in place of a missing reading's dash.
34
+ *
35
+ * @beta
36
+ */
37
+ declare function WidgetValue({
38
+ value,
39
+ noValueLabel,
40
+ before,
41
+ children
42
+ }: {
43
+ value: string;
44
+ noValueLabel?: string;
45
+ before?: ReactNode;
46
+ children?: ReactNode;
47
+ }): import("react/jsx-runtime").JSX.Element;
48
+ /**
49
+ * The chart, list or table, given the height the card has left.
50
+ *
51
+ * @beta
52
+ */
53
+ declare function WidgetBody({
54
+ children
55
+ }: {
56
+ children: ReactNode;
57
+ }): import("react/jsx-runtime").JSX.Element;
58
+ /**
59
+ * A message in place of the body, centered where the body would have been.
60
+ *
61
+ * @beta
62
+ */
63
+ declare function WidgetEmpty({
64
+ children
65
+ }: {
66
+ children: ReactNode;
67
+ }): import("react/jsx-runtime").JSX.Element;
68
+ /**
69
+ * The read's caveats, one line under the body; nothing at all when there are none.
70
+ *
71
+ * @beta
72
+ */
73
+ declare function WidgetNote({
74
+ children
75
+ }: {
76
+ children: string;
77
+ }): import("react/jsx-runtime").JSX.Element | null;
78
+ //#endregion
79
+ export { WidgetBody, WidgetCard, WidgetCardProps, WidgetEmpty, WidgetNote, WidgetValue };
80
+ //# sourceMappingURL=WidgetCard.d.ts.map