admanagekit-mcp-server 1.0.0

package/dist/tools/code-generation.js.map

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

package/dist/tools/documentation.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDocumentationTools(server: McpServer): void;

package/dist/tools/documentation.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDocumentationTools = registerDocumentationTools;
+const zod_1 = require("zod");
+const doc_loader_js_1 = require("../utils/doc-loader.js");
+const search_js_1 = require("../utils/search.js");
+const types_js_1 = require("../types.js");
+const topicKeys = Object.keys(types_js_1.TOPIC_MAP);
+function registerDocumentationTools(server) {
+    // Tool 1: search_docs
+    server.tool("search_docs", "Search across all AdManageKit documentation (docs/, wiki/, README) for a query. Returns matching sections with file paths and relevant snippets.", {
+        query: zod_1.z
+            .string()
+            .describe("Search query (e.g., 'collapsible banner', 'retry logic', 'HYBRID strategy')"),
+        max_results: zod_1.z
+            .number()
+            .optional()
+            .default(5)
+            .describe("Maximum number of matching sections to return (default: 5, max: 15)"),
+    }, async ({ query, max_results }) => {
+        const results = (0, search_js_1.searchDocs)(query, max_results);
+        if (results.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No results found for "${query}". Try different keywords or use list_documentation to see available topics.`,
+                    },
+                ],
+            };
+        }
+        const formatted = results
+            .map((r, i) => `### Result ${i + 1} (score: ${r.score})\n**File:** ${r.file}\n**Section:** ${r.heading}\n\n${r.content}`)
+            .join("\n\n---\n\n");
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Found ${results.length} results for "${query}":\n\n${formatted}`,
+                },
+            ],
+        };
+    });
+    // Tool 2: get_doc_by_topic
+    server.tool("get_doc_by_topic", "Get documentation for a specific AdManageKit topic. Topics include ad types (interstitial, native, banner, app-open, rewarded), features (loading-strategies, configuration, compose), and billing (billing-integration, subscriptions, etc.).", {
+        topic: zod_1.z
+            .enum(topicKeys)
+            .describe("The topic to retrieve documentation for"),
+    }, async ({ topic }) => {
+        const files = types_js_1.TOPIC_MAP[topic];
+        if (!files) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown topic "${topic}". Use list_documentation to see available topics.`,
+                    },
+                ],
+            };
+        }
+        const content = (0, doc_loader_js_1.loadTopicFiles)(files);
+        if (!content) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No documentation found for topic "${topic}". The documentation files may not exist yet.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: content }],
+        };
+    });
+    // Tool 3: get_api_reference
+    server.tool("get_api_reference", "Get the API reference for a specific AdManageKit class or component. Returns method signatures, parameters, and usage examples.", {
+        class_name: zod_1.z
+            .enum(types_js_1.API_CLASS_NAMES)
+            .describe("The class or component name to look up"),
+    }, async ({ class_name }) => {
+        const sections = (0, doc_loader_js_1.loadApiSections)();
+        const content = sections.get(class_name);
+        if (!content) {
+            // Try partial match
+            const partialMatch = Array.from(sections.entries()).find(([key]) => key.toLowerCase().includes(class_name.toLowerCase()));
+            if (partialMatch) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `### ${partialMatch[0]}\n\n${partialMatch[1]}`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No API reference found for "${class_name}". Available classes: ${Array.from(sections.keys()).join(", ")}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: `### ${class_name}\n\n${content}` }],
+        };
+    });
+    // Tool 4: get_release_notes
+    server.tool("get_release_notes", "Get release notes for a specific AdManageKit version. Returns new features, breaking changes, migration guides, and bug fixes.", {
+        version: zod_1.z
+            .enum(["latest", ...types_js_1.RELEASE_VERSIONS])
+            .describe("The version to get release notes for (e.g., '3.3.5', '3.0.0'). Use 'latest' for the most recent."),
+    }, async ({ version }) => {
+        const content = (0, doc_loader_js_1.loadReleaseNotes)(version);
+        if (!content) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No release notes found for version ${version}. Available versions: ${types_js_1.RELEASE_VERSIONS.join(", ")}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: content }],
+        };
+    });
+    // Tool 5: get_migration_guide
+    server.tool("get_migration_guide", "Get the migration guide for upgrading between AdManageKit versions. Covers breaking changes, deprecated APIs, and step-by-step migration instructions.", {
+        target_version: zod_1.z
+            .enum(types_js_1.MIGRATION_VERSIONS)
+            .describe("The version you are migrating TO (e.g., '3.0.0', '2.9.0')"),
+    }, async ({ target_version }) => {
+        const content = (0, doc_loader_js_1.loadMigrationGuide)(target_version);
+        if (!content) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No migration guide found for version ${target_version}. Migration guides are available for: ${types_js_1.MIGRATION_VERSIONS.join(", ")}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: "text", text: content }],
+        };
+    });
+    // Tool 6: list_documentation
+    server.tool("list_documentation", "List all available AdManageKit documentation topics, API references, release notes, and wiki pages.", {}, async () => {
+        const listing = `# AdManageKit Documentation
+
+## Ad Types
+- **interstitial** - Interstitial ad implementation and builder pattern
+- **native** - Native ad caching and display
+- **banner** - Banner ads with auto-refresh and collapsible support
+- **app-open** - Lifecycle-aware app open ads
+- **rewarded** - Rewarded video ads with reward tracking
+
+## Features
+- **loading-strategies** - ON_DEMAND, ONLY_CACHE, HYBRID, FRESH_WITH_CACHE_FALLBACK
+- **frequency-control** - Time-based and count-based ad frequency control
+- **configuration** - AdManageKitConfig settings reference
+- **compose** - Jetpack Compose integration
+- **interstitial-builder** - InterstitialAdBuilder fluent API
+- **native-template-view** - 27+ native ad templates
+- **native-preloading** - Preloading strategies for native ads
+- **native-caching** - NativeAdManager caching system
+- **banner-improvements** - Banner ad enhancements
+- **loading-strategy-examples** - Code examples for loading strategies
+
+## Billing
+- **billing-integration** - Google Play Billing setup and usage
+- **purchase-categories** - CONSUMABLE, FEATURE_UNLOCK, LIFETIME_PREMIUM, REMOVE_ADS
+- **consumables** - Consumable product handling
+- **subscriptions** - Subscription management
+- **subscription-upgrades** - Upgrade/downgrade flows
+
+## Other
+- **java-usage** - Java (non-Kotlin) usage guide
+
+## API Reference Classes
+${types_js_1.API_CLASS_NAMES.map((c) => `- ${c}`).join("\n")}
+
+## Release Notes
+${types_js_1.RELEASE_VERSIONS.map((v) => `- v${v}`).join("\n")}
+
+## Migration Guides
+${types_js_1.MIGRATION_VERSIONS.map((v) => `- Migrating to ${v}`).join("\n")}
+
+---
+Use \`get_doc_by_topic\`, \`get_api_reference\`, \`get_release_notes\`, or \`get_migration_guide\` to access specific documentation.
+Use \`search_docs\` to search across all documentation.`;
+        return {
+            content: [{ type: "text", text: listing }],
+        };
+    });
+}
+//# sourceMappingURL=documentation.js.map

