@scalemule/news-publication 0.0.9 → 0.0.10

package/dist/index.cjs

@@ -868,6 +868,13 @@ var COOKIE_CATEGORIES = [
         duration: "1 year",
         type: "Local Storage"
       },
+      {
+        name: "news_publication_theme",
+        provider: "First-Party",
+        purpose: "Remembers your reading theme preference (light, dark, or system).",
+        duration: "1 year",
+        type: "HTTP Cookie"
+      },
       {
         name: "audio_narration_speed",
         provider: "First-Party",
@@ -1366,6 +1373,282 @@ function CookieSettingsView({
   ] });
 }
 
+// src/theme.ts
+var THEME_COOKIE = "news_publication_theme";
+var THEME_STORAGE_KEY = "news_publication_theme";
+var THEME_EVENT = "news_publication_theme_change";
+var THEME_MAX_AGE_SECONDS = 365 * 24 * 60 * 60;
+var memoryTheme = "system";
+function getSystemTheme() {
+  if (typeof window === "undefined" || !window.matchMedia) return "light";
+  try {
+    return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+  } catch {
+    return "light";
+  }
+}
+function resolveEffectiveTheme(mode) {
+  if (mode === "system") return getSystemTheme();
+  return mode;
+}
+function getStoredTheme() {
+  if (typeof window === "undefined") return memoryTheme;
+  try {
+    const stored = window.localStorage?.getItem?.(THEME_STORAGE_KEY);
+    if (stored === "light" || stored === "dark" || stored === "system") {
+      memoryTheme = stored;
+      return stored;
+    }
+  } catch {
+  }
+  if (typeof document !== "undefined" && document.cookie) {
+    try {
+      const match = document.cookie.match(new RegExp(`(?:^|; )${THEME_COOKIE}=([^;]*)`));
+      if (match) {
+        const decoded = decodeURIComponent(match[1]);
+        if (decoded === "light" || decoded === "dark" || decoded === "system") {
+          memoryTheme = decoded;
+          return decoded;
+        }
+      }
+    } catch {
+    }
+  }
+  return memoryTheme;
+}
+function applyTheme(mode) {
+  if (typeof document === "undefined") return;
+  try {
+    document.documentElement.setAttribute("data-theme", mode);
+    const elements = document.querySelectorAll(".publication");
+    elements.forEach((el) => el.setAttribute("data-theme", mode));
+  } catch {
+  }
+}
+var memoryListeners = /* @__PURE__ */ new Set();
+function setTheme(mode) {
+  memoryTheme = mode;
+  if (typeof window !== "undefined") {
+    try {
+      window.localStorage?.setItem?.(THEME_STORAGE_KEY, mode);
+    } catch {
+    }
+    if (typeof document !== "undefined") {
+      try {
+        document.cookie = `${THEME_COOKIE}=${encodeURIComponent(mode)}; path=/; max-age=${THEME_MAX_AGE_SECONDS}; SameSite=Lax`;
+      } catch {
+      }
+    }
+    applyTheme(mode);
+    const effective = resolveEffectiveTheme(mode);
+    try {
+      window.dispatchEvent(
+        new CustomEvent(THEME_EVENT, {
+          detail: { mode, effective }
+        })
+      );
+    } catch {
+    }
+  }
+  memoryListeners.forEach((listener) => {
+    try {
+      listener();
+    } catch {
+    }
+  });
+}
+function clearTheme() {
+  memoryTheme = "system";
+  if (typeof document !== "undefined") {
+    try {
+      document.cookie = `${THEME_COOKIE}=; path=/; max-age=0; SameSite=Lax`;
+      document.documentElement.removeAttribute("data-theme");
+    } catch {
+    }
+  }
+  if (typeof window !== "undefined") {
+    try {
+      window.localStorage?.removeItem?.(THEME_STORAGE_KEY);
+    } catch {
+    }
+  }
+  memoryListeners.forEach((listener) => {
+    try {
+      listener();
+    } catch {
+    }
+  });
+}
+function subscribeTheme(listener) {
+  memoryListeners.add(listener);
+  if (typeof window === "undefined") {
+    return () => {
+      memoryListeners.delete(listener);
+    };
+  }
+  const onStorage = (e) => {
+    if (e.key === THEME_STORAGE_KEY) {
+      applyTheme(getStoredTheme());
+      listener();
+    }
+  };
+  const onCustom = () => {
+    listener();
+  };
+  window.addEventListener("storage", onStorage);
+  window.addEventListener(THEME_EVENT, onCustom);
+  let mediaQuery;
+  let onMediaChange;
+  if (window.matchMedia) {
+    try {
+      mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+      onMediaChange = () => {
+        if (getStoredTheme() === "system") {
+          applyTheme("system");
+          listener();
+        }
+      };
+      if (mediaQuery.addEventListener) {
+        mediaQuery.addEventListener("change", onMediaChange);
+      } else if (mediaQuery.addListener) {
+        mediaQuery.addListener(onMediaChange);
+      }
+    } catch {
+    }
+  }
+  return () => {
+    window.removeEventListener("storage", onStorage);
+    window.removeEventListener(THEME_EVENT, onCustom);
+    if (mediaQuery && onMediaChange) {
+      if (mediaQuery.removeEventListener) {
+        mediaQuery.removeEventListener("change", onMediaChange);
+      } else if (mediaQuery.removeListener) {
+        mediaQuery.removeListener(onMediaChange);
+      }
+    }
+  };
+}
+function themeInitScript() {
+  return `(function(){try{var k='${THEME_STORAGE_KEY}',m=localStorage.getItem(k);if(!m){var c=document.cookie.match(/(?:^|; )news_publication_theme=([^;]*)/);m=c?decodeURIComponent(c[1]):'system';}if(m==='light'||m==='dark'||m==='system'){document.documentElement.setAttribute('data-theme',m);}}catch(e){}})();`;
+}
+function SunIcon() {
+  return /* @__PURE__ */ jsxRuntime.jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("circle", { cx: "12", cy: "12", r: "4" }),
+    /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41" })
+  ] });
+}
+function MoonIcon() {
+  return /* @__PURE__ */ jsxRuntime.jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z" }) });
+}
+function SystemIcon() {
+  return /* @__PURE__ */ jsxRuntime.jsxs("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("rect", { width: "20", height: "14", x: "2", y: "3", rx: "2" }),
+    /* @__PURE__ */ jsxRuntime.jsx("line", { x1: "8", x2: "16", y1: "21", y2: "21" }),
+    /* @__PURE__ */ jsxRuntime.jsx("line", { x1: "12", x2: "12", y1: "17", y2: "21" })
+  ] });
+}
+function ThemeToggle({
+  variant = "compact",
+  className = "",
+  showPromotion = false,
+  accountUrl = "/account"
+}) {
+  const currentTheme = react.useSyncExternalStore(subscribeTheme, getStoredTheme, () => "system");
+  const [mounted, setMounted] = react.useState(false);
+  const [promoVisible, setPromoVisible] = react.useState(false);
+  react.useEffect(() => {
+    setMounted(true);
+  }, []);
+  const handleSelect = (mode) => {
+    setTheme(mode);
+    if (showPromotion) {
+      setPromoVisible(true);
+    }
+  };
+  const active = mounted ? currentTheme : "system";
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `pub-theme-toggle-container ${className}`.trim(), children: [
+    /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        className: "pub-theme-toggle",
+        "data-variant": variant,
+        role: "group",
+        "aria-label": "Display theme selection",
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => handleSelect("light"),
+              "aria-pressed": active === "light",
+              "data-active": active === "light",
+              title: "Light theme (broadsheet day edition)",
+              "aria-label": "Light theme",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(SunIcon, {}),
+                variant !== "compact" && /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Light" })
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => handleSelect("dark"),
+              "aria-pressed": active === "dark",
+              "data-active": active === "dark",
+              title: "Dark theme (broadsheet evening edition)",
+              "aria-label": "Dark theme",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(MoonIcon, {}),
+                variant !== "compact" && /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Dark" })
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsxRuntime.jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => handleSelect("system"),
+              "aria-pressed": active === "system",
+              "data-active": active === "system",
+              title: "System preference (matches device setting)",
+              "aria-label": "System theme",
+              children: [
+                /* @__PURE__ */ jsxRuntime.jsx(SystemIcon, {}),
+                variant !== "compact" && /* @__PURE__ */ jsxRuntime.jsx("span", { children: "System" })
+              ]
+            }
+          )
+        ]
+      }
+    ),
+    promoVisible && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "pub-theme-promo", role: "status", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Theme saved for this browser. " }),
+      /* @__PURE__ */ jsxRuntime.jsx("a", { href: accountUrl, children: "Create a free reader account" }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: " to sync preferences across all your devices." }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "button",
+        {
+          type: "button",
+          onClick: () => setPromoVisible(false),
+          "aria-label": "Dismiss note",
+          style: {
+            marginLeft: "8px",
+            background: "none",
+            border: "none",
+            cursor: "pointer",
+            color: "var(--pub-muted)",
+            fontSize: "12px",
+            padding: "0 4px"
+          },
+          children: "\xD7"
+        }
+      )
+    ] })
+  ] });
+}
+
 exports.ANALYTICS_COOKIE = ANALYTICS_COOKIE;
 exports.ANALYTICS_VERSION = ANALYTICS_VERSION;
 exports.BROADSHEET_THEME = BROADSHEET_THEME;
