@ingram-tech/nk-seo 0.4.0 → 0.5.0

package/README.md

@@ -1,7 +1,7 @@
 # @ingram-tech/nk-seo
 
-SEO primitives for Next.js sites, factored out of the patterns every Ingram site
-kept re-implementing:
+SEO primitives for Next.js sites, factored out of the patterns Next.js sites
+keep re-implementing:
 
 1. **`<JsonLd>`** + **typed schema.org builders** — `faqPage`, `breadcrumbList`,
    `article`, `softwareApplication`, `organization`, `website`, `person`,
@@ -9,7 +9,12 @@ kept re-implementing:
    paths and injects your publisher.
 2. **`createMetadata`** — a Next `Metadata` factory: canonical + OpenGraph +
    Twitter card from one title/description/path.
-3. **`<HreflangLinks>`** — self-referencing canonical plus per-locale `hreflang`
+3. **`createSitemap` / `createRobots`** — `app/sitemap.ts` and `app/robots.ts`
+   route helpers; `createRobots` blanket-disallows non-production hosts so
+   Vercel preview / branch URLs never get indexed.
+4. **`ogImageResponse`** (`@ingram-tech/nk-seo/og`) — a branded `next/og` share
+   card that sidesteps the Satori multi-child pitfall.
+5. **`<HreflangLinks>`** — self-referencing canonical plus per-locale `hreflang`
    alternates (query-param or path-prefix strategy).
 
 The package root (`@ingram-tech/nk-seo`) is **pure** — builders and the metadata
