multivmlabs · rubenmarcus · Jun 16, 2026 · Jun 10, 2026 · Jun 10, 2026 · Jun 16, 2026
diff --git a/README.md b/README.md
@@ -102,6 +102,16 @@ export default defineNuxtConfig({
 });
 ```
 
+### SvelteKit
+
+```json
+{
+  "scripts": {
+    "postbuild": "node -e \"import('aeo.js/sveltekit').then(m => m.postBuild({ title: 'My Site', url: 'https://mysite.com' }))\""
+  }
+}
+```
+
 ### Angular
 
 ```json
@@ -147,6 +157,7 @@ npx aeo.js check
 | Next.js | `aeo.js/next` |
 | Vite | `aeo.js/vite` |
 | Nuxt | `aeo.js/nuxt` |
+| SvelteKit | `aeo.js/sveltekit` |
 | Angular | `aeo.js/angular` |
 | Webpack | `aeo.js/webpack` |
 | CLI | `npx aeo.js generate` |

diff --git a/package.json b/package.json
@@ -45,6 +45,11 @@
       "import": "./dist/angular.mjs",
       "require": "./dist/angular.js"
     },
+    "./sveltekit": {
+      "types": "./dist/sveltekit.d.ts",
+      "import": "./dist/sveltekit.mjs",
+      "require": "./dist/sveltekit.js"
+    },
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.mjs",

