@bfra.me/doc-sync 0.1.0 → 0.1.2

package/lib/{chunk-6NKAJT2M.js → chunk-VHUUC45J.js}

@@ -1074,11 +1074,11 @@ function extractTextFromNode(node) {
 }
 function serializeNode(node) {
   if (node.type === "paragraph") {
-    return extractTextFromNode(node);
+    return serializeInlineContent(node);
   }
   if (node.type === "heading") {
     const prefix = "#".repeat(node.depth);
-    return `${prefix} ${extractTextFromNode(node)}`;
+    return `${prefix} ${serializeInlineContent(node)}`;
   }
   if (node.type === "code") {
     return `\`\`\`${node.lang ?? ""}
@@ -1108,6 +1108,38 @@ ${node.value}
   }
   return extractTextFromNode(node);
 }
+function serializeInlineContent(node) {
+  if ("value" in node && typeof node.value === "string") {
+    return node.value;
+  }
+  if (!("children" in node) || !Array.isArray(node.children)) {
+    return "";
+  }
+  return node.children.map((child) => {
+    if (child.type === "strong") {
+      return `**${serializeInlineContent(child)}**`;
+    }
+    if (child.type === "emphasis") {
+      return `*${serializeInlineContent(child)}*`;
+    }
+    if (child.type === "inlineCode") {
+      return `\`${"value" in child ? child.value : ""}\``;
+    }
+    if (child.type === "link") {
+      const text = serializeInlineContent(child);
+      return `[${text}](${"url" in child ? child.url : ""})`;
+    }
+    if (child.type === "image") {
+      const alt = "alt" in child ? child.alt : "";
+      const url = "url" in child ? child.url : "";
+      return `![${alt}](${url})`;
+    }
+    if ("value" in child && typeof child.value === "string") {
+      return child.value;
+    }
+    return serializeInlineContent(child);
+  }).join("");
+}
 function serializeTable(node) {
   if (node.type !== "table" || !("children" in node)) {
     return "";
@@ -1230,4 +1262,4 @@ export {
   flattenSections,
   getTableOfContents
 };
-//# sourceMappingURL=chunk-6NKAJT2M.js.map
+//# sourceMappingURL=chunk-VHUUC45J.js.map

package/lib/cli/index.js

@@ -3,15 +3,17 @@ import {
   createPackageScanner,
   createSyncOrchestrator,
   createValidationPipeline
-} from "../chunk-DR6UG237.js";
+} from "../chunk-DTXB5PMR.js";
 import {
   generateMDXDocument,
   mergeContent
-} from "../chunk-G5KKGJYO.js";
+} from "../chunk-CUBMCGAY.js";
 import "../chunk-ROLA7SBB.js";
 import {
   getUnscopedName
-} from "../chunk-6NKAJT2M.js";
+} from "../chunk-VHUUC45J.js";
+import "../chunk-GZ2MP3VN.js";
+import "../chunk-45NROJIG.js";
 
 // src/cli/index.ts
 import process4 from "process";

package/lib/generators/index.d.ts

@@ -160,9 +160,7 @@ declare function generateMDXDocument(packageInfo: PackageInfo, readme: ReadmeCon
 declare function sanitizeContent(content: string): string;
 /**
  * Sanitizes content within MDX while preserving JSX components
- * Only escapes content that appears to be user-provided text
- * Now includes sanitization of JSX component attributes to prevent XSS
- * Uses safe, non-backtracking parsing to prevent ReDoS
+ * Sanitizes JSX component attributes to prevent XSS while leaving closing tags unchanged
  */
 declare function sanitizeTextContent(content: string): string;
 declare function validateMDXSyntax(mdx: string): Result<true, SyncError>;

package/lib/generators/index.js

@@ -34,8 +34,9 @@ import {
   validateMarkerPairing,
   wrapAutoSection,
   wrapManualSection
-} from "../chunk-G5KKGJYO.js";
+} from "../chunk-CUBMCGAY.js";
 import "../chunk-ROLA7SBB.js";
