@zedtech/zedkit-seo 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zedtech-fr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @zedtech/zedkit-seo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Generic SEO bricks: robots, sitemaps, typed JSON-LD, page metadata,
+llms.txt, slugs. Pure functions, options-driven, no brand, no CMS.
+Original work by the same author.
+
+```sh
+pnpm add @zedtech/zedkit-seo
+```
+
+```ts
+import { buildRobots, buildSitemapEntries } from "@zedtech/zedkit-seo";
+
+export async function GET() {
+  return Response.json(buildSitemapEntries({ siteUrl, locales, pages }));
+}
+export function robots() {
+  return buildRobots({ siteUrl });
+}
+```
+
+Return shapes follow the Next.js Metadata API (`MetadataRoute.Robots`,
+`MetadataRoute.Sitemap`, `Metadata`) so builders drop straight into
+`robots.ts`, `sitemap.ts`, and `generateMetadata`. JSON-LD builders
+return `schema-dts` types. Map CMS docs to the plain `pages`/`videos`
+inputs first — the package never talks to a CMS.
+
+## API
+
+- `buildRobots({ siteUrl, extraSitemaps?, disallow?, allow? })`
+- `buildSitemapEntries({ siteUrl, locales, pages })`
+- `buildVideoSitemap({ videos })`, `escapeXml(value)`
+- `buildOrganizationJsonLd`, `buildWebPageJsonLd`,
+  `buildBreadcrumbJsonLd`, `buildArticleJsonLd`
+- `buildPageMetadata({ site, page, locale, pathname, ogImage?, robots? })`
+- `llmsTextResponse({ body })`, `normalizeLlmsBody`, `buildLlmsFull`
+- `truncateDescription`, `resolveDescription`, `resolveLocalizedField`
+- `normalizeSlug`, `isDraftSlug`
+
+See CATALOG.md for needs-first examples.

package/dist/description.d.ts

@@ -0,0 +1,17 @@
+export declare const SEO_DESCRIPTION_MAX = 160;
+/** Collapse whitespace and cap at 160 chars with an ellipsis (SERP length). */
+export declare function truncateDescription(text: string, max?: number): string;
+export type LocalizedField = string | Partial<Record<string, string>> | null | undefined;
+/** Resolve a localized CMS value: exact locale, then fallbacks, then first. */
+export declare function resolveLocalizedField(value: LocalizedField, locale: string, fallbackLocales?: string[]): string;
+export interface DescriptionSource {
+    /** Explicit SEO description (wins when present). */
+    custom?: string | null;
+    /** Plain-text body to derive from (convert rich text to text first). */
+    bodyText?: string | null;
+    /** Localized title, last resort. */
+    title?: LocalizedField;
+}
+/** Description fallback chain: custom → body text → title, truncated. */
+export declare function resolveDescription(source: DescriptionSource, locale?: string): string;
+//# sourceMappingURL=description.d.ts.map

package/dist/description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.d.ts","sourceRoot":"","sources":["../src/description.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAA4B,GAAG,MAAM,CAI3F;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzF,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAM,EAAW,GACjC,MAAM,CAWR;AAED,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAO,GAAG,MAAM,CAMnF"}

package/dist/description.js

@@ -0,0 +1,36 @@
+export const SEO_DESCRIPTION_MAX = 160;
+/** Collapse whitespace and cap at 160 chars with an ellipsis (SERP length). */
+export function truncateDescription(text, max = SEO_DESCRIPTION_MAX) {
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (normalized.length <= max)
+        return normalized;
+    return `${normalized.slice(0, max - 1).trimEnd()}…`;
+}
+/** Resolve a localized CMS value: exact locale, then fallbacks, then first. */
+export function resolveLocalizedField(value, locale, fallbackLocales = ["en"]) {
+    if (typeof value === "string")
+        return value.trim();
+    if (value === null || value === undefined)
+        return "";
+    for (const candidate of [locale, ...fallbackLocales]) {
+        const hit = value[candidate];
+        if (hit !== undefined && hit.trim().length > 0)
+            return hit.trim();
+    }
+    for (const hit of Object.values(value)) {
+        if (hit !== undefined && hit.trim().length > 0)
+            return hit.trim();
+    }
+    return "";
+}
+/** Description fallback chain: custom → body text → title, truncated. */
+export function resolveDescription(source, locale = "en") {
+    const custom = (source.custom ?? "").trim();
+    if (custom.length > 0)
+        return truncateDescription(custom);
+    const body = (source.bodyText ?? "").trim();
+    if (body.length > 0)
+        return truncateDescription(body);
+    return truncateDescription(resolveLocalizedField(source.title, locale));
+}
+//# sourceMappingURL=description.js.map

