getfilepress 0.0.0 → 0.1.1

package/packages/app/vite.config.ts

@@ -0,0 +1,141 @@
+import adapter from '@sveltejs/adapter-static';
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+	criticalThemePlugin,
+	writeCriticalThemeModule
+} from './vite-plugin-critical-theme.ts';
+import { geniePlugin } from './vite-plugin-genie.ts';
+
+const appRoot = dirname(fileURLToPath(import.meta.url));
+const defaultSiteRoot = resolve(appRoot, '../../sites/demo');
+
+function resolveSiteRoot(): string {
+	const raw = process.env.FILEPRESS_SITE_ROOT?.trim();
+	return raw ? resolve(raw) : defaultSiteRoot;
+}
+
+const siteRoot = resolveSiteRoot();
+const siteConfig = join(siteRoot, 'filepress.config.ts');
+const siteStatic = join(siteRoot, 'static');
+const siteBuild = join(siteRoot, 'build');
+const fallbackStatic = join(appRoot, 'static');
+
+// SvelteKit requires an assets directory to exist. Prefer the site's static/;
+// fall back to packages/app/static for sites that haven't added one yet.
+const assetsDir = existsSync(siteStatic) ? siteStatic : fallbackStatic;
+if (!existsSync(fallbackStatic)) mkdirSync(fallbackStatic, { recursive: true });
+
+if (!existsSync(siteConfig)) {
+	throw new Error(`No filepress.config.ts at site root: ${siteConfig}`);
+}
+
+/**
+ * Prefer site-root theme.css so Genie activate can overwrite a real file Vite watches.
+ * Create an empty theme.css when absent (not the app stub path).
+ */
+function resolveSiteTheme(): string {
+	const css = join(siteRoot, 'theme.css');
+	if (existsSync(css)) return css;
+	writeFileSync(css, '/* filepress site theme — edit freely or use Genie Mode in dev */\n');
+	return css;
+}
+
+const siteTheme = resolveSiteTheme();
+const filepressCache = join(siteRoot, '.filepress');
+if (!existsSync(filepressCache)) mkdirSync(filepressCache, { recursive: true });
+const criticalThemeOut = join(filepressCache, 'critical-theme.generated.ts');
+writeCriticalThemeModule(siteTheme, criticalThemeOut);
+
+const coreEntry = join(appRoot, '../core/src/lib/index.ts');
+const coreServer = join(appRoot, '../core/src/lib/server.ts');
+const coreTheme = join(appRoot, '../core/src/lib/theme.ts');
+
+/** Optional fixed port from `filepress dev|preview --port` (via FILEPRESS_PORT). */
+function resolvePort(): number | undefined {
+	const raw = process.env.FILEPRESS_PORT?.trim();
+	if (!raw) return undefined;
+	const n = Number(raw);
+	return Number.isInteger(n) && n > 0 && n <= 65535 ? n : undefined;
+}
+
+const fixedPort = resolvePort();
+
+export default defineConfig({
+	server: fixedPort
+		? { port: fixedPort, strictPort: true }
+		: undefined,
+	preview: fixedPort
+		? { port: fixedPort, strictPort: true }
+		: undefined,
+	// Regex aliases (exact) so npm installs don't need workspace links, and so a
+	// bare `@filepress/core` string alias can't steal `/server` + `/theme`.
+	resolve: {
+		alias: [
+			{ find: /^@filepress\/core\/server$/, replacement: coreServer },
+			{ find: /^@filepress\/core\/theme$/, replacement: coreTheme },
+			{ find: /^@filepress\/core$/, replacement: coreEntry }
+		]
+	},
+	plugins: [
+		criticalThemePlugin(siteTheme, criticalThemeOut),
+		geniePlugin(siteRoot),
+		sveltekit({
+			alias: {
+				// Site configs (monorepo or linked) import from `getfilepress`.
+				getfilepress: coreEntry,
+				'getfilepress/server': coreServer,
+				'getfilepress/theme': coreTheme,
+				'$site-config': siteConfig,
+				// Loaded after the core Essay theme so site rules win the cascade.
+				'$site-theme': siteTheme,
+				// Per-site critical tokens (written under site/.filepress/).
+				'$critical-theme': criticalThemeOut
+			},
+
+			// Absolute `/_app/...` asset URLs — more reliable on CDN/custom domains
+			// than `./_app/...` relative links (avoids unstyled flashes on deploy).
+			paths: {
+				relative: false
+			},
+
+			files: {
+				assets: assetsDir
+			},
+
+			compilerOptions: {
+				runes: ({ filename }) =>
+					filename.split(/[/\\]/).includes('node_modules') ? undefined : true
+			},
+
+			adapter: adapter({
+				pages: siteBuild,
+				assets: siteBuild,
+				fallback: '404.html',
+				strict: true
+			}),
+
+			prerender: {
+				entries: ['*'],
+
+				// Some parameterized routes legitimately have zero pages: /page/[n]
+				// when everything fits on page 1, /tags/[tag] when no listed post
+				// carries a tag, and /[slug] itself when every post is still
+				// draft:true (a site before its first published essay). Ignore
+				// those; stay strict for any other unseen route.
+				handleUnseenRoutes: ({ routes }) => {
+					const emptyOk = new Set(['/page/[n]', '/tags/[tag]', '/[slug]']);
+					const unexpected = routes.filter((r) => !emptyOk.has(r));
+					if (unexpected.length > 0) {
+						throw new Error(
+							`Routes marked prerenderable but not prerendered: ${unexpected.join(', ')}`
+						);
+					}
+				}
+			}
+		})
+	]
+});

