@hanology/cham-browser 0.1.0 → 0.2.0

package/template/src/styles/main.css

@@ -0,0 +1,136 @@
+/* ===== THEME DEFINITIONS ===== */
+:root,
+[data-theme="light"] {
+  --ink: #1a1a1a;
+  --ink-mid: #4a3f35;
+  --ink-light: #7a6e5f;
+  --ink-faint: #a89b8a;
+  --paper: #faf6ee;
+  --paper-warm: #f5f0e5;
+  --paper-deep: #ebe4d4;
+  --surface: #ffffff;
+  --surface-warm: #fffdf8;
+  --vermillion: #c23a2b;
+  --vermillion-light: #d4554a;
+  --gold: #9a7d3a;
+  --gold-light: #c9a84c;
+  --jade: #3a6b5e;
+  --border: #d8cdb8;
+  --border-light: #e8e0d0;
+  --shadow-rgb: 26,26,26;
+  --selection-text: #fff;
+}
+
+[data-theme="sepia"] {
+  --ink: #4a3f2e;
+  --ink-mid: #6b5d4a;
+  --ink-light: #8a7a66;
+  --ink-faint: #a8997f;
+  --paper: #f0e4c8;
+  --paper-warm: #e8d8b8;
+  --paper-deep: #dcc8a0;
+  --surface: #f8eed8;
+  --surface-warm: #f5ead0;
+  --vermillion: #a8321f;
+  --vermillion-light: #c44535;
+  --gold: #8a6d2a;
+  --gold-light: #b89540;
+  --jade: #2d5a4e;
+  --border: #c9b896;
+  --border-light: #d8cab0;
+  --shadow-rgb: 74,63,46;
+  --selection-text: #fff;
+}
+
+[data-theme="dark"] {
+  --ink: #e8e0d0;
+  --ink-mid: #c8bfae;
+  --ink-light: #9a9185;
+  --ink-faint: #6a6258;
+  --paper: #1c1c1e;
+  --paper-warm: #2a2a2c;
+  --paper-deep: #3a3a3c;
+  --surface: #2c2c2e;
+  --surface-warm: #323234;
+  --vermillion: #e05545;
+  --vermillion-light: #e87060;
+  --gold: #c9a84c;
+  --gold-light: #d8b860;
+  --jade: #5aaa98;
+  --border: #48484a;
+  --border-light: #555557;
+  --shadow-rgb: 0,0,0;
+  --selection-text: #fff;
+}
+
+[data-theme="oled"] {
+  --ink: #ffffff;
+  --ink-mid: #d0d0d0;
+  --ink-light: #909090;
+  --ink-faint: #606060;
+  --paper: #000000;
+  --paper-warm: #0a0a0a;
+  --paper-deep: #141414;
+  --surface: #0a0a0a;
+  --surface-warm: #101010;
+  --vermillion: #ff4444;
+  --vermillion-light: #ff6666;
+  --gold: #e8c840;
+  --gold-light: #f0d860;
+  --jade: #40c8a8;
+  --border: #333333;
+  --border-light: #444444;
+  --shadow-rgb: 0,0,0;
+  --selection-text: #000;
+}
+
+/* ===== RESET ===== */
+:root {
+  --serif: 'Noto Serif TC', '宋體-繁', serif;
+  --sans: 'Noto Sans TC', 'PingFang TC', sans-serif;
+  --nav-width: 56px;
+}
+*, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
+html { scroll-behavior: smooth; -webkit-font-smoothing: antialiased; }
+body {
+  font-family: var(--serif);
+  background: var(--paper);
+  color: var(--ink);
+  line-height: 1.8;
+  min-height: 100vh;
+}
+::selection { background: var(--vermillion); color: var(--selection-text); }
+::-webkit-scrollbar { width: 6px; height: 6px; }
+::-webkit-scrollbar-track { background: transparent; }
+::-webkit-scrollbar-thumb { background: var(--border); border-radius: 3px; }
+
+a { color: inherit; text-decoration: none; }
+
+/* ===== LOADING SCREEN ===== */
+#app-loading {
+  position: fixed; inset: 0;
+  background: var(--paper);
+  display: flex; flex-direction: column;
+  align-items: center; justify-content: center;
+  z-index: 9999;
+}
+#app-loading .char {
+  font-family: var(--serif);
+  font-size: 64px; font-weight: 900;
+  color: var(--ink);
+  animation: pulse 1.2s ease-in-out infinite;
+}
+#app-loading .text {
+  font-family: var(--sans);
+  font-size: 13px; color: var(--ink-faint);
+  letter-spacing: 4px; margin-top: 16px;
+}
+@keyframes pulse {
+  0%, 100% { opacity: 0.3; }
+  50% { opacity: 1; }
+}
+
+/* ===== RESPONSIVE ===== */
+@media (max-width: 768px) {
+  :root { --nav-width: 44px; }
+}

