driftdetect-core 0.1.0

package/dist/parsers/markdown-parser.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Markdown Parser - Markdown/MDX parsing for AST extraction
+ *
+ * Extracts headings, code blocks, links, images, lists, blockquotes,
+ * and front matter from Markdown files using regex-based parsing.
+ *
+ * @requirements 3.2
+ */
+import { BaseParser } from './base-parser.js';
+import type { AST, ASTNode, Language, ParseResult, Position } from './types.js';
+/**
+ * Heading levels (h1-h6)
+ */
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Information about a Markdown heading
+ */
+export interface MarkdownHeadingInfo {
+    /** Heading level (1-6) */
+    level: HeadingLevel;
+    /** Heading text content */
+    text: string;
+    /** Generated slug/anchor ID */
+    slug: string;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a code block
+ */
+export interface MarkdownCodeBlockInfo {
+    /** Language identifier (e.g., 'typescript', 'python') */
+    language: string | null;
+    /** Code content */
+    content: string;
+    /** Whether this is an inline code span */
+    isInline: boolean;
+    /** Meta string after language (e.g., 'title="example.ts"') */
+    meta: string | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Link types in Markdown
+ */
+export type LinkType = 'inline' | 'reference' | 'autolink';
+/**
+ * Information about a Markdown link
+ */
+export interface MarkdownLinkInfo {
+    /** Link text/label */
+    text: string;
+    /** Link URL/href */
+    url: string;
+    /** Link title (optional) */
+    title: string | null;
+    /** Type of link */
+    type: LinkType;
+    /** Reference ID for reference-style links */
+    referenceId: string | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a Markdown image
+ */
+export interface MarkdownImageInfo {
+    /** Alt text */
+    alt: string;
+    /** Image URL/src */
+    url: string;
+    /** Image title (optional) */
+    title: string | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * List types in Markdown
+ */
+export type ListType = 'ordered' | 'unordered';
+/**
+ * Information about a Markdown list
+ */
+export interface MarkdownListInfo {
+    /** Type of list */
+    type: ListType;
+    /** List items */
+    items: MarkdownListItemInfo[];
+    /** Nesting depth (0 = top level) */
+    depth: number;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a list item
+ */
+export interface MarkdownListItemInfo {
+    /** Item text content */
+    text: string;
+    /** Whether this is a task list item */
+    isTask: boolean;
+    /** Task completion status (null if not a task) */
+    isChecked: boolean | null;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about a blockquote
+ */
+export interface MarkdownBlockquoteInfo {
+    /** Blockquote content */
+    content: string;
+    /** Nesting depth (1 = single >) */
+    depth: number;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Information about front matter (YAML)
+ */
+export interface MarkdownFrontMatterInfo {
+    /** Raw YAML content */
+    raw: string;
+    /** Parsed key-value pairs */
+    data: Record<string, unknown>;
+    /** Start position */
+    startPosition: Position;
+    /** End position */
+    endPosition: Position;
+}
+/**
+ * Extended parse result with Markdown-specific information
+ */
+export interface MarkdownParseResult extends ParseResult {
+    /** Extracted headings */
+    headings: MarkdownHeadingInfo[];
+    /** Extracted code blocks */
+    codeBlocks: MarkdownCodeBlockInfo[];
+    /** Extracted links */
+    links: MarkdownLinkInfo[];
+    /** Extracted images */
+    images: MarkdownImageInfo[];
+    /** Extracted lists */
+    lists: MarkdownListInfo[];
+    /** Extracted blockquotes */
+    blockquotes: MarkdownBlockquoteInfo[];
+    /** Front matter if present */
+    frontMatter: MarkdownFrontMatterInfo | null;
+}
+/**
+ * Markdown/MDX parser using regex-based parsing.
+ *
+ * Provides AST parsing and extraction of headings, code blocks,
+ * links, images, lists, blockquotes, and front matter from
+ * Markdown source files.
+ *
+ * @requirements 3.2 - Support Markdown parsing
+ * @requirements 3.3 - Graceful degradation on parse errors
+ */
+export declare class MarkdownParser extends BaseParser {
+    readonly language: Language;
+    readonly extensions: string[];
+    /**
+     * Parse Markdown source code into an AST.
+     *
+     * @param source - The source code to parse
+     * @param filePath - Optional file path for error reporting
+     * @returns MarkdownParseResult containing the AST and extracted information
+     *
+     * @requirements 3.2, 3.3
+     */
+    parse(source: string, _filePath?: string): MarkdownParseResult;
+    /**
+     * Query the AST for nodes matching a pattern.
+     *
+     * Supports querying by node type (e.g., 'Heading', 'CodeBlock', 'Link', 'Image').
+     *
+     * @param ast - The AST to query
+     * @param pattern - The node type to search for
+     * @returns Array of matching AST nodes
+     *
+     * @requirements 3.5
+     */
+    query(ast: AST, pattern: string): ASTNode[];
+    /**
+     * Extract YAML front matter from the start of the document.
+     */
+    private extractFrontMatter;
+    /**
+     * Parse simple YAML key-value pairs.
+     */
+    private parseSimpleYaml;
+    /**
+     * Extract all headings from Markdown source.
+     */
+    private extractHeadings;
+    /**
+     * Generate a URL-friendly slug from heading text.
+     */
+    private generateSlug;
+    /**
+     * Extract all code blocks from Markdown source.
+     */
+    private extractCodeBlocks;
+    /**
+     * Extract all links from Markdown source.
+     */
+    private extractLinks;
+    /**
+     * Find a link reference definition.
+     */
+    private findLinkReference;
+    /**
+     * Extract all images from Markdown source.
+     */
+    private extractImages;
+    /**
+     * Extract all lists from Markdown source.
+     */
+    private extractLists;
+    /**
+     * Extract all blockquotes from Markdown source.
+     */
+    private extractBlockquotes;
+    /**
+     * Create an AST node for front matter.
+     */
+    private createFrontMatterNode;
+    /**
+     * Create an AST node for a heading.
+     */
+    private createHeadingNode;
+    /**
+     * Create an AST node for a code block.
+     */
+    private createCodeBlockNode;
+    /**
+     * Create an AST node for a link.
+     */
+    private createLinkNode;
+    /**
+     * Create an AST node for an image.
+     */
+    private createImageNode;
+    /**
+     * Create an AST node for a list.
+     */
+    private createListNode;
+    /**
+     * Create an AST node for a blockquote.
+     */
+    private createBlockquoteNode;
+    /**
+     * Get the line number for a character offset.
+     */
+    private getLineNumber;
+    /**
+     * Get the column number for a character offset.
+     */
+    private getColumnNumber;
+}
+//# sourceMappingURL=markdown-parser.d.ts.map

package/dist/parsers/markdown-parser.d.ts.map

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