@cosmicdrift/kumiko-headless 0.84.0 → 0.85.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-headless",
-  "version": "0.84.0",
+  "version": "0.85.0",
   "description": "Headless UI logic for Kumiko — Dispatcher contract, Form-Controller, View-Model, Nav-Resolver. Plattform- und React-frei; jeder Renderer (renderer, renderer-web, renderer-native, …) komponiert darauf.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -32,7 +32,7 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.84.0",
+    "@cosmicdrift/kumiko-framework": "0.85.0",
     "zod": "^4.4.3"
   },
   "publishConfig": {

package/src/apex/__tests__/render.test.ts

@@ -141,4 +141,86 @@ describe("renderApexPage", () => {
     expect(html).toContain("id='raw'");
     expect(html).toContain("trust-item");
   });
+
+  test("renders robots meta when set, absent when omitted", () => {
+    const without = renderApexPage(page());
+    expect(without).not.toContain("robots");
+    const withRobots = renderApexPage(
+      page({ head: { lang: "de", title: "T", description: "D", robots: "noindex, nofollow" } }),
+    );
+    expect(withRobots).toContain('<meta name="robots" content="noindex, nofollow" />');
+  });
+
+  test("renders og:site_name and og:locale", () => {
+    const html = renderApexPage(
+      page({
+        head: {
+          lang: "de",
+          title: "T",
+          description: "D",
+          siteName: "Acme",
+          locale: "de_DE",
+        },
+      }),
+    );
+    expect(html).toContain('<meta property="og:site_name" content="Acme" />');
+    expect(html).toContain('<meta property="og:locale" content="de_DE" />');
+  });
+
+  test("renders twitter:card when ogImage is set, plus twitter:site", () => {
+    const html = renderApexPage(
+      page({
+        head: {
+          lang: "de",
+          title: "T",
+          description: "D",
+          ogImage: "https://example.com/image.png",
+          twitterSite: "@acme",
+        },
+      }),
+    );
+    expect(html).toContain('<meta name="twitter:card" content="summary_large_image" />');
+    expect(html).toContain('<meta name="twitter:site" content="@acme" />');
+  });
+
+  test("does not render twitter:card without ogImage", () => {
+    const html = renderApexPage(
+      page({
+        head: { lang: "de", title: "T", description: "D", twitterSite: "@acme" },
+      }),
+    );
+    expect(html).not.toContain("twitter:card");
+    expect(html).toContain("twitter:site");
+  });
+
+  test("renders preconnect links", () => {
+    const html = renderApexPage(
+      page({
+        head: {
+          lang: "de",
+          title: "T",
+          description: "D",
+          preconnects: ["https://fonts.example.com", "https://api.example.com"],
+        },
+      }),
+    );
+    expect(html).toContain('<link rel="preconnect" href="https://fonts.example.com" />');
+    expect(html).toContain('<link rel="preconnect" href="https://api.example.com" />');
+  });
+
+  test("renders schemaJson as json-ld script tag", () => {
+    const html = renderApexPage(
+      page({
+        head: {
+          lang: "de",
+          title: "T",
+          description: "D",
+          schemaJson: { "@context": "https://schema.org", "@type": "WebSite", name: "Acme" },
+        },
+      }),
+    );
+    expect(html).toContain('<script type="application/ld+json">');
+    expect(html).toContain('{"@context":"https://schema.org","@type":"WebSite","name":"Acme"}');
+    expect(html).toContain("</script>");
+  });
 });

package/src/apex/index.ts

@@ -140,6 +140,18 @@ export type ApexHead = {
   readonly ogImage?: string;
   /** hreflang alternates for multilingual SEO (e.g. the other language's URL). */
   readonly alternates?: readonly { readonly hreflang: string; readonly href: string }[];
+  /** Robots meta content (e.g. "index, follow", "noindex, nofollow"). Omit = no tag. */
+  readonly robots?: string;
+  /** og:site_name — brand name for social shares. */
+  readonly siteName?: string;
+  /** og:locale — e.g. "de_DE", "en_US". */
+  readonly locale?: string;
+  /** twitter:site — @handle for X/Twitter card. */
+  readonly twitterSite?: string;
+  /** URLs for <link rel="preconnect"> hints (Core Web Vitals). */
+  readonly preconnects?: readonly string[];
+  /** Arbitrary JSON-LD structured data (Schema.org). Rendered as-is into <script type="application/ld+json">. */
+  readonly schemaJson?: Record<string, unknown>;
 };
 
 export type ApexPage = {
@@ -393,6 +405,33 @@ export function renderApexPage(page: ApexPage): string {
         `\n    <link rel="alternate" hreflang="${escapeHtml(a.hreflang)}" href="${escapeHtml(a.href)}" />`,
     )
     .join("");
+  const robots =
+    head.robots !== undefined
+      ? `\n    <meta name="robots" content="${escapeHtml(head.robots)}" />`
+      : "";
+  const siteName =
+    head.siteName !== undefined
+      ? `\n    <meta property="og:site_name" content="${escapeHtml(head.siteName)}" />`
+      : "";
+  const locale =
+    head.locale !== undefined
+      ? `\n    <meta property="og:locale" content="${escapeHtml(head.locale)}" />`
+      : "";
+  const twitterCard =
+    head.ogImage !== undefined
+      ? `\n    <meta name="twitter:card" content="summary_large_image" />`
+      : "";
+  const twitterSite =
+    head.twitterSite !== undefined
+      ? `\n    <meta name="twitter:site" content="${escapeHtml(head.twitterSite)}" />`
+      : "";
+  const preconnects = (head.preconnects ?? [])
+    .map((url) => `\n    <link rel="preconnect" href="${escapeHtml(url)}" />`)
+    .join("");
+  const schema =
+    head.schemaJson !== undefined
+      ? `\n    <script type="application/ld+json">${JSON.stringify(head.schemaJson)}</script>`
+      : "";
   return `<!doctype html>
 <html lang="${escapeHtml(head.lang)}">
   <head>
@@ -402,7 +441,7 @@ export function renderApexPage(page: ApexPage): string {
     <meta name="description" content="${escapeHtml(head.description)}" />
     <meta property="og:title" content="${escapeHtml(head.title)}" />
     <meta property="og:description" content="${escapeHtml(head.description)}" />
-    <meta property="og:type" content="website" />${ogUrl}${ogImage}${favicon}${canonical}${alternates}
+    <meta property="og:type" content="website" />${ogUrl}${ogImage}${siteName}${locale}${twitterCard}${twitterSite}${favicon}${canonical}${alternates}${robots}${preconnects}${schema}
     <style>${css}</style>
   </head>
   <body${theme === "dark" ? ` class="apex-dark"` : ""}>