@soloworks/smking-next 0.21.2 → 0.21.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @soloworks/smking-next
 
+## 0.21.3 — 2026-07-03
+
+**AEO original-vs-enhanced audits can now fetch the true host HTML.**
+
+`<SmkingAEO>` now honors `x-smking-origin-mode: raw` by returning `null`
+before calling the SaaS. This lets Page Zero fetch a customer page's real
+pre-injection HTML for source-change detection, then compare it against the
+served enhanced version. No customer code change; customers already on `^0.21`
+receive it on the next install/update.
+
 ## 0.21.2 — 2026-07-02
 
 **CMS taxonomy page types caught up with the SaaS catalog (types only — no runtime change).**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soloworks/smking-next",
-  "version": "0.21.2",
+  "version": "0.21.3",
   "description": "AI-native SEO (AEO) for Next.js — auto-inject JSON-LD, FAQ, AI summary, and SEO metadata so AI crawlers (ChatGPT, Perplexity, Google AI) can cite your pages.",
   "license": "MIT",
   "homepage": "https://github.com/sillyleo/smking/tree/main/packages/smking-next",
@@ -65,6 +65,11 @@
     "perplexity",
     "smking"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "peerDependencies": {
     "next": "^15.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0"
@@ -86,10 +91,5 @@
     "react-dom": "19.2.4",
     "typescript": "^5",
     "vitest": "^4.1.5"
-  },
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
   }
-}
+}

package/src/cms-blocks.ts

@@ -27,6 +27,35 @@
  * slug-prefix derived, tag mode targets `taxonomies.slug`.
  */
 
