getfilepress 0.0.0 → 0.1.0

package/packages/core/src/lib/content/rehype-figure.ts

@@ -0,0 +1,79 @@
+/**
+ * A tiny rehype transform: a paragraph whose only meaningful child is an image
+ * becomes a `<figure>`, and the image's `title` (falling back to `alt`) becomes
+ * a `<figcaption>`. This gives Ben Evans–style captioned images from plain
+ * Markdown (`![alt](src "Caption")`) with no new authoring syntax.
+ *
+ * Kept dependency-free (no unist-util-visit) so the content pipeline stays lean
+ * and easy to unit-test.
+ */
+
+interface HastNode {
+	type: string;
+	tagName?: string;
+	value?: string;
+	properties?: Record<string, unknown>;
+	children?: HastNode[];
+}
+
+function isWhitespaceText(node: HastNode): boolean {
+	return node.type === 'text' && (node.value ?? '').trim() === '';
+}
+
+/** The single <img> element inside a node's children, or null if it isn't image-only. */
+function loneImage(children: HastNode[]): HastNode | null {
+	const meaningful = children.filter((c) => !isWhitespaceText(c));
+	if (meaningful.length !== 1) return null;
+	const only = meaningful[0];
+	if (only.type === 'element' && only.tagName === 'img') return only;
+	// Support a linked image: <a><img/></a>
+	if (
+		only.type === 'element' &&
+		only.tagName === 'a' &&
+		only.children &&
+		only.children.length === 1 &&
+		only.children[0].type === 'element' &&
+		only.children[0].tagName === 'img'
+	) {
+		return only.children[0];
+	}
+	return null;
+}
+
+function captionText(img: HastNode): string {
+	const props = img.properties ?? {};
+	const title = typeof props.title === 'string' ? props.title.trim() : '';
+	if (title) return title;
+	const alt = typeof props.alt === 'string' ? props.alt.trim() : '';
+	return alt;
+}
+
+export function rehypeFigure() {
+	return (tree: HastNode) => {
+		const children = tree.children;
+		if (!children) return;
+		for (let i = 0; i < children.length; i++) {
+			const node = children[i];
+			if (node.type !== 'element' || node.tagName !== 'p' || !node.children) continue;
+			const img = loneImage(node.children);
+			if (!img) continue;
+
+			const caption = captionText(img);
+			const figureChildren: HastNode[] = [...node.children];
+			if (caption) {
+				figureChildren.push({
+					type: 'element',
+					tagName: 'figcaption',
+					properties: {},
+					children: [{ type: 'text', value: caption }]
+				});
+			}
+			children[i] = {
+				type: 'element',
+				tagName: 'figure',
+				properties: {},
+				children: figureChildren
+			};
+		}
+	};
+}

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

@@ -0,0 +1,88 @@
+/** Frontmatter as authored in a post's YAML block (before validation). */
+export interface RawFrontmatter {
+	title?: unknown;
+	date?: unknown;
+	slug?: unknown;
+	description?: unknown;
+	excerpt?: unknown;
+	tags?: unknown;
+	draft?: unknown;
+	updated?: unknown;
+	author?: unknown;
+}
+
+/** Validated, normalized metadata for a single post. */
+export interface PostMeta {
+	/** URL path segment, e.g. "my-first-post". */
+	slug: string;
+	title: string;
+	/** Publish date, strict YYYY-MM-DD. */
+	date: string;
+	/** Optional last-updated date, strict YYYY-MM-DD. */
+	updated: string | null;
+	/** Short summary for listings and SEO; null if not provided. */
+	description: string | null;
+	/** Normalized (lowercased, trimmed, de-duplicated) tags. */
+	tags: string[];
+	/** Optional per-post author byline; null falls back to the site author in views. */
+	author: string | null;
+	draft: boolean;
+	/** Source file path relative to the repo root, e.g. "/posts/foo.md". */
+	sourcePath: string;
+}
+
+/** A post's metadata plus its raw (uncompiled) Markdown body. */
+export interface PostSource extends PostMeta {
+	body: string;
+}
+
+/** A fully rendered post: metadata plus compiled HTML body. */
+export interface RenderedPost extends PostMeta {
+	html: string;
+}
+
+/** Frontmatter as authored in a static page's YAML block (before validation). */
+export interface RawPageFrontmatter {
+	title?: unknown;
+	slug?: unknown;
+	description?: unknown;
+	excerpt?: unknown;
+	draft?: unknown;
+	/** Optional nav/sort weight; lower first. */
+	order?: unknown;
+}
+
+/** Validated metadata for a static Markdown page (`pages/*.md` → `/<slug>`). */
+export interface PageMeta {
+	slug: string;
+	title: string;
+	description: string | null;
+	draft: boolean;
+	/** Sort weight for listings/nav helpers; default 0. */
+	order: number;
+	/** Source file path, e.g. "/pages/about.md". */
+	sourcePath: string;
+}
+
+export interface PageSource extends PageMeta {
+	body: string;
+}
+
+export interface RenderedPage extends PageMeta {
+	html: string;
+}
+
+/**
+ * Path segments reserved by the engine. A `pages/<slug>.md` file must not use
+ * these (or collide with another page slug).
+ */
+export const RESERVED_PAGE_SLUGS = [
+	'posts',
+	'writing',
+	'tags',
+	'topics',
+	'page',
+	'rss.xml',
+	'sitemap.xml',
+	'robots.txt'
+] as const;

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