package/dist/description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description.js","sourceRoot":"","sources":["../src/description.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,MAAc,mBAAmB;IACjF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,UAAU,CAAC;IAChD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACtD,CAAC;AAID,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CACnC,KAAqB,EACrB,MAAc,EACd,kBAA4B,CAAC,IAAI,CAAC;IAElC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAWD,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,MAAyB,EAAE,MAAM,GAAG,IAAI;IACzE,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,mBAAmB,CAAC,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { SEO_DESCRIPTION_MAX, resolveDescription, resolveLocalizedField, truncateDescription, type DescriptionSource, type LocalizedField, } from "./description.js";
+export { buildArticleJsonLd, buildBreadcrumbJsonLd, buildOrganizationJsonLd, buildWebPageJsonLd, type ArticleJsonLdOptions, type BreadcrumbItem, type OrganizationJsonLdOptions, type WebPageJsonLdOptions, } from "./jsonld.js";
+export { buildLlmsFull, llmsTextResponse, normalizeLlmsBody, type LlmsFullSection, type LlmsTextResponseOptions, } from "./llms.js";
+export { buildPageMetadata, type BuildPageMetadataOptions, type OpenGraphImage, type PageContent, type PageMetadata, type SiteMetadata, } from "./metadata.js";
+export { buildRobots, type BuildRobotsOptions, type RobotsConfig } from "./robots.js";
+export { buildSitemapEntries, type BuildSitemapOptions, type SitemapEntry, type SitemapPage, } from "./sitemap.js";
+export { isDraftSlug, normalizeSlug } from "./slug.js";
+export { buildVideoSitemap, escapeXml, type BuildVideoSitemapOptions, type VideoSitemapEntry, } from "./video-sitemap.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { SEO_DESCRIPTION_MAX, resolveDescription, resolveLocalizedField, truncateDescription, } from "./description.js";
+export { buildArticleJsonLd, buildBreadcrumbJsonLd, buildOrganizationJsonLd, buildWebPageJsonLd, } from "./jsonld.js";
+export { buildLlmsFull, llmsTextResponse, normalizeLlmsBody, } from "./llms.js";
+export { buildPageMetadata, } from "./metadata.js";
+export { buildRobots } from "./robots.js";
+export { buildSitemapEntries, } from "./sitemap.js";
+export { isDraftSlug, normalizeSlug } from "./slug.js";
+export { buildVideoSitemap, escapeXml, } from "./video-sitemap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GAGpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,GAKnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,GAMlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,mBAAmB,GAIpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,SAAS,GAGV,MAAM,oBAAoB,CAAC"}

package/dist/jsonld.d.ts

@@ -0,0 +1,31 @@
+import type { Article, BreadcrumbList, Organization, WebPage, WithContext } from "schema-dts";
+export interface OrganizationJsonLdOptions {
+    name: string;
+    url: string;
+    logoUrl?: string;
+    sameAs?: string[];
+}
+export declare function buildOrganizationJsonLd(options: OrganizationJsonLdOptions): WithContext<Organization>;
+export interface WebPageJsonLdOptions {
+    title: string;
+    description: string;
+    url: string;
+    breadcrumb?: BreadcrumbList;
+}
+export declare function buildWebPageJsonLd(options: WebPageJsonLdOptions): WithContext<WebPage>;
+export interface BreadcrumbItem {
+    name: string;
+    url: string;
+}
+export declare function buildBreadcrumbJsonLd(items: BreadcrumbItem[]): WithContext<BreadcrumbList>;
+export interface ArticleJsonLdOptions {
+    title: string;
+    description: string;
+    url: string;
+    datePublished: string;
+    dateModified?: string;
+    authorName?: string;
+    imageUrl?: string;
+}
+export declare function buildArticleJsonLd(options: ArticleJsonLdOptions): WithContext<Article>;
+//# sourceMappingURL=jsonld.d.ts.map

