@sonordev/contracts 2.12.0 → 2.15.0

package/dist/portfolio.d.ts

@@ -35,11 +35,11 @@ export declare const CASE_STUDY_STAGE_COPY: Record<CaseStudyStage, {
     question: string;
 }>;
 /**
- * An agency's own names for the four stages ("Heat", "Shape", "Temper",
- * "Finish"), set once in the dashboard and read everywhere a stage is named:
- * the editor, the public portfolio config, the agency's site. A stage left
- * unnamed falls back to its generic name. The ids never change; only what
- * people see does.
+ * A site's own names for the four stages ("Heat", "Shape", "Temper",
+ * "Finish"), set per project in the dashboard (branding is per project) and
+ * read everywhere a stage is named: the editor, the public portfolio config,
+ * the site itself. A stage left unnamed falls back to its generic name. The
+ * ids never change; only what people see does.
  */
 export type CaseStudyStageNames = Partial<Record<CaseStudyStage, string>>;
 /** The longest a stage name may run. It's a heading word, a rail label, a tab. */
@@ -49,7 +49,7 @@ export declare const STAGE_NAME_MAX_CHARS = 24;
  * (generic names); present must be an object of short text keyed by stage.
  */
 export declare function stageNamesProblems(names: unknown): string[];
-/** The name a stage is shown under: the agency's own when set, else the generic one. */
+/** The name a stage is shown under: the site's own when set, else the generic one. */
 export declare function stageName(names: CaseStudyStageNames | null | undefined, stage: CaseStudyStage): string;
 /**
  * Every section type a case study can hold, in canonical reading order:

package/dist/publication-branding.d.ts

@@ -9,11 +9,12 @@ export type PublicationPlatform = (typeof PUBLICATION_PLATFORMS)[number];
 /** The sections of a profile and of each platform override, in the order they're read. */
 export declare const PUBLICATION_BRANDING_SECTIONS: readonly ['identity', 'colors', 'typography', 'editorial', 'newsletter'];
 export type PublicationBrandingSection = (typeof PUBLICATION_BRANDING_SECTIONS)[number];
-export declare const PUBLICATION_IDENTITY_FIELDS: readonly ['publicationName', 'wordmark', 'tagline', 'publisherName', 'publisherUrl', 'publisherLogoUrl', 'logos'];
+export declare const PUBLICATION_IDENTITY_FIELDS: readonly ['publicationName', 'wordmark', 'tagline', 'publisherName', 'publisherUrl', 'publisherLogoUrl', 'logos', 'squareLogoUrl', 'fullLogoUrl'];
 export declare const PUBLICATION_LOGO_VARIANTS: readonly ['default', 'light', 'dark'];
 export declare const PUBLICATION_COLOR_FIELDS: readonly ['primary', 'secondary', 'accent', 'background', 'surface', 'text', 'muted', 'border'];
 export declare const PUBLICATION_TYPOGRAPHY_FIELDS: readonly ['heading', 'body', 'mono', 'emailHeadingFallback', 'emailBodyFallback'];
-export declare const PUBLICATION_EDITORIAL_FIELDS: readonly ['articleStyle', 'cardLayout', 'charter', 'siteCharters'];
+export declare const PUBLICATION_EDITORIAL_FIELDS: readonly ['articleStyle', 'cardLayout', 'focusClosingBackground', 'charter', 'siteCharters'];
+export declare const FOCUS_CLOSING_BACKGROUNDS: readonly ['planned_photo', 'article_atmosphere'];
 export declare const PUBLICATION_NEWSLETTER_FIELDS: readonly ['name', 'tagline', 'layout', 'maxWidth'];
 /** Fonts every email client has, the only families an email fallback may name. Lowercase. */
 export declare const EMAIL_SAFE_FONTS: ReadonlySet<string>;
