@jant/core 0.3.21 → 0.3.23

package/src/types.ts

@@ -291,6 +291,121 @@ export interface UpdateNavigationLink {
   position?: number;
 }
 
+// =============================================================================
+// View Model Types (render-ready, for theme components)
+// =============================================================================
+
+/**
+ * Render-ready post data for theme components.
+ * All fields are pre-computed — no lib/ imports needed.
+ */
+export interface PostView {
+  // Identity
+  id: number;
+  /** Pre-computed permalink, e.g. "/p/jR3k" */
+  permalink: string;
+
+  // Content
+  title?: string;
+  /** Pre-sanitized HTML */
+  contentHtml?: string;
+  /** Pre-computed excerpt, max 160 chars */
+  excerpt?: string;
+
+  // Metadata
+  type: PostType;
+  visibility: Visibility;
+  /** Custom path for pages, e.g. "/about" */
+  path?: string;
+
+  // Time — pre-formatted
+  /** ISO 8601 string */
+  publishedAt: string;
+  /** Human-readable, e.g. "Feb 1, 2024" */
+  publishedAtFormatted: string;
+  /** ISO 8601 string */
+  updatedAt: string;
+
+  // Source (for link/quote types)
+  sourceUrl?: string;
+  sourceName?: string;
+  sourceDomain?: string;
+
+  // Media — URLs pre-computed
+  media: MediaView[];
+
+  // Thread context
+  replyToId?: number;
+  threadRootId?: number;
+
+  // Raw content (for forms/editing, not typical theme use)
+  content?: string;
+}
+
+/**
+ * Render-ready media data for theme components.
+ * URLs are pre-computed — no lib/ imports needed.
+ */
+export interface MediaView {
+  id: string;
+  /** Full-size URL, pre-computed */
+  url: string;
+  /** Thumbnail URL, pre-computed */
+  thumbnailUrl: string;
+  mimeType: string;
+  altText?: string;
+  width?: number;
+  height?: number;
+  size?: number;
+}
+
+/**
+ * Render-ready navigation link for theme components.
+ * Active/external state pre-computed.
+ */
+export interface NavLinkView {
+  id: number;
+  label: string;
+  url: string;
+  /** Pre-computed based on currentPath */
+  isActive: boolean;
+  /** Pre-computed: starts with http(s):// */
+  isExternal: boolean;
+}
+
+/**
+ * Render-ready search result for theme components.
+ */
+export interface SearchResultView {
+  post: PostView;
+  rank: number;
+  snippet?: string;
+}
+
+/**
+ * Render-ready timeline item for theme components.
+ */
+export interface TimelineItemView {
+  post: PostView;
+  threadPreview?: {
+    replies: PostView[];
+    totalReplyCount: number;
+  };
+}
+
+/**
+ * Typed archive group with pre-formatted label.
+ */
+export interface ArchiveGroup {
+  /** e.g. "2024" */
+  year: string;
+  /** e.g. "02" */
+  month: string;
+  /** Pre-formatted, e.g. "February 2024" */
+  label: string;
+  posts: PostView[];
+}
+
 // =============================================================================
 // Configuration Types
 // =============================================================================
@@ -299,35 +414,93 @@ import type { FC, PropsWithChildren } from "hono/jsx";
 import type { ColorTheme } from "./theme/color-themes.js";
 
 /**
- * Props for overridable theme components
+ * Search result from FTS5
  */
