purecontext-mcp 1.0.1

package/dist/adapters/symfony.js

@@ -0,0 +1,242 @@
+/**
+ * Symfony framework adapter.
+ *
+ * Extracts route and controller symbols from Symfony PHP applications.
+ *
+ * Patterns recognised:
+ *   #[Route('/users', methods: ['GET', 'POST'])]   → route per method (PHP 8+ attribute)
+ *   @Route("/users", methods={"GET"})              → route (older docblock annotation)
+ *   class UserController extends AbstractController → class (symfony_controller)
+ *   #[AsController] class AdminController          → class (symfony_controller)
+ *
+ * Out of scope (Phase 5): YAML/XML route config, ORM entity extraction.
+ */
+import { createHash } from 'crypto';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// ─── Route extraction ─────────────────────────────────────────────────────────
+/**
+ * Extract HTTP methods from the content inside a Route attribute or annotation.
+ *
+ * Handles:
+ *   methods: ['GET', 'POST']       (PHP attribute named arg)
+ *   methods={"GET", "POST"}        (Doctrine annotation style)
+ */
+function extractHttpMethods(inner) {
+    // PHP attribute style: methods: ['GET', 'POST']
+    const attrMatch = inner.match(/methods\s*:\s*\[([^\]]*)\]/);
+    // Doctrine annotation style: methods={"GET"}
+    const annMatch = inner.match(/methods\s*=\s*\{([^}]*)\}/);
+    const raw = attrMatch?.[1] ?? annMatch?.[1] ?? '';
+    if (!raw.trim())
+        return [];
+    const found = raw.match(/['"]([A-Z]+)['"]/gi) ?? [];
+    return found.map((s) => s.replace(/['"]/g, '').toUpperCase());
+}
+/**
+ * Emit one SymbolRecord per HTTP method (or a single method-agnostic route if
+ * no methods are specified).
+ */
+function emitRouteSymbols(filePath, routePath, methods, signature) {
+    if (methods.length === 0) {
+        const name = routePath;
+        return [
+            {
+                id: makeId(filePath, name, 'route'),
+                name,
+                kind: 'route',
+                filePath,
+                startByte: 0,
+                endByte: 0,
+                signature,
+                summary: `Symfony route: ${name}`,
+                frameworkMeta: {
+                    symfony_route: true,
+                    route_path: routePath,
+                },
+            },
+        ];
+    }
+    return methods.map((httpMethod) => {
+        const name = `${httpMethod} ${routePath}`;
+        return {
+            id: makeId(filePath, name, 'route'),
+            name,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature,
+            summary: `Symfony route: ${name}`,
+            frameworkMeta: {
+                symfony_route: true,
+                route_path: routePath,
+                http_method: httpMethod,
+            },
+        };
+    });
+}
+/**
+ * `#[Route('/path', name: 'foo', methods: ['GET'])]`
+ *
+ * The inner content after the path argument may span multiple lines so we use
+ * a multiline-aware scan with brace/bracket depth tracking.
+ */
+function extractAttributeRoutes(sourceStr, filePath) {
+    const symbols = [];
+    // Match opening of a Route PHP attribute: #[Route(
+    const OPEN_RE = /#\[Route\s*\(/gi;
+    let m;
+    OPEN_RE.lastIndex = 0;
+    while ((m = OPEN_RE.exec(sourceStr)) !== null) {
+        const contentStart = m.index + m[0].length;
+        // Find the matching closing ')' using depth tracking
+        let depth = 1;
+        let i = contentStart;
+        while (i < sourceStr.length && depth > 0) {
+            const ch = sourceStr[i];
+            if (ch === '(' || ch === '[')
+                depth++;
+            else if (ch === ')' || ch === ']')
+                depth--;
+            i++;
+        }
+        if (depth !== 0)
+            continue;
+        const inner = sourceStr.slice(contentStart, i - 1);
+        // Extract the path — first quoted string argument
+        const pathMatch = inner.match(/^\s*['"]([^'"]*)['"]/);
+        if (!pathMatch)
+            continue;
+        const routePath = pathMatch[1];
+        const methods = extractHttpMethods(inner);
+        const sig = `#[Route('${routePath}'${methods.length ? `, methods: [${methods.map((x) => `'${x}'`).join(', ')}]` : ''})]`;
+        symbols.push(...emitRouteSymbols(filePath, routePath, methods, sig));
+    }
+    return symbols;
+}
+/**
+ * `@Route("/path", methods={"GET"})` inside `/** ... *\/` docblocks.
+ */
+function extractAnnotationRoutes(sourceStr, filePath) {
+    const symbols = [];
+    // Find /** ... */ comment blocks
+    const DOCBLOCK_RE = /\/\*\*([\s\S]*?)\*\//g;
+    let dm;
+    DOCBLOCK_RE.lastIndex = 0;
+    while ((dm = DOCBLOCK_RE.exec(sourceStr)) !== null) {
+        const docContent = dm[1];
+        // Find @Route annotations inside the docblock
+        const ANNOT_RE = /@Route\s*\(\s*["']([^"']+)["']([\s\S]*?)\)/g;
+        let am;
+        ANNOT_RE.lastIndex = 0;
+        while ((am = ANNOT_RE.exec(docContent)) !== null) {
+            const routePath = am[1];
+            const inner = am[2] ?? '';
+            const methods = extractHttpMethods(inner);
+            const sig = `@Route("${routePath}"${methods.length ? `, methods={"${methods.join('", "')}"}` : ''})`;
+            symbols.push(...emitRouteSymbols(filePath, routePath, methods, sig));
+        }
+    }
+    return symbols;
+}
+// ─── Controller detection ─────────────────────────────────────────────────────
+/** Detect `#[AsController]` attribute immediately preceding a class declaration. */
+const AS_CONTROLLER_ATTR_RE = /#\[AsController\b[^\]]*\][\s\n]*class\s+(\w+)/g;
+/** Class header regex to find classes with extends. */
+const CLASS_HEADER_RE = /class\s+(\w+)(?:\s+extends\s+([\w\\]+))?(?:\s+implements\s+[^{]*)?\s*\{/g;
+function extractControllers(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // #[AsController] classes
+    AS_CONTROLLER_ATTR_RE.lastIndex = 0;
+    let m;
+    while ((m = AS_CONTROLLER_ATTR_RE.exec(sourceStr)) !== null) {
+        const name = m[1];
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        symbols.push({
+            id: makeId(filePath, name, 'class'),
+            name,
+            kind: 'class',
+            filePath,
+            startByte: m.index,
+            endByte: m.index + m[0].length,
+            signature: `#[AsController] class ${name}`,
+            summary: `Symfony controller: ${name}`,
+            frameworkMeta: { symfony_controller: true },
+        });
+    }
+    // Classes extending AbstractController (or Symfony\Bundle\...\AbstractController)
+    CLASS_HEADER_RE.lastIndex = 0;
+    while ((m = CLASS_HEADER_RE.exec(sourceStr)) !== null) {
+        const name = m[1];
+        const extendsName = (m[2] ?? '').split('\\').pop() ?? '';
+        if (extendsName !== 'AbstractController')
+            continue;
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        symbols.push({
+            id: makeId(filePath, name, 'class'),
+            name,
+            kind: 'class',
+            filePath,
+            startByte: m.index,
+            endByte: m.index + m[0].length,
+            signature: m[0].slice(0, -1).trim(), // strip trailing '{'
+            summary: `Symfony controller: ${name}`,
+            frameworkMeta: { symfony_controller: true },
+        });
+    }
+    return symbols;
+}
+// ─── Symfony adapter ──────────────────────────────────────────────────────────
+export const symfonyAdapter = {
+    name: 'symfony',
+    extensions: () => [],
+    async detect(projectRoot) {
+        const composerPath = join(projectRoot, 'composer.json');
+        if (!existsSync(composerPath))
+            return false;
+        try {
+            const json = JSON.parse(readFileSync(composerPath, 'utf8'));
+            const require = json['require'];
+            return !!(require &&
+                ('symfony/framework-bundle' in require || 'symfony/symfony' in require));
+        }
+        catch {
+            return false;
+        }
+    },
+    fileFilter(filePath) {
+        if (!filePath.endsWith('.php'))
+            return false;
+        return /^src[\\/]/.test(filePath) || filePath.includes('/src/');
+    },
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        return [
+            ...extractAttributeRoutes(sourceStr, filePath),
+            ...extractAnnotationRoutes(sourceStr, filePath),
+            ...extractControllers(sourceStr, filePath),
+        ];
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(symfonyAdapter);
+logger.debug("Adapter 'symfony' registered");
+//# sourceMappingURL=symfony.js.map

package/dist/adapters/symfony.js.map

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

package/dist/adapters/vapor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Vapor framework adapter (server-side Swift).
+ *
+ * Detects Vapor projects via Package.swift containing `vapor/vapor`.
+ * Extracts route and middleware symbols from Swift source files using
+ * regex-based pattern matching on Vapor's routing DSL:
+ *
+ *   app.get("users", ":id", use: handler)       → GET /users/:id
+ *   app.post("users", use: create)              → POST /users
+ *   app.webSocket("chat", onUpgrade: handler)   → WEBSOCKET /chat
+ *   app.middleware.use(CORSMiddleware())         → middleware
+ *
+ * Also emits `RouteCollection`-conforming classes/structs as class symbols
+ * with `vapor_route_collection: true`.
+ *
+ * Path components that are not string literals (e.g. PathComponent.catchall)
+ * are skipped; only `"string"` and `":param"` literals are recognised.
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const vaporAdapter: FrameworkAdapter;
+//# sourceMappingURL=vapor.d.ts.map

package/dist/adapters/vapor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapor.d.ts","sourceRoot":"","sources":["../../src/adapters/vapor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAuP7E,eAAO,MAAM,YAAY,EAAE,gBAmD1B,CAAC"}

package/dist/adapters/vapor.js

@@ -0,0 +1,269 @@
+/**
+ * Vapor framework adapter (server-side Swift).
+ *
+ * Detects Vapor projects via Package.swift containing `vapor/vapor`.
+ * Extracts route and middleware symbols from Swift source files using
+ * regex-based pattern matching on Vapor's routing DSL:
+ *
+ *   app.get("users", ":id", use: handler)       → GET /users/:id
+ *   app.post("users", use: create)              → POST /users
+ *   app.webSocket("chat", onUpgrade: handler)   → WEBSOCKET /chat
+ *   app.middleware.use(CORSMiddleware())         → middleware
+ *
+ * Also emits `RouteCollection`-conforming classes/structs as class symbols
+ * with `vapor_route_collection: true`.
+ *
+ * Path components that are not string literals (e.g. PathComponent.catchall)
+ * are skipped; only `"string"` and `":param"` literals are recognised.
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { extname } from 'path';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+const VAPOR_HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/** All Vapor router variable names / patterns to recognise. */
+const VAPOR_ROUTER_RE = /^(?:app|routes?|router|grouped|api|v\d+)$/;
+// ─── Route extraction helpers ─────────────────────────────────────────────────
+/**
+ * Extract consecutive string-literal path components from a Vapor argument list.
+ *
+ * Vapor uses variadic path components:
+ *   `app.get("users", ":id", use: handler)`
+ *
+ * We read args until we hit a non-string-literal argument (e.g. `use:`, a
+ * variable reference, or a closure). Returns an array of path segments.
+ */
+function extractPathComponents(argsText) {
+    const parts = [];
+    // Match all leading string literals (before any `label:` keyword argument)
+    // Pattern: optional leading whitespace, a double-quoted string, optionally followed by ,
+    const re = /^\s*"([^"\\]*)"\s*(?:,\s*)?/;
+    let remaining = argsText.trim();
+    while (remaining.length > 0) {
+        // Stop at keyword arguments (e.g. `use:`, `onUpgrade:`, `body:`)
+        if (/^[a-zA-Z_]\w*\s*:/.test(remaining))
+            break;
+        const m = remaining.match(re);
+        if (!m)
+            break; // not a string literal — stop
+        parts.push(m[1]);
+        remaining = remaining.slice(m[0].length);
+    }
+    return parts;
+}
+/**
+ * Build a URL path string from Vapor path segments.
+ * Segments starting with `:` are kept as-is (dynamic params).
+ * Returns `/` for empty paths, or `/<seg1>/<seg2>/...` otherwise.
+ */
+function buildRoutePath(segments) {
+    if (segments.length === 0)
+        return '/';
+    return '/' + segments.join('/');
+}
+/**
+ * Find all `varName.method(args)` calls for Vapor HTTP methods.
+ * Uses a simple scanner that reads character-by-character to handle
+ * nested parentheses correctly.
+ */
+function findVaporRouteCalls(source) {
+    const methods = [...VAPOR_HTTP_METHODS, 'webSocket'];
+    const methodSet = new Set(methods);
+    const results = [];
+    // Quick check — avoid expensive processing on non-Vapor files
+    if (!methods.some((m) => source.includes(`.${m}(`)))
+        return results;
+    const pattern = new RegExp(`\\b(\\w+)\\.(${methods.join('|')})\\s*\\(`, 'g');
+    let match;
+    while ((match = pattern.exec(source)) !== null) {
+        const varName = match[1];
+        const method = match[2];
+        if (!methodSet.has(method))
+            continue;
+        if (!VAPOR_ROUTER_RE.test(varName))
+            continue;
+        // Collect the argument text up to the matching closing paren
+        const openPos = match.index + match[0].length;
+        let depth = 1;
+        let i = openPos;
+        while (i < source.length && depth > 0) {
+            const ch = source[i];
+            if (ch === '(')
+                depth++;
+            else if (ch === ')')
+                depth--;
+            else if (ch === '"') {
+                // Skip string literals to avoid counting parens inside strings
+                i++;
+                while (i < source.length && source[i] !== '"') {
+                    if (source[i] === '\\')
+                        i++; // skip escaped char
+                    i++;
+                }
+            }
+            i++;
+        }
+        const argsText = source.slice(openPos, i - 1);
+        const fullMatch = source.slice(match.index, i);
+        results.push({ varName, method, argsText, fullMatch });
+    }
+    return results;
+}
+/**
+ * Extract Vapor route symbols from the source text of a `.swift` file.
+ */
+function extractVaporRoutes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const calls = findVaporRouteCalls(source);
+    for (const { method, argsText } of calls) {
+        const isWebSocket = method === 'webSocket';
+        const httpMethod = isWebSocket ? 'WEBSOCKET' : method.toUpperCase();
+        const segments = extractPathComponents(argsText);
+        const routePath = buildRoutePath(segments);
+        const routeName = `${httpMethod} ${routePath}`;
+        if (seen.has(routeName))
+            continue;
+        seen.add(routeName);
+        symbols.push({
+            id: makeId(filePath, routeName, 'route'),
+            name: routeName,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `${method}(${segments.map((s) => `"${s}"`).join(', ')})`,
+            summary: `Vapor route: ${routeName}`,
+            frameworkMeta: {
+                http_method: httpMethod,
+                route_path: routePath,
+                vapor_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Middleware extraction ────────────────────────────────────────────────────
+/**
+ * Extract `app.middleware.use(SomeMiddleware(...))` calls.
+ * Returns the middleware type names as 'middleware' symbols.
+ */
+function extractVaporMiddleware(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // Pattern: app.middleware.use(TypeName(...)) or app.middleware.use(TypeName())
+    const re = /\b\w+\.middleware\.use\s*\(\s*([A-Z][A-Za-z0-9_]*)\s*[(\)]/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const typeName = m[1];
+        if (seen.has(typeName))
+            continue;
+        seen.add(typeName);
+        symbols.push({
+            id: makeId(filePath, typeName, 'middleware'),
+            name: typeName,
+            kind: 'middleware',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `app.middleware.use(${typeName}(...))`,
+            summary: `Vapor middleware: ${typeName}`,
+            frameworkMeta: { vapor_middleware: true },
+        });
+    }
+    return symbols;
+}
+// ─── RouteCollection extraction ───────────────────────────────────────────────
+/**
+ * Find classes and structs conforming to `RouteCollection` and emit them
+ * as 'class' symbols with `vapor_route_collection: true`.
+ */
+function extractRouteCollections(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // Pattern: `class Name: ..., RouteCollection, ...` or `struct Name: RouteCollection`
+    // Also handles `class Name: RouteCollection` with optional protocol list
+    const re = /\b(class|struct)\s+([A-Z][A-Za-z0-9_]*)\s*:[^{]*\bRouteCollection\b/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const declKind = m[1];
+        const name = m[2];
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        // Build a short signature from the declaration line up to `{`
+        const declStart = m.index;
+        const braceIdx = source.indexOf('{', declStart);
+        const declLine = (braceIdx >= 0 ? source.slice(declStart, braceIdx) : m[0])
+            .replace(/\s+/g, ' ')
+            .trim();
+        const sig = declLine.length > 120 ? declLine.slice(0, 117) + '...' : declLine;
+        symbols.push({
+            id: makeId(filePath, name, 'class'),
+            name,
+            kind: 'class',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: sig,
+            summary: `Vapor RouteCollection: ${name}`,
+            frameworkMeta: {
+                vapor_route_collection: true,
+                declaration_kind: declKind,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Vapor adapter ─────────────────────────────────────────────────────────────
+export const vaporAdapter = {
+    name: 'vapor',
+    /** `.swift` files are handled by the Swift handler — no new extension needed. */
+    extensions: () => [],
+    // ── Detection ─────────────────────────────────────────────────────────────
+    async detect(projectRoot) {
+        try {
+            const content = readFileSync(`${projectRoot}/Package.swift`, 'utf8');
+            // Check for Vapor dependency: `.package(url: "...vapor/vapor...", ...)`
+            return /\.package\s*\(.*["']https:\/\/github\.com\/vapor\/vapor/i.test(content);
+        }
+        catch {
+            return false;
+        }
+    },
+    // ── File routing ───────────────────────────────────────────────────────────
+    fileFilter: (filePath) => extname(filePath) === '.swift',
+    // ── Framework symbol extraction ────────────────────────────────────────────
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        // Quick bail — avoid scanning non-Vapor files
+        const hasVaporImport = /\bimport\s+Vapor\b/.test(sourceStr) ||
+            /\bRouteCollection\b/.test(sourceStr) ||
+            /\bmiddleware\.use\b/.test(sourceStr) ||
+            VAPOR_HTTP_METHODS.some((m) => sourceStr.includes(`.${m}(`));
+        if (!hasVaporImport)
+            return [];
+        return [
+            ...extractVaporRoutes(sourceStr, filePath),
+            ...extractVaporMiddleware(sourceStr, filePath),
+            ...extractRouteCollections(sourceStr, filePath),
+        ];
+    },
+    // ── Metadata enrichment ────────────────────────────────────────────────────
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(vaporAdapter);
+logger.debug("Adapter 'vapor' registered");
+//# sourceMappingURL=vapor.js.map

package/dist/adapters/vapor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapor.js","sourceRoot":"","sources":["../../src/adapters/vapor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,iFAAiF;AAEjF,SAAS,MAAM,CAAC,QAAgB,EAAE,IAAY,EAAE,IAAY;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,QAAQ,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;SACrC,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,iFAAiF;AAEjF,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAEjG,+DAA+D;AAC/D,MAAM,eAAe,GAAG,2CAA2C,CAAC;AAEpE,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,2EAA2E;IAC3E,yFAAyF;IACzF,MAAM,EAAE,GAAG,6BAA6B,CAAC;IACzC,IAAI,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEhC,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,iEAAiE;QACjE,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,MAAM;QAE/C,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC;YAAE,MAAM,CAAC,8BAA8B;QAE7C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QAClB,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,QAAkB;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACtC,OAAO,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAWD;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,MAAM,OAAO,GAAG,CAAC,GAAG,kBAAkB,EAAE,WAAW,CAAa,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,8DAA8D;IAC9D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAEpE,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,gBAAgB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAC3C,GAAG,CACJ,CAAC;IAEF,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAEzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,SAAS;QACrC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,SAAS;QAE7C,6DAA6D;QAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;QAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,GAAG,OAAO,CAAC;QAChB,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;YACtB,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;iBACnB,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,EAAE,CAAC;iBACxB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACpB,+DAA+D;gBAC/D,CAAC,EAAE,CAAC;gBACJ,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC9C,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;wBAAE,CAAC,EAAE,CAAC,CAAC,oBAAoB;oBACjD,CAAC,EAAE,CAAC;gBACN,CAAC;YACH,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE/C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE1C,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC;QACzC,MAAM,WAAW,GAAG,MAAM,KAAK,WAAW,CAAC;QAC3C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAEpE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC;QAE/C,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEpB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC;YACxC,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,OAAO;YACb,QAAQ;YACR,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,GAAG,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACnE,OAAO,EAAE,gBAAgB,SAAS,EAAE;YACpC,aAAa,EAAE;gBACb,WAAW,EAAE,UAAU;gBACvB,UAAU,EAAE,SAAS;gBACrB,WAAW,EAAE,IAAI;aAClB;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAS,sBAAsB,CAAC,MAAc,EAAE,QAAgB;IAC9D,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,+EAA+E;IAC/E,MAAM,EAAE,GAAG,6DAA6D,CAAC;IACzE,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC;YAC5C,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,YAAY;YAClB,QAAQ;YACR,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,sBAAsB,QAAQ,QAAQ;YACjD,OAAO,EAAE,qBAAqB,QAAQ,EAAE;YACxC,aAAa,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,SAAS,uBAAuB,CAAC,MAAc,EAAE,QAAgB;IAC/D,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,qFAAqF;IACrF,yEAAyE;IACzE,MAAM,EAAE,GAAG,sEAAsE,CAAC;IAClF,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEf,8DAA8D;QAC9D,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;aACzE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE9E,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;YACnC,IAAI;YACJ,IAAI,EAAE,OAAO;YACb,QAAQ;YACR,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,0BAA0B,IAAI,EAAE;YACzC,aAAa,EAAE;gBACb,sBAAsB,EAAE,IAAI;gBAC5B,gBAAgB,EAAE,QAAQ;aAC3B;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kFAAkF;AAElF,MAAM,CAAC,MAAM,YAAY,GAAqB;IAC5C,IAAI,EAAE,OAAO;IAEb,iFAAiF;IACjF,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE;IAEpB,6EAA6E;IAE7E,KAAK,CAAC,MAAM,CAAC,WAAmB;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,WAAW,gBAAgB,EAAE,MAAM,CAAC,CAAC;YACrE,wEAAwE;YACxE,OAAO,0DAA0D,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,8EAA8E;IAE9E,UAAU,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ;IAEhE,8EAA8E;IAE9E,uBAAuB,CACrB,KAAkB,EAClB,MAAc,EACd,QAAgB;QAEhB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE1C,8CAA8C;QAC9C,MAAM,cAAc,GAClB,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC;YACpC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;YACrC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;YACrC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,cAAc;YAAE,OAAO,EAAE,CAAC;QAE/B,OAAO;YACL,GAAG,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC1C,GAAG,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC9C,GAAG,uBAAuB,CAAC,SAAS,EAAE,QAAQ,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,8EAA8E;IAE9E,cAAc,CAAC,MAAoB;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC;AAEF,iFAAiF;AAEjF,eAAe,CAAC,YAAY,CAAC,CAAC;AAC9B,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/adapters/vue-preprocessor.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Vue Single-File Component (SFC) pre-processor.
+ *
+ * Splits a raw .vue file buffer into typed ProcessedBlock[] so the TypeScript/
+ * JavaScript language handlers can parse each script block independently.
+ * Template and style blocks are intentionally omitted — they don't contain
+ * symbols we want to index.
+ *
+ * Byte-offset correctness:
+ *   offsetInOriginal is always computed from Buffer.byteLength(), never from
+ *   string character indices. This ensures symbols inside multi-byte content
+ *   that precedes the script block are positioned correctly.
+ */
+import type { ProcessedBlock } from '../core/types.js';
+/**
+ * Split a Vue SFC buffer into its typed script blocks.
+ *
+ * Returns one ProcessedBlock per <script> / <script setup> block found,
+ * with language set to 'typescript' when lang="ts" or lang="tsx" is present,
+ * and 'javascript' otherwise.
+ *
+ * Returns [] for files with no script block (template/style-only SFCs).
+ * Throws ParseError for files with mismatched <script> open/close tags.
+ */
+export declare function splitVueSFC(source: Buffer, filePath: string): ProcessedBlock[];
+//# sourceMappingURL=vue-preprocessor.d.ts.map

package/dist/adapters/vue-preprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-preprocessor.d.ts","sourceRoot":"","sources":["../../src/adapters/vue-preprocessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAkD9E"}