@seo-partner/adapters 1.0.0 → 1.0.4

package/src/blog-scaffold-generator.ts

@@ -0,0 +1,153 @@
+import type { FrameworkType } from '@seo-partner/core';
+
+export interface BlogScaffoldFile {
+  relativePath: string;
+  code: string;
+  description: string;
+}
+
+export function generateBlogScaffold(
+  framework: FrameworkType,
+  pillarTitle = 'Actualités et Guides SEO',
+): BlogScaffoldFile[] {
+  switch (framework) {
+    case 'next_app':
+      return [
+        {
+          relativePath: 'app/blog/page.tsx',
+          code: `import type { Metadata } from 'next';
+import Link from 'next/link';
+
+export const metadata: Metadata = {
+  title: '${pillarTitle} | Blog',
+  description: 'Découvrez nos guides d\\\'experts et analyses approfondies.',
+  alternates: {
+    canonical: '/blog',
+  },
+};
+
+export default function BlogIndexPage() {
+  return (
+    <main className="max-w-4xl mx-auto py-12 px-4">
+      <h1 className="text-3xl font-bold mb-8">${pillarTitle}</h1>
+      <p className="text-gray-600 mb-6">Explorez nos articles et guides complets pour approfondir vos compétences.</p>
+    </main>
+  );
+}
+`,
+          description: 'Page d\'index du blog Next.js App Router',
+        },
+        {
+          relativePath: 'app/blog/[slug]/page.tsx',
+          code: `import type { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+
+interface Props {
+  params: { slug: string };
+}
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  return {
+    title: \`Article: \${params.slug} | Blog\`,
+    description: 'Guide complet et recommandations pratiques.',
+  };
+}
+
+export default function BlogPostPage({ params }: Props) {
+  return (
+    <article className="max-w-3xl mx-auto py-12 px-4 prose">
+      <h1>Détail de l\\\'article : {params.slug}</h1>
+    </article>
+  );
+}
+`,
+          description: 'Route dynamique d\'article Next.js App Router',
+        },
+      ];
+
+    case 'nuxt':
+      return [
+        {
+          relativePath: 'pages/blog/index.vue',
+          code: `<script setup lang="ts">
+useSeoMeta({
+  title: '${pillarTitle} | Blog',
+  description: 'Guides d\\\'experts et ressources pratiques.',
+});
+</script>
+
+<template>
+  <main class="blog-index">
+    <h1>${pillarTitle}</h1>
+  </main>
+</template>
+`,
+          description: 'Page d\'index du blog Nuxt 3',
+        },
+      ];
+
+    case 'astro':
+      return [
+        {
+          relativePath: 'src/pages/blog/index.astro',
+          code: `---
+const pageTitle = "${pillarTitle}";
+---
+<html>
+  <head>
+    <title>{pageTitle}</title>
+    <meta name="description" content="Guides et analyses éditoriales d\\\'experts." />
+  </head>
+  <body>
+    <main>
+      <h1>{pageTitle}</h1>
+    </main>
+  </body>
+</html>
+`,
+          description: 'Page d\'index du blog Astro',
+        },
+      ];
+
+    case 'laravel':
+      return [
+        {
+          relativePath: 'resources/views/blog/index.blade.php',
+          code: `@extends('layouts.app')
+
+@section('title', '${pillarTitle}')
+
+@push('meta')
+  <meta name="description" content="Retrouvez nos guides et articles spécialisés.">
+@endpush
+
+@section('content')
+  <div class="container py-5">
+    <h1>${pillarTitle}</h1>
+  </div>
+@endsection
+`,
+          description: 'Vue d\'index du blog Laravel Blade',
+        },
+      ];
+
+    default:
+      return [
+        {
+          relativePath: 'blog/index.php',
+          code: `<?php
+$pageTitle = '${pillarTitle}';
+$metaDescription = 'Guides et ressources d\\\'experts.';
+require_once __DIR__ . '/../includes/header.php';
+?>
+<main class="container">
+  <h1><?php echo htmlspecialchars($pageTitle); ?></h1>
+</main>
+<?php require_once __DIR__ . '/../includes/footer.php'; ?>
+`,
+          description: 'Script d\'index du blog PHP',
+        },
+      ];
+  }
+}
+

