@10x-media/analytics 0.1.0-beta.5 → 1.0.0-beta.11

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 (514) hide show
  1. package/CHANGELOG.md +277 -0
  2. package/README.md +15 -4
  3. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  4. package/dist/adapters/ga4/disableKey.js +21 -0
  5. package/dist/adapters/ga4/disableKey.js.map +1 -0
  6. package/dist/adapters/ga4/eventName.d.ts +15 -0
  7. package/dist/adapters/ga4/eventName.js +19 -0
  8. package/dist/adapters/ga4/eventName.js.map +1 -0
  9. package/dist/adapters/ga4/ga4.d.ts +5 -0
  10. package/dist/adapters/ga4/ga4.js +186 -58
  11. package/dist/adapters/ga4/ga4.js.map +1 -1
  12. package/dist/adapters/ga4/measurementId.js +15 -0
  13. package/dist/adapters/ga4/measurementId.js.map +1 -0
  14. package/dist/adapters/goalRead.js +126 -0
  15. package/dist/adapters/goalRead.js.map +1 -0
  16. package/dist/adapters/http/fetchJson.js +1 -1
  17. package/dist/adapters/plausible/plausible.d.ts +25 -0
  18. package/dist/adapters/plausible/plausible.js +159 -38
  19. package/dist/adapters/plausible/plausible.js.map +1 -1
  20. package/dist/adapters/posthog/posthog.d.ts +10 -1
  21. package/dist/adapters/posthog/posthog.js +130 -21
  22. package/dist/adapters/posthog/posthog.js.map +1 -1
  23. package/dist/adapters/series.js +11 -1
  24. package/dist/adapters/series.js.map +1 -1
  25. package/dist/adapters/umami/umami.d.ts +13 -1
  26. package/dist/adapters/umami/umami.js +278 -26
  27. package/dist/adapters/umami/umami.js.map +1 -1
  28. package/dist/binding/resolvePath.js +18 -2
  29. package/dist/binding/resolvePath.js.map +1 -1
  30. package/dist/capture/getTrackerConfig.d.ts +20 -0
  31. package/dist/capture/getTrackerConfig.js +31 -0
  32. package/dist/capture/getTrackerConfig.js.map +1 -0
  33. package/dist/capture/mountPath.js +14 -0
  34. package/dist/capture/mountPath.js.map +1 -0
  35. package/dist/capture/proxyEndpoint.js +127 -0
  36. package/dist/capture/proxyEndpoint.js.map +1 -0
  37. package/dist/capture/proxyRoutes.js +108 -0
  38. package/dist/capture/proxyRoutes.js.map +1 -0
  39. package/dist/capture/requestBody.js +68 -0
  40. package/dist/capture/requestBody.js.map +1 -0
  41. package/dist/capture/slots.d.ts +8 -0
  42. package/dist/capture/slots.js +54 -0
  43. package/dist/capture/slots.js.map +1 -0
  44. package/dist/capture/trackerConfig.d.ts +33 -0
  45. package/dist/capture/trackerConfig.js +95 -0
  46. package/dist/capture/trackerConfig.js.map +1 -0
  47. package/dist/capture/trackerEndpoint.js +35 -0
  48. package/dist/capture/trackerEndpoint.js.map +1 -0
  49. package/dist/charts/BarList.d.ts +16 -1
  50. package/dist/charts/BarList.js +41 -19
  51. package/dist/charts/BarList.js.map +1 -1
  52. package/dist/charts/TrendChart.d.ts +16 -3
  53. package/dist/charts/TrendChart.js +172 -106
  54. package/dist/charts/TrendChart.js.map +1 -1
  55. package/dist/charts/bars.d.ts +4 -0
  56. package/dist/charts/bars.js +3 -1
  57. package/dist/charts/bars.js.map +1 -1
  58. package/dist/charts/bucket.js +10 -1
  59. package/dist/charts/bucket.js.map +1 -1
  60. package/dist/charts/spline.js +2 -2
  61. package/dist/charts/spline.js.map +1 -1
  62. package/dist/charts/styles.js +18 -1
  63. package/dist/charts/styles.js.map +1 -1
  64. package/dist/core/cacheKey.js +26 -3
  65. package/dist/core/cacheKey.js.map +1 -1
  66. package/dist/core/capabilities.d.ts +5 -1
  67. package/dist/core/capabilities.js +11 -2
  68. package/dist/core/capabilities.js.map +1 -1
  69. package/dist/core/capture.d.ts +49 -0
  70. package/dist/core/contract.d.ts +74 -5
  71. package/dist/core/contract.js +30 -1
  72. package/dist/core/contract.js.map +1 -1
  73. package/dist/core/granularity.js +1 -1
  74. package/dist/core/options.d.ts +164 -6
  75. package/dist/core/options.js +126 -3
  76. package/dist/core/options.js.map +1 -1
  77. package/dist/core/registry.d.ts +1 -0
  78. package/dist/core/scopeList.js +32 -0
  79. package/dist/core/scopeList.js.map +1 -0
  80. package/dist/core/scopedRead.js +101 -30
  81. package/dist/core/scopedRead.js.map +1 -1
  82. package/dist/core/serverEvent.d.ts +60 -0
  83. package/dist/core/serverEvent.js +12 -0
  84. package/dist/core/serverEvent.js.map +1 -0
  85. package/dist/exports/adapters/ga4.d.ts +2 -1
  86. package/dist/exports/adapters/ga4.js +2 -1
  87. package/dist/exports/adapters/native.d.ts +3 -1
  88. package/dist/exports/adapters/native.js +2 -1
  89. package/dist/exports/client.d.ts +13 -3
  90. package/dist/exports/client.js +10 -1
  91. package/dist/exports/geo.d.ts +2 -2
  92. package/dist/exports/next.d.ts +2 -1
  93. package/dist/exports/next.js +2 -1
  94. package/dist/exports/react.d.ts +4 -0
  95. package/dist/exports/react.js +5 -0
  96. package/dist/exports/rsc.d.ts +11 -3
  97. package/dist/exports/rsc.js +7 -2
  98. package/dist/exports/tracker.d.ts +21 -0
  99. package/dist/exports/tracker.js +15 -0
  100. package/dist/exports/types.d.ts +16 -3
  101. package/dist/exports/types.js +4 -2
  102. package/dist/fields/AnalyticsPanelClient.js +2 -2
  103. package/dist/fields/AnalyticsPanelField.js +1 -1
  104. package/dist/fields/AnalyticsStatField.js +2 -2
  105. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  106. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  108. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  109. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  111. package/dist/fields/config/MetricSelectField.js +3 -3
  112. package/dist/fields/config/MetricSelectField.js.map +1 -1
  113. package/dist/fields/config/SourceSelectField.js +3 -3
  114. package/dist/fields/config/SourceSelectField.js.map +1 -1
  115. package/dist/fields/config/fetchSources.d.ts +5 -1
  116. package/dist/fields/config/fetchSources.js +7 -3
  117. package/dist/fields/config/fetchSources.js.map +1 -1
  118. package/dist/fields/config/narrow.js +2 -0
  119. package/dist/fields/config/narrow.js.map +1 -1
  120. package/dist/fields/config/sourcesState.js +19 -3
  121. package/dist/fields/config/sourcesState.js.map +1 -1
  122. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  123. package/dist/fields/config/useAnalyticsSources.js +9 -6
  124. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  125. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  126. package/dist/fields/config/useFilterCapabilities.js +52 -0
  127. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  128. package/dist/fields/readForDocument.d.ts +5 -0
  129. package/dist/fields/readForDocument.js +22 -10
  130. package/dist/fields/readForDocument.js.map +1 -1
  131. package/dist/goals/GoalSelectField.d.ts +7 -0
  132. package/dist/goals/GoalSelectField.js +77 -0
  133. package/dist/goals/GoalSelectField.js.map +1 -0
  134. package/dist/goals/collection.js +254 -0
  135. package/dist/goals/collection.js.map +1 -0
  136. package/dist/goals/currency.js +14 -0
  137. package/dist/goals/currency.js.map +1 -0
  138. package/dist/goals/fetchGoals.d.ts +18 -0
  139. package/dist/goals/fetchGoals.js +33 -0
  140. package/dist/goals/fetchGoals.js.map +1 -0
  141. package/dist/goals/goalField.d.ts +31 -0
  142. package/dist/goals/goalField.js +56 -0
  143. package/dist/goals/goalField.js.map +1 -0
  144. package/dist/goals/goalsEndpoint.d.ts +1 -0
  145. package/dist/goals/goalsEndpoint.js +58 -0
  146. package/dist/goals/goalsEndpoint.js.map +1 -0
  147. package/dist/goals/match.js +64 -0
  148. package/dist/goals/match.js.map +1 -0
  149. package/dist/goals/resolver.d.ts +8 -0
  150. package/dist/goals/resolver.js +147 -0
  151. package/dist/goals/resolver.js.map +1 -0
  152. package/dist/goals/trackGoalAction.d.ts +76 -0
  153. package/dist/goals/trackGoalAction.js +158 -0
  154. package/dist/goals/trackGoalAction.js.map +1 -0
  155. package/dist/goals/types.d.ts +33 -0
  156. package/dist/goals/types.js +7 -0
  157. package/dist/goals/types.js.map +1 -0
  158. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  159. package/dist/goals/useAnalyticsGoals.js +67 -0
  160. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  161. package/dist/index.d.ts +14 -3
  162. package/dist/index.js +174 -19
  163. package/dist/index.js.map +1 -1
  164. package/dist/native/collections/events.js +65 -1
  165. package/dist/native/collections/events.js.map +1 -1
  166. package/dist/native/collections/rollups.js +39 -3
  167. package/dist/native/collections/rollups.js.map +1 -1
  168. package/dist/native/eventScan.js +25 -0
  169. package/dist/native/eventScan.js.map +1 -0
  170. package/dist/native/geo/composeGeoResolvers.js +2 -2
  171. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  172. package/dist/native/geo/geoResolver.d.ts +9 -2
  173. package/dist/native/geo/geoResolver.js.map +1 -1
  174. package/dist/native/geo/maxmindResolver.js +3 -5
  175. package/dist/native/geo/maxmindResolver.js.map +1 -1
  176. package/dist/native/ingest/bots.d.ts +11 -0
  177. package/dist/native/ingest/bots.js +71 -0
  178. package/dist/native/ingest/bots.js.map +1 -0
  179. package/dist/native/ingest/browser.js +47 -0
  180. package/dist/native/ingest/browser.js.map +1 -0
  181. package/dist/native/ingest/clientIp.js +20 -0
  182. package/dist/native/ingest/clientIp.js.map +1 -0
  183. package/dist/native/ingest/device.js +11 -3
  184. package/dist/native/ingest/device.js.map +1 -1
  185. package/dist/native/ingest/endpoint.d.ts +1 -0
  186. package/dist/native/ingest/endpoint.js +107 -21
  187. package/dist/native/ingest/endpoint.js.map +1 -1
  188. package/dist/native/ingest/flushBatch.js +29 -38
  189. package/dist/native/ingest/flushBatch.js.map +1 -1
  190. package/dist/native/ingest/language.js +14 -0
  191. package/dist/native/ingest/language.js.map +1 -0
  192. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  193. package/dist/native/ingest/normalizeEvent.js +115 -16
  194. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  195. package/dist/native/ingest/referrer.js +48 -0
  196. package/dist/native/ingest/referrer.js.map +1 -0
  197. package/dist/native/ingest/requestHost.js +57 -0
  198. package/dist/native/ingest/requestHost.js.map +1 -0
  199. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  200. package/dist/native/ingest/resolveHostname.js +52 -0
  201. package/dist/native/ingest/resolveHostname.js.map +1 -0
  202. package/dist/native/ingest/salt.js +27 -2
  203. package/dist/native/ingest/salt.js.map +1 -1
  204. package/dist/native/ingest/serverTrack.d.ts +20 -0
  205. package/dist/native/ingest/serverTrack.js +109 -0
  206. package/dist/native/ingest/serverTrack.js.map +1 -0
  207. package/dist/native/ingest/source.d.ts +11 -0
  208. package/dist/native/ingest/source.js +264 -16
  209. package/dist/native/ingest/source.js.map +1 -1
  210. package/dist/native/ingest/utm.js +33 -0
  211. package/dist/native/ingest/utm.js.map +1 -0
  212. package/dist/native/ingest/validate.js +26 -0
  213. package/dist/native/ingest/validate.js.map +1 -0
  214. package/dist/native/nativeAdapter.d.ts +37 -1
  215. package/dist/native/nativeAdapter.js +175 -22
  216. package/dist/native/nativeAdapter.js.map +1 -1
  217. package/dist/native/query/eventAgg.js +175 -0
  218. package/dist/native/query/eventAgg.js.map +1 -0
  219. package/dist/native/retention/pruneTask.js +53 -13
  220. package/dist/native/retention/pruneTask.js.map +1 -1
  221. package/dist/native/rollupAcc.js +12 -1
  222. package/dist/native/rollupAcc.js.map +1 -1
  223. package/dist/native/rollups/bucketKey.js +15 -0
  224. package/dist/native/rollups/bucketKey.js.map +1 -0
  225. package/dist/native/rollups/bumpRollups.js +116 -0
  226. package/dist/native/rollups/bumpRollups.js.map +1 -0
  227. package/dist/native/rollups/deltas.js +86 -11
  228. package/dist/native/rollups/deltas.js.map +1 -1
  229. package/dist/native/rollups/insertManyIfNew.js +93 -0
  230. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  231. package/dist/next/captureRewrites.d.ts +42 -0
  232. package/dist/next/captureRewrites.js +57 -0
  233. package/dist/next/captureRewrites.js.map +1 -0
  234. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  235. package/dist/next/posthogProxyRewrites.js +16 -21
  236. package/dist/next/posthogProxyRewrites.js.map +1 -1
  237. package/dist/plugin/documentEndpoint.js +71 -24
  238. package/dist/plugin/documentEndpoint.js.map +1 -1
  239. package/dist/plugin/errors.d.ts +31 -0
  240. package/dist/plugin/errors.js +79 -0
  241. package/dist/plugin/errors.js.map +1 -0
  242. package/dist/plugin/goalHint.d.ts +1 -0
  243. package/dist/plugin/goalHint.js +24 -0
  244. package/dist/plugin/goalHint.js.map +1 -0
  245. package/dist/plugin/paths.js +17 -1
  246. package/dist/plugin/paths.js.map +1 -1
  247. package/dist/plugin/queryEndpoint.js +124 -0
  248. package/dist/plugin/queryEndpoint.js.map +1 -0
  249. package/dist/plugin/readContextForRequest.js +73 -0
  250. package/dist/plugin/readContextForRequest.js.map +1 -0
  251. package/dist/plugin/realtimeEndpoint.js +37 -16
  252. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  253. package/dist/plugin/refreshEndpoint.js +113 -0
  254. package/dist/plugin/refreshEndpoint.js.map +1 -0
  255. package/dist/plugin/runtime.d.ts +1 -0
  256. package/dist/plugin/runtime.js +33 -1
  257. package/dist/plugin/runtime.js.map +1 -1
  258. package/dist/plugin/scopeChange.js +22 -0
  259. package/dist/plugin/scopeChange.js.map +1 -0
  260. package/dist/plugin/scopeFieldBoot.js +22 -0
  261. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  262. package/dist/plugin/sourcesEndpoint.js +16 -41
  263. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  264. package/dist/plugin/warmTask.js +0 -0
  265. package/dist/plugin/warmTask.js.map +1 -1
  266. package/dist/providers/collection.js +89 -29
  267. package/dist/providers/collection.js.map +1 -1
  268. package/dist/providers/factory.js +11 -3
  269. package/dist/providers/factory.js.map +1 -1
  270. package/dist/providers/resolver.js.map +1 -1
  271. package/dist/query/dates.js +64 -0
  272. package/dist/query/dates.js.map +1 -0
  273. package/dist/query/errors.d.ts +14 -0
  274. package/dist/query/fetchQuery.d.ts +79 -0
  275. package/dist/query/fetchQuery.js +117 -0
  276. package/dist/query/fetchQuery.js.map +1 -0
  277. package/dist/query/parse.d.ts +22 -0
  278. package/dist/query/parse.js +168 -0
  279. package/dist/query/parse.js.map +1 -0
  280. package/dist/query/response.d.ts +39 -0
  281. package/dist/query/response.js +11 -0
  282. package/dist/query/response.js.map +1 -0
  283. package/dist/react/AnalyticsProvider.d.ts +50 -0
  284. package/dist/react/AnalyticsProvider.js +67 -0
  285. package/dist/react/AnalyticsProvider.js.map +1 -0
  286. package/dist/react/TrackerBoot.d.ts +22 -0
  287. package/dist/react/TrackerBoot.js +30 -0
  288. package/dist/react/TrackerBoot.js.map +1 -0
  289. package/dist/react/useAnalytics.d.ts +20 -0
  290. package/dist/react/useAnalytics.js +52 -0
  291. package/dist/react/useAnalytics.js.map +1 -0
  292. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  293. package/dist/rsc/AnalyticsScripts.js +41 -0
  294. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  295. package/dist/surfacing/cacheStore.d.ts +1 -0
  296. package/dist/surfacing/cacheStore.js +18 -2
  297. package/dist/surfacing/cacheStore.js.map +1 -1
  298. package/dist/surfacing/engine.d.ts +1 -0
  299. package/dist/surfacing/engine.js +47 -6
  300. package/dist/surfacing/engine.js.map +1 -1
  301. package/dist/surfacing/epoch.d.ts +1 -0
  302. package/dist/surfacing/epoch.js +72 -0
  303. package/dist/surfacing/epoch.js.map +1 -0
  304. package/dist/surfacing/queue.js +22 -6
  305. package/dist/surfacing/queue.js.map +1 -1
  306. package/dist/surfacing/rateLimiter.js +130 -0
  307. package/dist/surfacing/rateLimiter.js.map +1 -0
  308. package/dist/surfacing/retryPolicy.js +15 -0
  309. package/dist/surfacing/retryPolicy.js.map +1 -0
  310. package/dist/sync/collection.js +23 -7
  311. package/dist/sync/collection.js.map +1 -1
  312. package/dist/sync/syncTask.js +68 -33
  313. package/dist/sync/syncTask.js.map +1 -1
  314. package/dist/testing/memoryAdapter.d.ts +2 -0
  315. package/dist/testing/memoryAdapter.js +17 -1
  316. package/dist/testing/memoryAdapter.js.map +1 -1
  317. package/dist/timeframe/tz.js +17 -6
  318. package/dist/timeframe/tz.js.map +1 -1
  319. package/dist/tracker/autoCapture.d.ts +48 -0
  320. package/dist/tracker/autoCapture.js +129 -0
  321. package/dist/tracker/autoCapture.js.map +1 -0
  322. package/dist/tracker/consent.d.ts +24 -0
  323. package/dist/tracker/consent.js +48 -0
  324. package/dist/tracker/consent.js.map +1 -0
  325. package/dist/tracker/createTracker.d.ts +18 -0
  326. package/dist/tracker/createTracker.js +215 -0
  327. package/dist/tracker/createTracker.js.map +1 -0
  328. package/dist/tracker/exclusion.d.ts +28 -0
  329. package/dist/tracker/exclusion.js +50 -0
  330. package/dist/tracker/exclusion.js.map +1 -0
  331. package/dist/tracker/initTracker.d.ts +22 -0
  332. package/dist/tracker/initTracker.js +33 -0
  333. package/dist/tracker/initTracker.js.map +1 -0
  334. package/dist/tracker/loadScript.d.ts +14 -0
  335. package/dist/tracker/loadScript.js +41 -0
  336. package/dist/tracker/loadScript.js.map +1 -0
  337. package/dist/tracker/pageTracking.d.ts +17 -0
  338. package/dist/tracker/pageTracking.js +38 -0
  339. package/dist/tracker/pageTracking.js.map +1 -0
  340. package/dist/tracker/registry.d.ts +27 -0
  341. package/dist/tracker/registry.js +73 -0
  342. package/dist/tracker/registry.js.map +1 -0
  343. package/dist/tracker/sinks/ga4.d.ts +29 -0
  344. package/dist/tracker/sinks/ga4.js +30 -0
  345. package/dist/tracker/sinks/ga4.js.map +1 -0
  346. package/dist/tracker/sinks/native.d.ts +22 -0
  347. package/dist/tracker/sinks/native.js +56 -0
  348. package/dist/tracker/sinks/native.js.map +1 -0
  349. package/dist/tracker/sinks/plausible.d.ts +20 -0
  350. package/dist/tracker/sinks/plausible.js +32 -0
  351. package/dist/tracker/sinks/plausible.js.map +1 -0
  352. package/dist/tracker/sinks/posthog.d.ts +18 -0
  353. package/dist/tracker/sinks/posthog.js +30 -0
  354. package/dist/tracker/sinks/posthog.js.map +1 -0
  355. package/dist/tracker/sinks/umami.d.ts +18 -0
  356. package/dist/tracker/sinks/umami.js +23 -0
  357. package/dist/tracker/sinks/umami.js.map +1 -0
  358. package/dist/tracker/sinks/vendor.d.ts +14 -0
  359. package/dist/tracker/sinks/vendor.js +81 -0
  360. package/dist/tracker/sinks/vendor.js.map +1 -0
  361. package/dist/tracker/transport.js +28 -0
  362. package/dist/tracker/transport.js.map +1 -0
  363. package/dist/tracker/types.d.ts +91 -0
  364. package/dist/translations/ar.js +221 -0
  365. package/dist/translations/ar.js.map +1 -0
  366. package/dist/translations/de.js +145 -1
  367. package/dist/translations/de.js.map +1 -1
  368. package/dist/translations/en.js +145 -1
  369. package/dist/translations/en.js.map +1 -1
  370. package/dist/translations/es.js +221 -0
  371. package/dist/translations/es.js.map +1 -0
  372. package/dist/translations/fr.js +221 -0
  373. package/dist/translations/fr.js.map +1 -0
  374. package/dist/translations/id.js +221 -0
  375. package/dist/translations/id.js.map +1 -0
  376. package/dist/translations/index.d.ts +10 -1
  377. package/dist/translations/index.js +19 -1
  378. package/dist/translations/index.js.map +1 -1
  379. package/dist/translations/keys.d.ts +144 -0
  380. package/dist/translations/keys.js +145 -1
  381. package/dist/translations/keys.js.map +1 -1
  382. package/dist/translations/ko.js +221 -0
  383. package/dist/translations/ko.js.map +1 -0
  384. package/dist/translations/metricKeys.js +8 -2
  385. package/dist/translations/metricKeys.js.map +1 -1
  386. package/dist/translations/pt.js +221 -0
  387. package/dist/translations/pt.js.map +1 -0
  388. package/dist/translations/ru.js +221 -0
  389. package/dist/translations/ru.js.map +1 -0
  390. package/dist/translations/server.js.map +1 -1
  391. package/dist/translations/uk.js +221 -0
  392. package/dist/translations/uk.js.map +1 -0
  393. package/dist/translations/zh.js +221 -0
  394. package/dist/translations/zh.js.map +1 -0
  395. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  396. package/dist/view/AnalyticsNavLink.js +40 -0
  397. package/dist/view/AnalyticsNavLink.js.map +1 -0
  398. package/dist/view/AnalyticsView.d.ts +23 -0
  399. package/dist/view/AnalyticsView.js +45 -0
  400. package/dist/view/AnalyticsView.js.map +1 -0
  401. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  402. package/dist/view/AnalyticsViewClient.js +244 -0
  403. package/dist/view/AnalyticsViewClient.js.map +1 -0
  404. package/dist/view/authRedirect.js +32 -0
  405. package/dist/view/authRedirect.js.map +1 -0
  406. package/dist/view/conversionRate.js +18 -0
  407. package/dist/view/conversionRate.js.map +1 -0
  408. package/dist/view/dayRange.js +68 -0
  409. package/dist/view/dayRange.js.map +1 -0
  410. package/dist/view/gating.d.ts +1 -0
  411. package/dist/view/gating.js +142 -0
  412. package/dist/view/gating.js.map +1 -0
  413. package/dist/view/labels.js +76 -0
  414. package/dist/view/labels.js.map +1 -0
  415. package/dist/view/registerView.js +48 -0
  416. package/dist/view/registerView.js.map +1 -0
  417. package/dist/view/sections/Breakdowns.js +198 -0
  418. package/dist/view/sections/Breakdowns.js.map +1 -0
  419. package/dist/view/sections/EmptyStates.js +92 -0
  420. package/dist/view/sections/EmptyStates.js.map +1 -0
  421. package/dist/view/sections/FilterChips.js +46 -0
  422. package/dist/view/sections/FilterChips.js.map +1 -0
  423. package/dist/view/sections/GoalsPanel.js +82 -0
  424. package/dist/view/sections/GoalsPanel.js.map +1 -0
  425. package/dist/view/sections/OverviewCards.js +65 -0
  426. package/dist/view/sections/OverviewCards.js.map +1 -0
  427. package/dist/view/sections/RealtimeStrip.js +80 -0
  428. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  429. package/dist/view/sections/Toolbar.js +207 -0
  430. package/dist/view/sections/Toolbar.js.map +1 -0
  431. package/dist/view/sections/Trend.js +125 -0
  432. package/dist/view/sections/Trend.js.map +1 -0
  433. package/dist/view/sections/styles.js +76 -0
  434. package/dist/view/sections/styles.js.map +1 -0
  435. package/dist/view/state.js +211 -0
  436. package/dist/view/state.js.map +1 -0
  437. package/dist/view/useViewQueries.js +153 -0
  438. package/dist/view/useViewQueries.js.map +1 -0
  439. package/dist/view/viewProps.d.ts +40 -0
  440. package/dist/view/viewProps.js +90 -0
  441. package/dist/view/viewProps.js.map +1 -0
  442. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  443. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  444. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  445. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  446. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  448. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  449. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  450. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  451. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  453. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  454. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  455. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  456. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  457. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  458. package/dist/widgets/RealtimeCounter.js +18 -4
  459. package/dist/widgets/RealtimeCounter.js.map +1 -1
  460. package/dist/widgets/WidgetViewLink.js +17 -0
  461. package/dist/widgets/WidgetViewLink.js.map +1 -0
  462. package/dist/widgets/breakdownTypes.js +38 -0
  463. package/dist/widgets/breakdownTypes.js.map +1 -1
  464. package/dist/widgets/cardChrome.js +31 -7
  465. package/dist/widgets/cardChrome.js.map +1 -1
  466. package/dist/widgets/comparison.js +15 -1
  467. package/dist/widgets/comparison.js.map +1 -1
  468. package/dist/widgets/defaults.d.ts +6 -2
  469. package/dist/widgets/defaults.js +78 -23
  470. package/dist/widgets/defaults.js.map +1 -1
  471. package/dist/widgets/filterCaption.js +27 -0
  472. package/dist/widgets/filterCaption.js.map +1 -0
  473. package/dist/widgets/filterField.d.ts +19 -0
  474. package/dist/widgets/filterField.js +75 -0
  475. package/dist/widgets/filterField.js.map +1 -0
  476. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  477. package/dist/widgets/prepareWidgetRead.js +74 -0
  478. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  479. package/dist/widgets/range.js +43 -12
  480. package/dist/widgets/range.js.map +1 -1
  481. package/dist/widgets/readForWidget.d.ts +26 -3
  482. package/dist/widgets/readForWidget.js +48 -44
  483. package/dist/widgets/readForWidget.js.map +1 -1
  484. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  485. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  486. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  487. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  488. package/dist/widgets/readForWidgetGoals.js +140 -0
  489. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  490. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  491. package/dist/widgets/readForWidgetRealtime.js +23 -21
  492. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  493. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  494. package/dist/widgets/readForWidgetSeries.js +78 -53
  495. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  496. package/dist/widgets/readMeta.js +18 -0
  497. package/dist/widgets/readMeta.js.map +1 -0
  498. package/dist/widgets/realtimePoll.js +13 -1
  499. package/dist/widgets/realtimePoll.js.map +1 -1
  500. package/dist/widgets/registerWidgets.js +62 -10
  501. package/dist/widgets/registerWidgets.js.map +1 -1
  502. package/dist/widgets/types.d.ts +15 -0
  503. package/dist/widgets/types.js +16 -2
  504. package/dist/widgets/types.js.map +1 -1
  505. package/dist/widgets/viewLink.d.ts +22 -0
  506. package/dist/widgets/viewLink.js +86 -0
  507. package/dist/widgets/viewLink.js.map +1 -0
  508. package/package.json +27 -7
  509. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  510. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  511. package/dist/native/rollups/bumpRollup.js +0 -68
  512. package/dist/native/rollups/bumpRollup.js.map +0 -1
  513. package/dist/native/rollups/insertIfNew.js +0 -19
  514. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"TrendChart.js","names":[],"sources":["../../src/charts/TrendChart.tsx"],"sourcesContent":["'use client'\n\nimport { type PointerEvent, useEffect, useId, useLayoutEffect, useRef, useState } from 'react'\nimport { monotoneAreaPath } from './spline'\nimport { ChartStyles } from './styles'\n\n// useLayoutEffect measures before paint on the client; fall back to useEffect during\n// SSR to avoid React's server-render warning (the chart body is gated on `measured`).\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect\n\nexport interface TrendPoint {\n\tlabel: string\n\tvalue: number\n\tdisplay: string\n}\n\nexport interface TrendChartProps {\n\tbuckets: TrendPoint[]\n\tariaLabel: string\n\tminHeight?: number\n}\n\nconst MARGIN = { top: 8, right: 8, bottom: 18, left: 8 }\nconst MAX_TICKS = 6\nconst PAD = 2\nconst GRID = [0.25, 0.5, 0.75]\n\nconst tickIndices = (n: number): number[] => {\n\tif (n <= MAX_TICKS) {\n\t\treturn Array.from({ length: n }, (_, i) => i)\n\t}\n\tconst step = (n - 1) / (MAX_TICKS - 1)\n\treturn Array.from({ length: MAX_TICKS }, (_, i) => Math.round(i * step))\n}\n\n/**\n * Gradient area trend chart: a monotone-cubic line over a themed gradient fill, with\n * gridlines, dots (when sparse), timeframe-aware x-axis labels, and a pointer-tracked\n * tooltip. Dependency-free; sizes to its container via a ResizeObserver so dots and\n * labels stay crisp (no aspect-ratio distortion).\n */\nexport function TrendChart({ buckets, ariaLabel, minHeight = 160 }: TrendChartProps) {\n\tconst ref = useRef<HTMLDivElement>(null)\n\tconst [size, setSize] = useState({ w: 600, h: minHeight })\n\tconst [measured, setMeasured] = useState(false)\n\tconst [active, setActive] = useState<number | null>(null)\n\tconst gradientId = useId()\n\n\tuseIsomorphicLayoutEffect(() => {\n\t\tconst el = ref.current\n\t\tif (!el) {\n\t\t\treturn\n\t\t}\n\t\tconst update = () => {\n\t\t\tconst w = el.clientWidth\n\t\t\tconst h = el.clientHeight\n\t\t\tif (w > 0) {\n\t\t\t\tsetSize({ w, h: h || minHeight })\n\t\t\t\tsetMeasured(true)\n\t\t\t}\n\t\t}\n\t\tupdate()\n\t\tconst ro = new ResizeObserver(update)\n\t\tro.observe(el)\n\t\treturn () => ro.disconnect()\n\t}, [minHeight])\n\n\tconst width = size.w\n\tconst height = size.h\n\tconst values = buckets.map((b) => b.value)\n\tconst n = values.length\n\tconst plotW = Math.max(1, width - MARGIN.left - MARGIN.right)\n\tconst plotH = Math.max(1, height - MARGIN.top - MARGIN.bottom)\n\tconst { line, area } = monotoneAreaPath(values, { width: plotW, height: plotH, padding: PAD })\n\n\tconst vmax = n > 0 ? Math.max(...values) : 0\n\tconst vmin = n > 0 ? Math.min(...values) : 0\n\tconst vspan = vmax - vmin || 1\n\tconst px = (i: number): number => (n > 1 ? (i / (n - 1)) * plotW : plotW / 2)\n\tconst py = (v: number): number =>\n\t\tvmax === vmin ? plotH / 2 : PAD + (plotH - PAD * 2) - ((v - vmin) / vspan) * (plotH - PAD * 2)\n\n\tconst onMove = (e: PointerEvent<HTMLDivElement>): void => {\n\t\tif (n === 0) {\n\t\t\treturn\n\t\t}\n\t\tconst rect = e.currentTarget.getBoundingClientRect()\n\t\tconst rel = e.clientX - rect.left - MARGIN.left\n\t\tsetActive(Math.max(0, Math.min(n - 1, Math.round((rel / plotW) * (n - 1)))))\n\t}\n\n\tconst activeValue = active !== null ? (values[active] ?? 0) : 0\n\treturn (\n\t\t<div\n\t\t\tref={ref}\n\t\t\tclassName=\"analytics-chart\"\n\t\t\tstyle={{ flex: '1 1 0', minHeight }}\n\t\t\tonPointerMove={onMove}\n\t\t\tonPointerLeave={() => setActive(null)}\n\t\t>\n\t\t\t<ChartStyles />\n\t\t\t{measured ? (\n\t\t\t\t<svg\n\t\t\t\t\tclassName=\"analytics-chart__svg\"\n\t\t\t\t\twidth={width}\n\t\t\t\t\theight={height}\n\t\t\t\t\trole=\"img\"\n\t\t\t\t\taria-label={ariaLabel}\n\t\t\t\t>\n\t\t\t\t\t<defs>\n\t\t\t\t\t\t<linearGradient id={gradientId} x1=\"0\" y1=\"0\" x2=\"0\" y2=\"1\">\n\t\t\t\t\t\t\t<stop offset=\"0%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0.38\" />\n\t\t\t\t\t\t\t<stop offset=\"55%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0.1\" />\n\t\t\t\t\t\t\t<stop offset=\"100%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0\" />\n\t\t\t\t\t\t</linearGradient>\n\t\t\t\t\t</defs>\n\t\t\t\t\t<g transform={`translate(${MARGIN.left},${MARGIN.top})`}>\n\t\t\t\t\t\t{GRID.map((g) => (\n\t\t\t\t\t\t\t<line\n\t\t\t\t\t\t\t\tkey={g}\n\t\t\t\t\t\t\t\tclassName=\"analytics-chart__grid\"\n\t\t\t\t\t\t\t\tx1={0}\n\t\t\t\t\t\t\t\tx2={plotW}\n\t\t\t\t\t\t\t\ty1={g * plotH}\n\t\t\t\t\t\t\t\ty2={g * plotH}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t))}\n\t\t\t\t\t\t{area ? (\n\t\t\t\t\t\t\t<path className=\"analytics-chart__area\" d={area} fill={`url(#${gradientId})`} />\n\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t{line ? <path className=\"analytics-chart__line\" d={line} /> : null}\n\t\t\t\t\t\t{n <= 12\n\t\t\t\t\t\t\t? values.map((v, i) => (\n\t\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\t\tkey={buckets[i]?.label ?? i}\n\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__dot\"\n\t\t\t\t\t\t\t\t\t\tcx={px(i)}\n\t\t\t\t\t\t\t\t\t\tcy={py(v)}\n\t\t\t\t\t\t\t\t\t\tr={2.5}\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: null}\n\t\t\t\t\t\t{active !== null ? (\n\t\t\t\t\t\t\t<>\n\t\t\t\t\t\t\t\t<line\n\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__cursor\"\n\t\t\t\t\t\t\t\t\tx1={px(active)}\n\t\t\t\t\t\t\t\t\tx2={px(active)}\n\t\t\t\t\t\t\t\t\ty1={0}\n\t\t\t\t\t\t\t\t\ty2={plotH}\n\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__active\"\n\t\t\t\t\t\t\t\t\tcx={px(active)}\n\t\t\t\t\t\t\t\t\tcy={py(activeValue)}\n\t\t\t\t\t\t\t\t\tr={3.5}\n\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t</>\n\t\t\t\t\t\t) : null}\n\t\t\t\t\t</g>\n\t\t\t\t\t<g transform={`translate(${MARGIN.left},${height - 4})`}>\n\t\t\t\t\t\t{tickIndices(n).map((i) => (\n\t\t\t\t\t\t\t<text\n\t\t\t\t\t\t\t\tkey={buckets[i]?.label ?? i}\n\t\t\t\t\t\t\t\tclassName=\"analytics-chart__axis\"\n\t\t\t\t\t\t\t\tx={px(i)}\n\t\t\t\t\t\t\t\ttextAnchor={i === 0 ? 'start' : i === n - 1 ? 'end' : 'middle'}\n\t\t\t\t\t\t\t>\n\t\t\t\t\t\t\t\t{buckets[i]?.label}\n\t\t\t\t\t\t\t</text>\n\t\t\t\t\t\t))}\n\t\t\t\t\t</g>\n\t\t\t\t</svg>\n\t\t\t) : null}\n\t\t\t{active !== null ? (\n\t\t\t\t<div\n\t\t\t\t\tclassName=\"analytics-chart__tooltip\"\n\t\t\t\t\tstyle={{ left: MARGIN.left + px(active), top: MARGIN.top + py(activeValue) }}\n\t\t\t\t>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-label\">{buckets[active]?.label}</div>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-value\">{buckets[active]?.display}</div>\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t</div>\n\t)\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"TrendChart.js","names":[],"sources":["../../src/charts/TrendChart.tsx"],"sourcesContent":["'use client'\n\nimport { type PointerEvent, useEffect, useId, useLayoutEffect, useRef, useState } from 'react'\nimport { monotoneAreaPath } from './spline'\nimport { ChartStyles } from './styles'\n\n// useLayoutEffect measures before paint on the client; fall back to useEffect during\n// SSR to avoid React's server-render warning (the chart body is gated on `measured`).\nconst useIsomorphicLayoutEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect\n\nexport interface TrendPoint {\n\tlabel: string\n\tvalue: number\n\tdisplay: string\n}\n\nexport interface TrendChartProps {\n\tbuckets: TrendPoint[]\n\t/** Previous-period series drawn on the same axes, aligned to `buckets` by index. */\n\tcomparison?: TrendPoint[]\n\t/** Names the comparison series in the legend and the tooltip; keep it short. */\n\tcomparisonLabel?: string\n\t/** The comparison window, shown in the legend only, so the tooltip stays narrow. */\n\tcomparisonRange?: string\n\t/** Names the primary series in the legend; the legend only renders with a comparison. */\n\tlabel?: string\n\tariaLabel: string\n\tminHeight?: number\n}\n\nconst MARGIN = { top: 8, right: 8, bottom: 18, left: 8 }\nconst MAX_TICKS = 6\nconst PAD = 2\nconst GRID = [0.25, 0.5, 0.75]\nconst DOT_LIMIT = 12\n\nconst tickIndices = (n: number): number[] => {\n\tif (n <= MAX_TICKS) {\n\t\treturn Array.from({ length: n }, (_, i) => i)\n\t}\n\tconst step = (n - 1) / (MAX_TICKS - 1)\n\treturn Array.from({ length: MAX_TICKS }, (_, i) => Math.round(i * step))\n}\n\nconst EMPTY_POINT: TrendPoint = { label: '', value: 0, display: '0' }\n\n/** Both windows have equal bucket counts by construction; a stray length normalizes silently. */\nconst alignTo = (series: TrendPoint[], length: number): TrendPoint[] =>\n\tseries.length === length\n\t\t? series\n\t\t: Array.from({ length }, (_, i) => series[i] ?? { ...EMPTY_POINT })\n\n/**\n * Gradient area trend chart: a monotone-cubic line over a themed gradient fill, with\n * gridlines, dots (when sparse), timeframe-aware x-axis labels, and a pointer-tracked\n * tooltip. An optional `comparison` series overlays the previous period as a muted line\n * on a y-scale covering both. Dependency-free; sizes to its container via a\n * ResizeObserver so dots and labels stay crisp (no aspect-ratio distortion).\n */\nexport function TrendChart({\n\tbuckets,\n\tcomparison,\n\tcomparisonLabel,\n\tcomparisonRange,\n\tlabel,\n\tariaLabel,\n\tminHeight = 160,\n}: TrendChartProps) {\n\tconst ref = useRef<HTMLDivElement>(null)\n\tconst [size, setSize] = useState({ w: 600, h: minHeight })\n\tconst [measured, setMeasured] = useState(false)\n\tconst [active, setActive] = useState<number | null>(null)\n\tconst gradientId = useId()\n\n\tuseIsomorphicLayoutEffect(() => {\n\t\tconst el = ref.current\n\t\tif (!el) {\n\t\t\treturn\n\t\t}\n\t\tconst update = () => {\n\t\t\tconst w = el.clientWidth\n\t\t\tconst h = el.clientHeight\n\t\t\tif (w > 0) {\n\t\t\t\tsetSize({ w, h: h || minHeight })\n\t\t\t\tsetMeasured(true)\n\t\t\t}\n\t\t}\n\t\tupdate()\n\t\tconst ro = new ResizeObserver(update)\n\t\tro.observe(el)\n\t\treturn () => ro.disconnect()\n\t}, [minHeight])\n\n\tconst width = size.w\n\tconst height = size.h\n\tconst values = buckets.map((b) => b.value)\n\tconst n = values.length\n\tconst previous = comparison ? alignTo(comparison, n) : undefined\n\tconst previousValues = previous?.map((p) => p.value)\n\tconst plotW = Math.max(1, width - MARGIN.left - MARGIN.right)\n\tconst plotH = Math.max(1, height - MARGIN.top - MARGIN.bottom)\n\n\tconst scaled = previousValues ? [...values, ...previousValues] : values\n\tconst vmax = n > 0 ? Math.max(...scaled) : 0\n\tconst vmin = n > 0 ? Math.min(...scaled) : 0\n\tconst vspan = vmax - vmin || 1\n\tconst geometry = { width: plotW, height: plotH, padding: PAD, domain: { min: vmin, max: vmax } }\n\tconst { line, area } = monotoneAreaPath(values, geometry)\n\tconst previousLine = previousValues ? monotoneAreaPath(previousValues, geometry).line : ''\n\n\tconst px = (i: number): number => (n > 1 ? (i / (n - 1)) * plotW : plotW / 2)\n\tconst py = (v: number): number =>\n\t\tvmax === vmin ? plotH / 2 : PAD + (plotH - PAD * 2) - ((v - vmin) / vspan) * (plotH - PAD * 2)\n\n\tconst onMove = (e: PointerEvent<HTMLDivElement>): void => {\n\t\tif (n === 0) {\n\t\t\treturn\n\t\t}\n\t\tconst rect = e.currentTarget.getBoundingClientRect()\n\t\tconst rel = e.clientX - rect.left - MARGIN.left\n\t\tsetActive(Math.max(0, Math.min(n - 1, Math.round((rel / plotW) * (n - 1)))))\n\t}\n\n\tconst activeValue = active !== null ? (values[active] ?? 0) : 0\n\treturn (\n\t\t<div className=\"analytics-chart\" style={{ flex: '1 1 0', minHeight }}>\n\t\t\t<ChartStyles />\n\t\t\t{previous ? (\n\t\t\t\t<div className=\"analytics-chart__legend\">\n\t\t\t\t\t<span className=\"analytics-chart__legend-item\">\n\t\t\t\t\t\t<span className=\"analytics-chart__legend-swatch\" />\n\t\t\t\t\t\t{label}\n\t\t\t\t\t</span>\n\t\t\t\t\t<span className=\"analytics-chart__legend-item\">\n\t\t\t\t\t\t<span className=\"analytics-chart__legend-swatch analytics-chart__legend-swatch--comparison\" />\n\t\t\t\t\t\t{comparisonLabel}\n\t\t\t\t\t\t{comparisonRange ? (\n\t\t\t\t\t\t\t<span className=\"analytics-chart__legend-range\">{`· ${comparisonRange}`}</span>\n\t\t\t\t\t\t) : null}\n\t\t\t\t\t</span>\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t\t<div\n\t\t\t\tref={ref}\n\t\t\t\tclassName=\"analytics-chart__plot\"\n\t\t\t\tonPointerMove={onMove}\n\t\t\t\tonPointerLeave={() => setActive(null)}\n\t\t\t>\n\t\t\t\t{measured ? (\n\t\t\t\t\t<svg\n\t\t\t\t\t\tclassName=\"analytics-chart__svg\"\n\t\t\t\t\t\twidth={width}\n\t\t\t\t\t\theight={height}\n\t\t\t\t\t\trole=\"img\"\n\t\t\t\t\t\taria-label={ariaLabel}\n\t\t\t\t\t>\n\t\t\t\t\t\t<defs>\n\t\t\t\t\t\t\t<linearGradient id={gradientId} x1=\"0\" y1=\"0\" x2=\"0\" y2=\"1\">\n\t\t\t\t\t\t\t\t<stop offset=\"0%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0.38\" />\n\t\t\t\t\t\t\t\t<stop offset=\"55%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0.1\" />\n\t\t\t\t\t\t\t\t<stop offset=\"100%\" stopColor=\"var(--analytics-chart-1)\" stopOpacity=\"0\" />\n\t\t\t\t\t\t\t</linearGradient>\n\t\t\t\t\t\t</defs>\n\t\t\t\t\t\t<g transform={`translate(${MARGIN.left},${MARGIN.top})`}>\n\t\t\t\t\t\t\t{GRID.map((g) => (\n\t\t\t\t\t\t\t\t<line\n\t\t\t\t\t\t\t\t\tkey={g}\n\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__grid\"\n\t\t\t\t\t\t\t\t\tx1={0}\n\t\t\t\t\t\t\t\t\tx2={plotW}\n\t\t\t\t\t\t\t\t\ty1={g * plotH}\n\t\t\t\t\t\t\t\t\ty2={g * plotH}\n\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t))}\n\t\t\t\t\t\t\t{area ? (\n\t\t\t\t\t\t\t\t<path className=\"analytics-chart__area\" d={area} fill={`url(#${gradientId})`} />\n\t\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t\t{previousLine ? (\n\t\t\t\t\t\t\t\t<path className=\"analytics-chart__comparison\" d={previousLine} />\n\t\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t\t{line ? <path className=\"analytics-chart__line\" d={line} /> : null}\n\t\t\t\t\t\t\t{n <= DOT_LIMIT\n\t\t\t\t\t\t\t\t? (previousValues ?? []).map((v, i) => (\n\t\t\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\t\t\tkey={`previous-${buckets[i]?.label ?? i}`}\n\t\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__dot analytics-chart__dot--comparison\"\n\t\t\t\t\t\t\t\t\t\t\tcx={px(i)}\n\t\t\t\t\t\t\t\t\t\t\tcy={py(v)}\n\t\t\t\t\t\t\t\t\t\t\tr={2.5}\n\t\t\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t\t))\n\t\t\t\t\t\t\t\t: null}\n\t\t\t\t\t\t\t{n <= DOT_LIMIT\n\t\t\t\t\t\t\t\t? values.map((v, i) => (\n\t\t\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\t\t\tkey={buckets[i]?.label ?? i}\n\t\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__dot\"\n\t\t\t\t\t\t\t\t\t\t\tcx={px(i)}\n\t\t\t\t\t\t\t\t\t\t\tcy={py(v)}\n\t\t\t\t\t\t\t\t\t\t\tr={2.5}\n\t\t\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t\t))\n\t\t\t\t\t\t\t\t: null}\n\t\t\t\t\t\t\t{active !== null ? (\n\t\t\t\t\t\t\t\t<>\n\t\t\t\t\t\t\t\t\t<line\n\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__cursor\"\n\t\t\t\t\t\t\t\t\t\tx1={px(active)}\n\t\t\t\t\t\t\t\t\t\tx2={px(active)}\n\t\t\t\t\t\t\t\t\t\ty1={0}\n\t\t\t\t\t\t\t\t\t\ty2={plotH}\n\t\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t\t{previous ? (\n\t\t\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__active analytics-chart__active--comparison\"\n\t\t\t\t\t\t\t\t\t\t\tcx={px(active)}\n\t\t\t\t\t\t\t\t\t\t\tcy={py(previous[active]?.value ?? 0)}\n\t\t\t\t\t\t\t\t\t\t\tr={3}\n\t\t\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t\t\t\t<circle\n\t\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__active\"\n\t\t\t\t\t\t\t\t\t\tcx={px(active)}\n\t\t\t\t\t\t\t\t\t\tcy={py(activeValue)}\n\t\t\t\t\t\t\t\t\t\tr={3.5}\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) : null}\n\t\t\t\t\t\t</g>\n\t\t\t\t\t\t<g transform={`translate(${MARGIN.left},${height - 4})`}>\n\t\t\t\t\t\t\t{tickIndices(n).map((i) => (\n\t\t\t\t\t\t\t\t<text\n\t\t\t\t\t\t\t\t\tkey={buckets[i]?.label ?? i}\n\t\t\t\t\t\t\t\t\tclassName=\"analytics-chart__axis\"\n\t\t\t\t\t\t\t\t\tx={px(i)}\n\t\t\t\t\t\t\t\t\ttextAnchor={i === 0 ? 'start' : i === n - 1 ? 'end' : 'middle'}\n\t\t\t\t\t\t\t\t>\n\t\t\t\t\t\t\t\t\t{buckets[i]?.label}\n\t\t\t\t\t\t\t\t</text>\n\t\t\t\t\t\t\t))}\n\t\t\t\t\t\t</g>\n\t\t\t\t\t</svg>\n\t\t\t\t) : null}\n\t\t\t\t{active !== null ? (\n\t\t\t\t\t<div\n\t\t\t\t\t\tclassName=\"analytics-chart__tooltip\"\n\t\t\t\t\t\tstyle={{ left: MARGIN.left + px(active), top: MARGIN.top + py(activeValue) }}\n\t\t\t\t\t>\n\t\t\t\t\t\t<div className=\"analytics-chart__tooltip-label\">{buckets[active]?.label}</div>\n\t\t\t\t\t\t<div className=\"analytics-chart__tooltip-value\">{buckets[active]?.display}</div>\n\t\t\t\t\t\t{previous ? (\n\t\t\t\t\t\t\t<div className=\"analytics-chart__tooltip-comparison\">\n\t\t\t\t\t\t\t\t<span>{comparisonLabel}</span>\n\t\t\t\t\t\t\t\t<span className=\"analytics-chart__tooltip-previous\">\n\t\t\t\t\t\t\t\t\t{previous[active]?.display}\n\t\t\t\t\t\t\t\t</span>\n\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t) : null}\n\t\t\t\t\t</div>\n\t\t\t\t) : null}\n\t\t\t</div>\n\t\t</div>\n\t)\n}\n"],"mappings":"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"}
@@ -3,6 +3,10 @@ interface BarDatum {
3
3
  label: string;
4
4
  value: number;
5
5
  display?: string;
6
+ /** A second, unbarred column (the view's `visitors` beside the charted metric). */
7
+ secondary?: string;
8
+ /** `false` keeps this one row inert in a list that is otherwise selectable. */
9
+ selectable?: boolean;
6
10
  }
7
11
  //#endregion
8
12
  export { BarDatum };
@@ -10,7 +10,9 @@ const toBarRows = (data) => {
10
10
  label: d.label,
11
11
  value: d.value,
12
12
  fraction: max > 0 ? d.value / max : 0,
13
- display: d.display
13
+ display: d.display,
14
+ secondary: d.secondary,
15
+ selectable: d.selectable
14
16
  }));
