@jant/core 0.3.21 → 0.3.22

package/src/i18n/locales/zh-Hant.po

@@ -14,9 +14,9 @@ msgstr ""
 "Plural-Forms: \n"
 
 #. @context: Archive post reply indicator - plural
-#: src/routes/pages/archive.tsx:180
-msgid "{count} replies"
-msgstr "{count} 條回覆"
+#: src/theme/pages/ArchivePage.tsx:168
+#~ msgid "{count} replies"
+#~ msgstr "{count} 條回覆"
 
 #. @context: Navigation link
 #: src/routes/dash/collections.tsx:282
@@ -24,9 +24,9 @@ msgid "← Back to Collections"
 msgstr "← 返回收藏夾"
 
 #. @context: Archive post reply indicator - single
-#: src/routes/pages/archive.tsx:175
-msgid "1 reply"
-msgstr "1 條回覆"
+#: src/theme/pages/ArchivePage.tsx:163
+#~ msgid "1 reply"
+#~ msgstr "1 條回覆"
 
 #. @context: Redirect type option
 #: src/routes/dash/redirects.tsx:146
@@ -49,7 +49,7 @@ msgid "Add Media"
 msgstr "添加媒體"
 
 #. @context: Archive filter - all types
-#: src/routes/pages/archive.tsx:115
+#: src/theme/pages/ArchivePage.tsx:92
 msgid "All"
 msgstr "所有"
 
@@ -59,7 +59,7 @@ msgid "Appearance"
 msgstr "外觀"
 
 #. @context: Archive page title
-#: src/routes/pages/archive.tsx:102
+#: src/theme/pages/ArchivePage.tsx:77
 msgid "Archive"
 msgstr "檔案館"
 
@@ -71,14 +71,14 @@ msgstr ""
 #. @context: Post type badge - article
 #. @context: Post type label - article
 #. @context: Post type option
-#: src/routes/pages/archive.tsx:28
 #: src/theme/components/PostForm.tsx:74
 #: src/theme/components/TypeBadge.tsx:20
+#: src/theme/pages/ArchivePage.tsx:18
 msgid "Article"
 msgstr "文章"
 
 #. @context: Post type label plural - articles
-#: src/routes/pages/archive.tsx:53
+#: src/theme/pages/ArchivePage.tsx:43
 msgid "Articles"
 msgstr "文章"
 
@@ -351,12 +351,12 @@ msgid "Featured"
 msgstr "精選"
 
 #. @context: Search results count - multiple
-#: src/routes/pages/search.tsx:89
+#: src/theme/pages/SearchPage.tsx:77
 msgid "Found {count} results"
 msgstr "找到 {count} 個結果"
 
 #. @context: Search results count - single
-#: src/routes/pages/search.tsx:85
+#: src/theme/pages/SearchPage.tsx:73
 msgid "Found 1 result"
 msgstr "找到 1 個結果"
 
@@ -375,14 +375,14 @@ msgstr "一般設定"
 #. @context: Post type badge - image
 #. @context: Post type label - image
 #. @context: Post type option
-#: src/routes/pages/archive.tsx:37
 #: src/theme/components/PostForm.tsx:83
 #: src/theme/components/TypeBadge.tsx:29
+#: src/theme/pages/ArchivePage.tsx:27
 msgid "Image"
 msgstr "圖片"
 
 #. @context: Post type label plural - images
-#: src/routes/pages/archive.tsx:65
+#: src/theme/pages/ArchivePage.tsx:55
 msgid "Images"
 msgstr "圖片"
 
@@ -409,21 +409,21 @@ msgstr "語言"
 #. @context: Post type badge - link
 #. @context: Post type label - link
 #. @context: Post type option
-#: src/routes/pages/archive.tsx:32
 #: src/theme/components/PostForm.tsx:77
 #: src/theme/components/TypeBadge.tsx:24
+#: src/theme/pages/ArchivePage.tsx:22
 msgid "Link"
 msgstr "連結"
 
 #. @context: Post type label plural - links
-#: src/routes/pages/archive.tsx:57
+#: src/theme/pages/ArchivePage.tsx:47
 msgid "Links"
 msgstr "連結"
 
 #. @context: Button to load more posts in timeline
 #. @context: Pagination button - load more items
 #: src/theme/components/Pagination.tsx:103
-#: src/theme/components/timeline/TimelineFeed.tsx:43
+#: src/theme/components/timeline/TimelineFeed.tsx:47
 msgid "Load more"
 msgstr "載入更多"
 
@@ -551,21 +551,21 @@ msgid "No pages yet."
 msgstr "尚未有頁面。"
 
 #. @context: Archive empty state
-#: src/routes/pages/archive.tsx:135
+#: src/theme/pages/ArchivePage.tsx:112
 msgid "No posts found."
 msgstr "未找到任何帖子。"
 
 #. @context: Empty state message
 #. @context: Empty state message
 #: src/routes/dash/collections.tsx:243
