@soloworks/smking-next 0.19.0 → 0.20.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @soloworks/smking-next
 
+## 0.20.1 — 2026-06-03
+
+**Chore: removed dead carousel / nav-recent-posts / nav-search block types.**
+
+Dropped `NavRecentPostsProps`, `NavSearchIndexEntry`, `NavSearchProps`,
+`CarouselSlideProps`, `CarouselAspectRatio`, and `CarouselProps` from
+`types.ts`. Narrowed the `Block` union to the three active block components
+(`hero`, `article`, `nav-taxonomy-list`). `NavLayout` (layout enum including
+`"carousel"`) is unchanged — that value controls nav rendering style, not a
+separate block type.
+
+## 0.20.0 — 2026-06-02
+
+**`<SmkingCms>` now emits the structured-data engine's JSON-LD `@graph` inline.**
+
+CMS pages get a full multi-entity `@graph` (BlogPosting / Organization /
+WebSite / BreadcrumbList / FAQPage, `@id`-linked) generated by the smking
+structured-data engine and served via `/api/v1/public/page`. `<SmkingCms>`
+inlines it as `<script type="application/ld+json">` — JSON-LD is valid in
+`<body>`, so no head hoisting needed (unlike `<title>`/`<meta>`, which
+React 19 still hoists for you). The `safeJson` escaper (`</` + U+2028/U+2029)
+is extracted into a shared `lib/safe-json.ts` that `<SmkingAEO>` imports too.
+
+No customer code change — `<SmkingCms>` picks up the new `jsonLd` field
+automatically once a page is republished under the engine. Bump your
+constraint to `^0.20`.
+
 ## 0.19.0 — 2026-05-29
 
 **CMS base path reported via heartbeat — dashboard "View page" resolves real URLs without per-page visits.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soloworks/smking-next",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "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",

package/src/components/smking-aeo.tsx

@@ -1,5 +1,6 @@
 import type { DiscoverParams } from "../types";
 import { getAeoContent } from "../lib/client";
+import { safeJson } from "../lib/safe-json";
 
 const SR_ONLY_STYLE: React.CSSProperties = {
   position: "absolute",
@@ -118,17 +119,3 @@ export async function SmkingAEO(props: SmkingAEOProps) {
     </>
   );
 }
