getfilepress 0.1.2 → 0.1.4

package/packages/app/vite.config.ts

@@ -1,14 +1,16 @@
 import adapter from '@sveltejs/adapter-static';
 import { sveltekit } from '@sveltejs/kit/vite';
-import { defineConfig } from 'vite';
+import { defineConfig, createServer } from 'vite';
 import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import {
 	criticalThemePlugin,
 	writeCriticalThemeModule
 } from './vite-plugin-critical-theme.ts';
 import { geniePlugin } from './vite-plugin-genie.ts';
+import { pathMountsPlugin } from './vite-plugin-path-mounts.ts';
+import type { PathMount } from '../core/src/lib/paths-shared.ts';
 
 const appRoot = dirname(fileURLToPath(import.meta.url));
 const defaultSiteRoot = resolve(appRoot, '../../sites/demo');
@@ -24,8 +26,6 @@ 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 });
 
@@ -33,10 +33,6 @@ 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;
@@ -51,10 +47,41 @@ const criticalThemeOut = join(filepressCache, 'critical-theme.generated.ts');
 writeCriticalThemeModule(siteTheme, criticalThemeOut);
 
 const coreEntry = join(appRoot, '../core/src/lib/index.ts');
+const coreConfig = join(appRoot, '../core/src/lib/config.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). */
+/** Load `paths` via a short-lived Vite SSR graph (config-only getfilepress alias). */
+async function loadPathMounts(): Promise<PathMount[]> {
+	const temp = await createServer({
+		configFile: false,
+		root: siteRoot,
+		logLevel: 'silent',
+		resolve: {
+			alias: [
+				{ find: /^getfilepress\/server$/, replacement: coreServer },
+				{ find: /^getfilepress\/theme$/, replacement: coreTheme },
+				// Config-only — avoid pulling Essay Svelte components into this loader.
+				{ find: /^getfilepress$/, replacement: coreConfig }
+			]
+		},
+		server: { middlewareMode: true },
+		appType: 'custom',
+		optimizeDeps: { noDiscovery: true, include: [] }
+	});
+	try {
+		const mod = await temp.ssrLoadModule(pathToFileURL(siteConfig).href);
+		const paths = mod.default?.paths;
+		return Array.isArray(paths) ? (paths as PathMount[]) : [];
+	} catch (err) {
+		const detail = err instanceof Error ? err.message : String(err);
+		console.warn(`filepress: could not load path mounts (${detail}); continuing with none.`);
+		return [];
+	} finally {
+		await temp.close();
+	}
+}
+
 function resolvePort(): number | undefined {
 	const raw = process.env.FILEPRESS_PORT?.trim();
 	if (!raw) return undefined;
@@ -64,78 +91,82 @@ function resolvePort(): number | 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(', ')}`
-						);
+export default defineConfig(async () => {
+	const pathMounts = await loadPathMounts();
+	writeFileSync(
+		join(filepressCache, 'path-mounts.json'),
+		`${JSON.stringify(pathMounts, null, '\t')}\n`
+	);
+
+	return {
+		server: fixedPort
+			? { port: fixedPort, strictPort: true }
+			: undefined,
+		preview: fixedPort
+			? { port: fixedPort, strictPort: true }
+			: undefined,
+		resolve: {
+			alias: [
+				{ find: /^@filepress\/core\/server$/, replacement: coreServer },
+				{ find: /^@filepress\/core\/theme$/, replacement: coreTheme },
+				{ find: /^@filepress\/core$/, replacement: coreEntry }
+			]
+		},
+		optimizeDeps: {
+			exclude: ['ollanet']
+		},
+		ssr: {
+			external: ['ollanet']
+		},
+		plugins: [
+			criticalThemePlugin(siteTheme, criticalThemeOut),
+			geniePlugin(siteRoot),
+			pathMountsPlugin({ siteRoot, mounts: pathMounts }),
+			sveltekit({
+				alias: {
+					getfilepress: coreEntry,
+					'getfilepress/server': coreServer,
+					'getfilepress/theme': coreTheme,
+					'$site-config': siteConfig,
+					'$site-theme': siteTheme,
+					'$critical-theme': criticalThemeOut
+				},
+				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: ['*'],
+					handleHttpError: ({ path, message }) => {
+						// Nav may link into `paths` mounts; those are copied after vite build.
+						if (pathMounts.some((m) => path === m.url || path.startsWith(`${m.url}/`))) {
+							return;
+						}
+						throw new Error(message);
+					},
+					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/README.md

@@ -0,0 +1,29 @@
+# @filepress/core
+
+The reusable filepress engine. Sites under [`../../sites`](../../sites) depend on
+it (via `workspace:*` in this monorepo) and provide their own SvelteKit routes,
+content, and `filepress.config.ts`.
+
+## Entry points
+
+- `@filepress/core` — client-safe: `PostCard`, `PostIndex`, `Newsletter`,
+  `SiteHeader`, `SiteFooter`, `defineFilepressConfig`, `absoluteUrl`,
+  `formatDate`, and shared types.
+- `@filepress/core/server` — server-only (filesystem access): `createContent`,
+  `renderMarkdown`, `buildRssXml` / `buildSitemapXml` / `buildRobotsTxt`, and the
+  content-parsing primitives. Import only from `+page.server.ts`, `+server.ts`,
+  or `*.server.ts` modules.
+- `@filepress/core/theme` — self-hosted fonts + the Essay theme CSS. Import once
+  from a site's root layout.
+
+## Why routes live in the site
+
+SvelteKit's router is per-project, so each site owns its `src/routes/`. Those
+route files stay thin: they call `createContent(...)` + core builders and render
+core components. `scripts/create-site.mjs` scaffolds them.
+
+## Testing
+
+`pnpm --filter @filepress/core test` runs the unit tests over the pure parsing
+and figure-transform logic. Type-checking of the whole library happens through
+each site's `svelte-check`.

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@filepress/core",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"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.",

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

@@ -7,6 +7,8 @@
  * keeps `@filepress/core` app-agnostic and importable from both client and
  * server code.
  */
+import { normalizePathMounts, type PathMount } from './paths-shared';
+export type { PathMount } from './paths-shared';
 export interface NewsletterConfig {
 	/** Full URL to an external signup form (Buttondown, Substack, etc.). */
 	url: string;
@@ -64,6 +66,12 @@ export interface SiteConfig {
 	footerLinks: NavItem[];
 	topics: Topic[];
 	newsletter: NewsletterConfig | null;
+	/**
+	 * Site-owned trees mounted at a URL prefix (e.g. `/docs` ← `docs/dist`).
+	 * Copied into `build/` on `filepress build`; served in `filepress dev`.
+	 * FilePress does not parse or theme mount contents.
+	 */
+	paths: PathMount[];
 }
 
 /** What a site author supplies; everything but `title` and `url` is optional. */
@@ -85,6 +93,8 @@ export interface SiteConfigInput {
 	footerLinks?: NavItem[];
 	topics?: Topic[];
 	newsletter?: NewsletterConfig | null;
+	/** Mount site-relative dirs at URL prefixes (docs shells, etc.). */
+	paths?: PathMount[];
 }
 
 const defaultFooterLinks: NavItem[] = [
@@ -167,7 +177,8 @@ export function defineFilepressConfig(input: SiteConfigInput): SiteConfig {
 		nav: normalizeNavItems(input.nav) ?? defaultNav,
 		footerLinks: normalizeNavItems(input.footerLinks) ?? [...defaultFooterLinks],
 		topics: input.topics ?? [],
-		newsletter: input.newsletter ?? null
+		newsletter: input.newsletter ?? null,
+		paths: normalizePathMounts(input.paths)
 	};
 }
 

package/packages/core/src/lib/content/feeds.ts

@@ -46,7 +46,7 @@ ${items}
 `;
 }
 