package/src/index.ts

@@ -7,6 +7,9 @@ export * from './sveltekit-adapter.js';
 export * from './remix-adapter.js';
 export * from './django-adapter.js';
 export * from './php-adapter.js';
+export * from './laravel-adapter.js';
+export * from './symfony-adapter.js';
+export * from './php-native-adapter.js';
 export * from './static-adapter.js';
 export * from './parsers/tsx-ast-parser.js';
 export * from './parsers/html-parser.js';
@@ -21,3 +24,8 @@ export * from './parsers/php-template-parser.js';
 export * from './parsers/robots-sitemap-parser.js';
 export * from './parsers/route-normalizer.js';
 export * from './parsers/layout-resolver.js';
+export * from './sitemap-builder.js';
+export * from './skeleton-detector.js';
+export * from './ast-merger.js';
+export * from './layout-title-resolver.js';
+export * from './blog-scaffold-generator.js';

package/src/laravel-adapter.ts

@@ -0,0 +1,45 @@
+export interface LaravelMetaFields {
+  title?: string;
+  description?: string;
+  canonical?: string;
+}
+
+export function patchLaravelBladeTemplate(
+  sourceCode: string,
+  meta: LaravelMetaFields,
+): string {
+  let result = sourceCode;
+
+  // Title section
+  if (meta.title && !/@section\(\s*['"]title['"]/i.test(result)) {
+    const sectionTitle = `@section('title', '${meta.title.replace(/'/g, "\\'")}')\n`;
+    if (/@extends\([^)]+\)/i.test(result)) {
+      result = result.replace(/(@extends\([^)]+\)\s*\n)/i, `$1${sectionTitle}`);
+    } else {
+      result = sectionTitle + result;
+    }
+  }
+
+  // Meta push
+  if ((meta.description || meta.canonical) && !/@push\(\s*['"]meta['"]/i.test(result)) {
+    const metaTags: string[] = ["@push('meta')"];
+    if (meta.description) {
+      metaTags.push(`  <meta name="description" content="${meta.description.replace(/"/g, '&quot;')}">`);
+    }
+    if (meta.canonical) {
+      metaTags.push(`  <link rel="canonical" href="${meta.canonical}">`);
+    }
+    metaTags.push('@endpush\n');
+
+    if (/@section\(\s*['"]title['"][^)]*\)/i.test(result)) {
+      result = result.replace(/(@section\(\s*['"]title['"][^)]*\)\s*\n)/i, `$1${metaTags.join('\n')}`);
+    } else if (/@extends\([^)]+\)/i.test(result)) {
+      result = result.replace(/(@extends\([^)]+\)\s*\n)/i, `$1${metaTags.join('\n')}`);
+    } else {
+      result = metaTags.join('\n') + result;
+    }
+  }
+
+  return result;
+}
+

package/src/layout-title-resolver.ts

@@ -0,0 +1,37 @@
+export interface LayoutTitleTemplate {
+  template?: string;
+  defaultTitle?: string;
+  brandName?: string;
+}
+
+export function extractLayoutTitleTemplate(layoutCode: string): LayoutTitleTemplate | null {
+  const match = /title\s*:\s*\{([^}]+)\}/m.exec(layoutCode);
+  if (!match || !match[1]) return null;
+
+  const body = match[1];
+  const templateMatch = /template\s*:\s*['"`]([^'"`]+)['"`]/.exec(body);
+  const defaultMatch = /default\s*:\s*['"`]([^'"`]+)['"`]/.exec(body);
+
+  const template = templateMatch?.[1];
+  const defaultTitle = defaultMatch?.[1];
+
+  let brandName: string | undefined;
+  if (template && template.includes('%s')) {
+    brandName = template.replace('%s', '').replace(/^[| -]+|[| -]+$/g, '').trim();
+  }
+
+  return {
+    template,
+    defaultTitle,
+    brandName,
+  };
+}
+
+export function sanitizePageTitleForLayout(pageTitle: string, layoutTemplate: LayoutTitleTemplate | null): string {
+  if (!layoutTemplate?.brandName) {
+    return pageTitle;
+  }
+  const brand = layoutTemplate.brandName;
+  const regex = new RegExp(`(\\s*[|\\-]\\s*${brand.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&')})+$`, 'i');
+  return pageTitle.replace(regex, '').trim();
+}

package/src/nuxt-adapter.ts

@@ -1,118 +1,148 @@
-import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
-import type { AdapterCapabilities, AdapterVersion, FrameworkAdapter } from './contract.js';
-import { parseVueSfc } from './parsers/vue-sfc-parser.js';
-import { normalizeRoutePattern } from './parsers/route-normalizer.js';
-import { LayoutResolver } from './parsers/layout-resolver.js';
-
-export class NuxtAdapter implements FrameworkAdapter {
-  public readonly id = 'nuxt';
-  public readonly name = 'Nuxt 3';
-  public readonly version: AdapterVersion = '1.0';
-  public readonly capabilities: AdapterCapabilities = {
-    routes: true,
-    metadata: true,
-    headings: true,
-    internalLinks: true,
-    jsonLd: true,
-    images: true,
-    robotsAndSitemap: true,
-  };
-
-  private readonly layoutResolver = new LayoutResolver();
-
-  public async detect(
-    projectRoot: string,
-    filePaths: ReadonlyArray<string>,
-    contentsByPath: ReadonlyMap<string, string>,
-  ): Promise<boolean> {
-    for (const filePath of filePaths) {
-      const normalized = filePath.replace(/\\/g, '/');
-      if (
-        normalized === 'nuxt.config.ts' ||
-        normalized === 'nuxt.config.js' ||
-        normalized === 'nuxt.config.mjs'
-      ) {
-        return true;
-      }
-      if (normalized === 'package.json') {
-        const content = contentsByPath.get(filePath) ?? '';
-        if (content.includes('"nuxt"') || content.includes('"@nuxt/')) {
-          return true;
-        }
-      }
-    }
-    return false;
-  }
-
-  public async discoverRoutes(
-    projectRoot: string,
-    filePaths: ReadonlyArray<string>,
-    contentsByPath: ReadonlyMap<string, string>,
-    sitemapPaths: ReadonlySet<string>,
-  ): Promise<ReadonlyArray<DiscoveredRoute>> {
-    const routes: DiscoveredRoute[] = [];
-
-    // Pre-cache layouts from layouts/**
-    for (const filePath of filePaths) {
-      const normalized = filePath.replace(/\\/g, '/');
-      if (normalized.startsWith('layouts/') && normalized.endsWith('.vue')) {
-        const content = contentsByPath.get(filePath) ?? '';
-        const parsed = parseVueSfc(
-          {
-            pattern: '',
-            filePath,
-            routerKind: 'nuxt',
-            renderingMode: 'ssr-ssg',
-            isPrivate: false,
-            inSitemap: false,
-          },
-          content,
-        );
-        this.layoutResolver.registerLayout({
-          filePath,
-          htmlLang: parsed.htmlLang,
-          title: parsed.title,
-          description: parsed.description,
-          canonical: parsed.canonical,
-          robots: parsed.robots,
-        });
-      }
-    }
-
-    for (const filePath of filePaths) {
-      const normalized = filePath.replace(/\\/g, '/');
-      if (!normalized.startsWith('pages/')) continue;
-      if (!normalized.endsWith('.vue')) continue;
-
-      const relativeInsidePages = normalized.slice('pages/'.length);
-      const pattern = normalizeRoutePattern(relativeInsidePages, 'nuxt');
-      const inSitemap = sitemapPaths.has(pattern);
-
-      routes.push({
-        pattern,
-        filePath,
-        routerKind: 'nuxt',
-        renderingMode: 'ssr-ssg',
-        isPrivate: false,
-        inSitemap,
-      });
-    }
-
-    return routes;
-  }
-
-  public async extractRoute(
-    projectRoot: string,
-    route: DiscoveredRoute,
-    fileContent: string,
-  ): Promise<ExtractedRouteData> {
-    let extracted = parseVueSfc(route, fileContent);
-
-    // Inherit from default layout if present
-    const layoutCandidates = ['layouts/default.vue', 'layouts/main.vue'];
-    extracted = this.layoutResolver.applyInheritance(extracted, layoutCandidates);
-
-    return extracted;
-  }
-}
-
+import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
+import type { AdapterCapabilities, AdapterVersion, FrameworkAdapter } from './contract.js';
+import { parseVueSfc } from './parsers/vue-sfc-parser.js';
+import { normalizeRoutePattern } from './parsers/route-normalizer.js';
+import { LayoutResolver } from './parsers/layout-resolver.js';
+
+export class NuxtAdapter implements FrameworkAdapter {
+  public readonly id = 'nuxt';
+  public readonly name = 'Nuxt 3';
+  public readonly version: AdapterVersion = '1.0';
+  public readonly capabilities: AdapterCapabilities = {
+    routes: true,
+    metadata: true,
+    headings: true,
+    internalLinks: true,
+    jsonLd: true,
+    images: true,
+    robotsAndSitemap: true,
+  };
+
+  private readonly layoutResolver = new LayoutResolver();
+
+  public async detect(
+    projectRoot: string,
+    filePaths: ReadonlyArray<string>,
+    contentsByPath: ReadonlyMap<string, string>,
+  ): Promise<boolean> {
+    for (const filePath of filePaths) {
+      const normalized = filePath.replace(/\\/g, '/');
+      if (
+        normalized === 'nuxt.config.ts' ||
+        normalized === 'nuxt.config.js' ||
+        normalized === 'nuxt.config.mjs'
+      ) {
+        return true;
+      }
+      if (normalized === 'package.json') {
+        const content = contentsByPath.get(filePath) ?? '';
+        if (content.includes('"nuxt"') || content.includes('"@nuxt/')) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+
+  public async discoverRoutes(
+    projectRoot: string,
+    filePaths: ReadonlyArray<string>,
+    contentsByPath: ReadonlyMap<string, string>,
+    sitemapPaths: ReadonlySet<string>,
+  ): Promise<ReadonlyArray<DiscoveredRoute>> {
+    const routes: DiscoveredRoute[] = [];
+
+    // Pre-cache layouts from layouts/**
+    for (const filePath of filePaths) {
+      const normalized = filePath.replace(/\\/g, '/');
+      if (normalized.startsWith('layouts/') && normalized.endsWith('.vue')) {
+        const content = contentsByPath.get(filePath) ?? '';
+        const parsed = parseVueSfc(
+          {
+            pattern: '',
+            filePath,
+            routerKind: 'nuxt',
+            renderingMode: 'ssr-ssg',
+            isPrivate: false,
+            inSitemap: false,
+          },
+          content,
+        );
+        this.layoutResolver.registerLayout({
+          filePath,
+          htmlLang: parsed.htmlLang,
+          title: parsed.title,
+          description: parsed.description,
+          canonical: parsed.canonical,
+          robots: parsed.robots,
+        });
+      }
+    }
+
+    for (const filePath of filePaths) {
+      const normalized = filePath.replace(/\\/g, '/');
+      if (!normalized.startsWith('pages/')) continue;
+      if (!normalized.endsWith('.vue')) continue;
+
+      const relativeInsidePages = normalized.slice('pages/'.length);
+      const pattern = normalizeRoutePattern(relativeInsidePages, 'nuxt');
+      const inSitemap = sitemapPaths.has(pattern);
+
+      routes.push({
+        pattern,
+        filePath,
+        routerKind: 'nuxt',
+        renderingMode: 'ssr-ssg',
+        isPrivate: false,
+        inSitemap,
+      });
+    }
+
+    return routes;
+  }
+
+  public async extractRoute(
+    projectRoot: string,
+    route: DiscoveredRoute,
+    fileContent: string,
+  ): Promise<ExtractedRouteData> {
+    let extracted = parseVueSfc(route, fileContent);
+
+    // Inherit from default layout if present
+    const layoutCandidates = ['layouts/default.vue', 'layouts/main.vue'];
+    extracted = this.layoutResolver.applyInheritance(extracted, layoutCandidates);
+
+    return extracted;
+  }
+}
+
+
+export interface NuxtMetaFields {
+  title?: string;
+  description?: string;
+  canonical?: string;
+}
+
+export function patchNuxtTemplate(
+  sourceCode: string,
+  meta: NuxtMetaFields,
+): string {
+  let result = sourceCode;
+
+  const entries: string[] = [];
+  if (meta.title) entries.push(`  title: '${meta.title.replace(/'/g, "\\'")}',`);
+  if (meta.description) entries.push(`  description: '${meta.description.replace(/'/g, "\\'")}',`);
+  if (meta.canonical) entries.push(`  canonical: '${meta.canonical}',`);
+
+  const seoMetaCall = `useSeoMeta({\n${entries.join('\n')}\n});\n`;
+
+  if (/<script\s+setup[^>]*>/i.test(result)) {
+    if (!/useSeoMeta\s*\(/i.test(result)) {
+      result = result.replace(/(<script\s+setup[^>]*>\s*\n)/i, `$1${seoMetaCall}`);
+    }
+  } else {
+    result = `<script setup lang="ts">\n${seoMetaCall}</script>\n\n` + result;
+  }
+
+  return result;
+}

package/src/php-native-adapter.ts

@@ -0,0 +1,46 @@
+export interface PhpNativeMetaFields {
+  title?: string;
+  description?: string;
+  canonical?: string;
+}
+
+export function patchPhpNativeTemplate(
+  sourceCode: string,
+  meta: PhpNativeMetaFields,
+): string {
+  let result = sourceCode;
+
+  const vars: string[] = [];
+  if (meta.title && !/\$pageTitle\s*=/i.test(result)) {
+    vars.push(`$pageTitle = '${meta.title.replace(/'/g, "\\'")}';`);
+  }
+  if (meta.description && !/\$metaDescription\s*=/i.test(result)) {
+    vars.push(`$metaDescription = '${meta.description.replace(/'/g, "\\'")}';`);
+  }
+  if (meta.canonical && !/\$canonicalUrl\s*=/i.test(result)) {
+    vars.push(`$canonicalUrl = '${meta.canonical.replace(/'/g, "\\'")}';`);
+  }
+
+  if (vars.length === 0) {
+    return result;
+  }
+
+  const varsBlock = vars.join('\n') + '\n';
+
+  // If file starts with <?php, inject before any header include
+  if (/<\?php/i.test(result)) {
+    if (/(include|require|include_once|require_once)\s*['"][^'"]*header[^'"]*['"]/i.test(result)) {
+      result = result.replace(
+        /((?:include|require|include_once|require_once)\s*['"][^'"]*header[^'"]*['"])/i,
+        `${varsBlock}$1`,
+      );
+    } else {
+      result = result.replace(/(<\?php\s*\n)/i, `$1${varsBlock}`);
+    }
+  } else {
+    result = `<?php\n${varsBlock}?>\n` + result;
+  }
+
+  return result;
+}
+

package/src/sitemap-builder.ts

@@ -0,0 +1,57 @@
+export interface SitemapRouteEntry {
+  pattern: string;
+  isPrivate: boolean;
+  lastmod?: string;
+  changefreq?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+  priority?: number;
+}
+
+export function buildSitemapXml(
+  routes: ReadonlyArray<SitemapRouteEntry>,
+  siteUrl: string,
+): string {
+  const cleanBase = siteUrl.replace(/\/+$/, '');
+  const publicRoutes = routes.filter((r) => !r.isPrivate);
+
+  const urlEntries = publicRoutes.map((r) => {
+    const cleanPattern = r.pattern.startsWith('/') ? r.pattern : `/${r.pattern}`;
+    const loc = `${cleanBase}${cleanPattern === '/' ? '' : cleanPattern}`;
+    const lastmodTag = r.lastmod ? `\n    <lastmod>${r.lastmod}</lastmod>` : '';
+    const changefreqTag = r.changefreq ? `\n    <changefreq>${r.changefreq}</changefreq>` : '';
+    const priorityTag = typeof r.priority === 'number' ? `\n    <priority>${r.priority.toFixed(1)}</priority>` : '';
+
+    return `  <url>\n    <loc>${loc}</loc>${lastmodTag}${changefreqTag}${priorityTag}\n  </url>`;
+  });
+
+  return [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+    ...urlEntries,
+    '</urlset>',
+  ].join('\n');
+}
+
+export function buildNextJsAppSitemap(
+  routes: ReadonlyArray<SitemapRouteEntry>,
+  siteUrl: string,
+): string {
+  const cleanBase = siteUrl.replace(/\/+$/, '');
+  const publicRoutes = routes.filter((r) => !r.isPrivate);
+
+  const items = publicRoutes.map((r) => {
+    const cleanPattern = r.pattern.startsWith('/') ? r.pattern : `/${r.pattern}`;
+    const loc = `${cleanBase}${cleanPattern === '/' ? '' : cleanPattern}`;
+    return `    {\n      url: '${loc}',\n      lastModified: new Date(),\n      changeFrequency: 'weekly',\n      priority: ${cleanPattern === '/' ? '1.0' : '0.8'},\n    },`;
+  });
+
+  return [
+    "import type { MetadataRoute } from 'next';",
+    '',
+    'export default function sitemap(): MetadataRoute.Sitemap {',
+    '  return [',
+    ...items,
+    '  ];',
+    '}',
+  ].join('\n');
+}
+

package/src/skeleton-detector.ts

@@ -0,0 +1,56 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export interface SeoFileInventory {
+  robots: {
+    appRobotsTs?: string;
+    publicRobotsTxt?: string;
+    hasConflict: boolean;
+  };
+  sitemap: {
+    appSitemapTs?: string;
+    publicSitemapXml?: string;
+    hasConflict: boolean;
+  };
+}
+
+export function detectSeoFileInventory(projectRoot: string): SeoFileInventory {
+  const checkExists = (rel: string) => {
+    const full = path.join(projectRoot, rel);
+    return fs.existsSync(full) ? rel : undefined;
+  };
+
+  const appRobotsTs =
+    checkExists('app/robots.ts') ||
+    checkExists('app/robots.js') ||
+    checkExists('src/app/robots.ts') ||
+    checkExists('src/app/robots.js');
+
+  const publicRobotsTxt =
+    checkExists('public/robots.txt') ||
+    checkExists('robots.txt');
+
+  const appSitemapTs =
+    checkExists('app/sitemap.ts') ||
+    checkExists('app/sitemap.js') ||
+    checkExists('src/app/sitemap.ts') ||
+    checkExists('src/app/sitemap.js');
+
+  const publicSitemapXml =
+    checkExists('public/sitemap.xml') ||
+    checkExists('sitemap.xml');
+
+  return {
+    robots: {
+      appRobotsTs,
+      publicRobotsTxt,
+      hasConflict: Boolean(appRobotsTs && publicRobotsTxt),
+    },
+    sitemap: {
+      appSitemapTs,
+      publicSitemapXml,
+      hasConflict: Boolean(appSitemapTs && publicSitemapXml),
+    },
+  };
+}
+