@fuzdev/fuz_blog 0.20.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Ryan Atkinson <mail@ryanatkn.com> <https://ryanatkn.com/>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @fuzdev/fuz_blog 🖊️
+
+[<img src="/static/logo.svg" alt="a friendly yellow spider facing you" align="right" width="192" height="192">](https://blog.fuz.dev/)
+
+> blog software from scratch with SvelteKit
+
+[**blog.fuz.dev**](https://blog.fuz.dev/)
+
+[npm](https://www.npmjs.com/package/@fuzdev/fuz_blog):
+
+```bash
+npm i @fuzdev/fuz_blog
+```
+
+## License [🐦](https://wikipedia.org/wiki/Free_and_open-source_software)
+
+[MIT](LICENSE)

package/dist/BlogPost.svelte

@@ -0,0 +1,64 @@
+<script lang="ts">
+	import type {SvelteHTMLElements} from 'svelte/elements';
+	import type {Snippet} from 'svelte';
+	import Toot from '@fuzdev/fuz_mastodon/Toot.svelte';
+	import {mastodon_cache_context} from '@fuzdev/fuz_mastodon/mastodon_cache.svelte.js';
+
+	import BlogPostHeader from './BlogPostHeader.svelte';
+	import {blog_feed_context, type BlogPostData} from './blog.js';
+
+	interface Props {
+		post: BlogPostData;
+		attrs?: SvelteHTMLElements['article'] | undefined;
+		footer?: Snippet;
+		separator?: Snippet; // TODO currently only used before comments, maybe rename to `comments_header` or something?
+		children: Snippet;
+	}
+
+	const {post, attrs, footer, separator = default_separator, children}: Props = $props();
+
+	const feed = blog_feed_context.get();
+
+	// TODO maybe clean up the type vs `post`
+	const item = feed.items.find((i) => i.slug === post.slug);
+
+	const cache = mastodon_cache_context.get_maybe();
+</script>
+
+<svelte:head>
+	<!-- TODO title suffix like - ryanatkn.com/blog -->
+	<title>{post.title}</title>
+</svelte:head>
+
+<div class="blog_post width_upto_md">
+	{#if item}
+		<article {...attrs}>
+			<BlogPostHeader {item} />
+			{@render children()}
+			{@render footer?.()}
+			{#if item.comments}
+				{@render separator()}
+				<!-- TODO the storage key is weird -->
+				<!-- TODO use local cache in dev -->
+				<section>
+					<h2>Comments</h2>
+					{#if !cache || cache.data !== undefined}
+						<Toot
+							url={item.comments.url}
+							include_replies
+							initial_autoload
+							reply_filter={(item) => ({type: 'favourited_by', favourited_by: [item.account.acct]})}
+							settings_storage_key="{item.id}_comments_settings"
+							cache={cache?.data}
+						/>
+					{/if}
+				</section>
+				{@render separator()}
+			{/if}
+		</article>
+	{:else}
+		<div>cannot find post <code>{post.slug}</code></div>
+	{/if}
+</div>
+
+{#snippet default_separator()}<hr />{/snippet}

package/dist/BlogPost.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { SvelteHTMLElements } from 'svelte/elements';
+import type { Snippet } from 'svelte';
+import { type BlogPostData } from './blog.js';
+interface Props {
+    post: BlogPostData;
+    attrs?: SvelteHTMLElements['article'] | undefined;
+    footer?: Snippet;
+    separator?: Snippet;
+    children: Snippet;
+}
+declare const BlogPost: import("svelte").Component<Props, {}, "">;
+type BlogPost = ReturnType<typeof BlogPost>;
+export default BlogPost;
+//# sourceMappingURL=BlogPost.svelte.d.ts.map

package/dist/BlogPost.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogPost.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/BlogPost.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAKpC,OAAO,EAAoB,KAAK,YAAY,EAAC,MAAM,WAAW,CAAC;AAG9D,UAAU,KAAK;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAsDF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/BlogPostHeader.svelte

@@ -0,0 +1,17 @@
+<script lang="ts">
+	import FeedItemDate from './FeedItemDate.svelte';
+	import type {BlogPostItem} from './blog.js';
+
+	interface Props {
+		item: BlogPostItem;
+	}
+
+	const {item}: Props = $props();
+</script>
+
+<header>
+	<h1 class="mt_xl5 mb_lg">{item.title}</h1>
+	<p class="mb_xl5">
+		<FeedItemDate {item} />
+	</p>
+</header>

package/dist/BlogPostHeader.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { BlogPostItem } from './blog.js';
+interface Props {
+    item: BlogPostItem;
+}
+declare const BlogPostHeader: import("svelte").Component<Props, {}, "">;
+type BlogPostHeader = ReturnType<typeof BlogPostHeader>;
+export default BlogPostHeader;
+//# sourceMappingURL=BlogPostHeader.svelte.d.ts.map

package/dist/BlogPostHeader.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlogPostHeader.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/BlogPostHeader.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AAG3C,UAAU,KAAK;IACd,IAAI,EAAE,YAAY,CAAC;CACnB;AAkBF,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/FeedItemDate.svelte

@@ -0,0 +1,15 @@
+<script lang="ts">
+	import type {FeedItem} from './feed.js';
+	import {format_date} from './util.js';
+
+	interface Props {
+		item: FeedItem;
+	}
+
+	const {item}: Props = $props();
+</script>
+
+{format_date(
+	item.date_published || item.date_modified,
+)}{#if item.date_published && item.date_modified && item.date_published !== item.date_modified},
+	updated {format_date(item.date_modified)}{/if}

package/dist/FeedItemDate.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { FeedItem } from './feed.js';
+interface Props {
+    item: FeedItem;
+}
+declare const FeedItemDate: import("svelte").Component<Props, {}, "">;
+type FeedItemDate = ReturnType<typeof FeedItemDate>;
+export default FeedItemDate;
+//# sourceMappingURL=FeedItemDate.svelte.d.ts.map

package/dist/FeedItemDate.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedItemDate.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/FeedItemDate.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAC;AAIvC,UAAU,KAAK;IACd,IAAI,EAAE,QAAQ,CAAC;CACf;AAgBF,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/HashLink.svelte

@@ -0,0 +1,39 @@
+<script lang="ts">
+	import type {Snippet} from 'svelte';
+
+	// TODO maybe move to Fuz
+
+	interface Props {
+		slug: string;
+		children: Snippet;
+	}
+
+	const {slug, children}: Props = $props();
+</script>
+
+<div class="hash_link" id={slug}>
+	{@render children()}
+	<a class="icon_button" href="#{slug}">🔗</a>
+</div>
+
+<style>
+	.hash_link {
+		display: flex;
+		align-items: center;
+		position: relative;
+	}
+	a {
+		--icon_size: var(--icon_size_sm);
+		position: absolute;
+		left: calc(var(--icon_size, var(--icon_size_md)) * -1 - var(--space_xl));
+		opacity: 0;
+		font-size: var(--font_size_lg);
+		display: flex;
+		align-items: center;
+		justify-content: center;
+		margin-left: var(--space_md);
+	}
+	.hash_link:hover a {
+		opacity: 1;
+	}
+</style>

package/dist/HashLink.svelte.d.ts

@@ -0,0 +1,9 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    slug: string;
+    children: Snippet;
+}
+declare const HashLink: import("svelte").Component<Props, {}, "">;
+type HashLink = ReturnType<typeof HashLink>;
+export default HashLink;
+//# sourceMappingURL=HashLink.svelte.d.ts.map

package/dist/HashLink.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HashLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/HashLink.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAKnC,UAAU,KAAK;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CAClB;AAiBF,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/blog.d.ts

@@ -0,0 +1,53 @@
+import type { Component } from 'svelte';
+import type { Flavored, OmitStrict } from '@fuzdev/fuz_util/types.js';
+import type { Feed } from './feed.js';
+export type BlogFeedData = OmitStrict<Feed, 'items'>;
+export interface BlogFeed extends Feed {
+    items: Array<BlogPostItem>;
+}
+/**
+ * The author-defined data for each post.
+ */
+export interface BlogPostData {
+    title: string;
+    slug: string;
+    date_published: string;
+    date_modified: string;
+    summary: string;
+    tags?: Array<string>;
+    comments?: BlogComments;
+}
+export type BlogComments = MastodonBlogComments;
+export interface MastodonBlogComments {
+    url: string;
+    type: 'mastodon';
+}
+export interface BlogModule {
+    blog: BlogFeedData;
+}
+export interface BlogPostModule {
+    post: BlogPostData;
+    default: Component<any>;
+}
+export type BlogPostId = Flavored<number, 'BlogPostId'>;
+export interface BlogPostItem extends BlogPostData {
+    /**
+     * Blog post path with `blog_post_id`.
+     */
+    id: string;
+    /**
+     * Blog post path with `slug`.
+     */
+    url: string;
+    /**
+     * Incrementing 1-based integer.
+     */
+    blog_post_id: BlogPostId;
+    tags: Array<string>;
+}
+export declare const blog_feed_context: {
+    get: (error_message?: string) => BlogFeed;
+    get_maybe: () => BlogFeed | undefined;
+    set: (value: BlogFeed) => BlogFeed;
+};
+//# sourceMappingURL=blog.d.ts.map

package/dist/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/blog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAC,QAAQ,EAAE,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAGpE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAMpC,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,WAAW,QAAS,SAAQ,IAAI;IACrC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB;AAGD,MAAM,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAExD,MAAM,WAAW,YAAa,SAAQ,YAAY;IACjD;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,YAAY,EAAE,UAAU,CAAC;IAEzB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB;;;;CAA6B,CAAC"}

package/dist/blog.gen.d.ts

@@ -0,0 +1,4 @@
+import type { Gen } from '@ryanatkn/gro/gen.js';
+/** @nodocs */
+export declare const gen: Gen;
+//# sourceMappingURL=blog.gen.d.ts.map

package/dist/blog.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/blog.gen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,sBAAsB,CAAC;AAY9C,cAAc;AACd,eAAO,MAAM,GAAG,EAAE,GAkEjB,CAAC"}

package/dist/blog.gen.js

@@ -0,0 +1,78 @@
+import { join } from 'node:path';
+import { load_package_json } from '@ryanatkn/gro/package_json.js';
+import { create_atom_feed } from './feed.js';
+import { collect_blog_post_ids, load_blog_post_modules, resolve_blog_post_item, } from './blog_helpers.js';
+/** @nodocs */
+export const gen = async ({ origin_path }) => {
+    // TODO @many parameterize and refactor
+    const package_json = await load_package_json();
+    const fuz_blog_import_path = package_json.name === '@fuzdev/fuz_blog' ? '$lib' : '@fuzdev/fuz_blog';
+    const dir = process.cwd();
+    const blog_dirname = 'blog';
+    const routes_path = 'src/routes'; // TODO read from SvelteKit config;
+    const blog_dir = join(dir, routes_path, blog_dirname);
+    const { blog } = (await import(join(blog_dir, 'blog.ts'))); // TODO zod parse
+    const blog_post_ids = collect_blog_post_ids(blog_dir);
+    const modules = await load_blog_post_modules(blog_dir, blog_post_ids);
+    // TODO zod schema validation including parsing the status context url (with zod?)
+    // for (const mod of modules) {
+    // 	validate_blog_post(mod.post)
+    // }
+    const blog_url = blog.id + blog_dirname;
+    const items = modules.map((mod, i) => resolve_blog_post_item(i + 1, blog_url, mod.post));
+    const feed = { ...blog, items };
+    return [
+        {
+            // TODO @many harcoded /blog/
+            filename: join(dir, 'static/blog/feed.xml'),
+            content: create_atom_feed(feed),
+        },
+        {
+            filename: join(blog_dir, 'feed.ts'),
+            content: `
+				// generated by ${origin_path}
+
+				import type {BlogFeed} from '${fuz_blog_import_path}/blog.js';
+
+				export const feed: BlogFeed = ${JSON.stringify(feed)}
+
+				// generated by ${origin_path}
+			`,
+        },
+        ...modules.map((item, i) => {
+            const post = item.post;
+            const slug = post.slug;
+            const blog_post_id = i + 1;
+            return {
+                filename: join(blog_dir, slug, '+page.svelte'),
+                content: `
+						<!-- generated by ${origin_path} -->
+
+						<script lang="ts">
+							import Blog_Post_${blog_post_id} from '../${blog_post_id}/+page.svelte';
+						</script>
+
+						<Blog_Post_${blog_post_id} />
+
+						<!-- generated by ${origin_path} -->
+					`,
+            };
+        }),
+    ];
+};
+// const to_prerender_entries = (blog: Feed): string[] => {
+// 	const entries = [];
+// 	for (let index = 0; index < blog.items.length; index++) {
+// 		const item = blog.items[index];
+// 		const {pathname} = new URL(item.url);
+// 		entries.push(pathname);
+// 		// replace the last segment with the index
+// 		for (let i = pathname.length - 1; i >= 0; i--) {
+// 			if (pathname[i] === '/') {
+// 				entries.push(pathname.substring(0, i + 1) + (1 + index));
+// 				break;
+// 			}
+// 		}
+// 	}
+// 	return entries;
+// };

package/dist/blog.js

@@ -0,0 +1,2 @@
+import { create_context } from '@fuzdev/fuz_ui/context_helpers.js';
+export const blog_feed_context = create_context();

package/dist/blog_helpers.d.ts

@@ -0,0 +1,11 @@
+import type { BlogPostId, BlogPostData, BlogPostItem, BlogPostModule } from './blog.js';
+export declare const resolve_blog_post_item: (blog_post_id: BlogPostId, blog_url: string, post: BlogPostData) => BlogPostItem;
+/**
+ * Returns an array of all of the sequential blog post ids starting with 1.
+ * When it fails to find the next id, the sequence ends.
+ */
+export declare const collect_blog_post_ids: (blog_dir: string) => Array<BlogPostId>;
+export declare const load_blog_post_modules: (blog_dir: string, blog_post_ids: Array<BlogPostId>) => Promise<Array<BlogPostModule>>;
+export declare const to_next_blog_post_id: (blog_post_ids: Array<BlogPostId>) => BlogPostId;
+export declare const to_blog_post_path: (blog_dir: string, blog_post_id: BlogPostId) => string;
+//# sourceMappingURL=blog_helpers.d.ts.map

package/dist/blog_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/blog_helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAItF,eAAO,MAAM,sBAAsB,GAClC,cAAc,UAAU,EACxB,UAAU,MAAM,EAChB,MAAM,YAAY,KAChB,YAcF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,KAAK,CAAC,UAAU,CAaxE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAClC,UAAU,MAAM,EAChB,eAAe,KAAK,CAAC,UAAU,CAAC,KAC9B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CACkE,CAAC;AAEnG,eAAO,MAAM,oBAAoB,GAAI,eAAe,KAAK,CAAC,UAAU,CAAC,KAAG,UAGvE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,cAAc,UAAU,KAAG,MAChC,CAAC"}

package/dist/blog_helpers.js

@@ -0,0 +1,41 @@
+import { strip_end } from '@fuzdev/fuz_util/string.js';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+// TODO maybe move non-node stuff to `blog`, maybe rename this to `blog_fs_helpers`?
+export const resolve_blog_post_item = (blog_post_id, blog_url, post) => {
+    const final_blog_url = strip_end(blog_url, '/');
+    return {
+        id: final_blog_url + '/' + blog_post_id,
+        url: final_blog_url + '/' + post.slug,
+        blog_post_id,
+        title: post.title,
+        slug: post.slug,
+        date_published: post.date_published,
+        date_modified: post.date_modified,
+        summary: post.summary,
+        tags: post.tags ?? [],
+        comments: post.comments,
+    };
+};
+/**
+ * Returns an array of all of the sequential blog post ids starting with 1.
+ * When it fails to find the next id, the sequence ends.
+ */
+export const collect_blog_post_ids = (blog_dir) => {
+    const blog_post_ids = [];
+    let blog_post_id = 1;
+    while (true) {
+        if (!existsSync(to_blog_post_path(blog_dir, blog_post_id))) {
+            break;
+        }
+        blog_post_ids.push(blog_post_id);
+        blog_post_id++;
+    }
+    return blog_post_ids;
+};
+export const load_blog_post_modules = (blog_dir, blog_post_ids) => Promise.all(blog_post_ids.map((item) => import(join(blog_dir, item.toString(), '+page.svelte'))));
+export const to_next_blog_post_id = (blog_post_ids) => {
+    const last = blog_post_ids.at(-1);
+    return last === undefined ? 1 : last + 1;
+};
+export const to_blog_post_path = (blog_dir, blog_post_id) => join(blog_dir, blog_post_id + '/+page.svelte');

package/dist/feed.d.ts

@@ -0,0 +1,34 @@
+/**
+ * This is designed to extend JSON Feed 1.1 with namespaced data for other specs like Atom.
+ * It's still a work in progress, and I'll add features as I need them,
+ * and eventually this will be extracted to a standalone library.
+ * https://www.jsonfeed.org/version/1.1/
+ */
+export interface Feed {
+    id: string;
+    title: string;
+    home_page_url: string;
+    description: string;
+    icon: string;
+    favicon: string;
+    author: {
+        name: string;
+        url?: string;
+        email?: string;
+    };
+    items: Array<FeedItem>;
+    atom: {
+        feed_url: string;
+    };
+}
+export interface FeedItem {
+    id: string;
+    title: string;
+    url: string;
+    date_published: string;
+    date_modified: string;
+    summary: string;
+    tags?: Array<string>;
+}
+export declare const create_atom_feed: (data: Feed) => string;
+//# sourceMappingURL=feed.d.ts.map

package/dist/feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feed.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/feed.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,IAAI,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CAUF;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAMhB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MA8C7C,CAAC"}

package/dist/feed.js

@@ -0,0 +1,43 @@
+// TODO publish `feed.json` not just the Atom `feed.xml`
+export const create_atom_feed = (data) => {
+    const items = data.items
+        .slice()
+        .sort((a, b) => (new Date(a.date_published) > new Date(b.date_published) ? -1 : 1)); // TODO maybe add an option to customize this? maybe by `date_modified`?
+    const updated = items
+        .reduce((latest, item) => {
+        const modified = new Date(item.date_modified || item.date_published);
+        return modified > latest ? modified : latest;
+    }, new Date(0))
+        .toISOString();
+    return `<?xml version="1.0" encoding="UTF-8" ?>
+
+<feed xmlns="http://www.w3.org/2005/Atom">
+
+  <id>${data.id}</id>
+  <title>${data.title}</title>
+  <subtitle>${data.description}</subtitle>
+  <link href="${data.home_page_url}" />
+  <link href="${data.atom.feed_url}" rel="self" type="application/atom+xml" />
+	<updated>${updated}</updated>
+  <icon>${data.icon}</icon>
+  <author>
+    <name>${data.author.name}</name>
+    ${data.author.email ? `<email>${data.author.email}</email>` : ''}
+    ${data.author.url ? `<uri>${data.author.url}</uri>` : ''}
+  </author>
+  ${items
+        .map((item) => `
+  <entry>
+    <id>${item.id}</id>
+    <title>${item.title}</title>
+    <link rel="alternate" href="${item.url}" />
+    <published>${item.date_published}</published>
+    <updated>${item.date_modified}</updated>
+    <summary>${item.summary}</summary>
+    ${item.tags ? item.tags.map((tag) => `<category term="${tag}" />`).join('') : ''}
+  </entry>`)
+        .join('\n')}
+
+</feed>
+`;
+};

package/dist/post.task.d.ts

@@ -0,0 +1,11 @@
+import { type Task } from '@ryanatkn/gro';
+import { z } from 'zod';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    date: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=post.task.d.ts.map

package/dist/post.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/post.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,eAAe,CAAC;AACnD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAStB,cAAc;AACd,eAAO,MAAM,IAAI;;;kBAKP,CAAC;AACX,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAkE3B,CAAC"}

package/dist/post.task.js

@@ -0,0 +1,68 @@
+import { TaskError } from '@ryanatkn/gro';
+import { z } from 'zod';
+import { format_file } from '@ryanatkn/gro/format_file.js';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { load_package_json } from '@ryanatkn/gro/package_json.js';
+import { slugify } from '@fuzdev/fuz_util/path.js';
+import { collect_blog_post_ids, to_next_blog_post_id } from './blog_helpers.js';
+/** @nodocs */
+export const Args = z
+    .object({
+    _: z.array(z.string()).meta({ description: 'post title' }).max(1).default([]),
+    date: z.string().meta({ description: "the post's date_published" }).optional(),
+})
+    .strict();
+/** @nodocs */
+export const task = {
+    summary: 'create a new blog post',
+    Args,
+    run: async ({ args, log, invoke_task }) => {
+        const { _: [raw_title], date = new Date().toISOString(), } = args;
+        if (!raw_title) {
+            throw new TaskError('post title is required, e.g. `gro post "Hello world"`');
+        }
+        const title = raw_title.trim();
+        const slug = slugify(title);
+        // TODO @many parameterize and refactor
+        const package_json = await load_package_json();
+        const fuz_blog_import_path = package_json.name === '@fuzdev/fuz_blog' ? '$lib' : '@fuzdev/fuz_blog';
+        const dir = process.cwd();
+        const blog_dirname = 'blog'; // TODO @many harcoded /blog/
+        const routes_path = 'src/routes'; // TODO read from SvelteKit config;
+        const blog_dir = join(dir, routes_path, blog_dirname);
+        const blog_post_ids = collect_blog_post_ids(blog_dir);
+        const next_blog_post_id = to_next_blog_post_id(blog_post_ids);
+        const next_blog_post_path = join(blog_dir, next_blog_post_id + '/+page.svelte');
+        const unformatted = `
+			<script lang="ts" module>
+				import type {BlogPostData} from '${fuz_blog_import_path}/blog.js';
+
+				export const post = {
+					title: ${JSON.stringify(title)},
+					slug: '${slug}',
+					date_published: '${date}',
+					date_modified: '${date}',
+					summary: 'todo',
+					tags: ['todo'],
+				} satisfies BlogPostData;
+			</script>
+
+			<script lang="ts">
+				import BlogPost from '${fuz_blog_import_path}/BlogPost.svelte';
+			</script>
+
+			<!-- This component is totally optional, you have full control over the page. -->
+			<BlogPost {post}>
+				<p>
+					TODO content goes here
+				</p>
+			</BlogPost>
+		`;
+        const formatted = await format_file(unformatted, { parser: 'svelte' });
+        await mkdir(dirname(next_blog_post_path), { recursive: true });
+        await writeFile(next_blog_post_path, formatted, 'utf8');
+        await invoke_task('gen');
+        log.info(`created empty blog post with index ${next_blog_post_id} at ${next_blog_post_path}`);
+    },
+};

package/dist/update_post.task.d.ts

@@ -0,0 +1,11 @@
+import { type Task } from '@ryanatkn/gro';
+import { z } from 'zod';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    date: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=update_post.task.d.ts.map

package/dist/update_post.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update_post.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/update_post.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,cAAc;AACd,eAAO,MAAM,IAAI;;;kBAMP,CAAC;AACX,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAwB3B,CAAC"}

package/dist/update_post.task.js

@@ -0,0 +1,31 @@
+import { TaskError } from '@ryanatkn/gro';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { z } from 'zod';
+/** @nodocs */
+export const Args = z
+    .object({
+    // TODO accept `slug` as well as `id` ?
+    _: z.array(z.string()).meta({ description: 'id of the post to update' }).max(1).default([]),
+    date: z.string().meta({ description: "the post's date_modified" }).optional(),
+})
+    .strict();
+/** @nodocs */
+export const task = {
+    summary: 'updates the `date_modified` of a blog post',
+    Args,
+    run: async ({ args, invoke_task }) => {
+        const { _: [id], date = new Date().toISOString(), } = args;
+        if (!id) {
+            throw new TaskError('post id is required');
+        }
+        // TODO @many harcoded /blog/
+        const filename = `src/routes/blog/${id}/+page.svelte`;
+        if (!existsSync(filename)) {
+            throw new TaskError(`post with id '${id}' not found at path '${filename}'`);
+        }
+        const content = readFileSync(filename, 'utf8');
+        const updated_content = content.replace(/date_modified: '.*'/, `date_modified: '${date}'`);
+        writeFileSync(filename, updated_content, 'utf8');
+        await invoke_task('gen');
+    },
+};

package/dist/util.d.ts

@@ -0,0 +1,3 @@
+export declare const format_date: (date: string | number | Date) => string;
+export declare const to_pathname: (url: string, root: string) => string;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/util.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,KAAG,MACI,CAAC;AAEhE,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,KAAG,MACjB,CAAC"}

package/dist/util.js

@@ -0,0 +1,5 @@
+import { format } from 'date-fns';
+import { strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
+// TODO rename?
+export const format_date = (date) => format(typeof date === 'string' ? new Date(date) : date, 'PP');
+export const to_pathname = (url, root) => strip_start(url, strip_end(root, '/'));

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@fuzdev/fuz_blog",
+  "version": "0.20.0",
+  "description": "blog software from scratch with SvelteKit",
+  "glyph": "🖊️",
+  "logo": "logo.svg",
+  "logo_alt": "a friendly yellow spider facing you",
+  "public": true,
+  "homepage": "https://blog.fuz.dev/",
+  "repository": "https://github.com/fuzdev/fuz_blog",
+  "scripts": {
+    "start": "gro dev",
+    "dev": "gro dev",
+    "build": "gro build",
+    "check": "gro check",
+    "test": "gro test",
+    "preview": "vite preview",
+    "deploy": "gro deploy"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.15"
+  },
+  "peerDependencies": {
+    "@fuzdev/fuz_css": ">=0.40.0",
+    "@fuzdev/fuz_mastodon": ">=0.37.0",
+    "@fuzdev/fuz_ui": ">=0.169.0",
+    "@fuzdev/fuz_util": ">=0.42.0",
+    "@ryanatkn/gro": ">=0.181.0",
+    "@sveltejs/kit": "^2",
+    "date-fns": "^4",
+    "svelte": "^5"
+  },
+  "devDependencies": {
+    "@changesets/changelog-git": "^0.2.1",
+    "@fuzdev/fuz_code": "^0.37.0",
+    "@fuzdev/fuz_css": "^0.40.0",
+    "@fuzdev/fuz_mastodon": "^0.37.0",
+    "@fuzdev/fuz_ui": "^0.169.0",
+    "@fuzdev/fuz_util": "^0.42.0",
+    "@ryanatkn/belt": "^0.41.1",
+    "@ryanatkn/eslint-config": "^0.9.0",
+    "@ryanatkn/gro": "^0.181.0",
+    "@sveltejs/adapter-static": "^3.0.10",
+    "@sveltejs/kit": "^2.49.0",
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^6.2.1",
+    "@types/node": "^24.10.1",
+    "date-fns": "^4.1.0",
+    "eslint": "^9.39.1",
+    "eslint-plugin-svelte": "^3.13.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-svelte": "^3.4.0",
+    "svelte": "^5.45.2",
+    "svelte-check": "^4.3.4",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.0",
+    "vitest": "^4.0.14"
+  },
+  "prettier": {
+    "plugins": [
+      "prettier-plugin-svelte"
+    ],
+    "useTabs": true,
+    "printWidth": 100,
+    "singleQuote": true,
+    "bracketSpacing": false,
+    "overrides": [
+      {
+        "files": "package.json",
+        "options": {
+          "useTabs": false
+        }
+      }
+    ]
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    "./*.js": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./*.ts": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./*.svelte": {
+      "types": "./dist/*.svelte.d.ts",
+      "svelte": "./dist/*.svelte",
+      "default": "./dist/*.svelte"
+    }
+  }
+}