package/packages/core/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@filepress/core",
+	"version": "0.1.1",
+	"private": true,
+	"type": "module",
+	"description": "Reusable engine for filepress sites: content loader, Markdown pipeline, feed/sitemap builders, config helper, Essay theme, and shared Svelte components.",
+	"svelte": "./src/lib/index.ts",
+	"types": "./src/lib/index.ts",
+	"exports": {
+		".": {
+			"types": "./src/lib/index.ts",
+			"svelte": "./src/lib/index.ts",
+			"default": "./src/lib/index.ts"
+		},
+		"./server": {
+			"types": "./src/lib/server.ts",
+			"default": "./src/lib/server.ts"
+		},
+		"./theme": {
+			"default": "./src/lib/theme.ts"
+		},
+		"./assets/*": "./src/lib/assets/*"
+	},
+	"scripts": {
+		"test": "vitest run",
+		"test:watch": "vitest"
+	},
+	"dependencies": {
+		"@fontsource-variable/inter": "^5.2.8",
+		"@fontsource-variable/newsreader": "^5.2.10",
+		"gray-matter": "^4.0.3",
+		"highlight.js": "^11.11.1",
+		"rehype-autolink-headings": "^7.1.0",
+		"rehype-highlight": "^7.0.2",
+		"rehype-raw": "^7.0.0",
+		"rehype-slug": "^6.0.0",
+		"rehype-stringify": "^10.0.1",
+		"remark-gfm": "^4.0.1",
+		"remark-parse": "^11.0.0",
+		"remark-rehype": "^11.1.2",
+		"unified": "^11.0.5"
+	},
+	"peerDependencies": {
+		"svelte": "^5.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^26.1.0",
+		"svelte": "^5.56.1",
+		"vitest": "^4.1.9"
+	}
+}

package/packages/core/src/lib/assets/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="107" height="128" viewBox="0 0 107 128"><title>svelte-logo</title><path d="M94.157 22.819c-10.4-14.885-30.94-19.297-45.792-9.835L22.282 29.608A29.92 29.92 0 0 0 8.764 49.65a31.5 31.5 0 0 0 3.108 20.231 30 30 0 0 0-4.477 11.183 31.9 31.9 0 0 0 5.448 24.116c10.402 14.887 30.942 19.297 45.791 9.835l26.083-16.624A29.92 29.92 0 0 0 98.235 78.35a31.53 31.53 0 0 0-3.105-20.232 30 30 0 0 0 4.474-11.182 31.88 31.88 0 0 0-5.447-24.116" style="fill:#ff3e00"/><path d="M45.817 106.582a20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.503 18 18 0 0 1 .624-2.435l.49-1.498 1.337.981a33.6 33.6 0 0 0 10.203 5.098l.97.294-.09.968a5.85 5.85 0 0 0 1.052 3.878 6.24 6.24 0 0 0 6.695 2.485 5.8 5.8 0 0 0 1.603-.704L69.27 76.28a5.43 5.43 0 0 0 2.45-3.631 5.8 5.8 0 0 0-.987-4.371 6.24 6.24 0 0 0-6.698-2.487 5.7 5.7 0 0 0-1.6.704l-9.953 6.345a19 19 0 0 1-5.296 2.326 20.72 20.72 0 0 1-22.237-8.243 19.17 19.17 0 0 1-3.277-14.502 17.99 17.99 0 0 1 8.13-12.052l26.081-16.623a19 19 0 0 1 5.3-2.329 20.72 20.72 0 0 1 22.237 8.243 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-.624 2.435l-.49 1.498-1.337-.98a33.6 33.6 0 0 0-10.203-5.1l-.97-.294.09-.968a5.86 5.86 0 0 0-1.052-3.878 6.24 6.24 0 0 0-6.696-2.485 5.8 5.8 0 0 0-1.602.704L37.73 51.72a5.42 5.42 0 0 0-2.449 3.63 5.79 5.79 0 0 0 .986 4.372 6.24 6.24 0 0 0 6.698 2.486 5.8 5.8 0 0 0 1.602-.704l9.952-6.342a19 19 0 0 1 5.295-2.328 20.72 20.72 0 0 1 22.237 8.242 19.17 19.17 0 0 1 3.277 14.503 18 18 0 0 1-8.13 12.053l-26.081 16.622a19 19 0 0 1-5.3 2.328" style="fill:#fff"/></svg>

