@scalemule/news-publication 0.0.17 → 0.0.19

package/README.md

@@ -72,3 +72,16 @@ The React front page still lives in the Walnut Creek Times repository. This pack
 ## Versioning
 
 Patch only (`0.0.x` or `0.1.x`) until a stable release is explicitly approved. Publishing is manual: `npm publish` from this directory.
+
+
+### Reporting credit and sources
+
+`ArticleProvenance` renders the public reporting projection: analysis/commentary labels, network and wire credit, and up to five deduplicated source links. It accepts `NewsArticle.metadata` and never renders internal claim mappings, reporter notes or source artifacts. Syndicated commentary keeps its canonical commentary label.
+
+```tsx
+import { ArticleProvenance } from '@scalemule/news-publication'
+
+<ArticleProvenance metadata={article.metadata} />
+```
+
+The component inherits the publication's typography. Optional styling hooks are `article-provenance` and `article-provenance__label`. `readerSources()` is available when an existing publication component owns source-list rendering.

package/dist/index.cjs

@@ -320,11 +320,16 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
     headline: article.title,
     description: article.excerpt ?? void 0,
     datePublished: article.published_at,
-    dateModified: article.updated_at,
+    // updated_at also changes for media/operational maintenance. A trusted
+    // editorial modification timestamp is required before emitting dateModified.
     image: image ? [image] : void 0,
-    mainEntityOfPage: canonicalUrl,
+    mainEntityOfPage: url,
     url,
-    author: { "@type": "Organization", name: authorName || publication.name },
+    ...canonicalUrl !== url ? { isBasedOn: canonicalUrl } : {},
+    articleSection: article.section || void 0,
+    // The publication byline is known to be an organization. Do not infer a
+    // person's identity or classify an untyped external byline as a newsroom.
+    author: { ...!authorName || authorName === publication.name ? { "@type": "Organization" } : {}, name: authorName || publication.name },
     publisher: { "@type": "NewsMediaOrganization", name: publication.name, url: canonical }
   };
 }
@@ -359,17 +364,17 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.seo_title ?? article.title,
+    title: article.title,
     description: article.seo_description ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
+      siteName: publication.name,
       title: article.title,
       description: article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
-      modifiedTime: article.updated_at,
       images: image ? [image] : []
     }
   };
@@ -1759,6 +1764,56 @@ function LocalNetworkBar({ currentSlug, className = "", style }) {
     }
   );
 }
