@10x-media/analytics 1.0.0-beta.6 → 1.0.0-beta.8
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.
- package/CHANGELOG.md +73 -0
- package/README.md +13 -3
- package/dist/adapters/ga4/ga4.js +3 -2
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/http/fetchJson.js +1 -1
- package/dist/adapters/plausible/plausible.d.ts +10 -0
- package/dist/adapters/plausible/plausible.js +42 -1
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.d.ts +10 -1
- package/dist/adapters/posthog/posthog.js +47 -0
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/umami/umami.d.ts +5 -1
- package/dist/adapters/umami/umami.js +26 -0
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/capture/getTrackerConfig.d.ts +20 -0
- package/dist/capture/getTrackerConfig.js +31 -0
- package/dist/capture/getTrackerConfig.js.map +1 -0
- package/dist/capture/mountPath.js +14 -0
- package/dist/capture/mountPath.js.map +1 -0
- package/dist/capture/proxyEndpoint.js +123 -0
- package/dist/capture/proxyEndpoint.js.map +1 -0
- package/dist/capture/proxyRoutes.js +108 -0
- package/dist/capture/proxyRoutes.js.map +1 -0
- package/dist/capture/requestBody.js +68 -0
- package/dist/capture/requestBody.js.map +1 -0
- package/dist/capture/slots.d.ts +8 -0
- package/dist/capture/slots.js +54 -0
- package/dist/capture/slots.js.map +1 -0
- package/dist/capture/trackerConfig.d.ts +33 -0
- package/dist/capture/trackerConfig.js +95 -0
- package/dist/capture/trackerConfig.js.map +1 -0
- package/dist/capture/trackerEndpoint.js +35 -0
- package/dist/capture/trackerEndpoint.js.map +1 -0
- package/dist/charts/BarList.d.ts +15 -1
- package/dist/charts/BarList.js +34 -18
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +16 -3
- package/dist/charts/TrendChart.js +172 -106
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +2 -0
- package/dist/charts/bars.js +2 -1
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +10 -1
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/spline.js +2 -2
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/styles.js +18 -1
- package/dist/charts/styles.js.map +1 -1
- package/dist/core/cacheKey.js +13 -1
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/capture.d.ts +49 -0
- package/dist/core/contract.d.ts +35 -4
- package/dist/core/contract.js +29 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +148 -4
- package/dist/core/options.js +121 -3
- package/dist/core/options.js.map +1 -1
- package/dist/core/registry.d.ts +1 -0
- package/dist/core/scopeList.js +32 -0
- package/dist/core/scopeList.js.map +1 -0
- package/dist/core/scopedRead.js +45 -28
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +42 -0
- package/dist/core/serverEvent.js +12 -0
- package/dist/core/serverEvent.js.map +1 -0
- package/dist/exports/client.d.ts +8 -2
- package/dist/exports/client.js +6 -1
- package/dist/exports/next.d.ts +2 -1
- package/dist/exports/next.js +2 -1
- package/dist/exports/react.d.ts +4 -0
- package/dist/exports/react.js +5 -0
- package/dist/exports/rsc.d.ts +8 -1
- package/dist/exports/rsc.js +7 -2
- package/dist/exports/tracker.d.ts +18 -0
- package/dist/exports/tracker.js +12 -0
- package/dist/exports/types.d.ts +14 -3
- package/dist/exports/types.js +2 -2
- package/dist/fields/AnalyticsPanelClient.js +2 -2
- package/dist/fields/AnalyticsPanelField.js +1 -1
- package/dist/fields/AnalyticsStatField.js +2 -2
- package/dist/fields/config/MetricSelectField.js +2 -2
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/SourceSelectField.js +2 -2
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +5 -1
- package/dist/fields/config/narrow.js +2 -0
- package/dist/fields/config/narrow.js.map +1 -1
- package/dist/fields/readForDocument.d.ts +5 -0
- package/dist/fields/readForDocument.js +6 -6
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/goals/GoalSelectField.d.ts +7 -0
- package/dist/goals/GoalSelectField.js +77 -0
- package/dist/goals/GoalSelectField.js.map +1 -0
- package/dist/goals/collection.js +250 -0
- package/dist/goals/collection.js.map +1 -0
- package/dist/goals/currency.js +14 -0
- package/dist/goals/currency.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +18 -0
- package/dist/goals/fetchGoals.js +29 -0
- package/dist/goals/fetchGoals.js.map +1 -0
- package/dist/goals/goalField.d.ts +31 -0
- package/dist/goals/goalField.js +56 -0
- package/dist/goals/goalField.js.map +1 -0
- package/dist/goals/goalsEndpoint.d.ts +1 -0
- package/dist/goals/goalsEndpoint.js +55 -0
- package/dist/goals/goalsEndpoint.js.map +1 -0
- package/dist/goals/match.js +64 -0
- package/dist/goals/match.js.map +1 -0
- package/dist/goals/resolver.d.ts +8 -0
- package/dist/goals/resolver.js +147 -0
- package/dist/goals/resolver.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +74 -0
- package/dist/goals/trackGoalAction.js +139 -0
- package/dist/goals/trackGoalAction.js.map +1 -0
- package/dist/goals/types.d.ts +33 -0
- package/dist/goals/types.js +7 -0
- package/dist/goals/types.js.map +1 -0
- package/dist/goals/useAnalyticsGoals.d.ts +20 -0
- package/dist/goals/useAnalyticsGoals.js +67 -0
- package/dist/goals/useAnalyticsGoals.js.map +1 -0
- package/dist/index.d.ts +11 -3
- package/dist/index.js +104 -17
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +21 -1
- package/dist/native/collections/events.js.map +1 -1
- package/dist/native/collections/rollups.js +24 -0
- package/dist/native/collections/rollups.js.map +1 -1
- package/dist/native/geo/maxmindResolver.js +2 -4
- package/dist/native/geo/maxmindResolver.js.map +1 -1
- package/dist/native/ingest/clientIp.js +15 -0
- package/dist/native/ingest/clientIp.js.map +1 -0
- package/dist/native/ingest/device.js +11 -3
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -0
- package/dist/native/ingest/endpoint.js +25 -4
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/flushBatch.js +4 -13
- package/dist/native/ingest/flushBatch.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +20 -0
- package/dist/native/ingest/normalizeEvent.js +78 -10
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +99 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/validate.js +27 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +1 -1
- package/dist/native/nativeAdapter.js +38 -11
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/query/eventAgg.js +39 -13
- package/dist/native/query/eventAgg.js.map +1 -1
- package/dist/native/retention/pruneTask.js +1 -1
- package/dist/native/rollupAcc.js +12 -1
- package/dist/native/rollupAcc.js.map +1 -1
- package/dist/native/rollups/bumpRollup.js +5 -1
- package/dist/native/rollups/bumpRollup.js.map +1 -1
- package/dist/native/rollups/deltas.js +28 -6
- package/dist/native/rollups/deltas.js.map +1 -1
- package/dist/native/rollups/insertIfNew.js +36 -2
- package/dist/native/rollups/insertIfNew.js.map +1 -1
- package/dist/next/captureRewrites.d.ts +41 -0
- package/dist/next/captureRewrites.js +56 -0
- package/dist/next/captureRewrites.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +5 -0
- package/dist/next/posthogProxyRewrites.js +16 -21
- package/dist/next/posthogProxyRewrites.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +28 -10
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/paths.js +15 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +113 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +71 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +6 -3
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/runtime.d.ts +1 -0
- package/dist/plugin/runtime.js +31 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +13 -39
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/collection.js +71 -25
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/factory.js +8 -2
- package/dist/providers/factory.js.map +1 -1
- package/dist/providers/resolver.js.map +1 -1
- package/dist/query/dates.js +64 -0
- package/dist/query/dates.js.map +1 -0
- package/dist/query/errors.d.ts +17 -0
- package/dist/query/errors.js +10 -0
- package/dist/query/errors.js.map +1 -0
- package/dist/query/fetchQuery.d.ts +59 -0
- package/dist/query/fetchQuery.js +110 -0
- package/dist/query/fetchQuery.js.map +1 -0
- package/dist/query/parse.d.ts +22 -0
- package/dist/query/parse.js +168 -0
- package/dist/query/parse.js.map +1 -0
- package/dist/query/response.d.ts +36 -0
- package/dist/react/AnalyticsProvider.d.ts +43 -0
- package/dist/react/AnalyticsProvider.js +66 -0
- package/dist/react/AnalyticsProvider.js.map +1 -0
- package/dist/react/TrackerBoot.d.ts +22 -0
- package/dist/react/TrackerBoot.js +30 -0
- package/dist/react/TrackerBoot.js.map +1 -0
- package/dist/react/useAnalytics.d.ts +17 -0
- package/dist/react/useAnalytics.js +36 -0
- package/dist/react/useAnalytics.js.map +1 -0
- package/dist/rsc/AnalyticsScripts.d.ts +30 -0
- package/dist/rsc/AnalyticsScripts.js +41 -0
- package/dist/rsc/AnalyticsScripts.js.map +1 -0
- package/dist/surfacing/cacheStore.d.ts +1 -0
- package/dist/surfacing/cacheStore.js +18 -2
- package/dist/surfacing/cacheStore.js.map +1 -1
- package/dist/surfacing/engine.d.ts +1 -0
- package/dist/surfacing/engine.js +44 -4
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/surfacing/queue.js +22 -6
- package/dist/surfacing/queue.js.map +1 -1
- package/dist/surfacing/rateLimiter.js +130 -0
- package/dist/surfacing/rateLimiter.js.map +1 -0
- package/dist/surfacing/retryPolicy.js +15 -0
- package/dist/surfacing/retryPolicy.js.map +1 -0
- package/dist/sync/syncTask.js +60 -33
- package/dist/sync/syncTask.js.map +1 -1
- package/dist/testing/memoryAdapter.d.ts +2 -0
- package/dist/testing/memoryAdapter.js +10 -0
- package/dist/testing/memoryAdapter.js.map +1 -1
- package/dist/timeframe/tz.js +17 -6
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/tracker/autoCapture.d.ts +48 -0
- package/dist/tracker/autoCapture.js +129 -0
- package/dist/tracker/autoCapture.js.map +1 -0
- package/dist/tracker/consent.d.ts +24 -0
- package/dist/tracker/consent.js +48 -0
- package/dist/tracker/consent.js.map +1 -0
- package/dist/tracker/createTracker.d.ts +18 -0
- package/dist/tracker/createTracker.js +163 -0
- package/dist/tracker/createTracker.js.map +1 -0
- package/dist/tracker/initTracker.d.ts +22 -0
- package/dist/tracker/initTracker.js +33 -0
- package/dist/tracker/initTracker.js.map +1 -0
- package/dist/tracker/loadScript.d.ts +14 -0
- package/dist/tracker/loadScript.js +41 -0
- package/dist/tracker/loadScript.js.map +1 -0
- package/dist/tracker/pageTracking.d.ts +17 -0
- package/dist/tracker/pageTracking.js +38 -0
- package/dist/tracker/pageTracking.js.map +1 -0
- package/dist/tracker/registry.d.ts +27 -0
- package/dist/tracker/registry.js +73 -0
- package/dist/tracker/registry.js.map +1 -0
- package/dist/tracker/sinks/native.d.ts +22 -0
- package/dist/tracker/sinks/native.js +56 -0
- package/dist/tracker/sinks/native.js.map +1 -0
- package/dist/tracker/sinks/plausible.d.ts +14 -0
- package/dist/tracker/sinks/plausible.js +25 -0
- package/dist/tracker/sinks/plausible.js.map +1 -0
- package/dist/tracker/sinks/posthog.d.ts +14 -0
- package/dist/tracker/sinks/posthog.js +18 -0
- package/dist/tracker/sinks/posthog.js.map +1 -0
- package/dist/tracker/sinks/umami.d.ts +13 -0
- package/dist/tracker/sinks/umami.js +17 -0
- package/dist/tracker/sinks/umami.js.map +1 -0
- package/dist/tracker/sinks/vendor.d.ts +14 -0
- package/dist/tracker/sinks/vendor.js +66 -0
- package/dist/tracker/sinks/vendor.js.map +1 -0
- package/dist/tracker/transport.js +28 -0
- package/dist/tracker/transport.js.map +1 -0
- package/dist/tracker/types.d.ts +66 -0
- package/dist/translations/ar.js +104 -1
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +104 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +104 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +104 -1
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +104 -1
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +104 -1
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/keys.d.ts +103 -0
- package/dist/translations/keys.js +104 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +104 -1
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/metricKeys.js +1 -1
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +104 -1
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +104 -1
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/uk.js +104 -1
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +104 -1
- package/dist/translations/zh.js.map +1 -1
- package/dist/view/AnalyticsNavLink.d.ts +19 -0
- package/dist/view/AnalyticsNavLink.js +40 -0
- package/dist/view/AnalyticsNavLink.js.map +1 -0
- package/dist/view/AnalyticsView.d.ts +23 -0
- package/dist/view/AnalyticsView.js +45 -0
- package/dist/view/AnalyticsView.js.map +1 -0
- package/dist/view/AnalyticsViewClient.d.ts +15 -0
- package/dist/view/AnalyticsViewClient.js +189 -0
- package/dist/view/AnalyticsViewClient.js.map +1 -0
- package/dist/view/authRedirect.js +32 -0
- package/dist/view/authRedirect.js.map +1 -0
- package/dist/view/conversionRate.js +18 -0
- package/dist/view/conversionRate.js.map +1 -0
- package/dist/view/dayRange.js +68 -0
- package/dist/view/dayRange.js.map +1 -0
- package/dist/view/gating.d.ts +1 -0
- package/dist/view/gating.js +105 -0
- package/dist/view/gating.js.map +1 -0
- package/dist/view/labels.js +44 -0
- package/dist/view/labels.js.map +1 -0
- package/dist/view/registerView.js +48 -0
- package/dist/view/registerView.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +157 -0
- package/dist/view/sections/Breakdowns.js.map +1 -0
- package/dist/view/sections/EmptyStates.js +92 -0
- package/dist/view/sections/EmptyStates.js.map +1 -0
- package/dist/view/sections/FilterChips.js +41 -0
- package/dist/view/sections/FilterChips.js.map +1 -0
- package/dist/view/sections/GoalsPanel.js +81 -0
- package/dist/view/sections/GoalsPanel.js.map +1 -0
- package/dist/view/sections/OverviewCards.js +65 -0
- package/dist/view/sections/OverviewCards.js.map +1 -0
- package/dist/view/sections/RealtimeStrip.js +77 -0
- package/dist/view/sections/RealtimeStrip.js.map +1 -0
- package/dist/view/sections/Toolbar.js +179 -0
- package/dist/view/sections/Toolbar.js.map +1 -0
- package/dist/view/sections/Trend.js +119 -0
- package/dist/view/sections/Trend.js.map +1 -0
- package/dist/view/sections/styles.js +74 -0
- package/dist/view/sections/styles.js.map +1 -0
- package/dist/view/state.js +206 -0
- package/dist/view/state.js.map +1 -0
- package/dist/view/useViewQueries.js +150 -0
- package/dist/view/useViewQueries.js.map +1 -0
- package/dist/view/viewProps.d.ts +40 -0
- package/dist/view/viewProps.js +90 -0
- package/dist/view/viewProps.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsBreakdownWidget.js +22 -4
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
- package/dist/widgets/AnalyticsGoalsWidget.js +188 -0
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsMetricWidget.js +35 -12
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +42 -22
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsTrendWidget.js +51 -15
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/WidgetViewLink.js +17 -0
- package/dist/widgets/WidgetViewLink.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +32 -0
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/cardChrome.js +31 -7
- package/dist/widgets/cardChrome.js.map +1 -1
- package/dist/widgets/range.js +43 -12
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +12 -0
- package/dist/widgets/readForWidget.js +30 -19
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +15 -0
- package/dist/widgets/readForWidgetBreakdown.js +32 -20
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +57 -0
- package/dist/widgets/readForWidgetGoals.js +126 -0
- package/dist/widgets/readForWidgetGoals.js.map +1 -0
- package/dist/widgets/readForWidgetRealtime.js +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +13 -0
- package/dist/widgets/readForWidgetSeries.js +56 -28
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/registerWidgets.js +58 -9
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/types.js +16 -2
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +22 -0
- package/dist/widgets/viewLink.js +83 -0
- package/dist/widgets/viewLink.js.map +1 -0
- package/package.json +25 -5
|
@@ -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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"}
|
package/dist/charts/bars.d.ts
CHANGED
package/dist/charts/bars.js
CHANGED
package/dist/charts/bars.js.map
CHANGED
|
@@ -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":";;;;;;
|
|
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}\n\nexport interface BarRow {\n\tlabel: string\n\tvalue: number\n\tfraction: number\n\tdisplay?: string\n\tsecondary?: 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\tsecondary: d.secondary,\n\t}))\n}\n"],"mappings":";;;;;;AAqBA,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;CACd,EAAE;AACH"}
|
package/dist/charts/bucket.js
CHANGED
|
@@ -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;
|
|
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"}
|
package/dist/charts/spline.js
CHANGED
|
@@ -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":";
|
|
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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"}
|
package/dist/charts/styles.js
CHANGED
|
@@ -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 {
|
|
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
|
|
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"}
|
package/dist/core/cacheKey.js
CHANGED
|
@@ -1,10 +1,22 @@
|
|
|
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
|
+
/**
|
|
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
|
+
};
|
|
4
16
|
function buildCacheKey(provider, q) {
|
|
5
17
|
const pathKey = q.path ?? "site";
|
|
6
18
|
const tz = q.timezone ?? "UTC";
|
|
7
|
-
const range =
|
|
19
|
+
const range = rangeKey(q.dateRange, tz);
|
|
8
20
|
const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
|
|
9
21
|
return [
|
|
10
22
|
"analytics",
|
|
@@ -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 =
|
|
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\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): 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\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;;;;;;;;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;AAEA,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,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;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"}
|
|
@@ -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';
|
|
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
|
package/dist/core/contract.d.ts
CHANGED
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
import { Goal } from "../goals/types.js";
|
|
2
|
+
import { CaptureSupport } from "./capture.js";
|
|
3
|
+
import { ServerTrack } from "./serverEvent.js";
|
|
1
4
|
import { Config, PayloadRequest } from "payload";
|
|
2
5
|
|
|
3
6
|
//#region src/core/contract.d.ts
|
|
@@ -7,13 +10,17 @@ 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
|
-
|
|
13
|
+
/** Every breakdown key the contract defines; the registry request parsers validate against. */
|
|
14
|
+
declare const DIMENSION_KEYS: readonly ["page", "referrer", "source", "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
|
}
|
|
16
|
-
|
|
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];
|
|
17
24
|
interface AnalyticsFilter {
|
|
18
25
|
dimension: DimensionKey;
|
|
19
26
|
operator: FilterOperator;
|
|
@@ -58,14 +65,20 @@ interface AnalyticsResult {
|
|
|
58
65
|
provider: string;
|
|
59
66
|
sampled?: boolean;
|
|
60
67
|
clamped?: boolean;
|
|
61
|
-
fetchedAt: string;
|
|
68
|
+
fetchedAt: string; /** Served from an expired cache entry because the live refresh failed. */
|
|
69
|
+
stale?: boolean;
|
|
62
70
|
};
|
|
63
71
|
}
|
|
64
72
|
interface RateLimitDescriptor {
|
|
65
73
|
requestsPerMinute?: number;
|
|
66
74
|
requestsPerHour?: number;
|
|
67
75
|
maxConcurrent?: number;
|
|
76
|
+
/**
|
|
77
|
+
* Describes the provider's quota model for documentation; the limiter always
|
|
78
|
+
* throttles by request count regardless of this value.
|
|
79
|
+
*/
|
|
68
80
|
quotaModel?: 'requests' | 'tokens';
|
|
81
|
+
/** Documents whether reads consume the provider's write/ingest quota too. */
|
|
69
82
|
readsCountAsUsage?: boolean;
|
|
70
83
|
}
|
|
71
84
|
interface AnalyticsCapabilities {
|
|
@@ -109,11 +122,29 @@ interface AdapterRegisterContext {
|
|
|
109
122
|
* rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.
|
|
110
123
|
*/
|
|
111
124
|
resolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>;
|
|
125
|
+
/**
|
|
126
|
+
* The install's goals for a request's scope, for adapters that match completions
|
|
127
|
+
* themselves (the native engine, at ingest). Config goals, with the goals collection
|
|
128
|
+
* merged over them per scope once the install enables it.
|
|
129
|
+
*/
|
|
130
|
+
resolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>;
|
|
112
131
|
}
|
|
113
132
|
interface AnalyticsAdapter {
|
|
114
133
|
readonly id: string;
|
|
115
134
|
readonly label: string;
|
|
116
135
|
readonly capabilities: AnalyticsCapabilities;
|
|
136
|
+
/** Browser-tracker proxying/boot descriptor. Absent when the adapter has no client-side script (GA4). */
|
|
137
|
+
readonly capture?: CaptureSupport;
|
|
138
|
+
/**
|
|
139
|
+
* Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the
|
|
140
|
+
* adapters that register one (the native engine), and how server code reaches the same
|
|
141
|
+
* pipeline without an HTTP round trip. Server-side only: the tracker learns the path
|
|
142
|
+
* from `TrackerConfig.ingestPath`, and this object is never serialized.
|
|
143
|
+
*/
|
|
144
|
+
readonly ingest?: {
|
|
145
|
+
path: string;
|
|
146
|
+
track?: ServerTrack;
|
|
147
|
+
};
|
|
117
148
|
isConfigured(): boolean;
|
|
118
149
|
query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
|
|
119
150
|
realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
|
|
@@ -121,5 +152,5 @@ interface AnalyticsAdapter {
|
|
|
121
152
|
}
|
|
122
153
|
type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
|
|
123
154
|
//#endregion
|
|
124
|
-
export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
|
|
155
|
+
export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
|
|
125
156
|
//# sourceMappingURL=contract.d.ts.map
|
package/dist/core/contract.js
CHANGED
|
@@ -4,7 +4,35 @@
|
|
|
4
4
|
* scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
|
|
5
5
|
*/
|
|
6
6
|
const PLATFORM_SCOPE = "*";
|
|
7
|
+
/** Every breakdown key the contract defines; the registry request parsers validate against. */
|
|
8
|
+
const DIMENSION_KEYS = [
|
|
9
|
+
"page",
|
|
10
|
+
"referrer",
|
|
11
|
+
"source",
|
|
12
|
+
"medium",
|
|
13
|
+
"campaign",
|
|
14
|
+
"utmSource",
|
|
15
|
+
"utmMedium",
|
|
16
|
+
"utmCampaign",
|
|
17
|
+
"utmContent",
|
|
18
|
+
"utmTerm",
|
|
19
|
+
"device",
|
|
20
|
+
"browser",
|
|
21
|
+
"os",
|
|
22
|
+
"country",
|
|
23
|
+
"region",
|
|
24
|
+
"city",
|
|
25
|
+
"language",
|
|
26
|
+
"event",
|
|
27
|
+
"goal"
|
|
28
|
+
];
|
|
29
|
+
/** Every filter operator the contract defines; the registry request parsers validate against. */
|
|
30
|
+
const FILTER_OPERATORS = [
|
|
31
|
+
"eq",
|
|
32
|
+
"contains",
|
|
33
|
+
"matches"
|
|
34
|
+
];
|
|
7
35
|
//#endregion
|
|
8
|
-
export { PLATFORM_SCOPE };
|
|
36
|
+
export { DIMENSION_KEYS, FILTER_OPERATORS, PLATFORM_SCOPE };
|
|
9
37
|
|
|
10
38
|
//# sourceMappingURL=contract.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\n\n/**\n * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every\n * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.\n */\nexport const PLATFORM_SCOPE = '*'\n\nexport type MetricKey =\n\t| 'pageviews'\n\t| 'visitors'\n\t| 'visits'\n\t| 'sessions'\n\t| 'bounceRate'\n\t| 'avgDuration'\n\t| 'scrollDepth'\n\t| 'events'\n\t| 'conversions'\n\t| 'revenue'\n\nexport
|
|
1
|
+
{"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\nimport type { Goal } from '../goals/types'\nimport type { CaptureSupport } from './capture'\nimport type { ServerTrack } from './serverEvent'\n\n/**\n * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every\n * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.\n */\nexport const PLATFORM_SCOPE = '*'\n\nexport type MetricKey =\n\t| 'pageviews'\n\t| 'visitors'\n\t| 'visits'\n\t| 'sessions'\n\t| 'bounceRate'\n\t| 'avgDuration'\n\t| 'scrollDepth'\n\t| 'events'\n\t| 'conversions'\n\t| 'revenue'\n\n/** Every breakdown key the contract defines; the registry request parsers validate against. */\nexport const DIMENSION_KEYS = [\n\t'page',\n\t'referrer',\n\t'source',\n\t'medium',\n\t'campaign',\n\t'utmSource',\n\t'utmMedium',\n\t'utmCampaign',\n\t'utmContent',\n\t'utmTerm',\n\t'device',\n\t'browser',\n\t'os',\n\t'country',\n\t'region',\n\t'city',\n\t'language',\n\t'event',\n\t'goal',\n] as const\n\nexport type DimensionKey = (typeof DIMENSION_KEYS)[number]\n\nexport type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month'\n\nexport interface DateRange {\n\tstart: Date\n\tend: Date\n}\n\n/** Every filter operator the contract defines; the registry request parsers validate against. */\nexport const FILTER_OPERATORS = ['eq', 'contains', 'matches'] as const\n\nexport type FilterOperator = (typeof FILTER_OPERATORS)[number]\n\nexport interface AnalyticsFilter {\n\tdimension: DimensionKey\n\toperator: FilterOperator\n\tvalue: string\n}\n\nexport interface AnalyticsQuery {\n\tpath?: string\n\thostname?: string\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tdateRange: DateRange\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\t/**\n\t * Analytics boundary this read belongs to (tenant id, site key). Undefined means\n\t * install-wide (the default). Adapters that can filter by scope apply it; others\n\t * ignore it. Always part of the surfacing cache key, so per-scope adapter\n\t * instances sharing an id never share cached results.\n\t */\n\tscope?: string\n\t/**\n\t * IANA reporting timezone the read's day boundaries are aligned to. Undefined\n\t * means UTC. Adapters that can bucket in a timezone apply it (PostHog, Umami);\n\t * others report in their own account timezone. Part of the cache key when set.\n\t */\n\ttimezone?: string\n}\n\nexport interface AnalyticsRow {\n\tdimensions?: Partial<Record<DimensionKey, string>>\n\tmetrics: Partial<Record<MetricKey, number>>\n\ttimestamp?: string\n}\n\nexport interface AnalyticsResult {\n\trows: AnalyticsRow[]\n\ttotals?: Partial<Record<MetricKey, number>>\n\tmeta: {\n\t\tprovider: string\n\t\tsampled?: boolean\n\t\tclamped?: boolean\n\t\tfetchedAt: string\n\t\t/** Served from an expired cache entry because the live refresh failed. */\n\t\tstale?: boolean\n\t}\n}\n\nexport interface RateLimitDescriptor {\n\trequestsPerMinute?: number\n\trequestsPerHour?: number\n\tmaxConcurrent?: number\n\t/**\n\t * Describes the provider's quota model for documentation; the limiter always\n\t * throttles by request count regardless of this value.\n\t */\n\tquotaModel?: 'requests' | 'tokens'\n\t/** Documents whether reads consume the provider's write/ingest quota too. */\n\treadsCountAsUsage?: boolean\n}\n\nexport interface AnalyticsCapabilities {\n\tperPageQuery: boolean\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n\tmetrics: ReadonlySet<MetricKey>\n\tdimensions: ReadonlySet<DimensionKey>\n\t/** Dimensions the adapter can apply AnalyticsQuery.filters on; empty = filters unsupported. */\n\tfilters: ReadonlySet<DimensionKey>\n\t/** Operators the adapter honors in filters; adapters ignore filters whose operator they lack. */\n\tfilterOperators: ReadonlySet<FilterOperator>\n\tbatchPageReport: boolean\n\trateLimit: RateLimitDescriptor | null\n\trecommendedTtl: { realtime: number; aggregate: number }\n\t/**\n\t * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native\n\t * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through\n\t * a shared platform adapter would expose cross-scope data, so such reads are\n\t * gated by `access.platformRead`.\n\t */\n\tscopedQueries?: boolean\n}\n\nexport interface AdapterContext {\n\tsignal?: AbortSignal\n}\n\n/** Extra context the plugin hands adapters when they register config surface. */\nexport interface AdapterRegisterContext {\n\t/** True when the plugin has a scopeResolver configured. */\n\tscoped: boolean\n\t/** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\t/**\n\t * The plugin's reportingTimezone bound for adapter use (e.g. bucketing native\n\t * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.\n\t */\n\tresolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/**\n\t * The install's goals for a request's scope, for adapters that match completions\n\t * themselves (the native engine, at ingest). Config goals, with the goals collection\n\t * merged over them per scope once the install enables it.\n\t */\n\tresolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n}\n\nexport interface AnalyticsAdapter {\n\treadonly id: string\n\treadonly label: string\n\treadonly capabilities: AnalyticsCapabilities\n\t/** Browser-tracker proxying/boot descriptor. Absent when the adapter has no client-side script (GA4). */\n\treadonly capture?: CaptureSupport\n\t/**\n\t * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the\n\t * adapters that register one (the native engine), and how server code reaches the same\n\t * pipeline without an HTTP round trip. Server-side only: the tracker learns the path\n\t * from `TrackerConfig.ingestPath`, and this object is never serialized.\n\t */\n\treadonly ingest?: { path: string; track?: ServerTrack }\n\tisConfigured(): boolean\n\tquery(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\trealtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\tregister?(config: Config, context?: AdapterRegisterContext): void\n}\n\nexport type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter\n"],"mappings":";;;;;AASA,MAAa,iBAAiB;;AAe9B,MAAa,iBAAiB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;AAYA,MAAa,mBAAmB;CAAC;CAAM;CAAY;AAAS"}
|
package/dist/core/granularity.js
CHANGED
|
@@ -12,6 +12,6 @@ const GRANULARITY_ORDER = [
|
|
|
12
12
|
*/
|
|
13
13
|
const supportsGranularity = (caps, g) => GRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity);
|
|
14
14
|
//#endregion
|
|
15
|
-
export { supportsGranularity };
|
|
15
|
+
export { GRANULARITY_ORDER, supportsGranularity };
|
|
16
16
|
|
|
17
17
|
//# sourceMappingURL=granularity.js.map
|