@@ -33,17 +38,17 @@ import { createSeo } from "@ingram-tech/nk-seo";
 const seo = createSeo({
 	baseUrl: getServerUrl(),
 	organization: {
-		name: "Financica",
-		url: "https://financica.app",
-		logo: "https://financica.app/logo.png",
-		sameAs: ["https://linkedin.com/company/financica"],
+		name: "Acme",
+		url: "https://example.com",
+		logo: "https://example.com/logo.png",
+		sameAs: ["https://www.linkedin.com/company/acme"],
 	},
 });
 
 // Homepage:
 <JsonLd
 	data={seo.softwareApplication({
-		name: "Financica",
+		name: "Acme",
 		applicationCategory: "BusinessApplication",
 		operatingSystem: "Web",
 		offers: { priceCurrency: "EUR", lowPrice: 59, highPrice: 299, offerCount: 2, url: "/pricing" },
@@ -56,11 +61,17 @@ const seo = createSeo({
 <JsonLd data={seo.breadcrumbs([{ name: "Home", path: "/" }, { name: "Blog", path: "/blog" }, { name: title, path: `/blog/${slug}` }])} />
 ```
 
-Already have absolute URLs and don't want the factory? The standalone builders
-(`faqPage`, `article`, `breadcrumbList`, …) take absolute URLs directly.
+`createSeo` resolves **nested** URL fields too — the organization's `url`/`logo`
+and `offers.url` may be site-relative, as in the example above. Already have
+absolute URLs and don't want the factory? The standalone builders (`faqPage`,
+`article`, `breadcrumbList`, …) take absolute URLs directly (they resolve
+nothing).
 
-`<JsonLd data={...} />` accepts a single node or an array (e.g.
-`[organization(org), website(site)]` on the homepage).
+Every builder returns a typed node (`FaqPageNode`, `ArticleNode`, …), so the
+shape survives past the call site. `<JsonLd data={...} />` accepts a single node
+or an array (e.g. `[organization(org), website(site)]` on the homepage), and
+escapes `<` on serialization so CMS-sourced strings can't break out of the
+`<script>` tag.
 
 ## Page metadata
 
@@ -69,13 +80,17 @@ Already have absolute URLs and don't want the factory? The standalone builders
 import { createMetadata } from "@ingram-tech/nk-seo";
 
 export const pageMetadata = createMetadata({
-	baseUrl: "https://ingram.tech",
-	siteName: "Ingram Technologies",
+	baseUrl: "https://example.com",
+	siteName: "Acme",
+	titleTemplate: "%s | Acme",
 	defaultImage: "/images/og.png",
 	locale: "en_US",
-	twitterSite: "@IngramTech",
+	twitterSite: "@acme",
 });
 
+// app/layout.tsx — metadataBase + default title (+ template when configured):
+export const metadata = pageMetadata.root({ description: "The Acme platform." });
+
 // app/services/page.tsx
 export const metadata = pageMetadata({
 	title: "Services",
@@ -86,7 +101,85 @@ export const metadata = pageMetadata({
 
 Produces `title`, `description`, a self-referencing `alternates.canonical`,
 `openGraph`, and a `summary_large_image` Twitter card. Pass `noIndex`, `keywords`,
-`type: "article"`, or per-page `openGraph`/`twitter` overrides as needed.
+`type: "article"`, or per-page `openGraph`/`twitter` overrides as needed. With
+`titleTemplate` set, `pageMetadata.root()` emits `title.template`, so plain page
+titles render as "Services | Acme" without every page appending the suffix.
+
+## Sitemap & robots
+
+```ts
+// app/sitemap.ts
+import { createSitemap } from "@ingram-tech/nk-seo";
+
+export default () =>
+	createSitemap({
+		baseUrl: getServerUrl(), // your deployment's own origin
+		routes: ["/", "/pricing", "/docs", "/faq", "/support"],
+	});
+```
+
+`"/"` defaults to priority 1, every other route to 0.7; pass objects
+(`{ path, lastModified, changeFrequency, priority, languages }`) to override, or
+set `lastModified` / `defaultChangeFrequency` / `defaultPriority` site-wide.
+Absolute URLs pass through untouched; a `priority` outside 0–1 throws (Google
+would silently reject the whole entry). Localized routes can declare their
+alternates — `languages: { en: "/about", fr: "/fr/about" }` — mirroring what
+`<HreflangLinks>` emits on the page itself.
+
+```ts
+// app/robots.ts
+import { createRobots } from "@ingram-tech/nk-seo";
+
+export default () =>
+	createRobots({
+		baseUrl: getServerUrl(),
+		isProduction: process.env.VERCEL_ENV === "production",
+		disallow: ["/api/", "/internal/", "/login"],
+	});
+```
+
+When `isProduction` is false the whole site is disallowed — the one SEO
+safeguard everyone forgets on Vercel, where preview and branch deployments are
+otherwise crawlable and compete with the production domain for the same content.
+
+## Open Graph image
+
+`@ingram-tech/nk-seo/og` is a separate entry (it pulls in `next/og`), so the
+package root and `/components` never carry the renderer.
+
+```tsx
+// app/opengraph-image.tsx  (and re-export from app/twitter-image.tsx)
+import { ogImageResponse } from "@ingram-tech/nk-seo/og";
+
+export const size = { width: 1200, height: 630 };
+export const contentType = "image/png";
+export const alt = "Acme — Ship faster";
+
+export default () =>
+	ogImageResponse({
+		title: "Ship faster with Acme",
+		subtitle: "The all-in-one platform for modern teams.",
+		wordmark: "Acme",
+		footer: "example.com",
+		accent: "#565ac9",
+	});
+```
+
+Pass `logo` (absolute URL or data URI) to replace the accent-square mark with
+your logo, and `fonts` + `fontFamily` to render with the brand typeface —
+`fonts` is forwarded to `ImageResponse`, which takes raw TTF/OTF/WOFF data.
+
+The template encodes the Satori rule that trips everyone up: every node with
+more than one child sets `display: flex`, and text nodes are never mixed with
+sibling elements — so the headline stays a plain string and the accent rides on
+the mark, not a coloured `<span>` inside the title.
+
+No linter or type-check validates Satori-supported CSS (`ImageResponse` accepts
+all of `React.CSSProperties`; Satori silently drops what it doesn't know), so
+the only real validator is rendering. This package renders its template through
+the real satori + resvg pipeline in its own tests; if a site hand-rolls extra
+cards, give it the same guard — a vitest file (node environment) that renders
+each `opengraph-image.tsx` and asserts a valid PNG comes out.
 
 ## Hreflang & canonical
 
@@ -103,11 +196,11 @@ res.headers.set("x-pathname", req.nextUrl.pathname);
 import { HreflangLinks } from "@ingram-tech/nk-seo/components";
 
 // Query-param locales (?hl=fr):
-<HreflangLinks baseUrl="https://financica.app" locales={["en", "fr", "nl"]} />
+<HreflangLinks baseUrl="https://example.com" locales={["en", "fr", "nl"]} />
 
 // Path-prefix locales (/fr/about), default locale bare, regional hreflang tags:
 <HreflangLinks
-	baseUrl="https://malinamore.studio"
+	baseUrl="https://example.com"
 	locales={["en", "fr", "nl"]}
 	strategy="prefix"
 	defaultLocale="en"
@@ -116,4 +209,15 @@ import { HreflangLinks } from "@ingram-tech/nk-seo/components";
 />
 ```
 
-Pass `pathname` explicitly if you don't use the `x-pathname` header.
+Pass `pathname` explicitly if you don't use the `x-pathname` header. When
+neither is available the component **throws** instead of guessing — a silent
+fallback would canonicalize every page to the homepage, the kind of site-wide
+SEO bug nobody notices for months.
+
+Two rules of the road:
+
+- **One canonical per page.** If your pages already set `alternates.canonical`
+  (e.g. via `createMetadata`), render `<HreflangLinks canonical={false} />`.
+- Building metadata instead of rendering links? The pure `hreflangAlternates`
+  (package root) returns the same `{ canonical, links }` for use in
+  `generateMetadata`.

package/dist/alternates.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure hreflang computation behind `<HreflangLinks>` (from
+ * "@ingram-tech/nk-seo/components"). Usable directly wherever a component
+ * doesn't fit (e.g. building `Metadata.alternates` in `generateMetadata`).
+ */
+export interface HreflangConfig {
+    /** Absolute site origin, e.g. "https://acme.example". */
+    baseUrl: string;
+    /** Locales to emit alternates for, e.g. ["en", "fr", "nl"]. */
+    locales: readonly string[];
+    /**
+     * How locale is encoded in the alternate URLs:
+     *  - `"query"` (default): `${baseUrl}${path}?${param}=${locale}` for every locale.
+     *  - `"prefix"`: the default locale stays at the bare path; others get
+     *    `/${locale}${path}` (matches a localized-rewrite setup).
+     */
+    strategy?: "query" | "prefix";
+    /** Query-param name for the `"query"` strategy. Default `"hl"`. */
+    param?: string;
+    /** Default (unprefixed) locale for the `"prefix"` strategy. */
+    defaultLocale?: string;
+    /** Optional locale → hreflang tag map, e.g. `{ en: "en-BE", fr: "fr-BE" }`. */
+    hrefLangTags?: Record<string, string>;
+}
+export interface HreflangLink {
+    /** The `hreflang` attribute value ("fr-BE", "x-default", …). */
+    hrefLang: string;
+    href: string;
+}
+export interface HreflangAlternates {
+    /** Self-referencing canonical URL of `pathname`. */
+    canonical: string;
+    /** One link per locale, plus the trailing `x-default` (→ canonical). */
+    links: HreflangLink[];
+}
+/**
+ * Computes the self-referencing canonical plus per-locale hreflang alternate
+ * URLs (and an `x-default`) for `pathname`.
+ */
+export declare function hreflangAlternates(config: HreflangConfig, pathname: string): HreflangAlternates;
+//# sourceMappingURL=alternates.d.ts.map

package/dist/alternates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alternates.d.ts","sourceRoot":"","sources":["../src/alternates.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC5B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IAClC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,KAAK,EAAE,YAAY,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,MAAM,GACd,kBAAkB,CAyBpB"}

package/dist/alternates.js

@@ -0,0 +1,30 @@
+import { absoluteUrl } from "./url.js";
+/**
+ * Computes the self-referencing canonical plus per-locale hreflang alternate
+ * URLs (and an `x-default`) for `pathname`.
+ */
+export function hreflangAlternates(config, pathname) {
+    const { strategy = "query", param = "hl", defaultLocale, hrefLangTags } = config;
+    const canonical = absoluteUrl(pathname, config.baseUrl);
+    const hrefFor = (locale) => {
+        if (strategy === "prefix") {
+            if (defaultLocale && locale === defaultLocale) {
+                return canonical;
+            }
+            const clean = pathname === "/" ? "" : pathname;
+            return absoluteUrl(`/${locale}${clean}`, config.baseUrl);
+        }
+        return `${canonical}?${param}=${locale}`;
+    };
+    return {
+        canonical,
+        links: [
+            ...config.locales.map((locale) => ({
+                hrefLang: hrefLangTags?.[locale] ?? locale,
+                href: hrefFor(locale),
+            })),
+            { hrefLang: "x-default", href: canonical },
+        ],
+    };
+}
+//# sourceMappingURL=alternates.js.map

package/dist/alternates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alternates.js","sourceRoot":"","sources":["../src/alternates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAwCvC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CACjC,MAAsB,EACtB,QAAgB;IAEhB,MAAM,EAAE,QAAQ,GAAG,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IACjF,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,CAAC,MAAc,EAAU,EAAE;QAC1C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,aAAa,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBAC/C,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/C,OAAO,WAAW,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,SAAS,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;IAC1C,CAAC,CAAC;IAEF,OAAO;QACN,SAAS;QACT,KAAK,EAAE;YACN,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAClC,QAAQ,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM;gBAC1C,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;aACrB,CAAC,CAAC;YACH,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1C;KACD,CAAC;AACH,CAAC"}

package/dist/components.d.ts

@@ -1,3 +1,3 @@
-export { JsonLd } from "./json-ld.js";
+export { JsonLd, serializeJsonLd } from "./json-ld.js";
 export { HreflangLinks, type HreflangLinksProps } from "./hreflang.js";
 //# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/components.js

@@ -1,5 +1,5 @@
 // React entry: the rendering components. Kept out of the package root so server
 // code that only needs the builders/metadata never imports React or next/headers.
-export { JsonLd } from "./json-ld.js";
+export { JsonLd, serializeJsonLd } from "./json-ld.js";
 export { HreflangLinks } from "./hreflang.js";
 //# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAA2B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAA2B,MAAM,eAAe,CAAC"}

package/dist/hreflang.d.ts

@@ -1,8 +1,5 @@
-export interface HreflangLinksProps {
-    /** Absolute site origin, e.g. "https://financica.app". */
-    baseUrl: string;
-    /** Locales to emit `<link rel="alternate" hreflang>` for, e.g. ["en", "fr", "nl"]. */
-    locales: readonly string[];
+import { type HreflangConfig } from "./alternates.js";
+export interface HreflangLinksProps extends HreflangConfig {
     /**
      * Path being rendered. Defaults to the `x-pathname` request header (set it in
      * middleware: `headers.set("x-pathname", req.nextUrl.pathname)`). Pass
@@ -10,25 +7,20 @@ export interface HreflangLinksProps {
      */
     pathname?: string;
     /**
-     * How locale is encoded in the alternate URLs:
-     *  - `"query"` (default): `${baseUrl}${path}?${param}=${locale}` for every locale.
-     *  - `"prefix"`: the default locale stays at the bare path; others get
-     *    `/${locale}${path}` (matches a localized-rewrite setup).
+     * Emit a self-referencing `<link rel="canonical">`. Default `true`.
+     * Disable it if the page's metadata already sets `alternates.canonical`
+     * (e.g. via `createMetadata`) — a page must not declare two canonicals.
      */
-    strategy?: "query" | "prefix";
-    /** Query-param name for the `"query"` strategy. Default `"hl"`. */
-    param?: string;
-    /** Default (unprefixed) locale for the `"prefix"` strategy. */
-    defaultLocale?: string;
-    /** Optional locale → hreflang tag map, e.g. `{ en: "en-BE", fr: "fr-BE" }`. */
-    hrefLangTags?: Record<string, string>;
-    /** Emit a self-referencing `<link rel="canonical">`. Default `true`. */
     canonical?: boolean;
 }
 /**
  * Emits `<link rel="canonical">` plus per-locale `<link rel="alternate" hreflang>`
  * (and an `x-default`) for the current path. Render inside `<head>` (e.g. from
  * the root layout). Server component — reads the `x-pathname` header by default.
+ *
+ * Throws when neither `pathname` nor the header is available: silently falling
+ * back would canonicalize every page to the homepage, a site-wide
+ * duplicate-content bug that is otherwise invisible.
  */
-export declare function HreflangLinks({ baseUrl, locales, pathname, strategy, param, defaultLocale, hrefLangTags, canonical, }: HreflangLinksProps): Promise<import("react").JSX.Element>;
+export declare function HreflangLinks({ pathname, canonical, ...config }: HreflangLinksProps): Promise<import("react").JSX.Element>;
 //# sourceMappingURL=hreflang.d.ts.map

package/dist/hreflang.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hreflang.d.ts","sourceRoot":"","sources":["../src/hreflang.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EACnC,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAkB,EAClB,KAAY,EACZ,aAAa,EACb,YAAY,EACZ,SAAgB,GAChB,EAAE,kBAAkB,wCA6BpB"}
+{"version":3,"file":"hreflang.d.ts","sourceRoot":"","sources":["../src/hreflang.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACzD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,EACnC,QAAQ,EACR,SAAgB,EAChB,GAAG,MAAM,EACT,EAAE,kBAAkB,wCAwBpB"}

package/dist/hreflang.js

@@ -1,23 +1,23 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { headers } from "next/headers";
+import { hreflangAlternates } from "./alternates.js";
 /**
  * Emits `<link rel="canonical">` plus per-locale `<link rel="alternate" hreflang>`
  * (and an `x-default`) for the current path. Render inside `<head>` (e.g. from
  * the root layout). Server component — reads the `x-pathname` header by default.
+ *
+ * Throws when neither `pathname` nor the header is available: silently falling
+ * back would canonicalize every page to the homepage, a site-wide
+ * duplicate-content bug that is otherwise invisible.
  */
-export async function HreflangLinks({ baseUrl, locales, pathname, strategy = "query", param = "hl", defaultLocale, hrefLangTags, canonical = true, }) {
-    const path = pathname ?? (await headers()).get("x-pathname") ?? "/";
-    const canonicalUrl = `${baseUrl}${path}`;
-    const hrefFor = (locale) => {
-        if (strategy === "prefix") {
-            if (defaultLocale && locale === defaultLocale) {
-                return canonicalUrl;
-            }
-            const clean = path === "/" ? "" : path;
-            return `${baseUrl}/${locale}${clean}`;
-        }
-        return `${canonicalUrl}?${param}=${locale}`;
-    };
-    return (_jsxs(_Fragment, { children: [canonical ? _jsx("link", { rel: "canonical", href: canonicalUrl }) : null, locales.map((locale) => (_jsx("link", { rel: "alternate", hrefLang: hrefLangTags?.[locale] ?? locale, href: hrefFor(locale) }, locale))), _jsx("link", { rel: "alternate", hrefLang: "x-default", href: canonicalUrl })] }));
+export async function HreflangLinks({ pathname, canonical = true, ...config }) {
+    const path = pathname ?? (await headers()).get("x-pathname");
+    if (!path) {
+        throw new Error("HreflangLinks: no `pathname` prop and no `x-pathname` request header. " +
+            'Set the header in middleware (`res.headers.set("x-pathname", req.nextUrl.pathname)`) ' +
+            "or pass `pathname` explicitly.");
+    }
+    const { canonical: canonicalUrl, links } = hreflangAlternates(config, path);
+    return (_jsxs(_Fragment, { children: [canonical ? _jsx("link", { rel: "canonical", href: canonicalUrl }) : null, links.map((link) => (_jsx("link", { rel: "alternate", hrefLang: link.hrefLang, href: link.href }, link.hrefLang)))] }));
 }
 //# sourceMappingURL=hreflang.js.map

package/dist/hreflang.js.map

@@ -1 +1 @@
-{"version":3,"file":"hreflang.js","sourceRoot":"","sources":["../src/hreflang.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA8BvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EACnC,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,GAAG,OAAO,EAClB,KAAK,GAAG,IAAI,EACZ,aAAa,EACb,YAAY,EACZ,SAAS,GAAG,IAAI,GACI;IACpB,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;IACpE,MAAM,YAAY,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAU,EAAE;QAC1C,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,aAAa,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;gBAC/C,OAAO,YAAY,CAAC;YACrB,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvC,OAAO,GAAG,OAAO,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;QACvC,CAAC;QACD,OAAO,GAAG,YAAY,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO,CACN,8BACE,SAAS,CAAC,CAAC,CAAC,eAAM,GAAG,EAAC,WAAW,EAAC,IAAI,EAAE,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,EAC/D,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACxB,eAEC,GAAG,EAAC,WAAW,EACf,QAAQ,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,EAC1C,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAHhB,MAAM,CAIV,CACF,CAAC,EACF,eAAM,GAAG,EAAC,WAAW,EAAC,QAAQ,EAAC,WAAW,EAAC,IAAI,EAAE,YAAY,GAAI,IAC/D,CACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"hreflang.js","sourceRoot":"","sources":["../src/hreflang.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,iBAAiB,CAAC;AAiB1E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EACnC,QAAQ,EACR,SAAS,GAAG,IAAI,EAChB,GAAG,MAAM,EACW;IACpB,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACd,wEAAwE;YACvE,uFAAuF;YACvF,gCAAgC,CACjC,CAAC;IACH,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5E,OAAO,CACN,8BACE,SAAS,CAAC,CAAC,CAAC,eAAM,GAAG,EAAC,WAAW,EAAC,IAAI,EAAE,YAAY,GAAI,CAAC,CAAC,CAAC,IAAI,EAC/D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACpB,eAEC,GAAG,EAAC,WAAW,EACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,EACvB,IAAI,EAAE,IAAI,CAAC,IAAI,IAHV,IAAI,CAAC,QAAQ,CAIjB,CACF,CAAC,IACA,CACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { type AggregateRatingInput, article, type ArticleAuthor, type ArticleInput, breadcrumbList, type BreadcrumbItem, type BreadcrumbPath, createSeo, event, type EventInput, type EventLocationInput, faqPage, type FaqItem, type GeoInput, type JsonLdNode, localBusiness, type LocalBusinessInput, type OfferInput, organization, type OrganizationInput, person, type PersonInput, type PostalAddressInput, type Seo, type SeoConfig, softwareApplication, type SoftwareApplicationInput, website, type WebsiteInput, } from "./schema.js";
-export { createMetadata, type MetadataSiteConfig, type PageMetadata, type PageMetadataInput, } from "./metadata.js";
+export { type AggregateOfferNode, type AggregateRatingInput, type AggregateRatingNode, article, type ArticleAuthor, type ArticleAuthorNode, type ArticleInput, type ArticleNode, breadcrumbList, type BreadcrumbItem, type BreadcrumbListNode, type BreadcrumbPath, createSeo, event, type EventInput, type EventLocationInput, type EventNode, faqPage, type FaqItem, type FaqPageNode, type GeoCoordinatesNode, type GeoInput, type ImageObjectNode, type JsonLdNode, type ListItemNode, localBusiness, type LocalBusinessInput, type LocalBusinessNode, type OfferInput, type OfferNode, organization, type OrganizationInput, type OrganizationNode, person, type PersonInput, type PersonNode, type PlaceNode, type PostalAddressInput, type PostalAddressNode, type QuestionNode, type Seo, type SeoConfig, softwareApplication, type SoftwareApplicationInput, type SoftwareApplicationNode, type VirtualLocationNode, website, type WebsiteInput, type WebsiteNode, type WithContext, } from "./schema.js";
+export { createMetadata, type MetadataSiteConfig, type PageMetadata, type PageMetadataInput, type RootMetadataInput, } from "./metadata.js";
+export { createRobots, createSitemap, type RobotsConfig, type SitemapConfig, type SitemapLanguages, type SitemapRoute, } from "./routes.js";
+export { hreflangAlternates, type HreflangAlternates, type HreflangConfig, type HreflangLink, } from "./alternates.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,KAAK,oBAAoB,EACzB,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,YAAY,EACZ,KAAK,iBAAiB,EACtB,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,GAAG,EACR,KAAK,SAAS,EACd,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,OAAO,EACP,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACtB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,OAAO,EACP,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,GAAG,EACR,KAAK,SAAS,EACd,mBAAmB,EACnB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,YAAY,EACZ,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,YAAY,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,4 +4,6 @@
 // "@ingram-tech/nk-seo/components".
 export { article, breadcrumbList, createSeo, event, faqPage, localBusiness, organization, person, softwareApplication, website, } from "./schema.js";
 export { createMetadata, } from "./metadata.js";
+export { createRobots, createSitemap, } from "./routes.js";
+export { hreflangAlternates, } from "./alternates.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,sDAAsD;AACtD,oCAAoC;AACpC,OAAO,EAEN,OAAO,EAGP,cAAc,EAGd,SAAS,EACT,KAAK,EAGL,OAAO,EAIP,aAAa,EAGb,YAAY,EAEZ,MAAM,EAKN,mBAAmB,EAEnB,OAAO,GAEP,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,GAId,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,sDAAsD;AACtD,oCAAoC;AACpC,OAAO,EAIN,OAAO,EAKP,cAAc,EAId,SAAS,EACT,KAAK,EAIL,OAAO,EAQP,aAAa,EAKb,YAAY,EAGZ,MAAM,EASN,mBAAmB,EAInB,OAAO,GAIP,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,cAAc,GAKd,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,YAAY,EACZ,aAAa,GAKb,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,kBAAkB,GAIlB,MAAM,iBAAiB,CAAC"}

package/dist/json-ld.d.ts

@@ -1,10 +1,8 @@
+export declare const serializeJsonLd: (data: object | object[]) => string;
 /**
  * Renders one or more schema.org JSON-LD nodes into a
  * `<script type="application/ld+json">`. Works in server and client components.
  *
- * The payload is trusted, server-built structured data (never user input), so
- * serialising it into the script body is safe — that is how JSON-LD ships.
- *
  * @example
  * <JsonLd data={faqPage(items)} />
  * <JsonLd data={[organization(org), website(site)]} />

package/dist/json-ld.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,+BAQ3D"}
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,GAAG,MAAM,EAAE,KAAG,MAMtD,CAAC;AAEL;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,+BAQ3D"}

package/dist/json-ld.js

@@ -1,18 +1,30 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * JSON.stringify hardened for inline `<script>` bodies. `<` is escaped so a
+ * string value containing `</script>` (FAQ answers and article headlines often
+ * come from a CMS) cannot terminate the tag and inject markup; U+2028/2029 are
+ * escaped because they are valid JSON but not valid JS source.
+ */
+// U+2028/U+2029 via RegExp() so the source stays ASCII (a literal invisible
+// character would be one editor "normalization" away from silently vanishing).
+const LINE_SEPARATORS = new RegExp("[\\u2028\\u2029]", "g");
+export const serializeJsonLd = (data) => JSON.stringify(data)
+    .replace(/</g, "\\u003c")
+    .replace(LINE_SEPARATORS, (char) => {
+    const hex = char.codePointAt(0)?.toString(16) ?? "";
+    return "\\u" + hex;
+});
 /**
  * Renders one or more schema.org JSON-LD nodes into a
  * `<script type="application/ld+json">`. Works in server and client components.
  *
- * The payload is trusted, server-built structured data (never user input), so
- * serialising it into the script body is safe — that is how JSON-LD ships.
- *
  * @example
  * <JsonLd data={faqPage(items)} />
  * <JsonLd data={[organization(org), website(site)]} />
  */
 export function JsonLd({ data }) {
     return (_jsx("script", { type: "application/ld+json", 
-        // oxlint-disable-next-line no-danger -- trusted, server-built structured data, not user input
-        dangerouslySetInnerHTML: { __html: JSON.stringify(data) } }));
+        // oxlint-disable-next-line no-danger -- serializeJsonLd escapes `<`, so content strings cannot break out of the script tag
+        dangerouslySetInnerHTML: { __html: serializeJsonLd(data) } }));
 }
 //# sourceMappingURL=json-ld.js.map

package/dist/json-ld.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-ld.js","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,IAAI,EAA+B;IAC3D,OAAO,CACN,iBACC,IAAI,EAAC,qBAAqB;QAC1B,8FAA8F;QAC9F,uBAAuB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GACxD,CACF,CAAC;AACH,CAAC"}
+{"version":3,"file":"json-ld.js","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":";AAAA;;;;;GAKG;AACH,4EAA4E;AAC5E,+EAA+E;AAC/E,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAuB,EAAU,EAAE,CAClE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAClB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;KACxB,OAAO,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IACpD,OAAO,KAAK,GAAG,GAAG,CAAC;AACpB,CAAC,CAAC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,IAAI,EAA+B;IAC3D,OAAO,CACN,iBACC,IAAI,EAAC,qBAAqB;QAC1B,2HAA2H;QAC3H,uBAAuB,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,GACzD,CACF,CAAC;AACH,CAAC"}

package/dist/metadata.d.ts

@@ -7,6 +7,11 @@ export interface MetadataSiteConfig {
     baseUrl: string;
     /** OpenGraph `siteName`. */
     siteName: string;
+    /**
+     * `title.template` emitted by `pageMetadata.root()`, e.g. "%s | Acme".
+     * Applies to every child page whose title is a plain string.
+     */
+    titleTemplate?: string;
     /** Site-relative or absolute default OG/Twitter image. */
     defaultImage?: string;
     defaultImageWidth?: number;
@@ -34,21 +39,39 @@ export interface PageMetadataInput {
     /** Merged into the generated `twitter` (wins on conflict). */
     twitter?: Partial<NonNullable<Metadata["twitter"]>>;
 }
+/** Inputs for `pageMetadata.root()` — the root-layout metadata. */
+export interface RootMetadataInput {
+    /** `title.default` for pages without their own. Defaults to `siteName`. */
+    title?: string;
+    description?: string;
+    /** Extra `Metadata` merged over the generated object (wins on conflict). */
+    overrides?: Metadata;
+}
 /**
  * Returns a `pageMetadata(input)` builder that produces a Next `Metadata`
  * object with a self-referencing canonical, OpenGraph, and Twitter card from
  * one title/description/path. Collapses the boilerplate every site repeats.
  *
+ * `pageMetadata.root(input?)` builds the root-layout metadata: `metadataBase`,
+ * the default title (plus `titleTemplate` when configured), and description —
+ * pages then only set their own title/description/path.
+ *
  * @example
- * export const metadata = createMetadata({
+ * export const pageMetadata = createMetadata({
  *   baseUrl: "https://ingram.tech",
  *   siteName: "Ingram Technologies",
+ *   titleTemplate: "%s | Ingram Technologies",
  *   defaultImage: "/images/og.png",
  *   twitterSite: "@IngramTech",
  * });
+ * // app/layout.tsx:
+ * export const metadata = pageMetadata.root({ description: "AI deployment." });
  * // in a page:
  * export const metadata = pageMetadata({ title, description, path: "/services" });
  */
-export declare function createMetadata(site: MetadataSiteConfig): (input: PageMetadataInput) => Metadata;
+export declare function createMetadata(site: MetadataSiteConfig): {
+    (input: PageMetadataInput): Metadata;
+    root(input?: RootMetadataInput): Metadata;
+};
 export type PageMetadata = ReturnType<typeof createMetadata>;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,IAIzB,OAAO,iBAAiB,KAAG,QAAQ,CA2ChE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAGrC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IACjC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB;YAGzB,iBAAiB,GAAG,QAAQ;iBA6CR,iBAAiB,GAAQ,QAAQ;EAalF;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/metadata.js

@@ -1,25 +1,34 @@
+import { absoluteUrl } from "./url.js";
 /**
  * Returns a `pageMetadata(input)` builder that produces a Next `Metadata`
  * object with a self-referencing canonical, OpenGraph, and Twitter card from
  * one title/description/path. Collapses the boilerplate every site repeats.
  *
+ * `pageMetadata.root(input?)` builds the root-layout metadata: `metadataBase`,
+ * the default title (plus `titleTemplate` when configured), and description —
+ * pages then only set their own title/description/path.
+ *
  * @example
- * export const metadata = createMetadata({
+ * export const pageMetadata = createMetadata({
  *   baseUrl: "https://ingram.tech",
  *   siteName: "Ingram Technologies",
+ *   titleTemplate: "%s | Ingram Technologies",
  *   defaultImage: "/images/og.png",
  *   twitterSite: "@IngramTech",
  * });
+ * // app/layout.tsx:
+ * export const metadata = pageMetadata.root({ description: "AI deployment." });
  * // in a page:
  * export const metadata = pageMetadata({ title, description, path: "/services" });
  */
 export function createMetadata(site) {
-    const absolute = (path) => /^https?:\/\//.test(path) ? path : new URL(path, site.baseUrl).toString();
-    return function pageMetadata(input) {
+    const absolute = (path) => absoluteUrl(path, site.baseUrl);
+    function pageMetadata(input) {
         const imagePath = input.image ?? site.defaultImage;
         const imageUrl = imagePath ? absolute(imagePath) : undefined;
         const url = absolute(input.path);
         return {
+            metadataBase: new URL(site.baseUrl),
             title: input.title,
             description: input.description,
             ...(input.keywords ? { keywords: input.keywords } : {}),
@@ -56,6 +65,18 @@ export function createMetadata(site) {
                 ...input.twitter,
             },
         };
+    }
+    pageMetadata.root = function rootMetadata(input = {}) {
+        const title = input.title ?? site.siteName;
+        return {
+            metadataBase: new URL(site.baseUrl),
+            title: site.titleTemplate
+                ? { default: title, template: site.titleTemplate }
+                : title,
+            ...(input.description ? { description: input.description } : {}),
+            ...input.overrides,
+        };
     };
+    return pageMetadata;
 }
 //# sourceMappingURL=metadata.js.map