15
17
  };
16
18
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"bars.js","names":[],"sources":["../../src/charts/bars.ts"],"sourcesContent":["export interface BarDatum {\n\tlabel: string\n\tvalue: number\n\tdisplay?: string\n}\n\nexport interface BarRow {\n\tlabel: string\n\tvalue: number\n\tfraction: number\n\tdisplay?: string\n}\n\n/**\n * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked\n * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide\n * by zero.\n */\nexport const toBarRows = (data: BarDatum[]): BarRow[] => {\n\tconst max = data.reduce((m, d) => Math.max(m, d.value), 0)\n\treturn data.map((d) => ({\n\t\tlabel: d.label,\n\t\tvalue: d.value,\n\t\tfraction: max > 0 ? d.value / max : 0,\n\t\tdisplay: d.display,\n\t}))\n}\n"],"mappings":";;;;;;AAkBA,MAAa,aAAa,SAA+B;CACxD,MAAM,MAAM,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;CACzD,OAAO,KAAK,KAAK,OAAO;EACvB,OAAO,EAAE;EACT,OAAO,EAAE;EACT,UAAU,MAAM,IAAI,EAAE,QAAQ,MAAM;EACpC,SAAS,EAAE;CACZ,EAAE;AACH"}
1
+ {"version":3,"file":"bars.js","names":[],"sources":["../../src/charts/bars.ts"],"sourcesContent":["export interface BarDatum {\n\tlabel: string\n\tvalue: number\n\tdisplay?: string\n\t/** A second, unbarred column (the view's `visitors` beside the charted metric). */\n\tsecondary?: string\n\t/** `false` keeps this one row inert in a list that is otherwise selectable. */\n\tselectable?: boolean\n}\n\nexport interface BarRow {\n\tlabel: string\n\tvalue: number\n\tfraction: number\n\tdisplay?: string\n\tsecondary?: string\n\tselectable?: boolean\n}\n\n/**\n * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked\n * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide\n * by zero.\n */\nexport const toBarRows = (data: BarDatum[]): BarRow[] => {\n\tconst max = data.reduce((m, d) => Math.max(m, d.value), 0)\n\treturn data.map((d) => ({\n\t\tlabel: d.label,\n\t\tvalue: d.value,\n\t\tfraction: max > 0 ? d.value / max : 0,\n\t\tdisplay: d.display,\n\t\tsecondary: d.secondary,\n\t\tselectable: d.selectable,\n\t}))\n}\n"],"mappings":";;;;;;AAwBA,MAAa,aAAa,SAA+B;CACxD,MAAM,MAAM,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;CACzD,OAAO,KAAK,KAAK,OAAO;EACvB,OAAO,EAAE;EACT,OAAO,EAAE;EACT,UAAU,MAAM,IAAI,EAAE,QAAQ,MAAM;EACpC,SAAS,EAAE;EACX,WAAW,EAAE;EACb,YAAY,EAAE;CACf,EAAE;AACH"}
@@ -65,6 +65,15 @@ const bucketSeries = (points, timeframe, tz = "UTC") => bucketByUnit(points, {
65
65
  weekday: timeframe === "last7days" || timeframe === "today",
66
66
  tz
67
67
  });
