@scalemule/news-publication 0.0.57 → 0.0.60

package/dist/{chunk-3HPE2Y7V.js → chunk-7HXSQY4T.js}

@@ -512,9 +512,28 @@ function SponsorAcknowledgment2({
     /* @__PURE__ */ jsx("small", { children: "Paid community sponsorship. Sponsorship does not influence editorial selections and is not an endorsement." })
   ] });
 }
+var DEFAULT_COVER = {
+  url: "https://cdn-public.scalemule.com/01a1382e-6aff-7091-a757-12433a04eed1/anonymous/photos/01a13b52-a168-7131-90f6-a216dbe8dc3b/w800_h0_scaledown_q85_webp.webp",
+  alt: "A white Labrador retriever resting on a sunlit lawn",
+  credit: "Boyko Mihaylov"
+};
+function safeCoverUrl(url) {
+  if (!url || !/^https:\/\/[^\s"\\]+$/.test(url)) return null;
+  try {
+    return new URL(url).protocol === "https:" ? url : null;
+  } catch {
+    return null;
+  }
+}
+function resolveCover(cover) {
+  if (!cover || !safeCoverUrl(cover.url) || !cover.alt || !cover.credit)
+    return DEFAULT_COVER;
+  return cover;
+}
 function PetsSection({
   name = "Bay Area Paw",
   tagline = "Happier pets. Closer communities.",
+  coverPhoto,
   community,
   communities,
   resources,
@@ -533,6 +552,8 @@ function PetsSection({
   eventsUrl,
   accountUrl
 }) {
+  const cover = resolveCover(coverPhoto);
+  const coverCreditUrl = safeCoverUrl(cover.credit_url);
   const location = community?.name || regionLabel || "the Bay Area";
   const link = (id) => `${resourceBasePath || basePath}/${encodeURIComponent(id)}`;
   const local = (id) => communities.find((c) => c.id === id)?.name || "Our community";
@@ -636,10 +657,15 @@ function PetsSection({
           "div",
           {
             role: "img",
-            "aria-label": "A white Labrador retriever resting on a sunlit lawn"
+            "aria-label": cover.alt,
+            style: { backgroundImage: `url("${cover.url}")` }
           }
         ),
-        /* @__PURE__ */ jsx("figcaption", { children: "Cover photograph by Boyko Mihaylov" })
+        /* @__PURE__ */ jsxs("figcaption", { children: [
+          "Cover photograph by",
+          " ",
+          coverCreditUrl ? /* @__PURE__ */ jsx("a", { href: coverCreditUrl, rel: "noopener noreferrer", children: cover.credit }) : cover.credit
+        ] })
       ] })
     ] }),
     !unavailable && /* @__PURE__ */ jsxs("nav", { className: "paw-shortcuts", "aria-label": "Useful pet resources", children: [

package/dist/index.cjs

@@ -633,6 +633,156 @@ function defaultRevalidateTargets() {
   };
 }
 
+// src/navigation.ts
+var NAVIGATION_GROUPS = [
+  { id: "news-knowledge", label: "News & knowledge" },
+  { id: "local-life", label: "Local life" },
+  { id: "marketplace", label: "Marketplace" },
+  { id: "publication", label: "Publication" }
+];
+function editorial(id, section, overrides = {}) {
+  return {
+    id,
+    section,
+    kind: "editorial",
+    label: sectionDefinition(section).label,
+    href: sectionPath(section),
+    order: 0,
+    priority: 0,
+    ...overrides
+  };
+}
+var NETWORK_NAVIGATION = [
+  // Primary editorial row. "News" is the Civic life desk; the section slug and story classifications are unchanged.
+  editorial("news", "Civic life", { label: "News", order: 10, priority: 100, primary: true }),
+  editorial("community", "Community", { order: 20, priority: 90, primary: true }),
+  editorial("food-drink", "Food & places", { order: 30, priority: 85, primary: true }),
+  editorial("things-to-do", "Events", { order: 40, priority: 80, primary: true }),
+  editorial("health", "Health", { order: 50, priority: 75, primary: true }),
+  editorial("real-estate", "Real Estate", { order: 60, priority: 70, primary: true }),
+  { id: "autos", label: "Autos", href: "/autos", kind: "marketplace", group: "marketplace", order: 65, priority: 65, primary: true, more: true, enabled: false },
+  editorial("business", "Local businesses", { order: 70, priority: 60, primary: true }),
+  { id: "meet", label: "Meet", href: "/meet", kind: "product", order: 80, priority: 50, primary: true, feature: "chat" },
+  { id: "jokes", label: "Jokes", href: "/smile", kind: "product", order: 90, priority: 40, primary: true, feature: "smile" },
+  // More — News & knowledge.
+  editorial("ai-technology", "AI & Technology", { label: "AI & technology", group: "news-knowledge", order: 10, more: true }),
+  editorial("schools", "Schools", { label: "Schools & education", group: "news-knowledge", order: 20, more: true }),
+  editorial("civic-life", "Civic life", { group: "news-knowledge", order: 30, more: true }),
+  editorial("environment", "Environment", { group: "news-knowledge", order: 40, more: true }),
+  editorial("transportation", "Transportation", { group: "news-knowledge", order: 50, more: true }),
+  // More — Local life.
+  { id: "pets", label: "Pets", href: "/pets", kind: "product", group: "local-life", order: 10, more: true },
+  { id: "celebrations", label: "Celebrations", href: "/sections/celebrations", kind: "product", group: "local-life", order: 20, more: true, enabled: false },
+  { id: "community-maps", label: "Community maps", href: "/community-maps", kind: "product", group: "local-life", order: 30, more: true },
+  { id: "town-chat", label: "Town chat", href: "/chat", kind: "product", group: "local-life", order: 40, more: true, feature: "chat" },
+  { id: "neighborhood-guides", label: "Neighborhood guides", href: "/guides", kind: "product", group: "local-life", order: 50, more: true, enabled: false },
+  { id: "poll", label: "Poll", href: "/polls", kind: "product", group: "local-life", order: 60, more: true, publications: ["walnutcreektimes"] },
+  // More — Marketplace.
+  { id: "jobs", label: "Jobs", href: "/jobs", kind: "marketplace", group: "marketplace", order: 10, more: true, feature: "jobs" },
+  { id: "classifieds", label: "Classifieds", href: "/classifieds", kind: "marketplace", group: "marketplace", order: 20, more: true, feature: "classifieds" },
+  { id: "local-services", label: "Local services", href: "/services", kind: "marketplace", group: "marketplace", order: 40, more: true, enabled: false },
+  // More — Publication.
+  { id: "latest", label: "Latest", href: "/news", kind: "publication", group: "publication", order: 10, more: true },
+  { id: "this-week", label: "This week", href: "/this-week", kind: "publication", group: "publication", order: 20, more: true },
+  { id: "newsletter", label: "Newsletter", href: "/newsletter", kind: "publication", group: "publication", order: 30, more: true },
+  { id: "about", label: "About", href: "/about", kind: "publication", group: "publication", order: 40, more: true },
+  { id: "advertise", label: "Advertise", href: "/advertise", kind: "publication", group: "publication", order: 50, more: true },
+  { id: "contact", label: "Contact", href: "/contact", kind: "publication", group: "publication", order: 60, more: true }
+];
+var MAX_LABEL = 60;
+function safeHref(href) {
+  if (typeof href !== "string") return null;
+  const value = href.trim();
+  if (!value.startsWith("/") || value.startsWith("//") || /[\s\\]/.test(value)) return null;
+  return value;
+}
+function safeLabel(label) {
+  if (typeof label !== "string") return null;
+  const value = label.trim();
+  return value && value.length <= MAX_LABEL ? value : null;
+}
+var GROUP_IDS = new Set(NAVIGATION_GROUPS.map((group) => group.id));
+var KINDS = /* @__PURE__ */ new Set(["editorial", "product", "marketplace", "publication"]);
+function applyNavigationConfig(defaults, config) {
+  const merged = new Map(defaults.map((destination) => [destination.id, { ...destination }]));
+  for (const override of config?.destinations ?? []) {
+    if (!override || typeof override.id !== "string" || !override.id) continue;
+    const current = merged.get(override.id);
+    const label = safeLabel(override.label);
+    const href = safeHref(override.href);
+    if (!current && !(label && href)) continue;
+    const next = current ? { ...current } : {
+      id: override.id,
+      label,
+      href,
+      kind: "product",
+      order: 1e3,
+      priority: 0
+    };
+    if (label) next.label = label;
+    if (href) next.href = href;
+    if (typeof override.order === "number" && Number.isFinite(override.order)) next.order = override.order;
+    if (typeof override.priority === "number" && Number.isFinite(override.priority)) next.priority = override.priority;
+    if (typeof override.enabled === "boolean") next.enabled = override.enabled;
+    if (typeof override.primary === "boolean") next.primary = override.primary;
+    if (typeof override.more === "boolean") next.more = override.more;
+    if (override.group && GROUP_IDS.has(override.group)) next.group = override.group;
+    if (override.kind && KINDS.has(override.kind)) next.kind = override.kind;
+    if (typeof override.section === "string") next.section = override.section;
+    if (typeof override.feature === "string") next.feature = override.feature;
+    if (Array.isArray(override.publications)) next.publications = override.publications.filter((slug) => typeof slug === "string");
+    merged.set(next.id, next);
+  }
+  return Array.from(merged.values());
+}
+function activeFeatured(config, now) {
+  if (config?.featured === null) return null;
+  const featured = config?.featured;
+  if (!featured) return void 0;
+  const label = safeLabel(featured.label);
+  const href = safeHref(featured.href);
+  if (!label || !href) return void 0;
+  const time = now.getTime();
+  if (featured.from && time < Date.parse(featured.from)) return void 0;
+  if (featured.until && time >= Date.parse(featured.until)) return void 0;
+  return { label, href };
+}
+function resolveNavigation(context) {
+  const now = context.now ?? /* @__PURE__ */ new Date();
+  const sections2 = /* @__PURE__ */ new Set([...context.sections ?? [], ...context.discovered ?? []]);
+  const featureEnabled2 = context.featureEnabled ?? (() => false);
+  const destinations = applyNavigationConfig(NETWORK_NAVIGATION, context.config);
+  const visible = destinations.filter((destination) => {
+    if (destination.enabled === false) return false;
+    if (destination.feature && !featureEnabled2(destination.feature)) return false;
+    if (destination.section && !sections2.has(destination.section)) return false;
+    if (destination.publications && !destination.publications.includes(context.publication)) return false;
+    return true;
+  });
+  const link = (destination) => ({
+    id: destination.id,
+    label: destination.label,
+    href: destination.href,
+    kind: destination.kind,
+    priority: destination.priority ?? 0
+  });
+  const byOrder = (left, right) => left.order - right.order || left.label.localeCompare(right.label);
+  const primary = visible.filter((destination) => destination.primary).sort(byOrder).map(link);
+  const covered = new Set(destinations.map((destination) => destination.section).filter(Boolean));
+  const stray = [...new Set(context.discovered ?? [])].filter((name) => name !== "Local news" && !covered.has(name)).sort((left, right) => left.localeCompare(right)).map((name) => {
+    const definition = sectionDefinition(name);
+    return { id: definition.id, label: definition.label, href: sectionPath(name), kind: "editorial", priority: 0 };
+  });
+  const groups = NAVIGATION_GROUPS.map((group) => ({
+    ...group,
+    links: [
+      ...visible.filter((destination) => destination.more && destination.group === group.id).sort(byOrder).map(link),
+      ...group.id === "news-knowledge" ? stray : []
+    ]
+  })).filter((group) => group.links.length > 0);
+  return { primary, groups, featured: activeFeatured(context.config, now) };
+}
+
 // src/analytics.ts
 var ANALYTICS_VERSION = 1;
 var ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -3464,6 +3614,8 @@ exports.LAYOUT_COOKIE = LAYOUT_COOKIE;
 exports.LOCAL_BRIEFING_POLICY_VERSION = LOCAL_BRIEFING_POLICY_VERSION;
 exports.LocalNetworkBar = LocalNetworkBar;
 exports.MEET_ACTIVITIES = MEET_ACTIVITIES;
+exports.NAVIGATION_GROUPS = NAVIGATION_GROUPS;
+exports.NETWORK_NAVIGATION = NETWORK_NAVIGATION;
 exports.NETWORK_PARENT = NETWORK_PARENT;
 exports.NEWS_CACHE = NEWS_CACHE;
 exports.NetworkCopyrightNotice = NetworkCopyrightNotice;
@@ -3484,6 +3636,7 @@ exports.acceptRemoteRecord = acceptRemoteRecord;
 exports.acceptSnapshot = acceptSnapshot;
 exports.activeNearby = activeNearby;
 exports.activityLabel = activityLabel;
+exports.applyNavigationConfig = applyNavigationConfig;
 exports.applyTheme = applyTheme;
 exports.articleCacheKey = articleCacheKey;
 exports.articleCacheOptions = articleCacheOptions;
@@ -3562,6 +3715,7 @@ exports.renderArticleBlocksToHtml = renderArticleBlocksToHtml;
 exports.resolveCoupon = resolveCoupon;
 exports.resolveEffectiveTheme = resolveEffectiveTheme;
 exports.resolveLayout = resolveLayout;
+exports.resolveNavigation = resolveNavigation;
 exports.resolveSection = resolveSection;
 exports.revalidateDecision = revalidateDecision;
 exports.safeSponsorUrl = safeSponsorUrl;

package/dist/index.d.cts

@@ -274,6 +274,113 @@ declare function nearbyUpdates(items: NewsItem[], selection?: HomepageSelection,
 declare function shortDeck(value: string | null | undefined, limit?: number): string;
 declare function storyDate(value: string): string | null;
 
+/**
+ * Shared network navigation.
+ *
+ * One configuration drives the primary row, the More menu and the hamburger
+ * directory on every Bay Area News Network paper. The defaults below ship in
+ * this package; day-to-day changes (labels, order, enabling Autos, a featured
+ * seasonal destination) are `NavigationConfig` overrides stored in each
+ * paper's site record and picked up at request time — no release required.
+ */
+/** Editorial sections, community products and marketplaces stay distinct in config even where readers see one row. */
+type NavigationKind = "editorial" | "product" | "marketplace" | "publication";
+type NavigationGroup = "news-knowledge" | "local-life" | "marketplace" | "publication";
+declare const NAVIGATION_GROUPS: {
+    id: NavigationGroup;
+    label: string;
+}[];
+type NavigationDestination = {
+    /** Stable identifier; overrides and additions merge by id. */
+    id: string;
+    label: string;
+    href: string;
+    kind: NavigationKind;
+    /** More-menu column; destinations without a group never render in More. */
+    group?: NavigationGroup;
+    /** Reading order inside the primary row and inside each More group. */
+    order: number;
+    /** Responsive weight: when the row runs out of width, lower priority collapses into More first. */
+    priority?: number;
+    /** Renders in the primary editorial row. */
+    primary?: boolean;
+    /** Renders in its group inside the More menu. */
+    more?: boolean;
+    /** Hidden everywhere until enabled (default true). */
+    enabled?: boolean;
+    /** Publication feature flag that must be on (e.g. "jobs", "chat", "smile", "classifieds"). */
+    feature?: string;
+    /** Canonical section name: shown only when the publication configures or publishes the section. */
+    section?: string;
+    /** Restricts the destination to the listed publication slugs. */
+    publications?: string[];
+};
+/** Record-stored delta applied over the shipped defaults. Unknown ids with a label and href are additions. */
+type NavigationOverride = {
+    id: string;
+} & Partial<Omit<NavigationDestination, "id">>;
+type FeaturedDestination = {
+    label: string;
+    href: string;
+    /** ISO instants limiting when the promotion shows. */
+    from?: string;
+    until?: string;
+};
+/** Stored in the site record under `render.navigation`. Everything is optional: absent fields keep defaults. */
+type NavigationConfig = {
+    version?: 1;
+    destinations?: NavigationOverride[];
+    /** Overrides the seasonal featured slot; `null` suppresses it entirely. */
+    featured?: FeaturedDestination | null;
+};
+/**
+ * The network-wide default navigation. Primary order and collapse priority
+ * follow the 2026 information architecture: editorial sections first, then
+ * the community products. "Front page" is the masthead's job, so it is not a
+ * destination. Autos ships disabled; enabling it is a record override.
+ */
+declare const NETWORK_NAVIGATION: NavigationDestination[];
+type NavigationLink = {
+    id: string;
+    label: string;
+    href: string;
+    kind: NavigationKind;
+    priority: number;
+};
+type NavigationGroupLinks = {
+    id: NavigationGroup;
+    label: string;
+    links: NavigationLink[];
+};
+type ResolvedNavigation = {
+    /** Editorial row in reading order; collapse into More by ascending priority. */
+    primary: NavigationLink[];
+    /** More-menu columns in canonical group order; empty groups are dropped. */
+    groups: NavigationGroupLinks[];
+    /** Active featured promotion from config, if any. `null` means "configured off". */
+    featured?: {
+        label: string;
+        href: string;
+    } | null;
+};
+type NavigationContext = {
+    /** This paper's slug. */
+    publication: string;
+    /** Sections the publication configures (profile taxonomy). */
+    sections?: string[];
+    /** Sections observed in the live feed; they satisfy a section gate too. */
+    discovered?: string[];
+    /** Publication feature flags. */
+    featureEnabled?: (feature: string) => boolean;
+    /** Record-stored overrides. Invalid entries are ignored, never fatal. */
+    config?: NavigationConfig | null;
+    now?: Date;
+};
+/** Apply record overrides defensively: the record is data, never trusted markup or routing. */
+declare function applyNavigationConfig(defaults: NavigationDestination[], config: NavigationConfig | null | undefined): NavigationDestination[];
+/** The one place that decides what every reader-facing menu shows. */
+declare function resolveNavigation(context: NavigationContext): ResolvedNavigation;
+
 /** 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;
@@ -514,4 +621,4 @@ 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, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, 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, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+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 };

package/dist/index.d.ts

@@ -274,6 +274,113 @@ declare function nearbyUpdates(items: NewsItem[], selection?: HomepageSelection,
 declare function shortDeck(value: string | null | undefined, limit?: number): string;
 declare function storyDate(value: string): string | null;
 
+/**
+ * Shared network navigation.
+ *
+ * One configuration drives the primary row, the More menu and the hamburger
+ * directory on every Bay Area News Network paper. The defaults below ship in
+ * this package; day-to-day changes (labels, order, enabling Autos, a featured
+ * seasonal destination) are `NavigationConfig` overrides stored in each
+ * paper's site record and picked up at request time — no release required.
+ */
+/** Editorial sections, community products and marketplaces stay distinct in config even where readers see one row. */
+type NavigationKind = "editorial" | "product" | "marketplace" | "publication";
+type NavigationGroup = "news-knowledge" | "local-life" | "marketplace" | "publication";
+declare const NAVIGATION_GROUPS: {
+    id: NavigationGroup;
+    label: string;
+}[];
+type NavigationDestination = {
+    /** Stable identifier; overrides and additions merge by id. */
+    id: string;
+    label: string;
+    href: string;
+    kind: NavigationKind;
+    /** More-menu column; destinations without a group never render in More. */
+    group?: NavigationGroup;
+    /** Reading order inside the primary row and inside each More group. */
+    order: number;
+    /** Responsive weight: when the row runs out of width, lower priority collapses into More first. */
+    priority?: number;
+    /** Renders in the primary editorial row. */
+    primary?: boolean;
+    /** Renders in its group inside the More menu. */
+    more?: boolean;
+    /** Hidden everywhere until enabled (default true). */
+    enabled?: boolean;
+    /** Publication feature flag that must be on (e.g. "jobs", "chat", "smile", "classifieds"). */
+    feature?: string;
+    /** Canonical section name: shown only when the publication configures or publishes the section. */
+    section?: string;
+    /** Restricts the destination to the listed publication slugs. */
+    publications?: string[];
+};
+/** Record-stored delta applied over the shipped defaults. Unknown ids with a label and href are additions. */
+type NavigationOverride = {
+    id: string;
+} & Partial<Omit<NavigationDestination, "id">>;
+type FeaturedDestination = {
+    label: string;
+    href: string;
+    /** ISO instants limiting when the promotion shows. */
+    from?: string;
+    until?: string;
+};
+/** Stored in the site record under `render.navigation`. Everything is optional: absent fields keep defaults. */
+type NavigationConfig = {
+    version?: 1;
+    destinations?: NavigationOverride[];
+    /** Overrides the seasonal featured slot; `null` suppresses it entirely. */
+    featured?: FeaturedDestination | null;
+};
+/**
+ * The network-wide default navigation. Primary order and collapse priority
+ * follow the 2026 information architecture: editorial sections first, then
+ * the community products. "Front page" is the masthead's job, so it is not a
+ * destination. Autos ships disabled; enabling it is a record override.
+ */
+declare const NETWORK_NAVIGATION: NavigationDestination[];
+type NavigationLink = {
+    id: string;
+    label: string;
+    href: string;
+    kind: NavigationKind;
+    priority: number;
+};
+type NavigationGroupLinks = {
+    id: NavigationGroup;
+    label: string;
+    links: NavigationLink[];
+};
+type ResolvedNavigation = {
+    /** Editorial row in reading order; collapse into More by ascending priority. */
+    primary: NavigationLink[];
+    /** More-menu columns in canonical group order; empty groups are dropped. */
+    groups: NavigationGroupLinks[];
+    /** Active featured promotion from config, if any. `null` means "configured off". */
+    featured?: {
+        label: string;
+        href: string;
+    } | null;
+};
+type NavigationContext = {
+    /** This paper's slug. */
+    publication: string;
+    /** Sections the publication configures (profile taxonomy). */
+    sections?: string[];
+    /** Sections observed in the live feed; they satisfy a section gate too. */
+    discovered?: string[];
+    /** Publication feature flags. */
+    featureEnabled?: (feature: string) => boolean;
+    /** Record-stored overrides. Invalid entries are ignored, never fatal. */
+    config?: NavigationConfig | null;
+    now?: Date;
+};
+/** Apply record overrides defensively: the record is data, never trusted markup or routing. */
+declare function applyNavigationConfig(defaults: NavigationDestination[], config: NavigationConfig | null | undefined): NavigationDestination[];
+/** The one place that decides what every reader-facing menu shows. */
+declare function resolveNavigation(context: NavigationContext): ResolvedNavigation;
+
 /** 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;
@@ -514,4 +621,4 @@ 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, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NEWS_CACHE, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, 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, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+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 };

package/dist/index.js

@@ -576,6 +576,156 @@ function defaultRevalidateTargets() {
   };
 }
 
+// src/navigation.ts
+var NAVIGATION_GROUPS = [
+  { id: "news-knowledge", label: "News & knowledge" },
+  { id: "local-life", label: "Local life" },
+  { id: "marketplace", label: "Marketplace" },
+  { id: "publication", label: "Publication" }
+];
+function editorial(id, section, overrides = {}) {
+  return {
+    id,
+    section,
+    kind: "editorial",
+    label: sectionDefinition(section).label,
+    href: sectionPath(section),
+    order: 0,
+    priority: 0,
+    ...overrides
+  };
+}
+var NETWORK_NAVIGATION = [
+  // Primary editorial row. "News" is the Civic life desk; the section slug and story classifications are unchanged.
+  editorial("news", "Civic life", { label: "News", order: 10, priority: 100, primary: true }),
+  editorial("community", "Community", { order: 20, priority: 90, primary: true }),
+  editorial("food-drink", "Food & places", { order: 30, priority: 85, primary: true }),
+  editorial("things-to-do", "Events", { order: 40, priority: 80, primary: true }),
+  editorial("health", "Health", { order: 50, priority: 75, primary: true }),
+  editorial("real-estate", "Real Estate", { order: 60, priority: 70, primary: true }),
+  { id: "autos", label: "Autos", href: "/autos", kind: "marketplace", group: "marketplace", order: 65, priority: 65, primary: true, more: true, enabled: false },
+  editorial("business", "Local businesses", { order: 70, priority: 60, primary: true }),
+  { id: "meet", label: "Meet", href: "/meet", kind: "product", order: 80, priority: 50, primary: true, feature: "chat" },
+  { id: "jokes", label: "Jokes", href: "/smile", kind: "product", order: 90, priority: 40, primary: true, feature: "smile" },
+  // More — News & knowledge.
+  editorial("ai-technology", "AI & Technology", { label: "AI & technology", group: "news-knowledge", order: 10, more: true }),
+  editorial("schools", "Schools", { label: "Schools & education", group: "news-knowledge", order: 20, more: true }),
+  editorial("civic-life", "Civic life", { group: "news-knowledge", order: 30, more: true }),
+  editorial("environment", "Environment", { group: "news-knowledge", order: 40, more: true }),
+  editorial("transportation", "Transportation", { group: "news-knowledge", order: 50, more: true }),
+  // More — Local life.
+  { id: "pets", label: "Pets", href: "/pets", kind: "product", group: "local-life", order: 10, more: true },
+  { id: "celebrations", label: "Celebrations", href: "/sections/celebrations", kind: "product", group: "local-life", order: 20, more: true, enabled: false },
+  { id: "community-maps", label: "Community maps", href: "/community-maps", kind: "product", group: "local-life", order: 30, more: true },
+  { id: "town-chat", label: "Town chat", href: "/chat", kind: "product", group: "local-life", order: 40, more: true, feature: "chat" },
+  { id: "neighborhood-guides", label: "Neighborhood guides", href: "/guides", kind: "product", group: "local-life", order: 50, more: true, enabled: false },
+  { id: "poll", label: "Poll", href: "/polls", kind: "product", group: "local-life", order: 60, more: true, publications: ["walnutcreektimes"] },
+  // More — Marketplace.
+  { id: "jobs", label: "Jobs", href: "/jobs", kind: "marketplace", group: "marketplace", order: 10, more: true, feature: "jobs" },
+  { id: "classifieds", label: "Classifieds", href: "/classifieds", kind: "marketplace", group: "marketplace", order: 20, more: true, feature: "classifieds" },
+  { id: "local-services", label: "Local services", href: "/services", kind: "marketplace", group: "marketplace", order: 40, more: true, enabled: false },
+  // More — Publication.
+  { id: "latest", label: "Latest", href: "/news", kind: "publication", group: "publication", order: 10, more: true },
+  { id: "this-week", label: "This week", href: "/this-week", kind: "publication", group: "publication", order: 20, more: true },
+  { id: "newsletter", label: "Newsletter", href: "/newsletter", kind: "publication", group: "publication", order: 30, more: true },
+  { id: "about", label: "About", href: "/about", kind: "publication", group: "publication", order: 40, more: true },
+  { id: "advertise", label: "Advertise", href: "/advertise", kind: "publication", group: "publication", order: 50, more: true },
+  { id: "contact", label: "Contact", href: "/contact", kind: "publication", group: "publication", order: 60, more: true }
+];
+var MAX_LABEL = 60;
+function safeHref(href) {
+  if (typeof href !== "string") return null;
+  const value = href.trim();
+  if (!value.startsWith("/") || value.startsWith("//") || /[\s\\]/.test(value)) return null;
+  return value;
+}
+function safeLabel(label) {
+  if (typeof label !== "string") return null;
+  const value = label.trim();
+  return value && value.length <= MAX_LABEL ? value : null;
+}
+var GROUP_IDS = new Set(NAVIGATION_GROUPS.map((group) => group.id));
+var KINDS = /* @__PURE__ */ new Set(["editorial", "product", "marketplace", "publication"]);
+function applyNavigationConfig(defaults, config) {
+  const merged = new Map(defaults.map((destination) => [destination.id, { ...destination }]));
+  for (const override of config?.destinations ?? []) {
+    if (!override || typeof override.id !== "string" || !override.id) continue;
+    const current = merged.get(override.id);
+    const label = safeLabel(override.label);
+    const href = safeHref(override.href);
+    if (!current && !(label && href)) continue;
+    const next = current ? { ...current } : {
+      id: override.id,
+      label,
+      href,
+      kind: "product",
+      order: 1e3,
+      priority: 0
+    };
+    if (label) next.label = label;
+    if (href) next.href = href;
+    if (typeof override.order === "number" && Number.isFinite(override.order)) next.order = override.order;
+    if (typeof override.priority === "number" && Number.isFinite(override.priority)) next.priority = override.priority;
+    if (typeof override.enabled === "boolean") next.enabled = override.enabled;
+    if (typeof override.primary === "boolean") next.primary = override.primary;
+    if (typeof override.more === "boolean") next.more = override.more;
+    if (override.group && GROUP_IDS.has(override.group)) next.group = override.group;
+    if (override.kind && KINDS.has(override.kind)) next.kind = override.kind;
+    if (typeof override.section === "string") next.section = override.section;
+    if (typeof override.feature === "string") next.feature = override.feature;
+    if (Array.isArray(override.publications)) next.publications = override.publications.filter((slug) => typeof slug === "string");
+    merged.set(next.id, next);
+  }
+  return Array.from(merged.values());
+}
+function activeFeatured(config, now) {
+  if (config?.featured === null) return null;
+  const featured = config?.featured;
+  if (!featured) return void 0;
+  const label = safeLabel(featured.label);
+  const href = safeHref(featured.href);
+  if (!label || !href) return void 0;
+  const time = now.getTime();
+  if (featured.from && time < Date.parse(featured.from)) return void 0;
+  if (featured.until && time >= Date.parse(featured.until)) return void 0;
+  return { label, href };
+}
+function resolveNavigation(context) {
+  const now = context.now ?? /* @__PURE__ */ new Date();
+  const sections2 = /* @__PURE__ */ new Set([...context.sections ?? [], ...context.discovered ?? []]);
+  const featureEnabled2 = context.featureEnabled ?? (() => false);
+  const destinations = applyNavigationConfig(NETWORK_NAVIGATION, context.config);
+  const visible = destinations.filter((destination) => {
+    if (destination.enabled === false) return false;
+    if (destination.feature && !featureEnabled2(destination.feature)) return false;
+    if (destination.section && !sections2.has(destination.section)) return false;
+    if (destination.publications && !destination.publications.includes(context.publication)) return false;
+    return true;
+  });
+  const link = (destination) => ({
+    id: destination.id,
+    label: destination.label,
+    href: destination.href,
+    kind: destination.kind,
+    priority: destination.priority ?? 0
+  });
+  const byOrder = (left, right) => left.order - right.order || left.label.localeCompare(right.label);
+  const primary = visible.filter((destination) => destination.primary).sort(byOrder).map(link);
+  const covered = new Set(destinations.map((destination) => destination.section).filter(Boolean));
+  const stray = [...new Set(context.discovered ?? [])].filter((name) => name !== "Local news" && !covered.has(name)).sort((left, right) => left.localeCompare(right)).map((name) => {
+    const definition = sectionDefinition(name);
+    return { id: definition.id, label: definition.label, href: sectionPath(name), kind: "editorial", priority: 0 };
+  });
+  const groups = NAVIGATION_GROUPS.map((group) => ({
+    ...group,
+    links: [
+      ...visible.filter((destination) => destination.more && destination.group === group.id).sort(byOrder).map(link),
+      ...group.id === "news-knowledge" ? stray : []
+    ]
+  })).filter((group) => group.links.length > 0);
+  return { primary, groups, featured: activeFeatured(context.config, now) };
+}
+
 // src/analytics.ts
 var ANALYTICS_VERSION = 1;
 var ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -837,4 +987,4 @@ 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, NEWS_CACHE, NewsError, SESSION_IDLE_MS, UTM_FIELDS, UUID, activeNearby, 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, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+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 };

package/dist/pets-forms.js

@@ -1,5 +1,5 @@
 "use client";
-import { PawMark } from './chunk-3HPE2Y7V.js';
+import { PawMark } from './chunk-7HXSQY4T.js';
 import './chunk-4JRWZXAP.js';
 import './chunk-66GI2IX6.js';
 import { PET_PHOTO_CATEGORIES, PET_CELEBRATIONS, PET_SAFETY } from './chunk-AFJ6S5WJ.js';

package/dist/pets-plugin.js

@@ -1,4 +1,4 @@
-import { LostPetNotice, PetCelebrationCard, AdoptionListingCard, PetEventCard, PetProfileCard, PawMark } from './chunk-3HPE2Y7V.js';
+import { LostPetNotice, PetCelebrationCard, AdoptionListingCard, PetEventCard, PetProfileCard, PawMark } from './chunk-7HXSQY4T.js';
 import './chunk-4JRWZXAP.js';
 import './chunk-66GI2IX6.js';
 import { petRequest } from './chunk-ABPJMDUG.js';

package/dist/pets-publication.cjs

@@ -479,9 +479,28 @@ function SponsorAcknowledgment2({
     /* @__PURE__ */ jsxRuntime.jsx("small", { children: "Paid community sponsorship. Sponsorship does not influence editorial selections and is not an endorsement." })
   ] });
 }