@@ -0,0 +1,25 @@
+const MONTHS = [
+	'January',
+	'February',
+	'March',
+	'April',
+	'May',
+	'June',
+	'July',
+	'August',
+	'September',
+	'October',
+	'November',
+	'December'
+];
+
+/**
+ * Format a strict YYYY-MM-DD string as "4 July 2026". Parsed as UTC parts so the
+ * displayed date never shifts by a day due to the runner's timezone (see the
+ * SSR-vs-build Date lesson) — and since the site is fully prerendered, this is
+ * computed once at build time.
+ */
+export function formatDate(iso: string): string {
+	const [y, m, d] = iso.split('-').map(Number);
+	return `${d} ${MONTHS[m - 1]} ${y}`;
+}

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

@@ -0,0 +1,27 @@
+// Client-safe public API for @filepress/core. No filesystem or env access here,
+// so it is safe to import from universal/client code. Server-only helpers
+// (content loader, feed builders) live in `@filepress/core/server`.
+
+export { default as PostCard } from './components/PostCard.svelte';
+export { default as PostIndex } from './components/PostIndex.svelte';
+export { default as Newsletter } from './components/Newsletter.svelte';
+export { default as SiteHeader } from './components/SiteHeader.svelte';
+export { default as SiteFooter } from './components/SiteFooter.svelte';
+
+export {
+	defineFilepressConfig,
+	absoluteUrl,
+	ogImageUrl,
+	postsIndexPath
+} from './config';
+export type {
+	SiteConfig,
+	SiteConfigInput,
+	NewsletterConfig,
+	Topic,
+	NavItem
+} from './config';
+
+export { formatDate } from './format';
+
+export type { PostMeta, PostSource, RenderedPost, RawFrontmatter } from './content/types';

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

@@ -0,0 +1,33 @@
+// Server-only public API for @filepress/core. These modules touch the
+// filesystem (content loader) and must only be imported from server code
+// (`+page.server.ts`, `+server.ts`, or a `*.server.ts` lib module).
+
+export { createContent, resolveListDrafts } from './content/content';
+export type { CreateContentOptions } from './content/content';
+export type { ContentApi } from './content/content';
+export { createPages } from './content/pages';
+export type { CreatePagesOptions, PagesApi } from './content/pages';
+export { renderMarkdown } from './content/markdown';
+export { buildRssXml, buildSitemapXml, buildRobotsTxt } from './content/feeds';
+export {
+	ContentError,
+	parsePost,
+	parsePage,
+	slugify,
+	normalizeTag,
+	assertUniqueSlugs,
+	assertValidDate,
+	filenameOf
+} from './content/parse';
+
+export { absoluteUrl, ogImageUrl } from './config';
+export type { SiteConfig } from './config';
+export type {
+	PostMeta,
+	PostSource,
+	RenderedPost,
+	PageMeta,
+	PageSource,
+	RenderedPage
+} from './content/types';
+export { RESERVED_PAGE_SLUGS } from './content/types';

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

@@ -0,0 +1,72 @@
+/**
+ * Latin + latin-ext only — avoids shipping cyrillic/greek/vietnamese slices
+ * from the full @fontsource-variable index CSS (~half the demo font payload).
+ */
+@font-face {
+	font-family: 'Inter Variable';
+	font-style: normal;
+	font-display: swap;
+	font-weight: 100 900;
+	src: url('@fontsource-variable/inter/files/inter-latin-ext-wght-normal.woff2')
+		format('woff2-variations');
+	unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304,
+		U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0,
+		U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+	font-family: 'Inter Variable';
+	font-style: normal;
+	font-display: swap;
+	font-weight: 100 900;
+	src: url('@fontsource-variable/inter/files/inter-latin-wght-normal.woff2')
+		format('woff2-variations');
+	unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304,
+		U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+	font-family: 'Newsreader Variable';
+	font-style: normal;
+	font-display: swap;
+	font-weight: 200 800;
+	src: url('@fontsource-variable/newsreader/files/newsreader-latin-ext-wght-normal.woff2')
+		format('woff2-variations');
+	unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304,
+		U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0,
+		U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+	font-family: 'Newsreader Variable';
+	font-style: normal;
+	font-display: swap;
+	font-weight: 200 800;
+	src: url('@fontsource-variable/newsreader/files/newsreader-latin-wght-normal.woff2')
+		format('woff2-variations');
+	unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304,
+		U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+
+@font-face {
+	font-family: 'Newsreader Variable';
+	font-style: italic;
+	font-display: swap;
+	font-weight: 200 800;
+	src: url('@fontsource-variable/newsreader/files/newsreader-latin-ext-standard-italic.woff2')
+		format('woff2-variations');
+	unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304,
+		U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0,
+		U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+
+@font-face {
+	font-family: 'Newsreader Variable';
+	font-style: italic;
+	font-display: swap;
+	font-weight: 200 800;
+	src: url('@fontsource-variable/newsreader/files/newsreader-latin-standard-italic.woff2')
+		format('woff2-variations');
+	unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304,
+		U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}