@vibe-agent-toolkit/resource-compiler 0.1.11

package/dist/compiler/markdown-compiler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Markdown compiler orchestrator - coordinates the compilation pipeline
+ */
+import type { CompileOptions, CompileResult } from './types.js';
+/**
+ * Compile markdown resources to JavaScript and TypeScript declarations
+ *
+ * @param options - Compilation options
+ * @returns Array of compilation results for each file
+ *
+ * @example
+ * ```typescript
+ * const results = await compileMarkdownResources({
+ *   inputDir: './resources',
+ *   outputDir: './dist/resources',
+ *   pattern: '**\/*.md',
+ *   verbose: true,
+ * });
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`✓ Compiled ${result.sourcePath}`);
+ *   } else {
+ *     console.error(`✗ Failed ${result.sourcePath}: ${result.error}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function compileMarkdownResources(options: CompileOptions): Promise<CompileResult[]>;
+//# sourceMappingURL=markdown-compiler.d.ts.map

package/dist/compiler/markdown-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-compiler.d.ts","sourceRoot":"","sources":["../../src/compiler/markdown-compiler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B1B"}

package/dist/compiler/markdown-compiler.js

@@ -0,0 +1,125 @@
+/**
+ * Markdown compiler orchestrator - coordinates the compilation pipeline
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { mkdirSyncReal, toForwardSlash } from '@vibe-agent-toolkit/utils';
+import { glob } from 'glob';
+import { generateTypeScriptDeclarations } from './dts-generator.js';
+import { generateJavaScript } from './javascript-generator.js';
+import { parseMarkdown } from './markdown-parser.js';
+/**
+ * Compile markdown resources to JavaScript and TypeScript declarations
+ *
+ * @param options - Compilation options
+ * @returns Array of compilation results for each file
+ *
+ * @example
+ * ```typescript
+ * const results = await compileMarkdownResources({
+ *   inputDir: './resources',
+ *   outputDir: './dist/resources',
+ *   pattern: '**\/*.md',
+ *   verbose: true,
+ * });
+ *
+ * for (const result of results) {
+ *   if (result.success) {
+ *     console.log(`✓ Compiled ${result.sourcePath}`);
+ *   } else {
+ *     console.error(`✗ Failed ${result.sourcePath}: ${result.error}`);
+ *   }
+ * }
+ * ```
+ */
+export async function compileMarkdownResources(options) {
+    const { inputDir, outputDir, pattern = '**/*.md', verbose = false } = options;
+    if (verbose) {
+        console.log(`Compiling markdown resources from ${inputDir}`);
+        console.log(`Pattern: ${pattern}`);
+        console.log(`Output: ${outputDir}`);
+    }
+    // Find all markdown files matching pattern
+    const files = await glob(pattern, {
+        cwd: inputDir,
+        absolute: false,
+        nodir: true,
+    });
+    if (verbose) {
+        console.log(`Found ${files.length} markdown files`);
+    }
+    const results = [];
+    for (const file of files) {
+        const result = await compileSingleFile(file, inputDir, outputDir, verbose);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Compile a single markdown file
+ *
+ * @param relativeFilePath - Path relative to inputDir
+ * @param inputDir - Input directory
+ * @param outputDir - Output directory
+ * @param verbose - Enable verbose logging
+ * @returns Compilation result
+ */
+async function compileSingleFile(relativeFilePath, inputDir, outputDir, verbose) {
+    const sourcePath = join(inputDir, relativeFilePath);
+    try {
+        // Read markdown file
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Controlled input from glob
+        const markdownContent = readFileSync(sourcePath, 'utf-8');
+        if (verbose) {
+            console.log(`  Processing ${relativeFilePath}...`);
+        }
+        // Parse markdown
+        const resource = parseMarkdown(markdownContent);
+        // Generate JavaScript code
+        const jsCode = generateJavaScript(resource);
+        // Generate TypeScript declarations
+        const dtsCode = generateTypeScriptDeclarations(resource);
+        // Calculate output paths (maintain directory structure)
+        const fileBaseName = relativeFilePath.replace(/\.md$/i, '');
+        const jsRelativePath = `${fileBaseName}.js`;
+        const dtsRelativePath = `${fileBaseName}.d.ts`;
+        const jsPath = join(outputDir, jsRelativePath);
+        const dtsPath = join(outputDir, dtsRelativePath);
+        // Ensure output directories exist
+        const jsDir = dirname(jsPath);
+        const dtsDir = dirname(dtsPath);
+        mkdirSyncReal(jsDir, { recursive: true });
+        if (jsDir !== dtsDir) {
+            mkdirSyncReal(dtsDir, { recursive: true });
+        }
+        // Write output files
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Controlled output path
+        writeFileSync(jsPath, jsCode, 'utf-8');
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Controlled output path
+        writeFileSync(dtsPath, dtsCode, 'utf-8');
+        if (verbose) {
+            console.log(`    ✓ ${toForwardSlash(jsRelativePath)}`);
+            console.log(`    ✓ ${toForwardSlash(dtsRelativePath)}`);
+        }
+        return {
+            sourcePath,
+            jsPath,
+            dtsPath,
+            success: true,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (verbose) {
+            console.error(`    ✗ Failed to compile ${relativeFilePath}: ${errorMessage}`);
+        }
+        return {
+            sourcePath,
+            jsPath: '',
+            dtsPath: '',
+            success: false,
+            error: errorMessage,
+        };
+    }
+}
+//# sourceMappingURL=markdown-compiler.js.map

package/dist/compiler/markdown-compiler.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Markdown parser for extracting frontmatter and H2 fragments
+ */
+import type { MarkdownResource } from './types.js';
+/**
+ * Parse markdown file content into a MarkdownResource
+ *
+ * @param content - Raw markdown file content
+ * @returns Parsed resource with frontmatter and fragments
+ *
+ * @example
+ * ```typescript
+ * const content = `---
+ * title: My Document
+ * ---
+ * # Main Title
+ *
+ * ## First Section
+ * Content here
+ *
+ * ## Second Section
+ * More content
+ * `;
+ *
+ * const resource = parseMarkdown(content);
+ * console.log(resource.frontmatter.title); // "My Document"
+ * console.log(resource.fragments.length); // 2
+ * console.log(resource.fragments[0].slug); // "first-section"
+ * ```
+ */
+export declare function parseMarkdown(content: string): MarkdownResource;
+//# sourceMappingURL=markdown-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.d.ts","sourceRoot":"","sources":["../../src/compiler/markdown-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAerE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAY/D"}

package/dist/compiler/markdown-parser.js

@@ -0,0 +1,126 @@
+/**
+ * Markdown parser for extracting frontmatter and H2 fragments
+ */
+import matter from 'gray-matter';
+import slugifyModule from 'slugify';
+// Import slugify with type assertion to handle CJS module
+const slugifyFn = slugifyModule;
+/**
+ * Parse markdown file content into a MarkdownResource
+ *
+ * @param content - Raw markdown file content
+ * @returns Parsed resource with frontmatter and fragments
+ *
+ * @example
+ * ```typescript
+ * const content = `---
+ * title: My Document
+ * ---
+ * # Main Title
+ *
+ * ## First Section
+ * Content here
+ *
+ * ## Second Section
+ * More content
+ * `;
+ *
+ * const resource = parseMarkdown(content);
+ * console.log(resource.frontmatter.title); // "My Document"
+ * console.log(resource.fragments.length); // 2
+ * console.log(resource.fragments[0].slug); // "first-section"
+ * ```
+ */
+export function parseMarkdown(content) {
+    // Parse frontmatter
+    const { data: frontmatter, content: markdownContent } = matter(content);
+    // Extract H2 fragments
+    const fragments = extractH2Fragments(markdownContent);
+    return {
+        frontmatter,
+        content: markdownContent,
+        fragments,
+    };
+}
+/**
+ * Extract H2 heading fragments from markdown content
+ *
+ * @param content - Markdown content (without frontmatter)
+ * @returns Array of parsed fragments
+ */
+function extractH2Fragments(content) {
+    const fragments = [];
+    // Split by H2 headings (## at start of line)
+    const h2Regex = /^## (.+)$/gm;
+    const matches = [...content.matchAll(h2Regex)];
+    if (matches.length === 0) {
+        return [];
+    }
+    for (let i = 0; i < matches.length; i++) {
+        const match = matches[i];
+        if (!match || typeof match.index !== 'number') {
+            continue;
+        }
+        const heading = match[1]?.trim() ?? '';
+        const startIndex = match.index;
+        // Find content between this heading and next (or end of file)
+        const nextMatch = matches[i + 1];
+        const endIndex = nextMatch?.index ?? content.length;
+        // Extract the full text (header + body)
+        const text = content.slice(startIndex, endIndex).trim();
+        // Extract just the body (everything after the header line)
+        const headerEndIndex = content.indexOf('\n', startIndex);
+        const bodyStartIndex = headerEndIndex === -1 ? content.length : headerEndIndex + 1;
+        const body = content.slice(bodyStartIndex, endIndex).trim();
+        // Generate slug and camelCase name
+        const slug = generateSlug(heading);
+        const camelCase = slugToCamelCase(slug);
+        fragments.push({
+            heading,
+            slug,
+            camelCase,
+            header: `## ${heading}`,
+            body,
+            text,
+        });
+    }
+    return fragments;
+}
+/**
+ * Generate a URL-safe slug from heading text
+ *
+ * @param heading - Original heading text
+ * @returns Kebab-case slug
+ *
+ * @example
+ * ```typescript
+ * generateSlug("Purpose Driven")        // "purpose-driven"
+ * generateSlug("API v2.0")              // "api-v2-0"
+ * generateSlug("Hello, World!")         // "hello-world"
+ * generateSlug("  Spaces  Everywhere  ") // "spaces-everywhere"
+ * ```
+ */
+function generateSlug(heading) {
+    return slugifyFn(heading, {
+        lower: true,
+        strict: true,
+        trim: true,
+    });
+}
+/**
+ * Convert kebab-case slug to camelCase
+ *
+ * @param slug - Kebab-case slug
+ * @returns camelCase property name
+ *
+ * @example
+ * ```typescript
+ * slugToCamelCase("purpose-driven")  // "purposeDriven"
+ * slugToCamelCase("api-v2-0")        // "apiV20"
+ * slugToCamelCase("single")          // "single"
+ * ```
+ */
+function slugToCamelCase(slug) {
+    return slug.replaceAll(/-([a-z0-9])/g, (_, char) => char.toUpperCase());
+}
+//# sourceMappingURL=markdown-parser.js.map

package/dist/compiler/markdown-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.js","sourceRoot":"","sources":["../../src/compiler/markdown-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,aAAa,MAAM,SAAS,CAAC;AAIpC,0DAA0D;AAC1D,MAAM,SAAS,GAAG,aAUP,CAAC;AAEZ;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,oBAAoB;IACpB,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAExE,uBAAuB;IACvB,MAAM,SAAS,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAEtD,OAAO;QACL,WAAW;QACX,OAAO,EAAE,eAAe;QACxB,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,SAAS,GAAuB,EAAE,CAAC;IAEzC,6CAA6C;IAC7C,MAAM,OAAO,GAAG,aAAa,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAE/B,8DAA8D;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,EAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QAEpD,wCAAwC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAExD,2DAA2D;QAC3D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,cAAc,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC;QACnF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5D,mCAAmC;QACnC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAExC,SAAS,CAAC,IAAI,CAAC;YACb,OAAO;YACP,IAAI;YACJ,SAAS;YACT,MAAM,EAAE,MAAM,OAAO,EAAE;YACvB,IAAI;YACJ,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,SAAS,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC"}

package/dist/compiler/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Core types for the resource compiler
+ */
+/**
+ * Represents a parsed markdown resource with frontmatter and fragments
+ */
+export interface MarkdownResource {
+    /** Parsed YAML frontmatter as a key-value object */
+    frontmatter: Record<string, unknown>;
+    /** Full markdown content (excluding frontmatter) */
+    content: string;
+    /** Extracted H2 heading fragments */
+    fragments: MarkdownFragment[];
+}
+/**
+ * Represents a single H2 heading section in markdown
+ */
+export interface MarkdownFragment {
+    /** Original heading text (e.g., "Purpose Driven") */
+    heading: string;
+    /** Slugified heading (e.g., "purpose-driven") */
+    slug: string;
+    /** camelCase property name (e.g., "purposeDriven") */
+    camelCase: string;
+    /** Heading with markdown prefix (e.g., "## Purpose Driven") */
+    header: string;
+    /** Content below the heading (excluding the heading itself) */
+    body: string;
+    /** Full text (header + body) */
+    text: string;
+}
+/**
+ * Options for compiling markdown resources
+ */
+export interface CompileOptions {
+    /** Input directory containing markdown files */
+    inputDir: string;
+    /** Output directory for compiled JavaScript/TypeScript */
+    outputDir: string;
+    /** Enable watch mode for automatic recompilation */
+    watch?: boolean;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** File glob pattern (default: "**\/*.md") */
+    pattern?: string;
+}
+/**
+ * Result of parsing a single markdown file
+ */
+export interface ParseResult {
+    /** Path to the markdown file */
+    filePath: string;
+    /** Parsed resource */
+    resource: MarkdownResource;
+}
+/**
+ * Result of compiling a single markdown file
+ */
+export interface CompileResult {
+    /** Path to the original markdown file */
+    sourcePath: string;
+    /** Path to the generated JavaScript file */
+    jsPath: string;
+    /** Path to the generated TypeScript declaration file */
+    dtsPath: string;
+    /** Whether compilation succeeded */
+    success: boolean;
+    /** Error message if compilation failed */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compiler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/compiler/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for the resource compiler
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @vibe-agent-toolkit/resource-compiler
+ *
+ * Compile markdown resources to TypeScript with full IDE support
+ */
+export * from './compiler/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @vibe-agent-toolkit/resource-compiler
+ *
+ * Compile markdown resources to TypeScript with full IDE support
+ */
+export * from './compiler/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC"}

package/dist/language-service/completions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Enhance autocomplete with markdown fragment suggestions
+ */
+/**
+ * Enhance completion items with markdown fragment suggestions
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param prior - Original completion results from TypeScript
+ * @param fileName - File being edited
+ * @param position - Cursor position
+ * @returns Enhanced completion results, or original if no enhancements needed
+ */
+export declare function enhanceCompletions(ts: any, info: any, prior: any, fileName: string, position: number): any;
+/**
+ * Get detailed information for a completion entry
+ * Called when user hovers over a completion item
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param fileName - File being edited
+ * @param position - Cursor position
+ * @param entryName - Name of the completion entry
+ * @returns Detailed completion entry info, or undefined
+ */
+export declare function getCompletionEntryDetails(ts: any, info: any, fileName: string, position: number, entryName: string): any;
+//# sourceMappingURL=completions.d.ts.map

package/dist/language-service/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/language-service/completions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,GAAG,CA0CL;AAiDD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,GAAG,CAoDL"}

package/dist/language-service/completions.js

@@ -0,0 +1,147 @@
+/**
+ * Enhance autocomplete with markdown fragment suggestions
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types, max-depth, sonarjs/cognitive-complexity -- TypeScript Language Service plugin API requires any and complex AST traversal */
+import { getSourceFileAndNode, getMarkdownPathFromExpression, resolveAndLoadMarkdown, } from './utils.js';
+/**
+ * Enhance completion items with markdown fragment suggestions
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param prior - Original completion results from TypeScript
+ * @param fileName - File being edited
+ * @param position - Cursor position
+ * @returns Enhanced completion results, or original if no enhancements needed
+ */
+export function enhanceCompletions(ts, info, prior, fileName, position) {
+    // If no prior completions, return undefined
+    if (!prior) {
+        return undefined;
+    }
+    try {
+        // Get the source file and find the node at cursor
+        const context = getSourceFileAndNode(ts, info, fileName, position);
+        if (!context) {
+            return prior;
+        }
+        // Check if we're in a markdown fragment access context
+        // Look for patterns like: Core.fragments.<cursor>
+        let parent = context.node.parent;
+        while (parent) {
+            if (ts.isPropertyAccessExpression(parent)) {
+                const expressionInfo = getMarkdownPathFromExpression(ts, parent, context.sourceFile);
+                if (expressionInfo) {
+                    // Found markdown fragment access - add completions
+                    return addMarkdownFragmentCompletions(ts, info, prior, expressionInfo.markdownPath, fileName);
+                }
+            }
+            parent = parent.parent;
+        }
+        // Not in a markdown context - return original completions
+        return prior;
+    }
+    catch (error) {
+        // Log error and return original completions
+        info.project.projectService.logger.info(`markdown-import-plugin: Error enhancing completions: ${String(error)}`);
+        return prior;
+    }
+}
+/**
+ * Add markdown fragment completions to the completion list
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param prior - Original completion results
+ * @param markdownPath - Import path to markdown file
+ * @param containingFile - File containing the completion request
+ * @returns Enhanced completion results with markdown fragments
+ */
+function addMarkdownFragmentCompletions(ts, info, prior, markdownPath, containingFile) {
+    try {
+        // Resolve markdown path and load resource
+        const result = resolveAndLoadMarkdown(info, markdownPath, containingFile);
+        if (!result) {
+            return prior;
+        }
+        // Create completion entries for each fragment
+        const fragmentEntries = result.resource.fragments.map((fragment) => ({
+            name: fragment.camelCase,
+            kind: ts.ScriptElementKind.propertyElement,
+            sortText: '0', // Sort before other completions
+            insertText: fragment.camelCase,
+            kindModifiers: 'declare',
+        }));
+        // Merge with original completions
+        return {
+            ...prior,
+            entries: [...fragmentEntries, ...prior.entries],
+        };
+    }
+    catch (error) {
+        // Log error and return original completions
+        info.project.projectService.logger.info(`markdown-import-plugin: Error loading markdown for completions: ${String(error)}`);
+        return prior;
+    }
+}
+/**
+ * Get detailed information for a completion entry
+ * Called when user hovers over a completion item
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param fileName - File being edited
+ * @param position - Cursor position
+ * @param entryName - Name of the completion entry
+ * @returns Detailed completion entry info, or undefined
+ */
+export function getCompletionEntryDetails(ts, info, fileName, position, entryName) {
+    try {
+        // Get the source file and node
+        const context = getSourceFileAndNode(ts, info, fileName, position);
+        if (!context) {
+            return undefined;
+        }
+        // Find markdown context
+        let parent = context.node.parent;
+        while (parent) {
+            if (ts.isPropertyAccessExpression(parent)) {
+                const expressionInfo = getMarkdownPathFromExpression(ts, parent, context.sourceFile);
+                if (expressionInfo) {
+                    // Resolve and load the markdown file
+                    const result = resolveAndLoadMarkdown(info, expressionInfo.markdownPath, fileName);
+                    if (!result) {
+                        return undefined;
+                    }
+                    // Find the fragment matching this entry
+                    const fragment = result.resource.fragments.find((f) => f.camelCase === entryName);
+                    if (!fragment) {
+                        return undefined;
+                    }
+                    // Return detailed info with fragment heading
+                    return {
+                        name: entryName,
+                        kind: ts.ScriptElementKind.propertyElement,
+                        kindModifiers: 'declare',
+                        displayParts: [
+                            { text: 'fragment', kind: 'keyword' },
+                            { text: ' ', kind: 'space' },
+                            { text: entryName, kind: 'propertyName' },
+                        ],
+                        documentation: [
+                            {
+                                text: `Markdown fragment: ${fragment.heading}`,
+                                kind: 'text',
+                            },
+                        ],
+                    };
+                }
+            }
+            parent = parent.parent;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=completions.js.map

package/dist/language-service/completions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.js","sourceRoot":"","sources":["../../src/language-service/completions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oOAAoO;AAEpO,OAAO,EACL,oBAAoB,EACpB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAO,EACP,IAAS,EACT,KAAU,EACV,QAAgB,EAChB,QAAgB;IAEhB,4CAA4C;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,kDAAkD;QAClD,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uDAAuD;QACvD,kDAAkD;QAClD,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,OAAO,MAAM,EAAE,CAAC;YACd,IAAI,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,cAAc,GAAG,6BAA6B,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrF,IAAI,cAAc,EAAE,CAAC;oBACnB,mDAAmD;oBACnD,OAAO,8BAA8B,CACnC,EAAE,EACF,IAAI,EACJ,KAAK,EACL,cAAc,CAAC,YAAY,EAC3B,QAAQ,CACT,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,0DAA0D;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4CAA4C;QAC5C,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CACrC,wDAAwD,MAAM,CAAC,KAAK,CAAC,EAAE,CACxE,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,8BAA8B,CACrC,EAAO,EACP,IAAS,EACT,KAAU,EACV,YAAoB,EACpB,cAAsB;IAEtB,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8CAA8C;QAC9C,MAAM,eAAe,GAAU,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1E,IAAI,EAAE,QAAQ,CAAC,SAAS;YACxB,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe;YAC1C,QAAQ,EAAE,GAAG,EAAE,gCAAgC;YAC/C,UAAU,EAAE,QAAQ,CAAC,SAAS;YAC9B,aAAa,EAAE,SAAS;SACzB,CAAC,CAAC,CAAC;QAEJ,kCAAkC;QAClC,OAAO;YACL,GAAG,KAAK;YACR,OAAO,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;SAChD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4CAA4C;QAC5C,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CACrC,mEAAmE,MAAM,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,EAAO,EACP,IAAS,EACT,QAAgB,EAChB,QAAgB,EAChB,SAAiB;IAEjB,IAAI,CAAC;QACH,+BAA+B;QAC/B,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,wBAAwB;QACxB,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,OAAO,MAAM,EAAE,CAAC;YACd,IAAI,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,MAAM,cAAc,GAAG,6BAA6B,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrF,IAAI,cAAc,EAAE,CAAC;oBACnB,qCAAqC;oBACrC,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,EAAE,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;oBACnF,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,OAAO,SAAS,CAAC;oBACnB,CAAC;oBAED,wCAAwC;oBACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;oBAClF,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACd,OAAO,SAAS,CAAC;oBACnB,CAAC;oBAED,6CAA6C;oBAC7C,OAAO;wBACL,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe;wBAC1C,aAAa,EAAE,SAAS;wBACxB,YAAY,EAAE;4BACZ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;4BACrC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;4BAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE;yBAC1C;wBACD,aAAa,EAAE;4BACb;gCACE,IAAI,EAAE,sBAAsB,QAAQ,CAAC,OAAO,EAAE;gCAC9C,IAAI,EAAE,MAAM;6BACb;yBACF;qBACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/language-service/definitions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Enhance go-to-definition for markdown imports and fragments
+ */
+/**
+ * Enhance definition results with markdown file and fragment locations
+ *
+ * @param ts - TypeScript module
+ * @param info - Plugin create info
+ * @param fileName - File being edited
+ * @param position - Cursor position
+ * @returns Enhanced definition info, or original if no enhancements needed
+ */
+export declare function enhanceDefinitions(ts: any, info: any, fileName: string, position: number): readonly any[] | undefined;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/language-service/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/language-service/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,SAAS,GAAG,EAAE,GAAG,SAAS,CA4C5B"}