68
+ /**
69
+ * Re-date a comparison series onto the primary axis it is already index-aligned to, so both
70
+ * series bucket on identical boundaries: bucketed on its own dates, a previous window can
71
+ * split into a different number of weeks or months than the window it overlays.
72
+ */
73
+ const onPrimaryAxis = (comparison, axis) => comparison.map((point, i) => ({
74
+ date: axis[i]?.date ?? point.date,
75
+ value: point.value
76
+ }));
68
77
  const DAY = 864e5;
69
78
  const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
70
79
  /**
@@ -81,6 +90,6 @@ const bucketByRange = (points, range, tz = "UTC") => {
81
90
  });
82
91
  };
83
92
  //#endregion
84
- export { bucketByRange, bucketSeries };
93
+ export { bucketByRange, bucketSeries, onPrimaryAxis };
85
94
 
86
95
  //# sourceMappingURL=bucket.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfWeekInTz,\n} from '../timeframe/tz'\nimport type { SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport interface ChartBucket {\n\tlabel: string\n\tvalue: number\n}\n\ntype Unit = 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, Unit> = {\n\ttoday: 'day',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst bucketStart = (d: Date, unit: Unit, tz: string): Date => {\n\tif (unit === 'month') return startOfMonthInTz(d, tz)\n\tif (unit === 'week') return startOfWeekInTz(d, tz)\n\treturn startOfDayInTz(d, tz)\n}\n\ninterface BucketConfig {\n\tunit: Unit\n\t/** Label each bucket by weekday (only the fixed 7-day / today presets). */\n\tweekday: boolean\n\ttz: string\n}\n\nconst bucketByUnit = (\n\tpoints: SeriesPoint[],\n\t{ unit, weekday, tz }: BucketConfig\n): ChartBucket[] => {\n\tconst groups = new Map<string, { date: Date; value: number }>()\n\tfor (const p of points) {\n\t\tconst d = bucketStart(new Date(p.date), unit, tz)\n\t\tconst key = d.toISOString()\n\t\tconst g = groups.get(key)\n\t\tif (g) {\n\t\t\tg.value += p.value\n\t\t} else {\n\t\t\tgroups.set(key, { date: d, value: p.value })\n\t\t}\n\t}\n\tconst sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime())\n\t// The label reads each bucket's start in the reporting timezone, so a zone whose day\n\t// starts fall on the previous UTC calendar day still labels the correct local date.\n\tconst years = new Set(\n\t\tsorted.map((g) =>\n\t\t\tnew Intl.DateTimeFormat('en-US', { year: 'numeric', timeZone: tz }).format(g.date)\n\t\t)\n\t)\n\tconst multiYear = years.size > 1\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: tz }).format(d)\n\t\t}\n\t\tif (unit === 'month') {\n\t\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\t\tmonth: 'short',\n\t\t\t\tyear: multiYear ? 'numeric' : undefined,\n\t\t\t\ttimeZone: tz,\n\t\t\t}).format(d)\n\t\t}\n\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\tmonth: 'short',\n\t\t\tday: 'numeric',\n\t\t\ttimeZone: tz,\n\t\t}).format(d)\n\t}\n\treturn sorted.map((g) => ({ label: format(g.date), value: g.value }))\n}\n\n/**\n * Aggregate a daily series into display buckets sized to the timeframe (day for short\n * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and\n * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting\n * timezone the series and comparison windows are aligned to. Distinct metrics are summed\n * per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] =>\n\tbucketByUnit(points, {\n\t\tunit: UNIT_BY_TIMEFRAME[timeframe],\n\t\tweekday: timeframe === 'last7days' || timeframe === 'today',\n\t\ttz,\n\t})\n\nconst DAY = 86_400_000\n\nconst unitForSpan = (spanDays: number): Unit =>\n\tspanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n\n/**\n * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from\n * the span the way the presets do: short ranges by day, a quarter by week, longer by\n * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for\n * the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (\n\tpoints: SeriesPoint[],\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, { unit: unitForSpan(spanDays), weekday: false, tz })\n}\n"],"mappings":";;AAiBA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,eAAe,GAAS,MAAY,OAAqB;CAC9D,IAAI,SAAS,SAAS,OAAO,iBAAiB,GAAG,EAAE;CACnD,IAAI,SAAS,QAAQ,OAAO,gBAAgB,GAAG,EAAE;CACjD,OAAO,eAAe,GAAG,EAAE;AAC5B;AASA,MAAM,gBACL,QACA,EAAE,MAAM,SAAS,SACE;CACnB,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE;EAChD,MAAM,MAAM,EAAE,YAAY;EAC1B,MAAM,IAAI,OAAO,IAAI,GAAG;EACxB,IAAI,GACH,EAAE,SAAS,EAAE;OAEb,OAAO,IAAI,KAAK;GAAE,MAAM;GAAG,OAAO,EAAE;EAAM,CAAC;CAE7C;CACA,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;CAQtF,MAAM,YAAY,IALA,IACjB,OAAO,KAAK,MACX,IAAI,KAAK,eAAe,SAAS;EAAE,MAAM;EAAW,UAAU;CAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAClF,CAEqB,EAAE,OAAO;CAC/B,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAG,CAAC,EAAE,OAAO,CAAC;EAErF,IAAI,SAAS,SACZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,MAAM,YAAY,YAAY,KAAA;GAC9B,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;EAEZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,KAAK;GACL,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;CACZ;CACA,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE,IAAI;EAAG,OAAO,EAAE;CAAM,EAAE;AACrE;;;;;;;;AASA,MAAa,gBACZ,QACA,WACA,KAAA,UAEA,aAAa,QAAQ;CACpB,MAAM,kBAAkB;CACxB,SAAS,cAAc,eAAe,cAAc;CACpD;AACD,CAAC;AAEF,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;;AAQrD,MAAa,iBACZ,QACA,OACA,KAAA,UACmB;CAEnB,OAAO,aAAa,QAAQ;EAAE,MAAM,YADnB,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GACrB,CAAC;EAAG,SAAS;EAAO;CAAG,CAAC;AAChF"}