-#: src/routes/pages/collection.tsx:39
+#: src/theme/pages/CollectionPage.tsx:30
 msgid "No posts in this collection."
 msgstr "此集合中沒有帖子。"
 
 #. @context: Empty state message on home page
 #. @context: Empty state message when no posts exist
-#: src/routes/pages/home.tsx:42
 #: src/theme/components/PostList.tsx:25
+#: src/theme/pages/HomePage.tsx:27
 msgid "No posts yet."
 msgstr "尚未有帖子。"
 
@@ -575,21 +575,21 @@ msgid "No redirects configured."
 msgstr "未配置任何重定向。"
 
 #. @context: Search empty results
-#: src/routes/pages/search.tsx:80
+#: src/theme/pages/SearchPage.tsx:68
 msgid "No results found."
 msgstr "未找到結果。"
 
 #. @context: Post type badge - note
 #. @context: Post type label - note
 #. @context: Post type option
-#: src/routes/pages/archive.tsx:27
 #: src/theme/components/PostForm.tsx:71
 #: src/theme/components/TypeBadge.tsx:19
+#: src/theme/pages/ArchivePage.tsx:17
 msgid "Note"
 msgstr "備註"
 
 #. @context: Post type label plural - notes
-#: src/routes/pages/archive.tsx:49
+#: src/theme/pages/ArchivePage.tsx:39
 msgid "Notes"
 msgstr "筆記"
 
@@ -597,8 +597,8 @@ msgstr "筆記"
 #. @context: Post type badge - page
 #. @context: Post type label - page
 #: src/routes/dash/pages.tsx:125
-#: src/routes/pages/archive.tsx:41
 #: src/theme/components/TypeBadge.tsx:33
+#: src/theme/pages/ArchivePage.tsx:31
 msgid "Page"
 msgstr "頁面"
 
@@ -621,8 +621,8 @@ msgstr "頁面標題..."
 #. @context: Pages main heading
 #. @context: Post type label plural - pages
 #: src/routes/dash/pages.tsx:36
-#: src/routes/pages/archive.tsx:69
 #: src/theme/layouts/DashLayout.tsx:96
+#: src/theme/pages/ArchivePage.tsx:59
 msgid "Pages"
 msgstr "頁面"
 
@@ -645,8 +645,8 @@ msgstr "路徑（例如 /archive）或完整網址（例如 https://example.com
 
 #. @context: Link to individual post in thread
 #. @context: Link to permanent URL of post
-#: src/routes/pages/post.tsx:56
 #: src/theme/components/ThreadView.tsx:68
+#: src/theme/pages/PostPage.tsx:36
 msgid "Permalink"
 msgstr "永久鏈接"
 
@@ -753,14 +753,14 @@ msgstr "安靜（正常）"
 #. @context: Post type badge - quote
 #. @context: Post type label - quote
 #. @context: Post type option
-#: src/routes/pages/archive.tsx:33
 #: src/theme/components/PostForm.tsx:80
 #: src/theme/components/TypeBadge.tsx:25
+#: src/theme/pages/ArchivePage.tsx:23
 msgid "Quote"
 msgstr "引用"
 
 #. @context: Post type label plural - quotes
-#: src/routes/pages/archive.tsx:61
+#: src/theme/pages/ArchivePage.tsx:51
 msgid "Quotes"
 msgstr "引用"
 
@@ -802,13 +802,13 @@ msgstr "保存設定"
 
 #. @context: Search page title
 #. @context: Search submit button
-#: src/routes/pages/search.tsx:36
-#: src/routes/pages/search.tsx:60
+#: src/theme/pages/SearchPage.tsx:22
+#: src/theme/pages/SearchPage.tsx:48
 msgid "Search"
 msgstr "搜尋"
 
 #. @context: Search input placeholder
-#: src/routes/pages/search.tsx:52
+#: src/theme/pages/SearchPage.tsx:40
 msgid "Search posts..."
 msgstr "搜尋帖子..."
 

package/src/index.ts

@@ -10,7 +10,7 @@ import { createApp as _createApp } from "./app.js";
 export { createApp } from "./app.js";
 export type { App, AppVariables } from "./app.js";
 
