@jant/core 0.6.15 → 0.7.0

package/src/i18n/__tests__/supported-locales.test.ts

@@ -0,0 +1,83 @@
+import { describe, it, expect } from "vitest";
+import {
+  formatLanguageList,
+  parseLanguageList,
+  toLanguagePrefix,
+} from "../locales.js";
+import { resolveSupportedLocaleTag } from "../supported-locales.js";
+
+describe("resolveSupportedLocaleTag", () => {
+  it("matches a curated tag exactly", () => {
+    expect(resolveSupportedLocaleTag("ja")).toBe("ja");
+    expect(resolveSupportedLocaleTag("pt-BR")).toBe("pt-BR");
+  });
+
+  it("is case-insensitive", () => {
+    expect(resolveSupportedLocaleTag("PT-br")).toBe("pt-BR");
+  });
+
+  it("resolves a region tag to the right Chinese script", () => {
+    // The curated list offers zh by script, not by region, so this has to work
+    // or a Chinese browser lands on English.
+    expect(resolveSupportedLocaleTag("zh-CN")).toBe("zh-Hans");
+    expect(resolveSupportedLocaleTag("zh-SG")).toBe("zh-Hans");
+    expect(resolveSupportedLocaleTag("zh-TW")).toBe("zh-Hant");
+    expect(resolveSupportedLocaleTag("zh-HK")).toBe("zh-Hant");
+  });
+
+  it("falls back to the bare language when the region is unknown", () => {
+    expect(resolveSupportedLocaleTag("de-AT")).toBe("de");
+  });
+
+  it("respects q-values", () => {
+    expect(resolveSupportedLocaleTag("fr;q=0.5,ja;q=0.9,en;q=0.8")).toBe("ja");
+  });
+
+  it("skips entries the client excluded", () => {
+    expect(resolveSupportedLocaleTag("ja;q=0,fr")).toBe("fr");
+  });
+
+  it("falls back to English for anything unrecognized", () => {
+    expect(resolveSupportedLocaleTag("*")).toBe("en");
+    expect(resolveSupportedLocaleTag("")).toBe("en");
+    expect(resolveSupportedLocaleTag(undefined)).toBe("en");
+    expect(resolveSupportedLocaleTag("not a locale!!!")).toBe("en");
+  });
+});
+
+describe("language list settings value", () => {
+  it("round-trips canonical tags in order", () => {
+    expect(formatLanguageList(parseLanguageList("en,ja"))).toBe("en,ja");
+  });
+
+  it("canonicalizes case and trims whitespace", () => {
+    expect(parseLanguageList(" en , ZH-hant ")).toEqual(["en", "zh-Hant"]);
+  });
+
+  it("drops duplicates while keeping the first position", () => {
+    expect(parseLanguageList("ja,en,JA")).toEqual(["ja", "en"]);
+  });
+
+  it("drops blank and unparseable entries", () => {
+    expect(parseLanguageList("en,,not a locale!!!,ja")).toEqual(["en", "ja"]);
+  });
+
+  it("treats missing values as an empty list", () => {
+    expect(parseLanguageList(null)).toEqual([]);
+    expect(parseLanguageList(undefined)).toEqual([]);
+    expect(parseLanguageList("")).toEqual([]);
+  });
+});
+
+describe("toLanguagePrefix", () => {
+  it("lowercases the canonical tag", () => {
+    expect(toLanguagePrefix("zh-Hant")).toBe("zh-hant");
+    expect(toLanguagePrefix("en")).toBe("en");
+  });
+
+  it("maps distinct languages to distinct prefixes", () => {
+    const tags = ["en", "zh-Hans", "zh-Hant", "ja", "pt-BR"];
+    const prefixes = tags.map(toLanguagePrefix);
+    expect(new Set(prefixes).size).toBe(tags.length);
+  });
+});

package/src/i18n/context.tsx

@@ -1,9 +1,15 @@
 /**
- * Request-scoped i18n access for Hono JSX renders.
+ * Request-scoped render state for Hono JSX renders.
+ *
+ * Primarily the i18n instance, which is what components reach for. It also
+ * binds the viewer (`lib/viewer-context.ts`), because this provider is the one
+ * wrapper every server render already passes through — pages via `BaseLayout`,
+ * fragments via the partial routes — and both facts come from the same request.
  */
 
 import type { Context } from "hono";
 import type { FC, PropsWithChildren } from "hono/jsx";
+import { bindViewer } from "../lib/viewer-context.js";
 import type { I18n } from "./i18n.js";
 import { getI18n as getI18nFromContext } from "./i18n.js";
 