@@ -1387,6 +1670,11 @@ exports.MEET_ACTIVITIES = MEET_ACTIVITIES;
 exports.NEWS_CACHE = NEWS_CACHE;
 exports.NewsError = NewsError;
 exports.SESSION_IDLE_MS = SESSION_IDLE_MS;
+exports.THEME_COOKIE = THEME_COOKIE;
+exports.THEME_EVENT = THEME_EVENT;
+exports.THEME_MAX_AGE_SECONDS = THEME_MAX_AGE_SECONDS;
+exports.THEME_STORAGE_KEY = THEME_STORAGE_KEY;
+exports.ThemeToggle = ThemeToggle;
 exports.UTM_FIELDS = UTM_FIELDS;
 exports.UUID = UUID;
 exports.acceptAllCookies = acceptAllCookies;
@@ -1394,6 +1682,7 @@ exports.acceptRemoteRecord = acceptRemoteRecord;
 exports.acceptSnapshot = acceptSnapshot;
 exports.activeNearby = activeNearby;
 exports.activityLabel = activityLabel;
+exports.applyTheme = applyTheme;
 exports.articleCacheKey = articleCacheKey;
 exports.articleCacheOptions = articleCacheOptions;
 exports.articleMeta = articleMeta;
@@ -1405,6 +1694,7 @@ exports.categoryLabel = categoryLabel;
 exports.classifiedPath = classifiedPath;
 exports.classifiedSearchPath = classifiedSearchPath;
 exports.clearCookieConsent = clearCookieConsent;
