@scalemule/news-publication 0.0.59 → 0.0.60

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/package.json

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