@ingram-tech/nk-seo 0.3.0 → 0.5.0

package/dist/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAuCA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB;IACtD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CACzC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAE3E,OAAO,SAAS,YAAY,CAAC,KAAwB;QACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO;YACN,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE;YAC9B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,SAAS,EAAE;gBACV,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS;gBAC7B,GAAG;gBACH,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,QAAQ;oBACX,CAAC,CAAC;wBACA,MAAM,EAAE;4BACP;gCACC,GAAG,EAAE,QAAQ;gCACb,KAAK,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;gCACrC,MAAM,EAAE,IAAI,CAAC,kBAAkB,IAAI,GAAG;gCACtC,GAAG,EAAE,KAAK,CAAC,KAAK;6BAChB;yBACD;qBACD;oBACF,CAAC,CAAC,EAAE,CAAC;gBACN,GAAG,KAAK,CAAC,SAAS;aAClB;YACD,OAAO,EAAE;gBACR,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,KAAK,CAAC,OAAO;aAChB;SACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"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"}

package/dist/og.d.ts

@@ -0,0 +1,68 @@
+import { ImageResponse } from "next/og";
+type ImageResponseOptions = NonNullable<ConstructorParameters<typeof ImageResponse>[1]>;
+/**
+ * A branded Open Graph / Twitter card built with `next/og`. Lives on its own
+ * entry (`@ingram-tech/nk-seo/og`) because it imports `next/og` (satori + the
+ * resvg wasm) — the package root and `/components` stay free of it.
+ *
+ * Satori gotcha this template encodes so you don't have to: **every element
+ * with more than one child must set `display: "flex"`**, and you may not mix a
+ * text node and an element as siblings. The layout below keeps each region a
+ * single text node, so titles stay plain strings and the accent is carried by
+ * the mark — never by a coloured `<span>` inside the headline.
+ */
+export interface OgImageOptions {
+    /** The headline. Kept a single text node (no inline markup) for Satori. */
+    title: string;
+    /** Secondary line under the title. */
+    subtitle?: string;
+    /** Small label above the title (e.g. a section or category). */
+    eyebrow?: string;
+    /** Bottom-left footer, e.g. the bare domain. */
+    footer?: string;
+    /** Brand name shown next to the mark, top-left. */
+    wordmark?: string;
+    /**
+     * Logo image rendered as the top-left mark instead of the accent square.
+     * Absolute URL or data URI (Satori fetches it at render time).
+     */
+    logo?: string;
+    /** Accent colour — the mark, and the eyebrow if present. Default indigo. */
+    accent?: string;
+    background?: string;
+    /** Primary text colour. */
+    ink?: string;
+    /** Secondary text colour (subtitle, footer). */
+    muted?: string;
+    size?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Custom fonts, passed through to `ImageResponse` (Satori accepts raw
+     * TTF/OTF/WOFF data). Pair with `fontFamily` to actually use them.
+     */
+    fonts?: ImageResponseOptions["fonts"];
+    /** Font family for the whole card. Default "sans-serif". */
+    fontFamily?: string;
+}
+/**
+ * Returns an `ImageResponse` for use as the body of an `opengraph-image` /
+ * `twitter-image` route.
+ *
+ * @example
+ * // app/opengraph-image.tsx
+ * import { ogImageResponse } from "@ingram-tech/nk-seo/og";
+ * export const size = { width: 1200, height: 630 };
+ * export const contentType = "image/png";
+ * export default () =>
+ *   ogImageResponse({
+ *     title: "Ship faster with Acme",
+ *     subtitle: "The all-in-one platform for modern teams.",
+ *     wordmark: "Acme",
+ *     footer: "example.com",
+ *   });
+ */
+export declare function ogImageResponse(options: OgImageOptions): ImageResponse;
+export {};
+//# sourceMappingURL=og.d.ts.map

package/dist/og.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"og.d.ts","sourceRoot":"","sources":["../src/og.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,KAAK,oBAAoB,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC;;;OAGG;IACH,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACtC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAiFtE"}