package/dist/jsonld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.d.ts","sourceRoot":"","sources":["../src/jsonld.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,YAAY,EACZ,OAAO,EACP,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,WAAW,CAAC,YAAY,CAAC,CAUrG;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAAC,OAAO,CAAC,CAStF;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,CAW1F;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAAC,OAAO,CAAC,CActF"}

package/dist/jsonld.js

@@ -0,0 +1,49 @@
+export function buildOrganizationJsonLd(options) {
+    return {
+        "@context": "https://schema.org",
+        "@type": "Organization",
+        "@id": `${options.url.replace(/\/$/, "")}/#organization`,
+        name: options.name,
+        url: options.url,
+        ...(options.logoUrl === undefined ? {} : { logo: options.logoUrl }),
+        ...(options.sameAs === undefined ? {} : { sameAs: options.sameAs }),
+    };
+}
+export function buildWebPageJsonLd(options) {
+    return {
+        "@context": "https://schema.org",
+        "@type": "WebPage",
+        name: options.title,
+        description: options.description,
+        url: options.url,
+        ...(options.breadcrumb === undefined ? {} : { breadcrumb: options.breadcrumb }),
+    };
+}
+export function buildBreadcrumbJsonLd(items) {
+    return {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        itemListElement: items.map((item, index) => ({
+            "@type": "ListItem",
+            position: index + 1,
+            name: item.name,
+            item: item.url,
+        })),
+    };
+}
+export function buildArticleJsonLd(options) {
+    return {
+        "@context": "https://schema.org",
+        "@type": "Article",
+        headline: options.title,
+        description: options.description,
+        url: options.url,
+        datePublished: options.datePublished,
+        ...(options.dateModified === undefined ? {} : { dateModified: options.dateModified }),
+        ...(options.authorName === undefined
+            ? {}
+            : { author: { "@type": "Person", name: options.authorName } }),
+        ...(options.imageUrl === undefined ? {} : { image: options.imageUrl }),
+    };
+}
+//# sourceMappingURL=jsonld.js.map

package/dist/jsonld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonld.js","sourceRoot":"","sources":["../src/jsonld.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,uBAAuB,CAAC,OAAkC;IACxE,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB;QACxD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,OAAO,CAAC,KAAK;QACnB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,qBAAqB,CAAC,KAAuB;IAC3D,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,gBAAgB;QACzB,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,KAAK,GAAG,CAAC;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,GAAG;SACf,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO;QACL,UAAU,EAAE,oBAAoB;QAChC,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,OAAO,CAAC,KAAK;QACvB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/llms.d.ts

@@ -0,0 +1,17 @@
+/** Normalize CMS-stored llms.txt content (CRLF + surrounding blank lines). */
+export declare function normalizeLlmsBody(body: string): string;
+export interface LlmsTextResponseOptions {
+    /** Normalized body; empty answers 404 (nothing published yet). */
+    body: string;
+    /** Cache for served bodies. Defaults to one minute. */
+    cacheControl?: string;
+}
+/** `text/plain` Response for an llms.txt route (200 with body, else 404). */
+export declare function llmsTextResponse(options: LlmsTextResponseOptions): Response;
+export interface LlmsFullSection {
+    title: string;
+    body: string;
+}
+/** Join titled sections into one llms-full document (skips empty bodies). */
+export declare function buildLlmsFull(sections: LlmsFullSection[]): string;
+//# sourceMappingURL=llms.d.ts.map

package/dist/llms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../src/llms.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,QAAQ,CAe3E;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAMjE"}

package/dist/llms.js