package/template/src/types.ts

@@ -0,0 +1,164 @@
+// ─── Library ────────────────────────────────────────────────────
+
+export type LibraryScale = 'single-piece' | 'single-book' | 'library'
+export type BookGenre = 'poetry' | 'prose' | 'mixed' | 'drama'
+
+export interface BookLayer {
+  id: string
+  label: string
+  shortLabel?: string
+  contributor: string
+  role?: string
+  nature?: string
+  displayOrder?: number
+  enabled?: boolean
+}
+
+export interface BookAnnotationDefaults {
+  defaultLabel?: string
+  defaultShortLabel?: string
+}
+
+export interface BookMeta {
+  id: string
+  title: string
+  subtitle?: string
+  titleEn?: string
+  publisher?: string
+  genre: BookGenre
+  count: number
+  hero?: string[]
+  layers?: BookLayer[]
+  annotation?: BookAnnotationDefaults
+}
+
+export interface CrossRef {
+  focusedBookId: string
+  focusedNum: number
+  fullBookId: string
+  fullNum?: number
+  relation: 'section' | 'excerpt'
+}
+
+export interface LibraryIndex {
+  scale: LibraryScale
+  books: BookMeta[]
+  crossRefs?: CrossRef[]
+}
+
+export interface BookData {
+  meta: BookMeta
+  pieces: Piece[]
+}
+
+// ─── Piece ──────────────────────────────────────────────────────
+
+export interface TextRange {
+  type: 'point' | 'range' | 'full'
+  scope: 'verse' | 'title' | 'section' | 'full_text'
+  verseIndex?: number
+  sectionKey?: string
+  start?: number
+  end?: number
+}
+
+export interface Annotation {
+  id: string
+  range: TextRange
+  kind: 'pronunciation' | 'semantic' | 'etymology' | 'note' | 'definition' | 'commentary' | 'translation'
+  lang?: string
+  text: string
+  source: string
+}
+
+export interface PronSegment {
+  lang: 'yue' | 'cmn'
+  label: string
+  parts: string[]
+}
+
+export interface AnnotationEntry {
+  num: number
+  numDisplay: string
+  term: string
+  pronSegments: PronSegment[]
+  definition: string
+}
+
+export interface VerseLine {
+  text: string
+}
+
+export interface AnnotationLayer {
+  id: string
+  label: string
+  shortLabel: string
+  contributor: string
+  role: string
+  nature: string
+  displayOrder: number
+  enabled: boolean
+  annotations: Annotation[]
+}
+
+export interface PieceContributor {
+  id: string
+  name: string
+  role: string
+  title?: string
+}
+
+export interface PieceSource {  text?: string
+  textRef?: string
+  pieceRef?: number
+  relation: 'section' | 'excerpt' | 'standalone'
+  range?: { start: string; end: string }
+}
+
+export interface ProseSection {
+  key: string
+  title: string
+  filename: string
+  body: string
+  order: number
+}
+
+export interface Piece {
+  bookId: string
+  num: number
+  title: string
+  author: string
+  authorId: string
+  dynasty: string
+  genre: BookGenre
+  verses: VerseLine[]
+  sections: Record<string, string>
+  structuredSections?: ProseSection[]
+  annotations: Annotation[]
+  layers?: Record<string, Annotation[]>
+  annotationLayers?: AnnotationLayer[]
+  source?: PieceSource
+  contributors?: PieceContributor[]
+}
+
+// Backward compatibility alias
+export type Poem = Piece
+
+// ─── Author & Dynasty ───────────────────────────────────────────
+
+export interface Author {
+  '@id': string
+  '@type': string
+  name: string
+  dynasty: string
+  poemCount: number
+  bio?: string
+}
+
+export interface Dynasty {
+  '@id': string
+  '@type': string
+  name: string
+  authors: string[]
+  poemCount: number
+}