-export interface BaseLayoutProps extends PropsWithChildren {
-  title?: string;
-  description?: string;
+export interface SearchResult {
+  post: Post;
+  /** FTS5 rank score (lower is better) */
+  rank: number;
+  /** Highlighted snippet from content */
+  snippet?: string;
 }
 
-export interface PostCardProps {
-  post: Post;
-  showExcerpt?: boolean;
-  showDate?: boolean;
+// =============================================================================
+// Site Layout Props
+// =============================================================================
+
+export interface SiteLayoutProps {
+  siteName: string;
+  links: NavLinkView[];
+  currentPath: string;
 }
 
-export interface PostListProps {
-  posts: Post[];
-  emptyMessage?: string;
+// =============================================================================
+// Page-Level Props
+// =============================================================================
+
+/** Props for the home page component */
+export interface HomePageProps {
+  items: TimelineItemView[];
+  hasMore: boolean;
+  nextCursor?: number;
+  theme?: ThemeComponents;
 }
 
-export interface PaginationProps {
-  currentPage: number;
-  totalPages: number;
-  basePath: string;
+/** Props for the single post page component */
+export interface PostPageProps {
+  post: PostView;
+  theme?: ThemeComponents;
 }
 
-export interface EmptyStateProps {
-  title: string;
-  description?: string;
-  actionLabel?: string;
-  actionHref?: string;
+/** Props for the custom page component */
+export interface SinglePageProps {
+  page: PostView;
+  theme?: ThemeComponents;
+}
+
+/** Props for the archive page component */
+export interface ArchivePageProps {
+  groups: ArchiveGroup[];
+  hasMore: boolean;
+  nextCursor?: number;
+  type?: PostType;
+  theme?: ThemeComponents;
+}
+
+/** Props for the search page component */
+export interface SearchPageProps {
+  query: string;
+  results: SearchResultView[];
+  error?: string;
+  hasMore: boolean;
+  page: number;
+  theme?: ThemeComponents;
+}
+
+/** Props for the collection page component */
+export interface CollectionPageProps {
+  collection: Collection;
+  posts: PostView[];
+  theme?: ThemeComponents;
+}
+
+// =============================================================================
+// Feed Data Types
+// =============================================================================
+
+/** Data passed to RSS/Atom feed renderers */
+export interface FeedData {
+  siteName: string;
+  siteDescription: string;
+  siteUrl: string;
+  siteLanguage: string;
+  posts: PostView[];
+}
+
+/** Data passed to sitemap renderers */
+export interface SitemapData {
+  siteUrl: string;
+  posts: PostView[];
 }
 
 // =============================================================================
@@ -336,42 +509,42 @@ export interface EmptyStateProps {
 
 /** Props for per-type timeline cards */
 export interface TimelineCardProps {
-  post: PostWithMedia;
+  post: PostView;
   compact?: boolean;
 }
 
 /** Props for thread inline preview */
 export interface ThreadPreviewProps {
-  rootPost: PostWithMedia;
-  previewReplies: PostWithMedia[];
+  rootPost: PostView;
+  previewReplies: PostView[];
   totalReplyCount: number;
-}
-
-/** Data structure for a single timeline item */
-export interface TimelineItemData {
-  post: PostWithMedia;
-  threadPreview?: {
-    replies: PostWithMedia[];
-    totalReplyCount: number;
-  };
+  theme?: ThemeComponents;
 }
 
 /** Props for the timeline feed wrapper */
 export interface TimelineFeedProps {
-  items: TimelineItemData[];
+  items: TimelineItemView[];
   hasMore: boolean;
   nextCursor?: number;
+  theme?: ThemeComponents;
 }
 
 /**
  * Theme component overrides
  */
 export interface ThemeComponents {
-  BaseLayout?: FC<BaseLayoutProps>;
-  PostCard?: FC<PostCardProps>;
-  PostList?: FC<PostListProps>;
-  Pagination?: FC<PaginationProps>;
-  EmptyState?: FC<EmptyStateProps>;
+  // Layout
+  SiteLayout?: FC<PropsWithChildren<SiteLayoutProps>>;
+
+  // Pages
+  HomePage?: FC<HomePageProps>;
+  PostPage?: FC<PostPageProps>;
+  SinglePage?: FC<SinglePageProps>;
+  ArchivePage?: FC<ArchivePageProps>;
+  SearchPage?: FC<SearchPageProps>;
+  CollectionPage?: FC<CollectionPageProps>;
+
+  // Timeline sub-components
   NoteCard?: FC<TimelineCardProps>;
   ArticleCard?: FC<TimelineCardProps>;
   LinkCard?: FC<TimelineCardProps>;
@@ -379,6 +552,48 @@ export interface ThemeComponents {
   ImageCard?: FC<TimelineCardProps>;
   ThreadPreview?: FC<ThreadPreviewProps>;
   TimelineFeed?: FC<TimelineFeedProps>;
+
+  // Shared sub-components (re-exported real prop types from component files)
+  Pagination?: FC<PaginationComponentProps>;
+  PagePagination?: FC<PagePaginationComponentProps>;
+  EmptyState?: FC<EmptyStateComponentProps>;
+  MediaGallery?: FC<MediaGalleryComponentProps>;
+}
+
+/**
+ * Real component prop types (re-exported from component files via index.ts).
+ * These are provided here as aliases to avoid circular imports in types.ts.
+ * The canonical definitions live in the component files.
+ */
+
+/** @see Pagination component in theme/components/Pagination.tsx */
+export interface PaginationComponentProps {
+  baseUrl: string;
+  hasMore: boolean;
+  nextCursor?: number | string;
+  prevCursor?: number | string;
+  cursorParam?: string;
+}
+
+/** @see PagePagination component in theme/components/Pagination.tsx */
+export interface PagePaginationComponentProps {
+  baseUrl: string;
+  currentPage: number;
+  hasMore: boolean;
+  pageParam?: string;
+}
+
+/** @see EmptyState component in theme/components/EmptyState.tsx */
+export interface EmptyStateComponentProps {
+  message: string;
+  ctaText?: string;
+  ctaHref?: string;
+  centered?: boolean;
+}
+
+/** @see MediaGallery component in theme/components/MediaGallery.tsx */
+export interface MediaGalleryComponentProps {
+  attachments: MediaView[];
 }
 
 /**
@@ -389,6 +604,15 @@ export interface JantTheme {
   name?: string;
   /** Component overrides */
   components?: ThemeComponents;
+  /** Feed renderer overrides (RSS, Atom, Sitemap) */
+  feed?: {
+    /** Custom RSS 2.0 renderer — returns XML string */
+    rss?: (data: FeedData) => string;
+    /** Custom Atom renderer — returns XML string */
+    atom?: (data: FeedData) => string;
+    /** Custom Sitemap renderer — returns XML string */
+    sitemap?: (data: SitemapData) => string;
+  };
   /** CSS variable overrides (highest priority, always applied) */
   cssVariables?: Record<string, string>;
   /** Replace built-in color themes with a custom list */

package/dist/theme/components/timeline/ArticleCard.js

@@ -1,50 +0,0 @@
-/**
- * Article Card Component
- *
- * Prominent title + excerpt for type="article" posts.
- */ import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-import * as sqid from "../../../lib/sqid.js";
-import * as time from "../../../lib/time.js";
-export const ArticleCard = ({ post, compact })=>{
-    const permalink = `/p/${sqid.encode(post.id)}`;
-    const excerpt = post.content ? post.content.length > 160 ? post.content.slice(0, 160) + "..." : post.content : null;
-    return /*#__PURE__*/ _jsxs("article", {
-        class: `h-entry timeline-card${compact ? " timeline-card-compact" : ""}`,
-        children: [
-            post.title && /*#__PURE__*/ _jsx("h2", {
-                class: `p-name font-semibold ${compact ? "text-sm" : "text-lg"} mb-1`,
-                children: /*#__PURE__*/ _jsx("a", {
-                    href: permalink,
-                    class: "u-url hover:underline",
-                    children: post.title
-                })
-            }),
-            !compact && excerpt && /*#__PURE__*/ _jsx("p", {
-                class: "e-content text-sm text-muted-foreground line-clamp-3",
-                children: excerpt
-            }),
-            /*#__PURE__*/ _jsxs("footer", {
-                class: "mt-2 text-xs text-muted-foreground",
-                children: [
-                    /*#__PURE__*/ _jsx("a", {
-                        href: permalink,
-                        class: "u-url hover:underline",
-                        children: /*#__PURE__*/ _jsx("time", {
-                            class: "dt-published",
-                            datetime: time.toISOString(post.publishedAt),
-                            children: time.formatDate(post.publishedAt)
-                        })
-                    }),
-                    !compact && /*#__PURE__*/ _jsx("span", {
-                        class: "ml-2",
-                        children: /*#__PURE__*/ _jsx("a", {
-                            href: permalink,
-                            class: "hover:underline",
-                            children: "Read more →"
-                        })
-                    })
-                ]
-            })
-        ]
-    });
-};

package/dist/theme/components/timeline/ImageCard.js

@@ -1,86 +0,0 @@
-/**
- * Image Card Component
- *
- * Image-first layout for type="image" posts.
- */ import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-import { MediaGallery } from "../MediaGallery.js";
-import * as sqid from "../../../lib/sqid.js";
-import * as time from "../../../lib/time.js";
-export const ImageCard = ({ post, compact })=>{
-    const permalink = `/p/${sqid.encode(post.id)}`;
-    if (compact) {
-        return /*#__PURE__*/ _jsxs("article", {
-            class: "h-entry timeline-card timeline-card-compact",
-            children: [
-                post.title && /*#__PURE__*/ _jsx("h2", {
-                    class: "p-name text-sm font-medium mb-1",
-                    children: /*#__PURE__*/ _jsx("a", {
-                        href: permalink,
-                        class: "u-url hover:underline",
-                        children: post.title
-                    })
-                }),
-                post.contentHtml && /*#__PURE__*/ _jsx("div", {
-                    class: "e-content prose prose-sm text-muted-foreground",
-                    dangerouslySetInnerHTML: {
-                        __html: post.contentHtml
-                    }
-                }),
-                /*#__PURE__*/ _jsx("footer", {
-                    class: "mt-1 text-xs text-muted-foreground",
-                    children: /*#__PURE__*/ _jsx("a", {
-                        href: permalink,
-                        class: "u-url hover:underline",
-                        children: /*#__PURE__*/ _jsx("time", {
-                            class: "dt-published",
-                            datetime: time.toISOString(post.publishedAt),
-                            children: time.formatDate(post.publishedAt)
-                        })
-                    })
-                })
-            ]
-        });
-    }
-    return /*#__PURE__*/ _jsxs("article", {
-        class: "h-entry timeline-card timeline-card-image",
-        children: [
-            post.mediaAttachments.length > 0 && /*#__PURE__*/ _jsx("div", {
-                class: "timeline-card-image-gallery",
-                children: /*#__PURE__*/ _jsx(MediaGallery, {
-                    attachments: post.mediaAttachments
-                })
-            }),
-            /*#__PURE__*/ _jsxs("div", {
-                class: "p-4",
-                children: [
-                    post.title && /*#__PURE__*/ _jsx("h2", {
-                        class: "p-name font-medium mb-1",
-                        children: /*#__PURE__*/ _jsx("a", {
-                            href: permalink,
-                            class: "u-url hover:underline",
-                            children: post.title
-                        })
-                    }),
-                    post.contentHtml && /*#__PURE__*/ _jsx("div", {
-                        class: "e-content prose prose-sm",
-                        dangerouslySetInnerHTML: {
-                            __html: post.contentHtml
-                        }
-                    }),
-                    /*#__PURE__*/ _jsx("footer", {
-                        class: "mt-2 text-xs text-muted-foreground",
-                        children: /*#__PURE__*/ _jsx("a", {
-                            href: permalink,
-                            class: "u-url hover:underline",
-                            children: /*#__PURE__*/ _jsx("time", {
-                                class: "dt-published",
-                                datetime: time.toISOString(post.publishedAt),
-                                children: time.formatDate(post.publishedAt)
-                            })
-                        })
-                    })
-                ]
-            })
-        ]
-    });
-};

package/dist/theme/components/timeline/LinkCard.js

@@ -1,62 +0,0 @@
-/**
- * Link Card Component
- *
- * External link emphasis for type="link" posts.
- */ import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-import * as sqid from "../../../lib/sqid.js";
-import * as time from "../../../lib/time.js";
-export const LinkCard = ({ post, compact })=>{
-    const permalink = `/p/${sqid.encode(post.id)}`;
-    return /*#__PURE__*/ _jsxs("article", {
-        class: `h-entry timeline-card timeline-card-link${compact ? " timeline-card-compact" : ""}`,
-        children: [
-            post.sourceDomain && /*#__PURE__*/ _jsxs("div", {
-                class: "text-xs text-muted-foreground mb-1 flex items-center gap-1",
-                children: [
-                    /*#__PURE__*/ _jsx("svg", {
-                        class: "size-3",
-                        xmlns: "http://www.w3.org/2000/svg",
-                        fill: "none",
-                        viewBox: "0 0 24 24",
-                        "stroke-width": "2",
-                        stroke: "currentColor",
-                        children: /*#__PURE__*/ _jsx("path", {
-                            d: "M13.5 6H5.25A2.25 2.25 0 0 0 3 8.25v10.5A2.25 2.25 0 0 0 5.25 21h10.5A2.25 2.25 0 0 0 18 18.75V10.5m-10.5 6L21 3m0 0h-5.25M21 3v5.25"
-                        })
-                    }),
-                    /*#__PURE__*/ _jsx("span", {
-                        children: post.sourceDomain
-                    })
-                ]
-            }),
-            post.title && /*#__PURE__*/ _jsx("h2", {
-                class: `p-name font-semibold ${compact ? "text-sm" : "text-base"} mb-1`,
-                children: /*#__PURE__*/ _jsx("a", {
-                    href: post.sourceUrl || permalink,
-                    class: "u-url hover:underline",
-                    target: post.sourceUrl ? "_blank" : undefined,
-                    rel: post.sourceUrl ? "noopener noreferrer" : undefined,
-                    children: post.title
-                })
-            }),
-            !compact && post.contentHtml && /*#__PURE__*/ _jsx("div", {
-                class: "e-content prose prose-sm text-muted-foreground",
-                dangerouslySetInnerHTML: {
-                    __html: post.contentHtml
-                }
-            }),
-            /*#__PURE__*/ _jsx("footer", {
-                class: "mt-2 text-xs text-muted-foreground",
-                children: /*#__PURE__*/ _jsx("a", {
-                    href: permalink,
-                    class: "hover:underline",
-                    children: /*#__PURE__*/ _jsx("time", {
-                        class: "dt-published",
-                        datetime: time.toISOString(post.publishedAt),
-                        children: time.formatDate(post.publishedAt)
-                    })
-                })
-            })
-        ]
-    });
-};

package/dist/theme/components/timeline/NoteCard.js

@@ -1,37 +0,0 @@
-/**
- * Note Card Component
- *
- * Text-first, minimal card for type="note" posts.
- */ import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-import { MediaGallery } from "../MediaGallery.js";
-import * as sqid from "../../../lib/sqid.js";
-import * as time from "../../../lib/time.js";
-export const NoteCard = ({ post, compact })=>{
-    const permalink = `/p/${sqid.encode(post.id)}`;
-    return /*#__PURE__*/ _jsxs("article", {
-        class: `h-entry timeline-card${compact ? " timeline-card-compact" : ""}`,
-        children: [
-            post.contentHtml && /*#__PURE__*/ _jsx("div", {
-                class: `e-content prose ${compact ? "prose-sm" : "prose-sm"}`,
-                dangerouslySetInnerHTML: {
-                    __html: post.contentHtml
-                }
-            }),
-            !compact && post.mediaAttachments.length > 0 && /*#__PURE__*/ _jsx(MediaGallery, {
-                attachments: post.mediaAttachments
-            }),
-            /*#__PURE__*/ _jsx("footer", {
-                class: "mt-2 text-xs text-muted-foreground",
-                children: /*#__PURE__*/ _jsx("a", {
-                    href: permalink,
-                    class: "u-url hover:underline",
-                    children: /*#__PURE__*/ _jsx("time", {
-                        class: "dt-published",
-                        datetime: time.toISOString(post.publishedAt),
-                        children: time.formatDate(post.publishedAt)
-                    })
-                })
-            })
-        ]
-    });
-};

package/dist/theme/components/timeline/ThreadPreview.js

@@ -1,52 +0,0 @@
-/**
- * Thread Preview Component
- *
- * Inline thread preview: root card + compact replies + "show more" link.
- */ import { jsx as _jsx, jsxs as _jsxs } from "hono/jsx/jsx-runtime";
-import { useLingui as $_useLingui } from "@jant/core/i18n";
-import { TimelineItem } from "./TimelineItem.js";
-import * as sqid from "../../../lib/sqid.js";
-export const ThreadPreview = ({ rootPost, previewReplies, totalReplyCount })=>{
-    const { i18n: $__i18n, _: $__ } = $_useLingui();
-    const permalink = `/p/${sqid.encode(rootPost.id)}`;
-    const remainingCount = totalReplyCount - previewReplies.length;
-    return /*#__PURE__*/ _jsxs("div", {
-        class: "timeline-thread",
-        children: [
-            /*#__PURE__*/ _jsx(TimelineItem, {
-                item: {
-                    post: rootPost
-                }
-            }),
-            previewReplies.length > 0 && /*#__PURE__*/ _jsxs("div", {
-                class: "timeline-thread-replies",
-                children: [
-                    previewReplies.map((reply)=>/*#__PURE__*/ _jsx("div", {
-                            class: "timeline-thread-reply",
-                            children: /*#__PURE__*/ _jsx(TimelineItem, {
-                                item: {
-                                    post: reply
-                                },
-                                compact: true
-                            })
-                        }, reply.id)),
-                    remainingCount > 0 && /*#__PURE__*/ _jsx("div", {
-                        class: "timeline-thread-reply",
-                        children: /*#__PURE__*/ _jsx("a", {
-                            href: permalink,
-                            class: "text-sm text-muted-foreground hover:text-foreground hover:underline",
-                            children: $__i18n._({
-                                id: "smzF8S",
-                                message: "Show {remainingCount} more {0}",
-                                values: {
-                                    remainingCount: remainingCount,
-                                    0: remainingCount === 1 ? "reply" : "replies"
-                                }
-                            })
-                        })
-                    })
-                ]
-            })
-        ]
-    });
-};