+export interface YouTubeEmbedOptions {
+  autoplay?: boolean;
+  ccLangPref?: string;
+  ccLoadPolicy?: boolean;
+  color?: "red" | "white";
+  controls?: boolean;
+  disablekb?: boolean;
+  enablejsapi?: boolean;
+  end?: number;
+  fs?: boolean;
+  hl?: string;
+  ivLoadPolicy?: "show" | "hide";
+  list?: string;
+  listType?: "playlist" | "user_uploads";
+  loop?: boolean;
+  origin?: string;
+  playlist?: string;
+  playsinline?: boolean;
+  relatedMode?: "all" | "same-channel";
+  start?: number;
+  widgetReferrer?: string;
+}
+
+export interface HeroYouTubeProps extends YouTubeEmbedOptions {
+  url: string;
+  videoId: string;
+  thumbnailUrl: string;
+}
+
 export interface HeroProps {
   title: string;
   /** Generic visible meta lines. Legacy drafts may still also carry subtitle. */
@@ -39,6 +68,9 @@ export interface HeroProps {
   /** Legacy single-line fallback for SDK Mode B consumers. */
   subtitle?: string;
   image?: { url: string; alt: string };
+  /** YouTube hero media. Article body renders the embed; cards / metadata use
+   * the thumbnail so list-like pages never mount a player. */
+  youtube?: HeroYouTubeProps;
   cta?: { label: string; href: string };
   /** Header layout — omitted = the original centred hero; "start" = the
    * Apple-newsroom-style left-aligned header; "cover" = title-only banner over
@@ -122,22 +154,16 @@ export interface SearchProps {
   /** Content column vs wide breakout (default wide). Mirrors the media
    * blocks (image/embed). */
   widthMode?: "content" | "wide";
+  /** Quick-link cluster alignment beside the search trigger. Defaults left. */
+  linkAlign?: "left" | "right";
+  /** Quick-link visual treatment. Defaults badge. */
+  linkStyle?: "badge" | "plain";
   /** Optional quick links adjacent to search. */
   links?: SearchQuickLink[];
   /** Publish-time materialized snapshot — every published page on the site. */
   snapshot?: NavSnapshotEntry[];
 }
 
-export interface RecentPostsProps extends ModuleHeader {
-  /** Author-set number of latest posts to show (1..50). */
-  limit: number;
-  /** Content column vs wide breakout (default content). Mirrors the media
-   * blocks. */
-  widthMode?: "content" | "wide";
-  /** Publish-time materialized snapshot — whole-site newest-first. */
-  snapshot?: NavSnapshotEntry[];
-}
-
 /** One author-picked source for nav-related-posts. Same shape as
  * `CategoryIndexItem` (a category path OR a tag), reused so the source picker
  * UI stays identical across blocks. */
@@ -369,7 +395,7 @@ export interface ButtonGroupProps {
  * url = renders nothing on the customer side. `widthMode` matches the other
  * media blocks (content column vs wide breakout).
  */
-export interface EmbedProps {
+export interface EmbedProps extends YouTubeEmbedOptions {
   url?: string;
   caption?: string;
   widthMode?: "content" | "wide";
@@ -416,6 +442,15 @@ export type LatestNewsSlot =
       source?: "category-by-path" | "tag";
     };
 
+/** Whole-block source mode for `latest-news`. Omitted = `manual` so old
+ * blocks keep their curated slots exactly. */
+export type LatestNewsMode =
+  | "manual"
+  | "latest"
+  | "auto-category"
+  | "category"
+  | "tag";
+
 /**
  * One materialized `latest-news` card: the resolved article entry (the
  * article itself for an `article` slot, or the category's latest post for a
@@ -436,8 +471,18 @@ export interface LatestNewsCardSnapshot {
  * feeds; reuses `NavSnapshotEntry` for each resolved card.
  */
 export interface LatestNewsProps extends ModuleHeader {
+  /** Whole-block source mode. Omitted/manual uses `slots`; other modes resolve
+   * cards dynamically at publish time. */
+  mode?: LatestNewsMode;
   /** Author-curated slots, 3–6, in display order (first = feature card). */
   slots: LatestNewsSlot[];
+  /** Card count for automatic modes. The magazine grid supports 3–6 cards. */
+  limit?: number;
+  /** Selected category/tag path for `category` / `tag` modes. */
+  sourcePath?: string;
+  /** Editor-facing label for the selected category/tag; used as the card
+   * eyebrow in automatic source modes. */
+  sourceLabel?: string;
   /** Content column vs wide breakout (default wide). Mirrors the media
    * blocks. */
   widthMode?: "content" | "wide";
@@ -454,7 +499,6 @@ export type Block =
       props: NavTaxonomyListProps;
     }
   | { component: "search"; id: string; props: SearchProps }
-  | { component: "nav-recent-posts"; id: string; props: RecentPostsProps }
   | { component: "nav-related-posts"; id: string; props: RelatedPostsProps }
   | { component: "article-tags"; id: string; props: ArticleTagsProps }
   | { component: "nav-category-index"; id: string; props: CategoryIndexProps }

package/src/components/smking-aeo.tsx

@@ -1,3 +1,5 @@
+import { headers } from "next/headers";
+
 import type { DiscoverParams } from "../types";
 import { getAeoContent } from "../lib/client";
 import { safeJson } from "../lib/safe-json";
@@ -16,6 +18,18 @@ const SR_ONLY_STYLE: React.CSSProperties = {
 
 export interface SmkingAEOProps extends DiscoverParams {}
 
+async function wantsOriginBypass(): Promise<boolean> {
+  try {
+    const requestHeaders = await headers();
+    return (
+      requestHeaders.get("x-smking-origin-mode")?.trim().toLowerCase() ===
+      "raw"
+    );
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Server Component that injects AEO + SEO content for the current
  * request. Place once in the root layout, inside `<body>`:
@@ -57,6 +71,8 @@ export interface SmkingAEOProps extends DiscoverParams {}
  * arbitrary content fetched anywhere.
  */
 export async function SmkingAEO(props: SmkingAEOProps) {
+  if (await wantsOriginBypass()) return null;
+
   const aeo = await getAeoContent(props);
   if (!aeo || aeo.status !== "ready") return null;
 

package/src/index.ts

@@ -25,7 +25,6 @@ export type {
   NavLayout,
   NavSnapshotEntry,
   NavTaxonomyListProps,
-  RecentPostsProps,
   RelatedPostsProps,
   SearchQuickLink,
   SearchQuickLinkSource,

package/src/lib/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = "0.18.0";
+export const SDK_VERSION = "0.21.3";

package/src/types.ts

@@ -85,7 +85,6 @@ export type {
   NavLayout,
   NavSnapshotEntry,
   NavTaxonomyListProps,
-  RecentPostsProps,
   RelatedPostsProps,
   SearchQuickLink,
   SearchQuickLinkSource,