@fernforestgames/mcp-server-godot-docs 0.1.0

package/dist/docs/parser.js

@@ -0,0 +1,206 @@
+// Parse Godot XML documentation into TypeScript types
+import * as fs from 'fs';
+import { XMLParser } from 'fast-xml-parser';
+// Configure XML parser to preserve attributes
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    textNodeName: '#text',
+    isArray: (name) => {
+        // These elements can appear multiple times
+        return ['method', 'member', 'signal', 'constant', 'param', 'theme_item', 'link'].includes(name);
+    },
+});
+/**
+ * Parse a single Godot XML documentation file
+ */
+export function parseClassXml(xmlPath) {
+    try {
+        const xml = fs.readFileSync(xmlPath, 'utf-8');
+        const parsed = parser.parse(xml);
+        const classData = parsed.class;
+        if (!classData) {
+            return null;
+        }
+        return {
+            name: classData['@_name'] || '',
+            inherits: classData['@_inherits'] || undefined,
+            brief: extractText(classData.brief_description),
+            description: extractText(classData.description),
+            keywords: classData['@_keywords']?.split(',').map((k) => k.trim()) || [],
+            tutorials: parseTutorials(classData.tutorials),
+            methods: parseMethods(classData.methods),
+            properties: parseMembers(classData.members),
+            signals: parseSignals(classData.signals),
+            constants: parseConstants(classData.constants),
+            themeItems: parseThemeItems(classData.theme_items),
+        };
+    }
+    catch (error) {
+        console.error(`Failed to parse ${xmlPath}:`, error);
+        return null;
+    }
+}
+/**
+ * Extract text content from an element (handles both string and object with #text)
+ */
+function extractText(element) {
+    if (!element)
+        return '';
+    if (typeof element === 'string')
+        return element.trim();
+    if (typeof element === 'object' && element !== null && '#text' in element) {
+        return String(element['#text']).trim();
+    }
+    return '';
+}
+/**
+ * Parse tutorials section
+ */
+function parseTutorials(tutorials) {
+    if (!tutorials)
+        return [];
+    const links = tutorials['link'];
+    if (!links)
+        return [];
+    const linksArray = Array.isArray(links) ? links : [links];
+    return linksArray.map((link) => {
+        if (typeof link === 'string') {
+            return { title: '', link };
+        }
+        const linkObj = link;
+        return {
+            title: String(linkObj['@_title'] || ''),
+            link: extractText(linkObj) || String(linkObj['#text'] || ''),
+        };
+    });
+}
+/**
+ * Parse methods section
+ */
+function parseMethods(methods) {
+    if (!methods)
+        return [];
+    const methodList = methods['method'];
+    if (!methodList)
+        return [];
+    const methodsArray = Array.isArray(methodList) ? methodList : [methodList];
+    return methodsArray.map((method) => {
+        const m = method;
+        return {
+            name: String(m['@_name'] || ''),
+            returnType: parseReturnType(m['return']),
+            params: parseParams(m['param']),
+            description: extractText(m['description']),
+            qualifiers: m['@_qualifiers'] ? String(m['@_qualifiers']) : undefined,
+        };
+    });
+}
+/**
+ * Parse return type
+ */
+function parseReturnType(ret) {
+    if (!ret)
+        return 'void';
+    const r = ret;
+    return String(r['@_type'] || 'void');
+}
+/**
+ * Parse method/signal parameters
+ */
+function parseParams(params) {
+    if (!params)
+        return [];
+    const paramsArray = Array.isArray(params) ? params : [params];
+    return paramsArray.map((param) => {
+        const p = param;
+        return {
+            name: String(p['@_name'] || ''),
+            type: String(p['@_type'] || 'Variant'),
+            default: p['@_default'] ? String(p['@_default']) : undefined,
+        };
+    });
+}
+/**
+ * Parse members (properties) section
+ */
+function parseMembers(members) {
+    if (!members)
+        return [];
+    const memberList = members['member'];
+    if (!memberList)
+        return [];
+    const membersArray = Array.isArray(memberList) ? memberList : [memberList];
+    return membersArray.map((member) => {
+        const m = member;
+        return {
+            name: String(m['@_name'] || ''),
+            type: String(m['@_type'] || 'Variant'),
+            default: m['@_default'] ? String(m['@_default']) : undefined,
+            setter: m['@_setter'] ? String(m['@_setter']) : undefined,
+            getter: m['@_getter'] ? String(m['@_getter']) : undefined,
+            description: extractText(m),
+        };
+    });
+}
+/**
+ * Parse signals section
+ */
+function parseSignals(signals) {
+    if (!signals)
+        return [];
+    const signalList = signals['signal'];
+    if (!signalList)
+        return [];
+    const signalsArray = Array.isArray(signalList) ? signalList : [signalList];
+    return signalsArray.map((signal) => {
+        const s = signal;
+        return {
+            name: String(s['@_name'] || ''),
+            params: parseParams(s['param']),
+            description: extractText(s['description']),
+        };
+    });
+}
+/**
+ * Parse constants section
+ */
+function parseConstants(constants) {
+    if (!constants)
+        return [];
+    const constantList = constants['constant'];
+    if (!constantList)
+        return [];
+    const constantsArray = Array.isArray(constantList) ? constantList : [constantList];
+    return constantsArray.map((constant) => {
+        const c = constant;
+        return {
+            name: String(c['@_name'] || ''),
+            value: String(c['@_value'] || '0'),
+            enum: c['@_enum'] ? String(c['@_enum']) : undefined,
+            description: extractText(c),
+        };
+    });
+}
+/**
+ * Parse theme items section
+ */
+function parseThemeItems(themeItems) {
+    if (!themeItems)
+        return [];
+    const itemList = themeItems['theme_item'];
+    if (!itemList)
+        return [];
+    const itemsArray = Array.isArray(itemList) ? itemList : [itemList];
+    return itemsArray.map((item) => {
+        const t = item;
+        return {
+            name: String(t['@_name'] || ''),
+            type: String(t['@_data_type'] || t['@_type'] || 'unknown'),
+            dataType: t['@_data_type'] ? String(t['@_data_type']) : undefined,
+            default: t['@_default'] ? String(t['@_default']) : undefined,
+            description: extractText(t),
+        };
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/docs/parser.js.map

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

package/dist/docs/search.d.ts

@@ -0,0 +1,14 @@
+import type { SearchMatch } from './types.js';
+/**
+ * Search the documentation index
+ *
+ * Searches across:
+ * - Class names
+ * - Method names
+ * - Property names
+ * - Signal names
+ * - Constant names
+ * - Descriptions (lower priority)
+ */
+export declare function searchDocs(query: string, limit?: number): Promise<SearchMatch[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/docs/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/docs/search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,YAAY,CAAC;AAG1D;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA4F1F"}

package/dist/docs/search.js

@@ -0,0 +1,195 @@
+import { docsIndex } from './index.js';
+/**
+ * Search the documentation index
+ *
+ * Searches across:
+ * - Class names
+ * - Method names
+ * - Property names
+ * - Signal names
+ * - Constant names
+ * - Descriptions (lower priority)
+ */
+export async function searchDocs(query, limit = 10) {
+    await docsIndex.ensureInitialized();
+    const queryLower = query.toLowerCase();
+    const results = [];
+    for (const godotClass of docsIndex.getAllClasses()) {
+        // Search class name
+        const classScore = scoreMatch(godotClass.name, queryLower);
+        if (classScore > 0) {
+            results.push({
+                className: godotClass.name,
+                matchType: 'class',
+                name: godotClass.name,
+                excerpt: godotClass.brief || godotClass.description.slice(0, 200),
+                score: classScore * 10, // Boost class matches
+            });
+        }
+        // Search methods
+        for (const method of godotClass.methods) {
+            const methodScore = scoreMatch(method.name, queryLower);
+            if (methodScore > 0) {
+                results.push({
+                    className: godotClass.name,
+                    matchType: 'method',
+                    name: method.name,
+                    excerpt: formatMethodSignature(method) + (method.description ? '\n' + method.description.slice(0, 150) : ''),
+                    score: methodScore * 5,
+                });
+            }
+        }
+        // Search properties
+        for (const prop of godotClass.properties) {
+            const propScore = scoreMatch(prop.name, queryLower);
+            if (propScore > 0) {
+                results.push({
+                    className: godotClass.name,
+                    matchType: 'property',
+                    name: prop.name,
+                    excerpt: `${prop.type} ${prop.name}` + (prop.description ? '\n' + prop.description.slice(0, 150) : ''),
+                    score: propScore * 5,
+                });
+            }
+        }
+        // Search signals
+        for (const signal of godotClass.signals) {
+            const signalScore = scoreMatch(signal.name, queryLower);
+            if (signalScore > 0) {
+                results.push({
+                    className: godotClass.name,
+                    matchType: 'signal',
+                    name: signal.name,
+                    excerpt: formatSignalSignature(signal) + (signal.description ? '\n' + signal.description.slice(0, 150) : ''),
+                    score: signalScore * 5,
+                });
+            }
+        }
+        // Search constants
+        for (const constant of godotClass.constants) {
+            const constScore = scoreMatch(constant.name, queryLower);
+            if (constScore > 0) {
+                results.push({
+                    className: godotClass.name,
+                    matchType: 'constant',
+                    name: constant.name,
+                    excerpt: `${constant.name} = ${constant.value}` + (constant.enum ? ` (${constant.enum})` : '') + (constant.description ? '\n' + constant.description.slice(0, 150) : ''),
+                    score: constScore * 3,
+                });
+            }
+        }
+        // Also search descriptions (lower priority)
+        const descScore = scoreDescriptionMatch(godotClass, queryLower);
+        if (descScore > 0 && classScore === 0) {
+            // Only add if not already matched by name
+            results.push({
+                className: godotClass.name,
+                matchType: 'class',
+                name: godotClass.name,
+                excerpt: extractRelevantExcerpt(godotClass.description, query),
+                score: descScore,
+            });
+        }
+    }
+    // Sort by score (highest first) and limit
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, limit);
+}
+/**
+ * Score a match between a name and query
+ * Returns 0 for no match, higher for better matches
+ */
+function scoreMatch(name, queryLower) {
+    const nameLower = name.toLowerCase();
+    // Exact match
+    if (nameLower === queryLower) {
+        return 100;
+    }
+    // Starts with query
+    if (nameLower.startsWith(queryLower)) {
+        return 80;
+    }
+    // Contains query
+    if (nameLower.includes(queryLower)) {
+        return 60;
+    }
+    // Query contains name (e.g., searching "RigidBody3D move" matches "move")
+    if (queryLower.includes(nameLower) && nameLower.length > 3) {
+        return 40;
+    }
+    // Word boundary match (e.g., "move" matches "move_and_slide")
+    const words = nameLower.split(/[_\s]+/);
+    for (const word of words) {
+        if (word === queryLower) {
+            return 70;
+        }
+        if (word.startsWith(queryLower)) {
+            return 50;
+        }
+    }
+    return 0;
+}
+/**
+ * Score description matches
+ */
+function scoreDescriptionMatch(godotClass, queryLower) {
+    const desc = (godotClass.brief + ' ' + godotClass.description).toLowerCase();
+    // Check if query appears in description
+    if (desc.includes(queryLower)) {
+        // Bonus for multiple occurrences
+        const count = (desc.match(new RegExp(escapeRegExp(queryLower), 'g')) || []).length;
+        return Math.min(20 + count * 5, 40);
+    }
+    return 0;
+}
+/**
+ * Extract a relevant excerpt from description containing the query
+ */
+function extractRelevantExcerpt(description, query) {
+    const queryLower = query.toLowerCase();
+    const descLower = description.toLowerCase();
+    const index = descLower.indexOf(queryLower);
+    if (index === -1) {
+        return description.slice(0, 200);
+    }
+    // Get context around the match
+    const start = Math.max(0, index - 50);
+    const end = Math.min(description.length, index + query.length + 150);
+    let excerpt = description.slice(start, end);
+    if (start > 0)
+        excerpt = '...' + excerpt;
+    if (end < description.length)
+        excerpt = excerpt + '...';
+    return excerpt;
+}
+/**
+ * Format method signature for display
+ */
+function formatMethodSignature(method) {
+    const params = method.params.map(p => {
+        let param = `${p.name}: ${p.type}`;
+        if (p.default !== undefined) {
+            param += ` = ${p.default}`;
+        }
+        return param;
+    }).join(', ');
+    let sig = `${method.returnType} ${method.name}(${params})`;
+    if (method.qualifiers) {
+        sig += ` [${method.qualifiers}]`;
+    }
+    return sig;
+}
+/**
+ * Format signal signature for display
+ */
+function formatSignalSignature(signal) {
+    const params = signal.params.map(p => `${p.name}: ${p.type}`).join(', ');
+    return `signal ${signal.name}(${params})`;
+}
+/**
+ * Escape special regex characters
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=search.js.map

package/dist/docs/search.js.map

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

package/dist/docs/types.d.ts

@@ -0,0 +1,62 @@
+export interface GodotMethodParam {
+    name: string;
+    type: string;
+    default?: string;
+}
+export interface GodotMethod {
+    name: string;
+    returnType: string;
+    params: GodotMethodParam[];
+    description: string;
+    qualifiers?: string;
+}
+export interface GodotProperty {
+    name: string;
+    type: string;
+    default?: string;
+    setter?: string;
+    getter?: string;
+    description: string;
+}
+export interface GodotSignal {
+    name: string;
+    params: GodotMethodParam[];
+    description: string;
+}
+export interface GodotConstant {
+    name: string;
+    value: string;
+    enum?: string;
+    description: string;
+}
+export interface GodotThemeItem {
+    name: string;
+    type: string;
+    dataType?: string;
+    default?: string;
+    description: string;
+}
+export interface GodotClass {
+    name: string;
+    inherits?: string;
+    brief: string;
+    description: string;
+    keywords?: string[];
+    tutorials: {
+        title: string;
+        link: string;
+    }[];
+    methods: GodotMethod[];
+    properties: GodotProperty[];
+    signals: GodotSignal[];
+    constants: GodotConstant[];
+    themeItems: GodotThemeItem[];
+}
+export interface SearchMatch {
+    className: string;
+    matchType: 'class' | 'method' | 'property' | 'signal' | 'constant';
+    name: string;
+    excerpt: string;
+    score: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAGD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/docs/types.js

@@ -0,0 +1,3 @@
+// Type definitions for parsed Godot XML documentation
+export {};
+//# sourceMappingURL=types.js.map

package/dist/docs/types.js.map

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

package/dist/docs/version.d.ts

@@ -0,0 +1,25 @@
+export interface GodotVersionInfo {
+    major: number;
+    minor: number;
+    patch: number;
+    status: string;
+    full: string;
+}
+/**
+ * Get the Godot version from the executable
+ */
+export declare function getGodotVersion(): GodotVersionInfo;
+/**
+ * Map a Godot version to a GitHub ref (tag or branch)
+ *
+ * Stable versions: Use the exact tag (e.g., "4.5.1-stable")
+ * Dev/master builds: "master" branch
+ *
+ * Tags are preferred because they're immutable and match the exact version.
+ */
+export declare function versionToGitRef(version: GodotVersionInfo): string;
+/**
+ * Get a cache-safe version string (used for cache directory naming)
+ */
+export declare function versionToCacheKey(version: GodotVersionInfo): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/docs/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/docs/version.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CA0ClD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAYjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAMnE"}

package/dist/docs/version.js

@@ -0,0 +1,76 @@
+// Detect Godot version and map to GitHub ref
+import { execSync } from 'child_process';
+import { godotPath } from '../config.js';
+/**
+ * Get the Godot version from the executable
+ */
+export function getGodotVersion() {
+    try {
+        const output = execSync(`"${godotPath}" --version`, {
+            encoding: 'utf-8',
+            timeout: 10000,
+        }).trim();
+        // Godot version format: "4.3.stable.official.77dcf97d8"
+        // or "4.3.1.stable.official.77dcf97d8"
+        const parts = output.split('.');
+        const major = parseInt(parts[0] || '4', 10) || 4;
+        const minor = parseInt(parts[1] || '0', 10) || 0;
+        // Check if third part is a number (patch) or status
+        let patch = 0;
+        let statusIndex = 2;
+        if (parts[2] && /^\d+$/.test(parts[2])) {
+            patch = parseInt(parts[2], 10);
+            statusIndex = 3;
+        }
+        const status = parts[statusIndex] || 'stable';
+        return {
+            major,
+            minor,
+            patch,
+            status,
+            full: output,
+        };
+    }
+    catch (error) {
+        console.error('Failed to get Godot version:', error);
+        // Default to latest stable if we can't detect
+        return {
+            major: 4,
+            minor: 3,
+            patch: 0,
+            status: 'stable',
+            full: '4.3.stable',
+        };
+    }
+}
+/**
+ * Map a Godot version to a GitHub ref (tag or branch)
+ *
+ * Stable versions: Use the exact tag (e.g., "4.5.1-stable")
+ * Dev/master builds: "master" branch
+ *
+ * Tags are preferred because they're immutable and match the exact version.
+ */
+export function versionToGitRef(version) {
+    // Dev, alpha, beta, rc builds use master
+    if (version.status !== 'stable') {
+        return 'master';
+    }
+    // Stable versions use the exact tag: X.Y.Z-stable
+    // For X.Y.0 releases, Godot uses "X.Y-stable" not "X.Y.0-stable"
+    if (version.patch === 0) {
+        return `${version.major}.${version.minor}-stable`;
+    }
+    return `${version.major}.${version.minor}.${version.patch}-stable`;
+}
+/**
+ * Get a cache-safe version string (used for cache directory naming)
+ */
+export function versionToCacheKey(version) {
+    if (version.status !== 'stable') {
+        // For non-stable, include more version info to differentiate
+        return `${version.major}.${version.minor}.${version.patch}-${version.status}`;
+    }
+    return `${version.major}.${version.minor}-stable`;
+}
+//# sourceMappingURL=version.js.map

package/dist/docs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/docs/version.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,SAAS,aAAa,EAAE;YAClD,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,wDAAwD;QACxD,uCAAuC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAEjD,oDAAoD;QACpD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,WAAW,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC;QAE9C,OAAO;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,MAAM;YACN,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACrD,8CAA8C;QAC9C,OAAO;YACL,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,YAAY;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,yCAAyC;IACzC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,kDAAkD;IAClD,iEAAiE;IACjE,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,SAAS,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,SAAS,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,6DAA6D;QAC7D,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,SAAS,CAAC;AACpD,CAAC"}

package/dist/handlers/tools/get-class.d.ts

@@ -0,0 +1,9 @@
+export declare function getGodotClass({ className, }: {
+    className: string;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=get-class.d.ts.map

package/dist/handlers/tools/get-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-class.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/get-class.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,CAAC,EAClC,SAAS,GACV,EAAE;IACD,SAAS,EAAE,MAAM,CAAC;CACnB;;;;;GAqDA"}