@jant/core 0.3.36 → 0.3.38

package/src/types/bindings.ts

@@ -12,6 +12,7 @@ export interface Bindings {
   IMAGE_TRANSFORM_URL?: string;
   DEMO_EMAIL?: string;
   DEMO_PASSWORD?: string;
+  DEV_API_TOKEN?: string;
   // Timeline
   PAGE_SIZE?: string;
   // Site configuration (optional - can be overridden in DB)
@@ -28,10 +29,12 @@ export interface Bindings {
   S3_REGION?: string;
   S3_PUBLIC_URL?: string;
   // Upload
-  UPLOAD_MAX_FILE_SIZE?: string;
+  UPLOAD_MAX_FILE_SIZE_MB?: string;
   // Summary extraction
   SUMMARY_MAX_PARAGRAPHS?: string;
   SUMMARY_MAX_CHARS?: string;
+  // Slug generation
+  SLUG_ID_LENGTH?: string;
   // RSS feed
   RSS_FEED_LIMIT?: string;
 }

package/src/types/config.ts

@@ -15,7 +15,7 @@
  * - envOnly: true -> Environment-only (ENV > Default)
  */
 export const CONFIG_FIELDS = {
-  // User-configurable (can be modified in dashboard)
+  // User-configurable (can be modified in settings)
   SITE_NAME: {
     defaultValue: "Jant",
     envOnly: false,
@@ -98,7 +98,7 @@ export const CONFIG_FIELDS = {
     defaultValue: "",
     envOnly: true,
   },
-  UPLOAD_MAX_FILE_SIZE: {
+  UPLOAD_MAX_FILE_SIZE_MB: {
     defaultValue: "500",
     envOnly: true,
   },
@@ -110,8 +110,12 @@ export const CONFIG_FIELDS = {
     defaultValue: "500",
     envOnly: true,
   },
+  SLUG_ID_LENGTH: {
+    defaultValue: "5",
+    envOnly: true,
+  },
 
-  // Internal settings (DB-only, not configurable via env or dashboard)
+  // Internal settings (DB-only, not configurable via env or settings UI)
   THEME: {
     defaultValue: "",
     envOnly: false,
@@ -221,6 +225,10 @@ export interface AppConfig {
   pageSize: number;
   rssFeedLimit: number;
 
+  // Slug (ENV only)
+  /** Length of random IDs used in auto-generated slugs. Defaults to 5. */
+  slugIdLength: number;
+
   // Demo (ENV only)
   demoEmail: string;
   demoPassword: string;
@@ -238,7 +246,7 @@ export interface AppConfig {
   siteAvatarUrl: string;
   faviconVersion: string;
 
-  // Dashboard form placeholders (ENV > Default, without DB)
+  // Settings form placeholders (ENV > Default, without DB)
   fallbacks: {
     siteName: string;
     siteDescription: string;

package/src/types/constants.ts

@@ -8,7 +8,7 @@ export type Format = (typeof FORMATS)[number];
 export const STATUSES = ["draft", "published"] as const;
 export type Status = (typeof STATUSES)[number];
 
-export const VISIBILITIES = ["listed", "featured", "unlisted"] as const;
+export const VISIBILITIES = ["public", "unlisted", "private"] as const;
 export type Visibility = (typeof VISIBILITIES)[number];
 
 export const SORT_ORDERS = [
@@ -19,12 +19,12 @@ export const SORT_ORDERS = [
 ] as const;
 export type SortOrder = (typeof SORT_ORDERS)[number];
 
-export const NAV_ITEM_TYPES = ["page", "link", "system"] as const;
+export const NAV_ITEM_TYPES = ["link", "system"] as const;
 export type NavItemType = (typeof NAV_ITEM_TYPES)[number];
 
 export const SYSTEM_NAV_KEYS = {
   rss: { defaultLabel: "RSS", url: "/feed" },
-  dashboard: { defaultLabel: "Dashboard", url: "/dash" },
+  settings: { defaultLabel: "Settings", url: "/settings" },
   collections: { defaultLabel: "Collections", url: "/c" },
   archive: { defaultLabel: "Archive", url: "/archive" },
 } as const;
@@ -33,5 +33,17 @@ export type SystemNavKey = keyof typeof SYSTEM_NAV_KEYS;
 export const MAX_MEDIA_ATTACHMENTS = 20;
 export const MAX_PINNED_POSTS = 3;
 
+export const MEDIA_KINDS = [
+  "image",
+  "video",
+  "audio",
+  "text",
+  "document",
+] as const;
+export type MediaKind = (typeof MEDIA_KINDS)[number];
+
 export const STORAGE_DRIVERS = ["r2", "s3"] as const;
 export type StorageDriver = (typeof STORAGE_DRIVERS)[number];
+
+export const PATH_KINDS = ["slug", "alias", "redirect"] as const;
+export type PathKind = (typeof PATH_KINDS)[number];

package/src/types/entities.ts

@@ -8,44 +8,38 @@ import type {
   Visibility,
   SortOrder,
   NavItemType,
+  MediaKind,
+  PathKind,
 } from "./constants.js";
 
 export interface Post {
-  id: number;
+  id: string;
   format: Format;
   status: Status;
   visibility: Visibility;
-  pinned: number; // 0 | 1
-  path: string | null;
+  pinnedAt: number | null;
+  featuredAt: number | null;
+  slug: string;
   title: string | null;
   url: string | null;
   body: string | null;
   bodyHtml: string | null;
+  bodyText: string | null;
   quoteText: string | null;
   summary: string | null;
   rating: number | null;
-  replyToId: number | null;
-  threadId: number | null;
+  replyToId: string | null;
+  threadId: string;
   deletedAt: number | null;
-  publishedAt: number;
-  createdAt: number;
-  updatedAt: number;
-}
-
-export interface Page {
-  id: number;
-  slug: string;
-  title: string | null;
-  body: string | null;
-  bodyHtml: string | null;
-  status: Status;
+  publishedAt: number | null;
+  lastActivityAt: number;
   createdAt: number;
   updatedAt: number;
 }
 
 export interface Media {
   id: string; // UUIDv7
-  postId: number | null;
+  postId: string | null;
   filename: string;
   originalName: string;
   mimeType: string;
@@ -55,9 +49,15 @@ export interface Media {
   width: number | null;
   height: number | null;
   alt: string | null;
-  position: number;
+  position: string;
   blurhash: string | null;
+  waveform: string | null;
+  posterKey: string | null;
+  summary: string | null;
+  chars: number | null;
+  mediaKind: MediaKind;
   createdAt: number;
+  updatedAt: number;
 }
 
 export interface MediaAttachment {
@@ -66,10 +66,16 @@ export interface MediaAttachment {
   previewUrl: string;
   alt: string | null;
   blurhash: string | null;
+  waveform: string | null;
+  posterUrl: string | null;
   width: number | null;
   height: number | null;
-  position: number;
+  position: string;
   mimeType: string;
+  originalName: string;
+  size: number;
+  summary: string | null;
+  chars: number | null;
 }
 
 export interface PostWithMedia extends Post {
@@ -77,46 +83,62 @@ export interface PostWithMedia extends Post {
 }
 
 export interface Collection {
-  id: number;
+  id: string;
   slug: string;
   title: string;
   description: string | null;
   icon: string | null;
   sortOrder: SortOrder;
-  position: number;
   createdAt: number;
   updatedAt: number;
 }
 
-export interface CollectionDivider {
-  id: number;
-  position: number;
+export type SidebarItemType = "collection" | "divider";
+
+export interface SidebarItem {
+  id: string;
+  type: SidebarItemType;
+  collectionId: string | null;
+  position: string;
   createdAt: number;
   updatedAt: number;
 }
 
 export interface PostCollection {
-  postId: number;
-  collectionId: number;
+  postId: string;
+  collectionId: string;
 }
 
 export interface NavItem {
-  id: number;
+  id: string;
   type: NavItemType;
   label: string;
   url: string;
-  pageId: number | null;
-  position: number;
+  position: string;
   createdAt: number;
   updatedAt: number;
 }
 
-export interface Redirect {
-  id: number;
-  fromPath: string;
-  toPath: string;
-  type: 301 | 302;
+export interface CustomUrl {
+  id: string;
+  path: string;
+  targetType: "post" | "collection" | "redirect";
+  targetId: string | null;
+  toPath: string | null;
+  redirectType: 301 | 302 | null;
+  createdAt: number;
+}
+
+export interface PathRecord {
+  id: string;
+  path: string;
+  kind: PathKind;
+  postId: string | null;
+  collectionId: string | null;
+  redirectToPath: string | null;
+  redirectType: 301 | 302 | null;
   createdAt: number;
+  updatedAt: number;
 }
 
 export interface Setting {
@@ -124,3 +146,20 @@ export interface Setting {
   value: string;
   updatedAt: number;
 }
+
+export interface ApiToken {
+  id: string;
+  name: string;
+  prefix: string;
+  lastUsedAt: number | null;
+  createdAt: number;
+  updatedAt: number;
+}
+
+/** Latest-reply context for a thread root, used in timeline display */
+export interface ThreadTimelineContext {
+  latestReply: Post;
+  /** Parent of latestReply, only if it's not the root */
+  parentReply: Post | null;
+  totalReplyCount: number;
+}

package/src/types/operations.ts

@@ -15,14 +15,17 @@ export interface CreatePost {
   status?: Status;
   visibility?: Visibility;
   pinned?: boolean;
+  featured?: boolean;
+  slug?: string;
   path?: string;
   title?: string;
   url?: string;
   body?: string;
+  bodyMarkdown?: string;
   quoteText?: string;
   rating?: number;
-  collectionIds?: number[];
-  replyToId?: number;
+  collectionIds?: string[];
+  replyToId?: string;
   publishedAt?: number;
   mediaIds?: string[];
 }
@@ -32,45 +35,31 @@ export interface UpdatePost {
   status?: Status;
   visibility?: Visibility;
   pinned?: boolean;
-  path?: string | null;
+  featured?: boolean;
+  slug?: string;
   title?: string | null;
   url?: string | null;
   body?: string | null;
+  bodyMarkdown?: string | null;
   quoteText?: string | null;
   rating?: number | null;
-  collectionIds?: number[];
+  collectionIds?: string[];
   publishedAt?: number;
   mediaIds?: string[];
 }
 
-export interface CreatePage {
-  slug: string;
-  title?: string;
-  body?: string;
-  status?: Status;
-}
-
-export interface UpdatePage {
-  slug?: string;
-  title?: string | null;
-  body?: string | null;
-  status?: Status;
-}
-
 export interface CreateNavItem {
   type: NavItemType;
   label: string;
   url: string;
-  pageId?: number;
-  position?: number;
+  position?: string;
 }
 
 export interface UpdateNavItem {
   type?: NavItemType;
   label?: string;
   url?: string;
-  pageId?: number | null;
-  position?: number;
+  position?: string;
 }
 
 export interface CreateCollection {
@@ -79,7 +68,6 @@ export interface CreateCollection {
   description?: string;
   icon?: string;
   sortOrder?: SortOrder;
-  position?: number;
 }
 
 export interface UpdateCollection {
@@ -88,5 +76,4 @@ export interface UpdateCollection {
   description?: string | null;
   icon?: string | null;
   sortOrder?: SortOrder;
-  position?: number;
 }

package/src/types/props.ts

@@ -2,11 +2,10 @@
  * Page-Level Props & Feed Data Types
  */
 
-import type { Format, Visibility } from "./constants.js";
+import type { Format, MediaKind } from "./constants.js";
 import type { Collection } from "./entities.js";
 import type {
   PostView,
-  PageView,
   TimelineItemView,
   SearchResultView,
   ArchiveGroup,
@@ -19,7 +18,6 @@ import type {
 /** Props for the home page component */
 export interface HomePageProps {
   items: TimelineItemView[];
-  pinnedItems: PostView[];
   currentPage: number;
   totalPages: number;
 }
@@ -27,11 +25,7 @@ export interface HomePageProps {
 /** Props for the single post page component */
 export interface PostPageProps {
   post: PostView;
-}
-
-/** Props for the custom page component */
-export interface SinglePageProps {
-  page: PageView;
+  threadPosts?: PostView[];
 }
 
 /** Props for the featured page component */
@@ -39,13 +33,35 @@ export interface FeaturedPageProps {
   items: TimelineItemView[];
 }
 
+/** Visibility filter values for the archive page (includes "featured" as a virtual value). */
+export type ArchiveVisibility = "public" | "unlisted" | "private" | "featured";
+
+/** View mode for the archive page. */
+export type ArchiveView = "grid" | "list";
+
+/** Filters currently active on the archive page */
+export interface ArchiveFilters {
+  year?: number;
+  collectionSlug?: string;
+  collectionTitle?: string;
+  collectionIcon?: string | null;
+  format?: Format;
+  mediaKinds?: MediaKind[];
+  hasMedia?: boolean;
+  hasTitle?: boolean;
+  visibility?: ArchiveVisibility;
+  view?: ArchiveView;
+}
+
 /** Props for the archive page component */
 export interface ArchivePageProps {
   groups: ArchiveGroup[];
-  hasMore: boolean;
-  nextCursor?: number;
-  format?: Format;
-  visibility?: Visibility;
+  currentPage: number;
+  totalPages: number;
+  filters: ArchiveFilters;
+  availableYears: number[];
+  availableCollections: { slug: string; title: string; icon: string | null }[];
+  isAuthenticated: boolean;
 }
 
 /** Props for the search page component */
@@ -62,7 +78,7 @@ export interface CollectionPageProps {
   collection: Collection;
   items: TimelineItemView[];
   hasMore: boolean;
-  nextCursor?: number;
+  nextCursor?: string;
 }
 
 /** Props for the collections list page component */
@@ -87,23 +103,42 @@ export interface FeedData {
 export interface SitemapData {
   siteUrl: string;
   posts: PostView[];
-  pages: PageView[];
 }
 
 // =============================================================================
 // Timeline Types
 // =============================================================================
 
+/**
+ * Display mode for timeline cards.
+ * - `compact` — condensed view for constrained contexts
+ * - `feed`    — standard timeline card (default)
+ * - `detail`  — full single-post page view
+ */
+export type CardMode = "compact" | "feed" | "detail";
+
+export interface PostFooterDisplayOptions {
+  hideActions?: boolean;
+}
+
+export interface TimelineCardDisplayOptions {
+  hideStatusBadges?: boolean;
+  hideRating?: boolean;
+  footer?: PostFooterDisplayOptions;
+}
+
 /** Props for per-type timeline cards */
 export interface TimelineCardProps {
   post: PostView;
-  compact?: boolean;
+  mode?: CardMode;
+  display?: TimelineCardDisplayOptions;
 }
 
 /** Props for thread inline preview */
 export interface ThreadPreviewProps {
   rootPost: PostView;
-  previewReplies: PostView[];
+  latestReply: PostView;
+  parentReply?: PostView;
   totalReplyCount: number;
 }
 

package/src/types/views.ts

@@ -5,17 +5,29 @@
 import type { Format, Status, Visibility, NavItemType } from "./constants.js";
 import type { Post, Collection } from "./entities.js";
 
+/**
+ * Render-ready collection tag for display in post footers.
+ * Pre-computed at the viewmodel layer -- no lib/ imports needed.
+ */
+export interface CollectionTagView {
+  slug: string;
+  title: string;
+  /** Pre-rendered icon HTML (SVG or emoji span) */
+  iconHtml?: string;
+}
+
 /**
  * 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: "/{path}" if path set, otherwise "/p/{sqid}" */
+  /** UUIDv7 identifier */
+  id: string;
+  /** Pre-computed permalink: "/{slug}" */
   permalink: string;
-  /** Custom URL path, if set. Supports multi-level paths (e.g. "2024/my-post") */
-  path?: string;
+  /** Post slug */
+  slug: string;
 
   // Content
   title?: string;
@@ -37,6 +49,7 @@ export interface PostView {
   status: Status;
   visibility: Visibility;
   pinned: boolean;
+  featured: boolean;
   rating?: number;
 
   // Time -- pre-formatted
@@ -54,27 +67,23 @@ export interface PostView {
   // Media -- URLs pre-computed
   media: MediaView[];
 
+  // Collections this post belongs to
+  collections: CollectionTagView[];
+
   // Thread context
-  replyToId?: number;
-  threadRootId?: number;
+  /** UUIDv7 of the parent post */
+  replyToId?: string;
+  /** UUIDv7 of the thread root post */
+  threadRootId?: string;
+  /** Permalink of the thread root post (for "in thread" link on featured replies) */
+  threadRootPermalink?: string;
+  /** Whether this post is the last (most recent) in its thread. Controls reply button visibility. */
+  isLastInThread: boolean;
 
   // Raw content (for forms/editing, not typical theme use)
   body?: string;
 }
 
-/**
- * Render-ready page data for theme components.
- */
-export interface PageView {
-  id: number;
-  slug: string;
-  title?: string;
-  bodyHtml?: string;
-  status: Status;
-  createdAt: string;
-  updatedAt: string;
-}
-
 /**
  * Render-ready media data for theme components.
  * URLs are pre-computed -- no lib/ imports needed.
@@ -90,6 +99,12 @@ export interface MediaView {
   width?: number;
   height?: number;
   size?: number;
+  blurhash?: string;
+  waveform?: string;
+  posterUrl?: string;
+  originalName?: string;
+  summary?: string;
+  chars?: number;
 }
 
 /**
@@ -97,11 +112,11 @@ export interface MediaView {
  * Active/external state pre-computed.
  */
 export interface NavItemView {
-  id: number;
+  /** UUIDv7 identifier */
+  id: string;
   type: NavItemType;
   label: string;
   url: string;
-  pageId?: number;
   /** Pre-computed based on currentPath */
   isActive: boolean;
   /** Pre-computed: starts with http(s):// */
@@ -125,7 +140,12 @@ export interface SearchResult {
 export interface SearchResultView {
   post: PostView;
   rank: number;
+  /** FTS5 snippet from body_text column with <mark> tags */
   snippet?: string;
+  /** Title with matched query terms wrapped in <mark> */
+  titleHighlighted?: string;
+  /** quoteText (truncated) with matched query terms wrapped in <mark> */
+  quoteHighlighted?: string;
 }
 
 /**
@@ -134,7 +154,8 @@ export interface SearchResultView {
 export interface TimelineItemView {
   post: PostView;
   threadPreview?: {
-    replies: PostView[];
+    latestReply: PostView;
+    parentReply?: PostView;
     totalReplyCount: number;
   };
 }
@@ -168,4 +189,6 @@ export interface SiteLayoutProps {
   siteFooterHtml?: string;
   sidebar?: import("hono/jsx").Child;
   uploadMaxFileSize?: number;
+  showComposeDialog?: boolean;
+  showHeader?: boolean;
 }