package/dist/tools/documentation.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export type Language = "kotlin" | "java";
+export interface DocSection {
+    file: string;
+    heading: string;
+    content: string;
+    level: number;
+}
+export interface SearchResult {
+    file: string;
+    heading: string;
+    content: string;
+    score: number;
+}
+export declare const TOPIC_MAP: Record<string, string[]>;
+export declare const API_CLASS_NAMES: readonly ["AdManageKitConfig", "BillingConfig", "AdManager", "AppOpenManager", "BannerAdView", "NativeAdViews", "NativeAdManager", "RewardedAdManager", "AppPurchase", "PurchaseItem", "AdRetryManager", "AdDebugUtils", "AdLoadCallback", "AdManagerCallback", "InterstitialAdBuilder", "WeakReferenceHolder"];
+export declare const RELEASE_VERSIONS: readonly ["3.3.5", "3.3.4", "3.3.3", "3.3.2", "3.3.0", "3.1.0", "3.0.0", "2.9.0", "2.8.0", "2.7.0", "2.6.0", "2.5.0", "2.3.0", "2.2.0", "2.1.0"];
+export declare const MIGRATION_VERSIONS: readonly ["3.0.0", "2.9.0", "2.8.0", "2.7.0"];
+export declare const TEST_AD_UNITS: Record<string, string>;

