@jant/core 0.3.37 → 0.3.39

package/src/types/operations.ts

@@ -6,10 +6,33 @@ import type {
   Format,
   Status,
   Visibility,
-  SortOrder,
-  NavItemType,
+  CollectionSortOrder,
+  SystemNavKey,
+  TextAttachmentContentFormat,
 } from "./constants.js";
 
+export type PostAttachmentInput =
+  | {
+      type: "media";
+      mediaId: string;
+      alt?: string;
+    }
+  | {
+      type: "text";
+      contentFormat: TextAttachmentContentFormat;
+      content: string;
+      summary?: string;
+    };
+
+export interface TextAttachmentContent {
+  id: string;
+  type: "text";
+  contentFormat: TextAttachmentContentFormat;
+  content: string;
+  summary: string | null;
+  chars: number | null;
+}
+
 export interface CreatePost {
   format: Format;
   status?: Status;
@@ -27,7 +50,7 @@ export interface CreatePost {
   collectionIds?: string[];
   replyToId?: string;
   publishedAt?: number;
-  mediaIds?: string[];
+  attachments?: PostAttachmentInput[];
 }
 
 export interface UpdatePost {
@@ -45,18 +68,23 @@ export interface UpdatePost {
   rating?: number | null;
   collectionIds?: string[];
   publishedAt?: number;
-  mediaIds?: string[];
+  attachments?: PostAttachmentInput[];
 }
 
-export interface CreateNavItem {
-  type: NavItemType;
-  label: string;
-  url: string;
-  position?: string;
-}
+export type CreateNavItem =
+  | {
+      type: "link";
+      label: string;
+      url: string;
+      position?: string;
+    }
+  | {
+      type: "system";
+      systemKey: SystemNavKey;
+      position?: string;
+    };
 
 export interface UpdateNavItem {
-  type?: NavItemType;
   label?: string;
   url?: string;
   position?: string;
@@ -66,14 +94,16 @@ export interface CreateCollection {
   slug: string;
   title: string;
   description?: string;
-  icon?: string;
-  sortOrder?: SortOrder;
+  sortOrder?: CollectionSortOrder;
 }
 
 export interface UpdateCollection {
   slug?: string;
   title?: string;
   description?: string | null;
-  icon?: string | null;
-  sortOrder?: SortOrder;
+  sortOrder?: CollectionSortOrder;
+}
+
+export interface UpdateSidebarItem {
+  label?: string | null;
 }

package/src/types/props.ts

@@ -2,10 +2,11 @@
  * Page-Level Props & Feed Data Types
  */
 
-import type { Format, MediaKind } from "./constants.js";
-import type { Collection } from "./entities.js";
+import type { CollectionSortOrder, Format, MediaKind } from "./constants.js";
+import type { Collection, CollectionDirectoryItem } from "./entities.js";
 import type {
   PostView,
+  FeedPostView,
   TimelineItemView,
   SearchResultView,
   ArchiveGroup,
@@ -20,6 +21,7 @@ export interface HomePageProps {
   items: TimelineItemView[];
   currentPage: number;
   totalPages: number;
+  baseUrl: string;
 }
 
 /** Props for the single post page component */
@@ -31,10 +33,17 @@ export interface PostPageProps {
 /** Props for the featured page component */
 export interface FeaturedPageProps {
   items: TimelineItemView[];
+  currentPage: number;
+  totalPages: number;
+  baseUrl: string;
 }
 
 /** Visibility filter values for the archive page (includes "featured" as a virtual value). */
-export type ArchiveVisibility = "public" | "unlisted" | "private" | "featured";
+export type ArchiveVisibility =
+  | "public"
+  | "latest_hidden"
+  | "private"
+  | "featured";
 
 /** View mode for the archive page. */
 export type ArchiveView = "grid" | "list";
@@ -44,7 +53,6 @@ export interface ArchiveFilters {
   year?: number;
   collectionSlug?: string;
   collectionTitle?: string;
-  collectionIcon?: string | null;
   format?: Format;
   mediaKinds?: MediaKind[];
   hasMedia?: boolean;
@@ -56,12 +64,15 @@ export interface ArchiveFilters {
 /** Props for the archive page component */
 export interface ArchivePageProps {
   groups: ArchiveGroup[];
+  totalCount: number;
   currentPage: number;
   totalPages: number;
   filters: ArchiveFilters;
   availableYears: number[];
-  availableCollections: { slug: string; title: string; icon: string | null }[];
+  availableCollections: { slug: string; title: string }[];
   isAuthenticated: boolean;
+  sitePathPrefix?: string;
+  timeZone?: string;
 }
 
 /** Props for the search page component */
@@ -71,19 +82,37 @@ export interface SearchPageProps {
   error?: string;
   hasMore: boolean;
   page: number;
+  sitePathPrefix?: string;
 }
 
 /** Props for the single collection page component */
 export interface CollectionPageProps {
   collection: Collection;
   items: TimelineItemView[];
-  hasMore: boolean;
-  nextCursor?: string;
+  totalThreadCount: number;
+  currentPage: number;
+  totalPages: number;
+  baseUrl: string;
+  currentSort: CollectionSortOrder;
+  defaultSort: CollectionSortOrder;
+  showRatingSort: boolean;
+  isAuthenticated: boolean;
+  sitePathPrefix?: string;
+}
+
+/** Props for the collection editor page component */
+export interface CollectionEditorPageProps {
+  mode: "create" | "edit";
+  collection?: Collection;
+  cancelHref: string;
+  sitePathPrefix?: string;
 }
 
 /** Props for the collections list page component */
 export interface CollectionsPageProps {
-  collections: (Collection & { postCount: number })[];
+  items: CollectionDirectoryItem[];
+  isAuthenticated: boolean;
+  sitePathPrefix?: string;
 }
 
 // =============================================================================
@@ -96,12 +125,16 @@ export interface FeedData {
   siteDescription: string;
   siteUrl: string;
   siteLanguage: string;
-  posts: PostView[];
+  /** Optional feed-specific title shown in RSS/Atom readers. */
+  title?: string;
+  selfUrl: string;
+  posts: FeedPostView[];
 }
 
 /** Data passed to sitemap renderers */
 export interface SitemapData {
   siteUrl: string;
+  sitemapUrl: string;
   posts: PostView[];
 }
 
@@ -119,6 +152,9 @@ export type CardMode = "compact" | "feed" | "detail";
 
 export interface PostFooterDisplayOptions {
   hideActions?: boolean;
+  hideReply?: boolean;
+  hideTimestamp?: boolean;
+  hideThreadLink?: boolean;
 }
 
 export interface TimelineCardDisplayOptions {
@@ -145,6 +181,7 @@ export interface ThreadPreviewProps {
 /** Props for the timeline feed wrapper */
 export interface TimelineFeedProps {
   items: TimelineItemView[];
+  baseUrl: string;
   currentPage?: number;
   totalPages?: number;
 }

package/src/types/views.ts

@@ -2,7 +2,13 @@
  * View Model Types (render-ready, for theme components)
  */
 
-import type { Format, Status, Visibility, NavItemType } from "./constants.js";
+import type {
+  Format,
+  Status,
+  Visibility,
+  NavItemType,
+  SystemNavKey,
+} from "./constants.js";
 import type { Post, Collection } from "./entities.js";
 
 /**
@@ -12,8 +18,8 @@ import type { Post, Collection } from "./entities.js";
 export interface CollectionTagView {
   slug: string;
   title: string;
-  /** Pre-rendered icon HTML (SVG or emoji span) */
-  iconHtml?: string;
+  /** Public collection URL, including any configured site path prefix. */
+  url: string;
 }
 
 /**
@@ -22,7 +28,7 @@ export interface CollectionTagView {
  */
 export interface PostView {
   // Identity
-  /** UUIDv7 identifier */
+  /** TypeID identifier */
   id: string;
   /** Pre-computed permalink: "/{slug}" */
   permalink: string;
@@ -33,6 +39,8 @@ export interface PostView {
   title?: string;
   /** Pre-sanitized HTML */
   bodyHtml?: string;
+  /** Unified plain-text preview summary for cards, lists, and meta fallbacks */
+  summary?: string;
   /** Pre-computed excerpt, max 160 chars */
   excerpt?: string;
   /** HTML excerpt for article previews (paragraph-aware, ~500 chars) */
@@ -50,6 +58,12 @@ export interface PostView {
   visibility: Visibility;
   pinned: boolean;
   featured: boolean;
+  /** ISO 8601 string for when the post was added to Featured. */
+  featuredAt?: string;
+  /** Human-readable featured date, e.g. "Feb 1, 2024" */
+  featuredAtFormatted?: string;
+  /** 24-hour featured time, e.g. "23:05" */
+  featuredAtTime?: string;
   rating?: number;
 
   // Time -- pre-formatted
@@ -71,19 +85,33 @@ export interface PostView {
   collections: CollectionTagView[];
 
   // Thread context
-  /** UUIDv7 of the parent post */
+  /** TypeID of the parent post */
   replyToId?: string;
-  /** UUIDv7 of the thread root post */
+  /** TypeID of the thread root post */
   threadRootId?: string;
-  /** Permalink of the thread root post (for "in thread" link on featured replies) */
+  /** Permalink of the thread root post for the "In thread" link. */
   threadRootPermalink?: string;
   /** Whether this post is the last (most recent) in its thread. Controls reply button visibility. */
   isLastInThread: boolean;
+  /** Number of published replies in this thread when relevant to the current view. */
+  replyCount?: number;
 
   // Raw content (for forms/editing, not typical theme use)
   body?: string;
 }
 
+/**
+ * Render-ready post data for feeds.
+ * Feed timestamps can differ from on-page timestamps when a feed represents a
+ * curation event rather than original publication time.
+ */
+export interface FeedPostView extends PostView {
+  /** Optional ISO 8601 timestamp used for RSS pubDate / Atom published */
+  feedPublishedAt?: string;
+  /** Optional ISO 8601 timestamp used for Atom updated */
+  feedUpdatedAt?: string;
+}
+
 /**
  * Render-ready media data for theme components.
  * URLs are pre-computed -- no lib/ imports needed.
@@ -112,9 +140,10 @@ export interface MediaView {
  * Active/external state pre-computed.
  */
 export interface NavItemView {
-  /** UUIDv7 identifier */
+  /** TypeID identifier */
   id: string;
   type: NavItemType;
+  systemKey?: SystemNavKey;
   label: string;
   url: string;
   /** Pre-computed based on currentPath */
@@ -158,6 +187,14 @@ export interface TimelineItemView {
     parentReply?: PostView;
     totalReplyCount: number;
   };
+  curatedThread?: {
+    rootPost: PostView;
+    segments: {
+      post: PostView;
+      hiddenBeforeCount: number;
+      highlighted: boolean;
+    }[];
+  };
 }
 
 /**
@@ -170,7 +207,10 @@ export interface ArchiveGroup {
   month: string;
   /** Pre-formatted, e.g. "February 2024" */
   label: string;
+  /** Total thread roots in this month across the full filtered result set */
+  totalCount?: number;
   posts: PostView[];
+  items?: TimelineItemView[];
 }
 
 /**
@@ -180,6 +220,7 @@ export interface SiteLayoutProps {
   siteName: string;
   links: NavItemView[];
   currentPath: string;
+  sitePathPrefix?: string;
   isAuthenticated?: boolean;
   collections?: Collection[];
   homeDefaultView?: string;
@@ -187,8 +228,10 @@ export interface SiteLayoutProps {
   siteAvatarUrl?: string;
   showHeaderAvatar?: boolean;
   siteFooterHtml?: string;
+  showHomeBranding?: boolean;
   sidebar?: import("hono/jsx").Child;
   uploadMaxFileSize?: number;
   showComposeDialog?: boolean;
   showHeader?: boolean;
+  composeOpenShortcutDiscovered?: boolean;
 }

package/src/ui/__tests__/color-themes.test.ts

@@ -0,0 +1,81 @@
+import { describe, expect, it } from "vitest";
+import {
+  BUILTIN_COLOR_THEMES,
+  COLOR_THEME_GROUPS,
+  getGroupedColorThemes,
+} from "../color-themes.js";
+
+describe("BUILTIN_COLOR_THEMES", () => {
+  it("contains 12 themes", () => {
+    expect(BUILTIN_COLOR_THEMES).toHaveLength(12);
+  });
+
+  it("keeps Linen as the first theme", () => {
+    expect(BUILTIN_COLOR_THEMES[0]?.id).toBe("linen");
+  });
+
+  it("includes the new theme IDs", () => {
+    const ids = BUILTIN_COLOR_THEMES.map((theme) => theme.id);
+
+    expect(ids).toContain("parchment");
+    expect(ids).toContain("slate");
+    expect(ids).toContain("nocturne");
+  });
+
+  it("has no duplicate IDs", () => {
+    const ids = BUILTIN_COLOR_THEMES.map((theme) => theme.id);
+    expect(new Set(ids).size).toBe(ids.length);
+  });
+
+  it("keeps the intended group structure", () => {
+    expect(COLOR_THEME_GROUPS.map((group) => group.id)).toEqual([
+      "warm-editorial",
+      "quiet-neutral",
+      "distinctive-mood",
+    ]);
+
+    expect(COLOR_THEME_GROUPS.map((group) => group.themeIds)).toEqual([
+      ["linen", "dune", "clay", "parchment"],
+      ["ink", "stone", "mist", "slate"],
+      ["ember", "moss", "iris", "nocturne"],
+    ]);
+  });
+
+  it("assigns every built-in theme to exactly one group", () => {
+    const groupedIds = getGroupedColorThemes()
+      .flatMap((group) => group.themes)
+      .map((theme) => theme.id);
+
+    expect(groupedIds).toEqual(BUILTIN_COLOR_THEMES.map((theme) => theme.id));
+    expect(new Set(groupedIds).size).toBe(BUILTIN_COLOR_THEMES.length);
+  });
+
+  it("defines the required core tokens for each mode", () => {
+    const requiredTokens = [
+      "--background",
+      "--foreground",
+      "--primary",
+      "--primary-foreground",
+      "--site-accent",
+      "--muted",
+      "--muted-foreground",
+      "--border",
+    ] as const;
+
+    for (const theme of BUILTIN_COLOR_THEMES) {
+      for (const token of requiredTokens) {
+        expect(theme.light[token]).toBeTruthy();
+        expect(theme.dark[token]).toBeTruthy();
+      }
+    }
+  });
+
+  it("keeps Linen aligned with the default brand palette", () => {
+    const linen = BUILTIN_COLOR_THEMES.find((theme) => theme.id === "linen");
+
+    expect(linen?.light["--primary"]).toBe("oklch(0.3633 0.0697 159.95)");
+    expect(linen?.light["--site-accent"]).toBe("oklch(0.4406 0.0568 159.95)");
+    expect(linen?.dark["--primary"]).toBe("oklch(0.6966 0.0528 159.95)");
+    expect(linen?.dark["--site-accent"]).toBe("oklch(0.7306 0.0478 159.95)");
+  });
+});

package/src/ui/__tests__/font-themes.test.ts

@@ -1,9 +1,14 @@
 import { describe, it, expect } from "vitest";
-import { BUILTIN_FONT_THEMES } from "../font-themes.js";
+import {
+  BUILTIN_FONT_THEMES,
+  DEFAULT_FONT_CJK_SERIF_FALLBACK,
+  getCjkSerifCssVariables,
+  getFontThemeCssVariables,
+} from "../font-themes.js";
 
 describe("BUILTIN_FONT_THEMES", () => {
-  it("contains 5 themes", () => {
-    expect(BUILTIN_FONT_THEMES).toHaveLength(5);
+  it("contains 6 themes", () => {
+    expect(BUILTIN_FONT_THEMES).toHaveLength(6);
   });
 
   it("has 'default' as the first theme", () => {
@@ -16,6 +21,7 @@ describe("BUILTIN_FONT_THEMES", () => {
       expect(theme.name.message).toBeTruthy();
       expect(theme.headingFontFamily).toBeTruthy();
       expect(theme.bodyFontFamily).toBeTruthy();
+      expect(theme.cssVariables).toBeTruthy();
       expect(theme.description.message).toBeTruthy();
     }
   });
@@ -28,21 +34,27 @@ describe("BUILTIN_FONT_THEMES", () => {
   it("includes expected theme IDs", () => {
     const ids = BUILTIN_FONT_THEMES.map((t) => t.id);
     expect(ids).toContain("default");
-    expect(ids).toContain("classic-editorial");
+    expect(ids).toContain("system-sans");
+    expect(ids).toContain("humanist-sans");
     expect(ids).toContain("modern-editorial");
     expect(ids).toContain("literary");
     expect(ids).toContain("geometric");
   });
 
-  it("default theme uses the same font for heading and body", () => {
+  it("default theme uses serif heading and sans body", () => {
     const defaultTheme = BUILTIN_FONT_THEMES.find(
       (t) => t.id === "default",
     ) as (typeof BUILTIN_FONT_THEMES)[number];
-    expect(defaultTheme.headingFontFamily).toBe(defaultTheme.bodyFontFamily);
+    expect(defaultTheme.name.message).toBe("Classic");
+    expect(defaultTheme.headingFontFamily).not.toBe(
+      defaultTheme.bodyFontFamily,
+    );
+    expect(defaultTheme.headingFontFamily).toContain("Charter");
+    expect(defaultTheme.bodyFontFamily).toContain("ui-sans-serif");
   });
 
   it("pairing themes have distinct heading and body fonts", () => {
-    const pairingIds = ["classic-editorial", "modern-editorial", "literary"];
+    const pairingIds = ["default", "modern-editorial"];
     for (const id of pairingIds) {
       const theme = BUILTIN_FONT_THEMES.find(
         (t) => t.id === id,
@@ -50,4 +62,61 @@ describe("BUILTIN_FONT_THEMES", () => {
       expect(theme.headingFontFamily).not.toBe(theme.bodyFontFamily);
     }
   });
+
+  it("system sans uses the same font for heading and body", () => {
+    const theme = BUILTIN_FONT_THEMES.find(
+      (item) => item.id === "system-sans",
+    ) as (typeof BUILTIN_FONT_THEMES)[number];
+    expect(theme.headingFontFamily).toBe(theme.bodyFontFamily);
+  });
+
+  it("humanist sans uses Source Sans 3 for both heading and body", () => {
+    const theme = BUILTIN_FONT_THEMES.find(
+      (item) => item.id === "humanist-sans",
+    ) as (typeof BUILTIN_FONT_THEMES)[number];
+    expect(theme.headingFontFamily).toBe(theme.bodyFontFamily);
+    expect(theme.bodyFontFamily).toContain("Source Sans 3 Variable");
+  });
+
+  it("exposes font theme css variables for injection", () => {
+    const theme = BUILTIN_FONT_THEMES.find(
+      (item) => item.id === "geometric",
+    ) as (typeof BUILTIN_FONT_THEMES)[number];
+    const variables = getFontThemeCssVariables(theme);
+
+    expect(variables["--font-body"]).toBe(theme.bodyFontFamily);
+    expect(variables["--font-heading"]).toBe(theme.headingFontFamily);
+    expect(variables["--type-display-tracking"]).toBe("-0.06em");
+  });
+
+  it("routes zh-Hans sites to the simplified CJK serif fallback first", () => {
+    const variables = getCjkSerifCssVariables("zh-Hans");
+    const stack = variables["--font-cjk-serif-fallback"];
+
+    expect(stack).toContain('"Songti SC"');
+    expect(stack).toContain('"Noto Serif SC"');
+    expect(stack.indexOf('"Songti SC"')).toBeLessThan(
+      stack.indexOf('"Noto Serif SC"'),
+    );
+  });
+
+  it("routes zh-Hant sites to the traditional CJK serif fallback first", () => {
+    const variables = getCjkSerifCssVariables("zh-Hant");
+    const stack = variables["--font-cjk-serif-fallback"];
+
+    expect(stack).toContain('"Songti TC"');
+    expect(stack).toContain('"Noto Serif TC"');
+    expect(stack.indexOf('"Songti TC"')).toBeLessThan(
+      stack.indexOf('"Noto Serif TC"'),
+    );
+  });
+
+  it("does not inject a runtime override for non-Chinese sites", () => {
+    expect(getCjkSerifCssVariables("en")).toEqual({});
+  });
+
+  it("keeps a default CJK serif fallback for the base tokens", () => {
+    expect(DEFAULT_FONT_CJK_SERIF_FALLBACK).toContain('"Songti SC"');
+    expect(DEFAULT_FONT_CJK_SERIF_FALLBACK).toContain('"Noto Serif SC"');
+  });
 });