@seo-partner/adapters 0.0.0-stage → 1.0.0

package/src/remix-adapter.ts

@@ -0,0 +1,123 @@
+import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
+import type { AdapterCapabilities, AdapterVersion, FrameworkAdapter } from './contract.js';
+import { parseRemixRoute } from './parsers/remix-parser.js';
+import { normalizeRoutePattern } from './parsers/route-normalizer.js';
+import { LayoutResolver } from './parsers/layout-resolver.js';
+
+export class RemixAdapter implements FrameworkAdapter {
+  public readonly id = 'remix';
+  public readonly name = 'Remix / React Router v7';
+  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 === 'remix.config.js' ||
+        normalized === 'remix.config.ts' ||
+        normalized === 'remix.config.mjs' ||
+        normalized === 'react-router.config.ts' ||
+        normalized === 'react-router.config.js'
+      ) {
+        return true;
+      }
+      if (normalized === 'package.json') {
+        const content = contentsByPath.get(filePath) ?? '';
+        if (
+          content.includes('"@remix-run/') ||
+          content.includes('"react-router"')
+        ) {
+          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 root layout from app/root.tsx
+    for (const filePath of filePaths) {
+      const normalized = filePath.replace(/\\/g, '/');
+      if (normalized === 'app/root.tsx' || normalized === 'app/root.jsx') {
+        const content = contentsByPath.get(filePath) ?? '';
+        const parsed = parseRemixRoute(
+          {
+            pattern: '',
+            filePath,
+            routerKind: 'remix',
+            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('app/routes/')) continue;
+      if (!/\.(tsx|jsx|ts|js)$/i.test(normalized)) continue;
+
+      const relativeInsideRoutes = normalized.slice('app/routes/'.length);
+      const pattern = normalizeRoutePattern(relativeInsideRoutes, 'remix');
+      const inSitemap = sitemapPaths.has(pattern);
+
+      routes.push({
+        pattern,
+        filePath,
+        routerKind: 'remix',
+        renderingMode: 'ssr-ssg',
+        isPrivate: false,
+        inSitemap,
+      });
+    }
+
+    return routes;
+  }
+
+  public async extractRoute(
+    projectRoot: string,
+    route: DiscoveredRoute,
+    fileContent: string,
+  ): Promise<ExtractedRouteData> {
+    let extracted = parseRemixRoute(route, fileContent);
+
+    // Apply root layout inheritance
+    const layoutCandidates = ['app/root.tsx', 'app/root.jsx'];
+    extracted = this.layoutResolver.applyInheritance(extracted, layoutCandidates);
+
+    return extracted;
+  }
+}
+

package/src/static-adapter.ts

@@ -0,0 +1,62 @@
+import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
+import type { AdapterCapabilities, FrameworkAdapter } from './contract.js';
+import { isPrivateRoutePattern } from './nextjs-adapter.js';
+import { parseStaticHtmlOrMarkdown } from './parsers/html-parser.js';
+
+export class StaticAdapter implements FrameworkAdapter {
+  public readonly id = 'static-html';
+  public readonly name = 'Static HTML & Markdown';
+  public readonly version = '1.0' as const;
+  public readonly capabilities: AdapterCapabilities = {
+    routes: true,
+    metadata: true,
+    headings: true,
+    internalLinks: true,
+    jsonLd: true,
+    images: true,
+    robotsAndSitemap: true,
+  };
+
+  public async detect(
+    _projectRoot: string,
+    filePaths: ReadonlyArray<string>,
+  ): Promise<boolean> {
+    return filePaths.some((p) => p.endsWith('.html'));
+  }
+
+  public async discoverRoutes(
+    _projectRoot: string,
+    filePaths: ReadonlyArray<string>,
+    _contentsByPath: ReadonlyMap<string, string>,
+    sitemapPaths: ReadonlySet<string>,
+  ): Promise<ReadonlyArray<DiscoveredRoute>> {
+    const routes: DiscoveredRoute[] = [];
+    for (const filePath of filePaths) {
+      if (filePath.endsWith('.html')) {
+        const clean = filePath
+          .replace(/^public\//, '')
+          .replace(/index\.html$/, '')
+          .replace(/\.html$/, '');
+        const pattern = clean.startsWith('/') ? clean : `/${clean}`;
+        routes.push({
+          pattern: pattern === '' ? '/' : pattern,
+          filePath,
+          routerKind: 'static-html',
+          renderingMode: 'static',
+          isPrivate: isPrivateRoutePattern(pattern),
+          inSitemap: sitemapPaths.has(pattern),
+        });
+      }
+    }
+    return routes;
+  }
+
+  public async extractRoute(
+    _projectRoot: string,
+    route: DiscoveredRoute,
+    fileContent: string,
+  ): Promise<ExtractedRouteData> {
+    return parseStaticHtmlOrMarkdown(route, fileContent);
+  }
+}
+

package/src/sveltekit-adapter.ts

@@ -0,0 +1,119 @@
+import type { DiscoveredRoute, ExtractedRouteData } from '@seo-partner/core';
+import type { AdapterCapabilities, AdapterVersion, FrameworkAdapter } from './contract.js';
+import { parseSvelteComponent } from './parsers/svelte-parser.js';
+import { normalizeRoutePattern } from './parsers/route-normalizer.js';
+import { LayoutResolver } from './parsers/layout-resolver.js';
+
+export class SvelteKitAdapter implements FrameworkAdapter {
+  public readonly id = 'sveltekit';
+  public readonly name = 'SvelteKit';
+  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 === 'svelte.config.js' ||
+        normalized === 'svelte.config.ts' ||
+        normalized === 'svelte.config.mjs' ||
+        normalized === 'svelte.config.cjs'
+      ) {
+        return true;
+      }
+      if (normalized === 'package.json') {
+        const content = contentsByPath.get(filePath) ?? '';
+        if (content.includes('"@sveltejs/kit"')) {
+          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 src/routes/**/+layout.svelte
+    for (const filePath of filePaths) {
+      const normalized = filePath.replace(/\\/g, '/');
+      if (normalized.startsWith('src/routes/') && normalized.endsWith('+layout.svelte')) {
+        const content = contentsByPath.get(filePath) ?? '';
+        const parsed = parseSvelteComponent(
+          {
+            pattern: '',
+            filePath,
+            routerKind: 'sveltekit',
+            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('src/routes/')) continue;
+      if (!normalized.endsWith('+page.svelte')) continue;
+
+      const relativeInsideRoutes = normalized.slice('src/routes/'.length);
+      const pattern = normalizeRoutePattern(relativeInsideRoutes, 'sveltekit');
+      const inSitemap = sitemapPaths.has(pattern);
+
+      routes.push({
+        pattern,
+        filePath,
+        routerKind: 'sveltekit',
+        renderingMode: 'ssr-ssg',
+        isPrivate: false,
+        inSitemap,
+      });
+    }
+
+    return routes;
+  }
+
+  public async extractRoute(
+    projectRoot: string,
+    route: DiscoveredRoute,
+    fileContent: string,
+  ): Promise<ExtractedRouteData> {
+    let extracted = parseSvelteComponent(route, fileContent);
+
+    // Apply hierarchical layout inheritance from leaf up to root
+    const parentLayouts = this.layoutResolver.findSvelteKitLayoutPaths(route.filePath);
+    extracted = this.layoutResolver.applyInheritance(extracted, parentLayouts);
+
+    return extracted;
+  }
+}
+

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}
+

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.