@@ -11,7 +17,8 @@ import { getI18n as getI18nFromContext } from "./i18n.js";
 let currentI18n: I18n | null = null;
 
 /**
- * I18nProvider - binds the current request's i18n instance for this render.
+ * I18nProvider - binds this render's request-scoped state: the i18n instance
+ * and the viewer.
  *
  * @example
  * ```tsx
@@ -33,6 +40,9 @@ export const I18nProvider: FC<I18nProviderProps> = ({ c, children }) => {
   // Note: In Hono JSX, rendering is synchronous and single-threaded per request
   // so we can safely set global context without cleanup
   currentI18n = getI18nFromContext(c);
+  // The same flag `BaseLayout` writes into `data-authenticated`, so what a card
+  // renders and what the CSS reveals can never disagree.
+  bindViewer(c.get("isAuthenticated") === true);
   return <>{children}</>;
 };
 

package/src/i18n/detect.ts

@@ -95,25 +95,14 @@ export function detectLocaleFromHeader(header: string | undefined): Locale {
   return baseLocale;
 }
 
-/** Valid CJK font profile values */
-export const CJK_SERIF_FONT_VALUES = [
-  "off",
-  "zh-Hans",
-  "zh-Hant",
-  "ja",
-  "ko",
-] as const;
-export type CjkSerifFont = (typeof CJK_SERIF_FONT_VALUES)[number];
-
 /**
- * Check if a value is a valid CJK serif font setting
+ * CJK typography profiles Jant ships a font stack for.
+ *
+ * Simplified, Traditional, Japanese and Korean want different Han glyph shapes
+ * from the same code points, so each gets its own fallback stack and stylesheet.
  */
