@prenta/core 0.118.0

package/dist/seo/llms-select.js

@@ -0,0 +1,67 @@
+/**
+ * Shared selection + mapping for the llms.txt family of routes (`/llms.txt`,
+ * `/llms-full.txt`). Keeping this in one place means the curation rules and the
+ * privacy boundary (noindex exclusion) can never drift between the two surfaces.
+ */
+import { resolveDocumentUrl } from './page-meta.js';
+/** Tri-state per-doc include flag; defaults to AUTO for unrecognized values. */
+export function readLlmsInclude(data) {
+    const v = String(data?.llmsInclude ?? '').toUpperCase();
+    return v === 'ALWAYS' || v === 'NEVER' ? v : 'AUTO';
+}
+/** A doc is excluded from every llms surface when it is noindexed. */
+export function isLlmsNoindex(data) {
+    const d = data;
+    return d?.noindex === true || d?.robotsNoindex === true || d?.noindex === 'true';
+}
+/**
+ * Apply the curation + privacy rules:
+ *   - internal/system collections excluded
+ *   - noindexed docs excluded (privacy boundary)
+ *   - `llmsInclude` NEVER excluded, ALWAYS included (overrides eligibility),
+ *     AUTO included only when the collection is eligible
+ */
+export function selectLlmsDocs(docs, opts) {
+    return docs
+        .filter((d) => !opts.isInternalCollection(d.collection))
+        .filter((d) => {
+        const data = d.data || {};
+        if (isLlmsNoindex(data))
+            return false;
+        const include = readLlmsInclude(data);
+        if (include === 'NEVER')
+            return false;
+        if (include === 'ALWAYS')
+            return true;
+        return opts.eligible ? opts.eligible.has(d.collection) : true;
+    });
+}
+/** Map a selected document to the generator's page shape (curation-aware). */
+export function toLlmsPage(d, opts) {
+    const data = d.data || {};
+    const section = typeof data.llmsSection === 'string' && data.llmsSection.trim()
+        ? data.llmsSection.trim()
+        : undefined;
+    const str = (v) => typeof v === 'string' && v.trim() ? v : undefined;
+    return {
+        title: str(data.metaTitle) ?? d.title ?? str(data.title) ?? 'Untitled',
+        url: resolveDocumentUrl({
+            siteUrl: opts.base,
+            urlPrefix: opts.urlPrefix,
+            slug: d.slug ?? undefined,
+            data,
+        }),
+        description: str(data.llmsDescription) ??
+            str(data.keyTakeaway) ??
+            str(data.metaDescription) ??
+            str(data.seoDescription) ??
+            '',
+        collection: d.collection,
+        section,
+        optional: data.llmsOptional === true,
+        priority: typeof data.llmsPriority === 'number' ? data.llmsPriority : undefined,
+        updatedAt: d.updatedAt?.toISOString(),
+        isCornerstone: data.isCornerstone === true,
+    };
+}
+//# sourceMappingURL=llms-select.js.map

package/dist/seo/llms-select.js.map

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

package/dist/seo/llms-txt.d.ts

@@ -0,0 +1,40 @@
+export interface LlmsTxtConfig {
+    siteName: string;
+    siteUrl: string;
+    /** The reviewed one-to-three sentence blockquote summary. */
+    siteDescription?: string;
+    /** Optional free-text context block (no headings) emitted after the summary. */
+    intro?: string;
+    /** Overall cap across all sections (default 50). */
+    maxPages?: number;
+    /** Cap per section/collection (default 25) so one large group can't flood. */
+    maxPerSection?: number;
+}
+/**
+ * Coerce CMS-authored text into a safe single-line list-item fragment.
+ *
+ * These strings flow from editor fields into a file that AI agents read, so we
+ * defend against two things: (1) markdown-breaking characters that would corrupt
+ * the `- [title](url): desc` syntax, and (2) multi-line / control-character
+ * content that a careless or hostile editor could use to smuggle instruction-like
+ * text. This is not a complete prompt-injection defense (no text filter is) — it
+ * forces single-line, length-capped, link-safe plain text, which removes the
+ * most common corruption and obfuscation vectors.
+ */
+export declare function sanitizeLlmsText(raw: string | null | undefined, maxLen: number): string;
+export interface LlmsTxtPage {
+    title: string;
+    url: string;
+    description?: string;
+    collection?: string;
+    /** Explicit section/grouping override; falls back to `collection`. */
+    section?: string;
+    /** Routes the entry into the reserved `## Optional` section. */
+    optional?: boolean;
+    /** Sort order within a section — higher first. Defaults to 0. */
+    priority?: number;
+    updatedAt?: string;
+    isCornerstone?: boolean;
+}
+export declare function generateLlmsTxt(config: LlmsTxtConfig, pages: LlmsTxtPage[]): string;
+//# sourceMappingURL=llms-txt.d.ts.map