-
-/**
- * Escape JSON for safe `<script>` embedding. Covers the three values
- * that can break out:
- *   - `</` (any `</script>`-like sequence)
- *   - U+2028 / U+2029 (treated as line terminators inside a JS string
- *     literal, which would corrupt the embedded JSON)
- */
-function safeJson(value: Record<string, unknown>): string {
-  return JSON.stringify(value)
-    .replace(/<\//g, "<\\/")
-    .replace(/\u2028/g, "\\u2028")
-    .replace(/\u2029/g, "\\u2029");
-}

package/src/components/smking-cms.tsx

@@ -1,4 +1,5 @@
 import { getCmsPage } from "../lib/cms-client";
+import { safeJson } from "../lib/safe-json";
 import type { CmsParams } from "../types";
 
 /**
@@ -72,6 +73,17 @@ export async function SmkingCms(props: CmsParams) {
         <link rel="canonical" href={seo.canonicalUrl} data-smking="cms" />
       )}
 
+      {/* Engine-precomputed @graph. JSON-LD is valid in <body>, so no
+          head hoisting needed (unlike title/meta above). */}
+      {data.page.jsonLd && (
+        <script
+          type="application/ld+json"
+          data-smking="cms"
+          // eslint-disable-next-line react/no-danger -- escaped via safeJson; engine output is schema-bounded
+          dangerouslySetInnerHTML={{ __html: safeJson(data.page.jsonLd) }}
+        />
+      )}
+
       {/* Raw passthrough — bodyHtml is SaaS-emitted Plate output (Tailwind
           utility + slate-* hooks + data-slate-* attrs all intact). No
           article shell, no canonical CSS injection: what the dashboard

package/src/lib/safe-json.ts

@@ -0,0 +1,21 @@
+/**
+ * Escape an object for safe `<script type="application/ld+json">`
+ * embedding. Covers the sequences that can break out of / corrupt the
+ * script:
+ *   - `</` (any `</script>`-like sequence)
+ *   - U+2028 / U+2029 (JS string-literal line terminators)
+ *
+ * The U+2028 / U+2029 patterns are built via `new RegExp("\\u2028", ...)`
+ * (escaped-backslash strings) so this source file stays pure ASCII — no
+ * invisible line-separator characters to corrupt on edit.
+ *
+ * Shared by `<SmkingAEO>` and `<SmkingCms>`. Engine output is
+ * schema-bounded, but this guard is mandatory defence-in-depth — never
+ * inline JSON-LD without it.
+ */
+export function safeJson(value: Record<string, unknown>): string {
+  return JSON.stringify(value)
+    .replace(/<\//g, "<\\/")
+    .replace(new RegExp("\\u2028", "g"), "\\u2028")
+    .replace(new RegExp("\\u2029", "g"), "\\u2029");
+}

package/src/types.ts

@@ -102,13 +102,6 @@ export interface NavSnapshotEntry {
   contentType: "article" | "landing" | "listing" | null;
 }
 
-export interface NavRecentPostsProps extends ModuleHeader {
-  limit: number;
-  layout: NavLayout;
-  contentType?: "article" | "all";
-  /** Publish-time materialized — never fetched live. */
-  snapshot?: NavSnapshotEntry[];
-}
 export interface NavTaxonomyListProps extends ModuleHeader {
   /** category-by-path: slug prefix; tag: taxonomies.slug */
   source: "category-by-path" | "tag";
@@ -119,56 +112,10 @@ export interface NavTaxonomyListProps extends ModuleHeader {
   snapshot?: NavSnapshotEntry[];
 }
 
-/**
- * Search index entry. Customer SDK does client-side fuzzy filter
- * against this list; clicking a result navigates to the slug.
- */
-export interface NavSearchIndexEntry {
-  slug: string;
-  title: string | null;
-  excerpt: string | null;
-}
-
-export interface NavSearchProps {
-  placeholder: string;
-  contentType?: "article" | "all";
-  /** Publish-time materialized full-site search index. */
-  index?: NavSearchIndexEntry[];
-}
-
-export interface CarouselSlideProps {
-  imageUrl: string;
-  caption: string;
-}
-
-export type CarouselAspectRatio =
-  | "16:9"
-  | "4:3"
-  | "1:1"
-  | "3:4"
-  | "9:16";
-
-export interface CarouselProps {
-  slides: CarouselSlideProps[];
-  /** Fixed aspect ratio for all slides — image fills via `object-fit: cover`. Default `16:9`. */
-  aspectRatio?: CarouselAspectRatio;
-}
-
 export type Block =
   | { component: "hero"; id: string; props: HeroProps }
   | { component: "article"; id: string; props: ArticleProps }
-  | { component: "carousel"; id: string; props: CarouselProps }
-  | {
-      component: "nav-recent-posts";
-      id: string;
-      props: NavRecentPostsProps;
-    }
-  | {
-      component: "nav-taxonomy-list";
-      id: string;
-      props: NavTaxonomyListProps;
-    }
-  | { component: "nav-search"; id: string; props: NavSearchProps };
+  | { component: "nav-taxonomy-list"; id: string; props: NavTaxonomyListProps };
 
 /**
  * A single published CMS page returned by the smking public API
@@ -191,6 +138,12 @@ export interface CmsPage {
   excerpt?: string | null;
   featuredImageUrl?: string | null;
   publishedAt: string | null;
+  /**
+   * v0.M1+ engine-precomputed schema.org @graph. `<SmkingCms>` inlines it
+   * as `<script type="application/ld+json">`. Null until the page is
+   * republished under the structured-data engine.
+   */
+  jsonLd?: Record<string, unknown> | null;
 }
 
 /**