package/dist/types.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEST_AD_UNITS = exports.MIGRATION_VERSIONS = exports.RELEASE_VERSIONS = exports.API_CLASS_NAMES = exports.TOPIC_MAP = void 0;
+exports.TOPIC_MAP = {
+    interstitial: [
+        "docs/interstitial-ads.md",
+        "docs/INTERSTITIAL_BUILDER_GUIDE.md",
+        "wiki/Interstitial-Ads.md",
+    ],
+    native: ["docs/native-ads-caching.md", "wiki/NativeAdManager.md"],
+    banner: ["docs/BANNER_AD_IMPROVEMENTS.md", "wiki/Banner-Ads.md"],
+    "app-open": ["docs/app-open-ads.md", "wiki/App-Open-Ads.md"],
+    rewarded: ["docs/rewarded-ads.md", "wiki/Rewarded-Ads.md"],
+    "loading-strategies": [
+        "docs/AD_LOADING_STRATEGIES.md",
+        "wiki/Ad-Loading-Strategies.md",
+    ],
+    "frequency-control": ["docs/AD_FREQUENCY_CONTROL.md"],
+    configuration: ["docs/CONFIGURATION_USAGE.md", "wiki/Configuration.md"],
+    compose: ["docs/COMPOSE_INTEGRATION.md", "wiki/Jetpack-Compose.md"],
+    "interstitial-builder": ["docs/INTERSTITIAL_BUILDER_GUIDE.md"],
+    "billing-integration": [
+        "docs/APP_PURCHASE_GUIDE.md",
+        "wiki/Billing-Integration.md",
+    ],
+    "purchase-categories": ["wiki/Purchase-Categories.md"],
+    consumables: ["wiki/Consumable-Products.md"],
+    subscriptions: ["wiki/Subscriptions.md"],
+    "subscription-upgrades": ["wiki/Subscription-Upgrades.md"],
+    "java-usage": ["docs/JAVA_USAGE_GUIDE.md"],
+    "native-template-view": ["docs/NATIVE_TEMPLATE_VIEW.md"],
+    "native-preloading": ["docs/NATIVE_AD_PRELOADING.md"],
+    "native-caching": [
+        "docs/native-ads-caching.md",
+        "docs/NATIVE_AD_MANAGER_ENHANCEMENTS.md",
+    ],
+    "banner-improvements": ["docs/BANNER_AD_IMPROVEMENTS.md"],
+    "loading-strategy-examples": ["docs/LOADING_STRATEGY_EXAMPLES.md"],
+};
+exports.API_CLASS_NAMES = [
+    "AdManageKitConfig",
+    "BillingConfig",
+    "AdManager",
+    "AppOpenManager",
+    "BannerAdView",
+    "NativeAdViews",
+    "NativeAdManager",
+    "RewardedAdManager",
+    "AppPurchase",
+    "PurchaseItem",
+    "AdRetryManager",
+    "AdDebugUtils",
+    "AdLoadCallback",
+    "AdManagerCallback",
+    "InterstitialAdBuilder",
+    "WeakReferenceHolder",
+];
+exports.RELEASE_VERSIONS = [
+    "3.3.5",
+    "3.3.4",
+    "3.3.3",
+    "3.3.2",
+    "3.3.0",
+    "3.1.0",
+    "3.0.0",
+    "2.9.0",
+    "2.8.0",
+    "2.7.0",
+    "2.6.0",
+    "2.5.0",
+    "2.3.0",
+    "2.2.0",
+    "2.1.0",
+];
+exports.MIGRATION_VERSIONS = ["3.0.0", "2.9.0", "2.8.0", "2.7.0"];
+exports.TEST_AD_UNITS = {
+    banner: "ca-app-pub-3940256099942544/6300978111",
+    interstitial: "ca-app-pub-3940256099942544/1033173712",
+    native: "ca-app-pub-3940256099942544/2247696110",
+    app_open: "ca-app-pub-3940256099942544/9257395921",
+    rewarded: "ca-app-pub-3940256099942544/5224354917",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAgBa,QAAA,SAAS,GAA6B;IACjD,YAAY,EAAE;QACZ,0BAA0B;QAC1B,oCAAoC;QACpC,0BAA0B;KAC3B;IACD,MAAM,EAAE,CAAC,4BAA4B,EAAE,yBAAyB,CAAC;IACjE,MAAM,EAAE,CAAC,gCAAgC,EAAE,oBAAoB,CAAC;IAChE,UAAU,EAAE,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IAC5D,QAAQ,EAAE,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IAC1D,oBAAoB,EAAE;QACpB,+BAA+B;QAC/B,+BAA+B;KAChC;IACD,mBAAmB,EAAE,CAAC,8BAA8B,CAAC;IACrD,aAAa,EAAE,CAAC,6BAA6B,EAAE,uBAAuB,CAAC;IACvE,OAAO,EAAE,CAAC,6BAA6B,EAAE,yBAAyB,CAAC;IACnE,sBAAsB,EAAE,CAAC,oCAAoC,CAAC;IAC9D,qBAAqB,EAAE;QACrB,4BAA4B;QAC5B,6BAA6B;KAC9B;IACD,qBAAqB,EAAE,CAAC,6BAA6B,CAAC;IACtD,WAAW,EAAE,CAAC,6BAA6B,CAAC;IAC5C,aAAa,EAAE,CAAC,uBAAuB,CAAC;IACxC,uBAAuB,EAAE,CAAC,+BAA+B,CAAC;IAC1D,YAAY,EAAE,CAAC,0BAA0B,CAAC;IAC1C,sBAAsB,EAAE,CAAC,8BAA8B,CAAC;IACxD,mBAAmB,EAAE,CAAC,8BAA8B,CAAC;IACrD,gBAAgB,EAAE;QAChB,4BAA4B;QAC5B,wCAAwC;KACzC;IACD,qBAAqB,EAAE,CAAC,gCAAgC,CAAC;IACzD,2BAA2B,EAAE,CAAC,mCAAmC,CAAC;CACnE,CAAC;AAEW,QAAA,eAAe,GAAG;IAC7B,mBAAmB;IACnB,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,mBAAmB;IACnB,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,mBAAmB;IACnB,uBAAuB;IACvB,qBAAqB;CACb,CAAC;AAEE,QAAA,gBAAgB,GAAG;IAC9B,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;CACC,CAAC;AAEE,QAAA,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAEnE,QAAA,aAAa,GAA2B;IACnD,MAAM,EAAE,wCAAwC;IAChD,YAAY,EAAE,wCAAwC;IACtD,MAAM,EAAE,wCAAwC;IAChD,QAAQ,EAAE,wCAAwC;IAClD,QAAQ,EAAE,wCAAwC;CACnD,CAAC"}

package/dist/utils/doc-loader.d.ts

@@ -0,0 +1,17 @@
+import { DocSection } from "../types.js";
+/**
+ * Resolves the root directory containing docs/, wiki/, and README.md.
+ *
+ * Search order:
+ * 1. ADMANAGEKIT_REPO_ROOT env var (explicit override)
+ * 2. Bundled content/ directory (npm package mode)
+ * 3. Repo root relative to dist/ (local dev in monorepo)
+ * 4. Current working directory
+ */
+export declare function getRepoRoot(): string;
+export declare function loadFile(relativePath: string): string;
+export declare function loadAllDocSections(): DocSection[];
+export declare function loadApiSections(): Map<string, string>;
+export declare function loadTopicFiles(files: string[]): string;
+export declare function loadReleaseNotes(version: string): string;
+export declare function loadMigrationGuide(version: string): string;

package/dist/utils/doc-loader.js

@@ -0,0 +1,245 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepoRoot = getRepoRoot;
+exports.loadFile = loadFile;
+exports.loadAllDocSections = loadAllDocSections;
+exports.loadApiSections = loadApiSections;
+exports.loadTopicFiles = loadTopicFiles;
+exports.loadReleaseNotes = loadReleaseNotes;
+exports.loadMigrationGuide = loadMigrationGuide;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+let resolvedRoot = null;
+let docSections = null;
+let apiSections = null;
+/**
+ * Resolves the root directory containing docs/, wiki/, and README.md.
+ *
+ * Search order:
+ * 1. ADMANAGEKIT_REPO_ROOT env var (explicit override)
+ * 2. Bundled content/ directory (npm package mode)
+ * 3. Repo root relative to dist/ (local dev in monorepo)
+ * 4. Current working directory
+ */
+function getRepoRoot() {
+    if (resolvedRoot)
+        return resolvedRoot;
+    const candidates = [];
+    // 1. Environment variable override
+    if (process.env.ADMANAGEKIT_REPO_ROOT) {
+        candidates.push(process.env.ADMANAGEKIT_REPO_ROOT);
+    }
+    // 2. Bundled content/ dir (when installed as npm package)
+    //    Located at: <package>/dist/utils/ -> <package>/content/
+    candidates.push(path.resolve(__dirname, "..", "..", "content"));
+    // 3. Repo root relative to mcp-server/dist/utils/
+    candidates.push(path.resolve(__dirname, "..", "..", ".."));
+    // 4. Current working directory (when run from repo root)
+    candidates.push(process.cwd());
+    // 5. Parent of cwd (when run from mcp-server/)
+    candidates.push(path.resolve(process.cwd(), ".."));
+    for (const candidate of candidates) {
+        if (fs.existsSync(path.join(candidate, "docs", "API_REFERENCE.md")) ||
+            fs.existsSync(path.join(candidate, "README.md"))) {
+            resolvedRoot = candidate;
+            return resolvedRoot;
+        }
+    }
+    throw new Error("Could not find AdManageKit documentation. " +
+        "Set ADMANAGEKIT_REPO_ROOT environment variable or ensure the package was built with `npm run build`.");
+}
+function loadFile(relativePath) {
+    try {
+        const fullPath = path.join(getRepoRoot(), relativePath);
+        return fs.readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+function parseMarkdownSections(content, filePath) {
+    const sections = [];
+    const lines = content.split("\n");
+    let currentHeading = "";
+    let currentLevel = 0;
+    let currentContent = [];
+    for (const line of lines) {
+        const headingMatch = line.match(/^(#{1,4})\s+(.+)$/);
+        if (headingMatch) {
+            if (currentHeading || currentContent.length > 0) {
+                sections.push({
+                    file: filePath,
+                    heading: currentHeading || "(intro)",
+                    content: currentContent.join("\n").trim(),
+                    level: currentLevel,
+                });
+            }
+            currentLevel = headingMatch[1].length;
+            currentHeading = headingMatch[2];
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    if (currentHeading || currentContent.length > 0) {
+        sections.push({
+            file: filePath,
+            heading: currentHeading || "(intro)",
+            content: currentContent.join("\n").trim(),
+            level: currentLevel,
+        });
+    }
+    return sections;
+}
+function discoverFiles(dir, basePath) {
+    const results = [];
+    try {
+        const entries = fs.readdirSync(path.join(getRepoRoot(), dir), {
+            withFileTypes: true,
+        });
+        for (const entry of entries) {
+            const relPath = path.join(basePath, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...discoverFiles(path.join(dir, entry.name), relPath));
+            }
+            else if (entry.name.endsWith(".md")) {
+                results.push(relPath);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    return results;
+}
+function loadAllDocSections() {
+    if (docSections)
+        return docSections;
+    const filePaths = [];
+    filePaths.push("README.md");
+    filePaths.push(...discoverFiles("docs", "docs"));
+    filePaths.push(...discoverFiles("wiki", "wiki"));
+    docSections = [];
+    for (const filePath of filePaths) {
+        const content = loadFile(filePath);
+        if (content) {
+            docSections.push(...parseMarkdownSections(content, filePath));
+        }
+    }
+    return docSections;
+}
+function loadApiSections() {
+    if (apiSections)
+        return apiSections;
+    apiSections = new Map();
+    const content = loadFile("docs/API_REFERENCE.md");
+    if (!content)
+        return apiSections;
+    const lines = content.split("\n");
+    let currentClass = "";
+    let currentContent = [];
+    for (const line of lines) {
+        const h3Match = line.match(/^###\s+(.+)$/);
+        if (h3Match) {
+            if (currentClass) {
+                apiSections.set(normalizeClassName(currentClass), currentContent.join("\n").trim());
+            }
+            currentClass = h3Match[1];
+            currentContent = [line];
+        }
+        else if (currentClass) {
+            if (line.match(/^##\s+/)) {
+                apiSections.set(normalizeClassName(currentClass), currentContent.join("\n").trim());
+                currentClass = "";
+                currentContent = [];
+            }
+            else {
+                currentContent.push(line);
+            }
+        }
+    }
+    if (currentClass) {
+        apiSections.set(normalizeClassName(currentClass), currentContent.join("\n").trim());
+    }
+    return apiSections;
+}
+function normalizeClassName(name) {
+    return name.replace(/[`()]/g, "").trim().split(/\s+/)[0];
+}
+function loadTopicFiles(files) {
+    const parts = [];
+    for (const file of files) {
+        const content = loadFile(file);
+        if (content) {
+            parts.push(`--- ${file} ---\n\n${content}`);
+        }
+    }
+    return parts.join("\n\n");
+}
+function loadReleaseNotes(version) {
+    if (version === "latest") {
+        version = "3.3.5";
+    }
+    return loadFile(`docs/release-notes/RELEASE_NOTES_v${version}.md`);
+}
+function loadMigrationGuide(version) {
+    const readme = loadFile("README.md");
+    if (!readme)
+        return "";
+    const marker = `### Migrating to ${version}`;
+    const startIdx = readme.indexOf(marker);
+    if (startIdx === -1)
+        return "";
+    const rest = readme.slice(startIdx);
+    const lines = rest.split("\n");
+    const result = [lines[0]];
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].match(/^###\s+Migrating to/) ||
+            lines[i].match(/^---$/) ||
+            lines[i].match(/^##\s+/)) {
+            break;
+        }
+        result.push(lines[i]);
+    }
+    const releaseNotes = loadReleaseNotes(version);
+    if (releaseNotes) {
+        return (result.join("\n").trim() +
+            `\n\n--- Release Notes v${version} ---\n\n${releaseNotes}`);
+    }
+    return result.join("\n").trim();
+}
+//# sourceMappingURL=doc-loader.js.map

package/dist/utils/doc-loader.js.map

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

package/dist/utils/search.d.ts

@@ -0,0 +1,2 @@
+import { SearchResult } from "../types.js";
+export declare function searchDocs(query: string, maxResults?: number): SearchResult[];