getfilepress 0.0.0 → 0.1.0

package/packages/app/src/routes/posts/[slug]/+page.svelte

@@ -0,0 +1,95 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import { Newsletter, absoluteUrl, formatDate, ogImageUrl } from '@filepress/core';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+
+	const post = $derived(data.post);
+	const pageTitle = $derived(`${post.title} — ${config.title}`);
+	const canonical = $derived(absoluteUrl(config, `/posts/${post.slug}`));
+	const ogImage = $derived(ogImageUrl(config));
+	const showUpdated = $derived(post.updated && post.updated !== post.date);
+	const adjacent = $derived(data.adjacent);
+</script>
+
+<svelte:head>
+	<title>{pageTitle}</title>
+	{#if post.description}
+		<meta name="description" content={post.description} />
+	{/if}
+	<link rel="canonical" href={canonical} />
+	<meta property="og:type" content="article" />
+	<meta property="og:title" content={post.title} />
+	{#if post.description}
+		<meta property="og:description" content={post.description} />
+	{/if}
+	<meta property="og:url" content={canonical} />
+	{#if ogImage}
+		<meta property="og:image" content={ogImage} />
+		<meta name="twitter:card" content="summary" />
+		<meta name="twitter:image" content={ogImage} />
+	{/if}
+	{#if data.isDraft}
+		<meta name="robots" content="noindex" />
+	{/if}
+</svelte:head>
+
+<article>
+	<header class="post-header">
+		{#if data.isDraft}
+			<p class="draft-banner">
+				Draft — shown in local listings; excluded from production index, feeds, and sitemap.
+			</p>
+		{/if}
+		<h1>{post.title}</h1>
+		<p class="meta">
+			<time datetime={post.date}>{formatDate(post.date)}</time>
+			{#if post.author}
+				&middot; <span class="byline">{post.author}</span>
+			{/if}
+			{#if showUpdated}
+				&middot; updated <time datetime={post.updated}>{formatDate(post.updated!)}</time>
+			{/if}
+		</p>
+		{#if data.tags.length}
+			<ul class="tag-list" style="margin-top:0.75rem">
+				{#each data.tags as { tag, hasPage } (tag)}
+					<li>
+						{#if hasPage}
+							<a href="/tags/{tag}">{tag}</a>
+						{:else}
+							<span class="tag">{tag}</span>
+						{/if}
+					</li>
+				{/each}
+			</ul>
+		{/if}
+	</header>
+
+	<!-- Body HTML is compiled at build time from the owner's own Markdown (trusted). -->
+	<div class="prose">{@html post.html}</div>
+
+	{#if adjacent.older || adjacent.newer}
+		<nav class="post-nav" aria-label="More posts">
+			{#if adjacent.older}
+				<a class="older" href="/posts/{adjacent.older.slug}">
+					<span class="post-nav-label">&larr; Older</span>
+					<span class="post-nav-title">{adjacent.older.title}</span>
+				</a>
+			{:else}
+				<span></span>
+			{/if}
+			{#if adjacent.newer}
+				<a class="newer" href="/posts/{adjacent.newer.slug}">
+					<span class="post-nav-label">Newer &rarr;</span>
+					<span class="post-nav-title">{adjacent.newer.title}</span>
+				</a>
+			{:else}
+				<span></span>
+			{/if}
+		</nav>
+	{/if}
+</article>
+
+<Newsletter newsletter={config.newsletter} />

package/packages/app/src/routes/robots.txt/+server.ts

@@ -0,0 +1,11 @@
+import type { RequestHandler } from './$types';
+import { buildRobotsTxt } from '@filepress/core/server';
+import config from '$site-config';
+
+export const prerender = true;
+
+export const GET: RequestHandler = () => {
+	return new Response(buildRobotsTxt(config), {
+		headers: { 'Content-Type': 'text/plain; charset=utf-8' }
+	});
+};

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

@@ -0,0 +1,13 @@
+import type { RequestHandler } from './$types';
+import { buildRssXml } from '@filepress/core/server';
+import { content } from '$lib/content.server';
+import config from '$site-config';
+
+export const prerender = true;
+
+export const GET: RequestHandler = () => {
+	const xml = buildRssXml(config, content.getPublishedPosts());
+	return new Response(xml, {
+		headers: { 'Content-Type': 'application/xml; charset=utf-8' }
+	});
+};

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

@@ -0,0 +1,19 @@
+import type { RequestHandler } from './$types';
+import { buildSitemapXml } from '@filepress/core/server';
+import { content } from '$lib/content.server';
+import { pages } from '$lib/pages.server';
+import config from '$site-config';
+
+export const prerender = true;
+
+export const GET: RequestHandler = () => {
+	const xml = buildSitemapXml(config, {
+		posts: content.getPublishedPosts(),
+		tags: content.getAllTags(),
+		pageCount: content.getIndexPageCount(config.postsPerPage),
+		pages: pages.getPublishedPages()
+	});
+	return new Response(xml, {
+		headers: { 'Content-Type': 'application/xml; charset=utf-8' }
+	});
+};

package/packages/app/src/routes/tags/+page.server.ts

@@ -0,0 +1,4 @@
+import type { PageServerLoad } from './$types';
+import { content } from '$lib/content.server';
+
+export const load: PageServerLoad = () => ({ tags: content.getAllTags() });

package/packages/app/src/routes/tags/+page.svelte

@@ -0,0 +1,26 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+</script>
+
+<svelte:head>
+	<title>Tags — {config.title}</title>
+	<meta name="description" content="All tags on {config.title}." />
+</svelte:head>
+
+<header class="post-header">
+	<p class="eyebrow">Index</p>
+	<h1>Tags</h1>
+</header>
+
+{#if data.tags.length === 0}
+	<p class="empty-state">No tags yet.</p>
+{:else}
+	<ul class="tag-list">
+		{#each data.tags as { tag, count } (tag)}
+			<li><a href="/tags/{tag}">{tag} ({count})</a></li>
+		{/each}
+	</ul>
+{/if}

package/packages/app/src/routes/tags/[tag]/+page.server.ts

@@ -0,0 +1,15 @@
+import type { EntryGenerator, PageServerLoad } from './$types';
+import { error } from '@sveltejs/kit';
+import { content } from '$lib/content.server';
+
+export const entries: EntryGenerator = () => {
+	return content.getAllTags().map(({ tag }) => ({ tag }));
+};
+
+export const load: PageServerLoad = ({ params }) => {
+	const posts = content.getPostsByTag(params.tag);
+	if (posts.length === 0) {
+		error(404, `No posts tagged "${params.tag}".`);
+	}
+	return { tag: params.tag, posts };
+};

package/packages/app/src/routes/tags/[tag]/+page.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import { PostCard } from '@filepress/core';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+</script>
+
+<svelte:head>
+	<title>{data.tag} — {config.title}</title>
+	<meta name="description" content="Posts tagged {data.tag} on {config.title}." />
+</svelte:head>
+
+<header class="post-header">
+	<p class="eyebrow">Tag</p>
+	<h1>{data.tag}</h1>
+</header>
+
+<ul class="post-list">
+	{#each data.posts as post (post.slug)}
+		<li><PostCard {post} showTags={false} /></li>
+	{/each}
+</ul>

package/packages/app/src/routes/topics/+page.server.ts

@@ -0,0 +1,28 @@
+import type { PageServerLoad } from './$types';
+import type { Topic } from '@filepress/core';
+import { content } from '$lib/content.server';
+import config from '$site-config';
+
+const PREVIEW = 6;
+
+export const load: PageServerLoad = () => {
+	// Curated topics if the site defines them (Stratechery-style Explore);
+	// otherwise fall back to every tag, alphabetically.
+	const source: Topic[] = config.topics.length
+		? config.topics.map((t: Topic) => ({ label: t.label, tag: t.tag }))
+		: content.getAllTags().map((t) => ({ label: t.tag, tag: t.tag }));
+
+	const groups = source
+		.map((topic: Topic) => {
+			const posts = content.getPostsByTag(topic.tag);
+			return {
+				label: topic.label,
+				tag: topic.tag,
+				count: posts.length,
+				posts: posts.slice(0, PREVIEW)
+			};
+		})
+		.filter((g: { count: number }) => g.count > 0);
+
+	return { groups, curated: config.topics.length > 0 };
+};

package/packages/app/src/routes/topics/+page.svelte

@@ -0,0 +1,47 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import { formatDate } from '@filepress/core';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+</script>
+
+<svelte:head>
+	<title>Topics — {config.title}</title>
+	<meta name="description" content="Browse {config.title} by topic." />
+</svelte:head>
+
+<header class="post-header">
+	<p class="eyebrow">Explore</p>
+	<h1>Topics</h1>
+</header>
+
+{#if data.groups.length === 0}
+	<p class="empty-state">No topics yet.</p>
+{:else}
+	{#each data.groups as group (group.tag)}
+		<section class="topic-group">
+			<h2>
+				<a href="/tags/{group.tag}">{group.label}</a>
+				<span class="count">{group.count} post{group.count === 1 ? '' : 's'}</span>
+			</h2>
+			<ul class="topic-posts">
+				{#each group.posts as post (post.slug)}
+					<li>
+						<span class="date">{formatDate(post.date)}</span>
+						<a href="/posts/{post.slug}">{post.title}</a>
+					</li>
+				{/each}
+			</ul>
+			{#if group.count > group.posts.length}
+				<p class="meta" style="margin-top:0.6rem">
+					<a href="/tags/{group.tag}">All {group.count} &rarr;</a>
+				</p>
+			{/if}
+		</section>
+	{/each}
+
+	<p class="meta" style="margin-top:2rem">
+		<a href="/tags">See every tag &rarr;</a>
+	</p>
+{/if}

package/packages/app/src/routes/writing/+page.server.ts

@@ -0,0 +1,12 @@
+import { redirect } from '@sveltejs/kit';
+import type { PageServerLoad } from './$types';
+import { content } from '$lib/content.server';
+import config from '$site-config';
+
+export const load: PageServerLoad = () => {
+	// Without homePage, the post index stays at `/` — keep /writing as an alias.
+	if (!config.homePage) {
+		redirect(302, '/');
+	}
+	return content.getIndexPage(1, config.postsPerPage);
+};

package/packages/app/src/routes/writing/+page.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import type { PageData } from './$types';
+	import { PostIndex, absoluteUrl, ogImageUrl, postsIndexPath } from '@filepress/core';
+	import config from '$site-config';
+
+	let { data }: { data: PageData } = $props();
+
+	const pageTitle = $derived(`Posts — ${config.title}`);
+	const canonical = $derived(absoluteUrl(config, postsIndexPath(config)));
+	const ogImage = $derived(ogImageUrl(config));
+	const description = $derived(
+		`Posts from ${config.title}. ${config.description}`.trim()
+	);
+</script>
+
+<svelte:head>
+	<title>{pageTitle}</title>
+	<meta name="description" content={description} />
+	<link rel="canonical" href={canonical} />
+	<meta property="og:type" content="website" />
+	<meta property="og:title" content="Posts — {config.title}" />
+	<meta property="og:description" content={description} />
+	<meta property="og:url" content={canonical} />
+	{#if ogImage}
+		<meta property="og:image" content={ogImage} />
+		<meta name="twitter:card" content="summary" />
+		<meta name="twitter:image" content={ogImage} />
+	{/if}
+</svelte:head>
+
+<PostIndex
+	site={config}
+	featured={data.featured}
+	posts={data.posts}
+	page={data.page}
+	totalPages={data.totalPages}
+	indexHref={postsIndexPath(config)}
+/>

package/packages/app/src/site-theme.d.ts

@@ -0,0 +1,2 @@
+/** Aliased in vite.config.ts to the site's theme.css (created empty if missing). */
+declare module '$site-theme';

package/packages/app/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"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"
+	}
+}

package/packages/app/vite-plugin-critical-theme.ts

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import type { Plugin } from 'vite';
+
+/**
+ * Extract early paint tokens from the site theme: `:root` blocks (including
+ * those nested in `prefers-color-scheme` media) and top-level `body { ... }`.
+ */
+export function extractCriticalTheme(css: string): string {
+	const chunks: string[] = [];
+
+	// Prefer `:root:root` (higher specificity site tokens) when present.
+	for (const m of css.matchAll(/:root(?::root)?\s*\{[^}]*\}/g)) {
+		chunks.push(m[0]);
+	}
+
+	for (const m of css.matchAll(
+		/@media\s*\([^)]*prefers-color-scheme[^)]*\)\s*\{\s*:root(?::root)?\s*\{[^}]*\}\s*\}/g
+	)) {
+		chunks.push(m[0]);
+	}
+
+	for (const m of css.matchAll(/(?:^|\n)(?:html\s+)?body\s*\{[^}]*\}/g)) {
+		chunks.push(m[0].trim());
+	}
+
+	return chunks.join('\n');
+}
+
+export function writeCriticalThemeModule(siteThemePath: string, outPath: string): string {
+	let css = '';
+	if (existsSync(siteThemePath)) {
+		try {
+			css = readFileSync(siteThemePath, 'utf8');
+		} catch {
+			css = '';
+		}
+	}
+	const critical = extractCriticalTheme(css);
+	const source = `/** Auto-generated by filepress — do not edit. */\nexport default ${JSON.stringify(critical)};\n`;
+	writeFileSync(outPath, source, 'utf8');
+	return critical;
+}
+
+/**
+ * Keep `$lib/critical-theme.generated.ts` in sync with the site theme so
+ * layout can inline tokens without a Vite virtual module (SSR-safe).
+ */
+export function criticalThemePlugin(siteThemePath: string, outPath: string): Plugin {
+	return {
+		name: 'filepress-critical-theme',
+		buildStart() {
+			writeCriticalThemeModule(siteThemePath, outPath);
+		},
+		configureServer(server) {
+			writeCriticalThemeModule(siteThemePath, outPath);
+			server.watcher.add(siteThemePath);
+			server.watcher.on('change', (file) => {
+				const a = file.replace(/\\/g, '/');
+				const b = siteThemePath.replace(/\\/g, '/');
+				if (a !== b) return;
+				writeCriticalThemeModule(siteThemePath, outPath);
+				const mod = server.moduleGraph.getModuleById(outPath);
+				if (mod) {
+					server.moduleGraph.invalidateModule(mod);
+					server.ws.send({ type: 'full-reload' });
+				}
+			});
+		}
+	};
+}

package/packages/app/vite-plugin-genie.ts

@@ -0,0 +1,114 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Plugin } from 'vite';
+import {
+	applySteer,
+	doActivate,
+	fetchStockCover,
+	health,
+	receiveUpload
+} from './src/lib/genie/ops.ts';
+import { deleteVersion, listVersions } from './src/lib/genie/store.ts';
+
+function readBody(req: IncomingMessage): Promise<string> {
+	return new Promise((resolve, reject) => {
+		const chunks: Buffer[] = [];
+		req.on('data', (c) => chunks.push(Buffer.isBuffer(c) ? c : Buffer.from(c)));
+		req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+		req.on('error', reject);
+	});
+}
+
+function sendJson(res: ServerResponse, status: number, data: unknown) {
+	const body = JSON.stringify(data);
+	res.statusCode = status;
+	res.setHeader('Content-Type', 'application/json; charset=utf-8');
+	res.setHeader('Cache-Control', 'no-store');
+	res.end(body);
+}
+
+/**
+ * Dev-only Genie Mode API. `apply: 'serve'` keeps this out of `vite build`.
+ */
+export function geniePlugin(siteRoot: string): Plugin {
+	return {
+		name: 'filepress-genie',
+		apply: 'serve',
+		configureServer(server) {
+			server.middlewares.use(async (req, res, next) => {
+				const url = req.url || '';
+				if (!url.startsWith('/__filepress/genie')) return next();
+
+				const path = url.split('?')[0];
+				const method = (req.method || 'GET').toUpperCase();
+
+				try {
+					if (method === 'GET' && path === '/__filepress/genie/health') {
+						return sendJson(res, 200, await health(siteRoot));
+					}
+
+					if (method === 'GET' && path === '/__filepress/genie/versions') {
+						const h = await health(siteRoot);
+						return sendJson(res, 200, {
+							active: h.active,
+							versions: listVersions(siteRoot),
+							brief: h.brief
+						});
+					}
+
+					if (method === 'POST' && path === '/__filepress/genie/steer') {
+						const body = JSON.parse(await readBody(req));
+						return sendJson(res, 200, applySteer(siteRoot, body));
+					}
+
+					if (method === 'POST' && path === '/__filepress/genie/stock') {
+						const body = JSON.parse(await readBody(req));
+						if (!body.query || typeof body.query !== 'string') {
+							return sendJson(res, 400, { error: '`query` string required' });
+						}
+						return sendJson(res, 200, await fetchStockCover(siteRoot, body));
+					}
+
+					if (method === 'POST' && path === '/__filepress/genie/upload') {
+						const body = JSON.parse(await readBody(req));
+						if (!body.dataBase64 || !body.role) {
+							return sendJson(res, 400, {
+								error: '`role` and `dataBase64` required'
+							});
+						}
+						return sendJson(
+							res,
+							200,
+							receiveUpload(siteRoot, {
+								role: body.role,
+								filename: body.filename || `${body.role}.jpg`,
+								dataBase64: body.dataBase64,
+								activate: body.activate
+							})
+						);
+					}
+
+					if (method === 'POST' && path === '/__filepress/genie/activate') {
+						const body = JSON.parse(await readBody(req));
+						if (!body.versionId) {
+							return sendJson(res, 400, { error: '`versionId` required' });
+						}
+						return sendJson(res, 200, {
+							active: doActivate(siteRoot, body.versionId)
+						});
+					}
+
+					if (method === 'POST' && path === '/__filepress/genie/delete') {
+						const body = JSON.parse(await readBody(req));
+						deleteVersion(siteRoot, body.versionId);
+						return sendJson(res, 200, { ok: true });
+					}
+
+					return sendJson(res, 404, { error: `Unknown Genie route: ${method} ${path}` });
+				} catch (e) {
+					const message = e instanceof Error ? e.message : String(e);
+					return sendJson(res, 500, { error: message });
+				}
+			});
+		}
+	};
+}