package/dist/seo/llms-txt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms-txt.d.ts","sourceRoot":"","sources":["../../src/seo/llms-txt.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBvF;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CA4DnF"}

package/dist/seo/llms-txt.js

@@ -0,0 +1,177 @@
+const DESCRIPTION_MAX = 200;
+const TITLE_MAX = 160;
+/**
+ * Coerce CMS-authored text into a safe single-line list-item fragment.
+ *
+ * These strings flow from editor fields into a file that AI agents read, so we
+ * defend against two things: (1) markdown-breaking characters that would corrupt
+ * the `- [title](url): desc` syntax, and (2) multi-line / control-character
+ * content that a careless or hostile editor could use to smuggle instruction-like
+ * text. This is not a complete prompt-injection defense (no text filter is) — it
+ * forces single-line, length-capped, link-safe plain text, which removes the
+ * most common corruption and obfuscation vectors.
+ */
+export function sanitizeLlmsText(raw, maxLen) {
+    if (!raw)
+        return '';
+    let s = raw
+        // Strip control characters (incl. newlines, tabs, zero-width) → space.
+        .replace(/[\u0000-\u001F\u007F\u200B-\u200D\uFEFF]/g, ' ')
+        // Remove characters that break markdown link syntax in the list item.
+        .replace(/[[\]()]/g, '')
+        // Collapse any remaining whitespace runs.
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (s.length > maxLen)
+        s =
+            s
+                .slice(0, maxLen)
+                .replace(/\s+\S*$/, '')
+                .trim() || s.slice(0, maxLen);
+    return s;
+}
+export function generateLlmsTxt(config, pages) {
+    const maxPages = config.maxPages ?? 50;
+    const maxPerSection = config.maxPerSection ?? 25;
+    const lines = [];
+    lines.push(`# ${sanitizeLlmsText(config.siteName, TITLE_MAX) || 'Site'}`);
+    lines.push('');
+    const summary = sanitizeLlmsText(config.siteDescription, DESCRIPTION_MAX);
+    if (summary) {
+        lines.push(`> ${summary}`);
+        lines.push('');
+    }
+    // Free-text context block. It is a reviewed config field (not editor-freeform),
+    // so multi-line markdown is allowed; we only trim and drop accidental headings
+    // (which would corrupt the section structure the spec relies on).
+    const intro = (config.intro ?? '')
+        .split(/\r?\n/)
+        .filter((l) => !/^\s{0,3}#/.test(l))
+        .join('\n')
+        .trim();
+    if (intro) {
+        lines.push(intro);
+        lines.push('');
+    }
+    const sorted = [...pages].sort(comparePages);
+    const mainPages = sorted.filter((p) => !p.optional);
+    const optionalPages = sorted.filter((p) => p.optional);
+    // Cap each section BEFORE applying the global budget, then take round-robin
+    // across sections. Slicing globally first lets one actively-edited collection
+    // (sorted to the top by `updatedAt`) consume the entire `maxPages` window and
+    // starve every other section; per-section fairness first guarantees smaller /
+    // cornerstone sections are represented within the budget.
+    const cappedSections = new Map();
+    for (const [section, group] of groupBySection(mainPages)) {
+        cappedSections.set(section, group.slice(0, maxPerSection));
+    }
+    const selectedSections = takeWithinBudget(cappedSections, maxPages);
+    for (const [section, group] of selectedSections) {
+        emitSection(lines, formatHeading(section), group, maxPerSection);
+    }
+    // The reserved `## Optional` section tells context-limited agents what to skip
+    // first. Optional entries are flat (not sub-grouped) per common convention and
+    // kept outside the main budget so they never displace primary content.
+    if (optionalPages.length > 0) {
+        emitSection(lines, 'Optional', optionalPages, maxPerSection);
+    }
+    lines.push('## Resources');
+    lines.push('');
+    lines.push(`- [Sitemap](${config.siteUrl}/sitemap.xml)`);
+    lines.push(`- [API Documentation](${config.siteUrl}/api/cms/docs)`);
+    lines.push('');
+    return lines.join('\n');
+}
+/** Cornerstone first, then higher `priority`, then most-recently updated. */
+function comparePages(a, b) {
+    if (a.isCornerstone !== b.isCornerstone)
+        return a.isCornerstone ? -1 : 1;
+    const pa = a.priority ?? 0;
+    const pb = b.priority ?? 0;
+    if (pa !== pb)
+        return pb - pa;
+    if (a.updatedAt && b.updatedAt)
+        return b.updatedAt.localeCompare(a.updatedAt);
+    if (a.updatedAt)
+        return -1;
+    if (b.updatedAt)
+        return 1;
+    return 0;
+}
+/**
+ * Take entries round-robin across sections up to a global budget, so every
+ * section is represented within `maxPages` instead of the first (most-recently
+ * edited) section consuming the whole window. Preserves each section's internal
+ * order and the first-seen section order.
+ */
+function takeWithinBudget(sections, maxPages) {
+    const result = new Map();
+    if (maxPages <= 0)
+        return result;
+    const cursors = new Map();
+    for (const key of sections.keys())
+        cursors.set(key, 0);
+    let taken = 0;
+    let progressed = true;
+    while (taken < maxPages && progressed) {
+        progressed = false;
+        for (const [key, group] of sections) {
+            if (taken >= maxPages)
+                break;
+            const idx = cursors.get(key) ?? 0;
+            if (idx >= group.length)
+                continue;
+            let bucket = result.get(key);
+            if (!bucket) {
+                bucket = [];
+                result.set(key, bucket);
+            }
+            bucket.push(group[idx]);
+            cursors.set(key, idx + 1);
+            taken++;
+            progressed = true;
+        }
+    }
+    return result;
+}
+/** Group entries by their resolved section, preserving first-seen order. */
+function groupBySection(pages) {
+    const groups = new Map();
+    for (const page of pages) {
+        const key = page.section ?? page.collection ?? 'Important Pages';
+        let group = groups.get(key);
+        if (!group) {
+            group = [];
+            groups.set(key, group);
+        }
+        group.push(page);
+    }
+    return groups;
+}
+function emitSection(lines, heading, group, maxPerSection) {
+    lines.push(`## ${heading}`);
+    lines.push('');
+    // Cap per section so a single large collection can't crowd out the rest.
+    for (const page of group.slice(0, maxPerSection)) {
+        const title = sanitizeLlmsText(page.title, TITLE_MAX) || 'Untitled';
+        const description = sanitizeLlmsText(page.description, DESCRIPTION_MAX);
+        // Append a freshness marker so AI answer engines can prefer recent content.
+        // `updatedAt` is an ISO string; emit the date portion only.
+        const updated = page.updatedAt ? formatLlmsDate(page.updatedAt) : undefined;
+        const suffix = [description, updated ? `Updated: ${updated}` : undefined]
+            .filter(Boolean)
+            .join(' — ');
+        const entry = suffix ? `- [${title}](${page.url}): ${suffix}` : `- [${title}](${page.url})`;
+        lines.push(entry);
+    }
+    lines.push('');
+}
+function formatHeading(collection) {
+    return collection.replace(/[-_]/g, ' ').replace(/\b\w/g, (ch) => ch.toUpperCase());
+}
+/** Reduce an ISO timestamp to a `YYYY-MM-DD` date, or `undefined` if unparseable. */
+function formatLlmsDate(iso) {
+    const d = new Date(iso);
+    return isNaN(d.getTime()) ? undefined : d.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=llms-txt.js.map

package/dist/seo/llms-txt.js.map

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

package/dist/seo/meta-tags.d.ts

@@ -0,0 +1,108 @@
+export interface MetaTagInput {
+    title: string;
+    description?: string;
+    url: string;
+    siteName: string;
+    /**
+     * Primary Open Graph locale. Accepts either OG form (`en_US`) or a BCP-47 tag
+     * (`en-US` / `en`); it is normalized to OG `language_TERRITORY` before render.
+     */
+    locale?: string;
+    /**
+     * Other configured locales, emitted as `og:locale:alternate`. Accepts the same
+     * forms as {@link MetaTagInput.locale} and is normalized identically.
+     */
+    localeAlternates?: string[];
+    type?: 'website' | 'article' | 'profile';
+    /** Given name for `og:type=profile` (`profile:first_name`). */
+    profileFirstName?: string;
+    /** Family name for `og:type=profile` (`profile:last_name`). */
+    profileLastName?: string;
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImage?: {
+        url: string;
+        width?: number;
+        height?: number;
+        alt?: string;
+    };
+    twitterTitle?: string;
+    twitterDescription?: string;
+    twitterImage?: string;
+    /** Alt text for the Twitter card image (`twitter:image:alt`). */
+    twitterImageAlt?: string;
+    twitterCard?: 'summary' | 'summary_large_image';
+    twitterSite?: string;
+    publishedTime?: string;
+    modifiedTime?: string;
+    author?: string;
+    section?: string;
+    tags?: string[];
+    noIndex?: boolean;
+    noFollow?: boolean;
+    canonical?: string;
+    /**
+     * Absolute site origin used as the Next.js `metadataBase`, so relative OG /
+     * canonical URLs resolve to absolute ones in the rendered tags.
+     */
+    metadataBase?: string;
+    /**
+     * hreflang alternates for this document's translations. Rendered as
+     * `<link rel="alternate" hreflang>` and as `alternates.languages` in the
+     * Next.js metadata object.
+     */
+    alternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
+    /** Absolute URL of the previous page in a paginated series (`<link rel="prev">`). */
+    prev?: string;
+    /** Absolute URL of the next page in a paginated series (`<link rel="next">`). */
+    next?: string;
+}
+/**
+ * Normalize a locale to Open Graph `language_TERRITORY` form. Accepts OG form
+ * (`en_US`), a BCP-47 tag (`en-US`), or a bare language (`en`). Returns
+ * undefined for empty input.
+ */
+export declare function normalizeOgLocale(locale: string | undefined | null): string | undefined;
+export declare function generateMetaTags(input: MetaTagInput): Record<string, string>;
+export declare function renderMetaTagsHtml(input: MetaTagInput): string;
+export interface SeoVerificationTokens {
+    googleSearchConsole?: string;
+    bingWebmasterTools?: string;
+    yandex?: string;
+    pinterest?: string;
+    facebookDomain?: string;
+    customMetaTags?: Array<{
+        id?: string;
+        name?: string;
+        property?: string;
+        content?: string;
+    }>;
+}
+export interface VerificationMetaEntry {
+    name?: string;
+    property?: string;
+    content: string;
+}
+/**
+ * Build the flat list of verification `<meta>` entries from the configured
+ * tokens. Empty values are skipped. Custom tags require a `content` plus at
+ * least one of `name`/`property`.
+ */
+export declare function buildVerificationMetaEntries(tokens: SeoVerificationTokens | undefined | null): VerificationMetaEntry[];
+/** Render verification entries as escaped `<meta>` HTML lines. */
+export declare function renderVerificationMetaHtml(tokens: SeoVerificationTokens | undefined | null): string;
+/**
+ * Build the Next.js `metadata.verification` object. Google + Yandex map to
+ * first-class keys; everything else (Bing, Pinterest, Facebook, custom
+ * name-based tags) goes under `other`. Returns undefined when nothing is set.
+ */
+export declare function buildNextVerification(tokens: SeoVerificationTokens | undefined | null): {
+    google?: string;
+    yandex?: string;
+    other?: Record<string, string>;
+} | undefined;
+export declare function generateNextMetadata(input: MetaTagInput): object;
+//# sourceMappingURL=meta-tags.d.ts.map

package/dist/seo/meta-tags.d.ts.map

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