-/** Build a sitemap covering the index, static pages, paginated pages, topics, tags, and posts. */
+/** Build a sitemap covering the index, static pages, paginated pages, topics, tags, posts, and path mounts. */
 export function buildSitemapXml(
 	site: SiteConfig,
 	data: {
@@ -55,6 +55,8 @@ export function buildSitemapXml(
 		pageCount: number;
 		/** Published static pages (`pages/*.md`). */
 		pages?: PageMeta[];
+		/** Absolute site paths from `paths` mounts (e.g. `/docs`, `/docs/install`). */
+		mountUrls?: string[];
 	}
 ): string {
 	const esc = (v: string) => v.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
@@ -63,6 +65,7 @@ export function buildSitemapXml(
 	for (let n = 2; n <= data.pageCount; n++) extraPages.push({ loc: absoluteUrl(site, `/page/${n}`) });
 
 	const staticPages = data.pages ?? [];
+	const mountUrls = data.mountUrls ?? [];
 
 	const urls: { loc: string; lastmod?: string }[] = [
 		{ loc: absoluteUrl(site, '/') },
@@ -71,6 +74,7 @@ export function buildSitemapXml(
 		{ loc: absoluteUrl(site, '/tags') },
 		...extraPages,
 		...staticPages.map((p) => ({ loc: absoluteUrl(site, `/${p.slug}`) })),
+		...mountUrls.map((path) => ({ loc: absoluteUrl(site, path) })),
 		...data.posts.map((p) => ({
 			loc: absoluteUrl(site, `/posts/${p.slug}`),
 			lastmod: p.updated ?? p.date

package/packages/core/src/lib/content/pages.ts

@@ -20,6 +20,11 @@ export interface CreatePagesOptions {
 	/** Absolute or cwd-relative path to `pages/`. Missing dir → empty site (ok). */
 	pagesDir: string;
 	listDrafts?: boolean;
+	/**
+	 * Extra slugs reserved against `pages/*.md` (e.g. first segments of `paths` mounts).
+	 * Merged with {@link RESERVED_PAGE_SLUGS}.
+	 */
+	extraReservedSlugs?: string[];
 }
 
 /**
@@ -31,6 +36,9 @@ export function createPages(opts: CreatePagesOptions): PagesApi {
 		? opts.pagesDir
 		: resolve(process.cwd(), opts.pagesDir);
 	const listDrafts = resolveListDrafts(opts.listDrafts);
+	const extraReserved = (opts.extraReservedSlugs ?? [])
+		.map((s) => s.trim().toLowerCase())
+		.filter(Boolean);
 
 	let cache: PageSource[] | null = null;
 
@@ -52,7 +60,9 @@ export function createPages(opts: CreatePagesOptions): PagesApi {
 
 		const pages = filenames
 			.sort((a, b) => a.localeCompare(b))
-			.map((name) => parsePage(`/pages/${name}`, readFileSync(join(dir, name), 'utf8')));
+			.map((name) =>
+				parsePage(`/pages/${name}`, readFileSync(join(dir, name), 'utf8'), extraReserved)
+			);
 
 		assertUniqueSlugs(pages);
 		cache = pages;

package/packages/core/src/lib/content/parse.ts

@@ -157,7 +157,11 @@ export function assertUniqueSlugs(sources: { slug: string; sourcePath: string }[
 const RESERVED = new Set<string>(RESERVED_PAGE_SLUGS);
 
 /** Parse and validate one static page Markdown file. Throws ContentError. */
-export function parsePage(path: string, raw: string): PageSource {
+export function parsePage(
+	path: string,
+	raw: string,
+	extraReservedSlugs: string[] = []
+): PageSource {
 	let parsed: matter.GrayMatterFile<string>;
 	try {
 		parsed = matter(raw);
@@ -180,9 +184,14 @@ export function parsePage(path: string, raw: string): PageSource {
 			`${path}: could not derive a non-empty slug from ${explicitSlug ? 'the `slug` field' : 'the filename'}.`
 		);
 	}
-	if (RESERVED.has(slug)) {
+	const reserved = new Set([...RESERVED, ...extraReservedSlugs.map((s) => s.trim().toLowerCase())]);
+	if (reserved.has(slug)) {
+		const extras =
+			extraReservedSlugs.length > 0
+				? `, plus path mounts: ${extraReservedSlugs.join(', ')}`
+				: '';
 		throw new ContentError(
-			`${path}: slug "${slug}" is reserved by the engine (${RESERVED_PAGE_SLUGS.join(', ')}). ` +
+			`${path}: slug "${slug}" is reserved by the engine (${RESERVED_PAGE_SLUGS.join(', ')}${extras}). ` +
 				`Rename the file or set a different \`slug\` in frontmatter.`
 		);
 	}

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

@@ -20,7 +20,8 @@ export type {
 	NewsletterConfig,
 	Topic,
 	NavItem,
-	NavIconName
+	NavIconName,
+	PathMount
 } from './config';
 
 export { formatDate } from './format';

package/packages/core/src/lib/paths-shared.ts

@@ -0,0 +1,89 @@
+/**
+ * Client-safe path-mount helpers (no filesystem).
+ * Copy / HTML listing live in `./paths.ts` (server-only).
+ */
+import { RESERVED_PAGE_SLUGS } from './content/types';
+
+/** One mount: `dir` (site-relative) is copied/served at `url` (e.g. `/docs`). */
+export interface PathMount {
+	/** Site-relative directory (e.g. `docs/dist`). */
+	dir: string;
+	/** URL prefix starting with `/`, no trailing slash (e.g. `/docs`). */
+	url: string;
+}
+
+/** Engine route prefixes a mount must not steal. */
+const ENGINE_URL_PREFIXES = new Set([
+	...RESERVED_PAGE_SLUGS,
+	'',
+	'_app',
+	'__filepress',
+]);
+
+/**
+ * Normalize and validate `paths` from site config.
+ * Throws on empty/invalid entries or collisions with engine routes.
+ */
+export function normalizePathMounts(input: PathMount[] | undefined): PathMount[] {
+	if (input == null) return [];
+	if (!Array.isArray(input)) {
+		throw new Error('filepress.config: `paths` must be an array of { url, dir }.');
+	}
+
+	const seenUrls = new Set<string>();
+	const seenDirs = new Set<string>();
+	const out: PathMount[] = [];
+
+	for (const raw of input) {
+		if (!raw || typeof raw !== 'object') {
+			throw new Error('filepress.config: each `paths` entry must be an object { url, dir }.');
+		}
+		const dir = String(raw.dir ?? '').trim().replace(/\\/g, '/').replace(/\/+$/, '');
+		let url = String(raw.url ?? '').trim().replace(/\\/g, '/');
+		if (!dir) {
+			throw new Error('filepress.config: `paths[].dir` must be a non-empty site-relative path.');
+		}
+		if (dir.startsWith('/') || /^[a-zA-Z]:/.test(dir) || dir.includes('..')) {
+			throw new Error(
+				`filepress.config: \`paths[].dir\` must be a relative path without "..\" (got "${raw.dir}").`,
+			);
+		}
+		if (!url.startsWith('/')) {
+			throw new Error(`filepress.config: \`paths[].url\` must start with / (got "${raw.url}").`);
+		}
+		url = url.replace(/\/+$/, '') || '/';
+		if (url === '/') {
+			throw new Error('filepress.config: `paths[].url` cannot be `/` (that is the site home).');
+		}
+		const first = url.slice(1).split('/')[0] ?? '';
+		if (!first || ENGINE_URL_PREFIXES.has(first)) {
+			throw new Error(
+				`filepress.config: \`paths\` url "/${first}" collides with an engine route ` +
+					`(${[...RESERVED_PAGE_SLUGS].join(', ')}). Choose another prefix.`,
+			);
+		}
+		if (seenUrls.has(url)) {
+			throw new Error(`filepress.config: duplicate \`paths\` url "${url}".`);
+		}
+		if (seenDirs.has(dir)) {
+			throw new Error(`filepress.config: duplicate \`paths\` dir "${dir}".`);
+		}
+		for (const other of seenUrls) {
+			if (url.startsWith(`${other}/`) || other.startsWith(`${url}/`)) {
+				throw new Error(
+					`filepress.config: \`paths\` urls "${url}" and "${other}" nest; use disjoint prefixes.`,
+				);
+			}
+		}
+		seenUrls.add(url);
+		seenDirs.add(dir);
+		out.push({ url, dir });
+	}
+
+	return out;
+}
+
+/** First URL segment of each mount — reserved against `pages/<slug>.md`. */
+export function pathMountReservedSlugs(mounts: PathMount[]): string[] {
+	return mounts.map((m) => m.url.slice(1).split('/')[0]!).filter(Boolean);
+}

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

@@ -0,0 +1,84 @@
+/**
+ * Server-only path-mount filesystem helpers.
+ */
+import {
+	cpSync,
+	existsSync,
+	mkdirSync,
+	readdirSync,
+	statSync,
+} from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+import type { PathMount } from './paths-shared';
+
+export type { PathMount } from './paths-shared';
+export { normalizePathMounts, pathMountReservedSlugs } from './paths-shared';
+
+/** Absolute filesystem path for a mount's source directory. */
+export function resolvePathMountDir(siteRoot: string, mount: PathMount): string {
+	return resolve(siteRoot, mount.dir);
+}
+
+/**
+ * Copy each mount's directory into `buildDir<url>/`.
+ * Missing source dirs are skipped with a warning to stderr (site may build docs first).
+ */
+export function copyPathMounts(
+	siteRoot: string,
+	buildDir: string,
+	mounts: PathMount[],
+): void {
+	for (const mount of mounts) {
+		const src = resolvePathMountDir(siteRoot, mount);
+		const dest = join(buildDir, ...mount.url.slice(1).split('/'));
+		if (!existsSync(src)) {
+			console.warn(
+				`filepress: path mount ${mount.url} ← ${mount.dir} (missing; skipped)`,
+			);
+			continue;
+		}
+		if (!statSync(src).isDirectory()) {
+			throw new Error(
+				`filepress: path mount dir "${mount.dir}" is not a directory (${src}).`,
+			);
+		}
+		mkdirSync(dest, { recursive: true });
+		cpSync(src, dest, { recursive: true });
+		console.log(`filepress: mounted ${mount.url} ← ${mount.dir}`);
+	}
+}
+
+/**
+ * List site-relative URL paths for HTML files under each mount (for the sitemap).
+ * Includes `index.html` as the directory URL (e.g. `/docs` not `/docs/index.html`).
+ */
+export function listPathMountHtmlUrls(siteRoot: string, mounts: PathMount[]): string[] {
+	const urls: string[] = [];
+	for (const mount of mounts) {
+		const src = resolvePathMountDir(siteRoot, mount);
+		if (!existsSync(src) || !statSync(src).isDirectory()) continue;
+		walkHtml(src, src, mount.url, urls);
+	}
+	return [...new Set(urls)].sort();
+}
+
+function walkHtml(root: string, dir: string, urlBase: string, out: string[]): void {
+	for (const name of readdirSync(dir)) {
+		const abs = join(dir, name);
+		const st = statSync(abs);
+		if (st.isDirectory()) {
+			walkHtml(root, abs, urlBase, out);
+			continue;
+		}
+		if (!name.toLowerCase().endsWith('.html')) continue;
+		const rel = relative(root, abs).split(sep).join('/');
+		if (rel.toLowerCase() === 'index.html') {
+			out.push(urlBase);
+		} else if (name.toLowerCase() === 'index.html') {
+			const parent = rel.slice(0, -'/index.html'.length);
+			out.push(`${urlBase}/${parent}`);
+		} else {
+			out.push(`${urlBase}/${rel.replace(/\.html$/i, '')}`);
+		}
+	}
+}

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

@@ -21,7 +21,14 @@ export {
 } from './content/parse';
 
 export { absoluteUrl, ogImageUrl } from './config';
-export type { SiteConfig } from './config';
+export type { SiteConfig, PathMount } from './config';
+export {
+	normalizePathMounts,
+	pathMountReservedSlugs,
+	resolvePathMountDir,
+	copyPathMounts,
+	listPathMountHtmlUrls
+} from './paths';
 export type {
 	PostMeta,
 	PostSource,

package/packages/core/src/lib/styles/theme.css

@@ -317,7 +317,8 @@ a:hover {
 }
 
 .featured .post-card {
-	padding: 0;
+	/* Do not set padding: 0 — sites that paint boxed cards need horizontal inset.
+	   Essay cards already have horizontal padding 0 from .post-card. */
 	border-bottom: none;
 }
 
@@ -344,7 +345,7 @@ a:hover {
 	border-bottom: 1px solid var(--rule);
 }
 
-.post-list > .post-card:first-child {
+.post-list > li:first-child .post-card {
 	padding-top: 0;
 }
 

package/packages/import/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@filepress/import",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"private": true,
 	"type": "module",
 	"description": "Crawl an existing site and scaffold a filepress content-only sibling (optional Ollama restyle).",
@@ -15,6 +15,7 @@
 	"dependencies": {
 		"fast-xml-parser": "^5.2.5",
 		"linkedom": "^0.18.12",
+		"ollanet": "^0.4.0",
 		"turndown": "^7.2.1"
 	},
 	"devDependencies": {