@scalemule/news-publication 0.0.82 → 0.0.83

package/dist/index.cjs

@@ -829,8 +829,11 @@ var EVENTS = {
   article_shared: browser("engagement"),
   promotion_viewed: browser("content"),
   promotion_clicked: browser("engagement"),
+  newsletter_invitation_viewed: browser("content"),
+  related_stories_viewed: browser("content"),
   newsletter_signup_started: browser("engagement"),
   newsletter_subscription_confirmed: server(),
+  experiment_exposed: browser("system"),
   web_vital_recorded: browser("system"),
   scroll_depth_reached: browser("content"),
   navigation_clicked: browser("navigation"),
@@ -3633,6 +3636,198 @@ function articleFormatLabel(format) {
   return format === "opinion" ? "Opinion" : format === "explainer" ? "Explainer" : format === "interview" ? "Interview" : format === "photo_essay" ? "Photo essay" : format === "video_story" ? "Video story" : void 0;
 }
 
+// src/community-conversion.ts
+var ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+var CELEBRATION_PATTERN = /\b(celebrat(?:e|ion|ions|ing)|wedding|weddings|baby|babies|newborn|quarter[- ]?finals?|milestone|milestones|anniversar(?:y|ies)|graduat(?:e|es|ion|ions)|honor(?:s|ed|ing)?|award(?:s|ed)?|champion|champions|hero(?:es)?|little warrior|birthday)\b/iu;
+var SPONSORED_MARKER_PATTERN = /\b(sponsored|paid post|partner content|advertorial|promoted|brand studio)\b/iu;
+function resolveArticleConversionVariant(assignedVariant, queryOverride) {
+  const candidate = (queryOverride ?? assignedVariant ?? "").trim().toLowerCase();
+  if (candidate === "treatment" || candidate === "inline" || candidate === "b") {
+    return "treatment";
+  }
+  return "control";
+}
+function classifyStoryInvitationCategory(story) {
+  const combinedText = [
+    story.title,
+    story.excerpt ?? "",
+    story.section ?? "",
+    ...(story.tags ?? []).map((t) => t.name),
+    ...(story.categories ?? []).map((c) => c.name)
+  ].join(" ");
+  if (CELEBRATION_PATTERN.test(combinedText)) {
+    return "celebrations";
+  }
+  const section = resolveSection(story);
+  switch (section) {
+    case "Local businesses":
+      return "local_businesses";
+    case "Schools":
+      return "education";
+    case "Events":
+      return "community_events";
+    case "Civic life":
+    case "Real Estate":
+    case "Health":
+      return "neighborhood_news";
+    default:
+      return "community";
+  }
+}
+function contextualCommunityInvitation(story, publication) {
+  const category = classifyStoryInvitationCategory(story);
+  const region = publication.regionLabel.trim() || publication.name.trim();
+  const coverage = publication.coverageText?.trim() || (publication.towns && publication.towns.length > 0 ? publication.towns.slice(0, 3).join(", ") : region);
+  switch (category) {
+    case "celebrations":
+      return {
+        category,
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover more people and milestones worth celebrating.",
+        description: `${region} is full of stories worth celebrating. Discover the people, places, events, and milestones shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "local_businesses":
+      return {
+        category,
+        eyebrow: `${region} Local Businesses`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Meet the entrepreneurs building your community.",
+        description: `Discover the founders, independent shops, places, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More local stories in ${region}`
+      };
+    case "education":
+      return {
+        category,
+        eyebrow: `${region} Schools & Youth`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Follow achievements from local students and schools.",
+        description: `Discover the students, educators, neighborhood milestones, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "community_events":
+      return {
+        category,
+        eyebrow: `${region} Events & Gatherings`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Find something happening near you this weekend.",
+        description: `Discover the people, places, weekend gatherings, and local stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `Happening around ${region}`
+      };
+    case "neighborhood_news":
+      return {
+        category,
+        eyebrow: `${region} Neighborhood Briefing`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Stay informed about changes affecting your neighborhood.",
+        description: `Follow the civic decisions, neighborhood projects, people, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More from ${region}`
+      };
+    case "community":
+    default:
+      return {
+        category: "community",
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover the people, places, and events shaping your community.",
+        description: `Receive local reporting on the people, places, events, and stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+  }
+}
+function isSponsoredStoryItem(item) {
+  const markers = [
+    item.section ?? "",
+    ...(item.tags ?? []).map((t) => `${t.name} ${t.slug}`),
+    ...(item.categories ?? []).map((c) => `${c.name} ${c.slug}`)
+  ].join(" ");
+  return SPONSORED_MARKER_PATTERN.test(markers);
+}
+function normalizedCoverIdentity(item) {
+  const raw = item.cover_image_url?.trim();
+  if (!raw) return null;
+  if (item.visual_identity?.version === 1 && /^[a-f0-9]{64}$/u.test(item.visual_identity.key)) {
+    return `pixels:${item.visual_identity.key}`;
+  }
+  try {
+    const url = new URL(raw);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return null;
+    url.hash = "";
+    url.searchParams.sort();
+    return `url:${url.toString()}`;
+  } catch {
+    return null;
+  }
+}
+function selectRelevantLocalStories(currentStory, candidates, publication, limit = 3) {
+  if (limit <= 0) return [];
+  const currentSection = resolveSection(currentStory);
+  const pubTowns = Array.isArray(publication.towns) ? publication.towns : [];
+  const currentTowns = new Set(storyTowns(currentStory, pubTowns).map((t) => t.toLowerCase()));
+  const currentTags = /* @__PURE__ */ new Set([
+    ...(currentStory.tags ?? []).map((t) => t.name.toLowerCase()),
+    ...(currentStory.categories ?? []).map((c) => c.name.toLowerCase())
+  ]);
+  const primaryRegion = publication.regionLabel.trim().toLowerCase();
+  const seenIds = /* @__PURE__ */ new Set([currentStory.id]);
+  const seenSlugs = /* @__PURE__ */ new Set([currentStory.slug]);
+  const usedCovers = /* @__PURE__ */ new Set();
+  const currentCover = normalizedCoverIdentity(currentStory);
+  if (currentCover) usedCovers.add(currentCover);
+  const scored = candidates.filter((item) => {
+    if (!item?.id || !item?.slug) return false;
+    if (seenIds.has(item.id) || seenSlugs.has(item.slug)) return false;
+    if (isSponsoredStoryItem(item)) return false;
+    return true;
+  }).map((item) => {
+    let score = 0;
+    const cover = normalizedCoverIdentity(item);
+    if (cover) score += 40;
+    const itemTowns = storyTowns(item, pubTowns).map((t) => t.toLowerCase());
+    if (itemTowns.some((t) => currentTowns.has(t))) {
+      score += 25;
+    } else if (primaryRegion && `${item.title} ${item.excerpt ?? ""}`.toLowerCase().includes(primaryRegion)) {
+      score += 18;
+    }
+    const section = resolveSection(item);
+    if (section === currentSection) {
+      score += 20;
+    } else if (["Community", "Events", "Schools", "Local businesses", "Food & places"].includes(section)) {
+      score += 12;
+    }
+    const itemTags = [
+      ...(item.tags ?? []).map((t) => t.name.toLowerCase()),
+      ...(item.categories ?? []).map((c) => c.name.toLowerCase())
+    ];
+    const sharedTags = itemTags.filter((t) => currentTags.has(t)).length;
+    score += Math.min(sharedTags * 8, 16);
+    if (CELEBRATION_PATTERN.test(`${item.title} ${item.excerpt ?? ""}`)) {
+      score += 6;
+    }
+    const parsedTime = Date.parse(item.published_at);
+    const publishedMs = Number.isFinite(parsedTime) ? parsedTime : 0;
+    return { item: { ...item, section }, cover, score, publishedMs };
+  }).sort((a, b) => b.score - a.score || b.publishedMs - a.publishedMs);
+  const selected = [];
+  for (const entry of scored) {
+    if (selected.length >= limit) break;
+    if (seenIds.has(entry.item.id) || seenSlugs.has(entry.item.slug)) continue;
+    if (entry.cover && usedCovers.has(entry.cover)) continue;
+    seenIds.add(entry.item.id);
+    seenSlugs.add(entry.item.slug);
+    if (entry.cover) usedCovers.add(entry.cover);
+    selected.push(entry.item);
+  }
+  return selected;
+}
+
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
   get: function () { return compliance.COOKIE_CONSENT_BACKUP_KEY; }
@@ -3731,6 +3926,7 @@ Object.defineProperty(exports, "setNetworkConsentHub", {
 });
 exports.ANALYTICS_COOKIE = ANALYTICS_COOKIE;
 exports.ANALYTICS_VERSION = ANALYTICS_VERSION;
+exports.ARTICLE_CONVERSION_EXPERIMENT = ARTICLE_CONVERSION_EXPERIMENT;
 exports.ArticleProvenance = ArticleProvenance;
 exports.BROADSHEET_THEME = BROADSHEET_THEME;
 exports.CLASSIFIED_CATEGORIES = CLASSIFIED_CATEGORIES;
@@ -3787,12 +3983,14 @@ exports.canHostMeetup = canHostMeetup;
 exports.categoryLabel = categoryLabel;
 exports.classifiedPath = classifiedPath;
 exports.classifiedSearchPath = classifiedSearchPath;
+exports.classifyStoryInvitationCategory = classifyStoryInvitationCategory;
 exports.clearTheme = clearTheme;
 exports.clipChars = clipChars;
 exports.communityMapEmbeds = communityMapEmbeds;
 exports.communityPublications = communityPublications;
 exports.composeEdition = composeEdition;
 exports.composeLocalBriefing = composeLocalBriefing;
+exports.contextualCommunityInvitation = contextualCommunityInvitation;
 exports.dealDollars = dealDollars;
 exports.dealGoPath = dealGoPath;
 exports.dealsFeedPath = dealsFeedPath;
@@ -3818,6 +4016,7 @@ exports.isAdult = isAdult;
 exports.isClassifiedCategory = isClassifiedCategory;
 exports.isEmploymentType = isEmploymentType;
 exports.isSafeActionUrl = isSafeActionUrl;
+exports.isSponsoredStoryItem = isSponsoredStoryItem;
 exports.jobEmployerBody = jobEmployerBody;
 exports.jobOpeningBody = jobOpeningBody;
 exports.jobPostingBody = jobPostingBody;
@@ -3850,6 +4049,7 @@ exports.readerSources = readerSources;
 exports.recordConsentToCompliance = recordConsentToCompliance;
 exports.referralCode = referralCode;
 exports.renderArticleBlocksToHtml = renderArticleBlocksToHtml;
+exports.resolveArticleConversionVariant = resolveArticleConversionVariant;
 exports.resolveCoupon = resolveCoupon;
 exports.resolveEffectiveTheme = resolveEffectiveTheme;
 exports.resolveLayout = resolveLayout;
@@ -3863,6 +4063,7 @@ exports.secretsMatch = secretsMatch;
 exports.sectionDefinition = sectionDefinition;
 exports.sectionId = sectionId;
 exports.sectionPath = sectionPath;
+exports.selectRelevantLocalStories = selectRelevantLocalStories;
 exports.setTheme = setTheme;
 exports.shortDeck = shortDeck;
 exports.shortText = shortText;

package/dist/index.d.cts

@@ -624,4 +624,54 @@ interface SponsorshipReport {
 /** Shared by the newsroom print/export view and the repeatable PDF renderer. */
 declare function campaignReportHtml(report: SponsorshipReport): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+declare const ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+type ArticleConversionVariant = "control" | "treatment";
+type CommunityInvitationCategory = "celebrations" | "local_businesses" | "education" | "neighborhood_news" | "community_events" | "community";
+interface ContextualCommunityInvitation {
+    category: CommunityInvitationCategory;
+    eyebrow: string;
+    heading: string;
+    subprompt: string;
+    description: string;
+    ctaLabel: string;
+    relatedHeading: string;
+}
+/**
+ * Resolves the `article_conversion_module` experiment variant consistently.
+ * Supports query-parameter preview overrides (`?conversion=treatment` or `?conversion=control`)
+ * before falling back to the assigned ScaleMule flag variant (`"control"` default).
+ */
+declare function resolveArticleConversionVariant(assignedVariant?: string | null, queryOverride?: string | null): ArticleConversionVariant;
+/**
+ * Infers the reader-facing community invitation category from a story's section,
+ * tags, categories, headline, and excerpt.
+ */
+declare function classifyStoryInvitationCategory(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">): CommunityInvitationCategory;
+/**
+ * Builds a publication-aware, category-tailored invitation that connects the reader's
+ * reason for visiting a specific article to staying connected with the local community.
+ */
+interface CommunityInvitationPublicationContext {
+    name: string;
+    regionLabel: string;
+    coverageText?: string;
+    towns?: string[];
+}
+declare function contextualCommunityInvitation(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">, publication: CommunityInvitationPublicationContext): ContextualCommunityInvitation;
+/**
+ * Returns true if a story carries any sponsored, paid, or partner-content markers.
+ * Editorial recommendation slots must never mix unlabeled sponsored items.
+ */
+declare function isSponsoredStoryItem(item: NewsItem): boolean;
+/**
+ * Selects 2–3 relevant local editorial stories for the post-prose Community Conversion Module.
+ *
+ * Rules:
+ * - Never includes the current story or duplicate story IDs/slugs.
+ * - Never includes sponsored/paid items (`isSponsoredStoryItem`).
+ * - Deduplicates cover images so recommended cards never repeat the current story's cover or each other's cover.
+ * - Prioritizes stories with valid cover photographs, shared town/geographic relevance, and community/section affinity.
+ */
+declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -624,4 +624,54 @@ interface SponsorshipReport {
 /** Shared by the newsroom print/export view and the repeatable PDF renderer. */
 declare function campaignReportHtml(report: SponsorshipReport): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, clearTheme, composeEdition, composeLocalBriefing, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+declare const ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+type ArticleConversionVariant = "control" | "treatment";
+type CommunityInvitationCategory = "celebrations" | "local_businesses" | "education" | "neighborhood_news" | "community_events" | "community";
+interface ContextualCommunityInvitation {
+    category: CommunityInvitationCategory;
+    eyebrow: string;
+    heading: string;
+    subprompt: string;
+    description: string;
+    ctaLabel: string;
+    relatedHeading: string;
+}
+/**
+ * Resolves the `article_conversion_module` experiment variant consistently.
+ * Supports query-parameter preview overrides (`?conversion=treatment` or `?conversion=control`)
+ * before falling back to the assigned ScaleMule flag variant (`"control"` default).
+ */
+declare function resolveArticleConversionVariant(assignedVariant?: string | null, queryOverride?: string | null): ArticleConversionVariant;
+/**
+ * Infers the reader-facing community invitation category from a story's section,
+ * tags, categories, headline, and excerpt.
+ */
+declare function classifyStoryInvitationCategory(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">): CommunityInvitationCategory;
+/**
+ * Builds a publication-aware, category-tailored invitation that connects the reader's
+ * reason for visiting a specific article to staying connected with the local community.
+ */
+interface CommunityInvitationPublicationContext {
+    name: string;
+    regionLabel: string;
+    coverageText?: string;
+    towns?: string[];
+}
+declare function contextualCommunityInvitation(story: Pick<NewsItem, "title" | "excerpt" | "section" | "tags" | "categories">, publication: CommunityInvitationPublicationContext): ContextualCommunityInvitation;
+/**
+ * Returns true if a story carries any sponsored, paid, or partner-content markers.
+ * Editorial recommendation slots must never mix unlabeled sponsored items.
+ */
+declare function isSponsoredStoryItem(item: NewsItem): boolean;
+/**
+ * Selects 2–3 relevant local editorial stories for the post-prose Community Conversion Module.
+ *
+ * Rules:
+ * - Never includes the current story or duplicate story IDs/slugs.
+ * - Never includes sponsored/paid items (`isSponsoredStoryItem`).
+ * - Deduplicates cover images so recommended cards never repeat the current story's cover or each other's cover.
+ * - Prioritizes stories with valid cover photographs, shared town/geographic relevance, and community/section affinity.
+ */
+declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.js

@@ -773,8 +773,11 @@ var EVENTS = {
   article_shared: browser("engagement"),
   promotion_viewed: browser("content"),
   promotion_clicked: browser("engagement"),
+  newsletter_invitation_viewed: browser("content"),
+  related_stories_viewed: browser("content"),
   newsletter_signup_started: browser("engagement"),
   newsletter_subscription_confirmed: server(),
+  experiment_exposed: browser("system"),
   web_vital_recorded: browser("system"),
   scroll_depth_reached: browser("content"),
   navigation_clicked: browser("navigation"),
@@ -1020,4 +1023,196 @@ function campaignReportHtml(report) {
   <footer><p>${escape(report.reporting_note)}</p><p>${escape(report.editorial_independence)}</p><p>Campaign reference: ${escape(report.campaign_id)}</p></footer></body></html>`;
 }
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, LOCAL_BRIEFING_POLICY_VERSION, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, composeEdition, composeLocalBriefing, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveCoupon, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+// src/community-conversion.ts
+var ARTICLE_CONVERSION_EXPERIMENT = "article_conversion_module";
+var CELEBRATION_PATTERN = /\b(celebrat(?:e|ion|ions|ing)|wedding|weddings|baby|babies|newborn|quarter[- ]?finals?|milestone|milestones|anniversar(?:y|ies)|graduat(?:e|es|ion|ions)|honor(?:s|ed|ing)?|award(?:s|ed)?|champion|champions|hero(?:es)?|little warrior|birthday)\b/iu;
+var SPONSORED_MARKER_PATTERN = /\b(sponsored|paid post|partner content|advertorial|promoted|brand studio)\b/iu;
+function resolveArticleConversionVariant(assignedVariant, queryOverride) {
+  const candidate = (queryOverride ?? assignedVariant ?? "").trim().toLowerCase();
+  if (candidate === "treatment" || candidate === "inline" || candidate === "b") {
+    return "treatment";
+  }
+  return "control";
+}
+function classifyStoryInvitationCategory(story) {
+  const combinedText = [
+    story.title,
+    story.excerpt ?? "",
+    story.section ?? "",
+    ...(story.tags ?? []).map((t) => t.name),
+    ...(story.categories ?? []).map((c) => c.name)
+  ].join(" ");
+  if (CELEBRATION_PATTERN.test(combinedText)) {
+    return "celebrations";
+  }
+  const section = resolveSection(story);
+  switch (section) {
+    case "Local businesses":
+      return "local_businesses";
+    case "Schools":
+      return "education";
+    case "Events":
+      return "community_events";
+    case "Civic life":
+    case "Real Estate":
+    case "Health":
+      return "neighborhood_news";
+    default:
+      return "community";
+  }
+}
+function contextualCommunityInvitation(story, publication) {
+  const category = classifyStoryInvitationCategory(story);
+  const region = publication.regionLabel.trim() || publication.name.trim();
+  const coverage = publication.coverageText?.trim() || (publication.towns && publication.towns.length > 0 ? publication.towns.slice(0, 3).join(", ") : region);
+  switch (category) {
+    case "celebrations":
+      return {
+        category,
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover more people and milestones worth celebrating.",
+        description: `${region} is full of stories worth celebrating. Discover the people, places, events, and milestones shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "local_businesses":
+      return {
+        category,
+        eyebrow: `${region} Local Businesses`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Meet the entrepreneurs building your community.",
+        description: `Discover the founders, independent shops, places, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More local stories in ${region}`
+      };
+    case "education":
+      return {
+        category,
+        eyebrow: `${region} Schools & Youth`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Follow achievements from local students and schools.",
+        description: `Discover the students, educators, neighborhood milestones, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+    case "community_events":
+      return {
+        category,
+        eyebrow: `${region} Events & Gatherings`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Find something happening near you this weekend.",
+        description: `Discover the people, places, weekend gatherings, and local stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `Happening around ${region}`
+      };
+    case "neighborhood_news":
+      return {
+        category,
+        eyebrow: `${region} Neighborhood Briefing`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Stay informed about changes affecting your neighborhood.",
+        description: `Follow the civic decisions, neighborhood projects, people, and events shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More from ${region}`
+      };
+    case "community":
+    default:
+      return {
+        category: "community",
+        eyebrow: `${region} Community`,
+        heading: `Stay connected to ${region}`,
+        subprompt: "Discover the people, places, and events shaping your community.",
+        description: `Receive local reporting on the people, places, events, and stories shaping ${coverage}.`,
+        ctaLabel: "Subscribe",
+        relatedHeading: `More stories from ${region}`
+      };
+  }
+}
+function isSponsoredStoryItem(item) {
+  const markers = [
+    item.section ?? "",
+    ...(item.tags ?? []).map((t) => `${t.name} ${t.slug}`),
+    ...(item.categories ?? []).map((c) => `${c.name} ${c.slug}`)
+  ].join(" ");
+  return SPONSORED_MARKER_PATTERN.test(markers);
+}
+function normalizedCoverIdentity(item) {
+  const raw = item.cover_image_url?.trim();
+  if (!raw) return null;
+  if (item.visual_identity?.version === 1 && /^[a-f0-9]{64}$/u.test(item.visual_identity.key)) {
+    return `pixels:${item.visual_identity.key}`;
+  }
+  try {
+    const url = new URL(raw);
+    if (url.protocol !== "https:" && url.protocol !== "http:") return null;
+    url.hash = "";
+    url.searchParams.sort();
+    return `url:${url.toString()}`;
+  } catch {
+    return null;
+  }
+}
+function selectRelevantLocalStories(currentStory, candidates, publication, limit = 3) {
+  if (limit <= 0) return [];
+  const currentSection = resolveSection(currentStory);
+  const pubTowns = Array.isArray(publication.towns) ? publication.towns : [];
+  const currentTowns = new Set(storyTowns(currentStory, pubTowns).map((t) => t.toLowerCase()));
+  const currentTags = /* @__PURE__ */ new Set([
+    ...(currentStory.tags ?? []).map((t) => t.name.toLowerCase()),
+    ...(currentStory.categories ?? []).map((c) => c.name.toLowerCase())
+  ]);
+  const primaryRegion = publication.regionLabel.trim().toLowerCase();
+  const seenIds = /* @__PURE__ */ new Set([currentStory.id]);
+  const seenSlugs = /* @__PURE__ */ new Set([currentStory.slug]);
+  const usedCovers = /* @__PURE__ */ new Set();
+  const currentCover = normalizedCoverIdentity(currentStory);
+  if (currentCover) usedCovers.add(currentCover);
+  const scored = candidates.filter((item) => {
+    if (!item?.id || !item?.slug) return false;
+    if (seenIds.has(item.id) || seenSlugs.has(item.slug)) return false;
+    if (isSponsoredStoryItem(item)) return false;
+    return true;
+  }).map((item) => {
+    let score = 0;
+    const cover = normalizedCoverIdentity(item);
+    if (cover) score += 40;
+    const itemTowns = storyTowns(item, pubTowns).map((t) => t.toLowerCase());
+    if (itemTowns.some((t) => currentTowns.has(t))) {
+      score += 25;
+    } else if (primaryRegion && `${item.title} ${item.excerpt ?? ""}`.toLowerCase().includes(primaryRegion)) {
+      score += 18;
+    }
+    const section = resolveSection(item);
+    if (section === currentSection) {
+      score += 20;
+    } else if (["Community", "Events", "Schools", "Local businesses", "Food & places"].includes(section)) {
+      score += 12;
+    }
+    const itemTags = [
+      ...(item.tags ?? []).map((t) => t.name.toLowerCase()),
+      ...(item.categories ?? []).map((c) => c.name.toLowerCase())
+    ];
+    const sharedTags = itemTags.filter((t) => currentTags.has(t)).length;
+    score += Math.min(sharedTags * 8, 16);
+    if (CELEBRATION_PATTERN.test(`${item.title} ${item.excerpt ?? ""}`)) {
+      score += 6;
+    }
+    const parsedTime = Date.parse(item.published_at);
+    const publishedMs = Number.isFinite(parsedTime) ? parsedTime : 0;
+    return { item: { ...item, section }, cover, score, publishedMs };
+  }).sort((a, b) => b.score - a.score || b.publishedMs - a.publishedMs);
+  const selected = [];
+  for (const entry of scored) {
+    if (selected.length >= limit) break;
+    if (seenIds.has(entry.item.id) || seenSlugs.has(entry.item.slug)) continue;
+    if (entry.cover && usedCovers.has(entry.cover)) continue;
+    seenIds.add(entry.item.id);
+    seenSlugs.add(entry.item.slug);
+    if (entry.cover) usedCovers.add(entry.cover);
+    selected.push(entry.item);
+  }
+  return selected;
+}
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, ArticleProvenance, EDITORIAL_SECTION_ORDER, EVENTS, LOCAL_BRIEFING_POLICY_VERSION, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.82",
+  "version": "0.0.83",
   "description": "Shared server framework for ScaleMule local news publications. Walnut Creek Times is the broadsheet default; each paper supplies its own identity and feature flags.",
   "type": "module",
   "bin": {

package/tokens/broadsheet.css

@@ -508,12 +508,15 @@
   .publication [class*="sectionCollection"] > [class*="section"]:only-child [class*="sectionFeature"],
   .publication [class*="sectionCollection"] > [class*="section"]:last-child:nth-child(odd) [class*="sectionFeature"] {
     display: block;
+    grid-column: auto;
+    grid-row: auto;
   }
 
   .publication [class*="sectionCollection"] > [class*="section"]:only-child [class*="sectionSupporting"],
   .publication [class*="sectionCollection"] > [class*="section"]:last-child:nth-child(odd) [class*="sectionSupporting"] {
     display: grid;
-    grid-template-columns: minmax(0, 1fr);
+    grid-column: auto;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
     gap: 20px;
     align-content: start;
   }