@axerity/cli 0.1.0

package/src/routes/llms-full.txt/+server.ts

@@ -0,0 +1,22 @@
+import { base } from '$app/paths';
+import { site } from '$lib/config/site';
+import { flatPages } from '$lib/content';
+import { getRawMarkdown } from '$lib/content/raw';
+import type { RequestHandler } from './$types';
+
+export const prerender = true;
+
+export const GET: RequestHandler = async () => {
+	const parts = [`# ${site.name}`];
+	if (site.description) parts.push('', `> ${site.description}`);
+
+	for (const page of flatPages) {
+		const slug = page.href.slice(base.length).replace(/^\//, '');
+		const markdown = await getRawMarkdown(slug);
+		if (markdown) parts.push('', '---', '', markdown);
+	}
+
+	return new Response(parts.join('\n') + '\n', {
+		headers: { 'content-type': 'text/plain; charset=utf-8' }
+	});
+};

package/src/routes/llms.txt/+server.ts

@@ -0,0 +1,20 @@
+import { site } from '$lib/config/site';
+import { flatPages } from '$lib/content';
+import type { RequestHandler } from './$types';
+
+export const prerender = true;
+
+export const GET: RequestHandler = () => {
+	const lines = [`# ${site.name}`, ''];
+	if (site.description) lines.push(`> ${site.description}`, '');
+	lines.push('## Docs', '');
+
+	for (const page of flatPages) {
+		const suffix = page.description ? `: ${page.description}` : '';
+		lines.push(`- [${page.title}](${page.href}.md)${suffix}`);
+	}
+
+	return new Response(lines.join('\n') + '\n', {
+		headers: { 'content-type': 'text/plain; charset=utf-8' }
+	});
+};

package/src/routes/og/[...slug]/+server.ts

@@ -0,0 +1,77 @@
+import { error } from '@sveltejs/kit';
+import { base } from '$app/paths';
+import { site } from '$lib/config/site';
+import { renderOgImage } from '$lib/server/og';
+import type { PageFrontmatter } from '$lib/types';
+import type { EntryGenerator, RequestHandler } from './$types';
+
+const pages = import.meta.glob<{ metadata: PageFrontmatter }>('/src/content/docs/**/*.md', {
+	eager: true
+});
+
+const BASE = '/src/content/docs/';
+
+const WEIGHTS = [400, 600, 700] as const;
+let fontCache: { data: ArrayBuffer; weight: 400 | 600 | 700 }[] | null = null;
+
+async function getFonts(fetch: typeof globalThis.fetch) {
+	if (!fontCache) {
+		fontCache = await Promise.all(
+			WEIGHTS.map(async (weight) => {
+				const response = await fetch(`${base}/fonts/geist-${weight}.ttf`);
+				return { data: await response.arrayBuffer(), weight };
+			})
+		);
+	}
+	return fontCache;
+}
+
+const logoPath = site.og?.logo ?? site.logo?.dark ?? site.logo?.light;
+let logoCache: string | null | undefined;
+
+async function getLogo(fetch: typeof globalThis.fetch): Promise<string | undefined> {
+	if (logoCache === undefined) {
+		if (!logoPath) {
+			logoCache = null;
+		} else {
+			const response = await fetch(logoPath);
+			const svg = await response.text();
+			logoCache = `data:image/svg+xml;base64,${Buffer.from(svg).toString('base64')}`;
+		}
+	}
+	return logoCache ?? undefined;
+}
+
+export const prerender = true;
+
+export const entries: EntryGenerator = () => {
+	return Object.keys(pages).map((path) => ({
+		slug: `${path.slice(BASE.length).replace(/\.md$/, '')}.png`
+	}));
+};
+
+export const GET: RequestHandler = async ({ params, fetch }) => {
+	const key = params.slug.replace(/\.png$/, '');
+	const mod = pages[`${BASE}${key}.md`];
+	if (!mod) error(404, 'Not found');
+
+	const fm = mod.metadata ?? {};
+	const fonts = await getFonts(fetch);
+	const logo = await getLogo(fetch);
+
+	const png = await renderOgImage({
+		title: fm.title ?? site.name,
+		description: fm.description ?? site.description,
+		siteName: site.name,
+		og: site.og,
+		fonts,
+		logo
+	});
+
+	return new Response(new Uint8Array(png), {
+		headers: {
+			'content-type': 'image/png',
+			'cache-control': 'public, max-age=31536000, immutable'
+		}
+	});
+};

package/src/routes/rss.xml/+server.ts

@@ -0,0 +1,65 @@
+import { base as basePath } from '$app/paths';
+import { site } from '$lib/config/site';
+import type { PageFrontmatter } from '$lib/types';
+import type { RequestHandler } from './$types';
+
+const pages = import.meta.glob<{ metadata: PageFrontmatter }>('/src/content/docs/**/*.md', {
+	eager: true
+});
+
+const BASE = '/src/content/docs/';
+
+function pathToSlug(path: string): string {
+	const rel = path.slice(BASE.length).replace(/\.md$/, '');
+	return rel === 'index' ? '' : rel.replace(/\/index$/, '');
+}
+
+function escapeXml(value: string): string {
+	return value
+		.replace(/&/g, '&amp;')
+		.replace(/</g, '&lt;')
+		.replace(/>/g, '&gt;')
+		.replace(/"/g, '&quot;')
+		.replace(/'/g, '&apos;');
+}
+
+export const prerender = true;
+
+export const GET: RequestHandler = () => {
+	const origin = (site.url ?? '') + basePath;
+
+	const items = Object.entries(pages)
+		.map(([path, mod]) => ({ slug: pathToSlug(path), fm: mod.metadata ?? {} }))
+		.filter((entry) => Boolean(entry.fm.date))
+		.sort(
+			(a, b) => new Date(b.fm.date as string).getTime() - new Date(a.fm.date as string).getTime()
+		)
+		.map((entry) => {
+			const link = `${origin}/${entry.slug}`;
+			const title = escapeXml(entry.fm.title ?? entry.slug);
+			const description = escapeXml(entry.fm.description ?? '');
+			const pubDate = new Date(entry.fm.date as string).toUTCString();
+			return `    <item>
+      <title>${title}</title>
+      <link>${link}</link>
+      <guid>${link}</guid>
+      <pubDate>${pubDate}</pubDate>
+      <description>${description}</description>
+    </item>`;
+		})
+		.join('\n');
+
+	const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0">
+  <channel>
+    <title>${escapeXml(site.name)}</title>
+    <link>${origin}</link>
+    <description>${escapeXml(site.description ?? '')}</description>
+${items}
+  </channel>
+</rss>`;
+
+	return new Response(xml, {
+		headers: { 'content-type': 'application/xml; charset=utf-8' }
+	});
+};

package/src/routes/search.json/+server.ts

@@ -0,0 +1,54 @@
+import { base } from '$app/paths';
+import { sidebar } from '$lib/content';
+import { getRawMarkdown } from '$lib/content/raw';
+import type { NavEntry } from '$lib/types';
+import type { RequestHandler } from './$types';
+
+export const prerender = true;
+
+function plainText(markdown: string): string {
+	return markdown
+		.replace(/```[\s\S]*?```/g, ' ')
+		.replace(/<[^>]+>/g, ' ')
+		.replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
+		.replace(/[#>*_`|]/g, ' ')
+		.replace(/\s+/g, ' ')
+		.trim()
+		.slice(0, 3000);
+}
+
+export const GET: RequestHandler = async () => {
+	const docs: Array<{
+		id: string;
+		title: string;
+		section: string;
+		description: string;
+		content: string;
+		href: string;
+	}> = [];
+
+	async function walk(entries: NavEntry[], section: string) {
+		for (const entry of entries) {
+			if ('href' in entry) {
+				const slug = entry.href.slice(base.length).replace(/^\//, '');
+				const raw = await getRawMarkdown(slug);
+				docs.push({
+					id: entry.href,
+					title: entry.title,
+					section,
+					description: entry.description ?? '',
+					content: raw ? plainText(raw) : '',
+					href: entry.href
+				});
+			} else {
+				await walk(entry.items, section);
+			}
+		}
+	}
+
+	for (const group of sidebar) await walk(group.items, group.title);
+
+	return new Response(JSON.stringify(docs), {
+		headers: { 'content-type': 'application/json' }
+	});
+};

package/src/routes/sitemap.xml/+server.ts

@@ -0,0 +1,21 @@
+import { site } from '$lib/config/site';
+import { flatPages } from '$lib/content';
+import type { RequestHandler } from './$types';
+
+export const prerender = true;
+
+export const GET: RequestHandler = ({ url }) => {
+	const origin = site.url ?? url.origin;
+	const urls = flatPages
+		.map((page) => `\t<url>\n\t\t<loc>${origin}${page.href}</loc>\n\t</url>`)
+		.join('\n');
+
+	const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`;
+
+	return new Response(xml, {
+		headers: { 'content-type': 'application/xml' }
+	});
+};

package/static/favicon-dark.svg

@@ -0,0 +1,6 @@
+<svg viewBox="0 0 284 294" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M18.2074 162.62L131.021 19.7881" stroke="#FFFFFF" stroke-width="20"/>
+  <path d="M81.7836 77.8522C74.921 78.6033 69.9667 84.7754 70.7177 91.6379L82.9574 203.47C83.7085 210.333 89.8806 215.287 96.7432 214.536C103.606 213.785 108.56 207.613 107.809 200.75L96.9293 101.344L196.336 90.4641C203.198 89.713 208.153 83.5409 207.402 76.6783C206.65 69.8158 200.478 64.8614 193.616 65.6125L81.7836 77.8522ZM207.138 189.809L214.963 180.06L90.9683 80.53L83.1435 90.278L75.3188 100.026L199.313 199.557L207.138 189.809Z" fill="#FFFFFF"/>
+  <line x1="195.077" y1="29.6894" x2="211.177" y2="210.987" stroke="#FFFFFF" stroke-width="20"/>
+  <line x1="219.599" y1="200.204" x2="39.3612" y2="225.545" stroke="#FFFFFF" stroke-width="20"/>
+</svg>

package/static/favicon-light.svg

@@ -0,0 +1,6 @@
+<svg viewBox="0 0 284 294" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M18.2074 162.62L131.021 19.7881" stroke="#000000" stroke-width="20"/>
+  <path d="M81.7836 77.8522C74.921 78.6033 69.9667 84.7754 70.7177 91.6379L82.9574 203.47C83.7085 210.333 89.8806 215.287 96.7432 214.536C103.606 213.785 108.56 207.613 107.809 200.75L96.9293 101.344L196.336 90.4641C203.198 89.713 208.153 83.5409 207.402 76.6783C206.65 69.8158 200.478 64.8614 193.616 65.6125L81.7836 77.8522ZM207.138 189.809L214.963 180.06L90.9683 80.53L83.1435 90.278L75.3188 100.026L199.313 199.557L207.138 189.809Z" fill="#000000"/>
+  <line x1="195.077" y1="29.6894" x2="211.177" y2="210.987" stroke="#000000" stroke-width="20"/>
+  <line x1="219.599" y1="200.204" x2="39.3612" y2="225.545" stroke="#000000" stroke-width="20"/>
+</svg>

package/static/favicon.svg

@@ -0,0 +1,14 @@
+<svg viewBox="0 0 284 294" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .s { stroke: #0a0a0a; }
+    .f { fill: #0a0a0a; }
+    @media (prefers-color-scheme: dark) {
+      .s { stroke: #fafafa; }
+      .f { fill: #fafafa; }
+    }
+  </style>
+  <path class="s" d="M18.2074 162.62L131.021 19.7881" stroke-width="20"/>
+  <path class="f" d="M81.7836 77.8522C74.921 78.6033 69.9667 84.7754 70.7177 91.6379L82.9574 203.47C83.7085 210.333 89.8806 215.287 96.7432 214.536C103.606 213.785 108.56 207.613 107.809 200.75L96.9293 101.344L196.336 90.4641C203.198 89.713 208.153 83.5409 207.402 76.6783C206.65 69.8158 200.478 64.8614 193.616 65.6125L81.7836 77.8522ZM207.138 189.809L214.963 180.06L90.9683 80.53L83.1435 90.278L75.3188 100.026L199.313 199.557L207.138 189.809Z"/>
+  <line class="s" x1="195.077" y1="29.6894" x2="211.177" y2="210.987" stroke-width="20"/>
+  <line class="s" x1="219.599" y1="200.204" x2="39.3612" y2="225.545" stroke-width="20"/>
+</svg>

package/static/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://axerity.com/sitemap.xml

package/svelte.config.js

@@ -0,0 +1,35 @@
+import { readFileSync } from 'node:fs';
+import { mdsvex } from 'mdsvex';
+import adapter from '@sveltejs/adapter-static';
+import mdsvexConfig from './mdsvex.config.js';
+
+// serve the site under a sub-path when `basePath` is set in axerity.json
+let basePath = '';
+
+try {
+	basePath = JSON.parse(readFileSync('./axerity.json', 'utf8')).basePath ?? '';
+} catch {
+	// theres no config
+}
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+	compilerOptions: {
+		runes: ({ filename }) => (filename.split(/[/\\]/).includes('node_modules') ? undefined : true),
+		warningFilter: (warning) =>
+			!(warning.code === 'script_context_deprecated' && /\.(md|svx)$/.test(warning.filename ?? ''))
+	},
+	kit: {
+		adapter: adapter({ fallback: '404.html' }),
+		// The CLI points this at a gitignored merge of the engine's static assets
+		// and the user's public/ folder, so the tracked static/ is never touched.
+		files: { assets: process.env.AXERITY_ASSETS || 'static' },
+		// Absolute base (not relative to the page) so `base` is a stable prefix
+		// for both links and absolute URLs like OpenGraph images.
+		paths: { base: basePath, relative: false }
+	},
+	preprocess: [mdsvex(mdsvexConfig)],
+	extensions: ['.svelte', '.svx', '.md']
+};
+
+export default config;

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+	"extends": "./.svelte-kit/tsconfig.json",
+	"compilerOptions": {
+		"rewriteRelativeImportExtensions": true,
+		"allowJs": true,
+		"checkJs": true,
+		"esModuleInterop": true,
+		"forceConsistentCasingInFileNames": true,
+		"resolveJsonModule": true,
+		"skipLibCheck": true,
+		"sourceMap": true,
+		"strict": true,
+		"moduleResolution": "bundler"
+	}
+	// Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
+	// except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
+	//
+	// To make changes to top-level options such as include and exclude, we recommend extending
+	// the generated config; see https://svelte.dev/docs/kit/configuration#typescript
+}

package/vite.config.ts

@@ -0,0 +1,46 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import tailwindcss from '@tailwindcss/vite';
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+import { generateApiDocs } from './src/lib/openapi/generate';
+
+const allow = process.env.AXERITY_FS_ALLOW;
+
+function openapi() {
+	const localSpecs: string[] = [];
+	const run = async () => {
+		try {
+			const openapi = JSON.parse(readFileSync('./axerity.json', 'utf8')).openapi;
+			if (!openapi) return;
+			const sources = (Array.isArray(openapi) ? openapi : [openapi]).map((o) =>
+				typeof o === 'string' ? { spec: o } : o
+			);
+			localSpecs.length = 0;
+			for (const s of sources) {
+				if (s.spec && !/^https?:\/\//.test(s.spec)) localSpecs.push(resolve(s.spec));
+			}
+			await generateApiDocs(openapi, 'src/content/docs');
+		} catch {
+			// theres nothing
+		}
+	};
+	return {
+		name: 'axerity:openapi',
+		async buildStart() {
+			await run();
+		},
+		async configureServer(server: import('vite').ViteDevServer) {
+			await run();
+			for (const spec of localSpecs) server.watcher.add(spec);
+			server.watcher.on('change', (file: string) => {
+				if (localSpecs.includes(file)) run();
+			});
+		}
+	};
+}
+
+export default defineConfig({
+	plugins: [openapi(), tailwindcss(), sveltekit()],
+	server: allow ? { fs: { allow: ['.', allow] } } : undefined
+});