+var DEFAULT_COVER = {
+  url: "https://cdn-public.scalemule.com/01a1382e-6aff-7091-a757-12433a04eed1/anonymous/photos/01a13b52-a168-7131-90f6-a216dbe8dc3b/w800_h0_scaledown_q85_webp.webp",
+  alt: "A white Labrador retriever resting on a sunlit lawn",
+  credit: "Boyko Mihaylov"
+};
+function safeCoverUrl(url) {
+  if (!url || !/^https:\/\/[^\s"\\]+$/.test(url)) return null;
+  try {
+    return new URL(url).protocol === "https:" ? url : null;
+  } catch {
+    return null;
+  }
+}
+function resolveCover(cover) {
+  if (!cover || !safeCoverUrl(cover.url) || !cover.alt || !cover.credit)
+    return DEFAULT_COVER;
+  return cover;
+}
 function PetsSection({
   name = "Bay Area Paw",
   tagline = "Happier pets. Closer communities.",
+  coverPhoto,
   community,
   communities,
   resources,
@@ -500,6 +519,8 @@ function PetsSection({
   eventsUrl,
   accountUrl
 }) {
+  const cover = resolveCover(coverPhoto);
+  const coverCreditUrl = safeCoverUrl(cover.credit_url);
   const location = community?.name || regionLabel || "the Bay Area";
   const link = (id) => `${resourceBasePath || basePath}/${encodeURIComponent(id)}`;
   const local = (id) => communities.find((c) => c.id === id)?.name || "Our community";
@@ -603,10 +624,15 @@ function PetsSection({
           "div",
           {
             role: "img",
-            "aria-label": "A white Labrador retriever resting on a sunlit lawn"
+            "aria-label": cover.alt,
+            style: { backgroundImage: `url("${cover.url}")` }
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx("figcaption", { children: "Cover photograph by Boyko Mihaylov" })
+        /* @__PURE__ */ jsxRuntime.jsxs("figcaption", { children: [
+          "Cover photograph by",
+          " ",
+          coverCreditUrl ? /* @__PURE__ */ jsxRuntime.jsx("a", { href: coverCreditUrl, rel: "noopener noreferrer", children: cover.credit }) : cover.credit
+        ] })
       ] })
     ] }),
     !unavailable && /* @__PURE__ */ jsxRuntime.jsxs("nav", { className: "paw-shortcuts", "aria-label": "Useful pet resources", children: [
@@ -900,6 +926,7 @@ async function PublicationPetsSection({
         PetsSection,
         {
           basePath: "/pets",
+          coverPhoto: collection.config?.presentation?.cover_photo,
           regionLabel: region,
           resourceBasePath: native ? "/pets" : canonicalOrigin + "/pets",
           accountUrl: native ? "/pets/account" : void 0,

package/dist/pets-publication.js

@@ -1,4 +1,4 @@
-import { PetsSection, PawOfTheWeekCard, AdoptionListingCard, PetEventCard, PetCelebrationCard, LostPetNotice, PetProfileCard } from './chunk-3HPE2Y7V.js';
+import { PetsSection, PawOfTheWeekCard, AdoptionListingCard, PetEventCard, PetCelebrationCard, LostPetNotice, PetProfileCard } from './chunk-7HXSQY4T.js';
 import './chunk-4JRWZXAP.js';
 import './chunk-66GI2IX6.js';
 import { petRequest, petAcknowledgments, resolvePetReferences } from './chunk-ABPJMDUG.js';
@@ -92,6 +92,7 @@ async function PublicationPetsSection({
         PetsSection,
         {
           basePath: "/pets",
+          coverPhoto: collection.config?.presentation?.cover_photo,
           regionLabel: region,
           resourceBasePath: native ? "/pets" : canonicalOrigin + "/pets",
           accountUrl: native ? "/pets/account" : void 0,

package/dist/pets-view.cjs

@@ -602,9 +602,28 @@ function SponsorAcknowledgment2({
     /* @__PURE__ */ jsxRuntime.jsx("small", { children: "Paid community sponsorship. Sponsorship does not influence editorial selections and is not an endorsement." })
   ] });
 }
+var DEFAULT_COVER = {
+  url: "https://cdn-public.scalemule.com/01a1382e-6aff-7091-a757-12433a04eed1/anonymous/photos/01a13b52-a168-7131-90f6-a216dbe8dc3b/w800_h0_scaledown_q85_webp.webp",
+  alt: "A white Labrador retriever resting on a sunlit lawn",
+  credit: "Boyko Mihaylov"
+};
+function safeCoverUrl(url) {
+  if (!url || !/^https:\/\/[^\s"\\]+$/.test(url)) return null;
+  try {
+    return new URL(url).protocol === "https:" ? url : null;
+  } catch {
+    return null;
+  }
+}
+function resolveCover(cover) {
+  if (!cover || !safeCoverUrl(cover.url) || !cover.alt || !cover.credit)
+    return DEFAULT_COVER;
+  return cover;
+}
 function PetsSection({
   name = "Bay Area Paw",
   tagline = "Happier pets. Closer communities.",
+  coverPhoto,
   community,
   communities,
   resources,
@@ -623,6 +642,8 @@ function PetsSection({
   eventsUrl,
   accountUrl
 }) {
+  const cover = resolveCover(coverPhoto);
+  const coverCreditUrl = safeCoverUrl(cover.credit_url);
   const location = community?.name || regionLabel || "the Bay Area";
   const link = (id) => `${resourceBasePath || basePath}/${encodeURIComponent(id)}`;
   const local = (id) => communities.find((c) => c.id === id)?.name || "Our community";
@@ -726,10 +747,15 @@ function PetsSection({
           "div",
           {
             role: "img",
-            "aria-label": "A white Labrador retriever resting on a sunlit lawn"
+            "aria-label": cover.alt,
+            style: { backgroundImage: `url("${cover.url}")` }
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx("figcaption", { children: "Cover photograph by Boyko Mihaylov" })
+        /* @__PURE__ */ jsxRuntime.jsxs("figcaption", { children: [
+          "Cover photograph by",
+          " ",
+          coverCreditUrl ? /* @__PURE__ */ jsxRuntime.jsx("a", { href: coverCreditUrl, rel: "noopener noreferrer", children: cover.credit }) : cover.credit
+        ] })
       ] })
     ] }),
     !unavailable && /* @__PURE__ */ jsxRuntime.jsxs("nav", { className: "paw-shortcuts", "aria-label": "Useful pet resources", children: [

package/dist/pets-view.d.cts

@@ -35,9 +35,17 @@ declare function SponsorAcknowledgment({ acknowledgment, now, }: {
     acknowledgment: PublicAcknowledgment;
     now?: number;
 }): React__default.JSX.Element | null;
+/** Collection-managed cover photograph (config.presentation.cover_photo). */
+type PetCoverPhoto = {
+    url: string;
+    alt: string;
+    credit: string;
+    credit_url?: string | null;
+};
 type PetsSectionProps = {
     name?: string;
     tagline?: string;
+    coverPhoto?: PetCoverPhoto | null;
     community?: PetCommunity;
     communities: PetCommunity[];
     resources: PetResource[];
@@ -56,6 +64,6 @@ type PetsSectionProps = {
     eventsUrl?: string;
     accountUrl?: string;
 };
-declare function PetsSection({ name, tagline, community, communities, resources, spotlight, acknowledgments, basePath, mediaUrl, contributeUrl, placesUrl, walksUrl, nextUrl, unavailable, regionLabel, resourceBasePath, browseBasePath, eventsUrl, accountUrl, }: PetsSectionProps): React__default.JSX.Element;
+declare function PetsSection({ name, tagline, coverPhoto, community, communities, resources, spotlight, acknowledgments, basePath, mediaUrl, contributeUrl, placesUrl, walksUrl, nextUrl, unavailable, regionLabel, resourceBasePath, browseBasePath, eventsUrl, accountUrl, }: PetsSectionProps): React__default.JSX.Element;
 
-export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, type PetsSectionProps, SponsorAcknowledgment };
+export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, type PetCoverPhoto, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, type PetsSectionProps, SponsorAcknowledgment };

package/dist/pets-view.d.ts

@@ -35,9 +35,17 @@ declare function SponsorAcknowledgment({ acknowledgment, now, }: {
     acknowledgment: PublicAcknowledgment;
     now?: number;
 }): React__default.JSX.Element | null;
+/** Collection-managed cover photograph (config.presentation.cover_photo). */
+type PetCoverPhoto = {
+    url: string;
+    alt: string;
+    credit: string;
+    credit_url?: string | null;
+};
 type PetsSectionProps = {
     name?: string;
     tagline?: string;
+    coverPhoto?: PetCoverPhoto | null;
     community?: PetCommunity;
     communities: PetCommunity[];
     resources: PetResource[];
@@ -56,6 +64,6 @@ type PetsSectionProps = {
     eventsUrl?: string;
     accountUrl?: string;
 };
-declare function PetsSection({ name, tagline, community, communities, resources, spotlight, acknowledgments, basePath, mediaUrl, contributeUrl, placesUrl, walksUrl, nextUrl, unavailable, regionLabel, resourceBasePath, browseBasePath, eventsUrl, accountUrl, }: PetsSectionProps): React__default.JSX.Element;
+declare function PetsSection({ name, tagline, coverPhoto, community, communities, resources, spotlight, acknowledgments, basePath, mediaUrl, contributeUrl, placesUrl, walksUrl, nextUrl, unavailable, regionLabel, resourceBasePath, browseBasePath, eventsUrl, accountUrl, }: PetsSectionProps): React__default.JSX.Element;
 
-export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, type PetsSectionProps, SponsorAcknowledgment };
+export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, type PetCoverPhoto, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, type PetsSectionProps, SponsorAcknowledgment };

package/dist/pets-view.js

@@ -1,4 +1,4 @@
-export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, SponsorAcknowledgment } from './chunk-3HPE2Y7V.js';
+export { AdoptionListingCard, LostPetNotice, PawMark, PawNeighborhoodIllustration, PawOfTheWeekCard, PetCelebrationCard, PetEventCard, PetFriendlyPlaceCard, PetProfileCard, PetsSection, SponsorAcknowledgment } from './chunk-7HXSQY4T.js';
 import './chunk-4JRWZXAP.js';
 import './chunk-66GI2IX6.js';
 import './chunk-AFJ6S5WJ.js';

package/images/README.md

@@ -4,8 +4,20 @@ Photograph: Boyko Mihaylov, “Jasper,” a white Labrador retriever resting on
 sunlit lawn. Supplied directly by the publisher on October 14, 2026 as
 `jasper.png`; used with the photographer's permission via the publisher.
 
+The photograph is not stored in this repository or npm package. It is uploaded
+to ScaleMule storage under the Bay Area Paw application as an
+anonymous-visible, scan-gated object and delivered from the anonymous CDN with
+photo-service `hero` renditions:
+
+- storage file: `01a13b52-99ca-7c41-bd8b-61868d700678`
+- photo manifest: `01a13b52-a168-7131-90f6-a216dbe8dc3b` (preset `hero`,
+  WebP 400w/800w)
+- referenced from `pets.css` (`.paw-cover-photo`), 800w WebP rendition
+- upload record: Bay Area Paw workspace `previews/editorial-cover-cdn.json`
+
 The photograph illustrates life with pets. It is not a Bay Area resident
 submission, an adoption listing, a featured winner or an endorsement. Keep the
-visible photographer credit. The WebP rendition is a portrait crop of the
-supplied image, optimized with cwebp (metadata stripped); no generative image
-editing was applied by this repository.
+visible photographer credit in `src/pets-view.tsx`. The uploaded source is a
+portrait crop of the supplied image; the platform pipeline strips metadata and
+generates the optimized renditions. No generative image editing was applied by
+this repository.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/news-publication",
-  "version": "0.0.57",
+  "version": "0.0.60",
   "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",

package/pets.css

@@ -1147,8 +1147,11 @@
 }
 .paw-cover-photo > div {
   height: 100%;
-  background: url("./images/paw-jasper-mobile.webp") center 57% / cover
-    no-repeat;
+  /* The photograph is collection-managed content: the component sets
+     background-image inline from config.presentation.cover_photo. */
+  background-position: center 57%;
+  background-size: cover;
+  background-repeat: no-repeat;
 }
 .paw-cover-photo::after {
   content: "";