@better-seo/next 0.0.1

package/README.md

@@ -0,0 +1,65 @@
+# `@better-seo/next`
+
+[![npm](https://img.shields.io/npm/v/@better-seo/next?style=flat-square)](https://www.npmjs.com/package/@better-seo/next)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](../../LICENSE)
+[![CI](https://github.com/0xMilord/better-seo-js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/0xMilord/better-seo-js/actions/workflows/ci.yml)
+
+Next.js integration for [**`@better-seo/core`**](../core/README.md): App Router **`Metadata`**, **`generateMetadata`** patterns, shorthand **`seo()`**, **`prepareNextSeo`**, layout merge via **`withSEO`**, and **`NextJsonLd`** so JSON-LD uses the same **`serializeJSONLD`** path as the rest of the stack.
+
+**Peers:** `next` **>= 14.2**, `react` **>= 18.2** (see **`package.json`**).
+
+**Docs:** [Monorepo README](../../README.md) · [Usage](../../internal-docs/USAGE.md) · [Recipes](../../docs/recipes/)
+
+---
+
+## Install
+
+```bash
+npm install @better-seo/core @better-seo/next
+```
+
+---
+
+## Entry points
+
+| Import                         | Role                                                                                    |
+| ------------------------------ | --------------------------------------------------------------------------------------- |
+| **`@better-seo/next`**         | `seo`, `prepareNextSeo`, `withSEO`, `toNextMetadata`, adapter registration for `"next"` |
+| **`@better-seo/next/json-ld`** | **`NextJsonLd`** — renders `<script type="application/ld+json">` from a **`SEO`**       |
+
+---
+
+## Scripts (monorepo)
+
+From **`packages/next`**:
+
+```bash
+npm run build
+npm run test
+npm run test:coverage
+npm run lint
+npm run typecheck
+```
+
+**E2E:** Playwright tests in **`examples/nextjs-app`** exercise real HTML head output (runs in root **`npm run ci`**).
+
+---
+
+## Coverage
+
+[`vitest.config.ts`](./vitest.config.ts) scopes coverage to **`src/to-next-metadata.ts`** (mapping logic); wiring in `surface` / `register` is covered by E2E.
+
+| Metric         | Minimum |
+| -------------- | ------- |
+| **Lines**      | 82%     |
+| **Statements** | 82%     |
+| **Functions**  | 80%     |
+| **Branches**   | 72%     |
+
+LCov: **`coverage/lcov.info`** (uploaded from CI when present).
+
+---
+
+## License
+
+MIT — see [**LICENSE**](../../LICENSE).

package/dist/index.cjs

@@ -0,0 +1,101 @@
+'use strict';
+
+var core = require('@better-seo/core');
+
+// src/register.ts
+
+// src/to-next-metadata.ts
+function robotsFromString(robots) {
+  const lower = robots.toLowerCase();
+  const noindex = lower.includes("noindex");
+  const nofollow = lower.includes("nofollow");
+  if (!noindex && !nofollow) {
+    return { index: true, follow: true };
+  }
+  return {
+    index: !noindex,
+    follow: !nofollow
+  };
+}
+function omitUndefined(o) {
+  return Object.fromEntries(
+    Object.entries(o).filter(([, v]) => v !== void 0)
+  );
+}
+function toNextMetadata(seo2) {
+  const m = {
+    title: seo2.meta.title
+  };
+  if (seo2.meta.description !== void 0) {
+    m.description = seo2.meta.description;
+  }
+  const langs = seo2.meta.alternates?.languages;
+  const hasLang = langs !== void 0 && Object.keys(langs).length > 0;
+  if (seo2.meta.canonical || hasLang) {
+    const alt = {};
+    if (seo2.meta.canonical) alt.canonical = seo2.meta.canonical;
+    if (hasLang && langs) alt.languages = { ...langs };
+    m.alternates = alt;
+  }
+  if (seo2.meta.robots) {
+    m.robots = robotsFromString(seo2.meta.robots);
+  }
+  if (seo2.openGraph) {
+    const og = omitUndefined({
+      title: seo2.openGraph.title,
+      description: seo2.openGraph.description,
+      url: seo2.openGraph.url,
+      type: seo2.openGraph.type,
+      images: seo2.openGraph.images?.map(
+        (img) => omitUndefined({
+          url: img.url,
+          width: img.width,
+          height: img.height,
+          alt: img.alt
+        })
+      )
+    });
+    if (Object.keys(og).length > 0) {
+      m.openGraph = og;
+    }
+  }
+  if (seo2.twitter) {
+    const tw = omitUndefined({
+      card: seo2.twitter.card,
+      title: seo2.twitter.title,
+      description: seo2.twitter.description,
+      images: seo2.twitter.image ? [seo2.twitter.image] : void 0
+    });
+    if (Object.keys(tw).length > 0) {
+      m.twitter = tw;
+    }
+  }
+  return m;
+}
+
+// src/register.ts
+core.registerAdapter({
+  id: "next",
+  toFramework: toNextMetadata
+});
+function seo(input, config) {
+  return toNextMetadata(core.createSEO(input, config));
+}
+function withSEO(parent, child, config) {
+  return toNextMetadata(core.withSEO(parent, child, config));
+}
+function mergeNextMetadataSource(parent, child, config) {
+  return toNextMetadata(core.mergeSEO(parent, child, config));
+}
+function prepareNextSeo(input, config) {
+  const doc = core.createSEO(input, config);
+  return { metadata: toNextMetadata(doc), seo: doc };
+}
+
+exports.mergeNextMetadataSource = mergeNextMetadataSource;
+exports.prepareNextSeo = prepareNextSeo;
+exports.seo = seo;
+exports.toNextMetadata = toNextMetadata;
+exports.withSEO = withSEO;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/to-next-metadata.ts","../src/register.ts","../src/surface.ts"],"names":["seo","registerAdapter","createSEO","withSeoCore","mergeSEO"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { Metadata } from \"next\"\nimport type { SEO } from \"@better-seo/core\"\n\nfunction robotsFromString(robots: string): Metadata[\"robots\"] {\n  const lower = robots.toLowerCase()\n  const noindex = lower.includes(\"noindex\")\n  const nofollow = lower.includes(\"nofollow\")\n  if (!noindex && !nofollow) {\n    return { index: true, follow: true }\n  }\n  return {\n    index: !noindex,\n    follow: !nofollow,\n  }\n}\n\nfunction omitUndefined<T extends Record<string, unknown>>(o: T): Partial<T> {\n  return Object.fromEntries(\n    (Object.entries(o) as [string, unknown][]).filter(([, v]) => v !== undefined),\n  ) as Partial<T>\n}\n\n/** Map normalized `SEO` → Next.js `Metadata` (App Router). JSON-LD is not included — use `@better-seo/next/json-ld`. */\nexport function toNextMetadata(seo: SEO): Metadata {\n  const m: Metadata = {\n    title: seo.meta.title,\n  }\n  if (seo.meta.description !== undefined) {\n    m.description = seo.meta.description\n  }\n  const langs = seo.meta.alternates?.languages\n  const hasLang = langs !== undefined && Object.keys(langs).length > 0\n  if (seo.meta.canonical || hasLang) {\n    const alt: NonNullable<Metadata[\"alternates\"]> = {}\n    if (seo.meta.canonical) alt.canonical = seo.meta.canonical\n    if (hasLang && langs) alt.languages = { ...langs }\n    m.alternates = alt\n  }\n  if (seo.meta.robots) {\n    m.robots = robotsFromString(seo.meta.robots)\n  }\n\n  if (seo.openGraph) {\n    const og = omitUndefined({\n      title: seo.openGraph.title,\n      description: seo.openGraph.description,\n      url: seo.openGraph.url,\n      type: seo.openGraph.type,\n      images: seo.openGraph.images?.map((img) =>\n        omitUndefined({\n          url: img.url,\n          width: img.width,\n          height: img.height,\n          alt: img.alt,\n        }),\n      ),\n    })\n    if (Object.keys(og).length > 0) {\n      m.openGraph = og as Metadata[\"openGraph\"]\n    }\n  }\n\n  if (seo.twitter) {\n    const tw = omitUndefined({\n      card: seo.twitter.card,\n      title: seo.twitter.title,\n      description: seo.twitter.description,\n      images: seo.twitter.image ? [seo.twitter.image] : undefined,\n    })\n    if (Object.keys(tw).length > 0) {\n      m.twitter = tw as Metadata[\"twitter\"]\n    }\n  }\n\n  return m\n}\n","import type { Metadata } from \"next\"\nimport { registerAdapter } from \"@better-seo/core\"\nimport { toNextMetadata } from \"./to-next-metadata.js\"\n\nregisterAdapter<Metadata>({\n  id: \"next\",\n  toFramework: toNextMetadata,\n})\n","import type { Metadata } from \"next\"\nimport {\n  createSEO,\n  mergeSEO,\n  type SEO,\n  type SEOConfig,\n  type SEOInput,\n  withSEO as withSeoCore,\n} from \"@better-seo/core\"\nimport { toNextMetadata } from \"./to-next-metadata.js\"\n\n/** Voilà: `export const metadata = seo({ title: \"...\" })` (FEATURES N1). */\nexport function seo(input: SEOInput, config?: SEOConfig): Metadata {\n  return toNextMetadata(createSEO(input, config))\n}\n\n/**\n * Layer child metadata on a parent `SEO` document (layout → page), then emit Next `Metadata`.\n */\nexport function withSEO(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata {\n  return toNextMetadata(withSeoCore(parent, child, config))\n}\n\n/** Explicit merge without `withSEO` naming (FEATURES N2). */\nexport function mergeNextMetadataSource(\n  parent: SEO,\n  child: SEOInput,\n  config?: SEOConfig,\n): Metadata {\n  return toNextMetadata(mergeSEO(parent, child, config))\n}\n\n/** One call → Next metadata + full `SEO` (for `NextJsonLd` in the same route). */\nexport function prepareNextSeo(\n  input: SEOInput,\n  config?: SEOConfig,\n): { readonly metadata: Metadata; readonly seo: SEO } {\n  const doc = createSEO(input, config)\n  return { metadata: toNextMetadata(doc), seo: doc }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import { Metadata } from 'next';
+import { SEO, SEOInput, SEOConfig } from '@better-seo/core';
+
+/** Voilà: `export const metadata = seo({ title: "..." })` (FEATURES N1). */
+declare function seo(input: SEOInput, config?: SEOConfig): Metadata;
+/**
+ * Layer child metadata on a parent `SEO` document (layout → page), then emit Next `Metadata`.
+ */
+declare function withSEO(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata;
+/** Explicit merge without `withSEO` naming (FEATURES N2). */
+declare function mergeNextMetadataSource(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata;
+/** One call → Next metadata + full `SEO` (for `NextJsonLd` in the same route). */
+declare function prepareNextSeo(input: SEOInput, config?: SEOConfig): {
+    readonly metadata: Metadata;
+    readonly seo: SEO;
+};
+
+/** Map normalized `SEO` → Next.js `Metadata` (App Router). JSON-LD is not included — use `@better-seo/next/json-ld`. */
+declare function toNextMetadata(seo: SEO): Metadata;
+
+export { mergeNextMetadataSource, prepareNextSeo, seo, toNextMetadata, withSEO };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { Metadata } from 'next';
+import { SEO, SEOInput, SEOConfig } from '@better-seo/core';
+
+/** Voilà: `export const metadata = seo({ title: "..." })` (FEATURES N1). */
+declare function seo(input: SEOInput, config?: SEOConfig): Metadata;
+/**
+ * Layer child metadata on a parent `SEO` document (layout → page), then emit Next `Metadata`.
+ */
+declare function withSEO(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata;
+/** Explicit merge without `withSEO` naming (FEATURES N2). */
+declare function mergeNextMetadataSource(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata;
+/** One call → Next metadata + full `SEO` (for `NextJsonLd` in the same route). */
+declare function prepareNextSeo(input: SEOInput, config?: SEOConfig): {
+    readonly metadata: Metadata;
+    readonly seo: SEO;
+};
+
+/** Map normalized `SEO` → Next.js `Metadata` (App Router). JSON-LD is not included — use `@better-seo/next/json-ld`. */
+declare function toNextMetadata(seo: SEO): Metadata;
+
+export { mergeNextMetadataSource, prepareNextSeo, seo, toNextMetadata, withSEO };

package/dist/index.js

@@ -0,0 +1,95 @@
+import { registerAdapter, createSEO, withSEO as withSEO$1, mergeSEO } from '@better-seo/core';
+
+// src/register.ts
+
+// src/to-next-metadata.ts
+function robotsFromString(robots) {
+  const lower = robots.toLowerCase();
+  const noindex = lower.includes("noindex");
+  const nofollow = lower.includes("nofollow");
+  if (!noindex && !nofollow) {
+    return { index: true, follow: true };
+  }
+  return {
+    index: !noindex,
+    follow: !nofollow
+  };
+}
+function omitUndefined(o) {
+  return Object.fromEntries(
+    Object.entries(o).filter(([, v]) => v !== void 0)
+  );
+}
+function toNextMetadata(seo2) {
+  const m = {
+    title: seo2.meta.title
+  };
+  if (seo2.meta.description !== void 0) {
+    m.description = seo2.meta.description;
+  }
+  const langs = seo2.meta.alternates?.languages;
+  const hasLang = langs !== void 0 && Object.keys(langs).length > 0;
+  if (seo2.meta.canonical || hasLang) {
+    const alt = {};
+    if (seo2.meta.canonical) alt.canonical = seo2.meta.canonical;
+    if (hasLang && langs) alt.languages = { ...langs };
+    m.alternates = alt;
+  }
+  if (seo2.meta.robots) {
+    m.robots = robotsFromString(seo2.meta.robots);
+  }
+  if (seo2.openGraph) {
+    const og = omitUndefined({
+      title: seo2.openGraph.title,
+      description: seo2.openGraph.description,
+      url: seo2.openGraph.url,
+      type: seo2.openGraph.type,
+      images: seo2.openGraph.images?.map(
+        (img) => omitUndefined({
+          url: img.url,
+          width: img.width,
+          height: img.height,
+          alt: img.alt
+        })
+      )
+    });
+    if (Object.keys(og).length > 0) {
+      m.openGraph = og;
+    }
+  }
+  if (seo2.twitter) {
+    const tw = omitUndefined({
+      card: seo2.twitter.card,
+      title: seo2.twitter.title,
+      description: seo2.twitter.description,
+      images: seo2.twitter.image ? [seo2.twitter.image] : void 0
+    });
+    if (Object.keys(tw).length > 0) {
+      m.twitter = tw;
+    }
+  }
+  return m;
+}
+
+// src/register.ts
+registerAdapter({
+  id: "next",
+  toFramework: toNextMetadata
+});
+function seo(input, config) {
+  return toNextMetadata(createSEO(input, config));
+}
+function withSEO(parent, child, config) {
+  return toNextMetadata(withSEO$1(parent, child, config));
+}
+function mergeNextMetadataSource(parent, child, config) {
+  return toNextMetadata(mergeSEO(parent, child, config));
+}
+function prepareNextSeo(input, config) {
+  const doc = createSEO(input, config);
+  return { metadata: toNextMetadata(doc), seo: doc };
+}
+
+export { mergeNextMetadataSource, prepareNextSeo, seo, toNextMetadata, withSEO };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/to-next-metadata.ts","../src/register.ts","../src/surface.ts"],"names":["seo","withSeoCore"],"mappings":"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","file":"index.js","sourcesContent":["import type { Metadata } from \"next\"\nimport type { SEO } from \"@better-seo/core\"\n\nfunction robotsFromString(robots: string): Metadata[\"robots\"] {\n  const lower = robots.toLowerCase()\n  const noindex = lower.includes(\"noindex\")\n  const nofollow = lower.includes(\"nofollow\")\n  if (!noindex && !nofollow) {\n    return { index: true, follow: true }\n  }\n  return {\n    index: !noindex,\n    follow: !nofollow,\n  }\n}\n\nfunction omitUndefined<T extends Record<string, unknown>>(o: T): Partial<T> {\n  return Object.fromEntries(\n    (Object.entries(o) as [string, unknown][]).filter(([, v]) => v !== undefined),\n  ) as Partial<T>\n}\n\n/** Map normalized `SEO` → Next.js `Metadata` (App Router). JSON-LD is not included — use `@better-seo/next/json-ld`. */\nexport function toNextMetadata(seo: SEO): Metadata {\n  const m: Metadata = {\n    title: seo.meta.title,\n  }\n  if (seo.meta.description !== undefined) {\n    m.description = seo.meta.description\n  }\n  const langs = seo.meta.alternates?.languages\n  const hasLang = langs !== undefined && Object.keys(langs).length > 0\n  if (seo.meta.canonical || hasLang) {\n    const alt: NonNullable<Metadata[\"alternates\"]> = {}\n    if (seo.meta.canonical) alt.canonical = seo.meta.canonical\n    if (hasLang && langs) alt.languages = { ...langs }\n    m.alternates = alt\n  }\n  if (seo.meta.robots) {\n    m.robots = robotsFromString(seo.meta.robots)\n  }\n\n  if (seo.openGraph) {\n    const og = omitUndefined({\n      title: seo.openGraph.title,\n      description: seo.openGraph.description,\n      url: seo.openGraph.url,\n      type: seo.openGraph.type,\n      images: seo.openGraph.images?.map((img) =>\n        omitUndefined({\n          url: img.url,\n          width: img.width,\n          height: img.height,\n          alt: img.alt,\n        }),\n      ),\n    })\n    if (Object.keys(og).length > 0) {\n      m.openGraph = og as Metadata[\"openGraph\"]\n    }\n  }\n\n  if (seo.twitter) {\n    const tw = omitUndefined({\n      card: seo.twitter.card,\n      title: seo.twitter.title,\n      description: seo.twitter.description,\n      images: seo.twitter.image ? [seo.twitter.image] : undefined,\n    })\n    if (Object.keys(tw).length > 0) {\n      m.twitter = tw as Metadata[\"twitter\"]\n    }\n  }\n\n  return m\n}\n","import type { Metadata } from \"next\"\nimport { registerAdapter } from \"@better-seo/core\"\nimport { toNextMetadata } from \"./to-next-metadata.js\"\n\nregisterAdapter<Metadata>({\n  id: \"next\",\n  toFramework: toNextMetadata,\n})\n","import type { Metadata } from \"next\"\nimport {\n  createSEO,\n  mergeSEO,\n  type SEO,\n  type SEOConfig,\n  type SEOInput,\n  withSEO as withSeoCore,\n} from \"@better-seo/core\"\nimport { toNextMetadata } from \"./to-next-metadata.js\"\n\n/** Voilà: `export const metadata = seo({ title: \"...\" })` (FEATURES N1). */\nexport function seo(input: SEOInput, config?: SEOConfig): Metadata {\n  return toNextMetadata(createSEO(input, config))\n}\n\n/**\n * Layer child metadata on a parent `SEO` document (layout → page), then emit Next `Metadata`.\n */\nexport function withSEO(parent: SEO, child: SEOInput, config?: SEOConfig): Metadata {\n  return toNextMetadata(withSeoCore(parent, child, config))\n}\n\n/** Explicit merge without `withSEO` naming (FEATURES N2). */\nexport function mergeNextMetadataSource(\n  parent: SEO,\n  child: SEOInput,\n  config?: SEOConfig,\n): Metadata {\n  return toNextMetadata(mergeSEO(parent, child, config))\n}\n\n/** One call → Next metadata + full `SEO` (for `NextJsonLd` in the same route). */\nexport function prepareNextSeo(\n  input: SEOInput,\n  config?: SEOConfig,\n): { readonly metadata: Metadata; readonly seo: SEO } {\n  const doc = createSEO(input, config)\n  return { metadata: toNextMetadata(doc), seo: doc }\n}\n"]}

package/dist/json-ld.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+var core = require('@better-seo/core');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/next-json-ld.tsx
+function NextJsonLd(props) {
+  const { seo } = props;
+  if (!seo.schema.length) return null;
+  const [first] = seo.schema;
+  if (!first) return null;
+  const payload = seo.schema.length === 1 ? first : [...seo.schema];
+  const json = core.serializeJSONLD(payload);
+  return /* @__PURE__ */ jsxRuntime.jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: json } });
+}
+
+exports.NextJsonLd = NextJsonLd;
+//# sourceMappingURL=json-ld.cjs.map
+//# sourceMappingURL=json-ld.cjs.map

package/dist/json-ld.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next-json-ld.tsx"],"names":["serializeJSONLD","jsx"],"mappings":";;;;;;AAIO,SAAS,WAAW,KAAA,EAAwD;AACjF,EAAA,MAAM,EAAE,KAAI,GAAI,KAAA;AAChB,EAAA,IAAI,CAAC,GAAA,CAAI,MAAA,CAAO,MAAA,EAAQ,OAAO,IAAA;AAC/B,EAAA,MAAM,CAAC,KAAK,CAAA,GAAI,GAAA,CAAI,MAAA;AACpB,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AACnB,EAAA,MAAM,OAAA,GAAU,IAAI,MAAA,CAAO,MAAA,KAAW,IAAI,KAAA,GAAQ,CAAC,GAAG,GAAA,CAAI,MAAM,CAAA;AAChE,EAAA,MAAM,IAAA,GAAOA,qBAAgB,OAAO,CAAA;AACpC,EAAA,uBAAOC,cAAA,CAAC,YAAO,IAAA,EAAK,qBAAA,EAAsB,yBAAyB,EAAE,MAAA,EAAQ,MAAK,EAAG,CAAA;AACvF","file":"json-ld.cjs","sourcesContent":["import { serializeJSONLD } from \"@better-seo/core\"\nimport type { SEO } from \"@better-seo/core\"\n\n/** Renders JSON-LD using core `serializeJSONLD` only (FEATURES N4, ARCHITECTURE §7). */\nexport function NextJsonLd(props: { readonly seo: SEO }): React.JSX.Element | null {\n  const { seo } = props\n  if (!seo.schema.length) return null\n  const [first] = seo.schema\n  if (!first) return null\n  const payload = seo.schema.length === 1 ? first : [...seo.schema]\n  const json = serializeJSONLD(payload)\n  return <script type=\"application/ld+json\" dangerouslySetInnerHTML={{ __html: json }} />\n}\n"]}

package/dist/json-ld.d.cts

@@ -0,0 +1,8 @@
+import { SEO } from '@better-seo/core';
+
+/** Renders JSON-LD using core `serializeJSONLD` only (FEATURES N4, ARCHITECTURE §7). */
+declare function NextJsonLd(props: {
+    readonly seo: SEO;
+}): React.JSX.Element | null;
+
+export { NextJsonLd };

package/dist/json-ld.d.ts

@@ -0,0 +1,8 @@
+import { SEO } from '@better-seo/core';
+
+/** Renders JSON-LD using core `serializeJSONLD` only (FEATURES N4, ARCHITECTURE §7). */
+declare function NextJsonLd(props: {
+    readonly seo: SEO;
+}): React.JSX.Element | null;
+
+export { NextJsonLd };

package/dist/json-ld.js

@@ -0,0 +1,17 @@
+import { serializeJSONLD } from '@better-seo/core';
+import { jsx } from 'react/jsx-runtime';
+
+// src/next-json-ld.tsx
+function NextJsonLd(props) {
+  const { seo } = props;
+  if (!seo.schema.length) return null;
+  const [first] = seo.schema;
+  if (!first) return null;
+  const payload = seo.schema.length === 1 ? first : [...seo.schema];
+  const json = serializeJSONLD(payload);
+  return /* @__PURE__ */ jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: json } });
+}
+
+export { NextJsonLd };
+//# sourceMappingURL=json-ld.js.map
+//# sourceMappingURL=json-ld.js.map