diff --git a/src/plugins/sveltekit.test.ts b/src/plugins/sveltekit.test.ts
@@ -0,0 +1,168 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { postBuild, generate, getWidgetScript } from './sveltekit';
+import { mkdtempSync, mkdirSync, writeFileSync, readFileSync, existsSync, rmSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+
+let projectDir: string;
+let originalCwd: string;
+
+beforeEach(() => {
+  originalCwd = process.cwd();
+  projectDir = mkdtempSync(join(tmpdir(), 'aeo-sveltekit-'));
+  process.chdir(projectDir);
+});
+
+afterEach(() => {
+  process.chdir(originalCwd);
+  rmSync(projectDir, { recursive: true, force: true });
+});
+
+function writePage(relDir: string, html: string): void {
+  const dir = join(projectDir, relDir);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, 'index.html'), html, 'utf-8');
+}
+
+const HTML = (title: string) =>
+  `<!doctype html><html><head><title>${title}</title><meta name="description" content="Description for ${title} that is long enough."></head><body><h1>${title}</h1><p>Some real content about ${title} for extraction purposes.</p></body></html>`;
+
+describe('getWidgetScript', () => {
+  it('returns a module script with the widget config', () => {
+    const script = getWidgetScript({ title: 'My Site', url: 'https://mysite.com' });
+    expect(script).toContain('<script type="module">');
+    expect(script).toContain("import('aeo.js/widget')");
+    expect(script).toContain('My Site');
+  });
+
+  it('returns empty string when the widget is disabled', () => {
+    expect(getWidgetScript({ widget: { enabled: false } })).toBe('');
+  });
+});
+
+describe('generate (source routes)', () => {
+  it('discovers routes from src/routes, skipping dynamic and group segments', async () => {
+    const routes = join(projectDir, 'src', 'routes');
+    mkdirSync(join(routes, 'about'), { recursive: true });
+    mkdirSync(join(routes, '(marketing)', 'pricing'), { recursive: true });
+    mkdirSync(join(routes, 'blog', '[slug]'), { recursive: true });
+    writeFileSync(join(routes, '+page.svelte'), '<h1>Home</h1>');
+    writeFileSync(join(routes, 'about', '+page.svelte'), '<h1>About</h1>');
+    writeFileSync(join(routes, '(marketing)', 'pricing', '+page.svelte'), '<h1>Pricing</h1>');
+    writeFileSync(join(routes, 'blog', '[slug]', '+page.svelte'), '<h1>Post</h1>');
+
+    await generate({ title: 'My Site', url: 'https://mysite.com', widget: { enabled: false } });
+
+    const llms = readFileSync(join(projectDir, 'static', 'llms.txt'), 'utf-8');
+    expect(llms).toContain('/about');
+    // (marketing) group does not contribute a URL segment
+    expect(llms).toContain('/pricing');
+    expect(llms).not.toContain('(marketing)');
+    expect(llms).not.toContain('[slug]');
+  });
+});
+
+describe('postBuild (adapter-static)', () => {
+  it('scans build/ output, generates AEO files, and injects the widget', async () => {
+    writePage('build', HTML('Home'));
+    writePage('build/about', HTML('About'));
+
+    await postBuild({ title: 'My Site', url: 'https://mysite.com' });
+
+    expect(existsSync(join(projectDir, 'build', 'robots.txt'))).toBe(true);
+    expect(existsSync(join(projectDir, 'build', 'llms.txt'))).toBe(true);
+    expect(existsSync(join(projectDir, 'build', 'sitemap.xml'))).toBe(true);
+
+    const llms = readFileSync(join(projectDir, 'build', 'llms.txt'), 'utf-8');
+    expect(llms).toContain('/about');
+
+    const home = readFileSync(join(projectDir, 'build', 'index.html'), 'utf-8');
+    expect(home).toContain("import('aeo.js/widget')");
+  });
+
+  it('does not inject the widget when disabled', async () => {
+    writePage('build', HTML('Home'));
+
+    await postBuild({ title: 'My Site', url: 'https://mysite.com', widget: { enabled: false } });
+
+    const home = readFileSync(join(projectDir, 'build', 'index.html'), 'utf-8');
+    expect(home).not.toContain('aeo.js/widget');
+  });
+
+  it('does not double-inject the widget on repeated runs', async () => {
+    writePage('build', HTML('Home'));
+
+    await postBuild({ title: 'My Site', url: 'https://mysite.com' });
+    await postBuild({ title: 'My Site', url: 'https://mysite.com' });
+
+    const home = readFileSync(join(projectDir, 'build', 'index.html'), 'utf-8');
+    expect(home.match(/aeo\.js\/widget/g)).toHaveLength(1);
+  });
+
+  it('falls back to .svelte-kit output for non-static adapters', async () => {
+    writePage('.svelte-kit/output/client', '<!doctype html><html><body></body></html>');
+    // remove the placeholder html — client dir usually only has assets
+    rmSync(join(projectDir, '.svelte-kit', 'output', 'client', 'index.html'));
+    writePage('.svelte-kit/output/prerendered/pages', HTML('Home'));
+
+    await postBuild({ title: 'My Site', url: 'https://mysite.com', widget: { enabled: false } });
+
+    const outDir = join(projectDir, '.svelte-kit', 'output', 'client');
+    expect(existsSync(join(outDir, 'robots.txt'))).toBe(true);
+
+    const llms = readFileSync(join(outDir, 'llms.txt'), 'utf-8');
+    expect(llms).toContain('Home');
+  });
+
+  it('injects the widget into prerendered/pages for non-static adapters', async () => {
+    writePage('.svelte-kit/output/client', '<!doctype html><html><body></body></html>');
+    rmSync(join(projectDir, '.svelte-kit', 'output', 'client', 'index.html'));
+    writePage('.svelte-kit/output/prerendered/pages', HTML('Home'));
+
+    await postBuild({ title: 'My Site', url: 'https://mysite.com' });
+
+    const prerenderedHome = readFileSync(
+      join(projectDir, '.svelte-kit', 'output', 'prerendered', 'pages', 'index.html'),
+      'utf-8',
+    );
+    expect(prerenderedHome).toContain("import('aeo.js/widget')");
+  });
+
+  it('config.pages overrides take priority over auto-discovered pages with the same pathname', async () => {
+    // Auto-discovered page has content extracted from HTML; user-provided page
+    // explicitly sets a custom title that should win.
+    writePage('build', HTML('Auto Home Title'));
+    writePage('build/about', HTML('Auto About'));
+
+    await postBuild({
+      title: 'My Site',
+      url: 'https://mysite.com',
+      widget: { enabled: false },
+      pages: [
+        { pathname: '/', title: 'Custom Home Title', description: 'Custom home description.' },
+      ],
+    });
+
+    const llms = readFileSync(join(projectDir, 'build', 'llms.txt'), 'utf-8');
+    expect(llms).toContain('Custom Home Title');
+    expect(llms).not.toContain('Auto Home Title');
+  });
+});
+
+describe('getWidgetScript (script tag safety)', () => {
+  it('escapes </script> sequences in serialized config', () => {
+    const script = getWidgetScript({
+      title: 'Safe</script><script>alert(1)',
+      url: 'https://mysite.com',
+    });
+    // Extract just the JSON config argument — everything between `config: ` and
+    // the closing `}` of the AeoWidget call. The raw sequence </script> must
+    // not appear there; it would prematurely close the enclosing script element.
+    const configMatch = script.match(/new AeoWidget\(\{ config: (.+?) \}\)/s);
+    expect(configMatch).not.toBeNull();
+    const jsonPart = configMatch![1];
+    expect(jsonPart).not.toContain('</script>');
+    // The title value should be present in its unicode-escaped form.
+    expect(jsonPart).toContain('\\u003c/script\\u003e');
+  });
+});