@hanology/cham-browser 0.4.27 → 0.4.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanology/cham-browser",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "CHAM — browser-compatible parser, serializer, and site generator for Classical Han Annotated Markdown",
   "type": "module",
   "main": "dist/index.js",

package/template/src/components/AnnotationTooltip.vue

@@ -155,21 +155,27 @@ onBeforeUnmount(() => {
         <button class="ann-sheet-handle" @click="dismiss">
           <span class="ann-handle-bar" />
         </button>
-        <div v-if="headword" class="ann-sheet-head" :class="dominantKind()">
-          <span class="ann-headword">{{ headword }}</span>
-          <span class="ann-badge-count" v-if="annotations.length > 1">{{ annotations.length }}</span>
-        </div>
-        <div class="ann-sheet-scroll">
-          <div v-for="ann in annotations" :key="ann.id" class="ann-entry">
-            <div class="ann-entry-header">
-              <span class="ann-kind" :class="ann.kind">{{ kindLabel(ann) }}</span>
-              <span v-if="layerLabel(ann)" class="ann-layer">{{ layerLabel(ann) }}</span>
-            </div>
-            <div class="ann-entry-body">
-              <div v-if="getSegment(ann)" class="ann-pron-h"><PronunciationGroup :segment="getSegment(ann)!" /></div>
-              <div v-if="ann.text && ann.kind !== 'pronunciation'" class="ann-text">{{ ann.text }}</div>
+        <div class="ann-sheet-body" :class="{ vertical }">
+          <div v-if="headword" class="ann-sheet-head" :class="dominantKind()">
+            <span class="ann-headword">{{ headword }}</span>
+            <span class="ann-badge-count" v-if="annotations.length > 1">{{ annotations.length }}</span>
+          </div>
+          <div class="ann-sheet-scroll">
+            <div v-for="ann in annotations" :key="ann.id" class="ann-entry">
+              <div class="ann-entry-header">
+                <span class="ann-kind" :class="ann.kind">{{ kindLabel(ann) }}</span>
+                <span v-if="layerLabel(ann)" class="ann-layer">{{ layerLabel(ann) }}</span>
+              </div>
+              <div class="ann-entry-body">
+                <div v-if="getSegment(ann)" class="ann-pron-h"><PronunciationGroup :segment="getSegment(ann)!" /></div>
+                <div v-if="ann.text && ann.kind !== 'pronunciation'" class="ann-text">{{ ann.text }}</div>
+              </div>
             </div>
           </div>
+          <div v-if="headword" class="ann-sheet-v-head" :class="dominantKind()">
+            <span class="ann-sheet-v-word">{{ headword }}</span>
+            <span v-if="annotations.length > 1" class="ann-badge-count-v">{{ annotations.length }}</span>
+          </div>
         </div>
       </div>
     </Transition>
@@ -467,50 +473,69 @@ onBeforeUnmount(() => {
   line-height: 2;
 }
 
-.ann-sheet.vertical {
-  writing-mode: vertical-rl;
-  text-orientation: mixed;
-  flex-direction: row;
+.ann-sheet-body {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  min-height: 0;
 }
 
-.ann-sheet.vertical .ann-sheet-handle {
-  writing-mode: horizontal-tb;
-  position: absolute;
-  top: 0;
-  left: 0;
-  right: 0;
-  padding: 6px 0 0;
-  z-index: 1;
+.ann-sheet-body.vertical {
+  flex-direction: row-reverse;
 }
 
-.ann-sheet.vertical .ann-sheet-head {
-  writing-mode: horizontal-tb;
+.ann-sheet-body.vertical > .ann-sheet-head {
+  display: none;
 }
 
-.ann-sheet.vertical .ann-sheet-scroll {
-  display: flex;
-  flex-direction: column;
-  overflow-x: auto;
-  overflow-y: hidden;
-  padding: 8px 0 24px;
+.ann-sheet-body:not(.vertical) > .ann-sheet-v-head {
+  display: none;
 }
 
-.ann-sheet.vertical .ann-entry {
+.ann-sheet-v-head {
+  writing-mode: vertical-rl;
+  text-orientation: upright;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 8px;
+  padding: 12px 10px;
+  border-left: 1px solid var(--border-light);
   flex-shrink: 0;
-  border-bottom: none;
-  padding: 0 14px;
-  border-right: 1px solid var(--border-light);
 }
 
-.ann-sheet.vertical .ann-entry:first-child {
-  border-right: none;
+.ann-sheet-v-word {
+  font-family: var(--serif);
+  font-size: 20px;
+  font-weight: 900;
+  letter-spacing: 6px;
+  color: var(--ink);
+}
+
+.ann-badge-count-v {
+  font-family: var(--sans);
+  font-size: 11px;
+  font-weight: 700;
+  color: var(--ink-faint);
+  background: var(--surface-warm);
+  border: 1px solid var(--border-light);
+  border-radius: 10px;
+  padding: 2px 8px;
+  letter-spacing: 0;
+  writing-mode: horizontal-tb;
+}
+
+.ann-sheet-body.vertical .ann-sheet-scroll {
+  flex: 1;
+  min-width: 0;
 }
 
-.ann-sheet.vertical .ann-pron-h {
+.ann-sheet-body.vertical .ann-pron-h {
   writing-mode: horizontal-tb;
 }
 
-.ann-sheet.vertical .ann-text {
+.ann-sheet-body.vertical .ann-text {
   white-space: pre-line;
   line-height: 2;
 }

package/template/src/components/BackToTop.vue

@@ -48,18 +48,20 @@ onUnmounted(() => window.removeEventListener('scroll', onScroll))
   align-items: center;
   justify-content: center;
   box-shadow: 0 4px 16px rgba(var(--shadow-rgb), 0.1);
-  transition: all 0.25s cubic-bezier(0.34, 1.56, 0.64, 1);
+  transition: all 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
+  backdrop-filter: blur(8px);
+  -webkit-backdrop-filter: blur(8px);
 }
 
 @media (max-width: 768px) {
   .btt { bottom: 88px; right: 16px; width: 36px; height: 36px; }
 }
 .btt:hover {
-  background: var(--ink);
-  color: var(--paper);
-  border-color: var(--ink);
-  transform: translateY(-2px);
-  box-shadow: 0 8px 24px rgba(var(--shadow-rgb), 0.16);
+  background: var(--vermillion);
+  color: #fff;
+  border-color: var(--vermillion);
+  transform: translateY(-3px);
+  box-shadow: 0 8px 24px rgba(194, 58, 43, 0.2);
 }
 
 .btt-enter-active { transition: all 0.3s cubic-bezier(0.34, 1.56, 0.64, 1); }

package/template/src/components/HorizontalDisplay.vue

@@ -44,7 +44,8 @@ function onTap(event: MouseEvent) {
     <div
       v-for="(_, i) in verses"
       :key="i"
-      class="h-display-line"
+      class="h-display-line h-verse-anim"
+      :style="{ animationDelay: (0.15 + i * 0.08) + 's' }"
       v-html="verseHtml(i)"
     />
   </div>
@@ -59,6 +60,7 @@ function onTap(event: MouseEvent) {
   padding: 40px 56px;
   box-shadow: 0 4px 16px rgba(var(--shadow-rgb), 0.08);
   text-align: center;
+  animation: poemReveal 0.5s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1)) both;
 }
 .h-display-title {
   font-size: 32px; font-weight: 900;
@@ -73,18 +75,30 @@ function onTap(event: MouseEvent) {
   font-size: var(--main-font-size, 24px); line-height: 2.6;
   letter-spacing: 4px; color: var(--ink);
 }
+.h-verse-anim {
+  animation: verseFade 0.45s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1)) both;
+}
+@keyframes poemReveal {
+  from { opacity: 0; transform: translateY(16px) scale(0.98); }
+  to { opacity: 1; transform: translateY(0) scale(1); }
+}
+@keyframes verseFade {
+  from { opacity: 0; transform: translateY(8px); }
+  to { opacity: 1; transform: translateY(0); }
+}
 
 :deep(.ann-target) {
   border-bottom: 2px solid var(--vermillion);
   cursor: help;
-  transition: background 0.15s;
+  transition: background 0.2s ease, box-shadow 0.2s ease;
 }
 :deep(.ann-target.ann-overlap) {
   border-bottom-width: 3px;
   border-bottom-style: double;
 }
 :deep(.ann-target:hover) {
-  background: rgba(194, 58, 43, 0.08);
+  background: rgba(194, 58, 43, 0.1);
+  box-shadow: 0 2px 8px rgba(194, 58, 43, 0.08);
 }
 :deep(.ann-num) {
   font-size: 10px;
@@ -96,7 +110,8 @@ function onTap(event: MouseEvent) {
   letter-spacing: 0;
 }
 :deep(.ann-target.pronunciation:hover) {
-  background: rgba(58, 107, 94, 0.08);
+  background: rgba(58, 107, 94, 0.1);
+  box-shadow: 0 2px 8px rgba(58, 107, 94, 0.08);
 }
 :deep(.ann-target.pronunciation) {
   border-bottom-color: var(--jade);
@@ -117,19 +132,24 @@ function onTap(event: MouseEvent) {
   border-bottom-color: var(--ann-allusion);
 }
 :deep(.ann-target.person:hover) {
-  background: rgba(58, 90, 140, 0.08);
+  background: rgba(58, 90, 140, 0.1);
+  box-shadow: 0 2px 8px rgba(58, 90, 140, 0.08);
 }
 :deep(.ann-target.place:hover) {
-  background: rgba(139, 105, 20, 0.08);
+  background: rgba(139, 105, 20, 0.1);
+  box-shadow: 0 2px 8px rgba(139, 105, 20, 0.08);
 }
 :deep(.ann-target.event:hover) {
-  background: rgba(107, 76, 138, 0.08);
+  background: rgba(107, 76, 138, 0.1);
+  box-shadow: 0 2px 8px rgba(107, 76, 138, 0.08);
 }
 :deep(.ann-target.date:hover) {
-  background: rgba(42, 122, 122, 0.08);
+  background: rgba(42, 122, 122, 0.1);
+  box-shadow: 0 2px 8px rgba(42, 122, 122, 0.08);
 }
 :deep(.ann-target.allusion:hover) {
-  background: rgba(181, 101, 29, 0.08);
+  background: rgba(181, 101, 29, 0.1);
+  box-shadow: 0 2px 8px rgba(181, 101, 29, 0.08);
 }
 
 @media (max-width: 768px) {

package/template/src/components/PoemCard.vue

@@ -40,15 +40,16 @@ const preview = computed(() => {
   position: absolute;
   top: 0; left: 0;
   width: 3px; height: 0;
-  background: var(--vermillion);
-  transition: height 0.3s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
+  background: linear-gradient(180deg, var(--vermillion), var(--gold));
+  transition: height 0.35s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
 }
 .pc-root:hover {
-  transform: translateY(-2px);
-  box-shadow: 0 8px 32px rgba(var(--shadow-rgb), 0.08);
+  transform: translateY(-3px);
+  box-shadow: 0 8px 28px rgba(var(--shadow-rgb), 0.1);
   border-color: var(--gold);
 }
 .pc-root:hover .pc-accent { height: 100%; }
+.pc-root:hover .pc-title { color: var(--vermillion); }
 .pc-root:active { transform: scale(0.98); }
 .pc-body { padding: 24px; }
 .pc-num {
@@ -67,6 +68,7 @@ const preview = computed(() => {
   font-size: 20px; font-weight: 700;
   letter-spacing: 2px; margin-bottom: 6px;
   color: var(--ink);
+  transition: color 0.25s ease;
 }
 .pc-author {
   font-size: 13px; color: var(--ink-light);
@@ -130,6 +132,7 @@ const preview = computed(() => {
 .pc-vertical .pc-accent {
   top: auto; left: 0; bottom: 0;
   width: 0; height: 3px;
+  background: linear-gradient(90deg, var(--gold), var(--vermillion));
   transition: width 0.35s ease;
 }
 .pc-vertical:hover {

package/template/src/components/ReadingProgress.vue

@@ -69,18 +69,18 @@ onUnmounted(detach)
   z-index: 1001;
   pointer-events: none;
   will-change: width, height;
-  transition: width 0.1s ease, height 0.1s ease;
+  transition: width 0.08s linear, height 0.08s linear;
 }
 .rp:not(.rp-v) {
   top: 0; left: 0;
-  height: 2px;
-  background: var(--vermillion);
-  box-shadow: 0 0 8px rgba(194, 58, 43, 0.3);
+  height: 3px;
+  background: linear-gradient(90deg, var(--vermillion), var(--gold));
+  box-shadow: 0 0 8px rgba(194, 58, 43, 0.2);
 }
 .rp-v {
   top: 0; left: 0;
-  width: 2px;
-  background: var(--vermillion);
-  box-shadow: 0 0 8px rgba(194, 58, 43, 0.3);
+  width: 3px;
+  background: linear-gradient(180deg, var(--vermillion), var(--gold));
+  box-shadow: 0 0 8px rgba(194, 58, 43, 0.2);
 }
 </style>

package/template/src/components/SectionBlock.vue

@@ -89,8 +89,8 @@ const paragraphsHtml = computed(() => {
 .sb-root {
   margin-bottom: 40px;
   opacity: 0;
-  transform: translateY(12px);
-  transition: opacity 0.5s ease, transform 0.5s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
+  transform: translateY(16px);
+  transition: opacity 0.6s ease, transform 0.6s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
 }
 .sb-root.sb-visible {
   opacity: 1;

package/template/src/components/VerticalScroll.vue

@@ -47,7 +47,8 @@ function onTap(event: MouseEvent) {
       <span
         v-for="(_, i) in verses"
         :key="i"
-        class="v-scroll-line"
+        class="v-scroll-line v-verse-anim"
+        :style="{ animationDelay: (0.2 + i * 0.06) + 's' }"
         v-html="verseHtml(i)"
       />
     </div>
@@ -68,6 +69,7 @@ function onTap(event: MouseEvent) {
   position: relative;
   scrollbar-width: thin;
   scrollbar-color: var(--gold) transparent;
+  animation: poemRevealV 0.5s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1)) both;
 }
 .v-scroll::-webkit-scrollbar { height: 3px; }
 .v-scroll::-webkit-scrollbar-thumb { background: var(--gold); border-radius: 2px; }
@@ -89,12 +91,23 @@ function onTap(event: MouseEvent) {
   font-size: var(--main-font-size, 24px); line-height: 2.4; letter-spacing: 6px;
   color: var(--ink); display: block;
 }
+.v-verse-anim {
+  animation: verseFadeV 0.4s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1)) both;
+}
+@keyframes poemRevealV {
+  from { opacity: 0; transform: translateX(12px); }
+  to { opacity: 1; transform: translateX(0); }
+}
+@keyframes verseFadeV {
+  from { opacity: 0; }
+  to { opacity: 1; }
+}
 
 :deep(.ann-target) {
   border-left: 2px solid var(--vermillion);
   padding-left: 2px;
   cursor: help;
-  transition: background 0.15s;
+  transition: background 0.2s ease, box-shadow 0.2s ease;
 }
 :deep(.ann-target.ann-overlap) {
   border-left-width: 3px;
@@ -115,10 +128,12 @@ function onTap(event: MouseEvent) {
   letter-spacing: -1px;
 }
 :deep(.ann-target:hover) {
-  background: rgba(194, 58, 43, 0.08);
+  background: rgba(194, 58, 43, 0.1);
+  box-shadow: 0 -2px 8px rgba(194, 58, 43, 0.08);
 }
 :deep(.ann-target.pronunciation:hover) {
-  background: rgba(58, 107, 94, 0.08);
+  background: rgba(58, 107, 94, 0.1);
+  box-shadow: 0 -2px 8px rgba(58, 107, 94, 0.08);
 }
 :deep(.ann-target.pronunciation) {
   border-left-color: var(--jade);
@@ -142,18 +157,23 @@ function onTap(event: MouseEvent) {
   border-left-color: var(--ann-allusion);
 }
 :deep(.ann-target.person:hover) {
-  background: rgba(58, 90, 140, 0.08);
+  background: rgba(58, 90, 140, 0.1);
+  box-shadow: 0 -2px 8px rgba(58, 90, 140, 0.08);
 }
 :deep(.ann-target.place:hover) {
-  background: rgba(139, 105, 20, 0.08);
+  background: rgba(139, 105, 20, 0.1);
+  box-shadow: 0 -2px 8px rgba(139, 105, 20, 0.08);
 }
 :deep(.ann-target.event:hover) {
-  background: rgba(107, 76, 138, 0.08);
+  background: rgba(107, 76, 138, 0.1);
+  box-shadow: 0 -2px 8px rgba(107, 76, 138, 0.08);
 }
 :deep(.ann-target.date:hover) {
-  background: rgba(42, 122, 122, 0.08);
+  background: rgba(42, 122, 122, 0.1);
+  box-shadow: 0 -2px 8px rgba(42, 122, 122, 0.08);
 }
 :deep(.ann-target.allusion:hover) {
-  background: rgba(181, 101, 29, 0.08);
+  background: rgba(181, 101, 29, 0.1);
+  box-shadow: 0 -2px 8px rgba(181, 101, 29, 0.08);
 }
 </style>

package/template/src/styles/main.css

@@ -141,6 +141,23 @@ html[dir="rtl"] ::-webkit-scrollbar-thumb { background: var(--gold); }
 a { color: inherit; text-decoration: none; }
 button { font-family: inherit; }
 
+/* ===== FOCUS STYLES ===== */
+:focus-visible {
+  outline: 2px solid var(--vermillion);
+  outline-offset: 2px;
+}
+button:focus-visible {
+  outline: 2px solid var(--vermillion);
+  outline-offset: 2px;
+  border-radius: 4px;
+}
+
+/* ===== ACTIVE ANNOTATION FLASH ===== */
+@keyframes ann-flash-anim {
+  0% { background: rgba(194, 58, 43, 0.25); box-shadow: 0 0 12px rgba(194, 58, 43, 0.15); }
+  100% { background: transparent; box-shadow: none; }
+}
+
 /* ===== LOADING SCREEN ===== */
 #app-loading {
   position: fixed; inset: 0;
@@ -148,10 +165,11 @@ button { font-family: inherit; }
   display: flex; flex-direction: column;
   align-items: center; justify-content: center;
   z-index: 9999;
-  transition: opacity 0.4s ease;
+  transition: opacity 0.5s ease, transform 0.5s ease;
 }
 #app-loading.fade-out {
   opacity: 0;
+  transform: scale(1.02);
   pointer-events: none;
 }
 #app-loading .seal {

package/template/src/views/LibraryHome.vue

@@ -354,15 +354,17 @@ function openBook(bookId: string) {
   from { opacity: 0; transform: translateY(12px); }
   to { opacity: 1; transform: translateY(0); }
 }
-.lib-card:hover { border-color: var(--gold); box-shadow: 0 4px 20px rgba(var(--shadow-rgb), 0.1); }
+.lib-card:hover { border-color: var(--gold); box-shadow: 0 6px 24px rgba(var(--shadow-rgb), 0.1); transform: translateY(-2px); }
+.lib-card:active { transform: scale(0.98); }
 .lib-card-accent {
   position: absolute;
   top: 0; left: 0;
   width: 3px; height: 0;
-  background: var(--vermillion);
-  transition: height 0.35s ease;
+  background: linear-gradient(180deg, var(--vermillion), var(--gold));
+  transition: height 0.35s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
 }
 .lib-card:hover .lib-card-accent { height: 100%; }
+.lib-card:hover .lib-card-title { color: var(--vermillion); }
 .lib-card-top {
   display: flex;
   align-items: baseline;
@@ -372,6 +374,7 @@ function openBook(bookId: string) {
 .lib-card-title {
   font-size: 22px; font-weight: 900;
   letter-spacing: 4px; color: var(--ink);
+  transition: color 0.25s ease;
 }
 .lib-card-genre {
   font-size: 11px;

package/template/src/views/PieceView.vue

@@ -846,13 +846,26 @@ function tcy(n: number): string {
   border: 1px solid var(--border-light);
   border-radius: 6px;
   cursor: pointer;
-  transition: all 0.2s;
+  transition: all 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
   line-height: 1.6;
+  position: relative;
+  overflow: hidden;
+}
+.v-nav-btn::after {
+  content: '';
+  position: absolute;
+  right: 0; top: 0; bottom: 0;
+  width: 2px;
+  background: linear-gradient(180deg, var(--gold), var(--vermillion));
+  transform: scaleY(0);
+  transition: transform 0.35s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
 }
 .v-nav-btn:hover {
   border-color: var(--gold);
-  box-shadow: 0 4px 16px rgba(var(--shadow-rgb), 0.08);
+  box-shadow: 0 4px 20px rgba(var(--shadow-rgb), 0.1);
 }
+.v-nav-btn:hover::after { transform: scaleY(1); }
+.v-nav-btn:hover .v-nav-title { color: var(--vermillion); }
 .v-nav-dir {
   font-size: 16px; color: var(--vermillion);
   margin-bottom: 0.5em;
@@ -865,6 +878,7 @@ function tcy(n: number): string {
 .v-nav-title {
   font-size: 18px; font-weight: 700;
   letter-spacing: 3px; color: var(--ink);
+  transition: color 0.25s ease;
 }
 
 /* ═══════ 橫排模式 ═══════ */
@@ -950,7 +964,7 @@ function tcy(n: number): string {
 .h-nav-arrow {
   width: 32px; height: 32px;
   border: 1px solid var(--border);
-  border-radius: 4px;
+  border-radius: 6px;
   background: none;
   font-family: var(--sans);
   font-size: 16px;
@@ -1026,20 +1040,21 @@ function tcy(n: number): string {
   position: absolute;
   bottom: 0; left: 0; right: 0;
   height: 2px;
-  background: var(--vermillion);
+  background: linear-gradient(90deg, var(--vermillion), var(--gold));
   transform: scaleX(0);
-  transition: transform 0.3s ease;
+  transition: transform 0.35s var(--ease-out-expo, cubic-bezier(0.16, 1, 0.3, 1));
 }
 .h-nav-btn:hover {
   border-color: var(--gold);
   box-shadow: 0 8px 32px rgba(var(--shadow-rgb), 0.1);
-  transform: translateY(-2px);
+  transform: translateY(-3px);
 }
 .h-nav-btn:hover::after { transform: scaleX(1); }
+.h-nav-btn:hover .h-nav-title { color: var(--vermillion); }
 .h-nav-btn:active { transform: scale(0.98); }
 .h-nav-btn.h-nav-next { text-align: right; }
 .h-nav-label { font-size: 11px; color: var(--ink-faint); font-family: var(--sans); letter-spacing: 2px; margin-bottom: 4px; }
-.h-nav-title { font-size: 16px; font-weight: 600; letter-spacing: 1px; color: var(--ink); }
+.h-nav-title { font-size: 16px; font-weight: 600; letter-spacing: 1px; color: var(--ink); transition: color 0.25s ease; }
 
 .h-overlay {
   position: fixed; inset: 0;
@@ -1335,11 +1350,11 @@ function tcy(n: number): string {
 
 /* ─── 注釋閃爍 ─── */
 :deep(.ann-flash) {
-  animation: ann-flash-anim 1.2s ease-out;
+  animation: ann-flash-anim 1.5s ease-out;
 }
 @keyframes ann-flash-anim {
-  0% { background: rgba(194, 58, 43, 0.2); }
-  100% { background: transparent; }
+  0% { background: rgba(194, 58, 43, 0.25); box-shadow: 0 0 12px rgba(194, 58, 43, 0.15); }
+  100% { background: transparent; box-shadow: none; }
 }
 
 /* ═══════ 行動裝置適配 ═══════ */