1
+ {"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfWeekInTz,\n} from '../timeframe/tz'\nimport type { SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport interface ChartBucket {\n\tlabel: string\n\tvalue: number\n}\n\ntype Unit = 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, Unit> = {\n\ttoday: 'day',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst bucketStart = (d: Date, unit: Unit, tz: string): Date => {\n\tif (unit === 'month') return startOfMonthInTz(d, tz)\n\tif (unit === 'week') return startOfWeekInTz(d, tz)\n\treturn startOfDayInTz(d, tz)\n}\n\ninterface BucketConfig {\n\tunit: Unit\n\t/** Label each bucket by weekday (only the fixed 7-day / today presets). */\n\tweekday: boolean\n\ttz: string\n}\n\nconst bucketByUnit = (\n\tpoints: SeriesPoint[],\n\t{ unit, weekday, tz }: BucketConfig\n): ChartBucket[] => {\n\tconst groups = new Map<string, { date: Date; value: number }>()\n\tfor (const p of points) {\n\t\tconst d = bucketStart(new Date(p.date), unit, tz)\n\t\tconst key = d.toISOString()\n\t\tconst g = groups.get(key)\n\t\tif (g) {\n\t\t\tg.value += p.value\n\t\t} else {\n\t\t\tgroups.set(key, { date: d, value: p.value })\n\t\t}\n\t}\n\tconst sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime())\n\t// The label reads each bucket's start in the reporting timezone, so a zone whose day\n\t// starts fall on the previous UTC calendar day still labels the correct local date.\n\tconst years = new Set(\n\t\tsorted.map((g) =>\n\t\t\tnew Intl.DateTimeFormat('en-US', { year: 'numeric', timeZone: tz }).format(g.date)\n\t\t)\n\t)\n\tconst multiYear = years.size > 1\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: tz }).format(d)\n\t\t}\n\t\tif (unit === 'month') {\n\t\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\t\tmonth: 'short',\n\t\t\t\tyear: multiYear ? 'numeric' : undefined,\n\t\t\t\ttimeZone: tz,\n\t\t\t}).format(d)\n\t\t}\n\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\tmonth: 'short',\n\t\t\tday: 'numeric',\n\t\t\ttimeZone: tz,\n\t\t}).format(d)\n\t}\n\treturn sorted.map((g) => ({ label: format(g.date), value: g.value }))\n}\n\n/**\n * Aggregate a daily series into display buckets sized to the timeframe (day for short\n * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and\n * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting\n * timezone the series and comparison windows are aligned to. Distinct metrics are summed\n * per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] =>\n\tbucketByUnit(points, {\n\t\tunit: UNIT_BY_TIMEFRAME[timeframe],\n\t\tweekday: timeframe === 'last7days' || timeframe === 'today',\n\t\ttz,\n\t})\n\n/**\n * Re-date a comparison series onto the primary axis it is already index-aligned to, so both\n * series bucket on identical boundaries: bucketed on its own dates, a previous window can\n * split into a different number of weeks or months than the window it overlays.\n */\nexport const onPrimaryAxis = (comparison: SeriesPoint[], axis: SeriesPoint[]): SeriesPoint[] =>\n\tcomparison.map((point, i) => ({ date: axis[i]?.date ?? point.date, value: point.value }))\n\nconst DAY = 86_400_000\n\nconst unitForSpan = (spanDays: number): Unit =>\n\tspanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n\n/**\n * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from\n * the span the way the presets do: short ranges by day, a quarter by week, longer by\n * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for\n * the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (\n\tpoints: SeriesPoint[],\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, { unit: unitForSpan(spanDays), weekday: false, tz })\n}\n"],"mappings":";;AAiBA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,eAAe,GAAS,MAAY,OAAqB;CAC9D,IAAI,SAAS,SAAS,OAAO,iBAAiB,GAAG,EAAE;CACnD,IAAI,SAAS,QAAQ,OAAO,gBAAgB,GAAG,EAAE;CACjD,OAAO,eAAe,GAAG,EAAE;AAC5B;AASA,MAAM,gBACL,QACA,EAAE,MAAM,SAAS,SACE;CACnB,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE;EAChD,MAAM,MAAM,EAAE,YAAY;EAC1B,MAAM,IAAI,OAAO,IAAI,GAAG;EACxB,IAAI,GACH,EAAE,SAAS,EAAE;OAEb,OAAO,IAAI,KAAK;GAAE,MAAM;GAAG,OAAO,EAAE;EAAM,CAAC;CAE7C;CACA,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;CAQtF,MAAM,YAAY,IALA,IACjB,OAAO,KAAK,MACX,IAAI,KAAK,eAAe,SAAS;EAAE,MAAM;EAAW,UAAU;CAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAClF,CAEqB,EAAE,OAAO;CAC/B,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAG,CAAC,EAAE,OAAO,CAAC;EAErF,IAAI,SAAS,SACZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,MAAM,YAAY,YAAY,KAAA;GAC9B,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;EAEZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,KAAK;GACL,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;CACZ;CACA,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE,IAAI;EAAG,OAAO,EAAE;CAAM,EAAE;AACrE;;;;;;;;AASA,MAAa,gBACZ,QACA,WACA,KAAA,UAEA,aAAa,QAAQ;CACpB,MAAM,kBAAkB;CACxB,SAAS,cAAc,eAAe,cAAc;CACpD;AACD,CAAC;;;;;;AAOF,MAAa,iBAAiB,YAA2B,SACxD,WAAW,KAAK,OAAO,OAAO;CAAE,MAAM,KAAK,IAAI,QAAQ,MAAM;CAAM,OAAO,MAAM;AAAM,EAAE;AAEzF,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;;AAQrD,MAAa,iBACZ,QACA,OACA,KAAA,UACmB;CAEnB,OAAO,aAAa,QAAQ;EAAE,MAAM,YADnB,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GACrB,CAAC;EAAG,SAAS;EAAO;CAAG,CAAC;AAChF"}
@@ -47,8 +47,8 @@ const monotoneAreaPath = (values, opts) => {
47
47
  area: ""
48
48
  };