package/packages/core/src/lib/components/Newsletter.svelte

@@ -0,0 +1,13 @@
+<script lang="ts">
+	import type { NewsletterConfig } from '../config';
+
+	let { newsletter }: { newsletter: NewsletterConfig | null } = $props();
+</script>
+
+{#if newsletter}
+	<aside class="newsletter">
+		<h2>Subscribe</h2>
+		<p>{newsletter.blurb}</p>
+		<a class="button" href={newsletter.url} rel="noopener">{newsletter.cta}</a>
+	</aside>
+{/if}

package/packages/core/src/lib/components/PostCard.svelte

@@ -0,0 +1,34 @@
+<script lang="ts">
+	import type { PostMeta } from '../content/types';
+	import { formatDate } from '../format';
+
+	let {
+		post,
+		featured = false,
+		showTags = true
+	}: { post: PostMeta; featured?: boolean; showTags?: boolean } = $props();
+</script>
+
+<article class="post-card" class:featured>
+	<p class="meta">
+		{#if post.draft}
+			<span class="draft-label">Draft</span>
+		{/if}
+		<time datetime={post.date}>{formatDate(post.date)}</time>
+		{#if post.author}
+			&middot; <span class="byline">{post.author}</span>
+		{/if}
+	</p>
+	<h2 class="post-title"><a href="/posts/{post.slug}">{post.title}</a></h2>
+	{#if post.description}
+		<p class="excerpt">{post.description}</p>
+	{/if}
+	<a class="read-more" href="/posts/{post.slug}">Read more &rarr;</a>
+	{#if showTags && post.tags.length}
+		<ul class="tag-list card-tags">
+			{#each post.tags as tag (tag)}
+				<li><a href="/tags/{tag}">{tag}</a></li>
+			{/each}
+		</ul>
+	{/if}
+</article>

package/packages/core/src/lib/components/PostIndex.svelte

@@ -0,0 +1,86 @@
+<script lang="ts">
+	import type { PostMeta } from '../content/types';
+	import type { SiteConfig } from '../config';
+	import PostCard from './PostCard.svelte';
+	import Newsletter from './Newsletter.svelte';
+
+	let {
+		site,
+		hero = false,
+		featured = null,
+		posts,
+		page = 1,
+		totalPages = 1,
+		/** Page-1 URL for the post index (`/` or `/writing`). */
+		indexHref = '/'
+	}: {
+		site: SiteConfig;
+		hero?: boolean;
+		featured?: PostMeta | null;
+		posts: PostMeta[];
+		page?: number;
+		totalPages?: number;
+		indexHref?: string;
+	} = $props();
+
+	const hasContent = $derived(featured !== null || posts.length > 0);
+	const prevHref = $derived(page <= 2 ? indexHref : `/page/${page - 1}`);
+	const nextHref = $derived(`/page/${page + 1}`);
+</script>
+
+{#if hero}
+	<!-- The masthead carries the site identity (title/logo plus tagline). The
+	     index adds an optional one-line lede; a hidden h1 keeps semantics/SEO. -->
+	<header class="hero" class:visually-hidden={!site.lede}>
+		<h1 class="visually-hidden">{site.title}</h1>
+		{#if site.lede}
+			<p class="hero-lede">{site.lede}</p>
+		{/if}
+	</header>
+{:else}
+	<header class="post-header">
+		{#if page <= 1}
+			<h1>Posts</h1>
+		{:else}
+			<p class="eyebrow">Posts</p>
+			<h1>Page {page}</h1>
+		{/if}
+	</header>
+{/if}
+
+{#if !hasContent}
+	<p class="empty-state">No posts yet. Add a Markdown file to <code>/posts/</code> and push.</p>
+{:else}
+	{#if featured}
+		<div class="featured">
+			<p class="eyebrow">Latest</p>
+			<PostCard post={featured} featured />
+		</div>
+	{/if}
+
+	{#if posts.length}
+		<ul class="post-list">
+			{#each posts as post (post.slug)}
+				<li><PostCard {post} /></li>
+			{/each}
+		</ul>
+	{/if}
+
+	{#if totalPages > 1}
+		<nav class="pager" aria-label="Pagination">
+			{#if page > 1}
+				<a href={prevHref} rel="prev">&larr; Newer</a>
+			{:else}
+				<span></span>
+			{/if}
+			<span class="page-count">Page {page} of {totalPages}</span>
+			{#if page < totalPages}
+				<a href={nextHref} rel="next">Older &rarr;</a>
+			{:else}
+				<span></span>
+			{/if}
+		</nav>
+	{/if}
+{/if}
+
+<Newsletter newsletter={site.newsletter} />

package/packages/core/src/lib/components/SiteFooter.svelte

@@ -0,0 +1,15 @@
+<script lang="ts">
+	import type { SiteConfig } from '../config';
+
+	let { site, year = new Date().getFullYear() }: { site: SiteConfig; year?: number } = $props();
+</script>
+
+<footer class="site-footer">
+	<div class="wrap">
+		<span>&copy; {year} {site.author}</span>
+		<span class="footer-links">
+			<a href="/rss.xml">RSS</a>
+			<a href="/topics">Topics</a>
+		</span>
+	</div>
+</footer>

package/packages/core/src/lib/components/SiteHeader.svelte

@@ -0,0 +1,28 @@
+<script lang="ts">
+	import type { SiteConfig } from '../config';
+
+	let { site }: { site: SiteConfig } = $props();
+</script>
+
+<header class="site-header">
+	<div class="wrap">
+		<div class="site-id">
+			<a class="site-title" href="/">
+				{#if site.logo}
+					<img class="site-logo" src={site.logo} alt="" />
+				{/if}
+				<span class="site-brand-copy">
+					<span class="site-wordmark">{site.title}</span>
+					{#if site.tagline}
+						<span class="site-tagline">{site.tagline}</span>
+					{/if}
+				</span>
+			</a>
+		</div>
+		<nav class="site-nav" aria-label="Primary">
+			{#each site.nav as item (item.href)}
+				<a href={item.href}>{item.label}</a>
+			{/each}
+		</nav>
+	</div>
+</header>

package/packages/core/src/lib/config.ts

@@ -0,0 +1,154 @@
+/**
+ * filepress site configuration — the single per-site config surface.
+ *
+ * A site declares its identity in `filepress.config.ts` at the site root via
+ * `defineFilepressConfig({...})`. Core never reads environment variables for
+ * identity; the site owns that (and may read env in its own config file). This
+ * keeps `@filepress/core` app-agnostic and importable from both client and
+ * server code.
+ */
+export interface NewsletterConfig {
+	/** Full URL to an external signup form (Buttondown, Substack, etc.). */
+	url: string;
+	/** One-line pitch shown above the button. */
+	blurb: string;
+	/** Button label. */
+	cta: string;
+}
+
+/** A curated topic surfaced in the Explore/Topics view, mapped to a tag. */
+export interface Topic {
+	label: string;
+	tag: string;
+}
+
+export interface NavItem {
+	label: string;
+	href: string;
+}
+
+/** Fully-resolved site configuration (after defaults are applied). */
+export interface SiteConfig {
+	title: string;
+	description: string;
+	tagline: string;
+	/** One-line lede shown on the index hero, or null for no visible hero. */
+	lede: string | null;
+	/** Path to a masthead logo image (site-relative, e.g. "/logo.png"), or null for text. */
+	logo: string | null;
+	/**
+	 * Absolute or site-relative Open Graph image (e.g. "/logo.png").
+	 * Defaults to `logo` when unset.
+	 */
+	ogImage: string | null;
+	/** Canonical origin, no trailing slash, e.g. "https://example.com". */
+	url: string;
+	author: string;
+	/** Posts per page on the index (after the featured one). */
+	postsPerPage: number;
+	/**
+	 * When set, `/` renders this static page slug (`pages/<slug>.md`) and the
+	 * chronological post index moves to `/writing`.
+	 */
+	homePage: string | null;
+	nav: NavItem[];
+	topics: Topic[];
+	newsletter: NewsletterConfig | null;
+}
+
+/** What a site author supplies; everything but `title` and `url` is optional. */
+export interface SiteConfigInput {
+	title: string;
+	url: string;
+	description?: string;
+	tagline?: string;
+	lede?: string;
+	logo?: string;
+	/** Open Graph image path; defaults to `logo`. */
+	ogImage?: string;
+	author?: string;
+	postsPerPage?: number;
+	/** Static page slug to show at `/` (post index then lives at `/writing`). */
+	homePage?: string;
+	nav?: NavItem[];
+	topics?: Topic[];
+	newsletter?: NewsletterConfig | null;
+}
+
+/** Path to page 1 of the chronological post index. */
+export function postsIndexPath(site: Pick<SiteConfig, 'homePage'>): string {
+	return site.homePage ? '/writing' : '/';
+}
+
+/**
+ * Validate and normalize a site's config, applying defaults. Fails loudly if a
+ * required field is missing (edge case 19) so a misconfigured site never builds
+ * a broken feed or canonical URL silently.
+ */
+export function defineFilepressConfig(input: SiteConfigInput): SiteConfig {
+	if (!input || typeof input !== 'object') {
+		throw new Error('defineFilepressConfig: expected a config object.');
+	}
+	const title = (input.title ?? '').trim();
+	if (!title) throw new Error('filepress.config: `title` is required.');
+	const url = (input.url ?? '').trim();
+	if (!url) throw new Error('filepress.config: `url` is required.');
+	if (!/^https?:\/\//.test(url)) {
+		throw new Error(`filepress.config: \`url\` must start with http(s):// (got "${url}").`);
+	}
+
+	const description = (input.description ?? '').trim();
+	const homePage = (input.homePage ?? '').trim() || null;
+	if (homePage && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/i.test(homePage)) {
+		throw new Error(
+			`filepress.config: \`homePage\` must be a simple slug (got "${homePage}").`
+		);
+	}
+
+	const defaultNav: NavItem[] = homePage
+		? [
+				{ label: 'Home', href: '/' },
+				{ label: 'Posts', href: '/writing' },
+				{ label: 'Topics', href: '/topics' }
+			]
+		: [
+				{ label: 'Posts', href: '/' },
+				{ label: 'Topics', href: '/topics' }
+			];
+
+	return {
+		title,
+		description,
+		tagline: (input.tagline ?? '').trim() || description || title,
+		lede: (input.lede ?? '').trim() || null,
+		logo: (input.logo ?? '').trim() || null,
+		ogImage:
+			(input.ogImage ?? '').trim() || (input.logo ?? '').trim() || null,
+		url: url.replace(/\/+$/, ''),
+		author: (input.author ?? '').trim() || title,
+		postsPerPage:
+			Number.isFinite(input.postsPerPage) && (input.postsPerPage as number) > 0
+				? Math.floor(input.postsPerPage as number)
+				: 10,
+		homePage,
+		nav: input.nav && input.nav.length ? input.nav : defaultNav,
+		topics: input.topics ?? [],
+		newsletter: input.newsletter ?? null
+	};
+}
+
+/** Join the site origin with a path, guarding against double slashes. */
+export function absoluteUrl(site: Pick<SiteConfig, 'url'>, path: string): string {
+	const base = site.url.replace(/\/+$/, '');
+	const suffix = path.startsWith('/') ? path : `/${path}`;
+	return `${base}${suffix}`;
+}
+
+/** Absolute URL for Open Graph / Twitter cards, or null when unset. */
+export function ogImageUrl(
+	site: Pick<SiteConfig, 'url' | 'ogImage'>
+): string | null {
+	if (!site.ogImage) return null;
+	if (/^https?:\/\//i.test(site.ogImage)) return site.ogImage;
+	return absoluteUrl(site, site.ogImage);
+}