@sonordev/site-kit 6.5.0 → 7.0.1

package/dist/og/route.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/og/route-fit.ts","../../src/og/route.tsx"],"names":["OG_WIDTH","OG_HEIGHT","TITLE_MAX_PX","TITLE_MIN_PX","jsxs","jsx","barTextColor"],"mappings":"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","file":"route.js","sourcesContent":["/**\n * @sonordev/site-kit/og — title fitting for the runtime (Satori) card.\n *\n * The build-time card is fitted in the page: Chrome measures the rendered\n * title and steps it down until it fits (template.ts). The runtime card is\n * Satori, which has no DOM to measure, so its title sat at a fixed 84px,\n * uppercase, with no fitting. Beside the 430px photo that holds about 11\n * characters a line, so a real post title ran off the bottom of the card.\n * watsonhac.com, reinhart and vsf-consulting-nextjs each worked around it by\n * dropping the photo past a hand-picked length (40 or 50 characters).\n *\n * This does what the build-time fitter does, from an estimate instead of a\n * measurement: the same size range (TITLE_MAX_PX down to TITLE_MIN_PX, in 2px\n * steps), word-wrapped at an estimated glyph width against the real column\n * width and the height the kicker, subtitle and bar leave. When the title\n * can't fit beside the photo even at the floor, the photo goes and the title\n * gets the full width.\n *\n * The estimate is deliberately wide (uppercase, bold-ish) so an unusual\n * face errs toward a smaller title, never an overflowing one, and the title\n * box clips at its height as the backstop.\n *\n * Pure: no DOM, no Node built-ins. Geometry constants are the card's own\n * (route.tsx imports them), so the two can't drift.\n */\n\nimport { OG_HEIGHT, OG_WIDTH, TITLE_MAX_PX, TITLE_MIN_PX } from './config'\n\n/** The runtime card's layout, in px. route.tsx renders exactly this. */\nexport const ROUTE_CARD = {\n  padX: 68,\n  gap: 48,\n  photoWidth: 430,\n  photoHeight: 470,\n  barHeight: 74,\n  /** Breathing room above and below the copy column. */\n  padY: 44,\n  kickerPx: 24,\n  kickerGap: 18,\n  subtitlePx: 30,\n  subtitleGap: 20,\n  subtitleLineHeight: 1.3,\n  titleLineHeight: 1.02,\n} as const\n\n/**\n * Average advance of an UPPERCASE glyph, in em. Calibrated against next/og's\n * bundled face and a bold sans; errs wide. Narrow glyphs are counted\n * separately so \"ILLINOIS\" isn't treated like \"MMMMMMMM\".\n */\nconst UPPER_EM = 0.68\nconst NARROW_EM = 0.32\nconst SPACE_EM = 0.3\n/** Mixed-case body text (the subtitle), in em. */\nconst BODY_EM = 0.52\n/** The kicker is uppercase with 6px letter spacing at 24px. */\nconst KICKER_EM = 0.72 + 6 / 24\n\nconst NARROW = /[IJ1.,:;'’!|()\\-]/\n\n/** Estimated width of `text` set uppercase at `px`. */\nexport function uppercaseWidth(text: string, px: number): number {\n  let em = 0\n  for (const ch of text.toUpperCase()) {\n    em += ch === ' ' ? SPACE_EM : NARROW.test(ch) ? NARROW_EM : UPPER_EM\n  }\n  return em * px\n}\n\n/**\n * Lines `text` wraps to in a column `width` px wide, greedy by word, the way\n * the browser and Satori wrap. `\\n` is a hard break. Returns Infinity when a\n * single word is wider than the column: it can't wrap, so no line count fits.\n */\nexport function wrappedLines(\n  text: string,\n  width: number,\n  measure: (s: string) => number,\n): number {\n  let lines = 0\n  for (const paragraph of text.split('\\n')) {\n    const words = paragraph.split(/\\s+/).filter(Boolean)\n    if (!words.length) {\n      lines++\n      continue\n    }\n    let current = ''\n    for (const word of words) {\n      if (measure(word) > width) return Infinity\n      const next = current ? `${current} ${word}` : word\n      if (current && measure(next) > width) {\n        lines++\n        current = word\n      } else {\n        current = next\n      }\n    }\n    lines++\n  }\n  return lines\n}\n\nexport interface RouteFitInput {\n  title: string\n  kicker?: string\n  subtitle?: string\n  /** A photo was offered. */\n  photo: boolean\n  /** The card has a bottom bar. */\n  bar: boolean\n}\n\nexport interface RouteFit {\n  /** Title size in px. */\n  titlePx: number\n  /** Keep the photo. False when the title only fits at full width. */\n  photo: boolean\n  /** Height the title box may use; route.tsx clips the title to it. */\n  titleMaxHeight: number\n  /** The title fits at `titlePx` by the estimate (false only at the floor, full width). */\n  fits: boolean\n}\n\nfunction columnWidth(photo: boolean): number {\n  const inner = OG_WIDTH - ROUTE_CARD.padX * 2\n  return photo ? inner - ROUTE_CARD.photoWidth - ROUTE_CARD.gap : inner\n}\n\n/** Height left for the title once the kicker and subtitle have theirs. */\nfunction titleBudget(input: RouteFitInput, width: number): number {\n  const c = ROUTE_CARD\n  let height = OG_HEIGHT - (input.bar ? c.barHeight : 0) - c.padY * 2\n  if (input.kicker) {\n    const lines = wrappedLines(input.kicker, width, s => s.length * KICKER_EM * c.kickerPx)\n    height -= Math.min(lines, 2) * c.kickerPx * 1.2 + c.kickerGap\n  }\n  if (input.subtitle) {\n    const lines = wrappedLines(input.subtitle, width, s => s.length * BODY_EM * c.subtitlePx)\n    height -= Math.min(lines, 3) * c.subtitlePx * c.subtitleLineHeight + c.subtitleGap\n  }\n  return height\n}\n\n/** Largest title size that fits `width`, or null when none down to the floor does. */\nfunction largestFit(input: RouteFitInput, photo: boolean): { px: number; budget: number } | null {\n  const width = columnWidth(photo)\n  const budget = titleBudget(input, width)\n  for (let px = TITLE_MAX_PX; px >= TITLE_MIN_PX; px -= 2) {\n    const lines = wrappedLines(input.title, width, s => uppercaseWidth(s, px))\n    if (lines * px * ROUTE_CARD.titleLineHeight <= budget) return { px, budget }\n  }\n  return null\n}\n\n/**\n * Size the title, and decide whether the photo stays.\n *\n * Beside the photo first, since the photo is the page's own image and worth\n * keeping. If even the floor size doesn't fit there, drop the photo and fit\n * the full width. If that fails too, the title sits at the floor and clips.\n */\nexport function fitRouteTitle(input: RouteFitInput): RouteFit {\n  if (input.photo) {\n    const withPhoto = largestFit(input, true)\n    if (withPhoto) {\n      return { titlePx: withPhoto.px, photo: true, titleMaxHeight: withPhoto.budget, fits: true }\n    }\n  }\n  const full = largestFit(input, false)\n  if (full) return { titlePx: full.px, photo: false, titleMaxHeight: full.budget, fits: true }\n  return {\n    titlePx: TITLE_MIN_PX,\n    photo: false,\n    titleMaxHeight: titleBudget(input, columnWidth(false)),\n    fits: false,\n  }\n}\n","/**\n * @sonordev/site-kit/og/route — tier 2: per-entity runtime OG cards.\n *\n * `sonor-setup og` covers the build-time cards: the site card and one per\n * route. This covers the cards that must vary per URL and can't wait for a\n * rebuild — one per article, per event, per product — rendered on demand\n * with next/og (Satori).\n *\n * TWO SHAPES, ONE CARD:\n *\n * `createOgImage` is the metadata file convention, and the one to reach for.\n * Next calls an `opengraph-image.tsx` default export with `{ params }` and\n * wires og:image and twitter:image for the page by itself, and `sonor-setup\n * og` sees the file and leaves the folder alone:\n *\n * ```tsx\n * // app/blog/[slug]/opengraph-image.tsx\n * import { createOgImage } from '@sonordev/site-kit/og/route'\n * import { getArticle } from '@sonordev/site-kit/articles/server'\n *\n * export { size, contentType } from '@sonordev/site-kit/og/route'\n * export const alt = 'From the Acme article'\n *\n * export default createOgImage<{ slug: string }>(async ({ slug }) => {\n *   const post = await getArticle(slug)\n *   if (!post) return null                  // 404: a bad slug never renders a card\n *   return {\n *     theme: { bg: '#111110', text: '#faf6f0', accent: '#ad1d25' },\n *     kicker: 'From the publication',\n *     title: post.title,\n *     photoUrl: post.featured_image,       // absolute URL (Satori requirement)\n *     bar: 'yourdomain.com',\n *   }\n * })\n * ```\n *\n * The page then passes `images: false` to generateArticleMetadata: declared\n * images beat the file convention.\n *\n * `createOgImageRoute` is a plain route handler, `GET(request, { params })`,\n * for a card served at a URL of your choosing (`app/og/[slug]/route.tsx`).\n * Next doesn't wire it into metadata; the page declares it.\n *\n * Sites needed an adapter between the two before `createOgImage` existed\n * (watsonhac.com, reinhart, vsf-consulting-nextjs: a default export that\n * built a dummy Request to call the GET handler).\n *\n * SATORI CONSTRAINTS (why this is not the static template): flexbox-only CSS\n * subset, no external stylesheets, images must be absolute URLs or data URIs,\n * and fonts must be provided as ArrayBuffers via `fonts` — Satori cannot load\n * Google Fonts at runtime. Without fonts it falls back to Satori's default\n * face; brand-critical cards should pass font data (fetch the TTF once at\n * module init and reuse the promise).\n *\n * TITLE FITTING: Satori can't measure, so the title is sized from an estimate\n * (og/route-fit.ts) over the same range the build-time card uses, and the\n * photo is dropped when the title can't fit beside it. Long post titles no\n * longer run off the card.\n */\n\nimport React from 'react'\nimport { OG_HEIGHT, OG_WIDTH } from './config'\nimport { barTextColor } from './contrast'\nimport { fitRouteTitle, ROUTE_CARD } from './route-fit'\n\nexport interface OgRouteTheme {\n  bg: string\n  text: string\n  accent: string\n  muted?: string\n  /** og.config.ts's surface color. Only used as a bar-text candidate. */\n  surface?: string\n  /**\n   * Bottom-bar text, set on `accent`. Defaults to the first of `surface`,\n   * `bg`, `text` that reaches WCAG AA for large text (3:1) against the\n   * accent. It used to be `text`, which is unreadable wherever text and\n   * accent are both strong (navy on crimson).\n   */\n  barText?: string\n}\n\nexport interface OgRouteCard {\n  /** og.config.ts's `theme` can be passed as is. */\n  theme: OgRouteTheme\n  kicker?: string\n  title: string\n  subtitle?: string\n  /** Absolute URL (Satori requirement) of the page's own image. */\n  photoUrl?: string\n  /** Bottom-bar text, e.g. the domain. */\n  bar?: string\n}\n\nexport interface OgRouteFont {\n  name: string\n  data: ArrayBuffer\n  weight?: number\n  style?: 'normal' | 'italic'\n}\n\nexport interface OgImageOptions {\n  fonts?: OgRouteFont[]\n}\n\n/** For `export { size, contentType } from '@sonordev/site-kit/og/route'` in an opengraph-image file. */\nexport const size = { width: OG_WIDTH, height: OG_HEIGHT }\nexport const contentType = 'image/png'\n\ntype Resolver<Ctx> = (req: Request, ctx: Ctx) => Promise<OgRouteCard | null> | OgRouteCard | null\n\n/**\n * Satori-safe element tree — exported for tests and for sites that want to\n * extend it inside their own ImageResponse.\n */\nexport function ogRouteElement(card: OgRouteCard): React.ReactElement {\n  const { theme } = card\n  const muted = theme.muted || theme.text\n  // Only an absolute URL (or data URI) renders in Satori; anything else would\n  // throw inside the render, so it's treated as no photo.\n  const hasPhoto = !!card.photoUrl && /^(https?:|data:)/.test(card.photoUrl)\n  const fit = fitRouteTitle({\n    title: card.title,\n    kicker: card.kicker,\n    subtitle: card.subtitle,\n    photo: hasPhoto,\n    bar: !!card.bar,\n  })\n  const titleLine = fit.titlePx * ROUTE_CARD.titleLineHeight\n  // Clip on a whole line, so an estimate that ran short loses a line cleanly\n  // instead of spilling onto the bar.\n  const titleMaxHeight = Math.max(1, Math.floor(fit.titleMaxHeight / titleLine)) * titleLine\n\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n        backgroundColor: theme.bg,\n        color: theme.text,\n        fontSize: 32,\n      }}\n    >\n      <div\n        style={{\n          display: 'flex',\n          flex: 1,\n          alignItems: 'center',\n          padding: `0 ${ROUTE_CARD.padX}px`,\n          gap: ROUTE_CARD.gap,\n          minHeight: 0,\n        }}\n      >\n        <div style={{ display: 'flex', flexDirection: 'column', flex: 1, minWidth: 0 }}>\n          {card.kicker ? (\n            <div\n              style={{\n                fontSize: ROUTE_CARD.kickerPx,\n                letterSpacing: 6,\n                textTransform: 'uppercase',\n                color: theme.accent,\n                marginBottom: ROUTE_CARD.kickerGap,\n                fontWeight: 700,\n              }}\n            >\n              {card.kicker}\n            </div>\n          ) : null}\n          <div\n            style={{\n              display: 'flex',\n              fontSize: fit.titlePx,\n              fontWeight: 800,\n              lineHeight: ROUTE_CARD.titleLineHeight,\n              textTransform: 'uppercase',\n              maxHeight: titleMaxHeight,\n              overflow: 'hidden',\n            }}\n          >\n            {card.title}\n          </div>\n          {card.subtitle ? (\n            <div\n              style={{\n                fontSize: ROUTE_CARD.subtitlePx,\n                marginTop: ROUTE_CARD.subtitleGap,\n                color: muted,\n                lineHeight: ROUTE_CARD.subtitleLineHeight,\n              }}\n            >\n              {card.subtitle}\n            </div>\n          ) : null}\n        </div>\n        {hasPhoto && fit.photo ? (\n          <img\n            src={card.photoUrl}\n            width={ROUTE_CARD.photoWidth}\n            height={ROUTE_CARD.photoHeight}\n            style={{ borderRadius: 24, objectFit: 'cover' }}\n          />\n        ) : null}\n      </div>\n      {card.bar ? (\n        <div\n          style={{\n            display: 'flex',\n            alignItems: 'center',\n            justifyContent: 'center',\n            height: ROUTE_CARD.barHeight,\n            backgroundColor: theme.accent,\n            color: barTextColor(theme),\n            fontSize: 30,\n            fontWeight: 800,\n            letterSpacing: 3,\n            textTransform: 'uppercase',\n          }}\n        >\n          {card.bar}\n        </div>\n      ) : null}\n    </div>\n  )\n}\n\n/**\n * Render a card, or 404 for null. Single source of truth for both factories:\n * the file convention and the route handler differ only in how they're called.\n */\nasync function renderCard(card: OgRouteCard | null, options: OgImageOptions): Promise<Response> {\n  if (!card) return new Response('Not found', { status: 404 })\n\n  // next/og is imported lazily so this module stays importable in test/node\n  // contexts that lack the Next server runtime.\n  const { ImageResponse } = await import('next/og')\n  return new ImageResponse(ogRouteElement(card), {\n    ...size,\n    ...(options.fonts?.length ? { fonts: options.fonts as any } : {}),\n  })\n}\n\n/**\n * Metadata file-convention factory, for `export default` from an\n * `opengraph-image.tsx` (or `twitter-image.tsx`). Next calls it with\n * `{ params }` (a promise on Next 15+) and, with `generateImageMetadata`, an\n * `id`. The resolver gets both already awaited. Return null for a 404.\n */\nexport function createOgImage<Params extends Record<string, string | string[]> = Record<string, string>>(\n  resolve: (params: Params, ctx: { id?: string }) => Promise<OgRouteCard | null> | OgRouteCard | null,\n  options: OgImageOptions = {},\n) {\n  return async function Image(props: {\n    params: Params | Promise<Params>\n    id?: string | Promise<string>\n  }): Promise<Response> {\n    const params = await props.params\n    const id = props.id === undefined ? undefined : await props.id\n    return renderCard(await resolve(params, { id }), options)\n  }\n}\n\n/**\n * Route handler factory, `export const GET` from a `route.tsx`. Returns 404\n * when the resolver returns null, so a bad slug never renders a broken card.\n *\n * Next doesn't wire a route handler into metadata. For a card Next should\n * attach to the page by itself, use `createOgImage` in `opengraph-image.tsx`.\n */\nexport function createOgImageRoute<Ctx = { params: Promise<Record<string, string>> }>(\n  resolve: Resolver<Ctx>,\n  options: OgImageOptions = {},\n) {\n  return async function GET(req: Request, ctx: Ctx): Promise<Response> {\n    return renderCard(await resolve(req, ctx), options)\n  }\n}\n"]}

package/dist/og/route.mjs

@@ -1,239 +0,0 @@
-import { OG_HEIGHT, OG_WIDTH, barTextColor, TITLE_MIN_PX, TITLE_MAX_PX } from '../chunk-YU7QZ3PP.mjs';
-import '../chunk-BEXTDHO4.mjs';
-import { jsxs, jsx } from 'react/jsx-runtime';
-
-// src/og/route-fit.ts
-var ROUTE_CARD = {
-  padX: 68,
-  gap: 48,
-  photoWidth: 430,
-  photoHeight: 470,
-  barHeight: 74,
-  /** Breathing room above and below the copy column. */
-  padY: 44,
-  kickerPx: 24,
-  kickerGap: 18,
-  subtitlePx: 30,
-  subtitleGap: 20,
-  subtitleLineHeight: 1.3,
-  titleLineHeight: 1.02
-};
-var UPPER_EM = 0.68;
-var NARROW_EM = 0.32;
-var SPACE_EM = 0.3;
-var BODY_EM = 0.52;
-var KICKER_EM = 0.72 + 6 / 24;
-var NARROW = /[IJ1.,:;'’!|()\-]/;
-function uppercaseWidth(text, px) {
-  let em = 0;
-  for (const ch of text.toUpperCase()) {
-    em += ch === " " ? SPACE_EM : NARROW.test(ch) ? NARROW_EM : UPPER_EM;
-  }
-  return em * px;
-}
-function wrappedLines(text, width, measure) {
-  let lines = 0;
-  for (const paragraph of text.split("\n")) {
-    const words = paragraph.split(/\s+/).filter(Boolean);
-    if (!words.length) {
-      lines++;
-      continue;
-    }
-    let current = "";
-    for (const word of words) {
-      if (measure(word) > width) return Infinity;
-      const next = current ? `${current} ${word}` : word;
-      if (current && measure(next) > width) {
-        lines++;
-        current = word;
-      } else {
-        current = next;
-      }
-    }
-    lines++;
-  }
-  return lines;
-}
-function columnWidth(photo) {
-  const inner = OG_WIDTH - ROUTE_CARD.padX * 2;
-  return photo ? inner - ROUTE_CARD.photoWidth - ROUTE_CARD.gap : inner;
-}
-function titleBudget(input, width) {
-  const c = ROUTE_CARD;
-  let height = OG_HEIGHT - (input.bar ? c.barHeight : 0) - c.padY * 2;
-  if (input.kicker) {
-    const lines = wrappedLines(input.kicker, width, (s) => s.length * KICKER_EM * c.kickerPx);
-    height -= Math.min(lines, 2) * c.kickerPx * 1.2 + c.kickerGap;
-  }
-  if (input.subtitle) {
-    const lines = wrappedLines(input.subtitle, width, (s) => s.length * BODY_EM * c.subtitlePx);
-    height -= Math.min(lines, 3) * c.subtitlePx * c.subtitleLineHeight + c.subtitleGap;
-  }
-  return height;
-}
-function largestFit(input, photo) {
-  const width = columnWidth(photo);
-  const budget = titleBudget(input, width);
-  for (let px = TITLE_MAX_PX; px >= TITLE_MIN_PX; px -= 2) {
-    const lines = wrappedLines(input.title, width, (s) => uppercaseWidth(s, px));
-    if (lines * px * ROUTE_CARD.titleLineHeight <= budget) return { px, budget };
-  }
-  return null;
-}
-function fitRouteTitle(input) {
-  if (input.photo) {
-    const withPhoto = largestFit(input, true);
-    if (withPhoto) {
-      return { titlePx: withPhoto.px, photo: true, titleMaxHeight: withPhoto.budget, fits: true };
-    }
-  }
-  const full = largestFit(input, false);
-  if (full) return { titlePx: full.px, photo: false, titleMaxHeight: full.budget, fits: true };
-  return {
-    titlePx: TITLE_MIN_PX,
-    photo: false,
-    titleMaxHeight: titleBudget(input, columnWidth(false)),
-    fits: false
-  };
-}
-var size = { width: OG_WIDTH, height: OG_HEIGHT };
-var contentType = "image/png";
-function ogRouteElement(card) {
-  const { theme } = card;
-  const muted = theme.muted || theme.text;
-  const hasPhoto = !!card.photoUrl && /^(https?:|data:)/.test(card.photoUrl);
-  const fit = fitRouteTitle({
-    title: card.title,
-    kicker: card.kicker,
-    subtitle: card.subtitle,
-    photo: hasPhoto,
-    bar: !!card.bar
-  });
-  const titleLine = fit.titlePx * ROUTE_CARD.titleLineHeight;
-  const titleMaxHeight = Math.max(1, Math.floor(fit.titleMaxHeight / titleLine)) * titleLine;
-  return /* @__PURE__ */ jsxs(
-    "div",
-    {
-      style: {
-        width: "100%",
-        height: "100%",
-        display: "flex",
-        flexDirection: "column",
-        backgroundColor: theme.bg,
-        color: theme.text,
-        fontSize: 32
-      },
-      children: [
-        /* @__PURE__ */ jsxs(
-          "div",
-          {
-            style: {
-              display: "flex",
-              flex: 1,
-              alignItems: "center",
-              padding: `0 ${ROUTE_CARD.padX}px`,
-              gap: ROUTE_CARD.gap,
-              minHeight: 0
-            },
-            children: [
-              /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", flex: 1, minWidth: 0 }, children: [
-                card.kicker ? /* @__PURE__ */ jsx(
-                  "div",
-                  {
-                    style: {
-                      fontSize: ROUTE_CARD.kickerPx,
-                      letterSpacing: 6,
-                      textTransform: "uppercase",
-                      color: theme.accent,
-                      marginBottom: ROUTE_CARD.kickerGap,
-                      fontWeight: 700
-                    },
-                    children: card.kicker
-                  }
-                ) : null,
-                /* @__PURE__ */ jsx(
-                  "div",
-                  {
-                    style: {
-                      display: "flex",
-                      fontSize: fit.titlePx,
-                      fontWeight: 800,
-                      lineHeight: ROUTE_CARD.titleLineHeight,
-                      textTransform: "uppercase",
-                      maxHeight: titleMaxHeight,
-                      overflow: "hidden"
-                    },
-                    children: card.title
-                  }
-                ),
-                card.subtitle ? /* @__PURE__ */ jsx(
-                  "div",
-                  {
-                    style: {
-                      fontSize: ROUTE_CARD.subtitlePx,
-                      marginTop: ROUTE_CARD.subtitleGap,
-                      color: muted,
-                      lineHeight: ROUTE_CARD.subtitleLineHeight
-                    },
-                    children: card.subtitle
-                  }
-                ) : null
-              ] }),
-              hasPhoto && fit.photo ? /* @__PURE__ */ jsx(
-                "img",
-                {
-                  src: card.photoUrl,
-                  width: ROUTE_CARD.photoWidth,
-                  height: ROUTE_CARD.photoHeight,
-                  style: { borderRadius: 24, objectFit: "cover" }
-                }
-              ) : null
-            ]
-          }
-        ),
-        card.bar ? /* @__PURE__ */ jsx(
-          "div",
-          {
-            style: {
-              display: "flex",
-              alignItems: "center",
-              justifyContent: "center",
-              height: ROUTE_CARD.barHeight,
-              backgroundColor: theme.accent,
-              color: barTextColor(theme),
-              fontSize: 30,
-              fontWeight: 800,
-              letterSpacing: 3,
-              textTransform: "uppercase"
-            },
-            children: card.bar
-          }
-        ) : null
-      ]
-    }
-  );
-}
-async function renderCard(card, options) {
-  if (!card) return new Response("Not found", { status: 404 });
-  const { ImageResponse } = await import('next/og');
-  return new ImageResponse(ogRouteElement(card), {
-    ...size,
-    ...options.fonts?.length ? { fonts: options.fonts } : {}
-  });
-}
-function createOgImage(resolve, options = {}) {
-  return async function Image(props) {
-    const params = await props.params;
-    const id = props.id === void 0 ? void 0 : await props.id;
-    return renderCard(await resolve(params, { id }), options);
-  };
-}
-function createOgImageRoute(resolve, options = {}) {
-  return async function GET(req, ctx) {
-    return renderCard(await resolve(req, ctx), options);
-  };
-}
-
-export { contentType, createOgImage, createOgImageRoute, ogRouteElement, size };
-//# sourceMappingURL=route.mjs.map
-//# sourceMappingURL=route.mjs.map