package/template/src/utils/annotationParser.ts

@@ -0,0 +1,58 @@
+import type { Annotation, AnnotationEntry, PronSegment } from '../types'
+import { toChineseNumber } from './chineseNumber'
+
+function esc(s: string): string {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+}
+
+export function parsePronSegments(def: string): { segments: PronSegment[], remaining: string } {
+  const parts = def.split('○').filter(s => s.trim())
+  if (!parts.length) return { segments: [], remaining: '' }
+
+  const segments: PronSegment[] = []
+  const remaining: string[] = []
+
+  for (const raw of parts) {
+    const s = raw.replace(/[；;]/g, ' ').trim()
+    if (s.startsWith('粵')) {
+      segments.push({ lang: 'yue', label: '粵', parts: s.slice(1).trim().split(/\s+/).filter(Boolean) })
+    } else if (s.startsWith('漢')) {
+      segments.push({ lang: 'cmn', label: '普', parts: s.slice(1).trim().split(/\s+/).filter(Boolean) })
+    } else {
+      remaining.push(s)
+    }
+  }
+
+  return { segments, remaining: remaining.join('\n').trim() }
+}
+
+export function parseAnnotationBlock(raw: string): AnnotationEntry[] {
+  const parts = raw.split(/(\d{1,2})\.\s*/)
+  const entries: AnnotationEntry[] = []
+
+  for (let i = 1; i < parts.length; i += 2) {
+    const num = parseInt(parts[i], 10)
+    const body = parts[i + 1]?.trim() || ''
+    const colonIdx = body.indexOf('：')
+    const term = colonIdx >= 0 ? body.slice(0, colonIdx) : ''
+    const def = colonIdx >= 0 ? body.slice(colonIdx + 1) : body
+    const { segments, remaining } = parsePronSegments(def)
+    entries.push({
+      num,
+      numDisplay: toChineseNumber(num),
+      term,
+      pronSegments: segments,
+      definition: esc(remaining),
+    })
+  }
+
+  return entries.length ? entries : []
+}
+
+export function annotationToPronSegment(ann: Annotation): PronSegment | null {
+  if (ann.kind !== 'pronunciation') return null
+  const parts = ann.text.replace(/[；;]/g, ' ').trim().split(/\s+/).filter(Boolean)
+  if (!parts.length) return null
+  const lang = ann.lang === 'yue' ? 'yue' : 'cmn'
+  return { lang, label: lang === 'yue' ? '粵' : '普', parts }
+}

package/template/src/utils/chineseNumber.ts

@@ -0,0 +1,41 @@
+const DIGITS = ['零', '一', '二', '三', '四', '五', '六', '七', '八', '九']
+
+export function toChineseNumber(n: number): string {
+  if (n < 0) return '負' + toChineseNumber(-n)
+  if (n === 0) return '零'
+  if (n < 10) return DIGITS[n]
+
+  if (n >= 10000) {
+    const wan = Math.floor(n / 10000)
+    const rest = n % 10000
+    return (wan === 1 ? '' : toChineseNumber(wan)) + '萬' + (rest ? toChineseNumber(rest) : '')
+  }
+  if (n >= 1000) {
+    const qian = Math.floor(n / 1000)
+    const rest = n % 1000
+    return (qian === 1 ? '' : DIGITS[qian]) + '千' + (rest ? formatUnder1000(rest) : '')
+  }
+  if (n >= 100) {
+    const bai = Math.floor(n / 100)
+    const rest = n % 100
+    return (bai === 1 ? '' : DIGITS[bai]) + '百' + (rest ? formatTens(rest) : '')
+  }
+  return formatTens(n)
+}
+
+function formatTens(n: number): string {
+  if (n < 10) return DIGITS[n]
+  const tens = Math.floor(n / 10)
+  const ones = n % 10
+  const T: Record<number, string> = { 1: '十', 2: '廿', 3: '卅', 4: '卌' }
+  if (T[tens]) return T[tens] + (ones ? DIGITS[ones] : '')
+  return DIGITS[tens] + (ones ? DIGITS[ones] : '十')
+}
+
+function formatUnder1000(n: number): string {
+  if (n === 0) return ''
+  if (n < 100) return formatTens(n)
+  const bai = Math.floor(n / 100)
+  const rest = n % 100
+  return DIGITS[bai] + '百' + (rest ? formatTens(rest) : '')
+}