+import "../chunk-GZ2MP3VN.js";
 export {
   cleanCodeExample,
   createBadge,

package/lib/index.d.ts

@@ -1,141 +1,9 @@
 export { CodeExampleOptions, ComponentMapperConfig, ContentSection, MDXGeneratorOptions, MergeOptions, MergeResult, SectionMapper, cleanCodeExample, createBadge, createCard, createCardGrid, createDiffSummary, createTabs, detectLanguage, extractAutoSections, extractManualSections, formatCodeBlock, formatCodeExamples, formatFunctionExamples, formatGroupedExamples, formatTypeExamples, formatUsageExample, generateAPICompact, generateAPIReference, generateCategoryReference, generateFrontmatter, generateInstallTabs, generateMDXDocument, groupExamplesByCategory, hasAutoContent, hasManualContent, mapToStarlightComponents, mergeContent, parseFrontmatter, sanitizeContent, sanitizeTextContent, stringifyFrontmatter, stripSentinelMarkers, validateMDXSyntax, validateMarkerPairing, wrapAutoSection, wrapManualSection } from './generators/index.js';
-import { Result } from '@bfra.me/es/result';
-import { PackageInfo, ReadmeContent, PackageAPI, SyncError, FileChangeEvent, DocConfig, SyncSummary, MDXDocument } from './types.js';
-export { CLIOptions, DocConfigSource, ExportedFunction, ExportedType, FunctionParameter, InferSchema, JSDocInfo, JSDocParam, JSDocTag, MDXFrontmatter, ParseError, ParseErrorCode, ParseResult, ReExport, ReadmeSection, SENTINEL_MARKERS, SyncErrorCode, SyncInfo, SyncResult } from './types.js';
+export { PackageScannerOptions, ScanResult, ScannedPackage, SyncOrchestrator, SyncOrchestratorOptions, ValidationError, ValidationPipelineOptions, ValidationResult, ValidationWarning, createPackageScanner, createSyncOrchestrator, createValidationPipeline, filterPackagesByPattern, groupPackagesByScope, isValidFilePath, validateContentString, validateDocument } from './orchestrator/index.js';
+export { ExportAnalyzerOptions, JSDocableDeclaration, PackageInfoOptions, PackageJsonSchema, PublicAPIAnalysis, ReadmeParserOptions, ResolvedExport, TypeScriptParserOptions, analyzePublicAPI, analyzeTypeScriptContent, analyzeTypeScriptFile, assertPackageAPI, assertPackageInfo, assertParseError, buildDocSlug, createProject, extractDocsConfig, extractExportedFunctions, extractExportedTypes, extractJSDocInfo, extractPackageAPI, extractReExports, findEntryPoint, findExportedSymbols, findReadmePath, findSection, flattenSections, getExportedSymbolInfo, getExportsByKind, getPackageScope, getSectionsByLevel, getTableOfContents, getUnscopedName, hasJSDoc, isDocConfigSource, isExportedFunction, isExportedType, isJSDocInfo, isJSDocParam, isJSDocTag, isMDXFrontmatter, isPackageAPI, isPackageInfo, isParseError, isReExport, isReadmeContent, isReadmeSection, isSafeContent, isSafeFilePath, isSymbolExported, isSyncError, isValidHeadingLevel, isValidPackageName, isValidSemver, parseJSDoc, parsePackageComplete, parsePackageJson, parsePackageJsonContent, parseReadme, parseReadmeFile, parseSourceContent, parseSourceFile } from './parsers/index.js';
+export { CLIOptions, DocConfig, DocConfigSource, ExportedFunction, ExportedType, FileChangeEvent, FunctionParameter, InferSchema, JSDocInfo, JSDocParam, JSDocTag, MDXDocument, MDXFrontmatter, PackageAPI, PackageInfo, ParseError, ParseErrorCode, ParseResult, ReExport, ReadmeContent, ReadmeSection, SENTINEL_MARKERS, SyncError, SyncErrorCode, SyncInfo, SyncResult, SyncSummary } from './types.js';
+export { createHeadingPattern, extractCodeBlocks, findEmptyMarkdownLinks, hasComponent, parseJSXAttributes, parseJSXTags, sanitizeAttribute, sanitizeForMDX, sanitizeJSXTag } from './utils/index.js';
+export { BatchChangeHandler, DocChangeDetector, DocChangeDetectorOptions, DocChangeHandler, DocDebouncer, DocDebouncerOptions, DocFileWatcher, DocWatcherOptions, FileCategory, PackageChangeAnalysis, RegenerationScope, categorizeFile, consolidateEvents, createDocChangeDetector, createDocDebouncer, createDocWatcher, deduplicateEvents, determineRegenerationScope, filterDocumentationChanges, groupChangesByPackage, hasAnyFileChanged } from './watcher/index.js';
+import '@bfra.me/es/result';
+import 'ts-morph';
 import 'zod';
-
-interface PackageScannerOptions {
-    readonly rootDir: string;
-    readonly includePatterns?: readonly string[];
-    readonly excludePackages?: readonly string[];
-    readonly parseSourceFiles?: boolean;
-    readonly parseReadme?: boolean;
-}
-interface ScannedPackage {
-    readonly info: PackageInfo;
-    readonly readme?: ReadmeContent;
-    readonly api?: PackageAPI;
-    readonly sourceFiles: readonly string[];
-    readonly needsDocumentation: boolean;
-    readonly existingDocPath?: string;
-}
-interface ScanResult {
-    readonly packages: readonly ScannedPackage[];
-    readonly packagesNeedingDocs: readonly ScannedPackage[];
-    readonly errors: readonly SyncError[];
-    readonly durationMs: number;
-}
-declare function createPackageScanner(options: PackageScannerOptions): {
-    readonly scan: () => Promise<ScanResult>;
-    readonly scanPackage: (packagePath: string) => Promise<Result<ScannedPackage, SyncError>>;
-};
-declare function filterPackagesByPattern(packages: readonly ScannedPackage[], pattern: string): ScannedPackage[];
-declare function groupPackagesByScope(packages: readonly ScannedPackage[]): Map<string, ScannedPackage[]>;
-
-interface DocWatcherOptions {
-    readonly rootDir?: string;
-    readonly debounceMs?: number;
-    readonly additionalIgnore?: readonly string[];
-    readonly usePolling?: boolean;
-}
-type DocChangeHandler = (events: readonly FileChangeEvent[]) => void | Promise<void>;
-interface DocFileWatcher {
-    readonly start: () => Promise<void>;
-    readonly close: () => Promise<void>;
-    readonly onChanges: (handler: DocChangeHandler) => () => void;
-    readonly getWatchedPaths: () => readonly string[];
-}
-declare function createDocWatcher(options?: DocWatcherOptions): DocFileWatcher;
-type FileCategory = 'readme' | 'source' | 'package-json' | 'unknown';
-declare function categorizeFile(filePath: string): FileCategory;
-declare function groupChangesByPackage(events: readonly FileChangeEvent[]): Map<string, FileChangeEvent[]>;
-declare function filterDocumentationChanges(events: readonly FileChangeEvent[]): FileChangeEvent[];
-
-interface DocChangeDetectorOptions {
-    readonly algorithm?: 'sha256' | 'md5';
-}
-interface PackageChangeAnalysis {
-    readonly packageName: string;
-    readonly needsRegeneration: boolean;
-    readonly changedCategories: readonly FileCategory[];
-    readonly changedFiles: readonly string[];
-}
-interface DocChangeDetector {
-    readonly hasChanged: (filePath: string) => Promise<boolean>;
-    readonly record: (filePath: string) => Promise<void>;
-    readonly recordPackage: (pkg: PackageInfo, files: readonly string[]) => Promise<void>;
-    readonly clear: (filePath: string) => void;
-    readonly clearAll: () => void;
-    readonly analyzeChanges: (events: readonly FileChangeEvent[]) => Promise<PackageChangeAnalysis[]>;
-}
-declare function createDocChangeDetector(options?: DocChangeDetectorOptions): DocChangeDetector;
-type RegenerationScope = 'full' | 'api-only' | 'readme-only' | 'metadata-only' | 'none';
-declare function determineRegenerationScope(changedCategories: readonly FileCategory[]): RegenerationScope;
-declare function hasAnyFileChanged(detector: DocChangeDetector, files: readonly string[]): Promise<boolean>;
-
-interface DocDebouncerOptions {
-    readonly debounceMs?: number;
-    readonly maxWaitMs?: number;
-}
-type BatchChangeHandler = (events: readonly FileChangeEvent[]) => void | Promise<void>;
-interface DocDebouncer {
-    readonly add: (event: FileChangeEvent) => void;
-    readonly addAll: (events: readonly FileChangeEvent[]) => void;
-    readonly flush: () => void;
-    readonly cancel: () => void;
-    readonly getPendingCount: () => number;
-}
-declare function createDocDebouncer(handler: BatchChangeHandler, options?: DocDebouncerOptions): DocDebouncer;
-declare function deduplicateEvents(events: readonly FileChangeEvent[]): FileChangeEvent[];
-declare function consolidateEvents(events: readonly FileChangeEvent[]): FileChangeEvent[];
-
-interface SyncOrchestratorOptions {
-    readonly config: DocConfig;
-    readonly dryRun?: boolean;
-    readonly verbose?: boolean;
-    readonly onProgress?: (message: string) => void;
-    readonly onError?: (error: SyncError) => void;
-}
-interface SyncOrchestrator {
-    readonly syncAll: () => Promise<SyncSummary>;
-    readonly syncPackages: (packageNames: readonly string[]) => Promise<SyncSummary>;
-    readonly handleChanges: (events: readonly FileChangeEvent[]) => Promise<SyncSummary>;
-    readonly startWatching: () => Promise<void>;
-    readonly stopWatching: () => Promise<void>;
-    readonly isWatching: () => boolean;
-}
-declare function createSyncOrchestrator(options: SyncOrchestratorOptions): SyncOrchestrator;
-/** Prevents directory traversal attacks (SEC-002) */
-declare function isValidFilePath(filePath: string, rootDir: string): boolean;
-
-interface ValidationResult {
-    readonly valid: boolean;
-    readonly errors: readonly ValidationError[];
-    readonly warnings: readonly ValidationWarning[];
-}
-interface ValidationError {
-    readonly type: 'syntax' | 'frontmatter' | 'component' | 'content';
-    readonly message: string;
-    readonly line?: number;
-    readonly column?: number;
-}
-interface ValidationWarning {
-    readonly type: 'deprecation' | 'recommendation' | 'compatibility';
-    readonly message: string;
-    readonly line?: number;
-}
-interface ValidationPipelineOptions {
-    readonly validateFrontmatter?: boolean;
-    readonly validateComponents?: boolean;
-    readonly validateContent?: boolean;
-    readonly strict?: boolean;
-}
-declare function createValidationPipeline(options?: ValidationPipelineOptions): {
-    readonly validate: (doc: MDXDocument) => ValidationResult;
-    readonly validateContent: (content: string) => ValidationResult;
-    readonly validateMultiple: (docs: readonly MDXDocument[]) => Result<Map<string, ValidationResult>, SyncError>;
-};
-declare function validateDocument(doc: MDXDocument, options?: ValidationPipelineOptions): Result<MDXDocument, SyncError>;
-declare function validateContentString(content: string, options?: ValidationPipelineOptions): Result<string, SyncError>;
-
-export { type BatchChangeHandler, type DocChangeDetector, type DocChangeDetectorOptions, type DocChangeHandler, DocConfig, type DocDebouncer, type DocDebouncerOptions, type DocFileWatcher, type DocWatcherOptions, type FileCategory, FileChangeEvent, MDXDocument, PackageAPI, type PackageChangeAnalysis, PackageInfo, type PackageScannerOptions, ReadmeContent, type RegenerationScope, type ScanResult, type ScannedPackage, SyncError, type SyncOrchestrator, type SyncOrchestratorOptions, SyncSummary, type ValidationError, type ValidationPipelineOptions, type ValidationResult, type ValidationWarning, categorizeFile, consolidateEvents, createDocChangeDetector, createDocDebouncer, createDocWatcher, createPackageScanner, createSyncOrchestrator, createValidationPipeline, deduplicateEvents, determineRegenerationScope, filterDocumentationChanges, filterPackagesByPattern, groupChangesByPackage, groupPackagesByScope, hasAnyFileChanged, isValidFilePath, validateContentString, validateDocument };

package/lib/index.js

@@ -1,23 +1,14 @@
+import "./chunk-SQSYXPIF.js";
 import {
-  categorizeFile,
-  consolidateEvents,
-  createDocChangeDetector,
-  createDocDebouncer,
-  createDocWatcher,
   createPackageScanner,
   createSyncOrchestrator,
   createValidationPipeline,
-  deduplicateEvents,
-  determineRegenerationScope,
-  filterDocumentationChanges,
   filterPackagesByPattern,
-  groupChangesByPackage,
   groupPackagesByScope,
-  hasAnyFileChanged,
   isValidFilePath,
   validateContentString,
   validateDocument
-} from "./chunk-DR6UG237.js";
+} from "./chunk-DTXB5PMR.js";
 import {
   cleanCodeExample,
   createBadge,
@@ -54,13 +45,99 @@ import {
   validateMarkerPairing,
   wrapAutoSection,
   wrapManualSection
-} from "./chunk-G5KKGJYO.js";
+} from "./chunk-CUBMCGAY.js";
 import {
   SENTINEL_MARKERS
 } from "./chunk-ROLA7SBB.js";