package/dist/og/route.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/og/route-fit.ts","../../src/og/route.tsx"],"names":[],"mappings":"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","file":"route.mjs","sourcesContent":["/**\n * @sonordev/site-kit/og — title fitting for the runtime (Satori) card.\n *\n * The build-time card is fitted in the page: Chrome measures the rendered\n * title and steps it down until it fits (template.ts). The runtime card is\n * Satori, which has no DOM to measure, so its title sat at a fixed 84px,\n * uppercase, with no fitting. Beside the 430px photo that holds about 11\n * characters a line, so a real post title ran off the bottom of the card.\n * watsonhac.com, reinhart and vsf-consulting-nextjs each worked around it by\n * dropping the photo past a hand-picked length (40 or 50 characters).\n *\n * This does what the build-time fitter does, from an estimate instead of a\n * measurement: the same size range (TITLE_MAX_PX down to TITLE_MIN_PX, in 2px\n * steps), word-wrapped at an estimated glyph width against the real column\n * width and the height the kicker, subtitle and bar leave. When the title\n * can't fit beside the photo even at the floor, the photo goes and the title\n * gets the full width.\n *\n * The estimate is deliberately wide (uppercase, bold-ish) so an unusual\n * face errs toward a smaller title, never an overflowing one, and the title\n * box clips at its height as the backstop.\n *\n * Pure: no DOM, no Node built-ins. Geometry constants are the card's own\n * (route.tsx imports them), so the two can't drift.\n */\n\nimport { OG_HEIGHT, OG_WIDTH, TITLE_MAX_PX, TITLE_MIN_PX } from './config'\n\n/** The runtime card's layout, in px. route.tsx renders exactly this. */\nexport const ROUTE_CARD = {\n  padX: 68,\n  gap: 48,\n  photoWidth: 430,\n  photoHeight: 470,\n  barHeight: 74,\n  /** Breathing room above and below the copy column. */\n  padY: 44,\n  kickerPx: 24,\n  kickerGap: 18,\n  subtitlePx: 30,\n  subtitleGap: 20,\n  subtitleLineHeight: 1.3,\n  titleLineHeight: 1.02,\n} as const\n\n/**\n * Average advance of an UPPERCASE glyph, in em. Calibrated against next/og's\n * bundled face and a bold sans; errs wide. Narrow glyphs are counted\n * separately so \"ILLINOIS\" isn't treated like \"MMMMMMMM\".\n */\nconst UPPER_EM = 0.68\nconst NARROW_EM = 0.32\nconst SPACE_EM = 0.3\n/** Mixed-case body text (the subtitle), in em. */\nconst BODY_EM = 0.52\n/** The kicker is uppercase with 6px letter spacing at 24px. */\nconst KICKER_EM = 0.72 + 6 / 24\n\nconst NARROW = /[IJ1.,:;'’!|()\\-]/\n\n/** Estimated width of `text` set uppercase at `px`. */\nexport function uppercaseWidth(text: string, px: number): number {\n  let em = 0\n  for (const ch of text.toUpperCase()) {\n    em += ch === ' ' ? SPACE_EM : NARROW.test(ch) ? NARROW_EM : UPPER_EM\n  }\n  return em * px\n}\n\n/**\n * Lines `text` wraps to in a column `width` px wide, greedy by word, the way\n * the browser and Satori wrap. `\\n` is a hard break. Returns Infinity when a\n * single word is wider than the column: it can't wrap, so no line count fits.\n */\nexport function wrappedLines(\n  text: string,\n  width: number,\n  measure: (s: string) => number,\n): number {\n  let lines = 0\n  for (const paragraph of text.split('\\n')) {\n    const words = paragraph.split(/\\s+/).filter(Boolean)\n    if (!words.length) {\n      lines++\n      continue\n    }\n    let current = ''\n    for (const word of words) {\n      if (measure(word) > width) return Infinity\n      const next = current ? `${current} ${word}` : word\n      if (current && measure(next) > width) {\n        lines++\n        current = word\n      } else {\n        current = next\n      }\n    }\n    lines++\n  }\n  return lines\n}\n\nexport interface RouteFitInput {\n  title: string\n  kicker?: string\n  subtitle?: string\n  /** A photo was offered. */\n  photo: boolean\n  /** The card has a bottom bar. */\n  bar: boolean\n}\n\nexport interface RouteFit {\n  /** Title size in px. */\n  titlePx: number\n  /** Keep the photo. False when the title only fits at full width. */\n  photo: boolean\n  /** Height the title box may use; route.tsx clips the title to it. */\n  titleMaxHeight: number\n  /** The title fits at `titlePx` by the estimate (false only at the floor, full width). */\n  fits: boolean\n}\n\nfunction columnWidth(photo: boolean): number {\n  const inner = OG_WIDTH - ROUTE_CARD.padX * 2\n  return photo ? inner - ROUTE_CARD.photoWidth - ROUTE_CARD.gap : inner\n}\n\n/** Height left for the title once the kicker and subtitle have theirs. */\nfunction titleBudget(input: RouteFitInput, width: number): number {\n  const c = ROUTE_CARD\n  let height = OG_HEIGHT - (input.bar ? c.barHeight : 0) - c.padY * 2\n  if (input.kicker) {\n    const lines = wrappedLines(input.kicker, width, s => s.length * KICKER_EM * c.kickerPx)\n    height -= Math.min(lines, 2) * c.kickerPx * 1.2 + c.kickerGap\n  }\n  if (input.subtitle) {\n    const lines = wrappedLines(input.subtitle, width, s => s.length * BODY_EM * c.subtitlePx)\n    height -= Math.min(lines, 3) * c.subtitlePx * c.subtitleLineHeight + c.subtitleGap\n  }\n  return height\n}\n\n/** Largest title size that fits `width`, or null when none down to the floor does. */\nfunction largestFit(input: RouteFitInput, photo: boolean): { px: number; budget: number } | null {\n  const width = columnWidth(photo)\n  const budget = titleBudget(input, width)\n  for (let px = TITLE_MAX_PX; px >= TITLE_MIN_PX; px -= 2) {\n    const lines = wrappedLines(input.title, width, s => uppercaseWidth(s, px))\n    if (lines * px * ROUTE_CARD.titleLineHeight <= budget) return { px, budget }\n  }\n  return null\n}\n\n/**\n * Size the title, and decide whether the photo stays.\n *\n * Beside the photo first, since the photo is the page's own image and worth\n * keeping. If even the floor size doesn't fit there, drop the photo and fit\n * the full width. If that fails too, the title sits at the floor and clips.\n */\nexport function fitRouteTitle(input: RouteFitInput): RouteFit {\n  if (input.photo) {\n    const withPhoto = largestFit(input, true)\n    if (withPhoto) {\n      return { titlePx: withPhoto.px, photo: true, titleMaxHeight: withPhoto.budget, fits: true }\n    }\n  }\n  const full = largestFit(input, false)\n  if (full) return { titlePx: full.px, photo: false, titleMaxHeight: full.budget, fits: true }\n  return {\n    titlePx: TITLE_MIN_PX,\n    photo: false,\n    titleMaxHeight: titleBudget(input, columnWidth(false)),\n    fits: false,\n  }\n}\n","/**\n * @sonordev/site-kit/og/route — tier 2: per-entity runtime OG cards.\n *\n * `sonor-setup og` covers the build-time cards: the site card and one per\n * route. This covers the cards that must vary per URL and can't wait for a\n * rebuild — one per article, per event, per product — rendered on demand\n * with next/og (Satori).\n *\n * TWO SHAPES, ONE CARD:\n *\n * `createOgImage` is the metadata file convention, and the one to reach for.\n * Next calls an `opengraph-image.tsx` default export with `{ params }` and\n * wires og:image and twitter:image for the page by itself, and `sonor-setup\n * og` sees the file and leaves the folder alone:\n *\n * ```tsx\n * // app/blog/[slug]/opengraph-image.tsx\n * import { createOgImage } from '@sonordev/site-kit/og/route'\n * import { getArticle } from '@sonordev/site-kit/articles/server'\n *\n * export { size, contentType } from '@sonordev/site-kit/og/route'\n * export const alt = 'From the Acme article'\n *\n * export default createOgImage<{ slug: string }>(async ({ slug }) => {\n *   const post = await getArticle(slug)\n *   if (!post) return null                  // 404: a bad slug never renders a card\n *   return {\n *     theme: { bg: '#111110', text: '#faf6f0', accent: '#ad1d25' },\n *     kicker: 'From the publication',\n *     title: post.title,\n *     photoUrl: post.featured_image,       // absolute URL (Satori requirement)\n *     bar: 'yourdomain.com',\n *   }\n * })\n * ```\n *\n * The page then passes `images: false` to generateArticleMetadata: declared\n * images beat the file convention.\n *\n * `createOgImageRoute` is a plain route handler, `GET(request, { params })`,\n * for a card served at a URL of your choosing (`app/og/[slug]/route.tsx`).\n * Next doesn't wire it into metadata; the page declares it.\n *\n * Sites needed an adapter between the two before `createOgImage` existed\n * (watsonhac.com, reinhart, vsf-consulting-nextjs: a default export that\n * built a dummy Request to call the GET handler).\n *\n * SATORI CONSTRAINTS (why this is not the static template): flexbox-only CSS\n * subset, no external stylesheets, images must be absolute URLs or data URIs,\n * and fonts must be provided as ArrayBuffers via `fonts` — Satori cannot load\n * Google Fonts at runtime. Without fonts it falls back to Satori's default\n * face; brand-critical cards should pass font data (fetch the TTF once at\n * module init and reuse the promise).\n *\n * TITLE FITTING: Satori can't measure, so the title is sized from an estimate\n * (og/route-fit.ts) over the same range the build-time card uses, and the\n * photo is dropped when the title can't fit beside it. Long post titles no\n * longer run off the card.\n */\n\nimport React from 'react'\nimport { OG_HEIGHT, OG_WIDTH } from './config'\nimport { barTextColor } from './contrast'\nimport { fitRouteTitle, ROUTE_CARD } from './route-fit'\n\nexport interface OgRouteTheme {\n  bg: string\n  text: string\n  accent: string\n  muted?: string\n  /** og.config.ts's surface color. Only used as a bar-text candidate. */\n  surface?: string\n  /**\n   * Bottom-bar text, set on `accent`. Defaults to the first of `surface`,\n   * `bg`, `text` that reaches WCAG AA for large text (3:1) against the\n   * accent. It used to be `text`, which is unreadable wherever text and\n   * accent are both strong (navy on crimson).\n   */\n  barText?: string\n}\n\nexport interface OgRouteCard {\n  /** og.config.ts's `theme` can be passed as is. */\n  theme: OgRouteTheme\n  kicker?: string\n  title: string\n  subtitle?: string\n  /** Absolute URL (Satori requirement) of the page's own image. */\n  photoUrl?: string\n  /** Bottom-bar text, e.g. the domain. */\n  bar?: string\n}\n\nexport interface OgRouteFont {\n  name: string\n  data: ArrayBuffer\n  weight?: number\n  style?: 'normal' | 'italic'\n}\n\nexport interface OgImageOptions {\n  fonts?: OgRouteFont[]\n}\n\n/** For `export { size, contentType } from '@sonordev/site-kit/og/route'` in an opengraph-image file. */\nexport const size = { width: OG_WIDTH, height: OG_HEIGHT }\nexport const contentType = 'image/png'\n\ntype Resolver<Ctx> = (req: Request, ctx: Ctx) => Promise<OgRouteCard | null> | OgRouteCard | null\n\n/**\n * Satori-safe element tree — exported for tests and for sites that want to\n * extend it inside their own ImageResponse.\n */\nexport function ogRouteElement(card: OgRouteCard): React.ReactElement {\n  const { theme } = card\n  const muted = theme.muted || theme.text\n  // Only an absolute URL (or data URI) renders in Satori; anything else would\n  // throw inside the render, so it's treated as no photo.\n  const hasPhoto = !!card.photoUrl && /^(https?:|data:)/.test(card.photoUrl)\n  const fit = fitRouteTitle({\n    title: card.title,\n    kicker: card.kicker,\n    subtitle: card.subtitle,\n    photo: hasPhoto,\n    bar: !!card.bar,\n  })\n  const titleLine = fit.titlePx * ROUTE_CARD.titleLineHeight\n  // Clip on a whole line, so an estimate that ran short loses a line cleanly\n  // instead of spilling onto the bar.\n  const titleMaxHeight = Math.max(1, Math.floor(fit.titleMaxHeight / titleLine)) * titleLine\n\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n        backgroundColor: theme.bg,\n        color: theme.text,\n        fontSize: 32,\n      }}\n    >\n      <div\n        style={{\n          display: 'flex',\n          flex: 1,\n          alignItems: 'center',\n          padding: `0 ${ROUTE_CARD.padX}px`,\n          gap: ROUTE_CARD.gap,\n          minHeight: 0,\n        }}\n      >\n        <div style={{ display: 'flex', flexDirection: 'column', flex: 1, minWidth: 0 }}>\n          {card.kicker ? (\n            <div\n              style={{\n                fontSize: ROUTE_CARD.kickerPx,\n                letterSpacing: 6,\n                textTransform: 'uppercase',\n                color: theme.accent,\n                marginBottom: ROUTE_CARD.kickerGap,\n                fontWeight: 700,\n              }}\n            >\n              {card.kicker}\n            </div>\n          ) : null}\n          <div\n            style={{\n              display: 'flex',\n              fontSize: fit.titlePx,\n              fontWeight: 800,\n              lineHeight: ROUTE_CARD.titleLineHeight,\n              textTransform: 'uppercase',\n              maxHeight: titleMaxHeight,\n              overflow: 'hidden',\n            }}\n          >\n            {card.title}\n          </div>\n          {card.subtitle ? (\n            <div\n              style={{\n                fontSize: ROUTE_CARD.subtitlePx,\n                marginTop: ROUTE_CARD.subtitleGap,\n                color: muted,\n                lineHeight: ROUTE_CARD.subtitleLineHeight,\n              }}\n            >\n              {card.subtitle}\n            </div>\n          ) : null}\n        </div>\n        {hasPhoto && fit.photo ? (\n          <img\n            src={card.photoUrl}\n            width={ROUTE_CARD.photoWidth}\n            height={ROUTE_CARD.photoHeight}\n            style={{ borderRadius: 24, objectFit: 'cover' }}\n          />\n        ) : null}\n      </div>\n      {card.bar ? (\n        <div\n          style={{\n            display: 'flex',\n            alignItems: 'center',\n            justifyContent: 'center',\n            height: ROUTE_CARD.barHeight,\n            backgroundColor: theme.accent,\n            color: barTextColor(theme),\n            fontSize: 30,\n            fontWeight: 800,\n            letterSpacing: 3,\n            textTransform: 'uppercase',\n          }}\n        >\n          {card.bar}\n        </div>\n      ) : null}\n    </div>\n  )\n}\n\n/**\n * Render a card, or 404 for null. Single source of truth for both factories:\n * the file convention and the route handler differ only in how they're called.\n */\nasync function renderCard(card: OgRouteCard | null, options: OgImageOptions): Promise<Response> {\n  if (!card) return new Response('Not found', { status: 404 })\n\n  // next/og is imported lazily so this module stays importable in test/node\n  // contexts that lack the Next server runtime.\n  const { ImageResponse } = await import('next/og')\n  return new ImageResponse(ogRouteElement(card), {\n    ...size,\n    ...(options.fonts?.length ? { fonts: options.fonts as any } : {}),\n  })\n}\n\n/**\n * Metadata file-convention factory, for `export default` from an\n * `opengraph-image.tsx` (or `twitter-image.tsx`). Next calls it with\n * `{ params }` (a promise on Next 15+) and, with `generateImageMetadata`, an\n * `id`. The resolver gets both already awaited. Return null for a 404.\n */\nexport function createOgImage<Params extends Record<string, string | string[]> = Record<string, string>>(\n  resolve: (params: Params, ctx: { id?: string }) => Promise<OgRouteCard | null> | OgRouteCard | null,\n  options: OgImageOptions = {},\n) {\n  return async function Image(props: {\n    params: Params | Promise<Params>\n    id?: string | Promise<string>\n  }): Promise<Response> {\n    const params = await props.params\n    const id = props.id === undefined ? undefined : await props.id\n    return renderCard(await resolve(params, { id }), options)\n  }\n}\n\n/**\n * Route handler factory, `export const GET` from a `route.tsx`. Returns 404\n * when the resolver returns null, so a bad slug never renders a broken card.\n *\n * Next doesn't wire a route handler into metadata. For a card Next should\n * attach to the page by itself, use `createOgImage` in `opengraph-image.tsx`.\n */\nexport function createOgImageRoute<Ctx = { params: Promise<Record<string, string>> }>(\n  resolve: Resolver<Ctx>,\n  options: OgImageOptions = {},\n) {\n  return async function GET(req: Request, ctx: Ctx): Promise<Response> {\n    return renderCard(await resolve(req, ctx), options)\n  }\n}\n"]}

package/dist/og/template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/og/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAA;AAqKhE,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA2ExD"}

package/dist/og/wiring.d.ts

@@ -1,100 +0,0 @@
-/**
- * @sonordev/site-kit/og — the single source of truth for "is this site's OG
- * wiring correct".
- *
- * SINGLE SOURCE OF TRUTH, deliberately. This rule had two independent
- * implementations — `sonor-setup og`'s post-render check and the doctor's
- * `og.card` check — and BOTH were wrong the same way: they told a site to add
- * `openGraph.images: ['/og.png']` to the root layout. Since per-page cards
- * landed that advice actively breaks the site, because declared images override
- * the per-page card files. Two copies of a rule that inverted is exactly why it
- * lives in one function now. Never re-fork it.
- *
- * The rule itself, verified against real Next builds rather than assumed:
- *
- *   1. Config metadata BEATS the `opengraph-image` file convention. A route
- *      whose generateMetadata returns `openGraph.images` overrides its own card
- *      file. So a site with per-page cards must declare NO images anywhere —
- *      including `seo_pages.managed_og_image`, which site-kit serves into
- *      openGraph.images for every managed page.
- *   2. File metadata does NOT cascade to child segments. A card at `services/`
- *      is not inherited by `services/[city]`; a dynamic segment needs its own.
- *   3. A site with NO per-page cards still needs the layout to reference the
- *      site card, which is the original check and still correct in that mode.
- *   4. Next spells a code-based card's URL with no extension
- *      (`/article/x/opengraph-image`), and `trailingSlash: true` 308s it. Such a
- *      page declares the slashed URL (`codeCardImage`) instead.
- *
- * `summary_large_image` and the code-card rules read the site's code through
- * `shared/source-graph`, which follows imports into `lib/` helpers and
- * monorepo workspace packages. They used to grep the root layout alone, and
- * almost no site sets `twitter.card` there.
- *
- * `managed_og_image` is only reported when it's KNOWN to be set: the caller
- * passes the pages Sonor says have one (`sonor-setup og` reads them while
- * titling cards; `doctor --online` asks). It used to be a warning on every
- * per-page site, set or not, which taught people to ignore the check.
- *
- * Node-only (fs/path): never import from browser or client code.
- */
-export interface OgWiringFacts {
-    /** `public/og.png` (or a sibling) exists. */
-    siteCard: boolean;
-    /**
-     * Absolute paths of every `opengraph-image.*` / `twitter-image.*` found
-     * anywhere under app/: static images AND code-generated cards
-     * (`opengraph-image.tsx` and friends). Declared metadata overrides both.
-     */
-    pageCards: string[];
-    /** The root layout declares an `images: [...]` array. */
-    layoutDeclaresImages: boolean;
-    /**
-     * `summary_large_image` is set somewhere the pages run: the root layout or
-     * a page, or a helper either imports. A `twitter-image` file counts too
-     * (Next sets the large card for it).
-     */
-    largeCard: boolean;
-    /** The root layout references the site card at all. */
-    referencesImage: boolean;
-    /** Root layout was found. */
-    layoutFound: boolean;
-    /** next.config sets `trailingSlash: true`. */
-    trailingSlash?: boolean;
-    /** Code-based cards (`opengraph-image.tsx`) and what their page does about them. */
-    codeCards?: OgCodeCardFacts[];
-    /**
-     * Paths whose seo_pages row sets managed_og_image, when known. Undefined
-     * means nobody asked Sonor, which is not the same as none.
-     */
-    managedOgImages?: string[];
-}
-export interface OgCodeCardFacts {
-    /** Project-relative card file. */
-    file: string;
-    /** Route pattern, `/article/*`. */
-    route: string;
-    /** The page (or a helper it imports) declares the card with `codeCardImage`. */
-    declaresUrl: boolean;
-    /** The page calls generateArticleMetadata without `images: false`. */
-    articleDeclaresImages: boolean;
-}
-export interface OgWiringProblem {
-    message: string;
-    fix: string;
-}
-/** Every `opengraph-image.*` under the app directory, at any depth. */
-export declare function findPageCards(cwd: string): string[];
-/** Read the observable facts. No judgement here — that is `judgeOgWiring`. */
-export declare function readOgWiring(cwd: string, known?: {
-    managedOgImages?: string[];
-}): OgWiringFacts;
-/**
- * Turn the facts into problems, in the order that matters most. Empty array
- * means the wiring is right.
- */
-export declare function judgeOgWiring(facts: OgWiringFacts): OgWiringProblem[];
-/** Convenience: read + judge in one call. */
-export declare function checkOgWiring(cwd: string, known?: {
-    managedOgImages?: string[];
-}): OgWiringProblem[];
-//# sourceMappingURL=wiring.d.ts.map

package/dist/og/wiring.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../src/og/wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAOH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,yDAAyD;IACzD,oBAAoB,EAAE,OAAO,CAAA;IAC7B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAA;IACxB,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAA;IACpB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,oFAAoF;IACpF,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAA;IACpB,sEAAsE;IACtE,qBAAqB,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ;AAYD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBnD;AAwED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,aAAa,CAqCnG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,EAAE,CAoErE;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,eAAe,EAAE,CAExG"}

package/dist/portfolio/contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/portfolio/contract.ts"],"names":[],"mappings":"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"}

package/dist/portfolio/contract.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/portfolio/contract.ts"],"names":[],"mappings":"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","file":"contract.js","sourcesContent":["/**\n * @sonordev/site-kit/portfolio/contract — portfolio proof display policy (v1)\n *\n * Single source of truth for the Lighthouse-KPI collapse policy shared by the\n * content side (signal-api generation) and the render side (agency-site-kit\n * display). Same pattern as the other site-kit contracts:\n *  - agency-site-kit imports these directly (it already depends on site-kit)\n *    from `src/portfolio/curate-proof.ts`, which keeps the render-only\n *    primitives that bind to its section types.\n *  - signal-api keeps a byte-identical inline mirror\n *    (`src/modules/skills/portfolio/portfolio-kpi-policy.util.ts`) guarded by\n *    the shared drift-test vectors in `contract.test.ts`.\n *\n * Why it exists: generated case studies arrived with four \"100/100 Lighthouse X\"\n * KPIs repeated across hero, results cards, and a Performance section. One\n * differentiator repeated a dozen times stops differentiating — collapse the\n * per-category Lighthouse tiles to at most one summary, business outcomes first.\n *\n * It is also the single source of truth for METRIC PROVENANCE (below): the\n * three sources a portfolio number can have, what a client-reported number\n * must carry, and which numbers may headline. sonor-api and signal-api keep\n * byte-identical mirrors of those functions too, guarded by the same vectors.\n */\n\n// The live-frame handshake a case study's device frames listen for: defined\n// with the frame rules in shared/frame.ts, re-exported here because the\n// portfolio renderers are the ones listening.\nexport { FRAME_READY_MESSAGE, isFrameReadyMessage, type FrameReadyMessage } from '../shared/frame'\n\n/** Bump on breaking changes to the collapse policy. */\nexport const PORTFOLIO_CONTRACT_VERSION = 1 as const\n\n/** Minimal KPI shape the policy reads — callers pass their own richer tiles. */\nexport interface KpiLike {\n  label: string\n  value: number\n  description?: string\n}\n\nconst LIGHTHOUSE_RE = /lighthouse/i\n\n/** True when a KPI tile is a per-category Lighthouse score. */\nexport function isLighthouseKpi(kpi: Pick<KpiLike, 'label'>): boolean {\n  return LIGHTHOUSE_RE.test(kpi.label || '')\n}\n\n/**\n * Collapse per-category Lighthouse KPIs to at most one summary tile, business\n * outcomes first. When every category is present at 100 the summary says so;\n * otherwise the Performance category (the one buyers know) represents the set.\n * Fewer than two Lighthouse tiles → returned unchanged.\n */\nexport function curateHeroKpis<T extends KpiLike>(kpis: T[]): T[] {\n  const business = kpis.filter((k) => !isLighthouseKpi(k))\n  const lighthouse = kpis.filter(isLighthouseKpi)\n  if (lighthouse.length <= 1) return kpis\n\n  const allPerfect = lighthouse.length >= 4 && lighthouse.every((k) => k.value === 100)\n  const summary: T = allPerfect\n    ? {\n        ...lighthouse[0],\n        label: 'Lighthouse, all 4 categories',\n        description: 'Perfect scores across performance, SEO, accessibility, and best practices.',\n      }\n    : (lighthouse.find((k) => /performance/i.test(k.label)) ?? lighthouse[0])\n\n  return [...business, summary]\n}\n\n/**\n * Agent-native contract: JSON Schema for the minimal KPI shape, so services and\n * agents can validate tiles before applying the collapse policy.\n */\nexport const PORTFOLIO_KPI_JSON_SCHEMA = {\n  $schema: 'http://json-schema.org/draft-07/schema#',\n  $id: 'https://sonor.io/schemas/portfolio-kpi.v1.json',\n  title: 'KpiLike',\n  description: 'The subset of a portfolio KPI tile the Lighthouse-collapse policy reads.',\n  type: 'object',\n  required: ['label', 'value'],\n  properties: {\n    label: { type: 'string' },\n    value: { type: 'number' },\n    description: { type: 'string' },\n    source: { enum: ['measured', 'reported', 'estimated'] },\n    reportedBy: {\n      type: 'object',\n      required: ['name', 'organization', 'date'],\n      properties: {\n        name: { type: 'string', minLength: 1 },\n        role: { type: 'string' },\n        organization: { type: 'string', minLength: 1 },\n        date: { type: 'string', pattern: '^\\\\d{4}-\\\\d{2}-\\\\d{2}$' },\n      },\n    },\n  },\n  // A reported number is only valid with someone named behind it.\n  if: { properties: { source: { const: 'reported' } }, required: ['source'] },\n  then: { required: ['reportedBy'] },\n  additionalProperties: true,\n} as const\n\n// ─── Metric provenance ──────────────────────────────────────────────────────\n//\n// Where a published portfolio number came from. The three sources are not\n// grades of confidence, they're three different claims, and no surface may\n// let one pass as another:\n//\n//  - measured:  we measured it (Lighthouse, analytics, a count anyone can\n//               re-run against the live site).\n//  - reported:  the client told us, and a named person at the client stands\n//               behind it. Revenue, headcount and signed work can only ever\n//               be this, because we can't see a client's books. It always\n//               carries `reportedBy`, and every surface that shows it says\n//               whose number it is.\n//  - estimated: a reasonable projection. It never headlines anything.\n//\n// Proof is the strongest thing a case study has, and the client's own numbers\n// are usually the strongest proof. Before 'reported' existed they had nowhere\n// honest to go: tagging True Power Systems' \"$1M in signed work from web\n// leads\" as measured would have been false, and as estimated both false and\n// buried (2026-09-25).\n\n/** Every source a portfolio number can have. */\nexport const METRIC_SOURCES = ['measured', 'reported', 'estimated'] as const\nexport type MetricSource = (typeof METRIC_SOURCES)[number]\n\n/** Who stands behind a client-reported number. */\nexport interface MetricAttribution {\n  /** The person, e.g. \"Scott Mann\". */\n  name: string\n  /** Their title, e.g. \"Director of Business Development\". */\n  role?: string\n  /** Where they work: almost always the client, e.g. \"True Power Systems\". */\n  organization: string\n  /** The day they reported it, YYYY-MM-DD. */\n  date: string\n}\n\n/** The provenance fields a portfolio number (a KPI tile, a results card) carries. */\nexport interface SourcedMetric {\n  source?: string | null\n  reportedBy?: unknown\n}\n\nconst ISO_DAY_RE = /^\\d{4}-\\d{2}-\\d{2}$/\nconst MONTHS = [\n  'January', 'February', 'March', 'April', 'May', 'June',\n  'July', 'August', 'September', 'October', 'November', 'December',\n]\n\nexport function isMetricSource(value: unknown): value is MetricSource {\n  return typeof value === 'string' && (METRIC_SOURCES as readonly string[]).includes(value)\n}\n\n/**\n * What's wrong with a number's provenance, or null when nothing is. A missing\n * source is legacy data and passes (displays show it unlabelled, and it can't\n * headline); an unknown source, or a reported number nobody is named behind,\n * does not.\n */\nexport function metricSourceProblem(metric: SourcedMetric): string | null {\n  if (metric.source === undefined || metric.source === null) return null\n  if (!isMetricSource(metric.source)) return `source must be one of ${METRIC_SOURCES.join(', ')}`\n  if (metric.source !== 'reported') return null\n  const by = metric.reportedBy as Partial<MetricAttribution> | null | undefined\n  if (!by || typeof by !== 'object') {\n    return 'a reported number needs reportedBy: who reported it, where they work, and when'\n  }\n  if (typeof by.name !== 'string' || !by.name.trim()) return 'reportedBy.name is required'\n  if (typeof by.organization !== 'string' || !by.organization.trim()) {\n    return 'reportedBy.organization is required'\n  }\n  if (typeof by.date !== 'string' || !ISO_DAY_RE.test(by.date) || Number.isNaN(Date.parse(by.date))) {\n    return 'reportedBy.date must be a real day, YYYY-MM-DD'\n  }\n  if (by.role !== undefined && typeof by.role !== 'string') return 'reportedBy.role must be text'\n  return null\n}\n\n/**\n * May this number lead: a hero tile, a gallery card, a carousel, a social\n * post? Measured, or reported with someone named behind it. Never an\n * estimate, and never an unlabelled legacy number.\n */\nexport function isHeadlineMetric(metric: SourcedMetric): boolean {\n  if (metric.source === 'measured') return true\n  return metric.source === 'reported' && metricSourceProblem(metric) === null\n}\n\n/** The badge a display shows, or null for a missing or unknown source (show nothing rather than guess). */\nexport function metricSourceLabel(source: unknown): string | null {\n  if (source === 'measured') return 'Measured'\n  if (source === 'reported') return 'Client-reported'\n  if (source === 'estimated') return 'Estimated'\n  return null\n}\n\n/**\n * The full credit: \"Reported by Scott Mann, Director of Business Development,\n * True Power Systems, September 25, 2026\". The date is read as a plain day,\n * never through a time zone, so it can't slip to the day before.\n */\nexport function formatAttribution(by: MetricAttribution): string {\n  const [year, month, day] = by.date.split('-').map(Number)\n  const when = MONTHS[month - 1] ? `${MONTHS[month - 1]} ${day}, ${year}` : by.date\n  return [`Reported by ${by.name.trim()}`, by.role?.trim(), by.organization.trim(), when]\n    .filter(Boolean)\n    .join(', ')\n}\n\n/** The credit for a tight space (a card, a carousel tile): \"per True Power Systems\". */\nexport function shortAttribution(by: Pick<MetricAttribution, 'organization'>): string {\n  return `per ${by.organization.trim()}`\n}\n\n/**\n * Carry a person's reported numbers through a regeneration. The generator can\n * only write measured or estimated numbers (it can't see a client's books, and\n * any 'reported' tag it writes is dropped here), so without this a rewrite of\n * the hero or the results would silently erase what a client told us.\n * Reported entries from `previous` lead, in their order; `next` fills in\n * behind them, minus anything sharing a key with a reported entry.\n */\nexport function carryReportedMetrics<T extends SourcedMetric>(\n  previous: readonly T[] | null | undefined,\n  next: readonly T[] | null | undefined,\n  keyOf: (metric: T) => string,\n): T[] {\n  const norm = (metric: T) => String(keyOf(metric) ?? '').trim().toLowerCase()\n  const reported = (previous ?? []).filter((m) => m?.source === 'reported')\n  const taken = new Set(reported.map(norm))\n  const generated = (next ?? []).filter((m) => m && m.source !== 'reported' && !taken.has(norm(m)))\n  return [...reported, ...generated]\n}\n"]}

package/dist/portfolio/contract.mjs

@@ -1,115 +0,0 @@
-export { FRAME_READY_MESSAGE, isFrameReadyMessage } from '../chunk-MXJOKOFK.mjs';
-import '../chunk-BEXTDHO4.mjs';
-
-// src/portfolio/contract.ts
-var PORTFOLIO_CONTRACT_VERSION = 1;
-var LIGHTHOUSE_RE = /lighthouse/i;
-function isLighthouseKpi(kpi) {
-  return LIGHTHOUSE_RE.test(kpi.label || "");
-}
-function curateHeroKpis(kpis) {
-  const business = kpis.filter((k) => !isLighthouseKpi(k));
-  const lighthouse = kpis.filter(isLighthouseKpi);
-  if (lighthouse.length <= 1) return kpis;
-  const allPerfect = lighthouse.length >= 4 && lighthouse.every((k) => k.value === 100);
-  const summary = allPerfect ? {
-    ...lighthouse[0],
-    label: "Lighthouse, all 4 categories",
-    description: "Perfect scores across performance, SEO, accessibility, and best practices."
-  } : lighthouse.find((k) => /performance/i.test(k.label)) ?? lighthouse[0];
-  return [...business, summary];
-}
-var PORTFOLIO_KPI_JSON_SCHEMA = {
-  $schema: "http://json-schema.org/draft-07/schema#",
-  $id: "https://sonor.io/schemas/portfolio-kpi.v1.json",
-  title: "KpiLike",
-  description: "The subset of a portfolio KPI tile the Lighthouse-collapse policy reads.",
-  type: "object",
-  required: ["label", "value"],
-  properties: {
-    label: { type: "string" },
-    value: { type: "number" },
-    description: { type: "string" },
-    source: { enum: ["measured", "reported", "estimated"] },
-    reportedBy: {
-      type: "object",
-      required: ["name", "organization", "date"],
-      properties: {
-        name: { type: "string", minLength: 1 },
-        role: { type: "string" },
-        organization: { type: "string", minLength: 1 },
-        date: { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$" }
-      }
-    }
-  },
-  // A reported number is only valid with someone named behind it.
-  if: { properties: { source: { const: "reported" } }, required: ["source"] },
-  then: { required: ["reportedBy"] },
-  additionalProperties: true
-};
-var METRIC_SOURCES = ["measured", "reported", "estimated"];
-var ISO_DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
-var MONTHS = [
-  "January",
-  "February",
-  "March",
-  "April",
-  "May",
-  "June",
-  "July",
-  "August",
-  "September",
-  "October",
-  "November",
-  "December"
-];
-function isMetricSource(value) {
-  return typeof value === "string" && METRIC_SOURCES.includes(value);
-}
-function metricSourceProblem(metric) {
-  if (metric.source === void 0 || metric.source === null) return null;
-  if (!isMetricSource(metric.source)) return `source must be one of ${METRIC_SOURCES.join(", ")}`;
-  if (metric.source !== "reported") return null;
-  const by = metric.reportedBy;
-  if (!by || typeof by !== "object") {
-    return "a reported number needs reportedBy: who reported it, where they work, and when";
-  }
-  if (typeof by.name !== "string" || !by.name.trim()) return "reportedBy.name is required";
-  if (typeof by.organization !== "string" || !by.organization.trim()) {
-    return "reportedBy.organization is required";
-  }
-  if (typeof by.date !== "string" || !ISO_DAY_RE.test(by.date) || Number.isNaN(Date.parse(by.date))) {
-    return "reportedBy.date must be a real day, YYYY-MM-DD";
-  }
-  if (by.role !== void 0 && typeof by.role !== "string") return "reportedBy.role must be text";
-  return null;
-}
-function isHeadlineMetric(metric) {
-  if (metric.source === "measured") return true;
-  return metric.source === "reported" && metricSourceProblem(metric) === null;
-}
-function metricSourceLabel(source) {
-  if (source === "measured") return "Measured";
-  if (source === "reported") return "Client-reported";
-  if (source === "estimated") return "Estimated";
-  return null;
-}
-function formatAttribution(by) {
-  const [year, month, day] = by.date.split("-").map(Number);
-  const when = MONTHS[month - 1] ? `${MONTHS[month - 1]} ${day}, ${year}` : by.date;
-  return [`Reported by ${by.name.trim()}`, by.role?.trim(), by.organization.trim(), when].filter(Boolean).join(", ");
-}
-function shortAttribution(by) {
-  return `per ${by.organization.trim()}`;
-}
-function carryReportedMetrics(previous, next, keyOf) {
-  const norm = (metric) => String(keyOf(metric) ?? "").trim().toLowerCase();
-  const reported = (previous ?? []).filter((m) => m?.source === "reported");
-  const taken = new Set(reported.map(norm));
-  const generated = (next ?? []).filter((m) => m && m.source !== "reported" && !taken.has(norm(m)));
-  return [...reported, ...generated];
-}
-
-export { METRIC_SOURCES, PORTFOLIO_CONTRACT_VERSION, PORTFOLIO_KPI_JSON_SCHEMA, carryReportedMetrics, curateHeroKpis, formatAttribution, isHeadlineMetric, isLighthouseKpi, isMetricSource, metricSourceLabel, metricSourceProblem, shortAttribution };
-//# sourceMappingURL=contract.mjs.map
-//# sourceMappingURL=contract.mjs.map