+exports.clearTheme = clearTheme;
 exports.clipChars = clipChars;
 exports.composeEdition = composeEdition;
 exports.dealDollars = dealDollars;
@@ -1421,6 +1711,8 @@ exports.feedCacheKey = feedCacheKey;
 exports.feedCacheOptions = feedCacheOptions;
 exports.filterNews = filterNews;
 exports.getCookieConsent = getCookieConsent;
+exports.getStoredTheme = getStoredTheme;
+exports.getSystemTheme = getSystemTheme;
 exports.hasConsented = hasConsented;
 exports.inventoryCacheOptions = inventoryCacheOptions;
 exports.isAdult = isAdult;
@@ -1451,6 +1743,7 @@ exports.recordConsentToCompliance = recordConsentToCompliance;
 exports.referralCode = referralCode;
 exports.rejectOptionalCookies = rejectOptionalCookies;
 exports.resolveCoupon = resolveCoupon;
+exports.resolveEffectiveTheme = resolveEffectiveTheme;
 exports.resolveLayout = resolveLayout;
 exports.revalidateDecision = revalidateDecision;
 exports.screenMessage = screenMessage;
@@ -1459,13 +1752,16 @@ exports.sectionDefinition = sectionDefinition;
 exports.sectionId = sectionId;
 exports.sectionPath = sectionPath;
 exports.setCookieConsent = setCookieConsent;