+function ArticleProvenance({ metadata }) {
+  const origin = metadata?.reporting?.canonical_origin || metadata?.editorial_origin;
+  const reporting = metadata?.reporting;
+  const label = origin === "COMMENTARY" ? "Commentary" : origin === "ANALYSIS" ? "Analysis" : null;
+  const sources = readerSources(metadata?.citations);
+  const related = readerSources(reporting?.related_links?.map((url) => ({ url })));
+  const credit = reporting?.credit?.trim();
+  const byline = reporting?.original_byline?.trim();
+  const wire = reporting?.wire_credit?.trim();
+  if (!label && !credit && !byline && !wire && !sources.length && !related.length) return null;
+  return /* @__PURE__ */ jsxRuntime.jsxs("aside", { "aria-label": "About this reporting", className: "article-provenance", children: [
+    label && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "article-provenance__label", children: label }),
+    (credit || byline) && /* @__PURE__ */ jsxRuntime.jsx("p", { children: [credit, byline].filter(Boolean).join(" \xB7 ") }),
+    wire && /* @__PURE__ */ jsxRuntime.jsx("p", { children: wire }),
+    !!sources.length && /* @__PURE__ */ jsxRuntime.jsxs("details", { children: [
+      /* @__PURE__ */ jsxRuntime.jsx("summary", { children: "Sources" }),
+      /* @__PURE__ */ jsxRuntime.jsx("ul", { children: sources.map((source) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsx("a", { href: source.url, rel: "noopener noreferrer", target: "_blank", children: source.title || source.publisher || new URL(source.url).hostname }) }, source.url)) })
+    ] }),
+    !!related.length && /* @__PURE__ */ jsxRuntime.jsxs("details", { children: [
+      /* @__PURE__ */ jsxRuntime.jsx("summary", { children: "Related reporting" }),
+      /* @__PURE__ */ jsxRuntime.jsx("ul", { children: related.map((link) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsxs("a", { href: link.url, rel: "noopener noreferrer", children: [
+        new URL(link.url).hostname,
+        new URL(link.url).pathname
+      ] }) }, link.url)) })
+    ] })
+  ] });
+}
+function readerSources(input) {
+  if (!Array.isArray(input)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const output = [];
+  for (const value of input) {
+    if (!value || typeof value.url !== "string") continue;
+    try {
+      const url = new URL(value.url);
+      if (url.protocol !== "https:" || url.username || url.password || seen.has(url.href)) continue;
+      seen.add(url.href);
+      const text = (raw, limit) => {
+        if (typeof raw !== "string") return void 0;
+        const trimmed = raw.trim();
+        return trimmed ? Array.from(trimmed).slice(0, limit).join("") : void 0;
+      };
+      output.push({ url: url.href, title: text(value.title, 500), publisher: text(value.publisher, 255) });
+      if (output.length === 5) break;
+    } catch {
+      continue;
+    }
+  }
+  return output;
+}
 
 Object.defineProperty(exports, "COOKIE_CONSENT_BACKUP_KEY", {
   enumerable: true,
@@ -1846,6 +1901,7 @@ Object.defineProperty(exports, "setNetworkConsentHub", {
 });
 exports.ANALYTICS_COOKIE = ANALYTICS_COOKIE;
 exports.ANALYTICS_VERSION = ANALYTICS_VERSION;
+exports.ArticleProvenance = ArticleProvenance;
 exports.BROADSHEET_THEME = BROADSHEET_THEME;
 exports.CLASSIFIED_CATEGORIES = CLASSIFIED_CATEGORIES;
 exports.COOKIE_CATEGORIES = COOKIE_CATEGORIES;
@@ -1930,6 +1986,7 @@ exports.publicationFromSnapshot = publicationFromSnapshot;
 exports.publicationJsonLd = publicationJsonLd;
 exports.publicationMeta = publicationMeta;
 exports.publicationRecord = publicationRecord;
+exports.readerSources = readerSources;
 exports.recordConsentToCompliance = recordConsentToCompliance;
 exports.referralCode = referralCode;
 exports.resolveCoupon = resolveCoupon;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-sHgQHuAF.cjs';
-export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-sHgQHuAF.cjs';
+import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-OZFP3-Up.cjs';
+export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-OZFP3-Up.cjs';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-RWmfj3I3.cjs';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a 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-29i5w4LS.cjs';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
@@ -9,7 +9,7 @@ export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-v
 export { ThemeToggle, ThemeToggleProps } from './theme-toggle.cjs';
 export { PublicationNetworkItem, communityPublications, findPublicationByHost, findPublicationBySlug, getNetworkPublicationUrl, listedPublications, localPublications } from './network.cjs';
 export { LocalNetworkBar, LocalNetworkBarProps } from './network-bar.cjs';
-import 'react';
+import * as react from 'react';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;
@@ -146,26 +146,27 @@ declare function storyDate(value: string): string | null;
 /** https URL with no userinfo. Anything else is dropped from public markup. */
 declare function publicHttps(value?: string | null): string | undefined;
 declare function articleUrl(canonical: string, slug: string): string;
-/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+/** Describe the local edition while retaining the designated reporting source. */
 declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
-    "@context": string;
-    "@type": string;
-    headline: string;
-    description: string | undefined;
-    datePublished: string;
-    dateModified: string;
-    image: string[] | undefined;
-    mainEntityOfPage: string;
-    url: string;
+    articleSection: string | undefined;
     author: {
-        "@type": string;
         name: string;
+        "@type"?: string | undefined;
     };
     publisher: {
         "@type": string;
         name: string;
         url: string;
     };
+    isBasedOn?: string | undefined;
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -199,11 +200,11 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
     indexable: boolean;
     openGraph: {
         type: "article";
+        siteName: string;
         title: string;
         description: string | undefined;
         url: string;
         publishedTime: string;
-        modifiedTime: string;
         images: string[];
     };
 };
@@ -292,4 +293,12 @@ declare function subscribeTheme(listener: () => void): () => void;
  */
 declare function themeInitScript(): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+/** A reader projection, never an internal reporting package. */
+declare function ArticleProvenance({ metadata }: Pick<NewsArticle, 'metadata'>): react.JSX.Element | null;
+declare function readerSources(input: unknown): {
+    url: string;
+    title?: string;
+    publisher?: string;
+}[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-sHgQHuAF.js';
-export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-sHgQHuAF.js';
+import { b as PublicationTheme, c as PublicationInput, N as NewsPublication, F as FeatureName, H as HomepageSelection, d as NearbyUpdate, e as NewsItem, E as EditorialSection, f as NewsArticle, C as CouponOffer } from './snapshot-OZFP3-Up.js';
+export { A as ArticleCitation, g as CategoryRef, h as CouponSettings, i as CoverImageMetadata, j as FEATURE_NAMES, k as FeatureFlags, l as NewsFeed, m as NewsLayoutId, n as PublicationModules, o as PublicationRecord, P as PublicationSnapshot, R as ReferralSettings, S as SnapshotHooks, p as StoryDisplay, q as SyncSource, a as SyncedPublication, T as TagRef, r as acceptRemoteRecord, s as acceptSnapshot, t as parseSnapshot, u as publicationFromSnapshot, v as publicationRecord, w as snapshotFromRecord, x as syncPublication } from './snapshot-OZFP3-Up.js';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-RWmfj3I3.js';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a 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-29i5w4LS.js';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
@@ -9,7 +9,7 @@ export { CookieSettingsView, CookieSettingsViewProps } from './cookie-settings-v
 export { ThemeToggle, ThemeToggleProps } from './theme-toggle.js';
 export { PublicationNetworkItem, communityPublications, findPublicationByHost, findPublicationBySlug, getNetworkPublicationUrl, listedPublications, localPublications } from './network.js';
 export { LocalNetworkBar, LocalNetworkBarProps } from './network-bar.js';
-import 'react';
+import * as react from 'react';
 
 /** Walnut Creek Times broadsheet colors. A paper overrides only what it changes. */
 declare const BROADSHEET_THEME: PublicationTheme;
@@ -146,26 +146,27 @@ declare function storyDate(value: string): string | null;
 /** https URL with no userinfo. Anything else is dropped from public markup. */
 declare function publicHttps(value?: string | null): string | undefined;
 declare function articleUrl(canonical: string, slug: string): string;
-/** Same NewsArticle graph Walnut Creek Times emits on an indexable story. */
+/** Describe the local edition while retaining the designated reporting source. */
 declare function newsArticleJsonLd(publication: NewsPublication, article: NewsArticle, canonical: string, authorName?: string | null): {
-    "@context": string;
-    "@type": string;
-    headline: string;
-    description: string | undefined;
-    datePublished: string;
-    dateModified: string;
-    image: string[] | undefined;
-    mainEntityOfPage: string;
-    url: string;
+    articleSection: string | undefined;
     author: {
-        "@type": string;
         name: string;
+        "@type"?: string | undefined;
     };
     publisher: {
         "@type": string;
         name: string;
         url: string;
     };
+    isBasedOn?: string | undefined;
+    "@context": string;
+    "@type": string;
+    headline: string;
+    description: string | undefined;
+    datePublished: string;
+    image: string[] | undefined;
+    mainEntityOfPage: string;
+    url: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -199,11 +200,11 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
     indexable: boolean;
     openGraph: {
         type: "article";
+        siteName: string;
         title: string;
         description: string | undefined;
         url: string;
         publishedTime: string;
-        modifiedTime: string;
         images: string[];
     };
 };
@@ -292,4 +293,12 @@ declare function subscribeTheme(listener: () => void): () => void;
  */
 declare function themeInitScript(): string;
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+/** A reader projection, never an internal reporting package. */
+declare function ArticleProvenance({ metadata }: Pick<NewsArticle, 'metadata'>): react.JSX.Element | null;
+declare function readerSources(input: unknown): {
+    url: string;
+    title?: string;
+    publisher?: string;
+}[];
+
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, type Attribution, BROADSHEET_THEME, COOKIE_CATEGORIES, CouponOffer, 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, activeNearby, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, clearTheme, composeEdition, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveCoupon, resolveEffectiveTheme, resolveLayout, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.js

@@ -7,6 +7,7 @@ export { MEET_ACTIVITIES, activityLabel, canHostMeetup, isAdult, prepareMeetup,
 export { CookieConsentBanner } from './chunk-HTMIFWNA.js';
 export { CookieSettingsView } from './chunk-3MFKPHO3.js';
 export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, communityPublications, decorateNetworkUrl, findPublicationByHost, findPublicationBySlug, getCookieConsent, getNetworkPublicationUrl, hasConsented, isCategoryAllowed, isGeoConsentRequired, listedPublications, localPublications, queryNetworkConsentHub, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from './chunk-2IYYEFLD.js';
+import { jsxs, jsx } from 'react/jsx-runtime';
 
 // src/preset.ts
 var walnutCreekTimes = definePublication({
@@ -255,11 +256,16 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
     headline: article.title,
     description: article.excerpt ?? void 0,
     datePublished: article.published_at,
-    dateModified: article.updated_at,
+    // updated_at also changes for media/operational maintenance. A trusted
+    // editorial modification timestamp is required before emitting dateModified.
     image: image ? [image] : void 0,
-    mainEntityOfPage: canonicalUrl,
+    mainEntityOfPage: url,
     url,
-    author: { "@type": "Organization", name: authorName || publication.name },
+    ...canonicalUrl !== url ? { isBasedOn: canonicalUrl } : {},
+    articleSection: article.section || void 0,
+    // The publication byline is known to be an organization. Do not infer a
+    // person's identity or classify an untyped external byline as a newsroom.
+    author: { ...!authorName || authorName === publication.name ? { "@type": "Organization" } : {}, name: authorName || publication.name },
     publisher: { "@type": "NewsMediaOrganization", name: publication.name, url: canonical }
   };
 }
@@ -294,17 +300,17 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.seo_title ?? article.title,
+    title: article.title,
     description: article.seo_description ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
+      siteName: publication.name,
       title: article.title,
       description: article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
-      modifiedTime: article.updated_at,
       images: image ? [image] : []
     }
   };
@@ -439,5 +445,55 @@ function referralCode(publication, url) {
     return null;
   }
 }
+function ArticleProvenance({ metadata }) {
+  const origin = metadata?.reporting?.canonical_origin || metadata?.editorial_origin;
+  const reporting = metadata?.reporting;
+  const label = origin === "COMMENTARY" ? "Commentary" : origin === "ANALYSIS" ? "Analysis" : null;
+  const sources = readerSources(metadata?.citations);
+  const related = readerSources(reporting?.related_links?.map((url) => ({ url })));
+  const credit = reporting?.credit?.trim();
+  const byline = reporting?.original_byline?.trim();
+  const wire = reporting?.wire_credit?.trim();
+  if (!label && !credit && !byline && !wire && !sources.length && !related.length) return null;
+  return /* @__PURE__ */ jsxs("aside", { "aria-label": "About this reporting", className: "article-provenance", children: [
+    label && /* @__PURE__ */ jsx("p", { className: "article-provenance__label", children: label }),
+    (credit || byline) && /* @__PURE__ */ jsx("p", { children: [credit, byline].filter(Boolean).join(" \xB7 ") }),
+    wire && /* @__PURE__ */ jsx("p", { children: wire }),
+    !!sources.length && /* @__PURE__ */ jsxs("details", { children: [
+      /* @__PURE__ */ jsx("summary", { children: "Sources" }),
+      /* @__PURE__ */ jsx("ul", { children: sources.map((source) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", { href: source.url, rel: "noopener noreferrer", target: "_blank", children: source.title || source.publisher || new URL(source.url).hostname }) }, source.url)) })
+    ] }),
+    !!related.length && /* @__PURE__ */ jsxs("details", { children: [
+      /* @__PURE__ */ jsx("summary", { children: "Related reporting" }),
+      /* @__PURE__ */ jsx("ul", { children: related.map((link) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", { href: link.url, rel: "noopener noreferrer", children: [
+        new URL(link.url).hostname,
+        new URL(link.url).pathname
+      ] }) }, link.url)) })
+    ] })
+  ] });
+}
+function readerSources(input) {
+  if (!Array.isArray(input)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const output = [];
+  for (const value of input) {
+    if (!value || typeof value.url !== "string") continue;
+    try {
+      const url = new URL(value.url);
+      if (url.protocol !== "https:" || url.username || url.password || seen.has(url.href)) continue;
+      seen.add(url.href);
+      const text = (raw, limit) => {
+        if (typeof raw !== "string") return void 0;
+        const trimmed = raw.trim();
+        return trimmed ? Array.from(trimmed).slice(0, limit).join("") : void 0;
+      };
+      output.push({ url: url.href, title: text(value.title, 500), publisher: text(value.publisher, 255) });
+      if (output.length === 5) break;
+    } catch {
+      continue;
+    }
+  }
+  return output;
+}
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, EVENTS, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, composeEdition, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, referralCode, resolveCoupon, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ArticleProvenance, EVENTS, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, composeEdition, defaultRevalidateTargets, displayHeadline, edgeCacheControl, editorialSections, feedCacheKey, feedCacheOptions, filterNews, inventoryCacheOptions, llmsText, matchesStoryTag, nearbyUpdates, newsArticleJsonLd, normalizedText, publicHttps, publicUrl, publicationJsonLd, publicationMeta, readerSources, referralCode, resolveCoupon, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/{snapshot-sHgQHuAF.d.cts → snapshot-OZFP3-Up.d.cts}

@@ -145,6 +145,19 @@ type NewsArticle = NewsItem & {
         duration_ms?: number | null;
     };
     metadata?: {
+        editorial_origin?: 'UNKNOWN' | 'ORIGINAL_REPORTING' | 'DOCUMENT_REPORTING' | 'PRESS_RELEASE_BASED' | 'NEWS_PICKUP' | 'ANALYSIS' | 'COMMENTARY' | 'LICENSED_WIRE' | 'NETWORK_SYNDICATED' | 'COMMUNITY_SUBMISSION';
+        reporting?: {
+            edition_id: string;
+            story_id: string;
+            story_revision: number;
+            originating_publication_id: string;
+            original_byline?: string;
+            credit?: string;
+            related_links?: string[];
+            wire_credit?: string;
+            canonical_origin?: string;
+            origin?: string;
+        };
         cover_image?: CoverImageMetadata;
         citations?: ArticleCitation[];
         resources?: {

package/dist/{snapshot-sHgQHuAF.d.ts → snapshot-OZFP3-Up.d.ts}

@@ -145,6 +145,19 @@ type NewsArticle = NewsItem & {
         duration_ms?: number | null;
     };
     metadata?: {
+        editorial_origin?: 'UNKNOWN' | 'ORIGINAL_REPORTING' | 'DOCUMENT_REPORTING' | 'PRESS_RELEASE_BASED' | 'NEWS_PICKUP' | 'ANALYSIS' | 'COMMENTARY' | 'LICENSED_WIRE' | 'NETWORK_SYNDICATED' | 'COMMUNITY_SUBMISSION';
+        reporting?: {
+            edition_id: string;
+            story_id: string;
+            story_revision: number;
+            originating_publication_id: string;
+            original_byline?: string;
+            credit?: string;
+            related_links?: string[];
+            wire_credit?: string;
+            canonical_origin?: string;
+            origin?: string;
+        };
         cover_image?: CoverImageMetadata;
         citations?: ArticleCitation[];
         resources?: {

package/dist/snapshot-file.d.cts

@@ -1,4 +1,4 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-sHgQHuAF.cjs';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-OZFP3-Up.cjs';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/snapshot-file.d.ts

@@ -1,4 +1,4 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-sHgQHuAF.js';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-OZFP3-Up.js';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "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",
   "main": "./dist/index.cjs",