-export function isCjkSerifFont(value: unknown): value is CjkSerifFont {
-  return (
-    typeof value === "string" &&
-    CJK_SERIF_FONT_VALUES.includes(value as CjkSerifFont)
-  );
-}
+export const CJK_FONT_PROFILES = ["zh-Hans", "zh-Hant", "ja", "ko"] as const;
+export type CjkFontProfile = (typeof CJK_FONT_PROFILES)[number];
 
 /**
  * Map a BCP 47 language tag to a CJK font profile.
@@ -125,7 +114,7 @@ export function isCjkSerifFont(value: unknown): value is CjkSerifFont {
  */
 export function getCjkFontFromLanguageTag(
   tag: string,
-): Exclude<CjkSerifFont, "off"> | undefined {
+): CjkFontProfile | undefined {
   const normalized = tag.trim().toLowerCase();
   if (!normalized) return undefined;
 
@@ -144,51 +133,3 @@ export function getCjkFontFromLanguageTag(
 
   return undefined;
 }
-
-/**
- * Detect CJK serif font preference from an `Accept-Language` HTTP header.
- *
- * @param header - Raw `Accept-Language` header value
- * @returns CJK serif font value, or "off" if no CJK language detected
- *
- * @example
- * detectCjkFontFromHeader("zh-CN,en;q=0.8") // "zh-Hans"
- * detectCjkFontFromHeader("ja,en;q=0.9")    // "ja"
- * detectCjkFontFromHeader("en-US")           // "off"
- */
-export function detectCjkFontFromHeader(
-  header: string | undefined,
-): CjkSerifFont {
-  if (!header || !header.trim()) return "off";
-
-  const entries: Array<{ tag: string; q: number }> = [];
-
-  for (const part of header.split(",")) {
-    const segments = part.trim().split(";");
-    const tag = segments[0]?.trim();
-    if (!tag) continue;
-
-    let q = 1.0;
-    for (let i = 1; i < segments.length; i++) {
-      const param = segments[i]?.trim();
-      if (param?.toLowerCase().startsWith("q=")) {
-        const parsed = Number.parseFloat(param.slice(2));
-        if (!Number.isNaN(parsed)) q = parsed;
-        break;
-      }
-    }
-
-    if (q <= 0) continue;
-
-    entries.push({ tag, q });
-  }
-
-  entries.sort((a, b) => b.q - a.q);
-
-  for (const { tag } of entries) {
-    const font = getCjkFontFromLanguageTag(tag);
-    if (font) return font;
-  }
-
-  return "off";
-}

package/src/i18n/locales/glossary.zh-Hans.yml

@@ -1,4 +1,36 @@
 terms:
+  - source: Post
+    target: 帖子
+    note: Jant 的核心内容单位。泛指别人写的文章时仍用「文章」，不要混用。
+
+  - source: Posts
+    target: 帖子
+    note: Jant 的核心内容单位，可按语境补上量词。
+
+  - source: post
+    target: 帖子
+    note: Jant 的核心内容单位。泛指别人写的文章时仍用「文章」，不要混用。
+
+  - source: posts
+    target: 帖子
+    note: Jant 的核心内容单位，可按语境补上量词。
+
+  - source: Smart Collection
+    target: 智能合集
+    note: 成员由条件决定的合集。不要译成智能收藏夹或智能分组；「智能」修饰的是收录方式，不是它本身。
+
+  - source: Smart Collections
+    target: 智能合集
+    note: 成员由条件决定的合集，可按语境补上量词。
+
+  - source: smart collection
+    target: 智能合集
+    note: 成员由条件决定的合集。不要译成智能收藏夹或智能分组。
+
+  - source: smart collections
+    target: 智能合集
+    note: 成员由条件决定的合集，可按语境补上量词。
+
   - source: Collection
     target: 合集
     note: Jant 的策展概念。不要译成收藏夹、收藏集或集合。
@@ -76,8 +108,8 @@ terms:
     note: 未发布内容。
 
   - source: Featured
-    target: 精选
-    note: 站点精选内容。
+    target: Featured
+    note: 帖子标记的名称，界面上保留英文，不要译成「精选」。
 
   - source: Pinned
     target: 已置顶
@@ -88,8 +120,16 @@ terms:
     note: 已发布状态标签。
 
   - source: Hidden from Latest
-    target: 从最新中隐藏
-    note: 不出现在 Latest 中，但仍可通过固定链接和集合访问的状态。
+    target: Hidden from Latest
+    note: 帖子状态的名称，界面上保留英文。句子里描述这个状态时可以写「从 Latest 中隐藏」。
+
+  - source: Latest
+    target: Latest
+    note: 站点时间线的名称，界面上保留英文，不要译成「最新」。小写的 latest 只是「最新的」，照常翻译。
+
+  - source: Discover
+    target: Discover
+    note: Jant 公开博客目录的名称，界面上保留英文，不要译成「发现」或「探索」。「Jant Discover」整体是产品名。
 
   - source: API Tokens
     target: API 令牌

package/src/i18n/locales/glossary.zh-Hant.yml

@@ -1,4 +1,36 @@
 terms:
+  - source: Post
+    target: 貼文
+    note: Jant 的核心內容單位。台灣慣用貼文，不用帖子。
+
+  - source: Posts
+    target: 貼文
+    note: Jant 的核心內容單位，可依語境補上量詞。
+
+  - source: post
+    target: 貼文
+    note: Jant 的核心內容單位。台灣慣用貼文，不用帖子。
+
+  - source: posts
+    target: 貼文
+    note: Jant 的核心內容單位，可依語境補上量詞。
+
+  - source: Smart Collection
+    target: 智慧選集
+    note: 成員由條件決定的選集。不要譯成智慧收藏夾或智慧分組；「智慧」修飾的是收錄方式，不是它本身。
+
+  - source: Smart Collections
+    target: 智慧選集
+    note: 成員由條件決定的選集，可依語境補上量詞。
+
+  - source: smart collection
+    target: 智慧選集
+    note: 成員由條件決定的選集。不要譯成智慧收藏夾或智慧分組。
+
+  - source: smart collections
+    target: 智慧選集
+    note: 成員由條件決定的選集，可依語境補上量詞。
+
   - source: Collection
     target: 選集
     note: Jant 的策展概念。不要譯成收藏夾、收藏集或集合。
@@ -76,8 +108,8 @@ terms:
     note: 尚未發佈內容。
 
   - source: Featured
-    target: 精選
-    note: 網站精選內容。
+    target: Featured
+    note: 貼文標記的名稱，介面上保留英文，不要譯成「精選」。
 
   - source: Pinned
     target: 已釘選
@@ -88,8 +120,16 @@ terms:
     note: 已發佈狀態標籤。
 
   - source: Hidden from Latest
-    target: 從最新中隱藏
-    note: 不出現在 Latest 中，但仍可透過固定連結和集合存取的狀態。
+    target: Hidden from Latest
+    note: 貼文狀態的名稱，介面上保留英文。句子裡描述這個狀態時可以寫「從 Latest 中隱藏」。
+
+  - source: Latest
+    target: Latest
+    note: 網站時間軸的名稱，介面上保留英文，不要譯成「最新」。小寫的 latest 只是「最新的」，照常翻譯。
+
+  - source: Discover
+    target: Discover
+    note: Jant 公開部落格目錄的名稱，介面上保留英文，不要譯成「探索」或「發現」。「Jant Discover」整體是產品名。
 
   - source: API Tokens
     target: API 權杖