@scalemule/news-publication 0.0.92 → 0.0.93

package/bin/scalemule-article.mjs

@@ -18,7 +18,9 @@ Credentials: SCALEMULE_API_KEY and SCALEMULE_ACCESS_TOKEN (normal authorized mem
 Platform admins may use their normal access token with --application-id ID.
 Optional --api-url URL defaults to https://api.scalemule.com.
 
-edit saves prose, excerpt, cards, citations and tenant-owned tag_ids in one immutable revision.
+edit saves prose, excerpt, cards, citations, tenant-owned tag_ids and the headline set (title,
+headline <= 120 chars with 70 recommended, fly_title <= 40, subtitle as the rubric, seo_title) in
+one immutable revision.
 Unspecified fields and media are retained. Default: save for review.
 --release explicitly requests release under the existing policy; it never issues
 APPROVE or changes a policy. Legacy onboarding requires an explicit
@@ -157,7 +159,7 @@ try {
             while(!verified){
               const response=await fetch(values.url,{redirect:'error',cache:'no-store',signal:AbortSignal.timeout(Math.min(5000,remaining()))});
               const html=await response.text();
-              verified=response.ok&&articleEditHtmlMatches(html,{title:article.title,content_html:article.content_html,card_titles:(article.metadata?.cards??[]).map(c=>c.title),tags:checkpoint.document.tag_ids?article.tags:undefined});
+              verified=response.ok&&articleEditHtmlMatches(html,{title:article.title,headline:article.headline,content_html:article.content_html,card_titles:(article.metadata?.cards??[]).map(c=>c.title),tags:checkpoint.document.tag_ids?article.tags:undefined});
               if(!verified)await new Promise(r=>setTimeout(r,Math.min(300,remaining())));
             }
           }catch(error){reason=error.message;}

package/dist/article-workflow-client.cjs

@@ -31,8 +31,9 @@ var text = (html) => decode(html.replace(/<[^>]*>/gu, " ")).replace(/\s+/gu, " "
 var plain = (value) => value.replace(/\s+/gu, " ").trim();
 function articleEditHtmlMatches(html, expected) {
   const visible = html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/giu, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/giu, " ");
+  const shown = plain(expected.headline?.trim() || expected.title);
   const headline = [...visible.matchAll(/<h1\b[^>]*>([\s\S]*?)<\/h1>/giu)].some(
-    (m) => text(m[1]) === plain(expected.title)
+    (m) => text(m[1]) === shown
   );
   if (!headline) return false;
   const paragraphs = [
@@ -339,6 +340,29 @@ async function runArticlePhoto(t, input) {
   }
 }
 
+// src/headline.ts
+var HEADLINE_MAX_CHARS = 120;
+var FLY_TITLE_MAX_CHARS = 40;
+var RUBRIC_MAX_CHARS = 500;
+var SEO_TITLE_MAX_CHARS = 200;
+var headlineLength = (value) => Array.from(value).length;
+function headlineProblems(fields) {
+  const problems = [];
+  const check = (name, value, max) => {
+    if (value === void 0 || value === null) return;
+    if (typeof value !== "string") {
+      problems.push(`${name} must be a string`);
+      return;
+    }
+    if (headlineLength(value.trim()) > max) problems.push(`${name} exceeds ${max} characters`);
+  };
+  check("headline", fields.headline, HEADLINE_MAX_CHARS);
+  check("fly_title", fields.fly_title, FLY_TITLE_MAX_CHARS);
+  check("subtitle", fields.subtitle, RUBRIC_MAX_CHARS);
+  check("seo_title", fields.seo_title, SEO_TITLE_MAX_CHARS);
+  return problems;
+}
+
 // src/article-edit-operation.ts
 var ArticleEditOperationError = class extends Error {
   constructor(code, stage, message, status, revisionId) {
@@ -378,7 +402,10 @@ var digest2 = async (v) => [
 ].map((v2) => v2.toString(16).padStart(2, "0")).join("");
 var patchKeys = /* @__PURE__ */ new Set([
   "title",
+  "headline",
+  "fly_title",
   "subtitle",
+  "seo_title",
   "content_markdown",
   "excerpt",
   "section",
@@ -407,6 +434,8 @@ function validate(input) {
     } else if (typeof value !== "string")
       throw Error(key + " must be a string");
   }
+  const problems = headlineProblems(input.patch);
+  if (problems.length) throw Error(problems.join("; "));
   if (input.expectedGeneration !== void 0 && (!Number.isSafeInteger(input.expectedGeneration) || input.expectedGeneration < 1))
     throw Error("Expected generation must be positive");
   if (input.enableReviewPolicy && ![

package/dist/article-workflow-client.d.cts

@@ -6,6 +6,7 @@ declare function articlePhotoHtmlMatches(html: string, lead: string | string[],
 /** Requires visible body and actual card asides; serialized page data is not delivery. */
 declare function articleEditHtmlMatches(html: string, expected: {
     title: string;
+    headline?: string | null;
     content_html: string;
     card_titles: string[];
     tags?: {
@@ -52,7 +53,7 @@ declare class ArticlePhotoOperationError extends Error {
     constructor(code: string, stage: string, message: string, fileId?: string | undefined, status?: number | undefined);
 }
 
-type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
+type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "headline" | "fly_title" | "subtitle" | "seo_title" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
 type ArticleEditCheckpoint = {
     version: 1;
     identity: string;
@@ -92,7 +93,14 @@ declare class ArticleEditOperationError extends Error {
 
 type ArticleDocument = {
     title: string;
+    /** Short display headline (<= 120 characters, 70 recommended); see `headlineSet`. */
+    headline?: string;
+    /** Kicker above the headline (<= 40 characters). */
+    fly_title?: string;
+    /** The rubric (deck). */
     subtitle?: string;
+    /** Search title for <title> and previews. */
+    seo_title?: string;
     content_markdown: string;
     excerpt?: string;
     cards?: unknown[];

package/dist/article-workflow-client.d.ts

@@ -6,6 +6,7 @@ declare function articlePhotoHtmlMatches(html: string, lead: string | string[],
 /** Requires visible body and actual card asides; serialized page data is not delivery. */
 declare function articleEditHtmlMatches(html: string, expected: {
     title: string;
+    headline?: string | null;
     content_html: string;
     card_titles: string[];
     tags?: {
@@ -52,7 +53,7 @@ declare class ArticlePhotoOperationError extends Error {
     constructor(code: string, stage: string, message: string, fileId?: string | undefined, status?: number | undefined);
 }
 
-type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "subtitle" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
+type ArticleEditPatch = Partial<Pick<ArticleDocument, "title" | "headline" | "fly_title" | "subtitle" | "seo_title" | "content_markdown" | "excerpt" | "section" | "community" | "format" | "layout" | "cards" | "citations" | "tag_ids">>;
 type ArticleEditCheckpoint = {
     version: 1;
     identity: string;
@@ -92,7 +93,14 @@ declare class ArticleEditOperationError extends Error {
 
 type ArticleDocument = {
     title: string;
+    /** Short display headline (<= 120 characters, 70 recommended); see `headlineSet`. */
+    headline?: string;
+    /** Kicker above the headline (<= 40 characters). */
+    fly_title?: string;
+    /** The rubric (deck). */
     subtitle?: string;
+    /** Search title for <title> and previews. */
+    seo_title?: string;
     content_markdown: string;
     excerpt?: string;
     cards?: unknown[];

package/dist/article-workflow-client.js

@@ -1,3 +1,5 @@
+import { headlineProblems } from './chunk-SNQKSUWB.js';
+
 // src/article-photo-verification.ts
 function articlePhotoHtmlMatches(html, lead, social) {
   const contains = (tag, url) => tag.includes(url) || tag.includes(encodeURIComponent(url));
@@ -29,8 +31,9 @@ var text = (html) => decode(html.replace(/<[^>]*>/gu, " ")).replace(/\s+/gu, " "
 var plain = (value) => value.replace(/\s+/gu, " ").trim();
 function articleEditHtmlMatches(html, expected) {
   const visible = html.replace(/<script\b[^>]*>[\s\S]*?<\/script>/giu, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/giu, " ");
+  const shown = plain(expected.headline?.trim() || expected.title);
   const headline = [...visible.matchAll(/<h1\b[^>]*>([\s\S]*?)<\/h1>/giu)].some(
-    (m) => text(m[1]) === plain(expected.title)
+    (m) => text(m[1]) === shown
   );
   if (!headline) return false;
   const paragraphs = [
@@ -376,7 +379,10 @@ var digest2 = async (v) => [
 ].map((v2) => v2.toString(16).padStart(2, "0")).join("");
 var patchKeys = /* @__PURE__ */ new Set([
   "title",
+  "headline",
+  "fly_title",
   "subtitle",
+  "seo_title",
   "content_markdown",
   "excerpt",
   "section",
@@ -405,6 +411,8 @@ function validate(input) {
     } else if (typeof value !== "string")
       throw Error(key + " must be a string");
   }
+  const problems = headlineProblems(input.patch);
+  if (problems.length) throw Error(problems.join("; "));
   if (input.expectedGeneration !== void 0 && (!Number.isSafeInteger(input.expectedGeneration) || input.expectedGeneration < 1))
     throw Error("Expected generation must be positive");
   if (input.enableReviewPolicy && ![

package/dist/chunk-SNQKSUWB.js

@@ -0,0 +1,42 @@
+// src/headline.ts
+var HEADLINE_RECOMMENDED_CHARS = 70;
+var HEADLINE_MAX_CHARS = 120;
+var FLY_TITLE_MAX_CHARS = 40;
+var RUBRIC_MAX_CHARS = 500;
+var SEO_TITLE_MAX_CHARS = 200;
+var text = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.replace(/\s+/gu, " ").trim();
+  return trimmed || void 0;
+};
+var headlineLength = (value) => Array.from(value).length;
+function headlineSet(article, selection = {}) {
+  const display = selection.stories?.[article.slug];
+  const title = text(article.title) ?? "";
+  const headline = text(display?.display_title) ?? text(article.headline) ?? title;
+  return {
+    flyTitle: text(article.fly_title) ?? text(article.section),
+    headline,
+    rubric: text(display?.deck) ?? text(article.subtitle),
+    seoTitle: text(article.seo_title) ?? title,
+    title
+  };
+}
+function headlineProblems(fields) {
+  const problems = [];
+  const check = (name, value, max) => {
+    if (value === void 0 || value === null) return;
+    if (typeof value !== "string") {
+      problems.push(`${name} must be a string`);
+      return;
+    }
+    if (headlineLength(value.trim()) > max) problems.push(`${name} exceeds ${max} characters`);
+  };
+  check("headline", fields.headline, HEADLINE_MAX_CHARS);
+  check("fly_title", fields.fly_title, FLY_TITLE_MAX_CHARS);
+  check("subtitle", fields.subtitle, RUBRIC_MAX_CHARS);
+  check("seo_title", fields.seo_title, SEO_TITLE_MAX_CHARS);
+  return problems;
+}
+
+export { FLY_TITLE_MAX_CHARS, HEADLINE_MAX_CHARS, HEADLINE_RECOMMENDED_CHARS, RUBRIC_MAX_CHARS, SEO_TITLE_MAX_CHARS, headlineLength, headlineProblems, headlineSet };

package/dist/index.cjs

@@ -122,14 +122,14 @@ function resolveSection(item) {
     if (/\b(food|dining|restaurant|restaurants|wine|winery|brewery|bakery|cafe|coffee|cuisine|chef)\b/i.test(desc)) return "Food & places";
     if (/\b(community|volunteer|volunteers|library|libraries|neighborhood|nonprofit|charity|youth|senior|seniors)\b/i.test(desc)) return "Community";
   }
-  const text = `${item.title} ${item.excerpt ?? ""}`;
-  if (/\b(health|hospitals?|clinics?|medical|doctors?|pharmac(?:y|ies)|wellness|veterinar(?:y|ian)|pet care|animal welfare|vaccinat(?:ion|ions)|patients?)\b/iu.test(text)) return "Health";
-  if (/\b(real estate|homeownership|mortgage|housing|tenants?|apartments?|below-market rate|home sales?|condos?)\b/iu.test(text)) return "Real Estate";
-  if (/\b(city council|planning commission|board of supervisors|ballot|measure [a-z0-9]|election|transit|traffic|police|firefighter|wildfire|evacuation|pedestrian safety|city manager|public works)\b/iu.test(text)) return "Civic life";
-  if (/\b(storefront|retail|downtown business|chamber of commerce|opens? doors?|boutique|merchants?|shoppers?|commercial space)\b/iu.test(text)) return "Local businesses";
-  if (/\b(festival|parade|fair|concert|workshop|exhibition|showcase|celebration|weigh-off|halloween|trunk-or-treat)\b/iu.test(text)) return "Events";
-  if (/\b(schools?|students?|teachers?|campuses?|classrooms?|high school|elementary|school district)\b/iu.test(text)) return "Schools";
-  if (/\b(restaurants?|cafes?|baker(?:y|ies)|winer(?:y|ies)|brewer(?:y|ies)|dining|chefs?|menus?)\b/iu.test(text)) return "Food & places";
+  const text2 = `${item.title} ${item.excerpt ?? ""}`;
+  if (/\b(health|hospitals?|clinics?|medical|doctors?|pharmac(?:y|ies)|wellness|veterinar(?:y|ian)|pet care|animal welfare|vaccinat(?:ion|ions)|patients?)\b/iu.test(text2)) return "Health";
+  if (/\b(real estate|homeownership|mortgage|housing|tenants?|apartments?|below-market rate|home sales?|condos?)\b/iu.test(text2)) return "Real Estate";
+  if (/\b(city council|planning commission|board of supervisors|ballot|measure [a-z0-9]|election|transit|traffic|police|firefighter|wildfire|evacuation|pedestrian safety|city manager|public works)\b/iu.test(text2)) return "Civic life";
+  if (/\b(storefront|retail|downtown business|chamber of commerce|opens? doors?|boutique|merchants?|shoppers?|commercial space)\b/iu.test(text2)) return "Local businesses";
+  if (/\b(festival|parade|fair|concert|workshop|exhibition|showcase|celebration|weigh-off|halloween|trunk-or-treat)\b/iu.test(text2)) return "Events";
+  if (/\b(schools?|students?|teachers?|campuses?|classrooms?|high school|elementary|school district)\b/iu.test(text2)) return "Schools";
+  if (/\b(restaurants?|cafes?|baker(?:y|ies)|winer(?:y|ies)|brewer(?:y|ies)|dining|chefs?|menus?)\b/iu.test(text2)) return "Food & places";
   return "Community";
 }
 function orderedSections(sections2, order = EDITORIAL_SECTION_ORDER) {
@@ -234,7 +234,7 @@ function composeEdition(items, selection = {}, now = Date.now()) {
   return { lead, secondary, briefs, compact, sections: sections2, pendingImages, navigation: editorialSections(inventory) };
 }
 function displayHeadline(article, selection = {}) {
-  return selection.stories?.[article.slug]?.display_title?.trim() || article.title;
+  return selection.stories?.[article.slug]?.display_title?.trim() || article.headline?.trim() || article.title;
 }
 function briefSummary(article, selection = {}) {
   const chosen = selection.stories?.[article.slug]?.brief?.trim();
@@ -284,11 +284,11 @@ function nearbyUpdates(items, selection = {}, now = Date.now()) {
   return activeNearby(selection, now).filter((update) => published.has(update.slug)).map((update) => ({ ...update, article: published.get(update.slug) }));
 }
 function shortDeck(value, limit = 160) {
-  const text = value?.trim().replace(/\s+/gu, " ") ?? "";
-  const characters = Array.from(text);
-  if (characters.length <= limit) return text;
+  const text2 = value?.trim().replace(/\s+/gu, " ") ?? "";
+  const characters = Array.from(text2);
+  if (characters.length <= limit) return text2;
   let sentences = "";
-  for (const { segment } of new Intl.Segmenter("en", { granularity: "sentence" }).segment(text)) {
+  for (const { segment } of new Intl.Segmenter("en", { granularity: "sentence" }).segment(text2)) {
     if (Array.from(sentences + segment.trimEnd()).length > limit) break;
     sentences += segment;
   }
@@ -322,8 +322,9 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
   return {
     "@context": "https://schema.org",
     "@type": "NewsArticle",
-    headline: article.title,
-    description: article.excerpt ?? void 0,
+    headline: article.headline?.trim() || article.title,
+    ...article.headline?.trim() && article.headline.trim() !== article.title ? { alternativeHeadline: article.title } : {},
+    description: article.subtitle ?? article.excerpt ?? void 0,
     datePublished: article.published_at,
     ...article.metadata?.editorial?.modified_at ? { dateModified: article.metadata.editorial.modified_at } : {},
     // updated_at also changes for media/operational maintenance. A trusted
@@ -370,15 +371,15 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.title,
-    description: article.seo_description ?? article.excerpt ?? publication.description,
+    title: article.seo_title?.trim() || article.title,
+    description: article.seo_description ?? article.subtitle ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
       siteName: publication.name,
-      title: article.title,
-      description: article.excerpt ?? void 0,
+      title: article.headline?.trim() || article.title,
+      description: article.subtitle ?? article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
       images: image ? [image] : []
@@ -807,6 +808,47 @@ function resolveNavigation(context) {
   return { primary, groups, featured: activeFeatured(context.config, now) };
 }
 
+// src/headline.ts
+var HEADLINE_RECOMMENDED_CHARS = 70;
+var HEADLINE_MAX_CHARS = 120;
+var FLY_TITLE_MAX_CHARS = 40;
+var RUBRIC_MAX_CHARS = 500;
+var SEO_TITLE_MAX_CHARS = 200;
+var text = (value) => {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.replace(/\s+/gu, " ").trim();
+  return trimmed || void 0;
+};
+var headlineLength = (value) => Array.from(value).length;
+function headlineSet(article, selection = {}) {
+  const display = selection.stories?.[article.slug];
+  const title = text(article.title) ?? "";
+  const headline = text(display?.display_title) ?? text(article.headline) ?? title;
+  return {
+    flyTitle: text(article.fly_title) ?? text(article.section),
+    headline,
+    rubric: text(display?.deck) ?? text(article.subtitle),
+    seoTitle: text(article.seo_title) ?? title,
+    title
+  };
+}
+function headlineProblems(fields) {
+  const problems = [];
+  const check = (name, value, max) => {
+    if (value === void 0 || value === null) return;
+    if (typeof value !== "string") {
+      problems.push(`${name} must be a string`);
+      return;
+    }
+    if (headlineLength(value.trim()) > max) problems.push(`${name} exceeds ${max} characters`);
+  };
+  check("headline", fields.headline, HEADLINE_MAX_CHARS);
+  check("fly_title", fields.fly_title, FLY_TITLE_MAX_CHARS);
+  check("subtitle", fields.subtitle, RUBRIC_MAX_CHARS);
+  check("seo_title", fields.seo_title, SEO_TITLE_MAX_CHARS);
+  return problems;
+}
+
 // src/analytics.ts
 var ANALYTICS_VERSION = 1;
 var ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -869,9 +911,9 @@ var PUBLIC_PATHS = /* @__PURE__ */ new Set([
 ]);
 function shortText(value, max = 100) {
   if (typeof value !== "string") return void 0;
-  const text = value.trim();
-  if (!text || /[@\r\n\u0000-\u001f]/.test(text)) return void 0;
-  return Array.from(text).slice(0, max).join("");
+  const text2 = value.trim();
+  if (!text2 || /[@\r\n\u0000-\u001f]/.test(text2)) return void 0;
+  return Array.from(text2).slice(0, max).join("");
 }
 function publicUrl(value, originOnly = false) {
   if (typeof value !== "string") return void 0;
@@ -979,13 +1021,13 @@ function canHostMeetup(accountCreatedAt, now = /* @__PURE__ */ new Date()) {
   return Number.isFinite(created) && now.getTime() - created >= HOST_WAIT_MS;
 }
 function screenMessage(value) {
-  const text = Array.from(value.trim()).slice(0, 1e3).join("");
-  if (Array.from(text).length < 1) return { ok: false, reason: "Write a short message." };
-  if (/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/i.test(text)) return { ok: false, reason: "Share an email in person, not in the chat." };
-  if (/(https?:\/\/|www\.)\S+/i.test(text)) return { ok: false, reason: "Links are not allowed in the chat." };
-  const digits = text.replace(/\D/g, "");
+  const text2 = Array.from(value.trim()).slice(0, 1e3).join("");
+  if (Array.from(text2).length < 1) return { ok: false, reason: "Write a short message." };
+  if (/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/i.test(text2)) return { ok: false, reason: "Share an email in person, not in the chat." };
+  if (/(https?:\/\/|www\.)\S+/i.test(text2)) return { ok: false, reason: "Links are not allowed in the chat." };
+  const digits = text2.replace(/\D/g, "");
   if (digits.length >= 10) return { ok: false, reason: "Share a phone number in person, not in the chat." };
-  return { ok: true, text };
+  return { ok: true, text: text2 };
 }
 function activityLabel(value, otherLabel = "") {
   if (value === "other") return Array.from(otherLabel.trim()).slice(0, 40).join("") || "Something else";
@@ -1088,9 +1130,9 @@ function classifiedPath(id) {
   return `/v1/listings/${encodeURIComponent(id)}`;
 }
 function requireText(value, label, max, min = 1) {
-  const text = clipChars(typeof value === "string" ? value : "", max);
-  if (Array.from(text).length < min) throw new Error(`Please complete the ${label}.`);
-  return text;
+  const text2 = clipChars(typeof value === "string" ? value : "", max);
+  if (Array.from(text2).length < min) throw new Error(`Please complete the ${label}.`);
+  return text2;
 }
 function prepareJobPost(input, towns) {
   const title = requireText(input.title, "job title", 120);
@@ -1623,7 +1665,7 @@ var COOKIE_CATEGORIES = [
 ];
 function CookieConsentBanner({
   title = "Your privacy choices",
-  text,
+  text: text2,
   settingsUrl = "/cookies",
   className = "",
   publicationSlug,
@@ -1692,8 +1734,8 @@ function CookieConsentBanner({
       children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-banner-card", children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-cookie-banner-content", children: [
           /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "sm-cookie-banner-title", children: title }),
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "sm-cookie-banner-text", children: text ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-            text,
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "sm-cookie-banner-text", children: text2 ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+            text2,
             " ",
             /* @__PURE__ */ jsxRuntime.jsx("a", { href: settingsUrl, className: "sm-cookie-banner-link", children: "Cookie Settings" })
           ] }) : defaultText })
@@ -2398,12 +2440,12 @@ function readerSources(input) {
       const url = new URL(value.url);
       if (url.protocol !== "https:" || url.username || url.password || seen.has(url.href)) continue;
       seen.add(url.href);
-      const text = (raw, limit) => {
+      const text2 = (raw, limit) => {
         if (typeof raw !== "string") return void 0;
         const trimmed = raw.trim();
         return trimmed ? Array.from(trimmed).slice(0, limit).join("") : void 0;
       };
-      output.push({ url: url.href, title: text(value.title, 500), publisher: text(value.publisher, 255) });
+      output.push({ url: url.href, title: text2(value.title, 500), publisher: text2(value.publisher, 255) });
       if (output.length === 5) break;
     } catch {
       continue;
@@ -3254,23 +3296,23 @@ function normalizeUuid(id) {
   }
   return id.trim().toLowerCase();
 }
-function escapeHtml(text) {
-  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+function escapeHtml(text2) {
+  return text2.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
 function sanitizeInlineMarkdown(raw) {
-  let text = raw.trim();
-  text = text.replace(/on\w+\s*=\s*(?:["'][^"']*["']|[^\s>]+)/gi, "");
-  text = text.replace(/javascript\s*:/gi, "");
-  text = escapeHtml(text);
-  text = text.replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>");
-  text = text.replace(/__(.+?)__/g, "<strong>$1</strong>");
-  text = text.replace(/\*([^*]+?)\*/g, "<em>$1</em>");
-  text = text.replace(/_([^_]+?)_/g, "<em>$1</em>");
-  text = text.replace(/`([^`]+?)`/g, "<code>$1</code>");
-  text = text.replace(/\[([^\]]+)\]\(((?:https?:\/\/|mailto:)[^)]+)\)/g, (_m, label, url) => {
+  let text2 = raw.trim();
+  text2 = text2.replace(/on\w+\s*=\s*(?:["'][^"']*["']|[^\s>]+)/gi, "");
+  text2 = text2.replace(/javascript\s*:/gi, "");
+  text2 = escapeHtml(text2);
+  text2 = text2.replace(/\*\*(.+?)\*\*/g, "<strong>$1</strong>");
+  text2 = text2.replace(/__(.+?)__/g, "<strong>$1</strong>");
+  text2 = text2.replace(/\*([^*]+?)\*/g, "<em>$1</em>");
+  text2 = text2.replace(/_([^_]+?)_/g, "<em>$1</em>");
+  text2 = text2.replace(/`([^`]+?)`/g, "<code>$1</code>");
+  text2 = text2.replace(/\[([^\]]+)\]\(((?:https?:\/\/|mailto:)[^)]+)\)/g, (_m, label, url) => {
     return `<a href="${escapeHtml(url)}" rel="noopener noreferrer nofollow">${label}</a>`;
   });
-  return text;
+  return text2;
 }
 function parseDocumentBlocks(doc) {
   const mediaList = doc.media || [];
@@ -3563,7 +3605,7 @@ function measurementConsent(headers, sponsorship = false, now = Date.now()) {
 }
 
 // src/sponsorship-report.ts
-var escape = (text) => String(text ?? "").replace(
+var escape = (text2) => String(text2 ?? "").replace(
   /[&<>"']/g,
   (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]
 );
@@ -3934,6 +3976,9 @@ exports.EDITORIAL_PRINCIPLES = EDITORIAL_PRINCIPLES;
 exports.EDITORIAL_SECTION_ORDER = EDITORIAL_SECTION_ORDER;
 exports.EVENTS = EVENTS;
 exports.FEATURE_NAMES = FEATURE_NAMES;
+exports.FLY_TITLE_MAX_CHARS = FLY_TITLE_MAX_CHARS;
+exports.HEADLINE_MAX_CHARS = HEADLINE_MAX_CHARS;
+exports.HEADLINE_RECOMMENDED_CHARS = HEADLINE_RECOMMENDED_CHARS;
 exports.JOB_EMPLOYMENT_TYPES = JOB_EMPLOYMENT_TYPES;
 exports.LAYOUT_COOKIE = LAYOUT_COOKIE;
 exports.LOCAL_BRIEFING_POLICY_VERSION = LOCAL_BRIEFING_POLICY_VERSION;
@@ -3947,6 +3992,8 @@ exports.NetworkCopyrightNotice = NetworkCopyrightNotice;
 exports.NewsError = NewsError;
 exports.READER_SSO_EVENTS = READER_SSO_EVENTS;
 exports.READER_SSO_PROPERTY_KEYS = READER_SSO_PROPERTY_KEYS;
+exports.RUBRIC_MAX_CHARS = RUBRIC_MAX_CHARS;
+exports.SEO_TITLE_MAX_CHARS = SEO_TITLE_MAX_CHARS;
 exports.SESSION_IDLE_MS = SESSION_IDLE_MS;
 exports.SPONSORSHIP_OFFERINGS = SPONSORSHIP_OFFERINGS;
 exports.SPONSORSHIP_POLICY = SPONSORSHIP_POLICY;
@@ -4008,6 +4055,9 @@ exports.getNetworkPublicationUrl = getNetworkPublicationUrl;
 exports.getNetworkReaderHandoffUrl = getNetworkReaderHandoffUrl;
 exports.getStoredTheme = getStoredTheme;
 exports.getSystemTheme = getSystemTheme;
+exports.headlineLength = headlineLength;
+exports.headlineProblems = headlineProblems;
+exports.headlineSet = headlineSet;
 exports.inventoryCacheOptions = inventoryCacheOptions;
 exports.isAdult = isAdult;
 exports.isClassifiedCategory = isClassifiedCategory;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-22lEf_UU.cjs';
-export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-22lEf_UU.cjs';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-aYDyFCGs.cjs';
+export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-aYDyFCGs.cjs';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-CO9Unz5M.cjs';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-29i5w4LS.cjs';
-export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-BBTow5Bn.cjs';
+export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-C3kD6oFZ.cjs';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
 export { COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, CookieCategory, CookieCategoryDefinition, CookieConsentRecord, CookieDisclosure, CookiePreferences, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, consentModel, decorateNetworkUrl, effectivePreferences, getCookieConsent, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, queryNetworkConsentHub, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.cjs';
@@ -249,6 +249,7 @@ declare function composeEdition(items: NewsItem[], selection?: HomepageSelection
     pendingImages: NewsItem[];
     navigation: EditorialSection[];
 };
+/** The paper's override, else the article's short headline, else its long title (see `headlineSet`). */
 declare function displayHeadline(article: NewsItem, selection?: HomepageSelection): string;
 /** A complete existing sentence, not a cut-off or generated summary. */
 declare function briefSummary(article: NewsItem, selection?: HomepageSelection): string;
@@ -404,11 +405,12 @@ declare function newsArticleJsonLd(publication: NewsPublication, article: NewsAr
     mainEntityOfPage: string;
     url: string;
     dateModified?: string | undefined;
+    description: string | undefined;
+    datePublished: string;
+    alternativeHeadline?: string | undefined;
     "@context": string;
     "@type": string;
     headline: string;
-    description: string | undefined;
-    datePublished: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -453,6 +455,48 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
 /** One line a paper can serve at /llms.txt. Towns and the article path stay explicit. */
 declare function llmsText(publication: NewsPublication, canonical: string): string;
 
+/**
+ * The newspaper headline set. Every article may carry four pieces of title text, each with a job:
+ *
+ * - `fly_title`  the kicker above the headline: a beat, column or section label (<= 40 characters);
+ * - `headline`   the short display headline, written as a line, not a summary (recommended <= 70,
+ *                hard limit 120); front pages and the article h1 show it;
+ * - `subtitle`   the rubric (deck): one sentence that carries the facts;
+ * - `seo_title`  the search title for <title> and link previews.
+ *
+ * `title` is the long descriptive title that every article already has; it is the fallback for the
+ * headline and the search title, so nothing changes for an article that carries only a title.
+ * A per-paper homepage override (`StoryDisplay.display_title`/`deck`) still wins where an editor set one.
+ */
+declare const HEADLINE_RECOMMENDED_CHARS = 70;
+declare const HEADLINE_MAX_CHARS = 120;
+declare const FLY_TITLE_MAX_CHARS = 40;
+declare const RUBRIC_MAX_CHARS = 500;
+declare const SEO_TITLE_MAX_CHARS = 200;
+type Headlined = Pick<NewsItem, "slug" | "title" | "section"> & Partial<Pick<NewsItem, "headline" | "fly_title" | "excerpt">> & Partial<Pick<NewsArticle, "subtitle" | "seo_title">>;
+/** Characters, never bytes: Cyrillic, CJK and emoji count once each. */
+declare const headlineLength: (value: string) => number;
+type HeadlineSet = {
+    /** Kicker: the editor's fly title, else the section. */
+    flyTitle?: string;
+    /** Display headline: the paper's override, else the article's headline, else its title. */
+    headline: string;
+    /** Rubric: the paper's deck override, else the subtitle. Never a cut sentence. */
+    rubric?: string;
+    /** Search title for <title> and previews. */
+    seoTitle: string;
+    /** The long descriptive title, for alternativeHeadline when it differs from the headline. */
+    title: string;
+};
+declare function headlineSet(article: Headlined, selection?: HomepageSelection): HeadlineSet;
+/** Validation shared by the edit command and the editors: hard limits match the service. */
+declare function headlineProblems(fields: {
+    headline?: unknown;
+    fly_title?: unknown;
+    subtitle?: unknown;
+    seo_title?: unknown;
+}): string[];
+
 /** Bounded event contract from Walnut Creek Times. Never accept raw form or chat text. */
 declare const ANALYTICS_VERSION = 1;
 declare const ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -675,4 +719,4 @@ declare function isSponsoredStoryItem(item: NewsItem): boolean;
  */
 declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FLY_TITLE_MAX_CHARS, FeatureName, type FeaturedDestination, HEADLINE_MAX_CHARS, HEADLINE_RECOMMENDED_CHARS, type HeadlineSet, 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, RUBRIC_MAX_CHARS, type ResolvedNavigation, SEO_TITLE_MAX_CHARS, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, headlineLength, headlineProblems, headlineSet, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-22lEf_UU.js';
-export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-22lEf_UU.js';
+import { a as PublicationTheme, P as PublicationInput, N as NewsPublication, F as FeatureName, b as NewsItem, H as HomepageSelection, c as NearbyUpdate, E as EditorialSection, d as NewsArticle, C as CouponOffer } from './types-aYDyFCGs.js';
+export { A as ArticleCitation, e as CardType, f as CategoryRef, g as CouponSettings, h as CoverImageMetadata, i as FEATURE_NAMES, j as FeatureFlags, k as NewsFeed, l as NewsLayoutId, m as PublicationModules, R as ReferralSettings, S as StoryDisplay, T as TagRef, V as VerifiedCard, n as VerifiedCardAction, o as VerifiedCardFact, p as VerifiedCardImage } from './types-aYDyFCGs.js';
 export { M as MEET_ACTIVITIES, b as MeetActivity, c as MeetupInput, a as PreparedMeetup, P as PublicPlace, d as activityLabel, e as canHostMeetup, i as isAdult, p as prepareMeetup, s as screenMessage } from './meet-BWpxY20X.js';
 export { b as CLASSIFIED_CATEGORIES, c as ClassifiedCategory, C as ClassifiedListing, E as EmploymentType, J as JOB_EMPLOYMENT_TYPES, d as PreparedClassified, e as PreparedJob, P as PublicDeal, f as PublicDealOffer, a as PublicJob, g as categoryLabel, h as classifiedPath, i as classifiedSearchPath, j as clipChars, k as dealDollars, l as dealGoPath, m as dealsFeedPath, n as employmentLabel, o as isClassifiedCategory, p as isEmploymentType, q as jobEmployerBody, r as jobOpeningBody, s as jobPostingBody, t as prepareClassified, u as prepareJobPost, v as publicJobPath, w as publicJobsPath } from './marketplace-29i5w4LS.js';
-export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-CHdsfUnU.js';
+export { b as PublicationRecord, P as PublicationSnapshot, S as SnapshotHooks, c as SyncSource, a as SyncedPublication, d as acceptRemoteRecord, e as acceptSnapshot, p as parseSnapshot, f as publicationFromSnapshot, g as publicationRecord, s as snapshotFromRecord, h as syncPublication } from './snapshot-CEtTFD_h.js';
 import { CookieCategoryDefinition, CookieConsentRecord } from '@scalemule/compliance';
 export { COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, CookieCategory, CookieCategoryDefinition, CookieConsentRecord, CookieDisclosure, CookiePreferences, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, consentModel, decorateNetworkUrl, effectivePreferences, getCookieConsent, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, queryNetworkConsentHub, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub } from '@scalemule/compliance';
 export { CookieConsentBanner, CookieConsentBannerProps } from './cookie-consent-banner.js';
@@ -249,6 +249,7 @@ declare function composeEdition(items: NewsItem[], selection?: HomepageSelection
     pendingImages: NewsItem[];
     navigation: EditorialSection[];
 };
+/** The paper's override, else the article's short headline, else its long title (see `headlineSet`). */
 declare function displayHeadline(article: NewsItem, selection?: HomepageSelection): string;
 /** A complete existing sentence, not a cut-off or generated summary. */
 declare function briefSummary(article: NewsItem, selection?: HomepageSelection): string;
@@ -404,11 +405,12 @@ declare function newsArticleJsonLd(publication: NewsPublication, article: NewsAr
     mainEntityOfPage: string;
     url: string;
     dateModified?: string | undefined;
+    description: string | undefined;
+    datePublished: string;
+    alternativeHeadline?: string | undefined;
     "@context": string;
     "@type": string;
     headline: string;
-    description: string | undefined;
-    datePublished: string;
 };
 declare function publicationJsonLd(publication: NewsPublication, canonical: string): {
     "@context": string;
@@ -453,6 +455,48 @@ declare function articleMeta(publication: NewsPublication, article: NewsArticle,
 /** One line a paper can serve at /llms.txt. Towns and the article path stay explicit. */
 declare function llmsText(publication: NewsPublication, canonical: string): string;
 
+/**
+ * The newspaper headline set. Every article may carry four pieces of title text, each with a job:
+ *
+ * - `fly_title`  the kicker above the headline: a beat, column or section label (<= 40 characters);
+ * - `headline`   the short display headline, written as a line, not a summary (recommended <= 70,
+ *                hard limit 120); front pages and the article h1 show it;
+ * - `subtitle`   the rubric (deck): one sentence that carries the facts;
+ * - `seo_title`  the search title for <title> and link previews.
+ *
+ * `title` is the long descriptive title that every article already has; it is the fallback for the
+ * headline and the search title, so nothing changes for an article that carries only a title.
+ * A per-paper homepage override (`StoryDisplay.display_title`/`deck`) still wins where an editor set one.
+ */
+declare const HEADLINE_RECOMMENDED_CHARS = 70;
+declare const HEADLINE_MAX_CHARS = 120;
+declare const FLY_TITLE_MAX_CHARS = 40;
+declare const RUBRIC_MAX_CHARS = 500;
+declare const SEO_TITLE_MAX_CHARS = 200;
+type Headlined = Pick<NewsItem, "slug" | "title" | "section"> & Partial<Pick<NewsItem, "headline" | "fly_title" | "excerpt">> & Partial<Pick<NewsArticle, "subtitle" | "seo_title">>;
+/** Characters, never bytes: Cyrillic, CJK and emoji count once each. */
+declare const headlineLength: (value: string) => number;
+type HeadlineSet = {
+    /** Kicker: the editor's fly title, else the section. */
+    flyTitle?: string;
+    /** Display headline: the paper's override, else the article's headline, else its title. */
+    headline: string;
+    /** Rubric: the paper's deck override, else the subtitle. Never a cut sentence. */
+    rubric?: string;
+    /** Search title for <title> and previews. */
+    seoTitle: string;
+    /** The long descriptive title, for alternativeHeadline when it differs from the headline. */
+    title: string;
+};
+declare function headlineSet(article: Headlined, selection?: HomepageSelection): HeadlineSet;
+/** Validation shared by the edit command and the editors: hard limits match the service. */
+declare function headlineProblems(fields: {
+    headline?: unknown;
+    fly_title?: unknown;
+    subtitle?: unknown;
+    seo_title?: unknown;
+}): string[];
+
 /** Bounded event contract from Walnut Creek Times. Never accept raw form or chat text. */
 declare const ANALYTICS_VERSION = 1;
 declare const ANALYTICS_COOKIE = "napsite_analytics_v1";
@@ -675,4 +719,4 @@ declare function isSponsoredStoryItem(item: NewsItem): boolean;
  */
 declare function selectRelevantLocalStories(currentStory: NewsItem, candidates: NewsItem[], publication: Pick<NewsPublication, "regionLabel" | "towns">, limit?: number): NewsItem[];
 
-export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FeatureName, type FeaturedDestination, HomepageSelection, LAYOUT_COOKIE, LOCAL_BRIEFING_POLICY_VERSION, type ListeningArticle, type LocalBriefing, type LocalBriefingItem, type LocalBriefingOptions, Measurement, NAVIGATION_GROUPS, NETWORK_NAVIGATION, NEWS_CACHE, type NavigationConfig, type NavigationContext, type NavigationDestination, type NavigationGroup, type NavigationGroupLinks, type NavigationKind, type NavigationLink, type NavigationOverride, NearbyUpdate, NewsArticle, NewsError, NewsItem, NewsPublication, PublicationInput, PublicationTheme, type ResolvedNavigation, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };
+export { ANALYTICS_COOKIE, ANALYTICS_VERSION, ARTICLE_CONVERSION_EXPERIMENT, type ArticleConversionVariant, ArticleProvenance, type Attribution, BROADSHEET_THEME, type BriefingCandidate, type BriefingPreferences, type BriefingReason, type BriefingSection, type BriefingSource, type BriefingVerification, COOKIE_CATEGORIES, CURATED_COMMUNITY_CARDS, type CommunityInvitationCategory, type ContextualCommunityInvitation, CouponOffer, EDITORIAL_SECTION_ORDER, EVENTS, EditorialSection, type EffectiveTheme, FLY_TITLE_MAX_CHARS, FeatureName, type FeaturedDestination, HEADLINE_MAX_CHARS, HEADLINE_RECOMMENDED_CHARS, type HeadlineSet, 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, RUBRIC_MAX_CHARS, type ResolvedNavigation, SEO_TITLE_MAX_CHARS, SESSION_IDLE_MS, type SponsorshipReport, THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, type ThemeMode, UTM_FIELDS, UUID, activeNearby, applyNavigationConfig, applyTheme, articleCacheKey, articleCacheOptions, articleMeta, articleUrl, attribution, briefSummary, campaignReportHtml, classifyStoryInvitationCategory, clearTheme, composeEdition, composeLocalBriefing, contextualCommunityInvitation, defaultRevalidateTargets, definePublication, displayHeadline, edgeCacheControl, editorialSections, featureEnabled, feedCacheKey, feedCacheOptions, filterNews, getStoredTheme, getSystemTheme, headlineLength, headlineProblems, headlineSet, inventoryCacheOptions, isSponsoredStoryItem, llmsText, matchesStoryTag, measurementConsent, nearbyUpdates, newsArticleJsonLd, normalizedText, orderedSections, publicHttps, publicUrl, publicationJsonLd, publicationListeningCandidates, publicationListeningTrack, publicationMeta, readerSources, recordConsentToCompliance, referralCode, resolveArticleConversionVariant, resolveCoupon, resolveEffectiveTheme, resolveLayout, resolveNavigation, resolveSection, revalidateDecision, secretsMatch, sectionDefinition, sectionId, sectionPath, selectRelevantLocalStories, setTheme, shortDeck, shortText, shouldServeLastKnown, storyDate, storyTowns, subscribeTheme, themeInitScript, townSlug, validCalendarDate, walnutCreekTimes, withLastKnown };

package/dist/index.js

@@ -8,6 +8,7 @@ export { CookieSettingsView } from './chunk-PBRDIXQI.js';
 import { localPublications } from './chunk-NNEY6VBX.js';
 export { COOKIE_CATEGORIES, COOKIE_CONSENT_BACKUP_KEY, COOKIE_CONSENT_EVENT, COOKIE_CONSENT_KEY, COOKIE_CONSENT_MAX_AGE_SECONDS, DEFAULT_CONSENT_HUB_URL, DEFAULT_PREFERENCES_ACCEPTED, DEFAULT_PREFERENCES_REJECTED, EDITORIAL_PRINCIPLES, EU_EEA_UK_COUNTRIES, NETWORK_CONSENT_STORAGE_KEY, NETWORK_PARENT, acceptAllCookies, checkUrlConsentBridge, clearCookieConsent, communityPublications, consentModel, decorateNetworkUrl, effectivePreferences, findPublicationByHost, findPublicationBySlug, getCookieConsent, getNetworkPublicationUrl, getNetworkReaderHandoffUrl, hasConsented, impliedPreferences, isCategoryAllowed, isGeoConsentRequired, listedPublications, localPublications, queryNetworkConsentHub, recordConsentToCompliance, rejectOptionalCookies, setCookieConsent, setNetworkConsentHub, topicalPublications } from './chunk-NNEY6VBX.js';
 export { THEME_COOKIE, THEME_EVENT, THEME_MAX_AGE_SECONDS, THEME_STORAGE_KEY, ThemeToggle, applyTheme, clearTheme, getStoredTheme, getSystemTheme, resolveEffectiveTheme, setTheme, subscribeTheme, themeInitScript } from './chunk-NQD3M7ZY.js';
+export { FLY_TITLE_MAX_CHARS, HEADLINE_MAX_CHARS, HEADLINE_RECOMMENDED_CHARS, RUBRIC_MAX_CHARS, SEO_TITLE_MAX_CHARS, headlineLength, headlineProblems, headlineSet } from './chunk-SNQKSUWB.js';
 export { communityMapEmbeds } from './chunk-IMYBSG7J.js';
 export { articleFormatLabel, articleHeroRatio, articlePresentation, formatArtworkCaption, parseDocumentBlocks, renderArticleBlocksToHtml, sanitizeInlineMarkdown } from './chunk-DN3TBZLK.js';
 import { definePublication } from './chunk-57YVL6BD.js';
@@ -178,7 +179,7 @@ function composeEdition(items, selection = {}, now = Date.now()) {
   return { lead, secondary, briefs, compact, sections: sections2, pendingImages, navigation: editorialSections(inventory) };
 }
 function displayHeadline(article, selection = {}) {
-  return selection.stories?.[article.slug]?.display_title?.trim() || article.title;
+  return selection.stories?.[article.slug]?.display_title?.trim() || article.headline?.trim() || article.title;
 }
 function briefSummary(article, selection = {}) {
   const chosen = selection.stories?.[article.slug]?.brief?.trim();
@@ -266,8 +267,9 @@ function newsArticleJsonLd(publication, article, canonical, authorName) {
   return {
     "@context": "https://schema.org",
     "@type": "NewsArticle",
-    headline: article.title,
-    description: article.excerpt ?? void 0,
+    headline: article.headline?.trim() || article.title,
+    ...article.headline?.trim() && article.headline.trim() !== article.title ? { alternativeHeadline: article.title } : {},
+    description: article.subtitle ?? article.excerpt ?? void 0,
     datePublished: article.published_at,
     ...article.metadata?.editorial?.modified_at ? { dateModified: article.metadata.editorial.modified_at } : {},
     // updated_at also changes for media/operational maintenance. A trusted
@@ -314,15 +316,15 @@ function articleMeta(publication, article, canonical, indexable) {
   const canonicalUrl = publicHttps(article.canonical_url) ?? url;
   const image = publicHttps(article.og_image_url) ?? publicHttps(article.cover_image_url);
   return {
-    title: article.title,
-    description: article.seo_description ?? article.excerpt ?? publication.description,
+    title: article.seo_title?.trim() || article.title,
+    description: article.seo_description ?? article.subtitle ?? article.excerpt ?? publication.description,
     canonical: canonicalUrl,
     indexable: indexable && !article.no_index,
     openGraph: {
       type: "article",
       siteName: publication.name,
-      title: article.title,
-      description: article.excerpt ?? void 0,
+      title: article.headline?.trim() || article.title,
+      description: article.subtitle ?? article.excerpt ?? void 0,
       url,
       publishedTime: article.published_at,
       images: image ? [image] : []

package/dist/{snapshot-BBTow5Bn.d.cts → snapshot-C3kD6oFZ.d.cts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-22lEf_UU.cjs';
+import { P as PublicationInput, N as NewsPublication } from './types-aYDyFCGs.cjs';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/{snapshot-CHdsfUnU.d.ts → snapshot-CEtTFD_h.d.ts}

@@ -1,4 +1,4 @@
-import { P as PublicationInput, N as NewsPublication } from './types-22lEf_UU.js';
+import { P as PublicationInput, N as NewsPublication } from './types-aYDyFCGs.js';
 
 /**
  * Serializable application config. Code hooks (`matchTag`, `coupons.resolve`)

package/dist/snapshot-file.d.cts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-BBTow5Bn.cjs';
-import './types-22lEf_UU.cjs';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-C3kD6oFZ.cjs';
+import './types-aYDyFCGs.cjs';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/snapshot-file.d.ts

@@ -1,5 +1,5 @@
-import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-CHdsfUnU.js';
-import './types-22lEf_UU.js';
+import { P as PublicationSnapshot, S as SnapshotHooks, a as SyncedPublication } from './snapshot-CEtTFD_h.js';
+import './types-aYDyFCGs.js';
 
 declare function readSnapshotFile(file: string): Promise<PublicationSnapshot | null>;
 /**

package/dist/{types-22lEf_UU.d.cts → types-aYDyFCGs.d.cts}

@@ -97,7 +97,12 @@ type CategoryRef = {
 type NewsItem = {
     id: string;
     slug: string;
+    /** The long descriptive title; the fallback for `headline` and `seo_title`. */
     title: string;
+    /** Short display headline for front pages and the article h1 (see `headlineSet`). */
+    headline?: string | null;
+    /** Kicker above the headline; the section is the fallback. */
+    fly_title?: string | null;
     excerpt: string | null;
     cover_image_url: string | null;
     /** Versioned canonical pixel identity supplied by the publication owner. */
@@ -222,11 +227,13 @@ type NewsArticle = NewsItem & {
         cards?: VerifiedCard[] | unknown[];
     };
 };
+/** A paper's own homepage overrides for one story; `fly_title` here overrides the article's kicker on that paper only. */
 type StoryDisplay = {
     display_title?: string;
     deck?: string;
     brief?: string;
     towns?: string[];
+    fly_title?: string;
 };
 type NearbyUpdate = {
     slug: string;

package/dist/{types-22lEf_UU.d.ts → types-aYDyFCGs.d.ts}

@@ -97,7 +97,12 @@ type CategoryRef = {
 type NewsItem = {
     id: string;
     slug: string;
+    /** The long descriptive title; the fallback for `headline` and `seo_title`. */
     title: string;
+    /** Short display headline for front pages and the article h1 (see `headlineSet`). */
+    headline?: string | null;
+    /** Kicker above the headline; the section is the fallback. */
+    fly_title?: string | null;
     excerpt: string | null;
     cover_image_url: string | null;
     /** Versioned canonical pixel identity supplied by the publication owner. */
@@ -222,11 +227,13 @@ type NewsArticle = NewsItem & {
         cards?: VerifiedCard[] | unknown[];
     };
 };
+/** A paper's own homepage overrides for one story; `fly_title` here overrides the article's kicker on that paper only. */
 type StoryDisplay = {
     display_title?: string;
     deck?: string;
     brief?: string;
     towns?: string[];
+    fly_title?: string;
 };
 type NearbyUpdate = {
     slug: string;

package/dist/verified-card.d.cts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { V as VerifiedCard } from './types-22lEf_UU.cjs';
+import { V as VerifiedCard } from './types-aYDyFCGs.cjs';
 
 /**
  * Validate that an action link is safe for readers.

package/dist/verified-card.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { V as VerifiedCard } from './types-22lEf_UU.js';
+import { V as VerifiedCard } from './types-aYDyFCGs.js';
 
 /**
  * Validate that an action link is safe for readers.

package/package.json

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