package/dist/og.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ImageResponse } from "next/og";
+const DEFAULTS = {
+    accent: "#565ac9",
+    background: "#ffffff",
+    ink: "#171717",
+    muted: "#8a8a8a",
+    size: { width: 1200, height: 630 },
+};
+/**
+ * Returns an `ImageResponse` for use as the body of an `opengraph-image` /
+ * `twitter-image` route.
+ *
+ * @example
+ * // app/opengraph-image.tsx
+ * import { ogImageResponse } from "@ingram-tech/nk-seo/og";
+ * export const size = { width: 1200, height: 630 };
+ * export const contentType = "image/png";
+ * export default () =>
+ *   ogImageResponse({
+ *     title: "Ship faster with Acme",
+ *     subtitle: "The all-in-one platform for modern teams.",
+ *     wordmark: "Acme",
+ *     footer: "example.com",
+ *   });
+ */
+export function ogImageResponse(options) {
+    const accent = options.accent ?? DEFAULTS.accent;
+    const background = options.background ?? DEFAULTS.background;
+    const ink = options.ink ?? DEFAULTS.ink;
+    const muted = options.muted ?? DEFAULTS.muted;
+    const size = options.size ?? DEFAULTS.size;
+    return new ImageResponse(_jsxs("div", { style: {
+            width: "100%",
+            height: "100%",
+            display: "flex",
+            flexDirection: "column",
+            justifyContent: "space-between",
+            background,
+            padding: "80px",
+            fontFamily: options.fontFamily ?? "sans-serif",
+        }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: "20px" }, children: [options.logo ? (_jsx("img", { src: options.logo, width: 44, height: 44, alt: "" })) : (_jsx("div", { style: {
+                            width: "44px",
+                            height: "44px",
+                            borderRadius: "12px",
+                            background: accent,
+                        } })), options.wordmark ? (_jsx("div", { style: { fontSize: "40px", fontWeight: 600, color: ink }, children: options.wordmark })) : null] }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "24px" }, children: [options.eyebrow ? (_jsx("div", { style: {
+                            fontSize: "28px",
+                            fontWeight: 600,
+                            letterSpacing: "0.04em",
+                            textTransform: "uppercase",
+                            color: accent,
+                        }, children: options.eyebrow })) : null, _jsx("div", { style: {
+                            fontSize: "76px",
+                            fontWeight: 700,
+                            lineHeight: 1.05,
+                            letterSpacing: "-0.02em",
+                            color: ink,
+                            maxWidth: "1000px",
+                        }, children: options.title }), options.subtitle ? (_jsx("div", { style: { fontSize: "34px", color: muted, maxWidth: "900px" }, children: options.subtitle })) : null] }), options.footer ? (_jsx("div", { style: { fontSize: "30px", color: muted }, children: options.footer })) : (_jsx("div", { style: { display: "flex" } }))] }), { ...size, ...(options.fonts ? { fonts: options.fonts } : {}) });
+}
+//# sourceMappingURL=og.js.map

package/dist/og.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"og.js","sourceRoot":"","sources":["../src/og.tsx"],"names":[],"mappings":"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"}

package/dist/routes.d.ts

