@seo-partner/adapters 0.0.0-stage → 1.0.0

package/dist/parsers/html-parser.js

@@ -0,0 +1,195 @@
+function lineNumberAtOffset(content, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < content.length; i += 1) {
+        if (content.charCodeAt(i) === 10)
+            line += 1;
+    }
+    return line;
+}
+function getAttr(attrsRaw, attrName) {
+    const re = new RegExp(`\\b${attrName}\\s*=\\s*["']([^"']*)["']`, 'i');
+    const m = re.exec(attrsRaw);
+    return m ? (m[1] ?? null) : null;
+}
+export function parseStaticHtmlOrMarkdown(route, fileContent) {
+    let title = null;
+    let description = null;
+    let canonical = null;
+    let robots = null;
+    let htmlLang = undefined;
+    const openGraph = {};
+    const hreflang = [];
+    const headings = [];
+    const images = [];
+    const links = [];
+    const jsonLdItems = [];
+    if (route.routerKind === 'markdown') {
+        const lines = fileContent.split(/\r?\n/);
+        for (let i = 0; i < lines.length; i += 1) {
+            const lineText = lines[i] ?? '';
+            const lineNum = i + 1;
+            const titleFm = /^title:\s*["']?(.+?)["']?$/i.exec(lineText.trim());
+            if (titleFm && !title) {
+                title = { value: (titleFm[1] ?? '').trim(), line: lineNum };
+            }
+            const descFm = /^description:\s*["']?(.+?)["']?$/i.exec(lineText.trim());
+            if (descFm && !description) {
+                description = { value: (descFm[1] ?? '').trim(), line: lineNum };
+            }
+            const hMatch = /^(#{1,6})\s+(.+)$/.exec(lineText.trim());
+            if (hMatch) {
+                const level = (hMatch[1]?.length ?? 1);
+                headings.push({ level, text: (hMatch[2] ?? '').trim(), line: lineNum });
+            }
+        }
+        return {
+            route,
+            title,
+            description,
+            canonical,
+            robots,
+            headings,
+            openGraph,
+            hreflang,
+            images,
+            links,
+            jsonLdItems,
+        };
+    }
+    const htmlTagMatch = /<html\b([^>]*?)>/i.exec(fileContent);
+    if (htmlTagMatch) {
+        const langVal = getAttr(htmlTagMatch[1] ?? '', 'lang') ?? '';
+        htmlLang = {
+            value: langVal.trim(),
+            line: lineNumberAtOffset(fileContent, htmlTagMatch.index),
+        };
+    }
+    const titleMatch = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(fileContent);
+    if (titleMatch) {
+        title = {
+            value: (titleMatch[1] ?? '').replace(/\s+/g, ' ').trim(),
+            line: lineNumberAtOffset(fileContent, titleMatch.index),
+        };
+    }
+    const metaRegex = /<meta\b([^>]*?)\/?>/gi;
+    let metaMatch;
+    while ((metaMatch = metaRegex.exec(fileContent)) !== null) {
+        const attrs = metaMatch[1] ?? '';
+        const line = lineNumberAtOffset(fileContent, metaMatch.index);
+        const nameVal = getAttr(attrs, 'name')?.toLowerCase();
+        const propVal = getAttr(attrs, 'property')?.toLowerCase();
+        const contentVal = getAttr(attrs, 'content');
+        if (nameVal === 'description' && contentVal !== null && !description) {
+            description = { value: contentVal, line };
+        }
+        else if (nameVal === 'robots' && contentVal !== null && !robots) {
+            robots = { value: contentVal, line };
+        }
+        else if (propVal?.startsWith('og:') && contentVal !== null) {
+            openGraph[propVal.slice(3)] = contentVal;
+        }
+    }
+    const linkTagRegex = /<link\b([^>]*?)\/?>/gi;
+    let linkTagMatch;
+    while ((linkTagMatch = linkTagRegex.exec(fileContent)) !== null) {
+        const attrs = linkTagMatch[1] ?? '';
+        const line = lineNumberAtOffset(fileContent, linkTagMatch.index);
+        const relVal = getAttr(attrs, 'rel')?.toLowerCase();
+        const hrefVal = getAttr(attrs, 'href');
+        if (relVal === 'canonical' && hrefVal !== null && !canonical) {
+            canonical = { value: hrefVal, line };
+        }
+        else if (relVal === 'alternate' && hrefVal !== null) {
+            const hl = getAttr(attrs, 'hreflang');
+            if (hl)
+                hreflang.push({ lang: hl, url: hrefVal });
+        }
+    }
+    const headingRegex = /<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi;
+    let hMatch;
+    while ((hMatch = headingRegex.exec(fileContent)) !== null) {
+        const level = Number(hMatch[1]);
+        const text = (hMatch[2] ?? '').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim();
+        headings.push({
+            level,
+            text,
+            line: lineNumberAtOffset(fileContent, hMatch.index),
+        });
+    }
+    const imgRegex = /<img\b([^>]*?)\/?>/gi;
+    let imgMatch;
+    while ((imgMatch = imgRegex.exec(fileContent)) !== null) {
+        const attrs = imgMatch[1] ?? '';
+        const srcVal = getAttr(attrs, 'src') ?? '';
+        const altVal = getAttr(attrs, 'alt');
+        images.push({
+            src: srcVal,
+            alt: altVal,
+            hasAlt: altVal !== null && altVal.trim().length > 0,
+            width: getAttr(attrs, 'width'),
+            height: getAttr(attrs, 'height'),
+            line: lineNumberAtOffset(fileContent, imgMatch.index),
+        });
+    }
+    const anchorRegex = /<a\b([^>]*?)>([\s\S]*?)<\/a>/gi;
+    let aMatch;
+    while ((aMatch = anchorRegex.exec(fileContent)) !== null) {
+        const attrs = aMatch[1] ?? '';
+        const hrefVal = getAttr(attrs, 'href');
+        if (hrefVal) {
+            links.push({
+                toUrl: hrefVal,
+                anchorText: (aMatch[2] ?? '').replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim(),
+                kind: /^https?:\/\//i.test(hrefVal) ? 'external' : 'internal',
+                rel: getAttr(attrs, 'rel'),
+                line: lineNumberAtOffset(fileContent, aMatch.index),
+            });
+        }
+    }
+    const scriptRegex = /<script\b[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi;
+    let sMatch;
+    while ((sMatch = scriptRegex.exec(fileContent)) !== null) {
+        const rawJson = (sMatch[1] ?? '').trim();
+        const line = lineNumberAtOffset(fileContent, sMatch.index);
+        try {
+            const parsed = JSON.parse(rawJson);
+            const contextVal = parsed['@context'];
+            const typeVal = parsed['@type'];
+            const isValid = typeof contextVal === 'string' &&
+                contextVal.includes('schema.org') &&
+                typeof typeVal === 'string' &&
+                typeVal.trim().length > 0;
+            jsonLdItems.push({
+                schemaType: typeof typeVal === 'string' ? typeVal : null,
+                rawJson,
+                isValid,
+                validationError: isValid ? null : 'Missing @context (schema.org) or @type',
+                line,
+            });
+        }
+        catch (err) {
+            jsonLdItems.push({
+                schemaType: null,
+                rawJson,
+                isValid: false,
+                validationError: err instanceof Error ? err.message : 'Invalid JSON',
+                line,
+            });
+        }
+    }
+    return {
+        route,
+        title,
+        description,
+        canonical,
+        robots,
+        ...(htmlLang !== undefined ? { htmlLang } : {}),
+        headings,
+        openGraph,
+        hreflang,
+        images,
+        links,
+        jsonLdItems,
+    };
+}
+//# sourceMappingURL=html-parser.js.map

package/dist/parsers/html-parser.js.map

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

package/dist/parsers/layout-resolver.d.ts

@@ -0,0 +1,44 @@
+import type { ExtractedRouteData } from '@seo-partner/core';
+export interface ExtractedLayoutData {
+    readonly filePath: string;
+    readonly htmlLang?: {
+        readonly value: string;
+        readonly line: number;
+    } | null;
+    readonly title?: {
+        readonly value: string;
+        readonly line: number;
+    } | null;
+    readonly description?: {
+        readonly value: string;
+        readonly line: number;
+    } | null;
+    readonly canonical?: {
+        readonly value: string;
+        readonly line: number;
+    } | null;
+    readonly robots?: {
+        readonly value: string;
+        readonly line: number;
+    } | null;
+}
+export declare class LayoutResolver {
+    private readonly layoutsByPath;
+    registerLayout(layout: ExtractedLayoutData): void;
+    getLayout(filePath: string): ExtractedLayoutData | undefined;
+    /**
+     * Applies layout inheritance to an extracted route if the route lacks metadata
+     * (such as htmlLang or fallback title).
+     */
+    applyInheritance(routeData: ExtractedRouteData, parentLayoutPaths: ReadonlyArray<string>): ExtractedRouteData;
+    /**
+     * Finds candidate SvelteKit layout paths (+layout.svelte) starting from the page directory
+     * up to the routes root directory.
+     */
+    findSvelteKitLayoutPaths(pageFilePath: string): ReadonlyArray<string>;
+    /**
+     * Resolves Django base template paths (e.g. "base.html" or "layouts/base.html").
+     */
+    findDjangoExtendsPath(templateContent: string, allTemplatePaths: ReadonlyArray<string>): string | undefined;
+}
+//# sourceMappingURL=layout-resolver.d.ts.map

package/dist/parsers/layout-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-resolver.d.ts","sourceRoot":"","sources":["../../src/parsers/layout-resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5E;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAEjE,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAKjD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKnE;;;OAGG;IACI,gBAAgB,CACrB,SAAS,EAAE,kBAAkB,EAC7B,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,GACvC,kBAAkB;IAuCrB;;;OAGG;IACI,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IAkB5E;;OAEG;IACI,qBAAqB,CAC1B,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAC,GACtC,MAAM,GAAG,SAAS;CAWtB"}

package/dist/parsers/layout-resolver.js

@@ -0,0 +1,85 @@
+export class LayoutResolver {
+    layoutsByPath = new Map();
+    registerLayout(layout) {
+        const normalized = layout.filePath.replace(/\\/g, '/');
+        this.layoutsByPath.set(normalized, layout);
+    }
+    getLayout(filePath) {
+        const normalized = filePath.replace(/\\/g, '/');
+        return this.layoutsByPath.get(normalized);
+    }
+    /**
+     * Applies layout inheritance to an extracted route if the route lacks metadata
+     * (such as htmlLang or fallback title).
+     */
+    applyInheritance(routeData, parentLayoutPaths) {
+        let htmlLang = routeData.htmlLang;
+        let title = routeData.title;
+        let description = routeData.description;
+        let canonical = routeData.canonical;
+        let robots = routeData.robots;
+        // Traverse from nearest layout to root layout
+        for (const layoutPath of parentLayoutPaths) {
+            const layout = this.getLayout(layoutPath);
+            if (!layout)
+                continue;
+            if (!htmlLang && layout.htmlLang) {
+                htmlLang = layout.htmlLang;
+            }
+            if (!title && layout.title) {
+                title = layout.title;
+            }
+            if (!description && layout.description) {
+                description = layout.description;
+            }
+            if (!canonical && layout.canonical) {
+                canonical = layout.canonical;
+            }
+            if (!robots && layout.robots) {
+                robots = layout.robots;
+            }
+        }
+        return {
+            ...routeData,
+            htmlLang,
+            title,
+            description,
+            canonical,
+            robots,
+        };
+    }
+    /**
+     * Finds candidate SvelteKit layout paths (+layout.svelte) starting from the page directory
+     * up to the routes root directory.
+     */
+    findSvelteKitLayoutPaths(pageFilePath) {
+        const normalized = pageFilePath.replace(/\\/g, '/');
+        const parts = normalized.split('/');
+        const routesIdx = parts.lastIndexOf('routes');
+        if (routesIdx === -1)
+            return [];
+        const candidates = [];
+        const dirParts = parts.slice(0, -1);
+        // From current dir up to routes directory
+        for (let i = dirParts.length; i >= routesIdx; i--) {
+            const dir = dirParts.slice(0, i).join('/');
+            candidates.push(`${dir}/+layout.svelte`);
+        }
+        return candidates;
+    }
+    /**
+     * Resolves Django base template paths (e.g. "base.html" or "layouts/base.html").
+     */
+    findDjangoExtendsPath(templateContent, allTemplatePaths) {
+        const extendsMatch = templateContent.match(/\{%\s*extends\s+['"]([^'"]+)['"]\s*%\}/i);
+        if (!extendsMatch || !extendsMatch[1])
+            return undefined;
+        const baseName = extendsMatch[1].replace(/\\/g, '/');
+        // Match against known templates
+        return allTemplatePaths.find((p) => {
+            const norm = p.replace(/\\/g, '/');
+            return norm.endsWith(baseName) || norm === baseName;
+        });
+    }
+}
+//# sourceMappingURL=layout-resolver.js.map

package/dist/parsers/layout-resolver.js.map

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

package/dist/parsers/php-route-parser.d.ts

@@ -0,0 +1,11 @@
+export type PhpFlavor = 'laravel' | 'symfony' | 'php';
+export interface DiscoveredPhpRouteEntry {
+    readonly pattern: string;
+    readonly filePath: string;
+    readonly flavor: PhpFlavor;
+}
+export declare function detectPhpFlavor(filePaths: ReadonlyArray<string>, contentsByPath: ReadonlyMap<string, string>): PhpFlavor | null;
+export declare function parseLaravelRoutes(filePaths: ReadonlyArray<string>, contentsByPath: ReadonlyMap<string, string>): ReadonlyArray<DiscoveredPhpRouteEntry>;
+export declare function parseSymfonyRoutes(filePaths: ReadonlyArray<string>, contentsByPath: ReadonlyMap<string, string>): ReadonlyArray<DiscoveredPhpRouteEntry>;
+export declare function discoverNativePhpRoutes(filePaths: ReadonlyArray<string>): ReadonlyArray<DiscoveredPhpRouteEntry>;
+//# sourceMappingURL=php-route-parser.d.ts.map

package/dist/parsers/php-route-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-route-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/php-route-parser.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAChC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,SAAS,GAAG,IAAI,CAuBlB;AAWD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAChC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,aAAa,CAAC,uBAAuB,CAAC,CAkFxC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAChC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,aAAa,CAAC,uBAAuB,CAAC,CAwExC;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,GAC/B,aAAa,CAAC,uBAAuB,CAAC,CAyCxC"}

package/dist/parsers/php-route-parser.js

@@ -0,0 +1,194 @@
+export function detectPhpFlavor(filePaths, contentsByPath) {
+    const composerJson = contentsByPath.get('composer.json') ?? '';
+    if (composerJson.includes('laravel/framework') ||
+        filePaths.includes('artisan') ||
+        filePaths.some((p) => p.endsWith('.blade.php'))) {
+        return 'laravel';
+    }
+    if (composerJson.includes('symfony/framework-bundle') ||
+        composerJson.includes('symfony/twig-bundle') ||
+        filePaths.some((p) => p.endsWith('.html.twig'))) {
+        return 'symfony';
+    }
+    if (filePaths.some((p) => p.endsWith('.php'))) {
+        return 'php';
+    }
+    return null;
+}
+function normalizeRoutePattern(rawPattern) {
+    const trimmed = rawPattern.trim();
+    if (!trimmed || trimmed === '/')
+        return '/';
+    const withSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    return withSlash.length > 1 && withSlash.endsWith('/')
+        ? withSlash.slice(0, -1)
+        : withSlash;
+}
+export function parseLaravelRoutes(filePaths, contentsByPath) {
+    const viewPathByDotName = new Map();
+    for (const fp of filePaths) {
+        if (fp.startsWith('resources/views/') && fp.endsWith('.blade.php')) {
+            const rel = fp
+                .slice('resources/views/'.length)
+                .slice(0, -'.blade.php'.length);
+            const dotName = rel.replace(/\//g, '.');
+            viewPathByDotName.set(dotName, fp);
+            viewPathByDotName.set(rel, fp);
+        }
+    }
+    const results = [];
+    const mappedFiles = new Set();
+    const webPhp = contentsByPath.get('routes/web.php') ?? '';
+    if (webPhp) {
+        // 1. Route::view('/uri', 'view.name')
+        const routeViewRegex = /Route::view\s*\(\s*['"]([^'"]+)['"]\s*,\s*['"]([^'"]+)['"]/g;
+        let m;
+        while ((m = routeViewRegex.exec(webPhp)) !== null) {
+            const pattern = normalizeRoutePattern(m[1] ?? '/');
+            const viewName = m[2] ?? '';
+            const filePath = viewPathByDotName.get(viewName);
+            if (filePath) {
+                results.push({ pattern, filePath, flavor: 'laravel' });
+                mappedFiles.add(filePath);
+            }
+        }
+        // 2. Route::get('/uri', function() { return view('view.name'); })
+        const routeClosureRegex = /Route::(?:get|any)\s*\(\s*['"]([^'"]+)['"][\s\S]*?view\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+        while ((m = routeClosureRegex.exec(webPhp)) !== null) {
+            const pattern = normalizeRoutePattern(m[1] ?? '/');
+            const viewName = m[2] ?? '';
+            const filePath = viewPathByDotName.get(viewName);
+            if (filePath && !mappedFiles.has(filePath)) {
+                results.push({ pattern, filePath, flavor: 'laravel' });
+                mappedFiles.add(filePath);
+            }
+        }
+        // 3. Controller-based routes: Route::get('/uri', [Controller::class, 'method'])
+        const routeControllerRegex = /Route::(?:get|any)\s*\(\s*['"]([^'"]+)['"]\s*,\s*(?:\[|\w+Controller)/g;
+        while ((m = routeControllerRegex.exec(webPhp)) !== null) {
+            const pattern = normalizeRoutePattern(m[1] ?? '/');
+            if (!results.some((r) => r.pattern === pattern)) {
+                results.push({ pattern, filePath: 'routes/web.php', flavor: 'laravel' });
+            }
+        }
+    }
+    // Fallback for any public Blade view not explicitly matched in routes/web.php
+    for (const [dotName, filePath] of viewPathByDotName.entries()) {
+        if (mappedFiles.has(filePath) || dotName.includes('/'))
+            continue;
+        if (dotName.startsWith('layouts.') ||
+            dotName.startsWith('components.') ||
+            dotName.startsWith('partials.') ||
+            dotName.startsWith('emails.') ||
+            dotName.startsWith('errors.') ||
+            dotName.startsWith('vendor.')) {
+            continue;
+        }
+        const pattern = dotName === 'welcome' || dotName === 'home' || dotName === 'index'
+            ? '/'
+            : `/${dotName.replace(/\.index$/, '').replace(/\./g, '/')}`;
+        results.push({
+            pattern: normalizeRoutePattern(pattern),
+            filePath,
+            flavor: 'laravel',
+        });
+        mappedFiles.add(filePath);
+    }
+    return results;
+}
+export function parseSymfonyRoutes(filePaths, contentsByPath) {
+    const twigTemplates = new Set(filePaths.filter((p) => p.startsWith('templates/') && p.endsWith('.html.twig')));
+    const results = [];
+    const mappedFiles = new Set();
+    // 1. Parse PHP 8 #[Route('/path')] attributes in src/Controller/**/*.php
+    for (const fp of filePaths) {
+        if (!fp.startsWith('src/Controller/') || !fp.endsWith('.php'))
+            continue;
+        const content = contentsByPath.get(fp) ?? '';
+        const attrRegex = /#\[Route\s*\(\s*(?:path:\s*)?['"]([^'"]+)['"][^\]]*\)\][\s\S]*?\$this->render\s*\(\s*['"]([^'"]+)['"]/g;
+        let m;
+        while ((m = attrRegex.exec(content)) !== null) {
+            const pattern = normalizeRoutePattern(m[1] ?? '/');
+            const relTwig = (m[2] ?? '').replace(/^\/+/, '');
+            const fullTwig = `templates/${relTwig}`;
+            if (twigTemplates.has(fullTwig)) {
+                results.push({ pattern, filePath: fullTwig, flavor: 'symfony' });
+                mappedFiles.add(fullTwig);
+            }
+        }
+    }
+    // 2. Parse config/routes.yaml
+    const routesYaml = contentsByPath.get('config/routes.yaml') ?? '';
+    if (routesYaml) {
+        const blocks = routesYaml.split(/\r?\n(?=[a-zA-Z0-9_-]+:\s*$)/m);
+        for (const block of blocks) {
+            const pathMatch = /\bpath:\s*['"]?([^\s'"]+)['"]?/.exec(block);
+            const ctrlMatch = /\bcontroller:\s*[\w\\]+\\([A-Za-z0-9_]+)Controller::([a-zA-Z0-9_]+)/.exec(block);
+            if (pathMatch?.[1] && ctrlMatch?.[1] && ctrlMatch[2]) {
+                const pattern = normalizeRoutePattern(pathMatch[1]);
+                const folder = ctrlMatch[1].toLowerCase();
+                const action = ctrlMatch[2].toLowerCase();
+                const candidate = `templates/${folder}/${action}.html.twig`;
+                if (twigTemplates.has(candidate) && !mappedFiles.has(candidate)) {
+                    results.push({ pattern, filePath: candidate, flavor: 'symfony' });
+                    mappedFiles.add(candidate);
+                }
+            }
+        }
+    }
+    // 3. Fallback for unmapped public templates
+    for (const twigPath of twigTemplates) {
+        if (mappedFiles.has(twigPath))
+            continue;
+        const rel = twigPath.slice('templates/'.length, -'.html.twig'.length);
+        if (rel === 'base' ||
+            rel.startsWith('layouts/') ||
+            rel.startsWith('partials/') ||
+            rel.startsWith('components/') ||
+            rel.startsWith('bundles/')) {
+            continue;
+        }
+        const cleaned = rel.replace(/\/index$/, '');
+        const pattern = cleaned === 'home' || cleaned === 'index' || cleaned === 'default'
+            ? '/'
+            : normalizeRoutePattern(cleaned);
+        results.push({ pattern, filePath: twigPath, flavor: 'symfony' });
+        mappedFiles.add(twigPath);
+    }
+    return results;
+}
+export function discoverNativePhpRoutes(filePaths) {
+    const results = [];
+    const publicPhpFiles = filePaths.filter((p) => p.startsWith('public/') && p.endsWith('.php'));
+    if (publicPhpFiles.length > 0) {
+        for (const fp of publicPhpFiles) {
+            const rel = fp.slice('public/'.length);
+            const pattern = rel === 'index.php' ? '/' : normalizeRoutePattern(rel);
+            results.push({ pattern, filePath: fp, flavor: 'php' });
+        }
+        return results;
+    }
+    for (const fp of filePaths) {
+        if (!fp.endsWith('.php'))
+            continue;
+        const lower = fp.toLowerCase();
+        if (lower === 'artisan' ||
+            lower.startsWith('includes/') ||
+            lower.startsWith('inc/') ||
+            lower.startsWith('config/') ||
+            lower.startsWith('vendor/') ||
+            lower.startsWith('routes/') ||
+            lower.startsWith('src/') ||
+            lower.startsWith('app/') ||
+            lower.startsWith('tests/') ||
+            lower.endsWith('header.php') ||
+            lower.endsWith('footer.php') ||
+            lower.endsWith('functions.php')) {
+            continue;
+        }
+        const pattern = fp === 'index.php' ? '/' : normalizeRoutePattern(fp);
+        results.push({ pattern, filePath: fp, flavor: 'php' });
+    }
+    return results;
+}
+//# sourceMappingURL=php-route-parser.js.map

package/dist/parsers/php-route-parser.js.map

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

package/dist/parsers/php-template-parser.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
+export declare function parsePhpOrTemplateFile(projectRoot: string, route: DiscoveredRoute, fileContent: string): ExtractedRouteData;
+//# sourceMappingURL=php-template-parser.d.ts.map

package/dist/parsers/php-template-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php-template-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/php-template-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA+R7E,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAQpB"}