-// Types (excluding component props to avoid conflicts with theme exports)
+// Types
 export type {
   PostType,
   Visibility,
@@ -29,10 +29,31 @@ export type {
   JantConfig,
   JantTheme,
   ThemeComponents,
+  // View Model types (for theme authors)
+  PostView,
+  MediaView,
+  NavLinkView,
+  SearchResultView,
+  TimelineItemView,
+  ArchiveGroup,
+  // Timeline types
   TimelineCardProps,
   ThreadPreviewProps,
-  TimelineItemData,
   TimelineFeedProps,
+  // Site layout
+  SiteLayoutProps,
+  // Page-level props (for theme authors)
+  HomePageProps,
+  PostPageProps,
+  SinglePageProps,
+  ArchivePageProps,
+  SearchPageProps,
+  CollectionPageProps,
+  // Feed types (for theme authors)
+  FeedData,
+  SitemapData,
+  // Search
+  SearchResult,
 } from "./types.js";
 
 export {
@@ -48,5 +69,33 @@ export * as sqid from "./lib/sqid.js";
 export * as url from "./lib/url.js";
 export * as markdown from "./lib/markdown.js";
 
+// View Model conversion utilities (for advanced theme use)
+export {
+  createMediaContext,
+  toPostView,
+  toPostViews,
+  toMediaView,
+  toNavLinkView,
+  toNavLinkViews,
+  toSearchResultView,
+  toArchiveGroups,
+} from "./lib/view.js";
+export type { MediaContext } from "./lib/view.js";
+
+// Render helper (for theme authors adding custom routes)
+export { renderPublicPage } from "./lib/render.js";
+export type { RenderPublicPageOptions } from "./lib/render.js";
+
+// Navigation helper (for theme authors)
+export { getNavigationData } from "./lib/navigation.js";
+export type { NavigationData } from "./lib/navigation.js";
+
+// Default feed renderers (for theme authors to extend)
+export {
+  defaultRssRenderer,
+  defaultAtomRenderer,
+  defaultSitemapRenderer,
+} from "./lib/feed.js";
+
 // Default export for running core directly (e.g., for development)
 export default _createApp();

package/src/lib/__tests__/theme-components.test.ts

@@ -1,15 +1,12 @@
 import { describe, it, expect } from "vitest";
-import {
-  resolveCardComponent,
-  resolveThreadPreview,
-  resolveTimelineFeed,
-} from "../theme-components.js";
+import { resolveCardComponent, resolveComponent } from "../theme-components.js";
 import type {
   ThemeComponents,
   TimelineCardProps,
   ThreadPreviewProps,
   TimelineFeedProps,
   PostType,
+  HomePageProps,
 } from "../../types.js";
 import type { FC } from "hono/jsx";
 
@@ -21,6 +18,7 @@ const MockQuoteCard: FC<TimelineCardProps> = () => null;
 const MockImageCard: FC<TimelineCardProps> = () => null;
 const MockThreadPreview: FC<ThreadPreviewProps> = () => null;
 const MockTimelineFeed: FC<TimelineFeedProps> = () => null;
+const MockHomePage: FC<HomePageProps> = () => null;
 
 const DEFAULT_CARD_MAP: Record<PostType, FC<TimelineCardProps>> = {
   note: MockNoteCard,
@@ -79,29 +77,50 @@ describe("theme-components", () => {
     });
   });
 
-  describe("resolveThreadPreview", () => {
+  describe("resolveComponent", () => {
     it("returns default ThreadPreview when no override", () => {
-      expect(resolveThreadPreview(MockThreadPreview)).toBe(MockThreadPreview);
+      expect(resolveComponent("ThreadPreview", MockThreadPreview)).toBe(
+        MockThreadPreview,
+      );
     });
 
-    it("returns theme override when provided", () => {
+    it("returns theme override for ThreadPreview when provided", () => {
       const Custom: FC<ThreadPreviewProps> = () => null;
       expect(
-        resolveThreadPreview(MockThreadPreview, { ThreadPreview: Custom }),
+        resolveComponent("ThreadPreview", MockThreadPreview, {
+          ThreadPreview: Custom,
+        }),
       ).toBe(Custom);
     });
-  });
 
-  describe("resolveTimelineFeed", () => {
     it("returns default TimelineFeed when no override", () => {
-      expect(resolveTimelineFeed(MockTimelineFeed)).toBe(MockTimelineFeed);
+      expect(resolveComponent("TimelineFeed", MockTimelineFeed)).toBe(
+        MockTimelineFeed,
+      );
     });
 
-    it("returns theme override when provided", () => {
+    it("returns theme override for TimelineFeed when provided", () => {
       const Custom: FC<TimelineFeedProps> = () => null;
       expect(
-        resolveTimelineFeed(MockTimelineFeed, { TimelineFeed: Custom }),
+        resolveComponent("TimelineFeed", MockTimelineFeed, {
+          TimelineFeed: Custom,
+        }),
       ).toBe(Custom);
     });
+
+    it("returns default HomePage when no override", () => {
+      expect(resolveComponent("HomePage", MockHomePage)).toBe(MockHomePage);
+    });
+
+    it("returns theme override for HomePage when provided", () => {
+      const Custom: FC<HomePageProps> = () => null;
+      expect(
+        resolveComponent("HomePage", MockHomePage, { HomePage: Custom }),
+      ).toBe(Custom);
+    });
+
+    it("returns default when theme has empty overrides", () => {
+      expect(resolveComponent("HomePage", MockHomePage, {})).toBe(MockHomePage);
+    });
   });
 });