folderblog 0.0.2 → 0.0.3

package/dist/output-0P0br3Jc.d.cts

@@ -0,0 +1,452 @@
+/**
+ * Issue tracking types for @repo-md/processor-core
+ */
+type IssueSeverity = 'error' | 'warning' | 'info';
+type IssueCategory = 'broken-link' | 'missing-media' | 'media-processing' | 'slug-conflict' | 'mermaid-error' | 'frontmatter-error' | 'parse-error' | 'file-access' | 'embedding-error' | 'database-error' | 'plugin-error' | 'configuration' | 'other';
+type IssueModule = 'markdown-parser' | 'image-processor' | 'embed-mermaid' | 'embed-media' | 'link-resolver' | 'slug-generator' | 'frontmatter-parser' | 'file-system' | 'config-validator' | 'post-processor' | 'text-embeddings' | 'image-embeddings' | 'similarity' | 'database' | 'plugin-manager' | 'other';
+/**
+ * Base interface for all processing issues
+ */
+interface ProcessingIssue {
+    readonly severity: IssueSeverity;
+    readonly category: IssueCategory;
+    readonly module: IssueModule;
+    readonly message: string;
+    readonly filePath?: string;
+    readonly lineNumber?: number;
+    readonly columnNumber?: number;
+    readonly context?: Readonly<Record<string, unknown>>;
+    readonly timestamp: string;
+}
+/**
+ * Broken link issue
+ */
+interface BrokenLinkIssue extends ProcessingIssue {
+    readonly category: 'broken-link';
+    readonly module: 'link-resolver';
+    readonly context: {
+        readonly linkText: string;
+        readonly linkTarget: string;
+        readonly linkType: 'wiki' | 'markdown' | 'frontmatter';
+        readonly suggestions?: readonly string[];
+    };
+}
+/**
+ * Missing media issue
+ */
+interface MissingMediaIssue extends ProcessingIssue {
+    readonly category: 'missing-media';
+    readonly module: 'embed-media' | 'image-processor';
+    readonly context: {
+        readonly mediaPath: string;
+        readonly referencedFrom: 'content' | 'frontmatter' | 'embed';
+        readonly originalReference?: string;
+    };
+}
+/**
+ * Media processing issue
+ */
+interface MediaProcessingIssue extends ProcessingIssue {
+    readonly category: 'media-processing';
+    readonly module: 'image-processor';
+    readonly context: {
+        readonly mediaPath: string;
+        readonly operation: 'read' | 'optimize' | 'resize' | 'hash' | 'copy';
+        readonly errorMessage: string;
+        readonly errorCode?: string;
+    };
+}
+/**
+ * Slug conflict issue
+ */
+interface SlugConflictIssue extends ProcessingIssue {
+    readonly category: 'slug-conflict';
+    readonly module: 'slug-generator';
+    readonly context: {
+        readonly originalSlug: string;
+        readonly finalSlug: string;
+        readonly conflictingFiles: readonly string[];
+    };
+}
+/**
+ * Mermaid error issue
+ */
+interface MermaidErrorIssue extends ProcessingIssue {
+    readonly category: 'mermaid-error';
+    readonly module: 'embed-mermaid';
+    readonly context: {
+        readonly errorType: 'plugin-load' | 'render-fail' | 'missing-deps';
+        readonly diagramContent?: string;
+        readonly fallback: string;
+    };
+}
+/**
+ * Embedding error issue
+ */
+interface EmbeddingErrorIssue extends ProcessingIssue {
+    readonly category: 'embedding-error';
+    readonly module: 'text-embeddings' | 'image-embeddings';
+    readonly context: {
+        readonly embeddingType: 'text' | 'image';
+        readonly operation: 'initialize' | 'embed' | 'batch';
+        readonly errorMessage: string;
+    };
+}
+/**
+ * Plugin error issue
+ */
+interface PluginErrorIssue extends ProcessingIssue {
+    readonly category: 'plugin-error';
+    readonly module: 'plugin-manager';
+    readonly context: {
+        readonly pluginName: string;
+        readonly operation: 'initialize' | 'process' | 'dispose';
+        readonly errorMessage: string;
+    };
+}
+declare const isBrokenLinkIssue: (issue: ProcessingIssue) => issue is BrokenLinkIssue;
+declare const isMissingMediaIssue: (issue: ProcessingIssue) => issue is MissingMediaIssue;
+declare const isMediaProcessingIssue: (issue: ProcessingIssue) => issue is MediaProcessingIssue;
+declare const isSlugConflictIssue: (issue: ProcessingIssue) => issue is SlugConflictIssue;
+declare const isMermaidErrorIssue: (issue: ProcessingIssue) => issue is MermaidErrorIssue;
+declare const isEmbeddingErrorIssue: (issue: ProcessingIssue) => issue is EmbeddingErrorIssue;
+declare const isPluginErrorIssue: (issue: ProcessingIssue) => issue is PluginErrorIssue;
+interface IssueSummary {
+    readonly totalIssues: number;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly infoCount: number;
+    readonly filesAffected: number;
+    readonly categoryCounts: Readonly<Record<IssueCategory, number>>;
+    readonly moduleCounts: Readonly<Record<IssueModule, number>>;
+}
+interface IssueReport {
+    readonly issues: readonly ProcessingIssue[];
+    readonly summary: IssueSummary;
+    readonly metadata: {
+        readonly processStartTime: string;
+        readonly processEndTime: string;
+        readonly processorVersion?: string;
+    };
+}
+interface IssueFilterOptions {
+    readonly severity?: IssueSeverity | readonly IssueSeverity[];
+    readonly category?: IssueCategory | readonly IssueCategory[];
+    readonly module?: IssueModule | readonly IssueModule[];
+    readonly filePath?: string | readonly string[];
+}
+
+/**
+ * Cache types for @repo-md/processor-core
+ *
+ * These types support incremental builds by allowing the processor
+ * to skip re-processing files that haven't changed.
+ */
+
+/**
+ * Cached metadata for a previously processed media file.
+ * Contains all information needed to skip image processing
+ * while still generating correct HTML output with dimensions.
+ */
+interface CachedMediaMetadata {
+    /** Original image width */
+    readonly width: number;
+    /** Original image height */
+    readonly height: number;
+    /** Output format (webp, avif, jpeg, png) */
+    readonly format: string;
+    /** Output file size in bytes */
+    readonly size: number;
+    /** Original file size in bytes */
+    readonly originalSize?: number;
+    /** Output file path relative to media output dir */
+    readonly outputPath: string;
+    /** Responsive size variants */
+    readonly sizes: readonly CachedMediaSizeVariant[];
+}
+/**
+ * Cached size variant for responsive images
+ */
+interface CachedMediaSizeVariant {
+    /** Size suffix (xs, sm, md, lg, xl) */
+    readonly suffix: string;
+    /** Output file path relative to media output dir */
+    readonly outputPath: string;
+    /** Width of this variant */
+    readonly width: number;
+    /** Height of this variant */
+    readonly height: number;
+    /** File size in bytes */
+    readonly size: number;
+}
+/**
+ * Cache context passed to the processor for incremental builds.
+ * All caches are keyed by content hash (SHA-256).
+ */
+interface CacheContext {
+    /**
+     * Cached media metadata keyed by content hash.
+     * When a media file's hash matches a cached entry, processing can be skipped
+     * and the cached metadata used for HTML rendering (dimensions, paths).
+     */
+    readonly media?: ReadonlyMap<string, CachedMediaMetadata>;
+    /**
+     * Cached text embeddings keyed by post content hash.
+     * When a post's hash matches a cached entry, embedding generation
+     * can be skipped and the cached vector used directly.
+     */
+    readonly textEmbeddings?: ReadonlyMap<string, readonly number[]>;
+    /**
+     * Cached image embeddings keyed by media content hash.
+     * When a media file's hash matches a cached entry, CLIP embedding
+     * generation can be skipped and the cached vector used directly.
+     */
+    readonly imageEmbeddings?: ReadonlyMap<string, readonly number[]>;
+}
+/**
+ * Statistics about cache usage during processing
+ */
+interface CacheStats {
+    /** Number of media files that used cached metadata */
+    readonly mediaCacheHits: number;
+    /** Number of media files that were processed fresh */
+    readonly mediaCacheMisses: number;
+    /** Number of posts that used cached text embeddings */
+    readonly textEmbeddingCacheHits: number;
+    /** Number of posts that required fresh text embedding generation */
+    readonly textEmbeddingCacheMisses: number;
+    /** Number of media files that used cached image embeddings */
+    readonly imageEmbeddingCacheHits: number;
+    /** Number of media files that required fresh image embedding generation */
+    readonly imageEmbeddingCacheMisses: number;
+}
+/**
+ * Create empty cache statistics
+ */
+declare const createEmptyCacheStats: () => CacheStats;
+/**
+ * Build a media cache from a medias.json file structure
+ */
+declare function buildMediaCacheFromManifest(medias: readonly {
+    metadata?: MediaMetadata;
+    outputPath: string;
+    sizes?: readonly MediaSizeVariant[];
+}[]): Map<string, CachedMediaMetadata>;
+/**
+ * Build an embedding cache from an embedding hash map file structure
+ */
+declare function buildEmbeddingCacheFromManifest(embeddingMap: Record<string, readonly number[]>): Map<string, readonly number[]>;
+
+/**
+ * Output types for @repo-md/processor-core
+ */
+
+interface TocItem {
+    readonly text: string;
+    readonly depth: number;
+    readonly slug: string;
+}
+interface PostMetadata {
+    readonly createdAt: string;
+    readonly modifiedAt: string;
+    readonly processedAt: string;
+    readonly gitCreatedAt?: string;
+    readonly gitModifiedAt?: string;
+}
+interface PostCoverSize {
+    /** Size suffix (xs, sm, md, lg, xl) */
+    readonly suffix: string;
+    /** Output file path relative to output dir */
+    readonly path: string;
+    /** Full URL if domain configured */
+    readonly url?: string;
+    /** Width of this variant */
+    readonly width: number;
+    /** Height of this variant */
+    readonly height: number;
+}
+interface PostCover {
+    /** Original path from frontmatter */
+    readonly original: string;
+    /** Output file path relative to output dir */
+    readonly path: string;
+    /** Full URL if domain configured */
+    readonly url?: string;
+    /** Content hash */
+    readonly hash?: string;
+    /** Image width */
+    readonly width?: number;
+    /** Image height */
+    readonly height?: number;
+    /** Responsive image size variants */
+    readonly sizes?: readonly PostCoverSize[];
+}
+interface PostCoverError {
+    /** Original path from frontmatter */
+    readonly original: string;
+    /** Error message explaining why cover couldn't be resolved */
+    readonly error: string;
+}
+interface ProcessedPost {
+    /** Content hash for identification */
+    readonly hash: string;
+    /** URL-friendly slug */
+    readonly slug: string;
+    /** Post title (from frontmatter or filename) */
+    readonly title: string;
+    /** Original filename without extension */
+    readonly fileName: string;
+    /** Original file path relative to input directory */
+    readonly originalPath: string;
+    /** Rendered HTML content */
+    readonly content: string;
+    /** Original markdown content */
+    readonly markdown: string;
+    /** Plain text content (for search/embeddings) */
+    readonly plainText: string;
+    /** Excerpt/summary text */
+    readonly excerpt: string;
+    /** Word count */
+    readonly wordCount: number;
+    /** Table of contents */
+    readonly toc: readonly TocItem[];
+    /** Frontmatter data */
+    readonly frontmatter: Readonly<Record<string, unknown>>;
+    /** Timestamps and metadata */
+    readonly metadata: PostMetadata;
+    /** Cover image (resolved from frontmatter.cover) */
+    readonly cover?: PostCover | PostCoverError;
+    /** URL of first image (for cover) */
+    readonly firstImage?: string;
+    /** Hashes of posts this post links to */
+    readonly links?: readonly string[];
+    /** Text embedding vector */
+    readonly embedding?: readonly number[];
+}
+interface MediaMetadata {
+    readonly width?: number;
+    readonly height?: number;
+    readonly format?: string;
+    readonly size?: number;
+    readonly originalSize?: number;
+    readonly hash?: string;
+}
+interface MediaSizeVariant {
+    /** Size suffix (xs, sm, md, lg, xl) */
+    readonly suffix: string;
+    /** Output file path relative to output dir */
+    readonly outputPath: string;
+    /** Width of this variant */
+    readonly width: number;
+    /** Height of this variant */
+    readonly height: number;
+    /** File size in bytes */
+    readonly size: number;
+}
+interface ProcessedMedia {
+    /** Original file path relative to input */
+    readonly originalPath: string;
+    /** Output file path relative to output dir */
+    readonly outputPath: string;
+    /** Original filename */
+    readonly fileName: string;
+    /** Media type */
+    readonly type: 'image' | 'video' | 'audio' | 'media';
+    /** File metadata */
+    readonly metadata?: MediaMetadata;
+    /** Responsive image size variants */
+    readonly sizes?: readonly MediaSizeVariant[];
+    /** Image embedding vector */
+    readonly embedding?: readonly number[];
+}
+type RelationshipType = 'POST_LINKS_TO_POST' | 'POST_USE_IMAGE';
+interface GraphNode {
+    readonly id: string;
+    readonly type: 'post' | 'media';
+    readonly label: string;
+}
+interface GraphEdge {
+    readonly source: string;
+    readonly target: string;
+    readonly type: RelationshipType;
+}
+interface GraphData {
+    readonly nodes: readonly GraphNode[];
+    readonly edges: readonly GraphEdge[];
+}
+/** Maps original paths to optimized public paths */
+type MediaPathMap = Readonly<Record<string, string>>;
+/** Maps original paths to content hashes */
+type PathHashMap = Readonly<Record<string, string>>;
+/** Maps slugs to post hashes */
+type SlugHashMap = Readonly<Record<string, string>>;
+/** Maps hashes to embedding vectors */
+type EmbeddingMap = ReadonlyMap<string, readonly number[]>;
+interface OutputFiles {
+    readonly posts: string;
+    readonly media: string;
+    readonly slugMap: string;
+    readonly pathMap: string;
+    readonly issues: string;
+    readonly graph?: string;
+    readonly similarity?: string;
+    readonly database?: string;
+}
+interface BuildReport {
+    /** Text embedding stats (if embeddings were generated) */
+    readonly postEmbeddings?: {
+        readonly filesProcessed: number;
+        readonly dimensions: number;
+        readonly model: string;
+    };
+    /** Image embedding stats (if image embeddings were generated) */
+    readonly mediaEmbeddings?: {
+        readonly filesProcessed: number;
+        readonly dimensions: number;
+        readonly model: string;
+    };
+    /** Similarity computation stats */
+    readonly similarity?: {
+        readonly pairsComputed: number;
+        readonly topN: number;
+        readonly postsWithEmbeddings: number;
+    };
+    /** Phase timing in milliseconds */
+    readonly timing?: {
+        readonly totalMs: number;
+        readonly phases: Readonly<Record<string, number>>;
+    };
+}
+interface ProcessResult {
+    /** Processed posts */
+    readonly posts: readonly ProcessedPost[];
+    /** Processed media files */
+    readonly media: readonly ProcessedMedia[];
+    /** Output directory path */
+    readonly outputDir: string;
+    /** Output file paths */
+    readonly outputFiles: OutputFiles;
+    /** Processing issues report */
+    readonly issues: IssueReport;
+    /** Graph data (if trackRelationships enabled) */
+    readonly graph?: GraphData;
+    /** Cache statistics (if cache was provided) */
+    readonly cacheStats?: CacheStats;
+    /** Build report with stats about embeddings, similarity, timing */
+    readonly report?: BuildReport;
+}
+declare const OUTPUT_FILES: {
+    readonly POSTS: "posts.json";
+    readonly POSTS_SLUG_MAP: "posts-slug-map.json";
+    readonly POSTS_PATH_MAP: "posts-path-map.json";
+    readonly MEDIAS: "media.json";
+    readonly MEDIA_PATH_MAP: "media-path-map.json";
+    readonly GRAPH: "graph.json";
+    readonly TEXT_EMBEDDINGS: "posts-embedding-hash-map.json";
+    readonly IMAGE_EMBEDDINGS: "media-embedding-hash-map.json";
+    readonly SIMILARITY: "similarity.json";
+    readonly DATABASE: "repo.db";
+    readonly ISSUES: "processor-issues.json";
+};
+
+export { type ProcessResult as A, type BrokenLinkIssue as B, type CacheContext as C, type SlugHashMap as D, type EmbeddingErrorIssue as E, buildEmbeddingCacheFromManifest as F, type GraphData as G, buildMediaCacheFromManifest as H, type IssueFilterOptions as I, createEmptyCacheStats as J, isBrokenLinkIssue as K, isEmbeddingErrorIssue as L, type MediaMetadata as M, isMediaProcessingIssue as N, OUTPUT_FILES as O, type ProcessingIssue as P, isMermaidErrorIssue as Q, type RelationshipType as R, type SlugConflictIssue as S, type TocItem as T, isMissingMediaIssue as U, isPluginErrorIssue as V, isSlugConflictIssue as W, type IssueSeverity as a, type IssueReport as b, type IssueSummary as c, type ProcessedPost as d, type ProcessedMedia as e, type BuildReport as f, type CacheStats as g, type CachedMediaMetadata as h, type CachedMediaSizeVariant as i, type EmbeddingMap as j, type GraphEdge as k, type GraphNode as l, type IssueCategory as m, type IssueModule as n, type MediaPathMap as o, type MediaProcessingIssue as p, type MediaSizeVariant as q, type MermaidErrorIssue as r, type MissingMediaIssue as s, type OutputFiles as t, type PathHashMap as u, type PluginErrorIssue as v, type PostCover as w, type PostCoverError as x, type PostCoverSize as y, type PostMetadata as z };