@pas7/llm-seo 0.1.6

package/dist/core/index.d.ts

@@ -0,0 +1,752 @@
+import { M as ManifestItem, S as SiteManifest } from '../manifest.schema-B_z3rxRV.js';
+import { L as LlmsSeoConfig } from '../config.schema-DCnBx3Gm.js';
+import 'zod';
+
+/**
+ * URL normalization utilities for deterministic SEO processing.
+ */
+/**
+ * Options for URL normalization.
+ */
+interface NormalizeUrlOptions {
+    /** Base URL e.g., "https://example.com" */
+    baseUrl: string;
+    /** Path e.g., "/blog/my-post" */
+    path: string;
+    /** Trailing slash policy */
+    trailingSlash: 'always' | 'never' | 'preserve';
+    /** Strip query string (default: true) */
+    stripQuery?: boolean;
+    /** Strip hash/fragment (default: true) */
+    stripHash?: boolean;
+}
+/**
+ * Normalizes URL according to policy:
+ * - No // in path (collapse to single /)
+ * - Strip query and hash by default
+ * - Apply trailing slash policy
+ * - Lowercase hostname
+ * - Remove default ports (80, 443)
+ * @param options - Normalization options
+ * @returns The normalized URL string
+ */
+declare function normalizeUrl(options: NormalizeUrlOptions): string;
+/**
+ * Sorts URLs deterministically for consistent output ordering.
+ * @param urls - Array of URLs to sort
+ * @returns Sorted array of URLs
+ */
+declare function sortUrls(urls: readonly string[]): string[];
+
+/**
+ * Deterministic sorting utilities for SEO artifacts.
+ */
+/**
+ * Comparator function type for sorting operations.
+ */
+type Comparator<T> = (a: T, b: T) => number;
+/**
+ * Creates a deterministic string comparator for consistent ordering.
+ * Uses localeCompare with specific locale for reproducibility.
+ * @param a - First string to compare
+ * @param b - Second string to compare
+ * @returns Negative if a < b, positive if a > b, zero if equal
+ */
+declare function compareStrings(a: string, b: string): number;
+/**
+ * Sorts an array of strings deterministically.
+ * @param items - Array of strings to sort
+ * @returns New sorted array
+ */
+declare function sortStrings(items: readonly string[]): string[];
+/**
+ * Sorts an array of objects by a string key deterministically.
+ * @param items - Array of objects to sort
+ * @param keyFn - Function to extract the comparison key
+ * @returns New sorted array
+ */
+declare function sortBy<T>(items: readonly T[], keyFn: (item: T) => string): T[];
+
+/**
+ * Text normalization utilities for deterministic SEO processing.
+ */
+/**
+ * Normalizes whitespace in text by collapsing multiple spaces and trimming.
+ * @param text - The text to normalize
+ * @returns Normalized text with single spaces
+ */
+declare function normalizeWhitespace(text: string): string;
+/**
+ * Normalizes line endings to the specified format.
+ * @param text - The text to normalize
+ * @param lineEndings - Target line endings format ('lf' or 'crlf')
+ * @returns Text with normalized line endings
+ */
+declare function normalizeLineEndings(text: string, lineEndings: 'lf' | 'crlf'): string;
+/**
+ * Normalizes whitespace in lines - trims trailing whitespace and removes multiple consecutive spaces.
+ * @param text - The text to normalize
+ * @returns Text with normalized line whitespace
+ */
+declare function normalizeLineWhitespace(text: string): string;
+/**
+ * Normalizes text for use in SEO meta descriptions or titles.
+ * Collapses whitespace and truncates to a maximum length.
+ * @param text - The text to normalize
+ * @param maxLength - Maximum allowed length
+ * @returns Normalized text
+ */
+declare function normalizeSeoText(text: string, maxLength: number): string;
+
+/**
+ * Canonical URL generation from site manifests.
+ */
+
+/**
+ * Options for canonical URL generation.
+ */
+interface CanonicalOptions {
+    /** Whether to include trailing slash (default: false) */
+    trailingSlash?: boolean;
+    /** Whether to use lowercase (default: true) */
+    lowercase?: boolean;
+}
+/**
+ * Locale strategy for URL generation.
+ */
+type LocaleStrategy = 'prefix' | 'subdomain' | 'none';
+/**
+ * Trailing slash policy.
+ */
+type TrailingSlashPolicy = 'always' | 'never' | 'preserve';
+/**
+ * Options for creating canonical URLs from manifest.
+ */
+interface CreateCanonicalUrlsOptions {
+    /** Array of manifest items */
+    items: ManifestItem[];
+    /** Base URL e.g., "https://example.com" */
+    baseUrl: string;
+    /** Route prefix e.g., "/blog" for blog posts */
+    routePrefix?: string;
+    /** Default locale code */
+    defaultLocale: string;
+    /** Trailing slash policy */
+    trailingSlash: TrailingSlashPolicy;
+    /** Locale URL strategy */
+    localeStrategy: LocaleStrategy;
+}
+/**
+ * Generates a canonical URL for a given path from the site manifest.
+ * @param manifest - The site manifest containing base URL information
+ * @param path - The path to generate canonical URL for
+ * @param options - Canonical URL options
+ * @returns The canonical URL
+ */
+declare function generateCanonicalUrl(manifest: SiteManifest, path: string, options?: CanonicalOptions): string;
+/**
+ * Extracts all canonical URLs from a site manifest.
+ * @param manifest - The site manifest
+ * @param options - Canonical URL options
+ * @returns Array of canonical URLs
+ */
+declare function extractCanonicalUrls(manifest: SiteManifest, options?: CanonicalOptions): string[];
+/**
+ * Deduplicates URLs by converting to Set and back.
+ * @param urls - Array of URLs to deduplicate
+ * @returns Array of unique URLs
+ */
+declare function dedupeUrls(urls: string[]): string[];
+/**
+ * Creates a single canonical URL for a manifest item.
+ * @param item - The manifest item
+ * @param options - Options for URL creation (without items array)
+ * @returns The canonical URL string
+ */
+declare function createCanonicalUrlForItem(item: ManifestItem, options: Omit<CreateCanonicalUrlsOptions, 'items'>): string;
+/**
+ * Creates canonical URLs from manifest items:
+ * 1. For each item, select canonical locale
+ * 2. Build URL: baseUrl + localePrefix (if strategy=prefix) + routePrefix + slug
+ * 3. Apply trailing slash policy
+ * 4. Normalize URL
+ * 5. Dedupe (by URL string)
+ * 6. Sort stably
+ * @param options - Options for URL creation
+ * @returns Sorted array of canonical URLs
+ */
+declare function createCanonicalUrlsFromManifest(options: CreateCanonicalUrlsOptions): string[];
+
+/**
+ * Locale handling utilities for canonical URL generation.
+ */
+
+/**
+ * Represents a locale configuration for a site.
+ */
+interface LocaleConfig {
+    /** Default locale code (e.g., 'en') */
+    default: string;
+    /** Supported locale codes */
+    supported: readonly string[];
+    /** URL strategy for locales */
+    strategy: 'subdirectory' | 'subdomain' | 'domain';
+}
+/**
+ * Generates locale-prefixed path.
+ * @param path - The base path
+ * @param locale - The locale code
+ * @param config - Locale configuration
+ * @returns Path with locale prefix if applicable
+ */
+declare function localizePath(path: string, locale: string, config: LocaleConfig): string;
+/**
+ * Extracts locale from a path.
+ * @param path - The path to extract locale from
+ * @param config - Locale configuration
+ * @returns Tuple of [locale, pathWithoutLocale]
+ */
+declare function extractLocaleFromPath(path: string, config: LocaleConfig): readonly [string, string];
+/**
+ * Generates alternate locale URLs for a page.
+ * @param baseUrl - Base URL of the site
+ * @param path - Page path
+ * @param config - Locale configuration
+ * @returns Map of locale to full URL
+ */
+declare function generateAlternateUrls(baseUrl: string, path: string, config: LocaleConfig): Map<string, string>;
+
+/**
+ * llms.txt generator for LLM-optimized site documentation.
+ * Generates a short brand profile with sections, URLs, policies, and contact info.
+ */
+
+/**
+ * Options for llms.txt generation.
+ */
+interface CreateLlmsTxtOptions {
+    /** Full LLM SEO configuration */
+    config: LlmsSeoConfig;
+    /** Pre-built canonical URLs from manifests */
+    canonicalUrls: string[];
+}
+/**
+ * Result of llms.txt generation.
+ */
+interface CreateLlmsTxtResult {
+    /** Generated llms.txt content */
+    content: string;
+    /** Size in bytes */
+    byteSize: number;
+    /** Number of lines */
+    lineCount: number;
+}
+/**
+ * Creates llms.txt content with deterministic output.
+ * - Deterministic ordering of all sections
+ * - Handles missing optional fields gracefully
+ * - EOL controlled by config.format.lineEndings
+ * @param options - Generation options
+ * @returns Generated content with metadata
+ */
+declare function createLlmsTxt(options: CreateLlmsTxtOptions): CreateLlmsTxtResult;
+interface LlmsTxtOptions {
+    /** Whether to include optional sections */
+    includeOptionalSections?: boolean;
+}
+/**
+ * @deprecated Use createLlmsTxt instead
+ */
+declare function generateLlmsTxt(manifest: {
+    baseUrl: string;
+    title: string;
+    description?: string | undefined;
+    pages: Array<{
+        path: string;
+        title?: string | undefined;
+        description?: string | undefined;
+    }>;
+}, _options?: LlmsTxtOptions): string;
+
+/**
+ * llms-full.txt generator with complete context for LLMs.
+ * Generates full brand context with all URLs, detailed policies, social/booking, and machine hints.
+ */
+
+/**
+ * Options for llms-full.txt generation.
+ */
+interface CreateLlmsFullTxtOptions {
+    /** Full LLM SEO configuration */
+    config: LlmsSeoConfig;
+    /** Pre-built canonical URLs from manifests */
+    canonicalUrls: string[];
+    /** Manifest items for detailed URL listing */
+    manifestItems: ManifestItem[];
+}
+/**
+ * Result of llms-full.txt generation.
+ */
+interface CreateLlmsFullTxtResult {
+    /** Generated llms-full.txt content */
+    content: string;
+    /** Size in bytes */
+    byteSize: number;
+    /** Number of lines */
+    lineCount: number;
+}
+/**
+ * Creates llms-full.txt content with deterministic output.
+ * - Complete context with all URLs
+ * - Detailed policy sections
+ * - Social and booking info
+ * - EOL controlled by config.format.lineEndings
+ * @param options - Generation options
+ * @returns Generated content with metadata
+ */
+declare function createLlmsFullTxt(options: CreateLlmsFullTxtOptions): CreateLlmsFullTxtResult;
+interface LlmsFullTxtOptions {
+    /** Maximum content length per page (0 = no limit) */
+    maxContentLength?: number;
+}
+/**
+ * Generates full page content for llms-full.txt.
+ * @deprecated Use createLlmsFullTxt instead
+ */
+declare function generatePageContent(page: {
+    path: string;
+    title?: string;
+    description?: string;
+    content?: string;
+}, manifest: {
+    baseUrl: string;
+}, _options?: LlmsFullTxtOptions): string;
+/**
+ /**
+  * @deprecated Use createLlmsFullTxt instead
+  */
+declare function generateLlmsFullTxt(manifest: {
+    baseUrl: string;
+    title: string;
+    description?: string | undefined;
+    pages: Array<{
+        path: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        content?: string | undefined;
+    }>;
+}, _options?: LlmsFullTxtOptions): string;
+
+/**
+ * Citation generation utilities for LLM-optimized content.
+ * Creates machine-readable citations.json for CI validation.
+ */
+
+/**
+ * Citation source entry.
+ */
+interface CitationSource {
+    /** Canonical URL */
+    url: string;
+    /** Priority (0-100) */
+    priority: number;
+    /** Section name */
+    section: string;
+    /** Locale code */
+    locale: string;
+    /** Publication date (ISO 8601) */
+    publishedAt?: string;
+    /** Last update date (ISO 8601) */
+    updatedAt?: string;
+    /** Page title */
+    title?: string;
+}
+/**
+ * Site information in citations.json.
+ */
+interface CitationsSite {
+    /** Base URL */
+    baseUrl: string;
+    /** Site name */
+    name: string;
+}
+/**
+ * Policy information in citations.json.
+ */
+interface CitationsPolicy {
+    /** Geographic policy */
+    geoPolicy?: string;
+    /** Citation rules */
+    citationRules?: string;
+    /** Whether restricted claims are enabled */
+    restrictedClaimsEnabled: boolean;
+}
+/**
+ * Complete citations.json structure.
+ */
+interface CitationsJson {
+    /** Schema version */
+    version: string;
+    /** Generation timestamp (ISO 8601) */
+    generated: string;
+    /** Site information */
+    site: CitationsSite;
+    /** Sorted citation sources */
+    sources: CitationSource[];
+    /** Policy information */
+    policy: CitationsPolicy;
+}
+/**
+ * Options for citations.json generation.
+ */
+interface CreateCitationsJsonOptions {
+    /** Full LLM SEO configuration */
+    config: LlmsSeoConfig;
+    /** Manifest items to include */
+    manifestItems: ManifestItem[];
+    /** Section name for these items */
+    sectionName: string;
+    /** Optional fixed timestamp for deterministic output (tests) */
+    fixedTimestamp?: string;
+}
+/**
+ * Creates citations.json object with deterministic output.
+ * - Sorted by priority (descending), then by URL
+ * - Includes all manifest items with their metadata
+ * @param options - Generation options
+ * @returns Citations JSON object
+ */
+declare function createCitationsJson(options: CreateCitationsJsonOptions): CitationsJson;
+/**
+ * Creates citations.json as a formatted string.
+ * @param options - Generation options
+ * @returns JSON string with 2-space indentation
+ */
+declare function createCitationsJsonString(options: CreateCitationsJsonOptions): string;
+/**
+ * Represents a citation for a page.
+ * @deprecated Use CitationSource instead
+ */
+interface Citation {
+    /** The URL being cited */
+    url: string;
+    /** The title of the cited page */
+    title: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Generates a citation object for a page.
+ * @deprecated Use createCitationsJson instead
+ */
+declare function createCitation(page: {
+    path: string;
+    title?: string;
+    description?: string;
+}, manifest: {
+    baseUrl: string;
+}): Citation;
+/**
+ * Generates a citation in markdown format.
+ * @deprecated
+ */
+declare function citationToMarkdown(citation: Citation): string;
+/**
+ * Generates a citation in JSON-LD format.
+ * @deprecated
+ */
+declare function citationToJsonLd(citation: Citation): Record<string, string>;
+/**
+ * Generates a reference list from multiple citations.
+ * @deprecated
+ */
+declare function generateReferenceList(citations: readonly Citation[]): string;
+
+/**
+ * Issue types and utilities for SEO checking.
+ */
+/**
+ * Severity levels for issues.
+ */
+type IssueSeverity = 'error' | 'warning' | 'info';
+/**
+ * Categories of SEO issues.
+ */
+type IssueCategory = 'content' | 'structure' | 'accessibility' | 'performance' | 'metadata';
+/**
+ * Represents a check issue found during file verification.
+ */
+interface CheckIssue {
+    /** File path or config path */
+    path: string;
+    /** Issue code e.g., 'file_mismatch', 'missing_file' */
+    code: CheckIssueCode;
+    /** Human-readable message describing the issue */
+    message: string;
+    /** Severity of the issue */
+    severity: IssueSeverity;
+    /** Optional line number where the issue was found */
+    line?: number;
+    /** Context snippet (first N lines or relevant content) */
+    context?: string;
+}
+/**
+ * Issue codes for check issues.
+ */
+type CheckIssueCode = 'file_missing' | 'file_mismatch' | 'file_empty' | 'forbidden_term' | 'empty_section' | 'duplicate_url' | 'invalid_url' | 'config_invalid';
+/**
+ * Legacy Issue interface for backwards compatibility.
+ */
+interface Issue {
+    /** Unique identifier for the issue type */
+    id: string;
+    /** The page or resource this issue applies to */
+    pageId: string;
+    /** Severity of the issue */
+    severity: IssueSeverity;
+    /** Human-readable message describing the issue */
+    message: string;
+    /** Optional category for grouping */
+    category?: IssueCategory;
+    /** Optional suggestion for fixing the issue */
+    suggestion?: string;
+    /** Optional line number where the issue was found */
+    line?: number;
+    /** Optional column number where the issue was found */
+    column?: number;
+}
+/**
+ * Creates a legacy Issue with default values.
+ * @param overrides - Partial issue to override defaults
+ * @returns A complete issue object
+ */
+declare function createIssue(overrides: Partial<Issue> & Pick<Issue, 'id' | 'pageId' | 'severity' | 'message'>): Issue;
+/**
+ * Groups issues by severity (legacy).
+ * @param issues - List of issues
+ * @returns Map of severity to issues
+ */
+declare function groupBySeverity(issues: readonly Issue[]): Map<IssueSeverity, Issue[]>;
+/**
+ * Groups issues by page.
+ * @param issues - List of issues
+ * @returns Map of pageId to issues
+ */
+declare function groupByPage(issues: readonly Issue[]): Map<string, Issue[]>;
+/**
+ * Filters issues by minimum severity.
+ * @param issues - List of issues
+ * @param minSeverity - Minimum severity to include
+ * @returns Filtered list of issues
+ */
+declare function filterBySeverity(issues: readonly Issue[], minSeverity: IssueSeverity): Issue[];
+
+/**
+ * Exit codes for CLI commands.
+ */
+
+/**
+ * Exit codes for the llm-seo CLI.
+ */
+declare const ExitCodes: {
+    /** Command completed successfully */
+    readonly OK: 0;
+    /** Warnings found (when --fail-on warn) */
+    readonly WARN: 1;
+    /** Errors found */
+    readonly ERROR: 2;
+    /** Network error (for doctor command) */
+    readonly NETWORK_ERROR: 3;
+    /** Configuration file not found */
+    readonly CONFIG_NOT_FOUND: 4;
+    /** Invalid configuration */
+    readonly INVALID_CONFIG: 5;
+    /** File not found */
+    readonly FILE_NOT_FOUND: 6;
+    /** Validation failed */
+    readonly VALIDATION_FAILED: 7;
+    /** Generation failed */
+    readonly GENERATION_FAILED: 8;
+    /** Permission denied */
+    readonly PERMISSION_DENIED: 126;
+    /** Command not found */
+    readonly COMMAND_NOT_FOUND: 127;
+};
+/**
+ * Type for exit codes.
+ */
+type ExitCode = (typeof ExitCodes)[keyof typeof ExitCodes];
+
+/**
+ * SEO checker for LLM-optimized content validation.
+ */
+
+/**
+ * Configuration for the SEO checker.
+ */
+interface CheckerConfig {
+    /** Enable strict mode for additional checks */
+    strict?: boolean;
+    /** Maximum allowed title length */
+    maxTitleLength?: number;
+    /** Maximum allowed description length */
+    maxDescriptionLength?: number;
+}
+/**
+ * Options for checking generated files.
+ */
+interface CheckOptions {
+    /** LLM-SEO configuration */
+    config: LlmsSeoConfig;
+    /** Path to llms.txt (default from config) */
+    llmsTxtPath?: string;
+    /** Path to llms-full.txt (default from config) */
+    llmsFullTxtPath?: string;
+    /** Path to citations.json (optional) */
+    citationsPath?: string;
+    /** Fail threshold */
+    failOn: 'warn' | 'error';
+}
+/**
+ * Result of running the SEO checker.
+ */
+interface CheckerResult {
+    /** Whether all checks passed */
+    passed: boolean;
+    /** List of issues found */
+    issues: Issue[];
+    /** Number of pages checked */
+    pagesChecked: number;
+    /** Summary of issues by severity */
+    summary: Record<IssueSeverity, number>;
+}
+/**
+ * Result of checking generated files.
+ */
+interface CheckResult {
+    /** List of issues found */
+    issues: CheckIssue[];
+    /** Summary counts */
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+        filesChecked: number;
+        filesMissing: number;
+        filesMismatch: number;
+    };
+    /** Exit code for CI */
+    exitCode: ExitCode;
+}
+/**
+ * Result of content comparison.
+ */
+interface CompareResult {
+    /** Whether content matches */
+    match: boolean;
+    /** Context showing differences */
+    context: string;
+}
+/**
+ * Default checker configuration.
+ */
+declare const DEFAULT_CHECKER_CONFIG: Required<CheckerConfig>;
+/**
+ * Runs SEO checks on a site manifest.
+ * @param manifest - The site manifest to check
+ * @param config - Checker configuration
+ * @returns Checker result with issues and summary
+ */
+declare function checkManifest(manifest: SiteManifest, config?: CheckerConfig): CheckerResult;
+/**
+ * Main check function:
+ * 1. Validates config
+ * 2. Reads existing files from disk
+ * 3. Compares expected vs actual (if expected content provided)
+ * 4. Runs linting rules
+ * 5. Returns issues with summary
+ *
+ * @param options - Check options
+ * @returns Check result with issues and exit code
+ */
+declare function checkGeneratedFiles(options: CheckOptions): Promise<CheckResult>;
+/**
+ * Checks if a file exists.
+ * @param filePath - Path to the file
+ * @returns Promise resolving to true if file exists
+ */
+declare function checkFileExists(filePath: string): Promise<boolean>;
+/**
+ * Reads file content safely.
+ * @param filePath - Path to the file
+ * @returns File content or null if file doesn't exist
+ */
+declare function readFileContent(filePath: string): Promise<string | null>;
+/**
+ * Compares two strings and returns diff context.
+ * @param expected - Expected content
+ * @param actual - Actual content
+ * @param maxContextLines - Maximum number of diff lines to show (default: 5)
+ * @returns CompareResult with match status and context
+ */
+declare function compareContent(expected: string, actual: string, maxContextLines?: number): CompareResult;
+/**
+ * Checks generated files against expected content.
+ * @param llmsTxtPath - Path to llms.txt
+ * @param expectedLlmsTxt - Expected llms.txt content
+ * @param llmsFullTxtPath - Path to llms-full.txt
+ * @param expectedLlmsFullTxt - Expected llms-full.txt content
+ * @param maxContextLines - Maximum context lines for diff
+ * @returns Array of check issues
+ */
+declare function checkFilesAgainstExpected(llmsTxtPath: string, expectedLlmsTxt: string, llmsFullTxtPath: string, expectedLlmsFullTxt: string, maxContextLines?: number): Promise<CheckIssue[]>;
+
+/**
+ * Rules linter for llms.txt and related files.
+ */
+
+/**
+ * Rule definition for linting.
+ */
+interface LintRule {
+    /** Unique rule identifier */
+    id: string;
+    /** Human-readable description */
+    description: string;
+    /** Whether the rule is enabled by default */
+    enabled: boolean;
+    /** The lint function */
+    lint: (content: string, filePath: string) => Issue[];
+}
+/**
+ * Result of linting content.
+ */
+interface LintResult {
+    /** Issues found during linting */
+    issues: CheckIssue[];
+}
+/**
+ * Available lint rules.
+ */
+declare const LINT_RULES: readonly LintRule[];
+/**
+ * Lints content against provided rules.
+ * @param content - The content to lint
+ * @param filePath - Path to the file being linted
+ * @param rules - Rules to apply (defaults to all enabled rules)
+ * @returns Lint result with issues
+ */
+declare function lintContent(content: string, filePath: string, rules?: readonly LintRule[]): LintResultLegacy;
+/**
+ * Legacy lint result interface.
+ */
+interface LintResultLegacy {
+    /** File path that was linted */
+    filePath: string;
+    /** Issues found during linting */
+    issues: Issue[];
+    /** Whether the file passed all rules */
+    passed: boolean;
+}
+
+export { type CanonicalOptions, type CheckOptions, type CheckResult, type CheckerConfig, type CheckerResult, type Citation, type CitationSource, type CitationsJson, type CitationsPolicy, type CitationsSite, type Comparator, type CompareResult, type CreateCanonicalUrlsOptions, type CreateCitationsJsonOptions, type CreateLlmsFullTxtOptions, type CreateLlmsFullTxtResult, type CreateLlmsTxtOptions, type CreateLlmsTxtResult, DEFAULT_CHECKER_CONFIG, type Issue, type IssueCategory, type IssueSeverity, LINT_RULES, type LintResult, type LintRule, type LlmsFullTxtOptions, type LlmsTxtOptions, type LocaleConfig, type LocaleStrategy, type TrailingSlashPolicy, checkFileExists, checkFilesAgainstExpected, checkGeneratedFiles, checkManifest, citationToJsonLd, citationToMarkdown, compareContent, compareStrings, createCanonicalUrlForItem, createCanonicalUrlsFromManifest, createCitation, createCitationsJson, createCitationsJsonString, createIssue, createLlmsFullTxt, createLlmsTxt, dedupeUrls, extractCanonicalUrls, extractLocaleFromPath, filterBySeverity, generateAlternateUrls, generateCanonicalUrl, generateLlmsFullTxt, generateLlmsTxt, generatePageContent, generateReferenceList, groupByPage, groupBySeverity, lintContent, localizePath, normalizeLineEndings, normalizeLineWhitespace, normalizeSeoText, normalizeUrl, normalizeWhitespace, readFileContent, sortBy, sortStrings, sortUrls };