trending-news-api 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# trending-news-api
+
+React trending news widget: daily top Wikipedia pages (via the Wikimedia Pageviews API) matched
+against headlines from [The News API](https://www.thenewsapi.com/), served through a bundled
+Cloudflare Worker so the News API key never reaches the browser.
+
+## Features
+
+- Daily trending topics, ranked by Wikipedia pageviews.
+- Matching headlines per topic from The News API.
+- Single-topic headline lookup.
+- Compact card row or full article-list layouts.
+- `localStorage` response caching (10 minutes).
+- TypeScript + tsup library scaffold.
+
+## Install
+
+```bash
+npm install trending-news-api
+```
+
+## Usage
+
+```tsx
+import { TrendingNews } from 'trending-news-api';
+
+export default function App() {
+  return (
+    <TrendingNews
+      compact
+      maxTopics={8}
+      apiEndpoint="https://trending-news-api.your-subdomain.workers.dev"
+    />
+  );
+}
+```
+
+Pass `topic` to render headlines for a single topic instead of the daily trending list:
+
+```tsx
+<TrendingNews apiEndpoint="https://trending-news-api.your-subdomain.workers.dev" topic="Donald Trump" />
+```
+
+The widget renders nothing when `apiEndpoint` is unset, still loading, or errored — safe to drop
+into a layout unconditionally.
+
+## Direct API usage
+
+```ts
+import { getTrendingNews, getTrendingNewsForTopic } from 'trending-news-api';
+
+const trending = await getTrendingNews({
+  apiEndpoint: 'https://trending-news-api.your-subdomain.workers.dev',
+});
+
+const topicNews = await getTrendingNewsForTopic('Donald Trump', {
+  apiEndpoint: 'https://trending-news-api.your-subdomain.workers.dev',
+});
+```
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+## The worker backend
+
+`worker/index.ts` is a Cloudflare Worker that:
+
+- Fetches yesterday's top Wikipedia pages by pageviews (Wikimedia REST API), filtering out
+  non-article pages (`Main_Page`, `Special:`, `Wikipedia:`, etc).
+- For each page, searches The News API for matching headlines.
+- Exposes:
+  - `GET /` — trending topics with headline counts and articles.
+  - `GET /?topic=...` — headlines for a specific topic.
+
+### Deploying the worker
+
+```bash
+cd packages/trending-news-api
+npm run worker:deploy
+npx wrangler secret put THENEWSAPI_API_KEY --config worker/wrangler.jsonc
+```
+
+Use the resulting `*.workers.dev` URL (or a custom route) as `apiEndpoint`.
+
+## Caching
+
+`getTrendingNews` / `getTrendingNewsForTopic` cache each response in `localStorage` for 10
+minutes, keyed by the exact request URL. Call `clearTrendingNewsCache()` to evict everything
+(e.g. in tests). The cache is a no-op in non-browser environments (SSR) or when `localStorage`
+is unavailable/full.
+
+## Notes
+
+- Wikimedia's Pageviews API powers the trending topic list.
+- The News API (thenewsapi.com) powers the headlines — you'll need a free or paid API key.

package/dist/index.cjs

@@ -0,0 +1,283 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TrendingNews: () => TrendingNews,
+  clearTrendingNewsCache: () => clearTrendingNewsCache,
+  getTrendingNews: () => getTrendingNews,
+  getTrendingNewsForTopic: () => getTrendingNewsForTopic,
+  useTrendingNews: () => useTrendingNews
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/cache.ts
+var CACHE_PREFIX = "trending-news-cache:";
+var CACHE_TTL_MS = 10 * 60 * 1e3;
+function getStorage() {
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  return window.localStorage;
+}
+function readCachedTrendingNews(key) {
+  const storage = getStorage();
+  if (!storage) return null;
+  try {
+    const raw = storage.getItem(CACHE_PREFIX + key);
+    if (!raw) return null;
+    const entry = JSON.parse(raw);
+    if (Date.now() - entry.timestamp > CACHE_TTL_MS) {
+      storage.removeItem(CACHE_PREFIX + key);
+      return null;
+    }
+    return entry.data;
+  } catch {
+    return null;
+  }
+}
+function writeCachedTrendingNews(key, data) {
+  const storage = getStorage();
+  if (!storage) return;
+  try {
+    const entry = { timestamp: Date.now(), data };
+    storage.setItem(CACHE_PREFIX + key, JSON.stringify(entry));
+  } catch {
+  }
+}
+function clearTrendingNewsCache() {
+  const storage = getStorage();
+  if (!storage) return;
+  for (let i = storage.length - 1; i >= 0; i--) {
+    const key = storage.key(i);
+    if (key?.startsWith(CACHE_PREFIX)) storage.removeItem(key);
+  }
+}
+
+// src/api/trending.ts
+function mapArticles(articles = []) {
+  return articles.map((a) => ({
+    title: a.title ?? "",
+    url: a.url,
+    source: a.source,
+    publishedAt: a.published_at
+  }));
+}
+function buildUrl(apiEndpoint, options) {
+  const url = new URL(apiEndpoint);
+  if (options.topic) url.searchParams.set("topic", options.topic);
+  return url.toString();
+}
+async function getTrendingNews(options) {
+  if (!options.apiEndpoint) {
+    throw new Error("trending-news-api: apiEndpoint is required");
+  }
+  const url = buildUrl(options.apiEndpoint, options);
+  const cached = readCachedTrendingNews(url);
+  if (cached) return cached;
+  const response = await fetch(url, { headers: { "Content-Type": "application/json" } });
+  if (!response.ok) {
+    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);
+  }
+  const data = await response.json();
+  if (data.error) throw new Error(data.error);
+  const limit = options.limit ?? 25;
+  const result = {
+    date: data.date,
+    topics: (data.topics ?? []).slice(0, limit).map((t) => ({
+      topic: t.topic,
+      wikiRank: t.wiki_rank,
+      wikiViews: t.wiki_views,
+      newsCount: t.news_count,
+      articles: mapArticles(t.articles)
+    }))
+  };
+  writeCachedTrendingNews(url, result);
+  return result;
+}
+async function getTrendingNewsForTopic(topic, options) {
+  if (!options.apiEndpoint) {
+    throw new Error("trending-news-api: apiEndpoint is required");
+  }
+  const url = buildUrl(options.apiEndpoint, { ...options, topic });
+  const cached = readCachedTrendingNews(url);
+  if (cached) return cached;
+  const response = await fetch(url, { headers: { "Content-Type": "application/json" } });
+  if (!response.ok) {
+    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);
+  }
+  const data = await response.json();
+  if (data.error) throw new Error(data.error);
+  const result = {
+    topic: data.topic,
+    newsCount: data.news_count,
+    articles: mapArticles(data.articles)
+  };
+  writeCachedTrendingNews(url, result);
+  return result;
+}
+
+// src/hooks/useTrendingNews.ts
+var import_react = require("react");
+function useTrendingNews(options = {}) {
+  const [data, setData] = (0, import_react.useState)(null);
+  const [error, setError] = (0, import_react.useState)(null);
+  const [loading, setLoading] = (0, import_react.useState)(Boolean(options.apiEndpoint));
+  (0, import_react.useEffect)(() => {
+    if (!options.apiEndpoint) {
+      setLoading(false);
+      return;
+    }
+    let active = true;
+    setLoading(true);
+    setError(null);
+    getTrendingNews(options).then((result) => {
+      if (active) setData(result);
+    }).catch((err) => {
+      if (active) setError(err instanceof Error ? err : new Error("Unknown error"));
+    }).finally(() => {
+      if (active) setLoading(false);
+    });
+    return () => {
+      active = false;
+    };
+  }, [options.apiEndpoint, options.topic, options.limit]);
+  return { data, error, loading };
+}
+
+// src/components/TrendingNews.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var styles = {
+  root: {
+    fontFamily: "system-ui, sans-serif",
+    border: "1px solid #e5e7eb",
+    borderRadius: 12,
+    padding: 16,
+    background: "#fff",
+    color: "#111827",
+    maxWidth: 640
+  },
+  compactRoot: {
+    fontFamily: "system-ui, sans-serif",
+    display: "flex",
+    flexDirection: "column",
+    gap: 6,
+    padding: "10px 14px",
+    borderRadius: 8
+  },
+  compactHeader: {
+    fontSize: 11,
+    fontWeight: 600,
+    opacity: 0.75,
+    letterSpacing: 0.3,
+    textTransform: "uppercase"
+  },
+  topicRow: { display: "flex", gap: 10, overflowX: "auto", paddingBottom: 2 },
+  topicCard: {
+    minWidth: 160,
+    maxWidth: 200,
+    padding: "8px 10px",
+    borderRadius: 8,
+    background: "rgba(255,255,255,0.06)",
+    display: "flex",
+    flexDirection: "column",
+    gap: 4,
+    textDecoration: "none",
+    color: "inherit"
+  },
+  topicName: {
+    fontSize: 12,
+    fontWeight: 600,
+    whiteSpace: "nowrap",
+    overflow: "hidden",
+    textOverflow: "ellipsis"
+  },
+  headline: {
+    fontSize: 11,
+    opacity: 0.8,
+    display: "-webkit-box",
+    WebkitLineClamp: 2,
+    WebkitBoxOrient: "vertical",
+    overflow: "hidden"
+  },
+  count: { fontSize: 10, opacity: 0.6 },
+  list: { display: "flex", flexDirection: "column", gap: 16 },
+  fullTopic: { display: "flex", flexDirection: "column", gap: 6 },
+  fullTopicHeader: { display: "flex", alignItems: "baseline", gap: 8 },
+  article: { fontSize: 13 },
+  articleLink: { color: "inherit", textDecoration: "none" }
+};
+function TrendingNews(props) {
+  const { className, style, compact, maxTopics = 8, ...options } = props;
+  const { data, loading, error } = useTrendingNews(options);
+  if (!options.apiEndpoint) return null;
+  if (loading && !data) return null;
+  if (error) return null;
+  if (!data || data.topics.length === 0) return null;
+  const topics = data.topics.slice(0, maxTopics);
+  if (compact) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className, style: { ...styles.compactRoot, ...style }, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.compactHeader, children: "Trending" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.topicRow, children: topics.map((topic) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "a",
+        {
+          href: topic.articles[0]?.url,
+          target: "_blank",
+          rel: "noreferrer",
+          style: styles.topicCard,
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.topicName, children: topic.topic }),
+            topic.articles[0] && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: styles.headline, children: topic.articles[0].title }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.count, children: [
+              topic.newsCount,
+              " article",
+              topic.newsCount === 1 ? "" : "s"
+            ] })
+          ]
+        },
+        topic.topic
+      )) })
+    ] });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className, style: { ...styles.root, ...styles.list, ...style }, children: topics.map((topic) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.fullTopic, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.fullTopicHeader, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: topic.topic }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: styles.count, children: [
+        topic.newsCount,
+        " article",
+        topic.newsCount === 1 ? "" : "s"
+      ] })
+    ] }),
+    topic.articles.slice(0, 5).map((article, i) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: styles.article, children: [
+      article.url ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("a", { href: article.url, target: "_blank", rel: "noreferrer", style: styles.articleLink, children: article.title }) : article.title,
+      article.source && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: { opacity: 0.6 }, children: [
+        " \xB7 ",
+        article.source
+      ] })
+    ] }, article.url ?? i))
+  ] }, topic.topic)) });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TrendingNews,
+  clearTrendingNewsCache,
+  getTrendingNews,
+  getTrendingNewsForTopic,
+  useTrendingNews
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/lib/cache.ts","../src/api/trending.ts","../src/hooks/useTrendingNews.ts","../src/components/TrendingNews.tsx"],"sourcesContent":["export * from './types';\nexport { clearTrendingNewsCache } from './lib/cache';\nexport * from './api/trending';\nexport * from './hooks/useTrendingNews';\nexport * from './components/TrendingNews';\n","const CACHE_PREFIX = 'trending-news-cache:';\nconst CACHE_TTL_MS = 10 * 60 * 1000;\n\ntype CacheEntry<T> = {\n  timestamp: number;\n  data: T;\n};\n\nfunction getStorage(): Storage | null {\n  if (typeof window === 'undefined' || !window.localStorage) return null;\n  return window.localStorage;\n}\n\n/** Returns the cached value for `key` if it was written within the last 10 minutes. */\nexport function readCachedTrendingNews<T>(key: string): T | null {\n  const storage = getStorage();\n  if (!storage) return null;\n\n  try {\n    const raw = storage.getItem(CACHE_PREFIX + key);\n    if (!raw) return null;\n\n    const entry = JSON.parse(raw) as CacheEntry<T>;\n    if (Date.now() - entry.timestamp > CACHE_TTL_MS) {\n      storage.removeItem(CACHE_PREFIX + key);\n      return null;\n    }\n\n    return entry.data;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeCachedTrendingNews<T>(key: string, data: T): void {\n  const storage = getStorage();\n  if (!storage) return;\n\n  try {\n    const entry: CacheEntry<T> = { timestamp: Date.now(), data };\n    storage.setItem(CACHE_PREFIX + key, JSON.stringify(entry));\n  } catch {\n    // Storage full or unavailable (e.g. private browsing) — safe to ignore,\n    // the next call will simply hit the network again.\n  }\n}\n\n/** Clears all cached trending news responses. Mainly useful for tests/debugging. */\nexport function clearTrendingNewsCache(): void {\n  const storage = getStorage();\n  if (!storage) return;\n\n  for (let i = storage.length - 1; i >= 0; i--) {\n    const key = storage.key(i);\n    if (key?.startsWith(CACHE_PREFIX)) storage.removeItem(key);\n  }\n}\n","import type { NewsArticle, TrendingNewsData, TrendingNewsOptions, TrendingNewsTopicData } from '../types';\nimport { readCachedTrendingNews, writeCachedTrendingNews } from '../lib/cache';\n\ntype WorkerArticle = {\n  title?: string;\n  url?: string;\n  source?: string;\n  published_at?: string;\n};\n\ntype WorkerTopic = {\n  topic: string;\n  wiki_rank?: number;\n  wiki_views?: number;\n  news_count: number;\n  articles: WorkerArticle[];\n};\n\ntype WorkerTopicsResponse = {\n  date?: string;\n  topics: WorkerTopic[];\n  error?: string;\n};\n\ntype WorkerTopicResponse = {\n  topic: string;\n  news_count: number;\n  articles: WorkerArticle[];\n  error?: string;\n};\n\nfunction mapArticles(articles: WorkerArticle[] = []): NewsArticle[] {\n  return articles.map((a) => ({\n    title: a.title ?? '',\n    url: a.url,\n    source: a.source,\n    publishedAt: a.published_at,\n  }));\n}\n\nfunction buildUrl(apiEndpoint: string, options: TrendingNewsOptions) {\n  const url = new URL(apiEndpoint);\n  if (options.topic) url.searchParams.set('topic', options.topic);\n  return url.toString();\n}\n\n/**\n * Fetches trending topics (or, when `options.topic` is set, news for a\n * single topic) from a deployed instance of `worker/index.ts`.\n */\nexport async function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData> {\n  if (!options.apiEndpoint) {\n    throw new Error('trending-news-api: apiEndpoint is required');\n  }\n\n  const url = buildUrl(options.apiEndpoint, options);\n\n  const cached = readCachedTrendingNews<TrendingNewsData>(url);\n  if (cached) return cached;\n\n  const response = await fetch(url, { headers: { 'Content-Type': 'application/json' } });\n  if (!response.ok) {\n    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);\n  }\n\n  const data = (await response.json()) as WorkerTopicsResponse;\n  if (data.error) throw new Error(data.error);\n\n  const limit = options.limit ?? 25;\n  const result: TrendingNewsData = {\n    date: data.date,\n    topics: (data.topics ?? []).slice(0, limit).map((t) => ({\n      topic: t.topic,\n      wikiRank: t.wiki_rank,\n      wikiViews: t.wiki_views,\n      newsCount: t.news_count,\n      articles: mapArticles(t.articles),\n    })),\n  };\n\n  writeCachedTrendingNews(url, result);\n  return result;\n}\n\n/** Fetches news articles for a single topic. */\nexport async function getTrendingNewsForTopic(\n  topic: string,\n  options: Omit<TrendingNewsOptions, 'topic'>\n): Promise<TrendingNewsTopicData> {\n  if (!options.apiEndpoint) {\n    throw new Error('trending-news-api: apiEndpoint is required');\n  }\n\n  const url = buildUrl(options.apiEndpoint, { ...options, topic });\n\n  const cached = readCachedTrendingNews<TrendingNewsTopicData>(url);\n  if (cached) return cached;\n\n  const response = await fetch(url, { headers: { 'Content-Type': 'application/json' } });\n  if (!response.ok) {\n    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);\n  }\n\n  const data = (await response.json()) as WorkerTopicResponse;\n  if (data.error) throw new Error(data.error);\n\n  const result: TrendingNewsTopicData = {\n    topic: data.topic,\n    newsCount: data.news_count,\n    articles: mapArticles(data.articles),\n  };\n\n  writeCachedTrendingNews(url, result);\n  return result;\n}\n","import { useEffect, useState } from 'react';\nimport type { TrendingNewsData, TrendingNewsOptions } from '../types';\nimport { getTrendingNews } from '../api/trending';\n\nexport function useTrendingNews(options: TrendingNewsOptions = {}) {\n  const [data, setData] = useState<TrendingNewsData | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n  const [loading, setLoading] = useState(Boolean(options.apiEndpoint));\n\n  useEffect(() => {\n    if (!options.apiEndpoint) {\n      setLoading(false);\n      return;\n    }\n\n    let active = true;\n    setLoading(true);\n    setError(null);\n\n    getTrendingNews(options)\n      .then((result) => { if (active) setData(result); })\n      .catch((err) => { if (active) setError(err instanceof Error ? err : new Error('Unknown error')); })\n      .finally(() => { if (active) setLoading(false); });\n\n    return () => { active = false; };\n  }, [options.apiEndpoint, options.topic, options.limit]);\n\n  return { data, error, loading };\n}\n","import React from 'react';\nimport { useTrendingNews } from '../hooks/useTrendingNews';\nimport type { TrendingNewsOptions } from '../types';\n\ntype Props = TrendingNewsOptions & {\n  className?: string;\n  style?: React.CSSProperties;\n  compact?: boolean;\n  /** Max trending topics to render (default 8). */\n  maxTopics?: number;\n};\n\nconst styles = {\n  root: {\n    fontFamily: 'system-ui, sans-serif',\n    border: '1px solid #e5e7eb',\n    borderRadius: 12,\n    padding: 16,\n    background: '#fff',\n    color: '#111827',\n    maxWidth: 640,\n  } as React.CSSProperties,\n  compactRoot: {\n    fontFamily: 'system-ui, sans-serif',\n    display: 'flex',\n    flexDirection: 'column',\n    gap: 6,\n    padding: '10px 14px',\n    borderRadius: 8,\n  } as React.CSSProperties,\n  compactHeader: {\n    fontSize: 11,\n    fontWeight: 600,\n    opacity: 0.75,\n    letterSpacing: 0.3,\n    textTransform: 'uppercase',\n  } as React.CSSProperties,\n  topicRow: { display: 'flex', gap: 10, overflowX: 'auto', paddingBottom: 2 } as React.CSSProperties,\n  topicCard: {\n    minWidth: 160,\n    maxWidth: 200,\n    padding: '8px 10px',\n    borderRadius: 8,\n    background: 'rgba(255,255,255,0.06)',\n    display: 'flex',\n    flexDirection: 'column',\n    gap: 4,\n    textDecoration: 'none',\n    color: 'inherit',\n  } as React.CSSProperties,\n  topicName: {\n    fontSize: 12,\n    fontWeight: 600,\n    whiteSpace: 'nowrap',\n    overflow: 'hidden',\n    textOverflow: 'ellipsis',\n  } as React.CSSProperties,\n  headline: {\n    fontSize: 11,\n    opacity: 0.8,\n    display: '-webkit-box',\n    WebkitLineClamp: 2,\n    WebkitBoxOrient: 'vertical',\n    overflow: 'hidden',\n  } as React.CSSProperties,\n  count: { fontSize: 10, opacity: 0.6 } as React.CSSProperties,\n  list: { display: 'flex', flexDirection: 'column', gap: 16 } as React.CSSProperties,\n  fullTopic: { display: 'flex', flexDirection: 'column', gap: 6 } as React.CSSProperties,\n  fullTopicHeader: { display: 'flex', alignItems: 'baseline', gap: 8 } as React.CSSProperties,\n  article: { fontSize: 13 } as React.CSSProperties,\n  articleLink: { color: 'inherit', textDecoration: 'none' } as React.CSSProperties,\n};\n\n/**\n * Trending news widget. Requires `apiEndpoint` pointing at a deployed\n * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders\n * nothing when it's not configured, still loading, or errored, so it never\n * disrupts the layout it's dropped into.\n */\nexport function TrendingNews(props: Props) {\n  const { className, style, compact, maxTopics = 8, ...options } = props;\n  const { data, loading, error } = useTrendingNews(options);\n\n  if (!options.apiEndpoint) return null;\n  if (loading && !data) return null;\n  if (error) return null;\n  if (!data || data.topics.length === 0) return null;\n\n  const topics = data.topics.slice(0, maxTopics);\n\n  if (compact) {\n    return (\n      <div className={className} style={{ ...styles.compactRoot, ...style }}>\n        <div style={styles.compactHeader}>Trending</div>\n        <div style={styles.topicRow}>\n          {topics.map((topic) => (\n            <a\n              key={topic.topic}\n              href={topic.articles[0]?.url}\n              target=\"_blank\"\n              rel=\"noreferrer\"\n              style={styles.topicCard}\n            >\n              <div style={styles.topicName}>{topic.topic}</div>\n              {topic.articles[0] && <div style={styles.headline}>{topic.articles[0].title}</div>}\n              <div style={styles.count}>\n                {topic.newsCount} article{topic.newsCount === 1 ? '' : 's'}\n              </div>\n            </a>\n          ))}\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div className={className} style={{ ...styles.root, ...styles.list, ...style }}>\n      {topics.map((topic) => (\n        <div key={topic.topic} style={styles.fullTopic}>\n          <div style={styles.fullTopicHeader}>\n            <strong>{topic.topic}</strong>\n            <span style={styles.count}>\n              {topic.newsCount} article{topic.newsCount === 1 ? '' : 's'}\n            </span>\n          </div>\n          {topic.articles.slice(0, 5).map((article, i) => (\n            <div key={article.url ?? i} style={styles.article}>\n              {article.url ? (\n                <a href={article.url} target=\"_blank\" rel=\"noreferrer\" style={styles.articleLink}>\n                  {article.title}\n                </a>\n              ) : (\n                article.title\n              )}\n              {article.source && <span style={{ opacity: 0.6 }}> &middot; {article.source}</span>}\n            </div>\n          ))}\n        </div>\n      ))}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAM,eAAe;AACrB,IAAM,eAAe,KAAK,KAAK;AAO/B,SAAS,aAA6B;AACpC,MAAI,OAAO,WAAW,eAAe,CAAC,OAAO,aAAc,QAAO;AAClE,SAAO,OAAO;AAChB;AAGO,SAAS,uBAA0B,KAAuB;AAC/D,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI;AACF,UAAM,MAAM,QAAQ,QAAQ,eAAe,GAAG;AAC9C,QAAI,CAAC,IAAK,QAAO;AAEjB,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,QAAI,KAAK,IAAI,IAAI,MAAM,YAAY,cAAc;AAC/C,cAAQ,WAAW,eAAe,GAAG;AACrC,aAAO;AAAA,IACT;AAEA,WAAO,MAAM;AAAA,EACf,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,wBAA2B,KAAa,MAAe;AACrE,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AAEd,MAAI;AACF,UAAM,QAAuB,EAAE,WAAW,KAAK,IAAI,GAAG,KAAK;AAC3D,YAAQ,QAAQ,eAAe,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EAC3D,QAAQ;AAAA,EAGR;AACF;AAGO,SAAS,yBAA+B;AAC7C,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AAEd,WAAS,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;AAC5C,UAAM,MAAM,QAAQ,IAAI,CAAC;AACzB,QAAI,KAAK,WAAW,YAAY,EAAG,SAAQ,WAAW,GAAG;AAAA,EAC3D;AACF;;;ACzBA,SAAS,YAAY,WAA4B,CAAC,GAAkB;AAClE,SAAO,SAAS,IAAI,CAAC,OAAO;AAAA,IAC1B,OAAO,EAAE,SAAS;AAAA,IAClB,KAAK,EAAE;AAAA,IACP,QAAQ,EAAE;AAAA,IACV,aAAa,EAAE;AAAA,EACjB,EAAE;AACJ;AAEA,SAAS,SAAS,aAAqB,SAA8B;AACnE,QAAM,MAAM,IAAI,IAAI,WAAW;AAC/B,MAAI,QAAQ,MAAO,KAAI,aAAa,IAAI,SAAS,QAAQ,KAAK;AAC9D,SAAO,IAAI,SAAS;AACtB;AAMA,eAAsB,gBAAgB,SAAyD;AAC7F,MAAI,CAAC,QAAQ,aAAa;AACxB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,MAAM,SAAS,QAAQ,aAAa,OAAO;AAEjD,QAAM,SAAS,uBAAyC,GAAG;AAC3D,MAAI,OAAQ,QAAO;AAEnB,QAAM,WAAW,MAAM,MAAM,KAAK,EAAE,SAAS,EAAE,gBAAgB,mBAAmB,EAAE,CAAC;AACrF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,EAC3F;AAEA,QAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAE1C,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,SAA2B;AAAA,IAC/B,MAAM,KAAK;AAAA,IACX,SAAS,KAAK,UAAU,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,IAAI,CAAC,OAAO;AAAA,MACtD,OAAO,EAAE;AAAA,MACT,UAAU,EAAE;AAAA,MACZ,WAAW,EAAE;AAAA,MACb,WAAW,EAAE;AAAA,MACb,UAAU,YAAY,EAAE,QAAQ;AAAA,IAClC,EAAE;AAAA,EACJ;AAEA,0BAAwB,KAAK,MAAM;AACnC,SAAO;AACT;AAGA,eAAsB,wBACpB,OACA,SACgC;AAChC,MAAI,CAAC,QAAQ,aAAa;AACxB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,MAAM,SAAS,QAAQ,aAAa,EAAE,GAAG,SAAS,MAAM,CAAC;AAE/D,QAAM,SAAS,uBAA8C,GAAG;AAChE,MAAI,OAAQ,QAAO;AAEnB,QAAM,WAAW,MAAM,MAAM,KAAK,EAAE,SAAS,EAAE,gBAAgB,mBAAmB,EAAE,CAAC;AACrF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,EAC3F;AAEA,QAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAE1C,QAAM,SAAgC;AAAA,IACpC,OAAO,KAAK;AAAA,IACZ,WAAW,KAAK;AAAA,IAChB,UAAU,YAAY,KAAK,QAAQ;AAAA,EACrC;AAEA,0BAAwB,KAAK,MAAM;AACnC,SAAO;AACT;;;AClHA,mBAAoC;AAI7B,SAAS,gBAAgB,UAA+B,CAAC,GAAG;AACjE,QAAM,CAAC,MAAM,OAAO,QAAI,uBAAkC,IAAI;AAC9D,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAuB,IAAI;AACrD,QAAM,CAAC,SAAS,UAAU,QAAI,uBAAS,QAAQ,QAAQ,WAAW,CAAC;AAEnE,8BAAU,MAAM;AACd,QAAI,CAAC,QAAQ,aAAa;AACxB,iBAAW,KAAK;AAChB;AAAA,IACF;AAEA,QAAI,SAAS;AACb,eAAW,IAAI;AACf,aAAS,IAAI;AAEb,oBAAgB,OAAO,EACpB,KAAK,CAAC,WAAW;AAAE,UAAI,OAAQ,SAAQ,MAAM;AAAA,IAAG,CAAC,EACjD,MAAM,CAAC,QAAQ;AAAE,UAAI,OAAQ,UAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,eAAe,CAAC;AAAA,IAAG,CAAC,EACjG,QAAQ,MAAM;AAAE,UAAI,OAAQ,YAAW,KAAK;AAAA,IAAG,CAAC;AAEnD,WAAO,MAAM;AAAE,eAAS;AAAA,IAAO;AAAA,EACjC,GAAG,CAAC,QAAQ,aAAa,QAAQ,OAAO,QAAQ,KAAK,CAAC;AAEtD,SAAO,EAAE,MAAM,OAAO,QAAQ;AAChC;;;ACiEQ;AAjFR,IAAM,SAAS;AAAA,EACb,MAAM;AAAA,IACJ,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,aAAa;AAAA,IACX,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,SAAS;AAAA,IACT,cAAc;AAAA,EAChB;AAAA,EACA,eAAe;AAAA,IACb,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,eAAe;AAAA,EACjB;AAAA,EACA,UAAU,EAAE,SAAS,QAAQ,KAAK,IAAI,WAAW,QAAQ,eAAe,EAAE;AAAA,EAC1E,WAAW;AAAA,IACT,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,gBAAgB;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EACA,WAAW;AAAA,IACT,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,cAAc;AAAA,EAChB;AAAA,EACA,UAAU;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,UAAU;AAAA,EACZ;AAAA,EACA,OAAO,EAAE,UAAU,IAAI,SAAS,IAAI;AAAA,EACpC,MAAM,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,GAAG;AAAA,EAC1D,WAAW,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,EAAE;AAAA,EAC9D,iBAAiB,EAAE,SAAS,QAAQ,YAAY,YAAY,KAAK,EAAE;AAAA,EACnE,SAAS,EAAE,UAAU,GAAG;AAAA,EACxB,aAAa,EAAE,OAAO,WAAW,gBAAgB,OAAO;AAC1D;AAQO,SAAS,aAAa,OAAc;AACzC,QAAM,EAAE,WAAW,OAAO,SAAS,YAAY,GAAG,GAAG,QAAQ,IAAI;AACjE,QAAM,EAAE,MAAM,SAAS,MAAM,IAAI,gBAAgB,OAAO;AAExD,MAAI,CAAC,QAAQ,YAAa,QAAO;AACjC,MAAI,WAAW,CAAC,KAAM,QAAO;AAC7B,MAAI,MAAO,QAAO;AAClB,MAAI,CAAC,QAAQ,KAAK,OAAO,WAAW,EAAG,QAAO;AAE9C,QAAM,SAAS,KAAK,OAAO,MAAM,GAAG,SAAS;AAE7C,MAAI,SAAS;AACX,WACE,6CAAC,SAAI,WAAsB,OAAO,EAAE,GAAG,OAAO,aAAa,GAAG,MAAM,GAClE;AAAA,kDAAC,SAAI,OAAO,OAAO,eAAe,sBAAQ;AAAA,MAC1C,4CAAC,SAAI,OAAO,OAAO,UAChB,iBAAO,IAAI,CAAC,UACX;AAAA,QAAC;AAAA;AAAA,UAEC,MAAM,MAAM,SAAS,CAAC,GAAG;AAAA,UACzB,QAAO;AAAA,UACP,KAAI;AAAA,UACJ,OAAO,OAAO;AAAA,UAEd;AAAA,wDAAC,SAAI,OAAO,OAAO,WAAY,gBAAM,OAAM;AAAA,YAC1C,MAAM,SAAS,CAAC,KAAK,4CAAC,SAAI,OAAO,OAAO,UAAW,gBAAM,SAAS,CAAC,EAAE,OAAM;AAAA,YAC5E,6CAAC,SAAI,OAAO,OAAO,OAChB;AAAA,oBAAM;AAAA,cAAU;AAAA,cAAS,MAAM,cAAc,IAAI,KAAK;AAAA,eACzD;AAAA;AAAA;AAAA,QAVK,MAAM;AAAA,MAWb,CACD,GACH;AAAA,OACF;AAAA,EAEJ;AAEA,SACE,4CAAC,SAAI,WAAsB,OAAO,EAAE,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM,GAAG,MAAM,GAC1E,iBAAO,IAAI,CAAC,UACX,6CAAC,SAAsB,OAAO,OAAO,WACnC;AAAA,iDAAC,SAAI,OAAO,OAAO,iBACjB;AAAA,kDAAC,YAAQ,gBAAM,OAAM;AAAA,MACrB,6CAAC,UAAK,OAAO,OAAO,OACjB;AAAA,cAAM;AAAA,QAAU;AAAA,QAAS,MAAM,cAAc,IAAI,KAAK;AAAA,SACzD;AAAA,OACF;AAAA,IACC,MAAM,SAAS,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,MACxC,6CAAC,SAA2B,OAAO,OAAO,SACvC;AAAA,cAAQ,MACP,4CAAC,OAAE,MAAM,QAAQ,KAAK,QAAO,UAAS,KAAI,cAAa,OAAO,OAAO,aAClE,kBAAQ,OACX,IAEA,QAAQ;AAAA,MAET,QAAQ,UAAU,6CAAC,UAAK,OAAO,EAAE,SAAS,IAAI,GAAG;AAAA;AAAA,QAAW,QAAQ;AAAA,SAAO;AAAA,SARpE,QAAQ,OAAO,CASzB,CACD;AAAA,OAlBO,MAAM,KAmBhB,CACD,GACH;AAEJ;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,66 @@
+import React from 'react';
+
+type NewsArticle = {
+    title: string;
+    url?: string;
+    source?: string;
+    publishedAt?: string;
+};
+type TrendingTopic = {
+    topic: string;
+    wikiRank?: number;
+    wikiViews?: number;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+type TrendingNewsData = {
+    date?: string;
+    topics: TrendingTopic[];
+};
+type TrendingNewsTopicData = {
+    topic: string;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+type TrendingNewsOptions = {
+    /** URL of a deployed instance of the bundled Cloudflare Worker (`worker/index.ts`). */
+    apiEndpoint?: string;
+    /** When set, fetches news for this single topic instead of the daily trending list. */
+    topic?: string;
+    /** Max trending topics to request from the worker (default 25). */
+    limit?: number;
+};
+
+/** Clears all cached trending news responses. Mainly useful for tests/debugging. */
+declare function clearTrendingNewsCache(): void;
+
+/**
+ * Fetches trending topics (or, when `options.topic` is set, news for a
+ * single topic) from a deployed instance of `worker/index.ts`.
+ */
+declare function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData>;
+/** Fetches news articles for a single topic. */
+declare function getTrendingNewsForTopic(topic: string, options: Omit<TrendingNewsOptions, 'topic'>): Promise<TrendingNewsTopicData>;
+
+declare function useTrendingNews(options?: TrendingNewsOptions): {
+    data: TrendingNewsData | null;
+    error: Error | null;
+    loading: boolean;
+};
+
+type Props = TrendingNewsOptions & {
+    className?: string;
+    style?: React.CSSProperties;
+    compact?: boolean;
+    /** Max trending topics to render (default 8). */
+    maxTopics?: number;
+};
+/**
+ * Trending news widget. Requires `apiEndpoint` pointing at a deployed
+ * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders
+ * nothing when it's not configured, still loading, or errored, so it never
+ * disrupts the layout it's dropped into.
+ */
+declare function TrendingNews(props: Props): React.JSX.Element | null;
+
+export { type NewsArticle, TrendingNews, type TrendingNewsData, type TrendingNewsOptions, type TrendingNewsTopicData, type TrendingTopic, clearTrendingNewsCache, getTrendingNews, getTrendingNewsForTopic, useTrendingNews };

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import React from 'react';
+
+type NewsArticle = {
+    title: string;
+    url?: string;
+    source?: string;
+    publishedAt?: string;
+};
+type TrendingTopic = {
+    topic: string;
+    wikiRank?: number;
+    wikiViews?: number;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+type TrendingNewsData = {
+    date?: string;
+    topics: TrendingTopic[];
+};
+type TrendingNewsTopicData = {
+    topic: string;
+    newsCount: number;
+    articles: NewsArticle[];
+};
+type TrendingNewsOptions = {
+    /** URL of a deployed instance of the bundled Cloudflare Worker (`worker/index.ts`). */
+    apiEndpoint?: string;
+    /** When set, fetches news for this single topic instead of the daily trending list. */
+    topic?: string;
+    /** Max trending topics to request from the worker (default 25). */
+    limit?: number;
+};
+
+/** Clears all cached trending news responses. Mainly useful for tests/debugging. */
+declare function clearTrendingNewsCache(): void;
+
+/**
+ * Fetches trending topics (or, when `options.topic` is set, news for a
+ * single topic) from a deployed instance of `worker/index.ts`.
+ */
+declare function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData>;
+/** Fetches news articles for a single topic. */
+declare function getTrendingNewsForTopic(topic: string, options: Omit<TrendingNewsOptions, 'topic'>): Promise<TrendingNewsTopicData>;
+
+declare function useTrendingNews(options?: TrendingNewsOptions): {
+    data: TrendingNewsData | null;
+    error: Error | null;
+    loading: boolean;
+};
+
+type Props = TrendingNewsOptions & {
+    className?: string;
+    style?: React.CSSProperties;
+    compact?: boolean;
+    /** Max trending topics to render (default 8). */
+    maxTopics?: number;
+};
+/**
+ * Trending news widget. Requires `apiEndpoint` pointing at a deployed
+ * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders
+ * nothing when it's not configured, still loading, or errored, so it never
+ * disrupts the layout it's dropped into.
+ */
+declare function TrendingNews(props: Props): React.JSX.Element | null;
+
+export { type NewsArticle, TrendingNews, type TrendingNewsData, type TrendingNewsOptions, type TrendingNewsTopicData, type TrendingTopic, clearTrendingNewsCache, getTrendingNews, getTrendingNewsForTopic, useTrendingNews };

package/dist/index.js

@@ -0,0 +1,252 @@
+// src/lib/cache.ts
+var CACHE_PREFIX = "trending-news-cache:";
+var CACHE_TTL_MS = 10 * 60 * 1e3;
+function getStorage() {
+  if (typeof window === "undefined" || !window.localStorage) return null;
+  return window.localStorage;
+}
+function readCachedTrendingNews(key) {
+  const storage = getStorage();
+  if (!storage) return null;
+  try {
+    const raw = storage.getItem(CACHE_PREFIX + key);
+    if (!raw) return null;
+    const entry = JSON.parse(raw);
+    if (Date.now() - entry.timestamp > CACHE_TTL_MS) {
+      storage.removeItem(CACHE_PREFIX + key);
+      return null;
+    }
+    return entry.data;
+  } catch {
+    return null;
+  }
+}
+function writeCachedTrendingNews(key, data) {
+  const storage = getStorage();
+  if (!storage) return;
+  try {
+    const entry = { timestamp: Date.now(), data };
+    storage.setItem(CACHE_PREFIX + key, JSON.stringify(entry));
+  } catch {
+  }
+}
+function clearTrendingNewsCache() {
+  const storage = getStorage();
+  if (!storage) return;
+  for (let i = storage.length - 1; i >= 0; i--) {
+    const key = storage.key(i);
+    if (key?.startsWith(CACHE_PREFIX)) storage.removeItem(key);
+  }
+}
+
+// src/api/trending.ts
+function mapArticles(articles = []) {
+  return articles.map((a) => ({
+    title: a.title ?? "",
+    url: a.url,
+    source: a.source,
+    publishedAt: a.published_at
+  }));
+}
+function buildUrl(apiEndpoint, options) {
+  const url = new URL(apiEndpoint);
+  if (options.topic) url.searchParams.set("topic", options.topic);
+  return url.toString();
+}
+async function getTrendingNews(options) {
+  if (!options.apiEndpoint) {
+    throw new Error("trending-news-api: apiEndpoint is required");
+  }
+  const url = buildUrl(options.apiEndpoint, options);
+  const cached = readCachedTrendingNews(url);
+  if (cached) return cached;
+  const response = await fetch(url, { headers: { "Content-Type": "application/json" } });
+  if (!response.ok) {
+    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);
+  }
+  const data = await response.json();
+  if (data.error) throw new Error(data.error);
+  const limit = options.limit ?? 25;
+  const result = {
+    date: data.date,
+    topics: (data.topics ?? []).slice(0, limit).map((t) => ({
+      topic: t.topic,
+      wikiRank: t.wiki_rank,
+      wikiViews: t.wiki_views,
+      newsCount: t.news_count,
+      articles: mapArticles(t.articles)
+    }))
+  };
+  writeCachedTrendingNews(url, result);
+  return result;
+}
+async function getTrendingNewsForTopic(topic, options) {
+  if (!options.apiEndpoint) {
+    throw new Error("trending-news-api: apiEndpoint is required");
+  }
+  const url = buildUrl(options.apiEndpoint, { ...options, topic });
+  const cached = readCachedTrendingNews(url);
+  if (cached) return cached;
+  const response = await fetch(url, { headers: { "Content-Type": "application/json" } });
+  if (!response.ok) {
+    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);
+  }
+  const data = await response.json();
+  if (data.error) throw new Error(data.error);
+  const result = {
+    topic: data.topic,
+    newsCount: data.news_count,
+    articles: mapArticles(data.articles)
+  };
+  writeCachedTrendingNews(url, result);
+  return result;
+}
+
+// src/hooks/useTrendingNews.ts
+import { useEffect, useState } from "react";
+function useTrendingNews(options = {}) {
+  const [data, setData] = useState(null);
+  const [error, setError] = useState(null);
+  const [loading, setLoading] = useState(Boolean(options.apiEndpoint));
+  useEffect(() => {
+    if (!options.apiEndpoint) {
+      setLoading(false);
+      return;
+    }
+    let active = true;
+    setLoading(true);
+    setError(null);
+    getTrendingNews(options).then((result) => {
+      if (active) setData(result);
+    }).catch((err) => {
+      if (active) setError(err instanceof Error ? err : new Error("Unknown error"));
+    }).finally(() => {
+      if (active) setLoading(false);
+    });
+    return () => {
+      active = false;
+    };
+  }, [options.apiEndpoint, options.topic, options.limit]);
+  return { data, error, loading };
+}
+
+// src/components/TrendingNews.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var styles = {
+  root: {
+    fontFamily: "system-ui, sans-serif",
+    border: "1px solid #e5e7eb",
+    borderRadius: 12,
+    padding: 16,
+    background: "#fff",
+    color: "#111827",
+    maxWidth: 640
+  },
+  compactRoot: {
+    fontFamily: "system-ui, sans-serif",
+    display: "flex",
+    flexDirection: "column",
+    gap: 6,
+    padding: "10px 14px",
+    borderRadius: 8
+  },
+  compactHeader: {
+    fontSize: 11,
+    fontWeight: 600,
+    opacity: 0.75,
+    letterSpacing: 0.3,
+    textTransform: "uppercase"
+  },
+  topicRow: { display: "flex", gap: 10, overflowX: "auto", paddingBottom: 2 },
+  topicCard: {
+    minWidth: 160,
+    maxWidth: 200,
+    padding: "8px 10px",
+    borderRadius: 8,
+    background: "rgba(255,255,255,0.06)",
+    display: "flex",
+    flexDirection: "column",
+    gap: 4,
+    textDecoration: "none",
+    color: "inherit"
+  },
+  topicName: {
+    fontSize: 12,
+    fontWeight: 600,
+    whiteSpace: "nowrap",
+    overflow: "hidden",
+    textOverflow: "ellipsis"
+  },
+  headline: {
+    fontSize: 11,
+    opacity: 0.8,
+    display: "-webkit-box",
+    WebkitLineClamp: 2,
+    WebkitBoxOrient: "vertical",
+    overflow: "hidden"
+  },
+  count: { fontSize: 10, opacity: 0.6 },
+  list: { display: "flex", flexDirection: "column", gap: 16 },
+  fullTopic: { display: "flex", flexDirection: "column", gap: 6 },
+  fullTopicHeader: { display: "flex", alignItems: "baseline", gap: 8 },
+  article: { fontSize: 13 },
+  articleLink: { color: "inherit", textDecoration: "none" }
+};
+function TrendingNews(props) {
+  const { className, style, compact, maxTopics = 8, ...options } = props;
+  const { data, loading, error } = useTrendingNews(options);
+  if (!options.apiEndpoint) return null;
+  if (loading && !data) return null;
+  if (error) return null;
+  if (!data || data.topics.length === 0) return null;
+  const topics = data.topics.slice(0, maxTopics);
+  if (compact) {
+    return /* @__PURE__ */ jsxs("div", { className, style: { ...styles.compactRoot, ...style }, children: [
+      /* @__PURE__ */ jsx("div", { style: styles.compactHeader, children: "Trending" }),
+      /* @__PURE__ */ jsx("div", { style: styles.topicRow, children: topics.map((topic) => /* @__PURE__ */ jsxs(
+        "a",
+        {
+          href: topic.articles[0]?.url,
+          target: "_blank",
+          rel: "noreferrer",
+          style: styles.topicCard,
+          children: [
+            /* @__PURE__ */ jsx("div", { style: styles.topicName, children: topic.topic }),
+            topic.articles[0] && /* @__PURE__ */ jsx("div", { style: styles.headline, children: topic.articles[0].title }),
+            /* @__PURE__ */ jsxs("div", { style: styles.count, children: [
+              topic.newsCount,
+              " article",
+              topic.newsCount === 1 ? "" : "s"
+            ] })
+          ]
+        },
+        topic.topic
+      )) })
+    ] });
+  }
+  return /* @__PURE__ */ jsx("div", { className, style: { ...styles.root, ...styles.list, ...style }, children: topics.map((topic) => /* @__PURE__ */ jsxs("div", { style: styles.fullTopic, children: [
+    /* @__PURE__ */ jsxs("div", { style: styles.fullTopicHeader, children: [
+      /* @__PURE__ */ jsx("strong", { children: topic.topic }),
+      /* @__PURE__ */ jsxs("span", { style: styles.count, children: [
+        topic.newsCount,
+        " article",
+        topic.newsCount === 1 ? "" : "s"
+      ] })
+    ] }),
+    topic.articles.slice(0, 5).map((article, i) => /* @__PURE__ */ jsxs("div", { style: styles.article, children: [
+      article.url ? /* @__PURE__ */ jsx("a", { href: article.url, target: "_blank", rel: "noreferrer", style: styles.articleLink, children: article.title }) : article.title,
+      article.source && /* @__PURE__ */ jsxs("span", { style: { opacity: 0.6 }, children: [
+        " \xB7 ",
+        article.source
+      ] })
+    ] }, article.url ?? i))
+  ] }, topic.topic)) });
+}
+export {
+  TrendingNews,
+  clearTrendingNewsCache,
+  getTrendingNews,
+  getTrendingNewsForTopic,
+  useTrendingNews
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/cache.ts","../src/api/trending.ts","../src/hooks/useTrendingNews.ts","../src/components/TrendingNews.tsx"],"sourcesContent":["const CACHE_PREFIX = 'trending-news-cache:';\nconst CACHE_TTL_MS = 10 * 60 * 1000;\n\ntype CacheEntry<T> = {\n  timestamp: number;\n  data: T;\n};\n\nfunction getStorage(): Storage | null {\n  if (typeof window === 'undefined' || !window.localStorage) return null;\n  return window.localStorage;\n}\n\n/** Returns the cached value for `key` if it was written within the last 10 minutes. */\nexport function readCachedTrendingNews<T>(key: string): T | null {\n  const storage = getStorage();\n  if (!storage) return null;\n\n  try {\n    const raw = storage.getItem(CACHE_PREFIX + key);\n    if (!raw) return null;\n\n    const entry = JSON.parse(raw) as CacheEntry<T>;\n    if (Date.now() - entry.timestamp > CACHE_TTL_MS) {\n      storage.removeItem(CACHE_PREFIX + key);\n      return null;\n    }\n\n    return entry.data;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeCachedTrendingNews<T>(key: string, data: T): void {\n  const storage = getStorage();\n  if (!storage) return;\n\n  try {\n    const entry: CacheEntry<T> = { timestamp: Date.now(), data };\n    storage.setItem(CACHE_PREFIX + key, JSON.stringify(entry));\n  } catch {\n    // Storage full or unavailable (e.g. private browsing) — safe to ignore,\n    // the next call will simply hit the network again.\n  }\n}\n\n/** Clears all cached trending news responses. Mainly useful for tests/debugging. */\nexport function clearTrendingNewsCache(): void {\n  const storage = getStorage();\n  if (!storage) return;\n\n  for (let i = storage.length - 1; i >= 0; i--) {\n    const key = storage.key(i);\n    if (key?.startsWith(CACHE_PREFIX)) storage.removeItem(key);\n  }\n}\n","import type { NewsArticle, TrendingNewsData, TrendingNewsOptions, TrendingNewsTopicData } from '../types';\nimport { readCachedTrendingNews, writeCachedTrendingNews } from '../lib/cache';\n\ntype WorkerArticle = {\n  title?: string;\n  url?: string;\n  source?: string;\n  published_at?: string;\n};\n\ntype WorkerTopic = {\n  topic: string;\n  wiki_rank?: number;\n  wiki_views?: number;\n  news_count: number;\n  articles: WorkerArticle[];\n};\n\ntype WorkerTopicsResponse = {\n  date?: string;\n  topics: WorkerTopic[];\n  error?: string;\n};\n\ntype WorkerTopicResponse = {\n  topic: string;\n  news_count: number;\n  articles: WorkerArticle[];\n  error?: string;\n};\n\nfunction mapArticles(articles: WorkerArticle[] = []): NewsArticle[] {\n  return articles.map((a) => ({\n    title: a.title ?? '',\n    url: a.url,\n    source: a.source,\n    publishedAt: a.published_at,\n  }));\n}\n\nfunction buildUrl(apiEndpoint: string, options: TrendingNewsOptions) {\n  const url = new URL(apiEndpoint);\n  if (options.topic) url.searchParams.set('topic', options.topic);\n  return url.toString();\n}\n\n/**\n * Fetches trending topics (or, when `options.topic` is set, news for a\n * single topic) from a deployed instance of `worker/index.ts`.\n */\nexport async function getTrendingNews(options: TrendingNewsOptions): Promise<TrendingNewsData> {\n  if (!options.apiEndpoint) {\n    throw new Error('trending-news-api: apiEndpoint is required');\n  }\n\n  const url = buildUrl(options.apiEndpoint, options);\n\n  const cached = readCachedTrendingNews<TrendingNewsData>(url);\n  if (cached) return cached;\n\n  const response = await fetch(url, { headers: { 'Content-Type': 'application/json' } });\n  if (!response.ok) {\n    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);\n  }\n\n  const data = (await response.json()) as WorkerTopicsResponse;\n  if (data.error) throw new Error(data.error);\n\n  const limit = options.limit ?? 25;\n  const result: TrendingNewsData = {\n    date: data.date,\n    topics: (data.topics ?? []).slice(0, limit).map((t) => ({\n      topic: t.topic,\n      wikiRank: t.wiki_rank,\n      wikiViews: t.wiki_views,\n      newsCount: t.news_count,\n      articles: mapArticles(t.articles),\n    })),\n  };\n\n  writeCachedTrendingNews(url, result);\n  return result;\n}\n\n/** Fetches news articles for a single topic. */\nexport async function getTrendingNewsForTopic(\n  topic: string,\n  options: Omit<TrendingNewsOptions, 'topic'>\n): Promise<TrendingNewsTopicData> {\n  if (!options.apiEndpoint) {\n    throw new Error('trending-news-api: apiEndpoint is required');\n  }\n\n  const url = buildUrl(options.apiEndpoint, { ...options, topic });\n\n  const cached = readCachedTrendingNews<TrendingNewsTopicData>(url);\n  if (cached) return cached;\n\n  const response = await fetch(url, { headers: { 'Content-Type': 'application/json' } });\n  if (!response.ok) {\n    throw new Error(`Trending news request failed: ${response.status} ${response.statusText}`);\n  }\n\n  const data = (await response.json()) as WorkerTopicResponse;\n  if (data.error) throw new Error(data.error);\n\n  const result: TrendingNewsTopicData = {\n    topic: data.topic,\n    newsCount: data.news_count,\n    articles: mapArticles(data.articles),\n  };\n\n  writeCachedTrendingNews(url, result);\n  return result;\n}\n","import { useEffect, useState } from 'react';\nimport type { TrendingNewsData, TrendingNewsOptions } from '../types';\nimport { getTrendingNews } from '../api/trending';\n\nexport function useTrendingNews(options: TrendingNewsOptions = {}) {\n  const [data, setData] = useState<TrendingNewsData | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n  const [loading, setLoading] = useState(Boolean(options.apiEndpoint));\n\n  useEffect(() => {\n    if (!options.apiEndpoint) {\n      setLoading(false);\n      return;\n    }\n\n    let active = true;\n    setLoading(true);\n    setError(null);\n\n    getTrendingNews(options)\n      .then((result) => { if (active) setData(result); })\n      .catch((err) => { if (active) setError(err instanceof Error ? err : new Error('Unknown error')); })\n      .finally(() => { if (active) setLoading(false); });\n\n    return () => { active = false; };\n  }, [options.apiEndpoint, options.topic, options.limit]);\n\n  return { data, error, loading };\n}\n","import React from 'react';\nimport { useTrendingNews } from '../hooks/useTrendingNews';\nimport type { TrendingNewsOptions } from '../types';\n\ntype Props = TrendingNewsOptions & {\n  className?: string;\n  style?: React.CSSProperties;\n  compact?: boolean;\n  /** Max trending topics to render (default 8). */\n  maxTopics?: number;\n};\n\nconst styles = {\n  root: {\n    fontFamily: 'system-ui, sans-serif',\n    border: '1px solid #e5e7eb',\n    borderRadius: 12,\n    padding: 16,\n    background: '#fff',\n    color: '#111827',\n    maxWidth: 640,\n  } as React.CSSProperties,\n  compactRoot: {\n    fontFamily: 'system-ui, sans-serif',\n    display: 'flex',\n    flexDirection: 'column',\n    gap: 6,\n    padding: '10px 14px',\n    borderRadius: 8,\n  } as React.CSSProperties,\n  compactHeader: {\n    fontSize: 11,\n    fontWeight: 600,\n    opacity: 0.75,\n    letterSpacing: 0.3,\n    textTransform: 'uppercase',\n  } as React.CSSProperties,\n  topicRow: { display: 'flex', gap: 10, overflowX: 'auto', paddingBottom: 2 } as React.CSSProperties,\n  topicCard: {\n    minWidth: 160,\n    maxWidth: 200,\n    padding: '8px 10px',\n    borderRadius: 8,\n    background: 'rgba(255,255,255,0.06)',\n    display: 'flex',\n    flexDirection: 'column',\n    gap: 4,\n    textDecoration: 'none',\n    color: 'inherit',\n  } as React.CSSProperties,\n  topicName: {\n    fontSize: 12,\n    fontWeight: 600,\n    whiteSpace: 'nowrap',\n    overflow: 'hidden',\n    textOverflow: 'ellipsis',\n  } as React.CSSProperties,\n  headline: {\n    fontSize: 11,\n    opacity: 0.8,\n    display: '-webkit-box',\n    WebkitLineClamp: 2,\n    WebkitBoxOrient: 'vertical',\n    overflow: 'hidden',\n  } as React.CSSProperties,\n  count: { fontSize: 10, opacity: 0.6 } as React.CSSProperties,\n  list: { display: 'flex', flexDirection: 'column', gap: 16 } as React.CSSProperties,\n  fullTopic: { display: 'flex', flexDirection: 'column', gap: 6 } as React.CSSProperties,\n  fullTopicHeader: { display: 'flex', alignItems: 'baseline', gap: 8 } as React.CSSProperties,\n  article: { fontSize: 13 } as React.CSSProperties,\n  articleLink: { color: 'inherit', textDecoration: 'none' } as React.CSSProperties,\n};\n\n/**\n * Trending news widget. Requires `apiEndpoint` pointing at a deployed\n * instance of the bundled Cloudflare Worker (`worker/index.ts`) — renders\n * nothing when it's not configured, still loading, or errored, so it never\n * disrupts the layout it's dropped into.\n */\nexport function TrendingNews(props: Props) {\n  const { className, style, compact, maxTopics = 8, ...options } = props;\n  const { data, loading, error } = useTrendingNews(options);\n\n  if (!options.apiEndpoint) return null;\n  if (loading && !data) return null;\n  if (error) return null;\n  if (!data || data.topics.length === 0) return null;\n\n  const topics = data.topics.slice(0, maxTopics);\n\n  if (compact) {\n    return (\n      <div className={className} style={{ ...styles.compactRoot, ...style }}>\n        <div style={styles.compactHeader}>Trending</div>\n        <div style={styles.topicRow}>\n          {topics.map((topic) => (\n            <a\n              key={topic.topic}\n              href={topic.articles[0]?.url}\n              target=\"_blank\"\n              rel=\"noreferrer\"\n              style={styles.topicCard}\n            >\n              <div style={styles.topicName}>{topic.topic}</div>\n              {topic.articles[0] && <div style={styles.headline}>{topic.articles[0].title}</div>}\n              <div style={styles.count}>\n                {topic.newsCount} article{topic.newsCount === 1 ? '' : 's'}\n              </div>\n            </a>\n          ))}\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <div className={className} style={{ ...styles.root, ...styles.list, ...style }}>\n      {topics.map((topic) => (\n        <div key={topic.topic} style={styles.fullTopic}>\n          <div style={styles.fullTopicHeader}>\n            <strong>{topic.topic}</strong>\n            <span style={styles.count}>\n              {topic.newsCount} article{topic.newsCount === 1 ? '' : 's'}\n            </span>\n          </div>\n          {topic.articles.slice(0, 5).map((article, i) => (\n            <div key={article.url ?? i} style={styles.article}>\n              {article.url ? (\n                <a href={article.url} target=\"_blank\" rel=\"noreferrer\" style={styles.articleLink}>\n                  {article.title}\n                </a>\n              ) : (\n                article.title\n              )}\n              {article.source && <span style={{ opacity: 0.6 }}> &middot; {article.source}</span>}\n            </div>\n          ))}\n        </div>\n      ))}\n    </div>\n  );\n}\n"],"mappings":";AAAA,IAAM,eAAe;AACrB,IAAM,eAAe,KAAK,KAAK;AAO/B,SAAS,aAA6B;AACpC,MAAI,OAAO,WAAW,eAAe,CAAC,OAAO,aAAc,QAAO;AAClE,SAAO,OAAO;AAChB;AAGO,SAAS,uBAA0B,KAAuB;AAC/D,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS,QAAO;AAErB,MAAI;AACF,UAAM,MAAM,QAAQ,QAAQ,eAAe,GAAG;AAC9C,QAAI,CAAC,IAAK,QAAO;AAEjB,UAAM,QAAQ,KAAK,MAAM,GAAG;AAC5B,QAAI,KAAK,IAAI,IAAI,MAAM,YAAY,cAAc;AAC/C,cAAQ,WAAW,eAAe,GAAG;AACrC,aAAO;AAAA,IACT;AAEA,WAAO,MAAM;AAAA,EACf,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,wBAA2B,KAAa,MAAe;AACrE,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AAEd,MAAI;AACF,UAAM,QAAuB,EAAE,WAAW,KAAK,IAAI,GAAG,KAAK;AAC3D,YAAQ,QAAQ,eAAe,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,EAC3D,QAAQ;AAAA,EAGR;AACF;AAGO,SAAS,yBAA+B;AAC7C,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,QAAS;AAEd,WAAS,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;AAC5C,UAAM,MAAM,QAAQ,IAAI,CAAC;AACzB,QAAI,KAAK,WAAW,YAAY,EAAG,SAAQ,WAAW,GAAG;AAAA,EAC3D;AACF;;;ACzBA,SAAS,YAAY,WAA4B,CAAC,GAAkB;AAClE,SAAO,SAAS,IAAI,CAAC,OAAO;AAAA,IAC1B,OAAO,EAAE,SAAS;AAAA,IAClB,KAAK,EAAE;AAAA,IACP,QAAQ,EAAE;AAAA,IACV,aAAa,EAAE;AAAA,EACjB,EAAE;AACJ;AAEA,SAAS,SAAS,aAAqB,SAA8B;AACnE,QAAM,MAAM,IAAI,IAAI,WAAW;AAC/B,MAAI,QAAQ,MAAO,KAAI,aAAa,IAAI,SAAS,QAAQ,KAAK;AAC9D,SAAO,IAAI,SAAS;AACtB;AAMA,eAAsB,gBAAgB,SAAyD;AAC7F,MAAI,CAAC,QAAQ,aAAa;AACxB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,MAAM,SAAS,QAAQ,aAAa,OAAO;AAEjD,QAAM,SAAS,uBAAyC,GAAG;AAC3D,MAAI,OAAQ,QAAO;AAEnB,QAAM,WAAW,MAAM,MAAM,KAAK,EAAE,SAAS,EAAE,gBAAgB,mBAAmB,EAAE,CAAC;AACrF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,EAC3F;AAEA,QAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAE1C,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,SAA2B;AAAA,IAC/B,MAAM,KAAK;AAAA,IACX,SAAS,KAAK,UAAU,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,IAAI,CAAC,OAAO;AAAA,MACtD,OAAO,EAAE;AAAA,MACT,UAAU,EAAE;AAAA,MACZ,WAAW,EAAE;AAAA,MACb,WAAW,EAAE;AAAA,MACb,UAAU,YAAY,EAAE,QAAQ;AAAA,IAClC,EAAE;AAAA,EACJ;AAEA,0BAAwB,KAAK,MAAM;AACnC,SAAO;AACT;AAGA,eAAsB,wBACpB,OACA,SACgC;AAChC,MAAI,CAAC,QAAQ,aAAa;AACxB,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,MAAM,SAAS,QAAQ,aAAa,EAAE,GAAG,SAAS,MAAM,CAAC;AAE/D,QAAM,SAAS,uBAA8C,GAAG;AAChE,MAAI,OAAQ,QAAO;AAEnB,QAAM,WAAW,MAAM,MAAM,KAAK,EAAE,SAAS,EAAE,gBAAgB,mBAAmB,EAAE,CAAC;AACrF,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,EAC3F;AAEA,QAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAE1C,QAAM,SAAgC;AAAA,IACpC,OAAO,KAAK;AAAA,IACZ,WAAW,KAAK;AAAA,IAChB,UAAU,YAAY,KAAK,QAAQ;AAAA,EACrC;AAEA,0BAAwB,KAAK,MAAM;AACnC,SAAO;AACT;;;AClHA,SAAS,WAAW,gBAAgB;AAI7B,SAAS,gBAAgB,UAA+B,CAAC,GAAG;AACjE,QAAM,CAAC,MAAM,OAAO,IAAI,SAAkC,IAAI;AAC9D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AACrD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,QAAQ,QAAQ,WAAW,CAAC;AAEnE,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,aAAa;AACxB,iBAAW,KAAK;AAChB;AAAA,IACF;AAEA,QAAI,SAAS;AACb,eAAW,IAAI;AACf,aAAS,IAAI;AAEb,oBAAgB,OAAO,EACpB,KAAK,CAAC,WAAW;AAAE,UAAI,OAAQ,SAAQ,MAAM;AAAA,IAAG,CAAC,EACjD,MAAM,CAAC,QAAQ;AAAE,UAAI,OAAQ,UAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,eAAe,CAAC;AAAA,IAAG,CAAC,EACjG,QAAQ,MAAM;AAAE,UAAI,OAAQ,YAAW,KAAK;AAAA,IAAG,CAAC;AAEnD,WAAO,MAAM;AAAE,eAAS;AAAA,IAAO;AAAA,EACjC,GAAG,CAAC,QAAQ,aAAa,QAAQ,OAAO,QAAQ,KAAK,CAAC;AAEtD,SAAO,EAAE,MAAM,OAAO,QAAQ;AAChC;;;ACiEQ,cAYM,YAZN;AAjFR,IAAM,SAAS;AAAA,EACb,MAAM;AAAA,IACJ,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,cAAc;AAAA,IACd,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,UAAU;AAAA,EACZ;AAAA,EACA,aAAa;AAAA,IACX,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,SAAS;AAAA,IACT,cAAc;AAAA,EAChB;AAAA,EACA,eAAe;AAAA,IACb,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,eAAe;AAAA,EACjB;AAAA,EACA,UAAU,EAAE,SAAS,QAAQ,KAAK,IAAI,WAAW,QAAQ,eAAe,EAAE;AAAA,EAC1E,WAAW;AAAA,IACT,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK;AAAA,IACL,gBAAgB;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EACA,WAAW;AAAA,IACT,UAAU;AAAA,IACV,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,UAAU;AAAA,IACV,cAAc;AAAA,EAChB;AAAA,EACA,UAAU;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,SAAS;AAAA,IACT,iBAAiB;AAAA,IACjB,iBAAiB;AAAA,IACjB,UAAU;AAAA,EACZ;AAAA,EACA,OAAO,EAAE,UAAU,IAAI,SAAS,IAAI;AAAA,EACpC,MAAM,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,GAAG;AAAA,EAC1D,WAAW,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,EAAE;AAAA,EAC9D,iBAAiB,EAAE,SAAS,QAAQ,YAAY,YAAY,KAAK,EAAE;AAAA,EACnE,SAAS,EAAE,UAAU,GAAG;AAAA,EACxB,aAAa,EAAE,OAAO,WAAW,gBAAgB,OAAO;AAC1D;AAQO,SAAS,aAAa,OAAc;AACzC,QAAM,EAAE,WAAW,OAAO,SAAS,YAAY,GAAG,GAAG,QAAQ,IAAI;AACjE,QAAM,EAAE,MAAM,SAAS,MAAM,IAAI,gBAAgB,OAAO;AAExD,MAAI,CAAC,QAAQ,YAAa,QAAO;AACjC,MAAI,WAAW,CAAC,KAAM,QAAO;AAC7B,MAAI,MAAO,QAAO;AAClB,MAAI,CAAC,QAAQ,KAAK,OAAO,WAAW,EAAG,QAAO;AAE9C,QAAM,SAAS,KAAK,OAAO,MAAM,GAAG,SAAS;AAE7C,MAAI,SAAS;AACX,WACE,qBAAC,SAAI,WAAsB,OAAO,EAAE,GAAG,OAAO,aAAa,GAAG,MAAM,GAClE;AAAA,0BAAC,SAAI,OAAO,OAAO,eAAe,sBAAQ;AAAA,MAC1C,oBAAC,SAAI,OAAO,OAAO,UAChB,iBAAO,IAAI,CAAC,UACX;AAAA,QAAC;AAAA;AAAA,UAEC,MAAM,MAAM,SAAS,CAAC,GAAG;AAAA,UACzB,QAAO;AAAA,UACP,KAAI;AAAA,UACJ,OAAO,OAAO;AAAA,UAEd;AAAA,gCAAC,SAAI,OAAO,OAAO,WAAY,gBAAM,OAAM;AAAA,YAC1C,MAAM,SAAS,CAAC,KAAK,oBAAC,SAAI,OAAO,OAAO,UAAW,gBAAM,SAAS,CAAC,EAAE,OAAM;AAAA,YAC5E,qBAAC,SAAI,OAAO,OAAO,OAChB;AAAA,oBAAM;AAAA,cAAU;AAAA,cAAS,MAAM,cAAc,IAAI,KAAK;AAAA,eACzD;AAAA;AAAA;AAAA,QAVK,MAAM;AAAA,MAWb,CACD,GACH;AAAA,OACF;AAAA,EAEJ;AAEA,SACE,oBAAC,SAAI,WAAsB,OAAO,EAAE,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM,GAAG,MAAM,GAC1E,iBAAO,IAAI,CAAC,UACX,qBAAC,SAAsB,OAAO,OAAO,WACnC;AAAA,yBAAC,SAAI,OAAO,OAAO,iBACjB;AAAA,0BAAC,YAAQ,gBAAM,OAAM;AAAA,MACrB,qBAAC,UAAK,OAAO,OAAO,OACjB;AAAA,cAAM;AAAA,QAAU;AAAA,QAAS,MAAM,cAAc,IAAI,KAAK;AAAA,SACzD;AAAA,OACF;AAAA,IACC,MAAM,SAAS,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,MACxC,qBAAC,SAA2B,OAAO,OAAO,SACvC;AAAA,cAAQ,MACP,oBAAC,OAAE,MAAM,QAAQ,KAAK,QAAO,UAAS,KAAI,cAAa,OAAO,OAAO,aAClE,kBAAQ,OACX,IAEA,QAAQ;AAAA,MAET,QAAQ,UAAU,qBAAC,UAAK,OAAO,EAAE,SAAS,IAAI,GAAG;AAAA;AAAA,QAAW,QAAQ;AAAA,SAAO;AAAA,SARpE,QAAQ,OAAO,CASzB,CACD;AAAA,OAlBO,MAAM,KAmBhB,CACD,GACH;AAEJ;","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "trending-news-api",
+  "version": "0.1.0",
+  "description": "React trending news widget backed by Wikipedia pageviews and The News API, via a Cloudflare Worker proxy",
+  "keywords": [
+    "react",
+    "news",
+    "trending",
+    "wikipedia",
+    "thenewsapi",
+    "cloudflare",
+    "component-library"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenSourceAGI/qwksearch-research-agent.git",
+    "directory": "packages/trending-news-api"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20250115.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "jsdom": "^28.1.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "tsup": "^8.2.4",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.18",
+    "wrangler": "^3.88.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "worker:typecheck": "tsc --noEmit -p worker/tsconfig.json",
+    "worker:dev": "wrangler dev --config worker/wrangler.jsonc",
+    "worker:deploy": "wrangler deploy --config worker/wrangler.jsonc"
+  }
+}