getfilepress 0.1.27 → 0.1.28

package/README.md

@@ -38,7 +38,7 @@ Crawls a public site (sitemap/RSS preferred) into a sibling content tree. Option
 | Genie (dev only) | [Genie](https://getfilepress.com/genie) · [spec](docs/GENIE_MODE_SPEC.md) |
 | Deploy | [Deploy](https://getfilepress.com/deploy) · [docs/DEPLOY.md](docs/DEPLOY.md) |
 | Sibling / external sites | [docs/EXTERNAL_SITES.md](docs/EXTERNAL_SITES.md) |
-| Local ports | [docs/LOCALBERTH.md](docs/LOCALBERTH.md) |
+| Local ports | [docs/LOCALSLIP.md](docs/LOCALSLIP.md) |
 | Agent skill page | [Skill page](https://getfilepress.com/skill-page) · [docs/SKILL_PAGE.md](docs/SKILL_PAGE.md) |
 
 ## In this repo

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "getfilepress",
-	"version": "0.1.27",
+	"version": "0.1.28",
 	"private": false,
 	"type": "module",
 	"description": "FilePress — file-based Markdown blog engine. Link this package from a content-only site (config + posts), then run `filepress build`.",

package/packages/app/{localberth-port.ts → localslip-port.ts}

@@ -2,9 +2,9 @@ import { existsSync, readFileSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 import { join } from 'node:path';
 
-/** `localberth get <name>` — undefined if the CLI or lease is missing. */
-export function localberthGet(name: string): number | undefined {
-	const r = spawnSync('localberth', ['get', name], {
+/** `localslip get <name>` — undefined if the CLI or lease is missing. */
+export function localslipGet(name: string): number | undefined {
+	const r = spawnSync('localslip', ['get', name], {
 		encoding: 'utf8',
 		timeout: 5000,
 		windowsHide: true,

package/packages/app/vite.config.ts

@@ -10,7 +10,7 @@ import {
 } from './vite-plugin-critical-theme.ts';
 import { geniePlugin, resolveGenieMount } from './vite-plugin-genie.ts';
 import { pathMountsPlugin } from './vite-plugin-path-mounts.ts';
-import { filepressLeaseName, localberthGet } from './localberth-port.ts';
+import { filepressLeaseName, localslipGet } from './localslip-port.ts';
 import type { PathMount } from '../core/src/lib/paths-shared.ts';
 import { unexpectedUnseenPrerenderRoutes } from './src/lib/prerender-empty-ok.ts';
 import { buildRedirectRules, THEME_PRESETS, type ThemePreset } from '../core/src/lib/config.ts';
@@ -117,7 +117,7 @@ function resolvePort(): number | undefined {
 		const n = Number(raw);
 		return Number.isInteger(n) && n > 0 && n <= 65535 ? n : undefined;
 	}
-	return localberthGet(filepressLeaseName(siteRoot));
+	return localslipGet(filepressLeaseName(siteRoot));
 }
 
 const fixedPort = resolvePort();

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

@@ -16,4 +16,19 @@
 			0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8z"
 		/>
 	</svg>
+{:else if name === 'hn'}
+	<svg class="nav-icon" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true" focusable="false">
+		<rect x="1" y="1" width="14" height="14" rx="2" fill="none" stroke="currentColor" stroke-width="1.2" />
+		<path
+			fill="currentColor"
+			d="M4.35 4h1.85l1.8 3.55L9.8 4h1.85L9.15 8.35V12H7.85V8.35L4.35 4z"
+		/>
+	</svg>
+{:else if name === 'thingiverse'}
+	<svg class="nav-icon" viewBox="0 0 16 16" width="16" height="16" aria-hidden="true" focusable="false">
+		<path
+			fill="currentColor"
+			d="M8 1.4 14.2 4.7v6.6L8 14.6 1.8 11.3V4.7L8 1.4zm0 1.7L3.9 5.2 8 7.4l4.1-2.2L8 3.1zM3.1 6.3 7.3 8.6v4.3L3.1 10.6V6.3zm9.8 0v4.3L8.7 12.9V8.6l4.2-2.3z"
+		/>
+	</svg>
 {/if}

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

@@ -1,32 +1,68 @@
 <script lang="ts">
-	import type { SiteConfig } from '../config';
+	import type { NavItem, SiteConfig } from '../config';
 	import { isPathMountHref } from '../paths-shared';
 	import NavIcon from './NavIcon.svelte';
 
 	let { site, year = new Date().getFullYear() }: { site: SiteConfig; year?: number } = $props();
+
+	const collections = $derived(site.footerLinks.filter((item) => item.icon));
+	const utilities = $derived(site.footerLinks.filter((item) => !item.icon));
+
+	function linkAttrs(item: NavItem) {
+		if (item.icon || /^https?:\/\//i.test(item.href)) {
+			return { target: '_blank' as const, rel: 'noopener noreferrer' };
+		}
+		if (isPathMountHref(item.href, site.paths)) {
+			return { 'data-sveltekit-reload': true };
+		}
+		return {};
+	}
 </script>
 
+{#snippet footerLink(item: NavItem)}
+	<a
+		href={item.href}
+		class:has-icon={Boolean(item.icon)}
+		class:nav-github={item.icon === 'github'}
+		{...linkAttrs(item)}
+	>
+		{#if item.icon}
+			<NavIcon name={item.icon} />
+		{/if}
+		<span class="nav-label">{item.label}</span>
+	</a>
+{/snippet}
+
 <footer class="site-footer">
 	<div class="wrap">
-		<span>&copy; {year} {site.author}</span>
-		<span class="footer-links">
-			{#each site.footerLinks as item (item.href)}
-				<a
-					href={item.href}
-					class:has-icon={Boolean(item.icon)}
-					class:nav-github={item.icon === 'github'}
-					{...(item.icon === 'github'
-						? { target: '_blank', rel: 'noopener noreferrer' }
-						: isPathMountHref(item.href, site.paths)
-							? { 'data-sveltekit-reload': true }
-							: {})}
-				>
-					{#if item.icon}
-						<NavIcon name={item.icon} />
-					{/if}
-					<span class="nav-label">{item.label}</span>
-				</a>
-			{/each}
+		<span class="footer-meta">
+			<span>&copy; {year} {site.author}</span>
+			{#if site.footerCredit}
+				<span class="footer-credit">
+					{site.footerCredit.preface}
+					<a
+						href={site.footerCredit.href}
+						target="_blank"
+						rel="noopener noreferrer"
+					>{site.footerCredit.label}</a>
+				</span>
+			{/if}
+		</span>
+		<span class="footer-end">
+			{#if collections.length}
+				<span class="footer-collections">
+					{#each collections as item (item.href)}
+						{@render footerLink(item)}
+					{/each}
+				</span>
+			{/if}
+			{#if utilities.length}
+				<span class="footer-links">
+					{#each utilities as item (item.href)}
+						{@render footerLink(item)}
+					{/each}
+				</span>
+			{/if}
 		</span>
 	</div>
 </footer>

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

@@ -30,7 +30,8 @@ export interface Topic {
 }
 
 /** Built-in icons that chrome can render beside a nav/footer label. */
-export type NavIconName = 'github';
+export const NAV_ICON_NAMES = ['github', 'hn', 'thingiverse'] as const;
+export type NavIconName = (typeof NAV_ICON_NAMES)[number];
 
 export interface NavItem {
 	label: string;
@@ -39,6 +40,14 @@ export interface NavItem {
 	icon?: NavIconName;
 }
 
+/** Optional footer credit, e.g. a named partnership with an outbound link. */
+export interface FooterCredit {
+	/** Words before the linked name. Default: "In partnership with". */
+	preface: string;
+	label: string;
+	href: string;
+}
+
 /** Fully-resolved site configuration (after defaults are applied). */
 export interface SiteConfig {
 	title: string;
@@ -73,6 +82,8 @@ export interface SiteConfig {
 	 * Pass an explicit list (including RSS/Topics if you still want them) to customize.
 	 */
 	footerLinks: NavItem[];
+	/** Partnership / credit line under the copyright; null when omitted. */
+	footerCredit: FooterCredit | null;
 	topics: Topic[];
 	newsletter: NewsletterConfig | null;
 	/**
@@ -105,6 +116,12 @@ export interface SiteConfigInput {
 	nav?: NavItem[];
 	/** Custom footer links; replaces the default RSS + Topics row when set. */
 	footerLinks?: NavItem[];
+	/** Optional credit under the copyright (partnership, studio, etc.). */
+	footerCredit?: {
+		preface?: string;
+		label: string;
+		href: string;
+	};
 	topics?: Topic[];
 	newsletter?: NewsletterConfig | null;
 	/** Mount site-relative dirs at URL prefixes (docs shells, etc.). */
@@ -129,13 +146,31 @@ function normalizeNavItems(items: NavItem[] | undefined): NavItem[] | null {
 			throw new Error('filepress.config: nav/footerLinks entries need non-empty label and href.');
 		}
 		const icon = item.icon;
-		if (icon != null && icon !== 'github') {
-			throw new Error(`filepress.config: unsupported icon "${String(icon)}" (supported: github).`);
+		if (icon != null && !NAV_ICON_NAMES.includes(icon)) {
+			throw new Error(
+				`filepress.config: unsupported icon "${String(icon)}" (supported: ${NAV_ICON_NAMES.join(', ')}).`
+			);
 		}
 		return icon ? { label, href, icon } : { label, href };
 	});
 }
 
+function normalizeFooterCredit(
+	credit: SiteConfigInput['footerCredit']
+): FooterCredit | null {
+	if (!credit) return null;
+	const label = (credit.label ?? '').trim();
+	const href = (credit.href ?? '').trim();
+	if (!label || !href) {
+		throw new Error('filepress.config: footerCredit needs non-empty label and href.');
+	}
+	if (!/^https?:\/\//i.test(href)) {
+		throw new Error('filepress.config: footerCredit.href must start with http(s)://.');
+	}
+	const preface = (credit.preface ?? 'In partnership with').trim() || 'In partnership with';
+	return { preface, label, href };
+}
+
 /** Path to page 1 of the chronological post index. */
 export function postsIndexPath(site: Pick<SiteConfig, 'homePage'>): string {
 	return site.homePage ? '/posts' : '/';
@@ -202,6 +237,7 @@ export function defineFilepressConfig(input: SiteConfigInput): SiteConfig {
 		homePage,
 		nav: normalizeNavItems(input.nav) ?? defaultNav,
 		footerLinks: normalizeNavItems(input.footerLinks) ?? [...defaultFooterLinks],
+		footerCredit: normalizeFooterCredit(input.footerCredit),
 		topics: input.topics ?? [],
 		newsletter: input.newsletter ?? null,
 		paths: normalizePathMounts(input.paths),

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

@@ -14,7 +14,8 @@ export {
 	ogImageUrl,
 	postsIndexPath,
 	buildRedirectRules,
-	THEME_PRESETS
+	THEME_PRESETS,
+	NAV_ICON_NAMES
 } from './config';
 export type {
 	SiteConfig,
@@ -23,6 +24,7 @@ export type {
 	Topic,
 	NavItem,
 	NavIconName,
+	FooterCredit,
 	PathMount,
 	ThemePreset,
 	RedirectRule

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

@@ -212,10 +212,27 @@ body {
 	color: var(--ink-faint);
 }
 
+.site-footer .footer-meta {
+	display: flex;
+	flex-direction: column;
+	align-items: flex-start;
+	gap: 0.2rem;
+}
+
+.site-footer .footer-end {
+	display: flex;
+	flex-direction: column;
+	align-items: flex-end;
+	gap: 0.45rem;
+}
+
+.site-footer .footer-collections,
 .site-footer .footer-links {
 	display: flex;
 	align-items: center;
-	gap: 1.1rem;
+	flex-wrap: wrap;
+	justify-content: flex-end;
+	gap: 0.35rem 1.1rem;
 }
 
 .site-footer a {

package/packages/import/src/discover.ts

@@ -16,12 +16,14 @@ function asArray<T>(v: T | T[] | undefined | null): T[] {
 	return Array.isArray(v) ? v : [v];
 }
 
-function classify(url: string, origin: string): DiscoveredUrl['kind'] {
+export function classify(url: string, origin: string): DiscoveredUrl['kind'] {
 	const u = new URL(url);
 	if (u.origin !== new URL(origin).origin) return 'other';
 	const path = u.pathname.replace(/\/+$/, '') || '/';
 	if (path === '/') return 'home';
-	if (/\/tags?\//i.test(path) || /\/topics?\//i.test(path)) return 'tag';
+	if (/\/wp-(content|includes|admin|json|login)/i.test(path)) return 'other';
+	if (/\/(tags?|topics?|categor(?:y|ies))\//i.test(path)) return 'tag';
+	if (/^\/\d{4}\/\d{2}(?:\/\d{2})?\//.test(path)) return 'post';
 	if (/\/(writing|essays|posts|blog|articles)\/[^/]+/i.test(path)) return 'post';
 	if (/\/(writing|essays|posts|blog|articles)\/?$/i.test(path)) return 'listing';
 	if (/\/(about|contact|speaking|now|colophon|privacy|resume|cv)\/?$/i.test(path)) return 'page';

package/packages/import/src/extract.ts

@@ -3,6 +3,12 @@ import type { DiscoverResult } from './discover.ts';
 import { fetchText, resolveUrl, sameOrigin } from './fetch.ts';
 import { htmlToMarkdown } from './html-to-md.ts';
 import type { SiteIR, SiteIRPage, SiteIRPost } from './ir.ts';
+import {
+	fetchWordpressCatalog,
+	navFromWordpress,
+	topicsFromWordpress,
+	type WpCatalog
+} from './wordpress.ts';
 
 const RESERVED = new Set([
 	'posts',
@@ -137,12 +143,14 @@ function normalizeTagSlug(raw: string): string {
 
 function tagsFromDoc(document: Document): string[] {
 	const tags = new Set<string>();
-	for (const a of document.querySelectorAll('a[href*="/tag"], a[href*="/tags/"]')) {
+	for (const a of document.querySelectorAll(
+		'a[href*="/tag"], a[href*="/tags/"], a[href*="/category/"], a[rel="tag"], a[rel="category"]'
+	)) {
 		const href = a.getAttribute('href') ?? '';
-		const m = href.match(/\/tags?\/([^/]+)/i);
+		const m = href.match(/\/(?:tags?|categor(?:y|ies))\/([^/]+)/i);
 		if (m) {
 			const t = normalizeTagSlug(decodeURIComponent(m[1]));
-			if (t) tags.add(t);
+			if (t && t !== 'uncategorized') tags.add(t);
 		}
 	}
 	for (const chip of document.querySelectorAll('.tag-chip, .tag, [rel="tag"]')) {
@@ -186,11 +194,30 @@ function uniqueSlug(base: string, used: Set<string>): string {
 	return candidate;
 }
 
+function pathKeyOf(url: string): string {
+	try {
+		return new URL(url).pathname.replace(/\/+$/, '') || '/';
+	} catch {
+		return url;
+	}
+}
+
 /** Build SiteIR from discovery + HTML extraction. */
 export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 	const { origin, urls, rss, rssTitle } = discovered;
 	const notes: string[] = [];
 	const usedSlugs = new Set<string>();
+	let wp: WpCatalog | null = null;
+	try {
+		wp = await fetchWordpressCatalog(origin);
+		if (wp) {
+			notes.push(
+				`WordPress REST: ${wp.posts.length} posts, ${wp.pages.length} pages, ${wp.categories.length} categories.`
+			);
+		}
+	} catch (e) {
+		notes.push(`WordPress REST skipped: ${e instanceof Error ? e.message : e}`);
+	}
 
 	const homeUrl = urls.find((u) => u.kind === 'home')?.url ?? `${origin}/`;
 	const homeDoc = await loadDoc(homeUrl);
@@ -235,6 +262,9 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 		if (homeMd.length > 200 && paragraphs.length >= 2) {
 			homeMarkdown = homeMd;
 			notes.push('Home bio is long enough for pages/home.md; the post index moves to /posts.');
+		} else if (wp && homeMd.length > 20) {
+			homeMarkdown = homeMd;
+			notes.push('WordPress home page kept as pages/home.md even though it is short.');
 		} else {
 			notes.push('Home bio mapped to config `lede` (posts remain the index).');
 		}
@@ -243,10 +273,12 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 	const posts: SiteIRPost[] = [];
 	const rssByPath = new Map(rss.map((r) => [new URL(r.link, origin).pathname.replace(/\/+$/, ''), r]));
 
+	const wpByPath = new Map((wp?.posts ?? []).map((p) => [pathKeyOf(p.link), p]));
 	const postUrls = [
 		...new Set([
 			...urls.filter((u) => u.kind === 'post').map((u) => u.url),
-			...rss.map((r) => resolveUrl(origin, r.link)).filter((u): u is string => Boolean(u))
+			...rss.map((r) => resolveUrl(origin, r.link)).filter((u): u is string => Boolean(u)),
+			...(wp?.posts ?? []).map((p) => p.link)
 		])
 	];
 
@@ -269,17 +301,28 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 			notes.push(`Skipped thin post body: ${finalUrl}`);
 			continue;
 		}
-		const slug = uniqueSlug(slugFromUrl(finalUrl), usedSlugs);
+		const wpPost =
+			wpByPath.get(pathKey) ??
+			wp?.posts.find((p) => p.slug === slugFromUrl(finalUrl) || pathKeyOf(p.link) === pathKey);
+		const slug = uniqueSlug(wpPost?.slug || slugFromUrl(finalUrl), usedSlugs);
 		const date =
+			(wpPost?.date && /^\d{4}-\d{2}-\d{2}$/.test(wpPost.date) ? wpPost.date : null) ||
 			rfc822ToIso(rssItem?.pubDate ?? null) ||
 			dateFromDoc(document) ||
 			new Date().toISOString().slice(0, 10);
+		// WP REST categories/tags are authoritative. HTML chips pick up theme
+		// category widgets and stamp every heading onto every post.
+		const tags = wpPost ? [...wpPost.tags] : tagsFromDoc(document);
 		posts.push({
 			slug,
-			title: rssItem?.title || titleFromDoc(document),
+			title: wpPost?.title || rssItem?.title || titleFromDoc(document),
 			date,
-			tags: tagsFromDoc(document),
-			description: rssItem?.description || subtitle || metaContent(document, 'meta[name="description"]'),
+			tags,
+			description:
+				wpPost?.excerpt ||
+				rssItem?.description ||
+				subtitle ||
+				metaContent(document, 'meta[name="description"]'),
 			markdown,
 			sourceUrl: finalUrl,
 			imageUrls: extractImages(clone, finalUrl, origin)
@@ -290,7 +333,18 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 	posts.sort((a, b) => (a.date < b.date ? 1 : a.date > b.date ? -1 : a.slug.localeCompare(b.slug)));
 
 	const pages: SiteIRPage[] = [];
-	const pageUrls = urls.filter((u) => u.kind === 'page');
+	const pageUrlSet = new Set<string>();
+	const pageUrls = [
+		...urls.filter((u) => u.kind === 'page'),
+		...(wp?.pages ?? [])
+			.filter((p) => !p.isHome)
+			.map((p) => ({ url: p.link, kind: 'page' as const }))
+	].filter((u) => {
+		const key = pathKeyOf(u.url);
+		if (pageUrlSet.has(key)) return false;
+		pageUrlSet.add(key);
+		return true;
+	});
 	let order = 1;
 	for (const { url } of pageUrls) {
 		const loaded = await loadDoc(url);
@@ -298,6 +352,10 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 		const { document, finalUrl } = loaded;
 		const path = new URL(finalUrl).pathname.replace(/\/+$/, '') || '/';
 		if (path === '/') continue;
+		if (slugFromUrl(finalUrl) === 'sample-page') {
+			notes.push(`Skipped default WordPress sample page: ${finalUrl}`);
+			continue;
+		}
 		const main = pickMain(document);
 		const clone = main.cloneNode(true) as Element;
 		clone.querySelector('h1')?.remove();
@@ -328,32 +386,38 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 		notes.push(`Page ${finalUrl} → /${slug}`);
 	}
 
-	// Topics from tags
+	// Topics from WordPress categories when present; else from extracted tags
 	const tagCounts = new Map<string, number>();
 	for (const p of posts) {
 		for (const t of p.tags) tagCounts.set(t, (tagCounts.get(t) ?? 0) + 1);
 	}
-	const topics = [...tagCounts.entries()]
-		.sort((a, b) => b[1] - a[1])
-		.slice(0, 12)
-		.map(([tag]) => ({
-			label: tag.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
-			tag
-		}));
+	const topics = wp
+		? topicsFromWordpress(wp)
+		: [...tagCounts.entries()]
+				.sort((a, b) => b[1] - a[1])
+				.slice(0, 12)
+				.map(([tag]) => ({
+					label: tag.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
+					tag
+				}));
 
-	const nav: Array<{ label: string; href: string }> = homeMarkdown
-		? [
-				{ label: 'Home', href: '/' },
-				{ label: 'Posts', href: '/posts' }
-			]
-		: [{ label: 'Posts', href: '/' }];
-	for (const page of pages) {
-		nav.push({
-			label: page.title,
-			href: `/${page.slug}`
-		});
+	const nav: Array<{ label: string; href: string }> = wp
+		? navFromWordpress(wp, { homePage: Boolean(homeMarkdown) })
+		: homeMarkdown
+			? [
+					{ label: 'Home', href: '/' },
+					{ label: 'Posts', href: '/posts' }
+				]
+			: [{ label: 'Posts', href: '/' }];
+	if (!wp) {
+		for (const page of pages) {
+			nav.push({
+				label: page.title,
+				href: `/${page.slug}`
+			});
+		}
+		if (topics.length) nav.push({ label: 'Topics', href: '/topics' });
 	}
-	if (topics.length) nav.push({ label: 'Topics', href: '/topics' });
 
 	const assets: string[] = [];
 	if (homeDoc) {
@@ -365,6 +429,12 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 			const abs = resolveUrl(homeUrl, href);
 			if (abs && sameOrigin(abs, origin)) assets.push(abs);
 		}
+		const logoImg = homeDoc.document.querySelector('img.custom-logo, .custom-logo-link img');
+		const logoSrc = logoImg?.getAttribute('src');
+		if (logoSrc) {
+			const abs = resolveUrl(homeUrl, logoSrc);
+			if (abs) assets.push(abs);
+		}
 	}
 	// Common fallbacks often linked from HTML even when not in <link>
 	for (const path of ['/favicon.ico', '/favicon.svg', '/favicon-64.png', '/apple-touch-icon.png']) {
@@ -372,7 +442,7 @@ export async function extractSite(discovered: DiscoverResult): Promise<SiteIR> {
 	}
 
 	return {
-		source: { url: origin, generator },
+		source: { url: origin, generator: generator ?? (wp ? 'WordPress' : null) },
 		identity: {
 			title,
 			description: description || `${title} — imported into filepress.`,

package/packages/import/src/theme.ts

@@ -438,10 +438,54 @@ export function parseBriefJson(raw: string): DesignBrief {
 	};
 }
 
+function normalizeHex(raw: string | undefined): string | undefined {
+	if (!raw) return undefined;
+	const v = raw.trim();
+	if (/^#([0-9a-fA-F]{3})$/.test(v)) {
+		return `#${v[1]}${v[1]}${v[2]}${v[2]}${v[3]}${v[3]}`;
+	}
+	if (/^#([0-9a-fA-F]{6})$/.test(v)) return v;
+	return undefined;
+}
+
+function firstInlineHex(html: string, patterns: RegExp[]): string | undefined {
+	for (const re of patterns) {
+		const m = html.match(re);
+		const hex = normalizeHex(m?.[1]);
+		if (hex) return hex;
+	}
+	return undefined;
+}
+
+/** Fallback when the source theme (Astra, etc.) inlines hex instead of :root tokens. */
+function tokensFromInlineRules(html: string): Partial<DesignBrief['tokens']> {
+	const bg = firstInlineHex(html, [
+		/body(?:,[^{]{0,80})?\{[^}]*background-color:\s*(#[0-9a-fA-F]{3,8})/i
+	]);
+	const accent = firstInlineHex(html, [
+		/::selection\{[^}]*background-color:\s*(#[0-9a-fA-F]{3,8})/i,
+		/\.elementor-button[^{]*\{[^}]*background-color:\s*(#[0-9a-fA-F]{3,8})/i,
+		/(?:^|[,}])\s*a(?:,[^{]{0,40})?\{[^}]*color:\s*(#[0-9a-fA-F]{3,8})/i
+	]);
+	const ink = firstInlineHex(html, [
+		/body,h1,[^{]{0,120}\{[^}]*color:\s*(#[0-9a-fA-F]{3,8})/i,
+		/body(?:,[^{]{0,80})?\{[^}]*[^-]color:\s*(#[0-9a-fA-F]{3,8})/i
+	]);
+	const out: Partial<DesignBrief['tokens']> = {};
+	if (accent) {
+		out.accent = accent;
+		out.accentStrong = darken(accent);
+	}
+	if (bg) out.bg = bg;
+	if (ink) out.ink = ink;
+	return out;
+}
+
 /** Extract CSS custom properties from inline :root blocks (source site). */
 export function tokensFromSourceCss(html: string): Partial<DesignBrief['tokens']> {
+	const fallback = tokensFromInlineRules(html);
 	const m = html.match(/:root\s*\{([^}]+)\}/);
-	if (!m) return {};
+	if (!m) return fallback;
 	const block = m[1];
 	const vars = new Map<string, string>();
 	for (const hit of block.matchAll(/--([a-zA-Z0-9-_]+)\s*:\s*([^;}]+)/g)) {
@@ -457,15 +501,15 @@ export function tokensFromSourceCss(html: string): Partial<DesignBrief['tokens']
 	};
 	const firstHex = (...names: string[]) => {
 		for (const n of names) {
-			const v = resolve(n);
-			if (v && /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(v)) return v;
+			const v = normalizeHex(resolve(n));
+			if (v) return v;
 		}
 		return undefined;
 	};
 	const accent = firstHex('accent-color', 'accent', 'color-gold', 'color-augment');
 	const bg = firstHex('bg-color', 'bg', 'color-bg', 'color-cream');
 	const ink = firstHex('text-color', 'ink', 'color-espresso');
-	const out: Partial<DesignBrief['tokens']> = {};
+	const out: Partial<DesignBrief['tokens']> = { ...fallback };
 	if (accent) {
 		out.accent = accent;
 		out.accentStrong = firstHex('accent-strong', 'color-understand') || accent;

package/packages/import/src/wordpress.ts

@@ -0,0 +1,194 @@
+/**
+ * WordPress REST overlay for filepress import.
+ * Sitemap + HTML still own the crawl; this fills categories → tags and nav.
+ */
+import { fetchText, originOf } from './fetch.ts';
+
+export type WpTerm = {
+	id: number;
+	name: string;
+	slug: string;
+	count: number;
+};
+
+export type WpPostStub = {
+	slug: string;
+	title: string;
+	date: string;
+	link: string;
+	excerpt: string | null;
+	/** Category + tag slugs; `uncategorized` dropped. */
+	tags: string[];
+};
+
+export type WpPageStub = {
+	slug: string;
+	title: string;
+	link: string;
+	excerpt: string | null;
+	isHome: boolean;
+};
+
+export type WpCatalog = {
+	posts: WpPostStub[];
+	pages: WpPageStub[];
+	categories: WpTerm[];
+	tags: WpTerm[];
+};
+
+const SKIP_CATEGORY = new Set(['uncategorized']);
+const SKIP_PAGE = new Set(['sample-page']);
+
+export function decodeWpText(raw: string): string {
+	return raw
+		.replace(/<[^>]+>/g, ' ')
+		.replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)))
+		.replace(/&#x([0-9a-f]+);/gi, (_, n) => String.fromCodePoint(parseInt(n, 16)))
+		.replace(/&amp;/g, '&')
+		.replace(/&lt;/g, '<')
+		.replace(/&gt;/g, '>')
+		.replace(/&quot;/g, '"')
+		.replace(/&#039;|&apos;/g, "'")
+		.replace(/&nbsp;/g, ' ')
+		.replace(/\s+/g, ' ')
+		.trim();
+}
+
+export function termsToTags(categories: WpTerm[], tags: WpTerm[], categoryIds: number[], tagIds: number[]): string[] {
+	const byId = new Map<number, WpTerm>();
+	for (const t of [...categories, ...tags]) byId.set(t.id, t);
+	const out: string[] = [];
+	for (const id of [...categoryIds, ...tagIds]) {
+		const term = byId.get(id);
+		if (!term || SKIP_CATEGORY.has(term.slug)) continue;
+		if (!out.includes(term.slug)) out.push(term.slug);
+	}
+	return out;
+}
+
+export function navFromWordpress(catalog: WpCatalog, opts: { homePage: boolean }): Array<{ label: string; href: string }> {
+	const nav: Array<{ label: string; href: string }> = opts.homePage
+		? [
+				{ label: 'Home', href: '/' },
+				{ label: 'Posts', href: '/posts' }
+			]
+		: [{ label: 'Posts', href: '/' }];
+	for (const c of catalog.categories) {
+		if (SKIP_CATEGORY.has(c.slug) || c.count < 1) continue;
+		nav.push({ label: c.name, href: `/tags/${c.slug}` });
+	}
+	for (const page of catalog.pages) {
+		if (page.isHome || SKIP_PAGE.has(page.slug)) continue;
+		const label = page.slug === 'contact-us' ? 'Contact' : page.title;
+		nav.push({ label, href: `/${page.slug}` });
+	}
+	return nav;
+}
+
+export function topicsFromWordpress(catalog: WpCatalog): Array<{ label: string; tag: string }> {
+	return catalog.categories
+		.filter((c) => !SKIP_CATEGORY.has(c.slug) && c.count > 0)
+		.map((c) => ({ label: c.name, tag: c.slug }));
+}
+
+type WpJsonPost = {
+	slug?: string;
+	title?: { rendered?: string };
+	date?: string;
+	link?: string;
+	excerpt?: { rendered?: string };
+	categories?: number[];
+	tags?: number[];
+};
+
+type WpJsonPage = WpJsonPost & { id?: number };
+
+type WpJsonTerm = {
+	id?: number;
+	name?: string;
+	slug?: string;
+	count?: number;
+};
+
+async function fetchCollection<T>(url: string): Promise<T[] | null> {
+	const { status, text, contentType } = await fetchText(url, {
+		headers: { accept: 'application/json' }
+	});
+	if (status >= 400) return null;
+	if (contentType && !/json/i.test(contentType) && !text.trimStart().startsWith('[')) return null;
+	try {
+		const data = JSON.parse(text) as unknown;
+		return Array.isArray(data) ? (data as T[]) : null;
+	} catch {
+		return null;
+	}
+}
+
+function mapTerm(t: WpJsonTerm): WpTerm | null {
+	if (typeof t.id !== 'number' || !t.slug) return null;
+	return {
+		id: t.id,
+		name: decodeWpText(String(t.name ?? t.slug)),
+		slug: String(t.slug),
+		count: typeof t.count === 'number' ? t.count : 0
+	};
+}
+
+/** Probe `/wp-json/wp/v2` and load posts, pages, categories, tags. Null if not WordPress. */
+export async function fetchWordpressCatalog(sourceUrl: string): Promise<WpCatalog | null> {
+	const origin = originOf(sourceUrl.endsWith('/') ? sourceUrl : `${sourceUrl}/`);
+	const probe = await fetchText(`${origin}/wp-json/wp/v2/categories?per_page=1&_fields=id`, {
+		headers: { accept: 'application/json' }
+	});
+	if (probe.status >= 400) return null;
+	if (!/json/i.test(probe.contentType) && !probe.text.trimStart().startsWith('[')) return null;
+
+	const [postsRaw, pagesRaw, catsRaw, tagsRaw] = await Promise.all([
+		fetchCollection<WpJsonPost>(
+			`${origin}/wp-json/wp/v2/posts?per_page=100&_fields=slug,title,date,link,excerpt,categories,tags`
+		),
+		fetchCollection<WpJsonPage>(
+			`${origin}/wp-json/wp/v2/pages?per_page=100&_fields=id,slug,title,date,link,excerpt`
+		),
+		fetchCollection<WpJsonTerm>(`${origin}/wp-json/wp/v2/categories?per_page=100`),
+		fetchCollection<WpJsonTerm>(`${origin}/wp-json/wp/v2/tags?per_page=100`)
+	]);
+
+	if (!postsRaw && !pagesRaw) return null;
+
+	const categories = (catsRaw ?? []).map(mapTerm).filter((t): t is WpTerm => Boolean(t));
+	const tags = (tagsRaw ?? []).map(mapTerm).filter((t): t is WpTerm => Boolean(t));
+
+	const posts: WpPostStub[] = (postsRaw ?? [])
+		.filter((p) => p.link && p.slug)
+		.map((p) => ({
+			slug: String(p.slug),
+			title: decodeWpText(String(p.title?.rendered ?? p.slug)),
+			date: String(p.date ?? '').slice(0, 10),
+			link: String(p.link),
+			excerpt: p.excerpt?.rendered ? decodeWpText(p.excerpt.rendered) : null,
+			tags: termsToTags(categories, tags, p.categories ?? [], p.tags ?? [])
+		}));
+
+	const pages: WpPageStub[] = (pagesRaw ?? [])
+		.filter((p) => p.link && p.slug)
+		.filter((p) => !SKIP_PAGE.has(String(p.slug)))
+		.map((p) => {
+			const link = String(p.link);
+			let path = '/';
+			try {
+				path = new URL(link).pathname.replace(/\/+$/, '') || '/';
+			} catch {
+				/* keep / */
+			}
+			return {
+				slug: String(p.slug),
+				title: decodeWpText(String(p.title?.rendered ?? p.slug)),
+				link,
+				excerpt: p.excerpt?.rendered ? decodeWpText(p.excerpt.rendered) : null,
+				isHome: path === '/'
+			};
+		});
+
+	return { posts, pages, categories, tags };
+}

package/scripts/ensure-lease.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Idempotent LocalBerth claim for FilePress (and sibling) dev ports.
+ * Idempotent LocalSlip claim for FilePress (and sibling) dev ports.
  * Usage: node scripts/ensure-lease.mjs <name> <port>
  * Missing CLI → one line, exit 0. Existing lease → keep it (do not rewrite).
  */
@@ -14,11 +14,11 @@ if (!name || !port) {
 }
 
 const opt = { encoding: 'utf8', timeout: 8000, windowsHide: true, shell: process.platform === 'win32' };
-const got = spawnSync('localberth', ['get', name], { ...opt, stdio: ['ignore', 'pipe', 'ignore'] });
+const got = spawnSync('localslip', ['get', name], { ...opt, stdio: ['ignore', 'pipe', 'ignore'] });
 if (got.status === 0 && String(got.stdout || '').trim()) {
 	process.exit(0);
 }
-const claim = spawnSync('localberth', ['claim', name, '--port', port], { ...opt, stdio: 'inherit' });
+const claim = spawnSync('localslip', ['claim', name, '--port', port], { ...opt, stdio: 'inherit' });
 if (claim.error || claim.status !== 0) {
-	console.warn(`localberth: skip claim ${name} (install the CLI to pin this site to ${port})`);
+	console.warn(`localslip: skip claim ${name} (install the CLI to pin this site to ${port})`);
 }