@jant/core 0.6.11 → 0.6.12

package/src/services/index.ts

@@ -35,6 +35,7 @@ import {
   createSiteProfileService,
   type SiteProfileService,
 } from "./site-profile.js";
+import { createAboutPageService, type AboutPageService } from "./about-page.js";
 import {
   createUploadSessionService,
   type UploadSessionService,
@@ -64,6 +65,7 @@ export interface Services {
   siteAdmin: SiteAdminService;
   siteMembers: SiteMemberService;
   siteProfile: SiteProfileService;
+  aboutPage: AboutPageService;
   githubAppInstallations: GitHubAppInstallationsService;
   telegram: TelegramService;
 }
@@ -88,6 +90,23 @@ export function createServices(
   const settings = createSettingsService(db, siteId, databaseSchema, dialect);
   const paths = createPathService(db, siteId, databaseSchema);
   const navItems = createNavItemService(db, siteId, databaseSchema);
+  const posts = createPostService(
+    db,
+    {
+      slugIdLength: config?.slugIdLength ?? 5,
+      databaseDialect: dialect,
+    },
+    siteId,
+    paths,
+    databaseSchema,
+  );
+  const collections = createCollectionService(
+    db,
+    siteId,
+    paths,
+    databaseSchema,
+    dialect,
+  );
   const media = createMediaService(db, siteId, databaseSchema, dialect, {
     enforceHostedQuota: config?.enforceHostedMediaQuota ?? false,
     hostedControlPlane: config?.hostedControlPlane ?? null,
@@ -97,26 +116,11 @@ export function createServices(
     settings,
     site,
     paths,
-    posts: createPostService(
-      db,
-      {
-        slugIdLength: config?.slugIdLength ?? 5,
-        databaseDialect: dialect,
-      },
-      siteId,
-      paths,
-      databaseSchema,
-    ),
+    posts,
     customUrls: createCustomUrlService(db, siteId, paths, databaseSchema),
     media,
     uploads: createUploadSessionService(db, siteId, media, databaseSchema),
-    collections: createCollectionService(
-      db,
-      siteId,
-      paths,
-      databaseSchema,
-      dialect,
-    ),
+    collections,
     search: createSearchService(rawQuery, siteId, dialect),
     navItems,
     auth: createAuthService(
@@ -148,6 +152,11 @@ export function createServices(
         );
       },
     }),
+    aboutPage: createAboutPageService({
+      paths,
+      posts,
+      collections,
+    }),
     githubAppInstallations: createGitHubAppInstallationsService(
       db,
       databaseSchema,
@@ -166,6 +175,7 @@ export type { UploadSessionService } from "./upload-session.js";
 export type { CollectionService } from "./collection.js";
 export type { SearchService, SearchResult, SearchOptions } from "./search.js";
 export type { NavItemService } from "./navigation.js";
+export type { AboutPageService, AboutPageStatus } from "./about-page.js";
 export type { AuthService, DeleteAccountDeps } from "./auth.js";
 export type { ApiTokenService } from "./api-token.js";
 export type {

package/src/services/navigation.ts

@@ -15,6 +15,7 @@ import {
 import { createEntityId } from "../lib/ids.js";
 import { ValidationError } from "../lib/errors.js";
 import { now } from "../lib/time.js";
+import { normalizePath } from "../lib/url.js";
 import { COLLECTION_FRESHNESS_WINDOW_SECONDS } from "../types.js";
 import type {
   NavItem,
@@ -23,10 +24,15 @@ import type {
   CreateNavItem,
   UpdateNavItem,
   SystemNavKey,
+  SuggestedNavLink,
 } from "../types.js";
 import { SYSTEM_NAV_KEYS } from "../types.js";
 
 const POSITION_RETRY_ATTEMPTS = 5;
+const SUGGESTED_NAV_LINK_CANDIDATES = [
+  { key: "about", path: "/about", label: "About" },
+  { key: "now", path: "/now", label: "Now" },
+] as const;
 
 // Re-export shared constraint detection — see db/dialect.ts
 import { isUniqueConstraintError } from "../db/dialect.js";
@@ -45,6 +51,7 @@ export interface NavItemService {
     afterId: string | null,
     beforeId: string | null,
   ): Promise<NavItem | null>;
+  listSuggestedLinks(): Promise<SuggestedNavLink[]>;
   getCollectionFreshness(collectionIds: string[]): Promise<Map<string, number>>;
 }
 
@@ -53,7 +60,8 @@ export function createNavItemService(
   siteId: string,
   databaseSchema: DatabaseSchema = sqliteSchemaBundle,
 ): NavItemService {
-  const { navItems, postCollections, posts } = databaseSchema;
+  const { navItems, postCollections, posts, pathRegistry, collections } =
+    databaseSchema;
 
   const defaultSystemOrder = [
     "latest",
@@ -121,6 +129,39 @@ export function createNavItemService(
     };
   }
 
+  function withLeadingSlash(path: string): string {
+    const normalized = normalizePath(path);
+    return normalized ? `/${normalized}` : "/";
+  }
+
+  function getComparableInternalPath(url: string): string | null {
+    if (
+      url.startsWith("http://") ||
+      url.startsWith("https://") ||
+      url.startsWith("//") ||
+      url.startsWith("mailto:") ||
+      url.startsWith("tel:") ||
+      url.startsWith("#")
+    ) {
+      return null;
+    }
+
+    try {
+      const pathname = new URL(url, "https://jant.invalid").pathname;
+      return withLeadingSlash(pathname);
+    } catch {
+      return null;
+    }
+  }
+
+  function normalizeSuggestedLabel(
+    label: string | null | undefined,
+    fallback: string,
+  ): string {
+    const trimmed = label?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed : fallback;
+  }
+
   async function getLastPosition(): Promise<string | null> {
     const rows = await db
       .select({ position: navItems.position })
@@ -414,6 +455,119 @@ export function createNavItemService(
       throw new Error("Failed to assign a unique nav item position");
     },
 
+    async listSuggestedLinks() {
+      const existingRows = await db
+        .select({
+          url: navItems.url,
+          collectionId: navItems.collectionId,
+        })
+        .from(navItems)
+        .where(eq(navItems.siteId, siteId));
+      const existingPaths = new Set(
+        existingRows.flatMap((item) => {
+          const path = getComparableInternalPath(item.url);
+          return path ? [path] : [];
+        }),
+      );
+      const existingCollectionIds = new Set(
+        existingRows.flatMap((item) =>
+          item.collectionId ? [item.collectionId] : [],
+        ),
+      );
+
+      const suggestions: SuggestedNavLink[] = [];
+
+      for (const candidate of SUGGESTED_NAV_LINK_CANDIDATES) {
+        const path = withLeadingSlash(candidate.path);
+        if (existingPaths.has(path)) continue;
+
+        const pathRows = await db
+          .select()
+          .from(pathRegistry)
+          .where(
+            and(
+              eq(pathRegistry.siteId, siteId),
+              eq(pathRegistry.path, normalizePath(candidate.path)),
+            ),
+          )
+          .limit(1);
+        const record = pathRows[0];
+        if (!record || record.kind === "redirect") continue;
+
+        if (record.postId) {
+          const postRows = await db
+            .select({
+              title: posts.title,
+              status: posts.status,
+              visibility: posts.visibility,
+            })
+            .from(posts)
+            .where(and(eq(posts.siteId, siteId), eq(posts.id, record.postId)))
+            .limit(1);
+          const post = postRows[0];
+          if (
+            !post ||
+            post.status !== "published" ||
+            post.visibility === "private"
+          ) {
+            continue;
+          }
+
+          suggestions.push({
+            key: candidate.key,
+            label: normalizeSuggestedLabel(post.title, candidate.label),
+            url: path,
+            targetType: "page",
+            navItemType: "link",
+          });
+          continue;
+        }
+
+        if (record.collectionId) {
+          if (existingCollectionIds.has(record.collectionId)) continue;
+
+          const collectionRows = await db
+            .select({
+              title: collections.title,
+            })
+            .from(collections)
+            .where(
+              and(
+                eq(collections.siteId, siteId),
+                eq(collections.id, record.collectionId),
+              ),
+            )
+            .limit(1);
+          const collection = collectionRows[0];
+          if (!collection) continue;
+
+          suggestions.push({
+            key: candidate.key,
+            label: normalizeSuggestedLabel(collection.title, candidate.label),
+            url: path,
+            targetType: "collection",
+            navItemType: record.kind === "slug" ? "collection" : "link",
+            ...(record.kind === "slug" && {
+              collectionId: record.collectionId,
+            }),
+          });
+          continue;
+        }
+
+        if (record.kind === "archive") {
+          suggestions.push({
+            key: candidate.key,
+            label: candidate.label,
+            url: path,
+            targetType: "archive",
+            navItemType: "link",
+          });
+        }
+      }
+
+      return suggestions;
+    },
+
     async getCollectionFreshness(collectionIds) {
       if (collectionIds.length === 0) return new Map<string, number>();
 

package/src/services/post.ts

@@ -1105,6 +1105,21 @@ export function createPostService(
     return conditions;
   }
 
+  function buildCollectionThreadActivityExpr(alias: string) {
+    return sql<number>`MAX(
+      COALESCE(
+        (
+          SELECT root.last_activity_at
+          FROM post AS root
+          WHERE root.site_id = ${siteId}
+            AND root.id = ${posts.threadId}
+        ),
+        ${posts.publishedAt},
+        ${posts.updatedAt}
+      )
+    )`.as(alias);
+  }
+
   function isMediaAttachmentInput(
     attachment: PostAttachmentInput,
   ): attachment is Extract<PostAttachmentInput, { type: "media" }> {
@@ -2845,6 +2860,8 @@ export function createPostService(
         sortOrder === "oldest"
           ? sql<number>`MIN(${posts.publishedAt})`.as("published_at")
           : sql<number>`MAX(${posts.publishedAt})`.as("published_at");
+      const threadActivityAt =
+        buildCollectionThreadActivityExpr("thread_activity_at");
       const ratingPresence = sql<number>`MAX(
         CASE
           WHEN ${posts.rating} IS NULL THEN 0
@@ -2864,6 +2881,7 @@ export function createPostService(
         .select({
           threadId: posts.threadId,
           publishedAt,
+          threadActivityAt,
           collectionPinnedAt,
           ratingPresence,
           ratingValue,
@@ -2891,12 +2909,12 @@ export function createPostService(
                 desc(collectionPinnedAt),
                 desc(ratingPresence),
                 desc(ratingValue),
-                desc(publishedAt),
+                desc(threadActivityAt),
                 desc(posts.threadId),
               )
             : baseQuery.orderBy(
                 desc(collectionPinnedAt),
-                desc(publishedAt),
+                desc(threadActivityAt),
                 desc(posts.threadId),
               );
 
@@ -2923,9 +2941,8 @@ export function createPostService(
         ...buildThreadRootPageConditions(options),
         buildCollectionMembershipCondition(collectionIds),
       ];
-      const publishedAt = sql<number>`MAX(${posts.publishedAt})`.as(
-        "published_at",
-      );
+      const threadActivityAt =
+        buildCollectionThreadActivityExpr("thread_activity_at");
       const collectedAt = sql<number>`MAX(${postCollections.createdAt})`.as(
         "collected_at",
       );
@@ -2937,7 +2954,7 @@ export function createPostService(
       let query = db
         .select({
           threadId: posts.threadId,
-          publishedAt,
+          threadActivityAt,
           collectedAt,
           collectionPinnedAt,
         })
@@ -2953,7 +2970,7 @@ export function createPostService(
         .groupBy(posts.threadId)
         .orderBy(
           desc(collectionPinnedAt),
-          desc(publishedAt),
+          desc(threadActivityAt),
           desc(posts.threadId),
         );
 

package/src/styles/components.css

@@ -1163,6 +1163,26 @@ svg[stroke-width].icon-fine {
     border-color: var(--color-border);
   }
 
+  .nav-suggestions-list {
+    @apply flex flex-col gap-2;
+  }
+
+  .nav-suggestion-item {
+    @apply flex items-center justify-between gap-3 rounded-lg border px-3 py-2;
+  }
+
+  .nav-suggestion-info {
+    @apply flex min-w-0 flex-col;
+  }
+
+  .nav-suggestion-title {
+    @apply truncate text-sm font-medium;
+  }
+
+  .nav-suggestion-meta {
+    @apply truncate text-xs text-muted-foreground;
+  }
+
   /* Collection picker dropdown menu */
   .collection-picker {
     @apply absolute left-0 z-10 mt-1.5 w-64 overflow-y-auto rounded-lg border py-1.5;

package/src/styles/tokens.css

@@ -65,8 +65,8 @@
    *   --type-subtitle   1.8rem  (27px)   — h3
    *   --type-body       1.4rem  (21px)   — running text, form inputs
    *   --type-secondary  1.1rem  (16.5px) — meta, nav, sidenotes, UI labels
-   *   --type-base       1.0rem  (15px)   — code, UI buttons, controls
-   *   --type-sm         0.9rem  (13.5px) — code blocks, small UI text
+   *   --type-base       1.0rem  (15px)   — UI buttons, controls
+   *   --type-sm         0.9rem  (13.5px) — small UI text
    *   --type-xs         0.8rem  (12px)   — captions, descriptions, chips
    *   --type-2xs        0.65rem (9.75px) — tiny labels, file sizes, badges
    */
@@ -84,18 +84,20 @@
      mobile overrides below cap sizes for small screens.
      --type-content-scale uniformly scales all content sizes
      without affecting UI controls. */
-  --type-content-scale: 0.78;
+  --type-content-scale: 0.8;
   --type-content-display: calc(var(--type-display) * var(--type-content-scale));
   --type-content-title: calc(var(--type-title) * var(--type-content-scale));
   --type-content-subtitle: calc(
     var(--type-subtitle) * var(--type-content-scale)
   );
   --type-content-body: calc(var(--type-body) * var(--type-content-scale));
+  --type-content-quote: calc(var(--type-content-body) * 1.16);
+  --type-content-quote-leading: 1.4;
 
   /* Semantic aliases */
-  --type-code: var(--type-base);
-  --type-code-block: var(--type-sm);
   --type-body-size: var(--type-content-body);
+  --type-code: calc(var(--type-body-size) * 0.94);
+  --type-code-block: calc(var(--type-body-size) * 0.9);
   --type-body-tracking: 0;
   --type-ui-title: var(--type-secondary);
   --type-ui-control: var(--type-base);
@@ -107,9 +109,9 @@
   --type-thread-context: var(--type-base);
   --type-thread-context-title: var(--type-secondary);
   --type-thread-context-meta: var(--type-sm);
-  --feed-note-title-size: var(--type-content-title);
+  --feed-note-title-size: calc(var(--type-content-body) * 1.36);
   --feed-note-title-leading: var(--type-heading-leading);
-  --type-body-leading: 1.5;
+  --type-body-leading: 1.7;
   --type-display-leading: 1.15;
   --type-heading-leading: 1.15;
   --type-heading-weight: var(--fw-regular);
@@ -264,6 +266,22 @@
     var(--site-text-primary) 12%,
     transparent
   );
+  --site-code-text: color-mix(
+    in srgb,
+    var(--site-reading-heading) 86%,
+    var(--site-reading-body)
+  );
+  --site-code-bg: color-mix(in srgb, var(--site-reading-meta) 12%, transparent);
+  --site-code-block-bg: color-mix(
+    in srgb,
+    var(--site-elevated-bg) 94%,
+    var(--site-nav-hover-bg)
+  );
+  --site-code-block-border: color-mix(
+    in srgb,
+    var(--site-divider) 62%,
+    transparent
+  );
   --site-feed-divider-color: color-mix(
     in srgb,
     var(--site-text-secondary) 30%,
@@ -484,7 +502,7 @@
   :root {
     /* Content layer — tighter scale for mobile reading.
        Ratio ≈ 1.88 : 1.42 : 1.15 : 1 (display:title:subtitle:body).
-       At 15px root × 0.78 content-scale: 28.7 / 21.6 / 17.6 / 15.2px.
+       At 15px root × 0.8 content-scale: 29.4 / 22.2 / 18 / 15.6px.
        Body is floored to a 16px minimum below (max()) for readability;
        the floor still yields to calc() when the user zooms the root up. */
     --type-content-display: calc(2.45rem * var(--type-content-scale));