49
49
  const innerH = height - padding * 2;
50
- const max = Math.max(...values);
51
- const min = Math.min(...values);
50
+ const max = opts.domain?.max ?? Math.max(...values);
51
+ const min = opts.domain?.min ?? Math.min(...values);
52
52
  const span = max - min || 1;
53
53
  const x = (i) => round(values.length > 1 ? i / (values.length - 1) * width : 0);
54
54
  const y = (v) => round(max === min ? height / 2 : padding + innerH - (v - min) / span * innerH);
@@ -1 +1 @@
1
- {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = Math.max(...values)\n\tconst min = Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n\t/** Explicit value domain, so two series drawn on one chart share a y-scale. */\n\tdomain?: { min: number; max: number }\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = opts.domain?.max ?? Math.max(...values)\n\tconst min = opts.domain?.min ?? Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":"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"}
@@ -5,18 +5,29 @@ const CHART_CSS = `
5
5
  :where(:root) {
6
6
  --analytics-chart-1: var(--theme-success-500, #3b82f6);
7
7
  }
8
- .analytics-chart { position: relative; width: 100%; }
8
+ .analytics-chart { display: flex; flex-direction: column; width: 100%; }
9
+ .analytics-chart__plot { position: relative; flex: 1 1 auto; min-height: 0; width: 100%; }
10
+ .analytics-chart__legend { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: center; margin-bottom: 0.35rem; font-size: 0.6875rem; color: var(--theme-elevation-500); }
11
+ .analytics-chart__legend-item { display: inline-flex; align-items: center; gap: 0.35rem; }
12
+ .analytics-chart__legend-swatch { width: 0.75rem; height: 0.125rem; border-radius: 999px; background: var(--analytics-chart-1); }
13
+ .analytics-chart__legend-swatch--comparison { background: var(--theme-elevation-500); }
14
+ .analytics-chart__legend-range { color: var(--theme-elevation-400); }
9
15
  .analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }
10
16
  .analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }
11
17
  .analytics-chart__area { stroke: none; }
12
18
  .analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }
13
19
  .analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }
20
+ .analytics-chart__comparison { fill: none; stroke: var(--theme-elevation-500); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }
21
+ .analytics-chart__dot--comparison { stroke: var(--theme-elevation-500); stroke-width: 1.5; }
14
22
  .analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }
15
23
  .analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }
16
24
  .analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }
25
+ .analytics-chart__active--comparison { fill: var(--theme-elevation-500); }
17
26
  .analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }
18
27
  .analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }
19
28
  .analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }
29
+ .analytics-chart__tooltip-comparison { display: flex; gap: 0.5rem; justify-content: space-between; margin-top: 0.2rem; color: var(--theme-elevation-500); }
30
+ .analytics-chart__tooltip-previous { font-weight: 600; font-variant-numeric: tabular-nums; }
20
31
  @keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }
21
32
  .analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }
22
33
  .analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }
@@ -25,6 +36,12 @@ const CHART_CSS = `
25
36
  .analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }
26
37
  .analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
27
38
  .analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }
39
+ .analytics-bars--soft .analytics-bars__track { background: var(--theme-elevation-100); }
40
+ .analytics-bars--soft .analytics-bars__fill { background: color-mix(in srgb, var(--analytics-chart-1) 25%, transparent); }
41
+ .analytics-bars--soft .analytics-bars__label { color: var(--theme-elevation-800); }
42
+ .analytics-bars__secondary { flex: none; font-size: 0.8125rem; font-variant-numeric: tabular-nums; color: var(--theme-elevation-500); }
43
+ .analytics-bars__row--action { appearance: none; background: none; border: 0; padding: 0; margin: 0; font: inherit; color: inherit; width: 100%; text-align: start; cursor: pointer; }
44
+ .analytics-bars__row--action:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }
28
45
  .analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }
29
46
  `;
30
47
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"styles.js","names":[],"sources":["../../src/charts/styles.tsx"],"sourcesContent":["'use client'\n\nconst CHART_CSS = `\n:where(:root) {\n\t--analytics-chart-1: var(--theme-success-500, #3b82f6);\n}\n.analytics-chart { position: relative; width: 100%; }\n.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }\n.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }\n.analytics-chart__area { stroke: none; }\n.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }\n.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }\n.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }\n.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }\n.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }\n.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }\n.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }\n@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }\n.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }\n.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }\n.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }\n.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }\n.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }\n.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n`\n\n/**\n * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so\n * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically\n * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`\n * scope so a consuming app can override them.\n */\nexport function ChartStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: CHART_CSS }} />\n}\n"],"mappings":";;;AAEA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiClB,SAAgB,cAAc;CAE7B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,EAAI,CAAA;AAChE"}
1
+ {"version":3,"file":"styles.js","names":[],"sources":["../../src/charts/styles.tsx"],"sourcesContent":["'use client'\n\nconst CHART_CSS = `\n:where(:root) {\n\t--analytics-chart-1: var(--theme-success-500, #3b82f6);\n}\n.analytics-chart { display: flex; flex-direction: column; width: 100%; }\n.analytics-chart__plot { position: relative; flex: 1 1 auto; min-height: 0; width: 100%; }\n.analytics-chart__legend { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: center; margin-bottom: 0.35rem; font-size: 0.6875rem; color: var(--theme-elevation-500); }\n.analytics-chart__legend-item { display: inline-flex; align-items: center; gap: 0.35rem; }\n.analytics-chart__legend-swatch { width: 0.75rem; height: 0.125rem; border-radius: 999px; background: var(--analytics-chart-1); }\n.analytics-chart__legend-swatch--comparison { background: var(--theme-elevation-500); }\n.analytics-chart__legend-range { color: var(--theme-elevation-400); }\n.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }\n.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }\n.analytics-chart__area { stroke: none; }\n.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }\n.analytics-chart__comparison { fill: none; stroke: var(--theme-elevation-500); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot--comparison { stroke: var(--theme-elevation-500); stroke-width: 1.5; }\n.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }\n.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }\n.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }\n.analytics-chart__active--comparison { fill: var(--theme-elevation-500); }\n.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }\n.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }\n.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }\n.analytics-chart__tooltip-comparison { display: flex; gap: 0.5rem; justify-content: space-between; margin-top: 0.2rem; color: var(--theme-elevation-500); }\n.analytics-chart__tooltip-previous { font-weight: 600; font-variant-numeric: tabular-nums; }\n@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }\n.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }\n.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }\n.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }\n.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }\n.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }\n.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-bars--soft .analytics-bars__track { background: var(--theme-elevation-100); }\n.analytics-bars--soft .analytics-bars__fill { background: color-mix(in srgb, var(--analytics-chart-1) 25%, transparent); }\n.analytics-bars--soft .analytics-bars__label { color: var(--theme-elevation-800); }\n.analytics-bars__secondary { flex: none; font-size: 0.8125rem; font-variant-numeric: tabular-nums; color: var(--theme-elevation-500); }\n.analytics-bars__row--action { appearance: none; background: none; border: 0; padding: 0; margin: 0; font: inherit; color: inherit; width: 100%; text-align: start; cursor: pointer; }\n.analytics-bars__row--action:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }\n.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n`\n\n/**\n * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so\n * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically\n * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`\n * scope so a consuming app can override them.\n */\nexport function ChartStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: CHART_CSS }} />\n}\n"],"mappings":";;;AAEA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDlB,SAAgB,cAAc;CAE7B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,EAAI,CAAA;AAChE"}
@@ -1,13 +1,35 @@
1
1
  import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
2
2
  //#region src/core/cacheKey.ts
3
3
  const stable = (xs) => xs ? [...xs].sort().join(",") : "";
4
- function buildCacheKey(provider, q) {
4
+ /**
5
+ * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every
6
+ * render within one day shares one entry. A closed window, whose end is the final instant
7
+ * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two
8
+ * windows that differ only inside their last day share an entry, and an instant-comparing
9
+ * adapter read the narrower one's answer.
10
+ */
11
+ const rangeKey = (range, tz) => {
12
+ const nextDay = addDaysInTz(range.end, 1, tz);
13
+ if (nextDay.getTime() - 1 === range.end.getTime()) return `${range.start.toISOString()}_${range.end.toISOString()}`;
14
+ return `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`;
15
+ };
16
+ /**
17
+ * The goal segment, absent for a read with no hint and for an install with no goals, which
18
+ * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which
19
+ * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.
20
+ */
21
+ const goalKey = (goalSlugs) => {
22
+ if (goalSlugs === "unresolved") return ["goals:!unresolved"];
23
+ return goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : [];
24
+ };
25
+ function buildCacheKey(provider, q, opts = {}) {
5
26
  const pathKey = q.path ?? "site";
6
27
  const tz = q.timezone ?? "UTC";
7
- const range = `${startOfDayInTz(q.dateRange.start, tz).toISOString()}_${addDaysInTz(q.dateRange.end, 1, tz).toISOString()}`;
28
+ const range = rangeKey(q.dateRange, tz);
8
29
  const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
9
30
  return [
10
31
  "analytics",
32
+ `e${opts.epoch ?? "0"}`,
11
33
  provider,
12
34
  q.hostname ?? "_",
13
35
  pathKey,
@@ -19,7 +41,8 @@ function buildCacheKey(provider, q) {
19
41
  String(q.limit ?? "_"),
20
42
  q.order ? `${q.order.metric}:${q.order.direction}` : "_",
21
43
  ...q.timezone !== void 0 && q.timezone !== "UTC" ? [q.timezone] : [],
22
- ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
44
+ ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : [],
45
+ ...goalKey(q.goalSlugs)
23
46
  ].join("|");
24
47
  }
25
48
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst range = `${startOfDayInTz(q.dateRange.start, tz).toISOString()}_${addDaysInTz(q.dateRange.end, 1, tz).toISOString()}`\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for a non-UTC timezone so default (UTC) keys keep their format.\n\t\t...(q.timezone !== undefined && q.timezone !== DEFAULT_TIMEZONE ? [q.timezone] : []),\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t].join('|')\n}\n"],"mappings":";;AAGA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;AAE3E,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,KAAK,EAAE,YAAA;CACb,MAAM,QAAQ,GAAG,eAAe,EAAE,UAAU,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,UAAU,KAAK,GAAG,EAAE,EAAE,YAAY;CACxH,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EACA;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,aAAa,KAAA,KAAa,EAAE,aAAA,QAAgC,CAAC,EAAE,QAAQ,IAAI,CAAC;EAClF,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;CAC9D,EAAE,KAAK,GAAG;AACX"}
1
+ {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\n/**\n * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every\n * render within one day shares one entry. A closed window, whose end is the final instant\n * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two\n * windows that differ only inside their last day share an entry, and an instant-comparing\n * adapter read the narrower one's answer.\n */\nconst rangeKey = (range: AnalyticsQuery['dateRange'], tz: string): string => {\n\tconst nextDay = addDaysInTz(range.end, 1, tz)\n\tif (nextDay.getTime() - 1 === range.end.getTime()) {\n\t\treturn `${range.start.toISOString()}_${range.end.toISOString()}`\n\t}\n\treturn `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`\n}\n\n/**\n * The goal segment, absent for a read with no hint and for an install with no goals, which\n * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which\n * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.\n */\nconst goalKey = (goalSlugs: AnalyticsQuery['goalSlugs']): string[] => {\n\tif (goalSlugs === 'unresolved') {\n\t\treturn ['goals:!unresolved']\n\t}\n\treturn goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : []\n}\n\nexport interface CacheKeyOptions {\n\t/** The scope's cache epoch token; bumping it retires every entry keyed on the old one. */\n\tepoch?: string\n}\n\nexport function buildCacheKey(\n\tprovider: string,\n\tq: AnalyticsQuery,\n\topts: CacheKeyOptions = {}\n): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst range = rangeKey(q.dateRange, tz)\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\t// Fixed second segment, always written, so there is one key format rather than two;\n\t\t// its position keeps an adapter id spelled like an epoch from ever colliding with one.\n\t\t`e${opts.epoch ?? '0'}`,\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for a non-UTC timezone so default (UTC) keys keep their format.\n\t\t...(q.timezone !== undefined && q.timezone !== DEFAULT_TIMEZONE ? [q.timezone] : []),\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t\t// A provider read restricts its goal rows to the hint, so two hints answer differently\n\t\t// and must never share an entry. A failed resolver keys on its own segment rather than\n\t\t// on the healthy no-hint key. Prefixed, so the segment cannot read as a scope.\n\t\t...goalKey(q.goalSlugs),\n\t].join('|')\n}\n"],"mappings":";;AAGA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;;;;;;;;AAS3E,MAAM,YAAY,OAAoC,OAAuB;CAC5E,MAAM,UAAU,YAAY,MAAM,KAAK,GAAG,EAAE;CAC5C,IAAI,QAAQ,QAAQ,IAAI,MAAM,MAAM,IAAI,QAAQ,GAC/C,OAAO,GAAG,MAAM,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI,YAAY;CAE9D,OAAO,GAAG,eAAe,MAAM,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,YAAY;AAChF;;;;;;AAOA,MAAM,WAAW,cAAqD;CACrE,IAAI,cAAc,cACjB,OAAO,CAAC,mBAAmB;CAE5B,OAAO,WAAW,SAAS,CAAC,SAAS,OAAO,SAAS,GAAG,IAAI,CAAC;AAC9D;AAOA,SAAgB,cACf,UACA,GACA,OAAwB,CAAC,GAChB;CACT,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,KAAK,EAAE,YAAA;CACb,MAAM,QAAQ,SAAS,EAAE,WAAW,EAAE;CACtC,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EAGA,IAAI,KAAK,SAAS;EAClB;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,aAAa,KAAA,KAAa,EAAE,aAAA,QAAgC,CAAC,EAAE,QAAQ,IAAI,CAAC;EAClF,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;EAI7D,GAAG,QAAQ,EAAE,SAAS;CACvB,EAAE,KAAK,GAAG;AACX"}
@@ -1,9 +1,11 @@
1
- import { DimensionKey, Granularity, MetricKey } from "./contract.js";
1
+ import { DimensionKey, FilterOperator, Granularity, MetricKey } from "./contract.js";
2
2
 
3
3
  //#region src/core/capabilities.d.ts
4
4
  interface CapabilityRequirement {
5
5
  metrics?: MetricKey[];
6
6
  dimensions?: DimensionKey[];
7
+ filters?: DimensionKey[];
8
+ filterOperators?: FilterOperator[];
7
9
  realtime?: boolean;
8
10
  perPageQuery?: boolean;
9
11
  }
@@ -11,6 +13,8 @@ interface CapabilityRequirement {
11
13
  type SerializedCapabilities = {
12
14
  metrics: MetricKey[];
13
15
  dimensions: DimensionKey[];
16
+ filters: DimensionKey[];
17
+ filterOperators: FilterOperator[];
14
18
  realtime: boolean;
15
19
  realtimeWindowMinutes?: number;
16
20
  perPageQuery: boolean;
@@ -4,19 +4,28 @@ function satisfiesCapabilities(caps, req) {
4
4
  if (req.perPageQuery && !caps.perPageQuery) return false;
5
5
  if (req.metrics?.some((m) => !caps.metrics.has(m))) return false;
6
6
  if (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false;
7
+ if (req.filters?.some((d) => !caps.filters.has(d))) return false;
8
+ if (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false;
7
9
  return true;
8
10
  }
11
+ /**
12
+ * Whether a source compares against its previous period. The engine does that read
13
+ * generically, so it is on unless an adapter opted out.
14
+ */
15
+ const comparisonOf = (caps) => caps.comparison ?? true;
9
16
  const serializeCapabilities = (caps) => ({
10
17
  metrics: [...caps.metrics],
11
18
  dimensions: [...caps.dimensions],
19
+ filters: [...caps.filters],
20
+ filterOperators: [...caps.filterOperators],
12
21
  realtime: caps.realtime,
13
22
  ...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
14
23
  perPageQuery: caps.perPageQuery,
15
- comparison: caps.comparison,
24
+ comparison: comparisonOf(caps),
16
25
  minGranularity: caps.minGranularity,
17
26
  maxLookbackDays: caps.maxLookbackDays
18
27
  });
19
28
  //#endregion
20
- export { satisfiesCapabilities, serializeCapabilities };
29
+ export { comparisonOf, satisfiesCapabilities, serializeCapabilities };
21
30
 
22
31
  //# sourceMappingURL=capabilities.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type { AnalyticsCapabilities, DimensionKey, Granularity, MetricKey } from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\treturn true\n}\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: caps.comparison,\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AASA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,OAAO;AACR;AAcA,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,KAAK;CACjB,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
1
+ {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tDimensionKey,\n\tFilterOperator,\n\tGranularity,\n\tMetricKey,\n} from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfilters?: DimensionKey[]\n\tfilterOperators?: FilterOperator[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((d) => !caps.filters.has(d))) return false\n\tif (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false\n\treturn true\n}\n\n/**\n * Whether a source compares against its previous period. The engine does that read\n * generically, so it is on unless an adapter opted out.\n */\nexport const comparisonOf = (caps: AnalyticsCapabilities): boolean => caps.comparison ?? true\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\tfilters: DimensionKey[]\n\tfilterOperators: FilterOperator[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\tfilters: [...caps.filters],\n\tfilterOperators: [...caps.filterOperators],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: comparisonOf(caps),\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AAiBA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,iBAAiB,MAAM,OAAO,CAAC,KAAK,gBAAgB,IAAI,EAAE,CAAC,GAAG,OAAO;CAC7E,OAAO;AACR;;;;;AAMA,MAAa,gBAAgB,SAAyC,KAAK,cAAc;AAgBzF,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,iBAAiB,CAAC,GAAG,KAAK,eAAe;CACzC,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,aAAa,IAAI;CAC7B,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
@@ -0,0 +1,49 @@
1
+ //#region src/core/capture.d.ts
2
+ /** One rewrite the runtime proxy endpoint answers, source pattern to vendor upstream. */
3
+ interface ProxyRoute {
4
+ source: string;
5
+ upstream: string;
6
+ }
7
+ /** Routes a Next rewrites helper and the runtime proxy endpoint both consume. */
8
+ interface ProxyDescriptor {
9
+ routes: ProxyRoute[];
10
+ forwardHeaders?: string[];
11
+ /**
12
+ * The vendor serves some paths only with a trailing slash (PostHog's capture
13
+ * endpoints). Both slash forms always match; this decides what reaches the vendor:
14
+ * true keeps the request's trailing slash on the upstream path, absent or false
15
+ * normalizes it away. Next apps proxying such a vendor through rewrites also need
16
+ * `skipTrailingSlashRedirect: true`.
17
+ */
18
+ trailingSlashes?: boolean;
19
+ }
20
+ interface SnippetScript {
21
+ src?: string;
22
+ inline?: string;
23
+ attrs?: Record<string, string>;
24
+ async?: boolean;
25
+ defer?: boolean;
26
+ type?: string;
27
+ }
28
+ interface CaptureSnippet {
29
+ scripts: SnippetScript[];
30
+ }
31
+ type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami' | 'ga4';
32
+ /**
33
+ * Pure descriptor of how a vendor's browser tracker is proxied and booted, consumed by
34
+ * a later runtime proxy endpoint, a Next rewrites helper, and a snippet renderer. Never
35
+ * carries private/secret credentials (e.g. PostHog's Query API key); only what the
36
+ * browser is allowed to see.
37
+ */
38
+ interface CaptureSupport {
39
+ proxy: ProxyDescriptor;
40
+ snippet(args: {
41
+ path: string;
42
+ }): CaptureSnippet;
43
+ client: {
44
+ kind: CaptureClientKind;
45
+ } & Record<string, string | number | boolean>;
46
+ }
47
+ //#endregion
48
+ export { CaptureClientKind, CaptureSnippet, CaptureSupport, ProxyDescriptor, ProxyRoute, SnippetScript };
49
+ //# sourceMappingURL=capture.d.ts.map
@@ -1,3 +1,6 @@
1
+ import { Goal } from "../goals/types.js";
2
+ import { CaptureSupport } from "./capture.js";
3
+ import { IngestHostnameResolver, ServerTrack } from "./serverEvent.js";
1
4
  import { Config, PayloadRequest } from "payload";
2
5
 
3
6
  //#region src/core/contract.d.ts
@@ -7,15 +10,20 @@ import { Config, PayloadRequest } from "payload";
7
10
  */
8
11
  declare const PLATFORM_SCOPE = "*";
9
12
  type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
10
- type DimensionKey = 'page' | 'referrer' | 'source' | 'medium' | 'campaign' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmContent' | 'utmTerm' | 'device' | 'browser' | 'os' | 'country' | 'region' | 'city' | 'language' | 'event';
13
+ /** Every breakdown key the contract defines; the registry request parsers validate against. */
14
+ declare const DIMENSION_KEYS: readonly ["page", "referrer", "source", "channel", "medium", "campaign", "utmSource", "utmMedium", "utmCampaign", "utmContent", "utmTerm", "device", "browser", "os", "country", "region", "city", "language", "event", "goal"];
15
+ type DimensionKey = (typeof DIMENSION_KEYS)[number];
11
16
  type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
12
17
  interface DateRange {
13
18
  start: Date;
14
19
  end: Date;
15
20
  }
21
+ /** Every filter operator the contract defines; the registry request parsers validate against. */
22
+ declare const FILTER_OPERATORS: readonly ["eq", "contains", "matches"];
23
+ type FilterOperator = (typeof FILTER_OPERATORS)[number];
16
24
  interface AnalyticsFilter {
17
25
  dimension: DimensionKey;
18
- operator: 'eq' | 'contains' | 'matches';
26
+ operator: FilterOperator;
19
27
  value: string;
20
28
  }
21
29
  interface AnalyticsQuery {
@@ -44,6 +52,16 @@ interface AnalyticsQuery {
44
52
  * others report in their own account timezone. Part of the cache key when set.
45
53
  */
46
54
  timezone?: string;
55
+ /**
56
+ * The scope's goal slugs, set by callers that ask for the `goal` dimension or the
57
+ * `conversions` metric, and possibly empty when the scope configures no goals. Provider
58
+ * adapters restrict goal rows to it, since nothing in a provider marks which of its
59
+ * events are this install's goals; the native engine ignores it and matches completions
60
+ * itself. `'unresolved'` is the sentinel for a goal resolver that failed: the read keeps
61
+ * its site numbers, reports `goalsUnresolved`, and never shares a healthy cache key.
62
+ * Part of the surfacing cache key when set.
63
+ */
64
+ goalSlugs?: string[] | 'unresolved';
47
65
  }
48
66
  interface AnalyticsRow {
49
67
  dimensions?: Partial<Record<DimensionKey, string>>;
@@ -57,25 +75,55 @@ interface AnalyticsResult {
57
75
  provider: string;
58
76
  sampled?: boolean;
59
77
  clamped?: boolean;
60
- fetchedAt: string;
78
+ fetchedAt: string; /** Served from an expired cache entry because the live refresh failed. */
79
+ stale?: boolean;
80
+ /**
81
+ * Filters the source could not carry, so the rows are wider than the query asked for.
82
+ * A provider whose API takes one value per dimension reports the ones it dropped here.
83
+ */
84
+ unappliedFilters?: AnalyticsFilter[];
85
+ /**
86
+ * The read's goal numbers are absent because resolving them failed: it ran without
87
+ * `AnalyticsQuery.goalSlugs`, or with `'unresolved'`, or the provider rejected the goal
88
+ * request and the rest of the read was served without it. A scope that configured no
89
+ * goals is an empty result instead, not this flag.
90
+ */
91
+ goalsUnresolved?: true;
61
92
  };
62
93
  }
94
+ /**
95
+ * A read carrying conversions costs a provider up to twice the requests: the goal numbers
96
+ * come from a second, goal-filtered request the adapter issues after the plain one.
97
+ */
63
98
  interface RateLimitDescriptor {
64
99
  requestsPerMinute?: number;
65
100
  requestsPerHour?: number;
66
101
  maxConcurrent?: number;
102
+ /**
103
+ * Describes the provider's quota model for documentation; the limiter always
104
+ * throttles by request count regardless of this value.
105
+ */
67
106
  quotaModel?: 'requests' | 'tokens';
107
+ /** Documents whether reads consume the provider's write/ingest quota too. */
68
108
  readsCountAsUsage?: boolean;
69
109
  }
70
110
  interface AnalyticsCapabilities {
71
111
  perPageQuery: boolean;
72
112
  realtime: boolean;
73
113
  realtimeWindowMinutes?: number;
74
- comparison: boolean;
114
+ /**
115
+ * Period-over-period comparison, which the engine serves for every source by reading the
116
+ * previous window itself. Adapters omit this; set it false only to opt a source out.
117
+ */
118
+ comparison?: boolean;
75
119
  minGranularity: Granularity;
76
120
  maxLookbackDays: number | null;
77
121
  metrics: ReadonlySet<MetricKey>;
78
122
  dimensions: ReadonlySet<DimensionKey>;
123
+ /** Dimensions the adapter can apply AnalyticsQuery.filters on; empty = filters unsupported. */
124
+ filters: ReadonlySet<DimensionKey>;
125
+ /** Operators the adapter honors in filters; adapters ignore filters whose operator they lack. */
126
+ filterOperators: ReadonlySet<FilterOperator>;
79
127
  batchPageReport: boolean;
80
128
  rateLimit: RateLimitDescriptor | null;
81
129
  recommendedTtl: {
@@ -104,11 +152,32 @@ interface AdapterRegisterContext {
104
152
  * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.
105
153
  */
106
154
  resolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>;
155
+ /**
156
+ * The install's goals for a request's scope, for adapters that match completions
157
+ * themselves (the native engine, at ingest). Config goals, with the goals collection
158
+ * merged over them per scope once the install enables it.
159
+ */
160
+ resolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>;
161
+ /** The plugin's `trustedProxyHops`, for adapters that read a request's client address. */
162
+ trustedProxyHops?: number;
107
163
  }
108
164
  interface AnalyticsAdapter {
109
165
  readonly id: string;
110
166
  readonly label: string;
111
167
  readonly capabilities: AnalyticsCapabilities;
168
+ /** Browser-tracker proxying/boot descriptor. Absent when no public capture field is set. */
169
+ readonly capture?: CaptureSupport;
170
+ /**
171
+ * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the
172
+ * adapters that register one (the native engine), and how server code reaches the same
173
+ * pipeline without an HTTP round trip. Server-side only: the tracker learns the path
174
+ * from `TrackerConfig.ingestPath`, and this object is never serialized.
175
+ */
176
+ readonly ingest?: {
177
+ path: string;
178
+ track?: ServerTrack;
179
+ hostname?: IngestHostnameResolver;
180
+ };
112
181
  isConfigured(): boolean;
113
182
  query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
114
183
  realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
@@ -116,5 +185,5 @@ interface AnalyticsAdapter {
116
185
  }
117
186
  type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
118
187
  //#endregion
119
- export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
188
+ export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
120
189
  //# sourceMappingURL=contract.d.ts.map