@@ -27,6 +28,11 @@ export interface PublicationIdentity {
     publisherUrl?: string;
     /** The publisher's attribution mark, separate from the publication masthead. */
     publisherLogoUrl?: string;
+    /** The publication's square mark; independent of theme variants and publisher attribution. */
+    squareLogoUrl?: string;
+    /** The publication's full/display logo; wordmark remains a text fallback. */
+    fullLogoUrl?: string;
+    /** Legacy theme variants, not square/full logo roles. */
     logos?: {
         default?: string;
         light?: string;
@@ -56,6 +62,8 @@ export interface PublicationEditorial {
     /** Shared Broadcast style for articles, reviews and generated posts; portfolio is excluded. Legacy wire name. */
     articleStyle?: BroadcastStyleId;
     cardLayout?: PublicationCardLayout;
+    /** Focus closing frames may reuse the article's saved atmosphere and real author portrait. */
+    focusClosingBackground?: (typeof FOCUS_CLOSING_BACKGROUNDS)[number];
 }
 export interface PublicationNewsletter {
     name?: string;

package/dist/publication-branding.js

@@ -134,11 +134,12 @@ function publicationCharterContext(charter) {
 var PUBLICATION_BRANDING_VERSION = 1;
 var PUBLICATION_PLATFORMS = ["publication", "email", "social", "instagram", "facebook", "linkedin", "gbp"];
 var PUBLICATION_BRANDING_SECTIONS = ["identity", "colors", "typography", "editorial", "newsletter"];
-var PUBLICATION_IDENTITY_FIELDS = ["publicationName", "wordmark", "tagline", "publisherName", "publisherUrl", "publisherLogoUrl", "logos"];
+var PUBLICATION_IDENTITY_FIELDS = ["publicationName", "wordmark", "tagline", "publisherName", "publisherUrl", "publisherLogoUrl", "logos", "squareLogoUrl", "fullLogoUrl"];
 var PUBLICATION_LOGO_VARIANTS = ["default", "light", "dark"];
 var PUBLICATION_COLOR_FIELDS = ["primary", "secondary", "accent", "background", "surface", "text", "muted", "border"];
 var PUBLICATION_TYPOGRAPHY_FIELDS = ["heading", "body", "mono", "emailHeadingFallback", "emailBodyFallback"];
-var PUBLICATION_EDITORIAL_FIELDS = ["articleStyle", "cardLayout", "charter", "siteCharters"];
+var PUBLICATION_EDITORIAL_FIELDS = ["articleStyle", "cardLayout", "focusClosingBackground", "charter", "siteCharters"];
+var FOCUS_CLOSING_BACKGROUNDS = ["planned_photo", "article_atmosphere"];
 var PUBLICATION_NEWSLETTER_FIELDS = ["name", "tagline", "layout", "maxWidth"];
 var EMAIL_SAFE_FONTS = /* @__PURE__ */ new Set([
   "arial",
@@ -279,7 +280,7 @@ function createPublicationBrandingValidator(options) {
               throw new PublicationBrandingValidationError(`${prefix}.${key}`, error.message);
             }
           }
-          const allowed = key === "articleStyle" ? BROADCAST_STYLES : patch ? PUBLICATION_CARD_LAYOUTS : SAVED_PUBLICATION_CARD_LAYOUTS;
+          const allowed = key === "articleStyle" ? BROADCAST_STYLES : key === "focusClosingBackground" ? FOCUS_CLOSING_BACKGROUNDS : patch ? PUBLICATION_CARD_LAYOUTS : SAVED_PUBLICATION_CARD_LAYOUTS;
           if (typeof v !== "string" || !allowed.includes(v)) throw new PublicationBrandingValidationError(`${prefix}.${key}`, `choose ${allowed.join(", ")}`);
           return v;
         });
@@ -328,6 +329,7 @@ function createPublicationBrandingValidator(options) {
 }
 
 exports.EMAIL_SAFE_FONTS = EMAIL_SAFE_FONTS;
+exports.FOCUS_CLOSING_BACKGROUNDS = FOCUS_CLOSING_BACKGROUNDS;
 exports.GENERIC_FONT_FAMILIES = GENERIC_FONT_FAMILIES;
 exports.PUBLICATION_BRANDING_SECTIONS = PUBLICATION_BRANDING_SECTIONS;
 exports.PUBLICATION_BRANDING_VERSION = PUBLICATION_BRANDING_VERSION;

package/dist/publication-branding.mjs

@@ -132,11 +132,12 @@ function publicationCharterContext(charter) {
 var PUBLICATION_BRANDING_VERSION = 1;
 var PUBLICATION_PLATFORMS = ["publication", "email", "social", "instagram", "facebook", "linkedin", "gbp"];
 var PUBLICATION_BRANDING_SECTIONS = ["identity", "colors", "typography", "editorial", "newsletter"];
-var PUBLICATION_IDENTITY_FIELDS = ["publicationName", "wordmark", "tagline", "publisherName", "publisherUrl", "publisherLogoUrl", "logos"];
+var PUBLICATION_IDENTITY_FIELDS = ["publicationName", "wordmark", "tagline", "publisherName", "publisherUrl", "publisherLogoUrl", "logos", "squareLogoUrl", "fullLogoUrl"];
 var PUBLICATION_LOGO_VARIANTS = ["default", "light", "dark"];
 var PUBLICATION_COLOR_FIELDS = ["primary", "secondary", "accent", "background", "surface", "text", "muted", "border"];
 var PUBLICATION_TYPOGRAPHY_FIELDS = ["heading", "body", "mono", "emailHeadingFallback", "emailBodyFallback"];
-var PUBLICATION_EDITORIAL_FIELDS = ["articleStyle", "cardLayout", "charter", "siteCharters"];
+var PUBLICATION_EDITORIAL_FIELDS = ["articleStyle", "cardLayout", "focusClosingBackground", "charter", "siteCharters"];
+var FOCUS_CLOSING_BACKGROUNDS = ["planned_photo", "article_atmosphere"];
 var PUBLICATION_NEWSLETTER_FIELDS = ["name", "tagline", "layout", "maxWidth"];
 var EMAIL_SAFE_FONTS = /* @__PURE__ */ new Set([
   "arial",
@@ -277,7 +278,7 @@ function createPublicationBrandingValidator(options) {
               throw new PublicationBrandingValidationError(`${prefix}.${key}`, error.message);
             }
           }
-          const allowed = key === "articleStyle" ? BROADCAST_STYLES : patch ? PUBLICATION_CARD_LAYOUTS : SAVED_PUBLICATION_CARD_LAYOUTS;
+          const allowed = key === "articleStyle" ? BROADCAST_STYLES : key === "focusClosingBackground" ? FOCUS_CLOSING_BACKGROUNDS : patch ? PUBLICATION_CARD_LAYOUTS : SAVED_PUBLICATION_CARD_LAYOUTS;
           if (typeof v !== "string" || !allowed.includes(v)) throw new PublicationBrandingValidationError(`${prefix}.${key}`, `choose ${allowed.join(", ")}`);
           return v;
         });
@@ -325,4 +326,4 @@ function createPublicationBrandingValidator(options) {
   };
 }
 
-export { EMAIL_SAFE_FONTS, GENERIC_FONT_FAMILIES, PUBLICATION_BRANDING_SECTIONS, PUBLICATION_BRANDING_VERSION, PUBLICATION_CHARTER_FIELDS, PUBLICATION_COLOR_FIELDS, PUBLICATION_EDITORIAL_FIELDS, PUBLICATION_IDENTITY_FIELDS, PUBLICATION_LOGO_VARIANTS, PUBLICATION_NEWSLETTER_FIELDS, PUBLICATION_PLATFORMS, PUBLICATION_TYPOGRAPHY_FIELDS, PublicationBrandingValidationError, containsControlCharacters, createPublicationBrandingValidator, mergePublicationBrandingLayers, parsePublicationCharter, parseSiteCharters, publicationCharterContext, publicationCharterFor, safeFontStack };
+export { EMAIL_SAFE_FONTS, FOCUS_CLOSING_BACKGROUNDS, GENERIC_FONT_FAMILIES, PUBLICATION_BRANDING_SECTIONS, PUBLICATION_BRANDING_VERSION, PUBLICATION_CHARTER_FIELDS, PUBLICATION_COLOR_FIELDS, PUBLICATION_EDITORIAL_FIELDS, PUBLICATION_IDENTITY_FIELDS, PUBLICATION_LOGO_VARIANTS, PUBLICATION_NEWSLETTER_FIELDS, PUBLICATION_PLATFORMS, PUBLICATION_TYPOGRAPHY_FIELDS, PublicationBrandingValidationError, containsControlCharacters, createPublicationBrandingValidator, mergePublicationBrandingLayers, parsePublicationCharter, parseSiteCharters, publicationCharterContext, publicationCharterFor, safeFontStack };

package/dist/site-cache.d.ts

@@ -29,6 +29,8 @@ export declare const SITE_CACHE_TAGS: {
     readonly portfolio: 'portfolio';
     /** Products, services, events and membership plans (commerce-kit). */
     readonly commerce: 'commerce';
+    /** Published managed landing pages. Draft previews never enter this cache. */
+    readonly funnels: 'sonor-funnels';
 };
 export type SiteCacheTag = (typeof SITE_CACHE_TAGS)[keyof typeof SITE_CACHE_TAGS];
 /** The body Sonor POSTs to the revalidation route. */

package/dist/site-cache.js

@@ -14,7 +14,9 @@ var SITE_CACHE_TAGS = {
   /** Portfolio items (agency-site-kit). */
   portfolio: "portfolio",
   /** Products, services, events and membership plans (commerce-kit). */
-  commerce: "commerce"
+  commerce: "commerce",
+  /** Published managed landing pages. Draft previews never enter this cache. */
+  funnels: "sonor-funnels"
 };
 function isSiteRevalidatePong(body) {
   return typeof body === "object" && body !== null && body.ok === true && body.ping === true;

package/dist/site-cache.mjs

@@ -12,7 +12,9 @@ var SITE_CACHE_TAGS = {
   /** Portfolio items (agency-site-kit). */
   portfolio: "portfolio",
   /** Products, services, events and membership plans (commerce-kit). */
-  commerce: "commerce"
+  commerce: "commerce",
+  /** Published managed landing pages. Draft previews never enter this cache. */
+  funnels: "sonor-funnels"
 };
 function isSiteRevalidatePong(body) {
   return typeof body === "object" && body !== null && body.ok === true && body.ping === true;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sonordev/contracts",
-  "version": "2.12.0",
-  "description": "The rules Sonor's sites, APIs and dashboard share: popup blocks and site design tokens, site hosts, SEO page identity, title quality, llms.txt sanitizers, the forms honeypot, fleet heartbeats, slot content and signing, site cache tags, portfolio metrics, the house voice's contraction rule, how a proposal's site plan counts its pages, what separates an error page from a page's content, which stored JSON-LD is a template's unfilled placeholder, where prose splits into sentences, which Sonor records Signal reads into a project's knowledge and the address each one is stored under, what outbound email and text may claim about a business and whether a sent email arrived intact, what a segment of outreach is and who may turn one on, a page's own name taken from its title or its slug, which Broadcast card layouts and review compositions are drawn and what a retired one draws as, what a publication's branding may hold, and which literal hosts are refused as public fetch destinations. Pure functions, no dependencies.",
+  "version": "2.15.0",
+  "description": "The rules Sonor's sites, APIs and dashboard share: popup blocks and site design tokens, site hosts, SEO page identity, title quality, llms.txt sanitizers, the forms honeypot, fleet heartbeats, slot content and signing, site cache tags, portfolio metrics, the house voice's contraction rule, how a proposal's site plan counts its pages, what separates an error page from a page's content, which stored JSON-LD is a template's unfilled placeholder, where prose splits into sentences, which Sonor records Signal reads into a project's knowledge and the address each one is stored under, what outbound email and text may claim about a business and whether a sent email arrived intact, what a segment of outreach is and who may turn one on, a page's own name taken from its title or its slug, which Broadcast card layouts and review compositions are drawn and what a retired one draws as, what a publication's branding may hold, which literal hosts are refused as public fetch destinations, and which inbox cards are decisions a bulk action leaves alone. Pure functions, no dependencies.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -130,8 +130,7 @@
       "types": "./dist/page-titles.d.ts",
       "import": "./dist/page-titles.mjs",
       "require": "./dist/page-titles.js"
-    }
-,
+    },
     "./broadcast-layouts": {
       "types": "./dist/broadcast-layouts.d.ts",
       "import": "./dist/broadcast-layouts.mjs",
@@ -146,6 +145,16 @@
       "types": "./dist/public-url-host.d.ts",
       "import": "./dist/public-url-host.mjs",
       "require": "./dist/public-url-host.js"
+    },
+    "./inbox": {
+      "types": "./dist/inbox.d.ts",
+      "import": "./dist/inbox.mjs",
+      "require": "./dist/inbox.js"
+    },
+    "./funnels": {
+      "types": "./dist/funnels.d.ts",
+      "import": "./dist/funnels.mjs",
+      "require": "./dist/funnels.js"
     }
   },
   "typesVersions": {