package/dist/json-ld.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next-json-ld.tsx"],"names":[],"mappings":";;;;AAIO,SAAS,WAAW,KAAA,EAAwD;AACjF,EAAA,MAAM,EAAE,KAAI,GAAI,KAAA;AAChB,EAAA,IAAI,CAAC,GAAA,CAAI,MAAA,CAAO,MAAA,EAAQ,OAAO,IAAA;AAC/B,EAAA,MAAM,CAAC,KAAK,CAAA,GAAI,GAAA,CAAI,MAAA;AACpB,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AACnB,EAAA,MAAM,OAAA,GAAU,IAAI,MAAA,CAAO,MAAA,KAAW,IAAI,KAAA,GAAQ,CAAC,GAAG,GAAA,CAAI,MAAM,CAAA;AAChE,EAAA,MAAM,IAAA,GAAO,gBAAgB,OAAO,CAAA;AACpC,EAAA,uBAAO,GAAA,CAAC,YAAO,IAAA,EAAK,qBAAA,EAAsB,yBAAyB,EAAE,MAAA,EAAQ,MAAK,EAAG,CAAA;AACvF","file":"json-ld.js","sourcesContent":["import { serializeJSONLD } from \"@better-seo/core\"\nimport type { SEO } from \"@better-seo/core\"\n\n/** Renders JSON-LD using core `serializeJSONLD` only (FEATURES N4, ARCHITECTURE §7). */\nexport function NextJsonLd(props: { readonly seo: SEO }): React.JSX.Element | null {\n  const { seo } = props\n  if (!seo.schema.length) return null\n  const [first] = seo.schema\n  if (!first) return null\n  const payload = seo.schema.length === 1 ? first : [...seo.schema]\n  const json = serializeJSONLD(payload)\n  return <script type=\"application/ld+json\" dangerouslySetInnerHTML={{ __html: json }} />\n}\n"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@better-seo/next",
+  "version": "0.0.1",
+  "description": "Next.js integration for @better-seo/core on the App Router (and documented Pages Router patterns): turn your SEO model into Metadata and generateMetadata, use shorthand helpers like seo() and prepareNextSeo, merge layout and page SEO without duplicating logic, and stream JSON-LD through NextJsonLd from @better-seo/next/json-ld so structured data uses the same serializeJSONLD path as everywhere else. Peer dependencies: next >= 14.2 and react >= 18.2.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": true,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./json-ld": {
+      "types": "./dist/json-ld.d.ts",
+      "import": "./dist/json-ld.js",
+      "require": "./dist/json-ld.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@better-seo/core": "0.0.1"
+  },
+  "peerDependencies": {
+    "next": ">=14.2.0",
+    "react": ">=18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": false
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "audit": "npm audit --audit-level=high"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.8",
+    "@vitest/coverage-v8": "^3.0.6",
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.6"
+  }
+}