@fullstackdatasolutions/articles 1.2.3 → 1.3.1

package/dist/server.d.ts

@@ -15,6 +15,21 @@ interface HowToStep {
     name: string;
     text: string;
 }
+/**
+ * A real-world thing an article is about, emitted as schema.org `about`.
+ * `sameAs` should point at an authoritative identifier for the entity
+ * (Wikipedia, Wikidata, an official site) - that URL is what lets a consumer
+ * resolve "Pathfinder" the game system rather than guessing from the string.
+ */
+interface EntityReference {
+    name: string;
+    sameAs?: string;
+}
+/** An outbound source an article cites, emitted as schema.org `citation`. */
+interface CitationReference {
+    name: string;
+    url?: string;
+}
 interface Article {
     slug: string;
     title: string;
@@ -39,6 +54,18 @@ interface Article {
     toc?: TocItem[];
     faq?: FaqItem[];
     howTo?: HowToStep[];
+    /**
+     * A direct, self-contained answer to the article's core question, 40-60
+     * words. Rendered by `ArticleAnswer`, emitted as the Article schema's
+     * `abstract`, used as the `acceptedAnswer` when `articleType` is
+     * `'QAPage'`, and placed at the top of the article's markdown twin - the
+     * one passage most likely to be lifted verbatim by an answer engine.
+     */
+    answer?: string;
+    /** Entities this article is about. Emitted as schema.org `about`. */
+    about?: EntityReference[];
+    /** Outbound sources. Emitted as schema.org `citation`. */
+    citation?: CitationReference[];
     canonicalUrl?: string;
     articleType?: string;
     series?: string;
@@ -153,6 +180,13 @@ interface AuthorProfile {
     promise?: string;
     /** Structured long-form origin story - see `RichText`/`RichTextSection`. */
     originStory?: RichText;
+    /**
+     * Topics this author writes about, emitted as Person `knowsAbout`. Omit to
+     * derive it from the categories of their own published articles - unlike
+     * `credentials`/`proof`, subject matter is verifiable from the corpus
+     * itself, so it does belong in structured data.
+     */
+    knowsAbout?: string[];
     /** Who this author's content/work is for, e.g. "New game masters", "Streaming DMs". */
     servesWho?: string[];
     /** Core beliefs/approach statements. */
@@ -165,6 +199,27 @@ interface AuthorProfile {
     credentials?: string[];
     /** Concrete, sourceable proof points. */
     proof?: ProofItem[];
+    /**
+     * The one canonical URL identifying this person across every site they
+     * publish on. Used *only* to derive the Person `@id`, so the same author
+     * resolves to a single entity everywhere instead of one entity per site.
+     *
+     * Deliberately separate from `url`: that field also drives byline link
+     * targets, the author page's Open Graph URL, and its `CollectionPage` URL,
+     * so pointing it at another domain would send readers off-site and hand
+     * this site's author page a canonical belonging to a different one.
+     * `identityUrl` changes nothing a reader sees.
+     *
+     * Set the same value on every site. Falls back to `url`, then to this
+     * site's own author page.
+     */
+    identityUrl?: string;
+    /**
+     * Additional profile URLs identifying this same person elsewhere, merged
+     * into the Person schema's `sameAs` alongside the derived social links.
+     * List the author's pages on the other sites here.
+     */
+    sameAs?: string[];
     /** Primary call-to-action rendered on the author's page. */
     primaryCta?: {
         label: string;
@@ -346,6 +401,54 @@ interface BreadcrumbsConfig {
     /** Optional label overrides for built-in breadcrumb items. */
     labels?: BreadcrumbLabels;
 }
+/** Payload passed to `ArticlesConfig.onAiCrawl`. */
+interface AiCrawlEvent {
+    /** Article slug whose markdown twin was fetched. */
+    slug: string;
+    /** Matched crawler name (e.g. `'GPTBot'`), or `'unknown'` when the agent is not recognized. */
+    crawler: string;
+    /** Raw `User-Agent` header, or an empty string when absent. */
+    userAgent: string;
+}
+/**
+ * The publishing entity behind the site. Drives `OrganizationSchema`,
+ * `WebSiteSchema`, and the `publisher` reference on every article - so all
+ * three point at one `@id` instead of repeating an inline, unlinked
+ * `Organization` stub per page.
+ */
+interface OrganizationConfig {
+    /** schema.org type. Use `'Person'` for a personal brand. Default: `'Organization'`. */
+    type?: 'Organization' | 'Person';
+    /** Entity name. Falls back to `siteName`. */
+    name?: string;
+    /** Entity homepage. Falls back to `siteUrl`. */
+    url?: string;
+    /** Logo URL. Site-relative paths are resolved against `siteUrl`. */
+    logo?: string;
+    /** Entity description. Falls back to `ArticlesConfig.description`. */
+    description?: string;
+    /** Profile URLs that identify the same entity elsewhere (social, Crunchbase, Wikidata). */
+    sameAs?: string[];
+    /**
+     * The umbrella entity this site belongs to, for a network of sites run by
+     * one publisher. Emitted as `parentOrganization` - the link that lets
+     * authority earned by the network attach to each site in it, instead of
+     * each site standing alone.
+     */
+    parentOrganization?: {
+        name: string;
+        url: string;
+    };
+    /**
+     * Search URL template for the `WebSite` `SearchAction`, e.g.
+     * `'/search?q={search_term_string}'`. Omitted by default - the library's
+     * own search is client-side with no crawlable results URL, so declaring one
+     * that does not exist would be a false claim. Only set this if the app
+     * actually serves search results at that URL. Must contain the literal
+     * `{search_term_string}` placeholder.
+     */
+    searchUrlTemplate?: string;
+}
 /** Top-level configuration object. Pass one instance to every library component. */
 interface ArticlesConfig {
     /** Canonical base URL of the site, used in metadata and JSON-LD. Example: `'https://yoursite.com'` */
@@ -408,6 +511,94 @@ interface ArticlesConfig {
      * step rather than a build-time failure otherwise.
      */
     paths?: Record<string, PathDefinition>;
+    /**
+     * Template for the `<title>` tag on article, category, series, and author
+     * pages. Supports `{title}` and `{siteName}` placeholders.
+     * Default: `'{title} | {siteName}'`.
+     *
+     * Google truncates a result title around 60 characters, and a site name
+     * suffix spends that budget on every page. Set `'{title}'` to drop it when
+     * your titles are already long and your brand draws little search volume -
+     * the suffix is only earning its characters if people search for the brand.
+     */
+    titleTemplate?: string;
+    /**
+     * BCP 47 language tag for the site's content. Emitted as the Article
+     * schema's `inLanguage` and the RSS channel `<language>`. Default: `'en'`.
+     */
+    language?: string;
+    /**
+     * Set to `false` when articles sit behind a paywall or registration wall.
+     * Default: `true`, emitted as the Article schema's `isAccessibleForFree` -
+     * an explicit "this is readable" signal, since consumers that cannot tell
+     * tend to skip suspected-paywalled sources.
+     */
+    isAccessibleForFree?: boolean;
+    /**
+     * CSS selectors marking the parts of an article suitable for text-to-speech,
+     * emitted as the Article schema's `speakable`. Omitted by default - the
+     * correct selectors depend on the consuming app's own markup, and guessing
+     * them would point at elements that may not exist.
+     */
+    speakableSelectors?: string[];
+    /**
+     * Set to `true` to derive `FAQPage` entries from question-shaped `##`
+     * headings and the paragraph that follows each one. Default: `false` -
+     * turning prose into structured data without the author's intent can
+     * promote a rhetorical heading into a published Q&A pair, so this is
+     * opt-in. Explicit `faq` frontmatter always wins over derived entries.
+     */
+    deriveFaqFromHeadings?: boolean;
+    /**
+     * Shared entity vocabulary, keyed by an app-chosen slug. Article `about`
+     * entries may reference a key here instead of repeating a name/`sameAs`
+     * pair - the point of `about` is that a consumer can resolve one entity
+     * across a corpus, which free-text names spelled three different ways
+     * defeat. `validateArticles` warns on `about` keys with no registry entry.
+     */
+    entities?: Record<string, EntityReference>;
+    /**
+     * Where `lastmod` comes from when frontmatter omits it.
+     * - `'published'` (default): reuse the publish date, as before 1.3.0.
+     * - `'none'`: leave `lastmod` unset, so `dateModified` is omitted rather
+     *   than repeating a stale publish date.
+     * - `'fileMtime'`: read the article file's modification time. Accurate
+     *   locally; on a CI runner that clones fresh, every file's mtime is the
+     *   checkout time, which would report the whole corpus as updated today.
+     *   Only use it where the build preserves mtimes.
+     */
+    lastmodFallback?: 'published' | 'none' | 'fileMtime';
+    /**
+     * Called when an AI crawler fetches an article's markdown twin. The one
+     * choke point where those requests land, so it is the only place a site
+     * can measure whether any of its AI-readable content is being read, and
+     * by which bot. No PII: the payload carries the slug, the matched crawler
+     * name, and the raw user agent string only.
+     */
+    onAiCrawl?: (event: AiCrawlEvent) => void;
+    /**
+     * The publishing entity behind the site. Omit to keep the pre-1.3.0 inline
+     * `{'@type':'Organization', name: siteName}` publisher stub on articles.
+     * Set it to emit `OrganizationSchema`/`WebSiteSchema` in the root layout and
+     * have every article, author, and collection page reference the same `@id`.
+     */
+    organization?: OrganizationConfig;
+    /**
+     * Default `aiCrawl` value for articles whose frontmatter omits the key.
+     * Default: `false` (every article stays opted out unless it sets
+     * `aiCrawl: true`). Set to `true` on a site whose goal is being cited by
+     * answer engines to opt the whole corpus in at once; per-article
+     * `aiCrawl: false` still wins and keeps that article blocked.
+     */
+    aiCrawlDefault?: boolean;
+    /**
+     * Set to `false` to serve article markdown twins as the bare body, with no
+     * attribution header. Default: `true` - the twin is prefixed with the
+     * title, excerpt, canonical source URL, dates, author, and site name so a
+     * model reading `/articles/[slug].md` can attribute it. Only applies when
+     * a config is available (i.e. via `getArticleMarkdownResponse`).
+     */
+    markdownTwinHeader?: boolean;
     /**
      * Vendor-neutral event callback (Phase 27F). Fired by components/hooks at
      * meaningful reader-journey moments (see `ArticleEvent` in `events.ts`).
@@ -417,6 +608,18 @@ interface ArticlesConfig {
     onEvent?: ArticleEventHandler;
 }
 declare function getBreadcrumbsConfig(config: ArticlesConfig): BreadcrumbsConfig;
+/** Stable `@id` for the site's publishing entity. */
+declare function getOrganizationId(config: Pick<ArticlesConfig, 'siteUrl'>): string;
+/** Stable `@id` for the site itself. */
+declare function getWebSiteId(config: Pick<ArticlesConfig, 'siteUrl'>): string;
+/** Stable `@id` for an author, so every article by them resolves to one Person. */
+declare function getPersonId(authorUrl: string): string;
+/**
+ * Applies `ArticlesConfig.titleTemplate` to a page title. Kept here rather
+ * than inlined at each call site so article, category, series, and author
+ * pages can never drift apart on how the site name is appended.
+ */
+declare function formatPageTitle(title: string, config: Pick<ArticlesConfig, 'siteName' | 'titleTemplate'>): string;
 
 declare function sanitizeImagePath(rawPath: string, articleSlug: string): string | null;
 declare function getAvailableArticleSlugs(): string[];
@@ -429,11 +632,64 @@ declare function getAdjacentArticles(currentSlug: string): Promise<{
     previous: Article | null;
     next: Article | null;
 }>;
-declare function getArticleMarkdown(slug: string): Promise<string | null>;
-declare function getArticleMarkdownResponse(slug: string, config: ArticlesConfig): Promise<Response>;
+declare function getArticleMarkdown(slug: string, config?: ArticlesConfig): Promise<string | null>;
+/**
+ * Crawlers that read content on behalf of an answer engine. Used both to
+ * write robots.txt rules and to classify markdown-twin fetches for
+ * `ArticlesConfig.onAiCrawl` - one list, so the two can never disagree about
+ * what counts as an AI crawler.
+ */
+declare const AI_CRAWLERS: readonly ["GPTBot", "ChatGPT-User", "OAI-SearchBot", "CCBot", "ClaudeBot", "Claude-User", "Claude-SearchBot", "anthropic-ai", "PerplexityBot", "Perplexity-User", "Google-Extended", "Applebot-Extended", "Bytespider", "Amazonbot", "meta-externalagent", "cohere-ai", "DuckAssistBot", "MistralAI-User"];
+/** Matches a `User-Agent` against `AI_CRAWLERS`, returning the crawler name or `null`. */
+declare function matchAiCrawler(userAgent: string): string | null;
+/**
+ * Attribution header prepended to an article's markdown twin.
+ *
+ * The twin is what an AI crawler actually reads, and `matter()` strips every
+ * frontmatter field before it is served - so without this the model gets an
+ * anonymous body with no title, date, author, or link back to the canonical
+ * page. Skips its own `# {title}` line when the body already opens with the
+ * same H1, so the common "body repeats the title" layout doesn't end up with
+ * two.
+ */
+declare function buildMarkdownTwinHeader(article: Article, config: ArticlesConfig, body: string): string;
+/** Minimal shape of a request's headers - avoids depending on `next/server` here. */
+type RequestHeaders = Readonly<{
+    get(name: string): string | null;
+}>;
+/** Markdown twin for `/articles/category/[category]`. `null` when the category has no articles. */
+declare function getCategoryMarkdown(categorySlug: string, config: ArticlesConfig): Promise<string | null>;
+/**
+ * Markdown twin for `/articles/authors/[author]`.
+ *
+ * Carries the author's bio, promise, principles, and sourced proof alongside
+ * their article list - the "who is this and why trust them" context that
+ * otherwise exists only inside React components, and the exact question asked
+ * before anything they wrote gets cited. `credentials` are included as the
+ * author's own stated claims; unlike JSON-LD, prose can attribute a claim
+ * without asserting it as a verified fact.
+ */
+declare function getAuthorMarkdown(authorSlug: string, config: ArticlesConfig): Promise<string | null>;
+/** Markdown twin for `/articles/series/[series]`. `null` when the series has no articles. */
+declare function getSeriesMarkdown(seriesSlug: string, config: ArticlesConfig): Promise<string | null>;
+/**
+ * Serves the markdown twin for any `/articles/...` path - an article, or a
+ * category/author/series listing.
+ *
+ * Dispatching on the slug prefix here rather than adding three more app
+ * routes keeps the existing single rewrite (`/articles/:path*.md`) working
+ * unchanged: without it, `/articles/category/campaigns.md` matches that
+ * rewrite, reaches the article handler, and 404s.
+ */
+declare function getMarkdownTwinResponse(slug: string, config: ArticlesConfig, options?: Readonly<{
+    headers?: RequestHeaders;
+}>): Promise<Response>;
+declare function getArticleMarkdownResponse(slug: string, config: ArticlesConfig, options?: Readonly<{
+    headers?: RequestHeaders;
+}>): Promise<Response>;
 declare function getArticleMarkdownUrl(article: Pick<Article, 'slug' | 'aiCrawl'>, config?: Pick<ArticlesConfig, 'siteUrl'>): string | undefined;
 declare function getArticleAiHeaders(article: Pick<Article, 'slug' | 'aiCrawl'>, config?: Pick<ArticlesConfig, 'siteUrl'>): Record<string, string>;
-declare function getAiRobotsTxtRules(): Promise<string>;
+declare function getAiRobotsTxtRules(config?: ArticlesConfig): Promise<string>;
 declare function searchArticles(query: string, config?: ArticlesConfig): Promise<Article[]>;
 declare function categoryToSlug(category: string): string;
 declare function getAllCategories(): Promise<CategoryInfo[]>;
@@ -478,7 +734,39 @@ interface RelatedContentResult {
  */
 declare function getRelatedContent(article: Article, config: ArticlesConfig, limit?: number): Promise<RelatedContentResult>;
 
-declare function generateRssFeed(articles: Article[], config: ArticlesConfig): string;
+/**
+ * `options.fullContent` adds `<content:encoded>` with each article's rendered
+ * HTML, for feeds meant to be ingested rather than previewed - an
+ * excerpt-only feed gives a consumer nothing to work with. Off by default:
+ * it requires articles loaded with `htmlContent` (i.e. via
+ * `getArticleMetadata`, not `getAllArticles`' summaries), and articles
+ * without it are simply emitted without the element.
+ */
+declare function generateRssFeed(articles: Article[], config: ArticlesConfig, options?: Readonly<{
+    fullContent?: boolean;
+}>): string;
+/**
+ * `llms.txt` index - the emerging convention for pointing an LLM at a site's
+ * canonical, markdown-native content (https://llmstxt.org). Lists only
+ * articles opted in via `aiCrawl` (see `ArticlesConfig.aiCrawlDefault`),
+ * grouped by category, linking to each article's `.md` twin rather than its
+ * HTML page.
+ *
+ * Wire it up in the consuming app as `app/llms.txt/route.ts`:
+ *   export async function GET() {
+ *     return new Response(generateLlmsTxt(await getAllArticles(siteConfig), siteConfig), {
+ *       headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+ *     })
+ *   }
+ */
+declare function generateLlmsTxt(articles: Article[], config: ArticlesConfig): string;
+/**
+ * `llms-full.txt` - every opted-in article's full markdown twin, headers
+ * included, concatenated into one document. Larger and slower to build than
+ * `generateLlmsTxt`; generate it in a route handler or at build time, not on
+ * every request.
+ */
+declare function generateLlmsFullTxt(articles: Article[], config: ArticlesConfig): Promise<string>;
 declare function generateArticleStaticParams(): {
     slug: string;
 }[];
@@ -570,8 +858,17 @@ interface ContentSlotBoundaries {
 }
 declare function getContentSlotBoundaries(markdown: string): ContentSlotBoundaries | null;
 declare function extractToc(markdown: string): Promise<TocItem[]>;
+/**
+ * Derives `FaqItem`s from question-shaped `##` headings and the prose that
+ * follows each one, for `ArticlesConfig.deriveFaqFromHeadings`.
+ *
+ * Line-based on purpose: it runs for every article at summary time, and the
+ * shapes it must reject (fenced code, a heading with no prose under it) are
+ * cheaper to detect by scanning than by walking a parsed AST.
+ */
+declare function deriveFaqFromHeadings(markdown: string): FaqItem[];
 
-type ArticlesErrorCode = 'article-directory-read-failed' | 'article-load-failed' | 'article-markdown-load-failed' | 'markdown-conversion-failed' | 'unsafe-image-path';
+type ArticlesErrorCode = 'article-directory-read-failed' | 'article-load-failed' | 'article-markdown-load-failed' | 'ai-crawl-handler-failed' | 'markdown-conversion-failed' | 'unsafe-image-path';
 type ArticlesErrorContext = Readonly<Record<string, string | number | boolean | undefined>>;
 type ArticlesErrorReport = Readonly<{
     code: ArticlesErrorCode;
@@ -620,6 +917,22 @@ type ArticleTOCProps = Readonly<{
 }>;
 declare function ArticleTOC({ toc, className }: ArticleTOCProps): react_jsx_runtime.JSX.Element | null;
 
+type ArticleAnswerProps = Readonly<{
+    article: Pick<Article, 'answer'>;
+    /** Heading shown above the answer. Default: `'The short answer'`. */
+    label?: string;
+    className?: string;
+}>;
+/**
+ * Renders `article.answer` as a callout above the article body.
+ *
+ * The same text is emitted as the Article schema's `abstract` and placed at
+ * the top of the article's markdown twin, so the passage an answer engine is
+ * most likely to lift is also the one a reader sees first. Returns `null`
+ * when the article has no `answer`, so it is safe to render unconditionally.
+ */
+declare function ArticleAnswer({ article, label, className, }: ArticleAnswerProps): react_jsx_runtime.JSX.Element | null;
+
 type ValidationSeverity = 'error' | 'warning';
 interface ValidationIssue {
     severity: ValidationSeverity;
@@ -636,13 +949,21 @@ interface ValidationResult {
 }
 /**
  * Validates a loaded article set + config. Warnings cover optional
- * discovery-field issues (missing excerpt/date, over-length search/social
- * fields, category slug collisions); errors cover broken reader journeys
- * (duplicate canonical URLs, unknown author references, series order
- * collisions, missing/draft path references, unsafe URL schemes).
+ * discovery-field issues (missing excerpt/date, over-length rendered title
+ * and meta description, over-length social fields, category slug collisions) and answer-engine readiness
+ * (`no-answer`, `thin-content`, `missing-about`, `unknown-entity`,
+ * `stale-content`, `orphan-article`); errors cover broken reader journeys (duplicate canonical
+ * URLs, unknown author references, series order collisions, missing/draft
+ * path references, unsafe URL schemes).
+ *
+ * `options.now` overrides the clock used by the `stale-content` check.
  */
-declare function validateArticles(articles: Article[], config: ArticlesConfig): ValidationResult;
+declare function validateArticles(articles: Article[], config: ArticlesConfig, options?: Readonly<{
+    now?: Date;
+}>): ValidationResult;
 /** Convenience wrapper: loads every article via `getAllArticles(config)` (fs-dependent) then validates. Suitable for a consuming app's own `scripts/validate-articles.ts` invoked in CI before publish. */
-declare function validateAllArticles(config: ArticlesConfig): Promise<ValidationResult>;
+declare function validateAllArticles(config: ArticlesConfig, options?: Readonly<{
+    now?: Date;
+}>): Promise<ValidationResult>;
 
-export { type Article, ArticleContent, type ArticleEvent, type ArticleEventHandler, type ArticleEventName, type ArticleSlotContent, type ArticleSlotContext, ArticleTOC, type ArticleViewedEvent, type ArticlesConfig, type ArticlesErrorCode, type ArticlesErrorContext, type ArticlesErrorHandler, type ArticlesErrorReport, type AuthorClickedEvent, type AuthorProfile, type AuthorSocial, type BreadcrumbItem, type CategoryInfo, type ContentSlotBoundaries, type CtaClickedEvent, type CtaViewedEvent, type LinkTargetStrategy, type ListingPagination, type ListingPaginationContext, type MeaningfulReadEvent, type PaginatedArticles, type PaginationLinks, type PathDefinition, type PathStepAdvancedEvent, type RelatedArticleClickedEvent, type RelatedContentResult, type RelatedContentSource, type SharedEvent, type TocItem, type ValidationIssue, type ValidationResult, type ValidationSeverity, buildArticleBreadcrumbs, buildAuthorBreadcrumbs, buildCategoryBreadcrumbs, buildPageUrl, buildPaginationLinks, categoryToSlug, emitArticleEvent, extractToc, generateArticleMetadata, generateArticleStaticParams, generateArticlesIndexMetadata, generateArticlesIndexPageMetadata, generateAuthorMetadata, generateAuthorPageMetadata, generateAuthorStaticParams, generateCategoryMetadata, generateCategoryPageMetadata, generateCategoryStaticParams, generateListingPageStaticParams, generateRssFeed, generateSeriesMetadata, generateSeriesStaticParams, getAdjacentArticles, getAdjacentArticlesInSeries, getAiRobotsTxtRules, getAllArticles, getAllAuthors, getAllCategories, getArticleAiHeaders, getArticleAuthors, getArticleMarkdown, getArticleMarkdownResponse, getArticleMarkdownUrl, getArticleMetadata, getArticleSitemapEntries, getArticlesByAuthor, getArticlesByCategory, getArticlesBySeries, getAuthorBySlug, getAvailableArticleSlugs, getBreadcrumbsConfig, getContentSlotBoundaries, getPath, getPathArticles, getRelatedArticlesByCategory, getRelatedContent, getTotalPages, isPageOutOfRange, markdownToHtml, paginateArticles, parsePageParam, resolveAuthorAvatar, resolveSearchMetadata, resolveSocialMetadata, sanitizeImagePath, searchArticles, setArticlesErrorHandler, validateAllArticles, validateArticles };
+export { AI_CRAWLERS, type AiCrawlEvent, type Article, ArticleAnswer, ArticleContent, type ArticleEvent, type ArticleEventHandler, type ArticleEventName, type ArticleSlotContent, type ArticleSlotContext, ArticleTOC, type ArticleViewedEvent, type ArticlesConfig, type ArticlesErrorCode, type ArticlesErrorContext, type ArticlesErrorHandler, type ArticlesErrorReport, type AuthorClickedEvent, type AuthorProfile, type AuthorSocial, type BreadcrumbItem, type CategoryInfo, type CitationReference, type ContentSlotBoundaries, type CtaClickedEvent, type CtaViewedEvent, type EntityReference, type FaqItem, type HowToStep, type LinkTargetStrategy, type ListingPagination, type ListingPaginationContext, type MeaningfulReadEvent, type OrganizationConfig, type PaginatedArticles, type PaginationLinks, type PathDefinition, type PathStepAdvancedEvent, type RelatedArticleClickedEvent, type RelatedContentResult, type RelatedContentSource, type RequestHeaders, type SharedEvent, type TocItem, type ValidationIssue, type ValidationResult, type ValidationSeverity, buildArticleBreadcrumbs, buildAuthorBreadcrumbs, buildCategoryBreadcrumbs, buildMarkdownTwinHeader, buildPageUrl, buildPaginationLinks, categoryToSlug, deriveFaqFromHeadings, emitArticleEvent, extractToc, formatPageTitle, generateArticleMetadata, generateArticleStaticParams, generateArticlesIndexMetadata, generateArticlesIndexPageMetadata, generateAuthorMetadata, generateAuthorPageMetadata, generateAuthorStaticParams, generateCategoryMetadata, generateCategoryPageMetadata, generateCategoryStaticParams, generateListingPageStaticParams, generateLlmsFullTxt, generateLlmsTxt, generateRssFeed, generateSeriesMetadata, generateSeriesStaticParams, getAdjacentArticles, getAdjacentArticlesInSeries, getAiRobotsTxtRules, getAllArticles, getAllAuthors, getAllCategories, getArticleAiHeaders, getArticleAuthors, getArticleMarkdown, getArticleMarkdownResponse, getArticleMarkdownUrl, getArticleMetadata, getArticleSitemapEntries, getArticlesByAuthor, getArticlesByCategory, getArticlesBySeries, getAuthorBySlug, getAuthorMarkdown, getAvailableArticleSlugs, getBreadcrumbsConfig, getCategoryMarkdown, getContentSlotBoundaries, getMarkdownTwinResponse, getOrganizationId, getPath, getPathArticles, getPersonId, getRelatedArticlesByCategory, getRelatedContent, getSeriesMarkdown, getTotalPages, getWebSiteId, isPageOutOfRange, markdownToHtml, matchAiCrawler, paginateArticles, parsePageParam, resolveAuthorAvatar, resolveSearchMetadata, resolveSocialMetadata, sanitizeImagePath, searchArticles, setArticlesErrorHandler, validateAllArticles, validateArticles };