@byline/admin 4.15.0 → 4.17.0

package/dist/modules/analytics/components/dashboard.js

@@ -0,0 +1,308 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { ANALYTICS_DASHBOARD_PERIODS, ANALYTICS_OVERFLOW_KEY, isAnalyticsDashboardPeriod } from "@byline/analytics/config";
+import { ANALYTICS_IGNORE_STORAGE_KEY } from "@byline/analytics-agent";
+import { useTranslation } from "@byline/i18n/react";
+import { Button, Card, Container, Section, Select } from "@byline/ui/react";
+import clsx from "clsx";
+import dashboard_module from "./dashboard.module.js";
+import { AnalyticsTimeseries, resolveAnalyticsChartGranularity } from "./timeseries.js";
+function AnalyticsDashboard({ data, period, onPeriodChange }) {
+    const { locale, t } = useTranslation('byline-admin');
+    const [excluded, setExcluded] = useState(false);
+    const numbers = useMemo(()=>new Intl.NumberFormat(locale), [
+        locale
+    ]);
+    useEffect(()=>{
+        try {
+            setExcluded(null != localStorage.getItem(ANALYTICS_IGNORE_STORAGE_KEY));
+        } catch  {
+            setExcluded(false);
+        }
+    }, []);
+    const toggleExclusion = ()=>{
+        try {
+            if (excluded) localStorage.removeItem(ANALYTICS_IGNORE_STORAGE_KEY);
+            else localStorage.setItem(ANALYTICS_IGNORE_STORAGE_KEY, '1');
+            setExcluded(!excluded);
+        } catch  {}
+    };
+    const periodItems = ANALYTICS_DASHBOARD_PERIODS.map((value)=>({
+            value: String(value),
+            label: 'number' == typeof value ? t('analytics.period.days', {
+                count: value
+            }) : t(`analytics.period.${value}`)
+        }));
+    const { views, visitors, downloads } = data.summary;
+    const days = data.summary.timeseries.length;
+    const chartGranularity = resolveAnalyticsChartGranularity(period, days);
+    return /*#__PURE__*/ jsx(Section, {
+        children: /*#__PURE__*/ jsxs(Container, {
+            children: [
+                /*#__PURE__*/ jsxs("header", {
+                    className: clsx('byline-analytics-header', dashboard_module.header),
+                    children: [
+                        /*#__PURE__*/ jsxs("div", {
+                            children: [
+                                /*#__PURE__*/ jsx("h1", {
+                                    className: clsx('byline-analytics-title', dashboard_module.title),
+                                    children: t('analytics.title')
+                                }),
+                                /*#__PURE__*/ jsx("p", {
+                                    className: clsx('muted', 'byline-analytics-help', dashboard_module.help),
+                                    children: t('analytics.dailyUniquesHelp')
+                                })
+                            ]
+                        }),
+                        /*#__PURE__*/ jsxs("div", {
+                            className: clsx('byline-analytics-controls', dashboard_module.controls),
+                            children: [
+                                /*#__PURE__*/ jsx(Select, {
+                                    id: "analytics-period",
+                                    name: "analytics-period",
+                                    "aria-label": t('analytics.period.label'),
+                                    size: "sm",
+                                    value: String(period),
+                                    items: periodItems,
+                                    onValueChange: (value)=>{
+                                        const next = 'ytd' === value || 'all' === value ? value : Number(value);
+                                        if (isAnalyticsDashboardPeriod(next)) onPeriodChange(next);
+                                    }
+                                }),
+                                /*#__PURE__*/ jsx(Button, {
+                                    type: "button",
+                                    size: "sm",
+                                    "aria-pressed": excluded,
+                                    title: t('analytics.exclusion.help'),
+                                    onClick: toggleExclusion,
+                                    children: excluded ? t('analytics.exclusion.include') : t('analytics.exclusion.exclude')
+                                })
+                            ]
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    className: clsx('byline-analytics-stats', dashboard_module.stats),
+                    children: [
+                        /*#__PURE__*/ jsx(StatTile, {
+                            tone: "views",
+                            label: t('analytics.stats.views'),
+                            value: numbers.format(views),
+                            foot: t('analytics.stats.perDay', {
+                                count: 0 === days ? 0 : Math.round(views / days)
+                            })
+                        }),
+                        /*#__PURE__*/ jsx(StatTile, {
+                            tone: "visitors",
+                            label: t('analytics.stats.dailyUniques'),
+                            value: numbers.format(visitors),
+                            foot: t('analytics.stats.sumOfDays', {
+                                count: days
+                            })
+                        }),
+                        /*#__PURE__*/ jsx(StatTile, {
+                            tone: "downloads",
+                            label: t('analytics.stats.downloads'),
+                            value: numbers.format(downloads),
+                            foot: t('analytics.stats.shareOfViews', {
+                                share: formatShare(downloads, views, locale)
+                            })
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsxs(Card, {
+                    className: clsx('byline-analytics-chart-card', dashboard_module.chartCard),
+                    children: [
+                        /*#__PURE__*/ jsx(Card.Header, {
+                            children: /*#__PURE__*/ jsx(Card.Title, {
+                                children: 'day' === chartGranularity ? t('analytics.chart.perDay') : 'seven-day' === chartGranularity ? t('analytics.chart.perSevenDays') : t('analytics.chart.perMonth')
+                            })
+                        }),
+                        /*#__PURE__*/ jsx(Card.Content, {
+                            children: /*#__PURE__*/ jsx(AnalyticsTimeseries, {
+                                days: data.summary.timeseries,
+                                granularity: chartGranularity,
+                                locale: locale
+                            })
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    className: clsx('byline-analytics-lists', dashboard_module.lists),
+                    children: [
+                        /*#__PURE__*/ jsx(RankedList, {
+                            title: t('analytics.sections.pages'),
+                            caption: t('analytics.columns.viewsAndUniques'),
+                            tone: "views",
+                            locale: locale,
+                            rows: data.pages.rows.map(toPathRow),
+                            total: data.pages.total,
+                            coverageFrom: partialCoverageFrom(data.range.from, data.coverage.pathsFrom)
+                        }),
+                        /*#__PURE__*/ jsxs("div", {
+                            className: dashboard_module.stack,
+                            children: [
+                                /*#__PURE__*/ jsx(RankedList, {
+                                    title: t('analytics.sections.referrers'),
+                                    tone: "visitors",
+                                    locale: locale,
+                                    total: data.referrers.total,
+                                    coverageFrom: partialCoverageFrom(data.range.from, data.coverage.referrersFrom),
+                                    rows: data.referrers.rows.map((row)=>({
+                                            key: row.referrerHost,
+                                            label: row.referrerHost,
+                                            value: row.views,
+                                            visitors: row.visitors,
+                                            overflow: row.referrerHost === ANALYTICS_OVERFLOW_KEY
+                                        }))
+                                }),
+                                /*#__PURE__*/ jsx(RankedList, {
+                                    title: t('analytics.sections.countries'),
+                                    tone: "visitors",
+                                    locale: locale,
+                                    rows: data.countries.map((row)=>({
+                                            key: row.country,
+                                            label: row.country,
+                                            value: row.views,
+                                            visitors: row.visitors,
+                                            overflow: false
+                                        }))
+                                })
+                            ]
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsx(RankedList, {
+                    title: t('analytics.sections.downloads'),
+                    caption: t('analytics.columns.clicksAndUniques'),
+                    tone: "downloads",
+                    locale: locale,
+                    rows: data.downloads.rows.map(toPathRow),
+                    total: data.downloads.total,
+                    coverageFrom: partialCoverageFrom(data.range.from, data.coverage.pathsFrom)
+                })
+            ]
+        })
+    });
+}
+const TONE_TILE = {
+    views: dashboard_module.toneViews,
+    visitors: dashboard_module.toneVisitors,
+    downloads: dashboard_module.toneDownloads
+};
+const TONE_BAR = {
+    views: dashboard_module.barViews,
+    visitors: dashboard_module.barVisitors,
+    downloads: dashboard_module.barDownloads
+};
+function StatTile({ tone, label, value, foot }) {
+    return /*#__PURE__*/ jsxs("div", {
+        className: clsx('byline-analytics-stat', dashboard_module.stat, TONE_TILE[tone]),
+        children: [
+            /*#__PURE__*/ jsx("span", {
+                className: clsx('byline-analytics-stat-label', dashboard_module.statLabel),
+                children: label
+            }),
+            /*#__PURE__*/ jsx("span", {
+                className: clsx('byline-analytics-stat-value', dashboard_module.statValue),
+                children: value
+            }),
+            /*#__PURE__*/ jsx("span", {
+                className: clsx('byline-analytics-stat-foot', dashboard_module.statFoot),
+                children: foot
+            })
+        ]
+    });
+}
+function toPathRow(row) {
+    return {
+        key: row.path,
+        label: row.path,
+        value: row.views,
+        visitors: row.visitors,
+        overflow: row.path === ANALYTICS_OVERFLOW_KEY
+    };
+}
+function RankedList({ title, caption, rows, tone, locale, total, coverageFrom }) {
+    const { t } = useTranslation('byline-admin');
+    const numbers = useMemo(()=>new Intl.NumberFormat(locale), [
+        locale
+    ]);
+    const ceiling = Math.max(1, ...rows.map((row)=>row.value));
+    const truncated = null != total && total > rows.length;
+    const coverageDate = useMemo(()=>new Intl.DateTimeFormat(locale, {
+            dateStyle: 'medium',
+            timeZone: 'UTC'
+        }), [
+        locale
+    ]);
+    const description = [
+        truncated ? t('analytics.topOf', {
+            shown: rows.length,
+            total
+        }) : caption,
+        null == coverageFrom ? void 0 : t('analytics.coverage.since', {
+            date: coverageDate.format(new Date(`${coverageFrom}T00:00:00.000Z`))
+        })
+    ].filter((value)=>null != value).join(' · ');
+    return /*#__PURE__*/ jsxs(Card, {
+        className: clsx('byline-analytics-list', dashboard_module.list),
+        children: [
+            /*#__PURE__*/ jsxs(Card.Header, {
+                children: [
+                    /*#__PURE__*/ jsx(Card.Title, {
+                        children: title
+                    }),
+                    description.length > 0 && /*#__PURE__*/ jsx(Card.Description, {
+                        children: description
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsx(Card.Content, {
+                children: 0 === rows.length ? /*#__PURE__*/ jsx("p", {
+                    className: "muted",
+                    children: t('analytics.empty')
+                }) : /*#__PURE__*/ jsx("ol", {
+                    className: clsx('byline-analytics-ranking', dashboard_module.ranking),
+                    children: rows.map((row)=>/*#__PURE__*/ jsxs("li", {
+                            className: clsx('byline-analytics-ranking-row', dashboard_module.rankingRow, TONE_BAR[tone], row.overflow && dashboard_module.rankingOverflow),
+                            style: {
+                                '--byline-analytics-share': `${shareWidth(row.value, ceiling)}%`
+                            },
+                            children: [
+                                /*#__PURE__*/ jsx("span", {
+                                    className: dashboard_module.rankingLabel,
+                                    title: row.key,
+                                    children: row.overflow ? t('analytics.overflow') : row.label
+                                }),
+                                /*#__PURE__*/ jsx("span", {
+                                    className: dashboard_module.rankingValue,
+                                    children: numbers.format(row.value)
+                                }),
+                                /*#__PURE__*/ jsx("span", {
+                                    className: dashboard_module.rankingVisitors,
+                                    children: numbers.format(row.visitors)
+                                })
+                            ]
+                        }, row.key))
+                })
+            })
+        ]
+    });
+}
+function shareWidth(value, ceiling) {
+    if (!Number.isFinite(value) || value <= 0 || ceiling <= 0) return 0;
+    return Math.max(3, Math.min(100, value / ceiling * 100));
+}
+function formatShare(part, whole, locale) {
+    const percent = new Intl.NumberFormat(locale, {
+        style: 'percent',
+        maximumFractionDigits: 1
+    });
+    return percent.format(whole <= 0 ? 0 : part / whole);
+}
+function partialCoverageFrom(rangeFrom, coverageFrom) {
+    return null != coverageFrom && coverageFrom > rangeFrom ? coverageFrom : void 0;
+}
+export { AnalyticsDashboard, formatShare, partialCoverageFrom, shareWidth };

package/dist/modules/analytics/components/dashboard.module.js

@@ -0,0 +1,29 @@
+import "./dashboard_module.css";
+const dashboard_module = {
+    header: "header-zAoAGd",
+    title: "title-ZhxB2D",
+    help: "help-HT9JOI",
+    chartCard: "chartCard-NaXVMm",
+    list: "list-sR__nc",
+    controls: "controls-_Alpbi",
+    stats: "stats-u3kcTH",
+    stat: "stat-KhSBeS",
+    statLabel: "statLabel-X0_tdu",
+    statValue: "statValue-D32ine",
+    statFoot: "statFoot-yvtZiS",
+    toneViews: "toneViews-QGWabX",
+    toneVisitors: "toneVisitors-GTLZDo",
+    toneDownloads: "toneDownloads-WuDN7n",
+    lists: "lists-BLqFfy",
+    stack: "stack-Yzch8f",
+    ranking: "ranking-yfNSnw",
+    rankingRow: "rankingRow-CH1cHn",
+    barViews: "barViews-E6VuaR",
+    barVisitors: "barVisitors-eIANXw",
+    barDownloads: "barDownloads-Z50NxT",
+    rankingOverflow: "rankingOverflow-hUQMKU",
+    rankingLabel: "rankingLabel-wsuniC",
+    rankingValue: "rankingValue-i_vmgf",
+    rankingVisitors: "rankingVisitors-NZl_jj"
+};
+export default dashboard_module;

package/dist/modules/analytics/components/dashboard.test.node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+export {};

package/dist/modules/analytics/components/dashboard_module.css

@@ -0,0 +1,268 @@
+:is(.header-zAoAGd, .byline-analytics-header) {
+  border-bottom: var(--border-width-thin) var(--border-style-solid) var(--gray-200);
+  flex-wrap: wrap;
+  justify-content: space-between;
+  align-items: flex-end;
+  gap: 1rem 1.5rem;
+  margin-bottom: 1.25rem;
+  padding-bottom: 1rem;
+  display: flex;
+}
+
+:is(.title-ZhxB2D, .byline-analytics-title) {
+  letter-spacing: -.02em;
+  margin: 0;
+  font-size: 1.875rem;
+  font-weight: 650;
+}
+
+:is(.help-HT9JOI, .byline-analytics-help) {
+  max-width: 48ch;
+  margin: .35rem 0 0;
+  font-size: .8125rem;
+}
+
+:is(.chartCard-NaXVMm .byline-card-title, .list-sR__nc .byline-card-title) {
+  letter-spacing: normal;
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+:is(.chartCard-NaXVMm .byline-card-description, .list-sR__nc .byline-card-description) {
+  font-size: .75rem;
+}
+
+:is(.controls-_Alpbi, .byline-analytics-controls) {
+  flex-wrap: wrap;
+  align-items: center;
+  gap: .75rem;
+  display: flex;
+}
+
+:is(.stats-u3kcTH, .byline-analytics-stats) {
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: .75rem;
+  margin-bottom: .75rem;
+  display: grid;
+}
+
+:is(.stat-KhSBeS, .byline-analytics-stat) {
+  border-radius: .375rem;
+  flex-direction: column;
+  gap: .5rem;
+  min-width: 0;
+  padding: 1rem 1.125rem 1.125rem;
+  display: flex;
+}
+
+:is(.statLabel-X0_tdu, .byline-analytics-stat-label) {
+  text-transform: uppercase;
+  letter-spacing: .1em;
+  font-size: .625rem;
+  font-weight: 600;
+  line-height: 1;
+}
+
+:is(.statValue-D32ine, .byline-analytics-stat-value) {
+  font-variant-numeric: tabular-nums;
+  letter-spacing: -.02em;
+  font-size: clamp(1.75rem, 4.5vw, 2.5rem);
+  font-weight: 700;
+  line-height: 1;
+}
+
+:is(.statFoot-yvtZiS, .byline-analytics-stat-foot) {
+  font-variant-numeric: tabular-nums;
+  color: var(--gray-600);
+  font-size: .6875rem;
+}
+
+.toneViews-QGWabX {
+  background-color: #f0f9ff;
+}
+
+.toneViews-QGWabX .statLabel-X0_tdu, .toneViews-QGWabX .statValue-D32ine {
+  color: #0369a1;
+}
+
+.toneVisitors-GTLZDo {
+  background-color: #f5f3ff;
+}
+
+.toneVisitors-GTLZDo .statLabel-X0_tdu, .toneVisitors-GTLZDo .statValue-D32ine {
+  color: #6d28d9;
+}
+
+.toneDownloads-WuDN7n {
+  background-color: #ecfdf5;
+}
+
+.toneDownloads-WuDN7n .statLabel-X0_tdu, .toneDownloads-WuDN7n .statValue-D32ine {
+  color: #047857;
+}
+
+:is(:is([data-theme="dark"], .dark) .statFoot-yvtZiS, :is([data-theme="dark"], .dark) .byline-analytics-stat-foot) {
+  color: var(--gray-400);
+}
+
+:is([data-theme="dark"], .dark) .toneViews-QGWabX {
+  background-color: #0c4a6e47;
+}
+
+:is([data-theme="dark"], .dark) .toneViews-QGWabX .statLabel-X0_tdu, :is([data-theme="dark"], .dark) .toneViews-QGWabX .statValue-D32ine {
+  color: #7dd3fc;
+}
+
+:is([data-theme="dark"], .dark) .toneVisitors-GTLZDo {
+  background-color: #4c1d954d;
+}
+
+:is([data-theme="dark"], .dark) .toneVisitors-GTLZDo .statLabel-X0_tdu, :is([data-theme="dark"], .dark) .toneVisitors-GTLZDo .statValue-D32ine {
+  color: #c4b5fd;
+}
+
+:is([data-theme="dark"], .dark) .toneDownloads-WuDN7n {
+  background-color: #064e3b47;
+}
+
+:is([data-theme="dark"], .dark) .toneDownloads-WuDN7n .statLabel-X0_tdu, :is([data-theme="dark"], .dark) .toneDownloads-WuDN7n .statValue-D32ine {
+  color: #6ee7b7;
+}
+
+:is(.chartCard-NaXVMm, .byline-analytics-chart-card) {
+  margin-bottom: .75rem;
+}
+
+:is(.lists-BLqFfy, .byline-analytics-lists) {
+  grid-template-columns: 1.55fr 1fr;
+  align-items: start;
+  gap: .75rem;
+  margin-bottom: .75rem;
+  display: grid;
+}
+
+.stack-Yzch8f {
+  flex-direction: column;
+  gap: .75rem;
+  display: flex;
+}
+
+:is(.ranking-yfNSnw, .byline-analytics-ranking) {
+  flex-direction: column;
+  gap: 1px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+}
+
+:is(.rankingRow-CH1cHn, .byline-analytics-ranking-row) {
+  isolation: isolate;
+  border-radius: .25rem;
+  grid-template-columns: minmax(0, 1fr) auto auto;
+  align-items: center;
+  gap: .75rem;
+  padding: .45rem .625rem;
+  display: grid;
+  position: relative;
+}
+
+.rankingRow-CH1cHn:before {
+  content: "";
+  z-index: -1;
+  width: var(--byline-analytics-share, 0%);
+  background-color: var(--byline-analytics-bar, transparent);
+  opacity: .16;
+  border-radius: .25rem;
+  position: absolute;
+  inset: 0 auto 0 0;
+}
+
+.barViews-E6VuaR {
+  --byline-analytics-bar: #38bdf8;
+}
+
+.barVisitors-eIANXw {
+  --byline-analytics-bar: #7c3aed;
+}
+
+.barDownloads-Z50NxT {
+  --byline-analytics-bar: #10b981;
+}
+
+.rankingOverflow-hUQMKU {
+  border: var(--border-width-thin) dashed var(--gray-300);
+}
+
+.rankingOverflow-hUQMKU:before {
+  opacity: .07;
+}
+
+.rankingOverflow-hUQMKU .rankingLabel-wsuniC {
+  color: var(--gray-600);
+  font-style: italic;
+}
+
+.rankingLabel-wsuniC {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+  font-size: .8125rem;
+  overflow: hidden;
+}
+
+.rankingValue-i_vmgf {
+  font-variant-numeric: tabular-nums;
+  font-size: .8125rem;
+  font-weight: 600;
+}
+
+.rankingVisitors-NZl_jj {
+  font-variant-numeric: tabular-nums;
+  text-align: end;
+  min-width: 3ch;
+  color: var(--gray-500);
+  font-size: .6875rem;
+}
+
+:is(:is([data-theme="dark"], .dark) .header-zAoAGd, :is([data-theme="dark"], .dark) .byline-analytics-header) {
+  border-bottom-color: var(--gray-700);
+}
+
+:is([data-theme="dark"], .dark) .rankingVisitors-NZl_jj {
+  color: var(--gray-400);
+}
+
+:is([data-theme="dark"], .dark) .rankingOverflow-hUQMKU {
+  border-color: var(--gray-600);
+}
+
+:is([data-theme="dark"], .dark) .rankingOverflow-hUQMKU .rankingLabel-wsuniC {
+  color: var(--gray-400);
+}
+
+:is([data-theme="dark"], .dark) .barVisitors-eIANXw {
+  --byline-analytics-bar: #a78bfa;
+}
+
+:is([data-theme="dark"], .dark) .barDownloads-Z50NxT {
+  --byline-analytics-bar: #34d399;
+}
+
+@media (max-width: 900px) {
+  :is(.lists-BLqFfy, .byline-analytics-lists) {
+    grid-template-columns: 1fr;
+  }
+}
+
+@media (max-width: 720px) {
+  :is(.header-zAoAGd, .byline-analytics-header) {
+    flex-direction: column;
+    align-items: stretch;
+  }
+
+  :is(.stats-u3kcTH, .byline-analytics-stats) {
+    grid-template-columns: 1fr;
+  }
+}
+

package/dist/modules/analytics/components/timeseries.d.ts

@@ -0,0 +1,59 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+/**
+ * The analytics timeseries — one column per explicit UTC reporting bucket.
+ *
+ * A column rather than a continuous line is a claim about the data, not a
+ * style: the rows behind this chart are sums of daily aggregates and visitor
+ * hashes rotate at UTC midnight, so nothing is measured between two points.
+ * The dashboard selects the granularity and passes it into this renderer;
+ * the chart never guesses from the number of rows.
+ */
+import type React from 'react';
+import type { AnalyticsSummaryDay } from '@byline/analytics';
+import type { AnalyticsDashboardPeriod } from '@byline/analytics/config';
+export type AnalyticsChartGranularity = 'day' | 'seven-day' | 'month';
+export interface AnalyticsChartBucket {
+    from: string;
+    to: string;
+    granularity: AnalyticsChartGranularity;
+    /** Actual number of daily rows, including partial first or last buckets. */
+    dayCount: number;
+    views: number;
+    /** Sum of the bucket's daily-unique visitor values. */
+    visitors: number;
+    downloads: number;
+}
+export interface AnalyticsColumn {
+    index: number;
+    /** Full-height mark: that bucket's page views. */
+    x: number;
+    width: number;
+    y: number;
+    height: number;
+    /** Inset mark: summed daily uniques, always no greater than views. */
+    insetX: number;
+    insetWidth: number;
+    insetY: number;
+    insetHeight: number;
+    /** Full-height transparent target, so narrow columns stay easy to hit. */
+    hitX: number;
+    hitWidth: number;
+}
+/** Resolve chart density outside the renderer so the chosen width is explicit. */
+export declare function resolveAnalyticsChartGranularity(period: AnalyticsDashboardPeriod, dayCount: number): AnalyticsChartGranularity;
+/** Combine complete daily query rows using the caller-selected granularity. */
+export declare function bucketAnalyticsTimeseries(days: readonly AnalyticsSummaryDay[], granularity: AnalyticsChartGranularity): readonly AnalyticsChartBucket[];
+/** Project reporting buckets into column geometry. */
+export declare function buildAnalyticsColumns(buckets: readonly Pick<AnalyticsChartBucket, 'views' | 'visitors'>[]): readonly AnalyticsColumn[];
+export interface AnalyticsTimeseriesProps {
+    days: readonly AnalyticsSummaryDay[];
+    granularity: AnalyticsChartGranularity;
+    locale: string;
+}
+export declare function AnalyticsTimeseries({ days, granularity, locale, }: AnalyticsTimeseriesProps): React.JSX.Element;