@@ -0,0 +1,91 @@
+import type { MetadataRoute } from "next";
+/**
+ * Route-handler helpers for `app/sitemap.ts` and `app/robots.ts`. Pure — no
+ * React — so they live in the package root next to the metadata factory and can
+ * be imported by route handlers freely.
+ *
+ * Both resolve site-relative paths against one `baseUrl` (pass your deployment's
+ * own origin, e.g. `getServerUrl()`), so preview / sandbox deployments advertise
+ * themselves and never leak the production host.
+ */
+type ChangeFrequency = NonNullable<MetadataRoute.Sitemap[number]["changeFrequency"]>;
+/** hreflang → URL map, keyed by the locale codes Next accepts. */
+export type SitemapLanguages = NonNullable<NonNullable<MetadataRoute.Sitemap[number]["alternates"]>["languages"]>;
+/** A sitemap entry. A bare string is shorthand for `{ path }`. */
+export interface SitemapRoute {
+    /** Site-relative path (e.g. "/pricing") or an absolute URL. */
+    path: string;
+    lastModified?: string | Date;
+    changeFrequency?: ChangeFrequency;
+    /** 0.0–1.0. Defaults to 1 for "/" and {@link SitemapConfig.defaultPriority} otherwise. */
+    priority?: number;
+    /**
+     * Per-locale alternates of this route (hreflang → site-relative path or
+     * absolute URL), e.g. `{ en: "/about", fr: "/fr/about" }`. Pairs with
+     * `<HreflangLinks>` / `hreflangAlternates` on the page side.
+     */
+    languages?: SitemapLanguages;
+}
+export interface SitemapConfig {
+    /** Absolute site origin, e.g. "https://example.com". */
+    baseUrl: string;
+    /** The indexable routes. Strings or `SitemapRoute` objects may be mixed. */
+    routes: Array<string | SitemapRoute>;
+    /** Applied when an entry omits `lastModified`. */
+    lastModified?: string | Date;
+    /** Applied when an entry omits `changeFrequency`. */
+    defaultChangeFrequency?: ChangeFrequency;
+    /** Priority for every non-root entry that omits its own. Default 0.7. */
+    defaultPriority?: number;
+}
+/**
+ * Builds a `MetadataRoute.Sitemap` from a list of routes, resolving relative
+ * paths against `baseUrl`. `"/"` defaults to priority 1; every other route
+ * defaults to `defaultPriority` (0.7).
+ *
+ * @example
+ * // app/sitemap.ts
+ * import { createSitemap } from "@ingram-tech/nk-seo";
+ * export default () =>
+ *   createSitemap({
+ *     baseUrl: getServerUrl(),
+ *     routes: ["/", "/pricing", "/docs", "/faq"],
+ *   });
+ */
+export declare function createSitemap(config: SitemapConfig): MetadataRoute.Sitemap;
+export interface RobotsConfig {
+    /** Absolute site origin, e.g. "https://example.com". */
+    baseUrl: string;
+    /**
+     * Whether this deployment is the canonical production host. When false, the
+     * whole site is disallowed so preview / sandbox / branch deployments never
+     * get indexed and dilute the real domain with duplicate content. Derive it
+     * from `VERCEL_ENV === "production"` (and/or a host check).
+     */
+    isProduction: boolean;
+    /** Prod-only disallow list (private routes, APIs, auth flows). */
+    disallow?: string[];
+    /** Prod allow rule. Default "/". */
+    allow?: string | string[];
+    /** Sitemap path advertised in prod. Default "/sitemap.xml". Pass null to omit. */
+    sitemapPath?: string | null;
+}
+/**
+ * Builds a `MetadataRoute.Robots`. On non-production hosts it returns a
+ * blanket `Disallow: /` — the single most-forgotten SEO safeguard on Vercel,
+ * where preview and branch URLs are otherwise crawlable and compete with the
+ * production domain.
+ *
+ * @example
+ * // 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"],
+ *   });
+ */
+export declare function createRobots(config: RobotsConfig): MetadataRoute.Robots;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C;;;;;;;;GAQG;AAEH,KAAK,eAAe,GAAG,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAErF,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,WAAW,CACzC,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CACrE,CAAC;AAEF,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;IACrC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qDAAqD;IACrD,sBAAsB,CAAC,EAAE,eAAe,CAAC;IACzC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAeD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAAC,OAAO,CA6B1E;AAED,MAAM,WAAW,YAAY;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC,MAAM,CAcvE"}

package/dist/routes.js