-import "./chunk-6NKAJT2M.js";
+import {
+  analyzePublicAPI,
+  analyzeTypeScriptContent,
+  analyzeTypeScriptFile,
+  assertPackageAPI,
+  assertPackageInfo,
+  assertParseError,
+  buildDocSlug,
+  createProject,
+  extractDocsConfig,
+  extractExportedFunctions,
+  extractExportedTypes,
+  extractJSDocInfo,
+  extractPackageAPI,
+  extractReExports,
+  findEntryPoint,
+  findExportedSymbols,
+  findReadmePath,
+  findSection,
+  flattenSections,
+  getExportedSymbolInfo,
+  getExportsByKind,
+  getPackageScope,
+  getSectionsByLevel,
+  getTableOfContents,
+  getUnscopedName,
+  hasJSDoc,
+  isDocConfigSource,
+  isExportedFunction,
+  isExportedType,
+  isJSDocInfo,
+  isJSDocParam,
+  isJSDocTag,
+  isMDXFrontmatter,
+  isPackageAPI,
+  isPackageInfo,
+  isParseError,
+  isReExport,
+  isReadmeContent,
+  isReadmeSection,
+  isSafeContent,
+  isSafeFilePath,
+  isSymbolExported,
+  isSyncError,
+  isValidHeadingLevel,
+  isValidPackageName,
+  isValidSemver,
+  parseJSDoc,
+  parsePackageComplete,
+  parsePackageJson,
+  parsePackageJsonContent,
+  parseReadme,
+  parseReadmeFile,
+  parseSourceContent,
+  parseSourceFile
+} from "./chunk-VHUUC45J.js";
+import "./chunk-DRBRT57F.js";
+import {
+  createHeadingPattern,
+  extractCodeBlocks,
+  findEmptyMarkdownLinks,
+  hasComponent,
+  parseJSXAttributes,
+  parseJSXTags,
+  sanitizeAttribute,
+  sanitizeForMDX,
+  sanitizeJSXTag
+} from "./chunk-GZ2MP3VN.js";
+import {
+  categorizeFile,
+  consolidateEvents,
+  createDocChangeDetector,
+  createDocDebouncer,
+  createDocWatcher,
+  deduplicateEvents,
+  determineRegenerationScope,
+  filterDocumentationChanges,
+  groupChangesByPackage,
+  hasAnyFileChanged
+} from "./chunk-45NROJIG.js";
 export {
   SENTINEL_MARKERS,
+  analyzePublicAPI,
+  analyzeTypeScriptContent,
+  analyzeTypeScriptFile,
+  assertPackageAPI,
+  assertPackageInfo,
+  assertParseError,
+  buildDocSlug,
   categorizeFile,
   cleanCodeExample,
   consolidateEvents,
@@ -71,7 +148,9 @@ export {
   createDocChangeDetector,
   createDocDebouncer,
   createDocWatcher,
+  createHeadingPattern,
   createPackageScanner,
+  createProject,
   createSyncOrchestrator,
   createTabs,
   createValidationPipeline,
@@ -79,9 +158,22 @@ export {
   detectLanguage,
   determineRegenerationScope,
   extractAutoSections,
+  extractCodeBlocks,
+  extractDocsConfig,
+  extractExportedFunctions,
+  extractExportedTypes,
+  extractJSDocInfo,
   extractManualSections,
+  extractPackageAPI,
+  extractReExports,
   filterDocumentationChanges,
   filterPackagesByPattern,
+  findEmptyMarkdownLinks,
+  findEntryPoint,
+  findExportedSymbols,
+  findReadmePath,
+  findSection,
+  flattenSections,
   formatCodeBlock,
   formatCodeExamples,
   formatFunctionExamples,
@@ -94,17 +186,58 @@ export {
   generateFrontmatter,
   generateInstallTabs,
   generateMDXDocument,
+  getExportedSymbolInfo,
+  getExportsByKind,
+  getPackageScope,
+  getSectionsByLevel,
+  getTableOfContents,
+  getUnscopedName,
   groupChangesByPackage,
   groupExamplesByCategory,
   groupPackagesByScope,
   hasAnyFileChanged,
   hasAutoContent,
+  hasComponent,
+  hasJSDoc,
   hasManualContent,
+  isDocConfigSource,
+  isExportedFunction,
+  isExportedType,
+  isJSDocInfo,
+  isJSDocParam,
+  isJSDocTag,
+  isMDXFrontmatter,
+  isPackageAPI,
+  isPackageInfo,
+  isParseError,
+  isReExport,
+  isReadmeContent,
+  isReadmeSection,
+  isSafeContent,
+  isSafeFilePath,
+  isSymbolExported,
+  isSyncError,
   isValidFilePath,
+  isValidHeadingLevel,
+  isValidPackageName,
+  isValidSemver,
   mapToStarlightComponents,
   mergeContent,
   parseFrontmatter,
+  parseJSDoc,
+  parseJSXAttributes,
+  parseJSXTags,
+  parsePackageComplete,
+  parsePackageJson,
+  parsePackageJsonContent,
+  parseReadme,
+  parseReadmeFile,
+  parseSourceContent,
+  parseSourceFile,
+  sanitizeAttribute,
   sanitizeContent,
+  sanitizeForMDX,
+  sanitizeJSXTag,
   sanitizeTextContent,
   stringifyFrontmatter,
   stripSentinelMarkers,

package/lib/orchestrator/index.d.ts

@@ -0,0 +1,82 @@
+import { Result } from '@bfra.me/es/result';
+import { PackageInfo, ReadmeContent, PackageAPI, SyncError, DocConfig, SyncSummary, FileChangeEvent, MDXDocument } from '../types.js';
+import 'zod';
+
+interface PackageScannerOptions {
+    readonly rootDir: string;
+    readonly includePatterns?: readonly string[];
+    readonly excludePackages?: readonly string[];
+    readonly parseSourceFiles?: boolean;
+    readonly parseReadme?: boolean;
+}
+interface ScannedPackage {
+    readonly info: PackageInfo;
+    readonly readme?: ReadmeContent;
+    readonly api?: PackageAPI;
+    readonly sourceFiles: readonly string[];
+    readonly needsDocumentation: boolean;
+    readonly existingDocPath?: string;
+}
+interface ScanResult {
+    readonly packages: readonly ScannedPackage[];
+    readonly packagesNeedingDocs: readonly ScannedPackage[];
+    readonly errors: readonly SyncError[];
+    readonly durationMs: number;
+}
+declare function createPackageScanner(options: PackageScannerOptions): {
+    readonly scan: () => Promise<ScanResult>;
+    readonly scanPackage: (packagePath: string) => Promise<Result<ScannedPackage, SyncError>>;
+};
+declare function filterPackagesByPattern(packages: readonly ScannedPackage[], pattern: string): ScannedPackage[];
+declare function groupPackagesByScope(packages: readonly ScannedPackage[]): Map<string, ScannedPackage[]>;
+
+interface SyncOrchestratorOptions {
+    readonly config: DocConfig;
+    readonly dryRun?: boolean;
+    readonly verbose?: boolean;
+    readonly onProgress?: (message: string) => void;
+    readonly onError?: (error: SyncError) => void;
+}
+interface SyncOrchestrator {
+    readonly syncAll: () => Promise<SyncSummary>;
+    readonly syncPackages: (packageNames: readonly string[]) => Promise<SyncSummary>;
+    readonly handleChanges: (events: readonly FileChangeEvent[]) => Promise<SyncSummary>;
+    readonly startWatching: () => Promise<void>;
+    readonly stopWatching: () => Promise<void>;
+    readonly isWatching: () => boolean;
+}
+declare function createSyncOrchestrator(options: SyncOrchestratorOptions): SyncOrchestrator;
+/** Prevents directory traversal attacks (SEC-002) */
+declare function isValidFilePath(filePath: string, rootDir: string): boolean;
+
+interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly ValidationError[];
+    readonly warnings: readonly ValidationWarning[];
+}
+interface ValidationError {
+    readonly type: 'syntax' | 'frontmatter' | 'component' | 'content';
+    readonly message: string;
+    readonly line?: number;
+    readonly column?: number;
+}
+interface ValidationWarning {
+    readonly type: 'deprecation' | 'recommendation' | 'compatibility';
+    readonly message: string;
+    readonly line?: number;
+}
+interface ValidationPipelineOptions {
+    readonly validateFrontmatter?: boolean;
+    readonly validateComponents?: boolean;
+    readonly validateContent?: boolean;
+    readonly strict?: boolean;
+}
+declare function createValidationPipeline(options?: ValidationPipelineOptions): {
+    readonly validate: (doc: MDXDocument) => ValidationResult;
+    readonly validateContent: (content: string) => ValidationResult;
+    readonly validateMultiple: (docs: readonly MDXDocument[]) => Result<Map<string, ValidationResult>, SyncError>;
+};
+declare function validateDocument(doc: MDXDocument, options?: ValidationPipelineOptions): Result<MDXDocument, SyncError>;
+declare function validateContentString(content: string, options?: ValidationPipelineOptions): Result<string, SyncError>;
+
+export { type PackageScannerOptions, type ScanResult, type ScannedPackage, type SyncOrchestrator, type SyncOrchestratorOptions, type ValidationError, type ValidationPipelineOptions, type ValidationResult, type ValidationWarning, createPackageScanner, createSyncOrchestrator, createValidationPipeline, filterPackagesByPattern, groupPackagesByScope, isValidFilePath, validateContentString, validateDocument };

package/lib/orchestrator/index.js

@@ -0,0 +1,27 @@
+import "../chunk-SQSYXPIF.js";
+import {
+  createPackageScanner,
+  createSyncOrchestrator,
+  createValidationPipeline,
+  filterPackagesByPattern,
+  groupPackagesByScope,
+  isValidFilePath,
+  validateContentString,
+  validateDocument
+} from "../chunk-DTXB5PMR.js";
+import "../chunk-CUBMCGAY.js";
+import "../chunk-ROLA7SBB.js";
+import "../chunk-VHUUC45J.js";
+import "../chunk-GZ2MP3VN.js";
+import "../chunk-45NROJIG.js";
+export {
+  createPackageScanner,
+  createSyncOrchestrator,
+  createValidationPipeline,
+  filterPackagesByPattern,
+  groupPackagesByScope,
+  isValidFilePath,
+  validateContentString,
+  validateDocument
+};
+//# sourceMappingURL=index.js.map

package/lib/parsers/index.js

@@ -53,7 +53,7 @@ import {
   parseReadmeFile,
   parseSourceContent,
   parseSourceFile
-} from "../chunk-6NKAJT2M.js";
+} from "../chunk-VHUUC45J.js";
 export {
   analyzePublicAPI,
   analyzeTypeScriptContent,