@@ -0,0 +1,30 @@
+/** Normalize CMS-stored llms.txt content (CRLF + surrounding blank lines). */
+export function normalizeLlmsBody(body) {
+    return body.replace(/\r\n/g, "\n").trim();
+}
+/** `text/plain` Response for an llms.txt route (200 with body, else 404). */
+export function llmsTextResponse(options) {
+    const body = normalizeLlmsBody(options.body);
+    if (body.length === 0) {
+        return new Response("Not Found", {
+            status: 404,
+            headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "no-store" },
+        });
+    }
+    return new Response(`${body}\n`, {
+        status: 200,
+        headers: {
+            "Content-Type": "text/plain; charset=utf-8",
+            "Cache-Control": options.cacheControl ?? "public, max-age=60",
+        },
+    });
+}
+/** Join titled sections into one llms-full document (skips empty bodies). */
+export function buildLlmsFull(sections) {
+    return sections
+        .map((section) => ({ title: section.title.trim(), body: normalizeLlmsBody(section.body) }))
+        .filter((section) => section.title.length > 0 && section.body.length > 0)
+        .map((section) => `# ${section.title}\n\n${section.body}`)
+        .join("\n\n");
+}
+//# sourceMappingURL=llms.js.map

package/dist/llms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.js","sourceRoot":"","sources":["../src/llms.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AASD,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE;YAC/B,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,eAAe,EAAE,UAAU,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,GAAG,IAAI,IAAI,EAAE;QAC/B,MAAM,EAAE,GAAG;QACX,OAAO,EAAE;YACP,cAAc,EAAE,2BAA2B;YAC3C,eAAe,EAAE,OAAO,CAAC,YAAY,IAAI,oBAAoB;SAC9D;KACF,CAAC,CAAC;AACL,CAAC;AAOD,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,QAA2B;IACvD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAC1F,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACxE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;SACzD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Page metadata, shaped for Next.js `Metadata` (generateMetadata return).
+ * Structural on purpose: no Next dependency, assignable where used.
+ */
+export interface PageMetadata {
+    title: string;
+    description: string;
+    keywords?: string[];
+    authors?: Array<{
+        name: string;
+    }>;
+    creator?: string;
+    publisher?: string;
+    metadataBase?: URL;
+    alternates?: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+    openGraph?: {
+        type: "website" | "article";
+        locale?: string;
+        url?: string;
+        siteName?: string;
+        title?: string;
+        description?: string;
+        images?: Array<{
+            url: string;
+            width?: number;
+            height?: number;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card: "summary" | "summary_large_image";
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    robots?: {
+        index: boolean;
+        follow: boolean;
+        googleBot?: {
+            index: boolean;
+            follow: boolean;
+            "max-video-preview"?: number;
+            "max-image-preview"?: "none" | "standard" | "large";
+            "max-snippet"?: number;
+        };
+    };
+}
+export interface SiteMetadata {
+    name: string;
+    url: string;
+    defaultLocale: string;
+    locales: string[];
+}
+export interface PageContent {
+    title: string;
+    description: string;
+    keywords?: string[];
+}
+export interface OpenGraphImage {
+    url: string;
+    width: number;
+    height: number;
+}
+export interface BuildPageMetadataOptions {
+    site: SiteMetadata;
+    page: PageContent;
+    /** Active locale, e.g. `"en"`. */
+    locale: string;
+    /** Full pathname including the locale prefix, e.g. `/en/work/slug`. */
+    pathname: string;
+    /** Brand or page social image. */
+    ogImage?: OpenGraphImage;
+    /** Open Graph locale tag, e.g. `"en_US"`. Defaults to `<locale>_<LOCALE>`. */
+    openGraphLocale?: string;
+    /** Page-level robots overrides (e.g. `{ index: false }` for drafts). */
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+    };
+}
+export declare function buildPageMetadata(options: BuildPageMetadataOptions): PageMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChF,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,SAAS,GAAG,qBAAqB,CAAC;QACxC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE;YACV,KAAK,EAAE,OAAO,CAAC;YACf,MAAM,EAAE,OAAO,CAAC;YAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;YAC7B,mBAAmB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;YACpD,aAAa,CAAC,EAAE,MAAM,CAAC;SACxB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAWD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAuDjF"}

package/dist/metadata.js

@@ -0,0 +1,65 @@
+function stripLocale(pathname, locales) {
+    for (const locale of locales) {
+        if (pathname === `/${locale}` || pathname.startsWith(`/${locale}/`)) {
+            return pathname.slice(locale.length + 1) || "/";
+        }
+    }
+    return pathname || "/";
+}
+export function buildPageMetadata(options) {
+    const { site, page, locale } = options;
+    const barePath = stripLocale(options.pathname, site.locales);
+    const suffix = barePath === "/" ? "" : barePath;
+    const languages = {};
+    for (const available of site.locales) {
+        languages[available] = `/${available}${suffix}`;
+    }
+    languages["x-default"] = `/${site.defaultLocale}${suffix}`;
+    const index = options.robots?.index ?? true;
+    const follow = options.robots?.follow ?? true;
+    const image = options.ogImage;
+    return {
+        title: page.title,
+        description: page.description,
+        ...(page.keywords === undefined ? {} : { keywords: page.keywords }),
+        authors: [{ name: site.name }],
+        creator: site.name,
+        publisher: site.name,
+        metadataBase: new URL(site.url),
+        alternates: {
+            canonical: `/${locale}${suffix}`,
+            languages,
+        },
+        openGraph: {
+            type: "website",
+            locale: options.openGraphLocale ?? `${locale}_${locale.toUpperCase()}`,
+            url: `${site.url.replace(/\/$/, "")}/${locale}${suffix}`,
+            siteName: site.name,
+            title: page.title,
+            description: page.description,
+            ...(image === undefined
+                ? {}
+                : {
+                    images: [{ url: image.url, width: image.width, height: image.height, alt: site.name }],
+                }),
+        },
+        twitter: {
+            card: "summary_large_image",
+            title: page.title,
+            description: page.description,
+            ...(image === undefined ? {} : { images: [image.url] }),
+        },
+        robots: {
+            index,
+            follow,
+            googleBot: {
+                index,
+                follow,
+                "max-video-preview": -1,
+                "max-image-preview": "large",
+                "max-snippet": -1,
+            },
+        },
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AA8EA,SAAS,WAAW,CAAC,QAAgB,EAAE,OAAiB;IACtD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,QAAQ,KAAK,IAAI,MAAM,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,IAAI,GAAG,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAChD,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;IAClD,CAAC;IACD,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,IAAI,CAAC,aAAa,GAAG,MAAM,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,SAAS,EAAE,IAAI,CAAC,IAAI;QACpB,YAAY,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/B,UAAU,EAAE;YACV,SAAS,EAAE,IAAI,MAAM,GAAG,MAAM,EAAE;YAChC,SAAS;SACV;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,OAAO,CAAC,eAAe,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE;YACtE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,GAAG,MAAM,EAAE;YACxD,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,KAAK,KAAK,SAAS;gBACrB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;iBACvF,CAAC;SACP;QACD,OAAO,EAAE;YACP,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;SACxD;QACD,MAAM,EAAE;YACN,KAAK;YACL,MAAM;YACN,SAAS,EAAE;gBACT,KAAK;gBACL,MAAM;gBACN,mBAAmB,EAAE,CAAC,CAAC;gBACvB,mBAAmB,EAAE,OAAO;gBAC5B,aAAa,EAAE,CAAC,CAAC;aAClB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/robots.d.ts

@@ -0,0 +1,25 @@
+/** robots.txt content, shaped for Next.js `MetadataRoute.Robots` routes. */
+export interface RobotsConfig {
+    rules: {
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+    } | Array<{
+        userAgent: string | string[];
+        allow?: string | string[];
+        disallow?: string | string[];
+    }>;
+    sitemap?: string | string[];
+}
+export interface BuildRobotsOptions {
+    /** Absolute site URL, e.g. `https://example.com` (trailing slash trimmed). */
+    siteUrl: string;
+    /** Extra sitemap URLs besides the default `/sitemap.xml` (e.g. a video sitemap). */
+    extraSitemaps?: string[];
+    /** Paths crawlers may not visit. Defaults to the admin area. */
+    disallow?: string[];
+    /** Paths crawlers may visit. Defaults to `/`. */
+    allow?: string[];
+}
+export declare function buildRobots(options: BuildRobotsOptions): RobotsConfig;
+//# sourceMappingURL=robots.d.ts.map

package/dist/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,GAAG,KAAK,CAAC;QACR,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC9B,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAYrE"}

package/dist/robots.js

@@ -0,0 +1,14 @@
+export function buildRobots(options) {
+    const base = options.siteUrl.replace(/\/$/, "");
+    const extra = options.extraSitemaps ?? [];
+    const sitemap = extra.length === 0 ? `${base}/sitemap.xml` : [`${base}/sitemap.xml`, ...extra];
+    return {
+        rules: {
+            userAgent: "*",
+            allow: options.allow ?? "/",
+            disallow: options.disallow ?? "/admin/",
+        },
+        sitemap,
+    };
+}
+//# sourceMappingURL=robots.js.map

package/dist/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,cAAc,EAAE,GAAG,KAAK,CAAC,CAAC;IAC/F,OAAO;QACL,KAAK,EAAE;YACL,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;SACxC;QACD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/sitemap.d.ts

@@ -0,0 +1,24 @@
+/** Sitemap entry, shaped for Next.js `MetadataRoute.Sitemap` routes. */
+export interface SitemapEntry {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+}
+export interface SitemapPage {
+    /** Locale-less path: `""` for the home page, else `/path` or `/section/slug`. */
+    path: string;
+    lastModified?: string | Date;
+    changeFrequency?: SitemapEntry["changeFrequency"];
+    priority?: number;
+}
+export interface BuildSitemapOptions {
+    /** Absolute site URL, e.g. `https://example.com` (trailing slash trimmed). */
+    siteUrl: string;
+    /** Locales to prefix every page with, e.g. `["en", "fr"]`. */
+    locales: string[];
+    /** Pages to list under each locale. Map CMS docs to this shape first. */
+    pages: SitemapPage[];
+}
+export declare function buildSitemapEntries(options: BuildSitemapOptions): SitemapEntry[];
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,EAAE,CAchF"}

package/dist/sitemap.js

@@ -0,0 +1,16 @@
+export function buildSitemapEntries(options) {
+    const base = options.siteUrl.replace(/\/$/, "");
+    const entries = [];
+    for (const locale of options.locales) {
+        for (const page of options.pages) {
+            entries.push({
+                url: `${base}/${locale}${page.path}`,
+                ...(page.lastModified === undefined ? {} : { lastModified: page.lastModified }),
+                ...(page.changeFrequency === undefined ? {} : { changeFrequency: page.changeFrequency }),
+                ...(page.priority === undefined ? {} : { priority: page.priority }),
+            });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,mBAAmB,CAAC,OAA4B;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE,GAAG,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE;gBACpC,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC/E,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACxF,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;aACpE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,5 @@
+/** Lowercase, dashed, ASCII slug (accents stripped via NFKD). */
+export declare function normalizeSlug(value: string): string;
+/** Draft placeholder slugs (`""`, `untitled`, `untitled-N`, `draft-N`). */
+export declare function isDraftSlug(slug: string | null | undefined): boolean;
+//# sourceMappingURL=slug.d.ts.map

package/dist/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAKpE"}

package/dist/slug.js

@@ -0,0 +1,22 @@
+/** Lowercase, dashed, ASCII slug (accents stripped via NFKD). */
+export function normalizeSlug(value) {
+    return value
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/\s+/g, "-")
+        .replace(/[^\w-]+/g, "")
+        .replace(/--+/g, "-")
+        .replace(/^-+/, "")
+        .replace(/-+$/, "");
+}
+/** Draft placeholder slugs (`""`, `untitled`, `untitled-N`, `draft-N`). */
+export function isDraftSlug(slug) {
+    const value = (slug ?? "").trim().toLowerCase();
+    if (value.length === 0)
+        return true;
+    if (value === "untitled")
+        return true;
+    return /^untitled-\d+$/.test(value) || /^draft-\d+$/.test(value);
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK;SACT,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,IAA+B;IACzD,MAAM,KAAK,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/video-sitemap.d.ts

@@ -0,0 +1,22 @@
+export declare function escapeXml(value: string): string;
+export interface VideoSitemapEntry {
+    /** Absolute URL of the page embedding the video. */
+    pageUrl: string;
+    /** Absolute URL of the thumbnail image. */
+    thumbnailUrl: string;
+    title: string;
+    description: string;
+    /** Direct media file URL, when the video is self-hosted. */
+    contentUrl?: string;
+    /** Player page URL (embeds allowed), for hosted videos. */
+    playerUrl?: string;
+    /** Publication date, `YYYY-MM-DD`. */
+    publicationDate?: string;
+    familyFriendly?: boolean;
+}
+export interface BuildVideoSitemapOptions {
+    videos: VideoSitemapEntry[];
+}
+/** Google video sitemap XML (`sitemap-video/1.1` namespace). */
+export declare function buildVideoSitemap(options: BuildVideoSitemapOptions): string;
+//# sourceMappingURL=video-sitemap.d.ts.map

package/dist/video-sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-sitemap.d.ts","sourceRoot":"","sources":["../src/video-sitemap.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAsB3E"}

package/dist/video-sitemap.js

@@ -0,0 +1,31 @@
+export function escapeXml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/** Google video sitemap XML (`sitemap-video/1.1` namespace). */
+export function buildVideoSitemap(options) {
+    const urls = options.videos.map((video) => {
+        const tags = [
+            `      <video:thumbnail_loc>${escapeXml(video.thumbnailUrl)}</video:thumbnail_loc>`,
+            `      <video:title>${escapeXml(video.title)}</video:title>`,
+            `      <video:description>${escapeXml(video.description)}</video:description>`,
+        ];
+        if (video.contentUrl !== undefined) {
+            tags.push(`      <video:content_loc>${escapeXml(video.contentUrl)}</video:content_loc>`);
+        }
+        if (video.playerUrl !== undefined) {
+            tags.push(`      <video:player_loc allow_embed="yes">${escapeXml(video.playerUrl)}</video:player_loc>`);
+        }
+        if (video.publicationDate !== undefined) {
+            tags.push(`      <video:publication_date>${escapeXml(video.publicationDate)}</video:publication_date>`);
+        }
+        tags.push(`      <video:family_friendly>${video.familyFriendly === false ? "no" : "yes"}</video:family_friendly>`);
+        return `  <url>\n    <loc>${escapeXml(video.pageUrl)}</loc>\n    <video:video>\n${tags.join("\n")}\n    </video:video>\n  </url>`;
+    });
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset\n  xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"\n  xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"\n>\n${urls.join("\n")}\n</urlset>`;
+}
+//# sourceMappingURL=video-sitemap.js.map

package/dist/video-sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-sitemap.js","sourceRoot":"","sources":["../src/video-sitemap.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAsBD,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,IAAI,GAAG;YACX,8BAA8B,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,wBAAwB;YACnF,sBAAsB,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB;YAC5D,4BAA4B,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,sBAAsB;SAC/E,CAAC;QACF,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,4BAA4B,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CACP,6CAA6C,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,CAC7F,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,iCAAiC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,2BAA2B,CAAC,CAAC;QAC1G,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,gCAAgC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,0BAA0B,CAAC,CAAC;QACnH,OAAO,qBAAqB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,8BAA8B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC;IACpI,CAAC,CAAC,CAAC;IACH,OAAO,+KAA+K,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;AACrN,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@zedtech/zedkit-seo",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "Generic SEO bricks: robots, sitemaps, typed JSON-LD, metadata, llms.txt, slugs.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zedtech-fr/zedkit",
+    "directory": "packages/seo"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "imports": {
+    "#*": "./src/*"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "schema-dts": "2.1.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "2.1.9"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.tests.json",
+    "lint": "eslint src tests"
+  }
 }