@@ -0,0 +1,78 @@
+import { absoluteUrl } from "./url.js";
+const resolveLanguages = (languages, baseUrl) => 
+// Object.entries/fromEntries erase the hreflang key union; the keys are
+// passed through unchanged (only values are resolved), so restoring it is safe.
+Object.fromEntries(Object.entries(languages).map(([locale, path]) => [
+    locale,
+    path === undefined ? path : absoluteUrl(path, baseUrl),
+]));
+/**
+ * Builds a `MetadataRoute.Sitemap` from a list of routes, resolving relative
+ * paths against `baseUrl`. `"/"` defaults to priority 1; every other route
+ * defaults to `defaultPriority` (0.7).
+ *
+ * @example
+ * // app/sitemap.ts
+ * import { createSitemap } from "@ingram-tech/nk-seo";
+ * export default () =>
+ *   createSitemap({
+ *     baseUrl: getServerUrl(),
+ *     routes: ["/", "/pricing", "/docs", "/faq"],
+ *   });
+ */
+export function createSitemap(config) {
+    const defaultPriority = config.defaultPriority ?? 0.7;
+    return config.routes.map((entry) => {
+        const route = typeof entry === "string" ? { path: entry } : entry;
+        const lastModified = route.lastModified ?? config.lastModified;
+        const changeFrequency = route.changeFrequency ?? config.defaultChangeFrequency;
+        const priority = route.priority ?? (route.path === "/" ? 1 : defaultPriority);
+        if (priority < 0 || priority > 1) {
+            throw new RangeError(`createSitemap: priority must be between 0 and 1, got ${priority} for "${route.path}"`);
+        }
+        return {
+            url: absoluteUrl(route.path, config.baseUrl),
+            ...(lastModified ? { lastModified } : {}),
+            ...(changeFrequency ? { changeFrequency } : {}),
+            priority,
+            ...(route.languages
+                ? {
+                    alternates: {
+                        languages: resolveLanguages(route.languages, config.baseUrl),
+                    },
+                }
+                : {}),
+        };
+    });
+}
+/**
+ * Builds a `MetadataRoute.Robots`. On non-production hosts it returns a
+ * blanket `Disallow: /` — the single most-forgotten SEO safeguard on Vercel,
+ * where preview and branch URLs are otherwise crawlable and compete with the
+ * production domain.
+ *
+ * @example
+ * // 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"],
+ *   });
+ */
+export function createRobots(config) {
+    if (!config.isProduction) {
+        return { rules: { userAgent: "*", disallow: "/" } };
+    }
+    const sitemapPath = config.sitemapPath === undefined ? "/sitemap.xml" : config.sitemapPath;
+    return {
+        rules: {
+            userAgent: "*",
+            allow: config.allow ?? "/",
+            ...(config.disallow?.length ? { disallow: config.disallow } : {}),
+        },
+        ...(sitemapPath ? { sitemap: absoluteUrl(sitemapPath, config.baseUrl) } : {}),
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -1,27 +1,44 @@
-/**
- * Typed schema.org JSON-LD builders. Each returns a plain object ready to hand
- * to `<JsonLd>` (from "@ingram-tech/nk-seo/components").
- *
- * The standalone builders take values as-is: pass **absolute** URLs for
- * `url`/`image`/`logo` fields. If your pages work in site-relative paths and
- * share one Organization, prefer {@link createSeo}, which resolves paths against
- * a base URL and injects the publisher/provider for you.
- */
-/** A schema.org node. Hand it to `<JsonLd data={...} />`. */
+/** A loosely-typed schema.org node. The builders return more precise subtypes. */
 export type JsonLdNode = Record<string, unknown>;
+/** A top-level schema.org node: the payload plus its `@context`. */
+export type WithContext<T> = T & {
+    "@context": "https://schema.org";
+};
 export interface FaqItem {
     question: string;
     answer: string;
 }
+export type QuestionNode = {
+    "@type": "Question";
+    name: string;
+    acceptedAnswer: {
+        "@type": "Answer";
+        text: string;
+    };
+};
+export type FaqPageNode = {
+    "@type": "FAQPage";
+    mainEntity: QuestionNode[];
+};
 /** FAQPage: marks up a list of question/answer pairs for FAQ rich results. */
-export declare function faqPage(items: FaqItem[]): JsonLdNode;
+export declare function faqPage(items: FaqItem[]): WithContext<FaqPageNode>;
 export interface BreadcrumbItem {
     name: string;
     /** Absolute URL of the crumb. */
     url: string;
 }
+export type ListItemNode = {
+    "@type": "ListItem";
+    position: number;
+    name: string;
+    item: string;
+};
+export type BreadcrumbListNode = {
+    "@type": "BreadcrumbList";
+    itemListElement: ListItemNode[];
+};
 /** BreadcrumbList: the trail of links Google shows in place of the raw URL. */
-export declare function breadcrumbList(items: BreadcrumbItem[]): JsonLdNode;
+export declare function breadcrumbList(items: BreadcrumbItem[]): WithContext<BreadcrumbListNode>;
 export interface OrganizationInput {
     name: string;
     /** Absolute URL of the organization's site. */
@@ -30,19 +47,46 @@ export interface OrganizationInput {
     logo?: string;
     description?: string;
     email?: string;
+    telephone?: string;
+    /** Registered/office postal address. */
+    address?: PostalAddressInput;
     /** Profile/social URLs that corroborate the entity (LinkedIn, Crunchbase…). */
     sameAs?: string[];
 }
+export type PostalAddressNode = {
+    "@type": "PostalAddress";
+} & PostalAddressInput;
+export type ImageObjectNode = {
+    "@type": "ImageObject";
+    url: string;
+};
+export type OrganizationNode = {
+    "@type": "Organization";
+    name: string;
+    url?: string;
+    logo?: ImageObjectNode;
+    description?: string;
+    email?: string;
+    telephone?: string;
+    address?: PostalAddressNode;
+    sameAs?: string[];
+};
 /** Organization: the entity behind the site (for the knowledge panel). */
-export declare function organization(input: OrganizationInput): JsonLdNode;
+export declare function organization(input: OrganizationInput): WithContext<OrganizationNode>;
 export interface WebsiteInput {
     name: string;
     /** Absolute URL of the site root. */
     url: string;
     publisher?: OrganizationInput;
 }
+export type WebsiteNode = {
+    "@type": "WebSite";
+    name: string;
+    url: string;
+    publisher?: OrganizationNode;
+};
 /** WebSite: identifies the site as an entity; pair with {@link organization}. */
-export declare function website(input: WebsiteInput): JsonLdNode;
+export declare function website(input: WebsiteInput): WithContext<WebsiteNode>;
 export interface OfferInput {
     priceCurrency: string;
     /** Single price. Mutually exclusive with low/high (which emit an AggregateOffer). */
@@ -53,6 +97,20 @@ export interface OfferInput {
     /** Absolute URL of the pricing/offer page. */
     url?: string;
 }
+export type OfferNode = {
+    "@type": "Offer";
+    priceCurrency: string;
+    price?: string;
+    url?: string;
+};
+export type AggregateOfferNode = {
+    "@type": "AggregateOffer";
+    priceCurrency: string;
+    lowPrice?: string;
+    highPrice?: string;
+    offerCount?: string;
+    url?: string;
+};
 export interface SoftwareApplicationInput {
     name: string;
     description?: string;
@@ -64,8 +122,17 @@ export interface SoftwareApplicationInput {
     operatingSystem?: string;
     offers?: OfferInput;
 }
+export type SoftwareApplicationNode = {
+    "@type": "SoftwareApplication";
+    name: string;
+    applicationCategory?: string;
+    operatingSystem?: string;
+    url?: string;
+    description?: string;
+    offers?: OfferNode | AggregateOfferNode;
+};
 /** SoftwareApplication: marks a product page as an app for rich results. */
-export declare function softwareApplication(input: SoftwareApplicationInput): JsonLdNode;
+export declare function softwareApplication(input: SoftwareApplicationInput): WithContext<SoftwareApplicationNode>;
 export interface ArticleAuthor {
     name: string;
     /** Absolute URL of the author's profile/page. */
@@ -86,8 +153,26 @@ export interface ArticleInput {
     keywords?: string[];
     publisher?: OrganizationInput;
 }
+export type ArticleAuthorNode = {
+    "@type": "Person";
+    name: string;
+    url?: string;
+};
+export type ArticleNode = {
+    "@type": "Article" | "BlogPosting" | "NewsArticle" | "ScholarlyArticle";
+    headline: string;
+    url: string;
+    mainEntityOfPage: string;
+    description?: string;
+    author?: ArticleAuthorNode[];
+    publisher?: OrganizationNode;
+    datePublished?: string;
+    dateModified?: string;
+    image?: string;
+    keywords?: string[];
+};
 /** Article (or BlogPosting/NewsArticle/ScholarlyArticle) for editorial pages. */
-export declare function article(input: ArticleInput): JsonLdNode;
+export declare function article(input: ArticleInput): WithContext<ArticleNode>;
 export interface PersonInput {
     name: string;
     /** Absolute URL of the person's page/profile. */
@@ -104,8 +189,23 @@ export interface PersonInput {
     /** Home location place name, e.g. "Brussels, Belgium". */
     homeLocation?: string;
 }
+export type PersonNode = {
+    "@type": "Person";
+    name: string;
+    url?: string;
+    jobTitle?: string;
+    worksFor?: OrganizationNode;
+    image?: string;
+    description?: string;
+    email?: string;
+    sameAs?: string[];
+    homeLocation?: {
+        "@type": "Place";
+        name: string;
+    };
+};
 /** Person: identifies an individual as an entity (portfolio, team, author bios). */
-export declare function person(input: PersonInput): JsonLdNode;
+export declare function person(input: PersonInput): WithContext<PersonNode>;
 export interface PostalAddressInput {
     streetAddress?: string;
     addressLocality?: string;
@@ -145,8 +245,36 @@ export interface LocalBusinessInput {
     /** schema.org LocalBusiness subtype, e.g. "Store", "ArtGallery". Default "LocalBusiness". */
     type?: string;
 }
+export type GeoCoordinatesNode = {
+    "@type": "GeoCoordinates";
+    latitude: number;
+    longitude: number;
+};
+export type AggregateRatingNode = {
+    "@type": "AggregateRating";
+    ratingValue: string;
+    reviewCount: string;
+};
+export type LocalBusinessNode = {
+    /** "LocalBusiness" or the subtype passed as `type`. */
+    "@type": string;
+    name: string;
+    url?: string;
+    description?: string;
+    image?: string[];
+    logo?: string;
+    email?: string;
+    telephone?: string;
+    priceRange?: string;
+    openingHours?: string | string[];
+    address?: PostalAddressNode;
+    geo?: GeoCoordinatesNode;
+    hasMap?: string;
+    aggregateRating?: AggregateRatingNode;
+    sameAs?: string[];
+};
 /** LocalBusiness (or a subtype): a physical business for local/maps SEO. */
-export declare function localBusiness(input: LocalBusinessInput): JsonLdNode;
+export declare function localBusiness(input: LocalBusinessInput): WithContext<LocalBusinessNode>;
 export interface EventLocationInput {
     name?: string;
     /** Postal address string or a URL for online events. */
@@ -174,12 +302,40 @@ export interface EventInput {
     eventStatus?: string;
     attendanceMode?: "offline" | "online" | "mixed";
 }
+export type PlaceNode = {
+    "@type": "Place";
+    name?: string;
+    address?: string;
+    url?: string;
+};
+export type VirtualLocationNode = {
+    "@type": "VirtualLocation";
+    url?: string;
+};
+export type EventNode = {
+    "@type": "Event";
+    name: string;
+    startDate: string;
+    endDate: string;
+    eventStatus: string;
+    eventAttendanceMode?: string;
+    description?: string;
+    url?: string;
+    image?: string[];
+    location?: PlaceNode | VirtualLocationNode;
+    organizer?: OrganizationNode;
+    offers?: OfferNode | AggregateOfferNode;
+};
 /** Event: a scheduled happening (summit, workshop, conference) for event rich results. */
-export declare function event(input: EventInput): JsonLdNode;
+export declare function event(input: EventInput): WithContext<EventNode>;
 export interface SeoConfig {
-    /** Absolute site origin, e.g. "https://financica.app". */
+    /** Absolute site origin, e.g. "https://acme.example". */
     baseUrl: string;
-    /** Shared publisher/provider, injected into article()/website()/organization(). */
+    /**
+     * Shared publisher/provider, injected into article()/website()/organization().
+     * Its `url` and `logo` may be site-relative — they are resolved against
+     * `baseUrl`.
+     */
     organization?: OrganizationInput;
 }
 /** A path-aware version of a crumb: `path` is resolved against the base URL. */
@@ -190,6 +346,8 @@ export interface BreadcrumbPath {
 /**
  * Binds the builders to a site so callers pass site-relative paths instead of
  * absolute URLs, and the configured Organization is injected automatically.
+ * Nested URL fields (`organization.url`/`logo`, `offers.url`, article `image`)
+ * are resolved too — JSON-LD must never ship relative URLs.
  *
  * @example
  * const seo = createSeo({ baseUrl: getServerUrl(), organization: ORG });
@@ -201,21 +359,21 @@ export declare function createSeo(config: SeoConfig): {
     /** FAQPage (path-free). */
     faqPage: typeof faqPage;
     /** BreadcrumbList from site-relative paths. */
-    breadcrumbs(items: BreadcrumbPath[]): JsonLdNode;
+    breadcrumbs(items: BreadcrumbPath[]): WithContext<BreadcrumbListNode>;
     /** Organization from config (with optional per-call overrides). */
-    organization(overrides?: Partial<OrganizationInput>): JsonLdNode;
+    organization(overrides?: Partial<OrganizationInput>): WithContext<OrganizationNode>;
     /** WebSite from config, defaulting name/url/publisher to the configured org. */
-    website(input?: Partial<WebsiteInput>): JsonLdNode;
-    /** SoftwareApplication; `path` (default "/") is resolved to an absolute URL. */
+    website(input?: Partial<WebsiteInput>): WithContext<WebsiteNode>;
+    /** SoftwareApplication; `path` (default "/") and `offers.url` are resolved. */
     softwareApplication(input: Omit<SoftwareApplicationInput, "url"> & {
         path?: string;
-    }): JsonLdNode;
+    }): WithContext<SoftwareApplicationNode>;
     /** Article; `path`/`image` are resolved and the configured org becomes publisher. */
     article(input: Omit<ArticleInput, "url" | "image" | "publisher"> & {
         path: string;
         image?: string;
         publisher?: OrganizationInput;
-    }): JsonLdNode;
+    }): WithContext<ArticleNode>;
 };
 export type Seo = ReturnType<typeof createSeo>;
 //# sourceMappingURL=schema.d.ts.map