+exports.setTheme = setTheme;
 exports.shortDeck = shortDeck;
 exports.shortText = shortText;
 exports.shouldServeLastKnown = shouldServeLastKnown;
 exports.snapshotFromRecord = snapshotFromRecord;
 exports.storyDate = storyDate;
 exports.storyTowns = storyTowns;
+exports.subscribeTheme = subscribeTheme;
 exports.syncPublication = syncPublication;
+exports.themeInitScript = themeInitScript;
 exports.townSlug = townSlug;
 exports.validCalendarDate = validCalendarDate;
 exports.walnutCreekTimes = walnutCreekTimes;

package/dist/index.d.cts

@@ -4,6 +4,7 @@ export { M as MEET_ACTIVITIES, a as MeetActivity, b as MeetupInput, P as Prepare
 export { C as CLASSIFIED_CATEGORIES, a as ClassifiedCategory, b as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, P as PreparedClassified, c as PreparedJob, d as PublicDeal, e as PublicDealOffer, f as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-CpGWPbFk.cjs';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.cjs';
 export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-view.cjs';
+export { ThemeToggle, ThemeToggleProps } from './theme-toggle.cjs';
 import 'react';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
@@ -314,4 +315,45 @@ declare function recordConsentToCompliance(record: CookieConsentRecord, options?
     publicationSlug?: string;
 }): Promise<void>;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+type ThemeMode = "light" | "dark" | "system";
+type EffectiveTheme = "light" | "dark";
+declare const THEME_COOKIE = "news_publication_theme";
+declare const THEME_STORAGE_KEY = "news_publication_theme";
+declare const THEME_EVENT = "news_publication_theme_change";
+declare const THEME_MAX_AGE_SECONDS: number;
+/**
+ * Returns the current system color scheme preference.
+ */
+declare function getSystemTheme(): EffectiveTheme;
+/**
+ * Resolves the effective "light" or "dark" appearance from a chosen mode.
+ */
+declare function resolveEffectiveTheme(mode: ThemeMode): EffectiveTheme;
+/**
+ * Reads stored theme mode from localStorage, falling back to cookie, memory, then "system".
+ */
+declare function getStoredTheme(): ThemeMode;
+/**
+ * Applies the given theme mode to documentElement attribute and publication elements.
+ */
+declare function applyTheme(mode: ThemeMode): void;
+/**
+ * Persists the reader's theme mode in memory, localStorage, and cookie,
+ * applies the attribute, and broadcasts an event for other components and browser tabs.
+ */
+declare function setTheme(mode: ThemeMode): void;
+/**
+ * Resets stored theme to "system" and cleans cookies/storage.
+ */
+declare function clearTheme(): void;
+/**
+ * Subscribes to theme changes across in-memory calls, storage events, custom events, and system media queries.
+ */
+declare function subscribeTheme(listener: () => void): () => void;
+/**
+ * Inline JavaScript to inject into <head> to synchronously set data-theme before
+ * any DOM renders, eliminating any Flash of Unstyled Content (FOUC).
+ */
+declare function themeInitScript(): string;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { M as MEET_ACTIVITIES, a as MeetActivity, b as MeetupInput, P as Prepare
 export { C as CLASSIFIED_CATEGORIES, a as ClassifiedCategory, b as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, P as PreparedClassified, c as PreparedJob, d as PublicDeal, e as PublicDealOffer, f as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-CpGWPbFk.js';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.js';
 export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-view.js';
+export { ThemeToggle, ThemeToggleProps } from './theme-toggle.js';
 import 'react';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
@@ -314,4 +315,45 @@ declare function recordConsentToCompliance(record: CookieConsentRecord, options?
     publicationSlug?: string;
 }): Promise<void>;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+type ThemeMode = "light" | "dark" | "system";
+type EffectiveTheme = "light" | "dark";
+declare const THEME_COOKIE = "news_publication_theme";
+declare const THEME_STORAGE_KEY = "news_publication_theme";
+declare const THEME_EVENT = "news_publication_theme_change";
+declare const THEME_MAX_AGE_SECONDS: number;
+/**
+ * Returns the current system color scheme preference.
+ */
+declare function getSystemTheme(): EffectiveTheme;
+/**
+ * Resolves the effective "light" or "dark" appearance from a chosen mode.
+ */
+declare function resolveEffectiveTheme(mode: ThemeMode): EffectiveTheme;
+/**
+ * Reads stored theme mode from localStorage, falling back to cookie, memory, then "system".
+ */
+declare function getStoredTheme(): ThemeMode;
+/**
+ * Applies the given theme mode to documentElement attribute and publication elements.
+ */
+declare function applyTheme(mode: ThemeMode): void;
+/**
+ * Persists the reader's theme mode in memory, localStorage, and cookie,
+ * applies the attribute, and broadcasts an event for other components and browser tabs.
+ */
+declare function setTheme(mode: ThemeMode): void;
+/**
+ * Resets stored theme to "system" and cleans cookies/storage.
+ */
+declare function clearTheme(): void;
+/**
+ * Subscribes to theme changes across in-memory calls, storage events, custom events, and system media queries.
+ */
+declare function subscribeTheme(listener: () => void): () => void;
+/**
+ * Inline JavaScript to inject into <head> to synchronously set data-theme before
+ * any DOM renders, eliminating any Flash of Unstyled Content (FOUC).
+ */
+declare function themeInitScript(): string;
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, type CookieCategory, type CookieCategoryDefinition, type CookieConsentRecord, type CookieDisclosure, type CookiePreferences, CouponOffer, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, HomepageSelection, LAYOUT_COOKIE, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, acceptAllCookies, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearCookieConsent, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getCookieConsent, getStoredTheme, getSystemTheme, hasConsented, inventoryCacheOptions, isCategoryAllowed, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, rejectOptionalCookies, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setCookieConsent, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.js

@@ -1,10 +1,11 @@
+export { THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, ThemeToggle, applyTheme, clearTheme, getStoredTheme, getSystemTheme, resolveEffectiveTheme, setTheme, subscribeTheme, themeInitScript } from './chunk-NQD3M7ZY.js';
 import { definePublication } from './chunk-C7JTEHTH.js';
 export { BROADSHEET_THEME, FEATURE_NAMES, LAYOUT_COOKIE, acceptRemoteRecord, acceptSnapshot, definePublication, featureEnabled, parseSnapshot, publicationFromSnapshot, publicationRecord, resolveLayout, snapshotFromRecord, syncPublication } from './chunk-C7JTEHTH.js';
 export { CLASSIFIED_CATEGORIES, JOB_EMPLOYMENT_TYPES, categoryLabel, classifiedPath, classifiedSearchPath, clipChars, dealDollars, dealGoPath, dealsFeedPath, employmentLabel, isClassifiedCategory, isEmploymentType, jobEmployerBody, jobOpeningBody, jobPostingBody, prepareClassified, prepareJobPost, publicJobPath, publicJobsPath } from './chunk-C7ZPLH2K.js';
 export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup, screenMessage } from './chunk-GB36YM56.js';
-export { CookieConsentBanner } from './chunk-PYCU2T5O.js';
-export { CookieSettingsView } from './chunk-R33MJWND.js';
-export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, acceptAllCookies, clearCookieConsent, getCookieConsent, hasConsented, isCategoryAllowed, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent } from './chunk-TJ7RL3PV.js';
+export { CookieConsentBanner } from './chunk-5QHNNRVQ.js';
+export { CookieSettingsView } from './chunk-AYSBXLOT.js';
+export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, acceptAllCookies, clearCookieConsent, getCookieConsent, hasConsented, isCategoryAllowed, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent } from './chunk-RNXTBN5Z.js';
 
 // src/preset.ts
 var walnutCreekTimes = definePublication({