@waterwx/dsh-novel-forge 0.1.0

package/src/client/panel/controller.ts

@@ -0,0 +1,45 @@
+/**
+ * Novel-forge panel controller: the single owner of the panel's open/closed
+ * state (framework-free, mirroring the family plugins' controllers).
+ */
+
+/** Immutable controller snapshot for UI subscriptions. */
+export interface PanelControllerSnapshot {
+  panelOpen: boolean
+}
+
+/** The panel state owner the sidebar entry toggles and the view renders from. */
+export class PanelController {
+  private panelOpen = false
+  private listeners = new Set<() => void>()
+
+  getSnapshot(): PanelControllerSnapshot {
+    return { panelOpen: this.panelOpen }
+  }
+
+  subscribe(fn: () => void): () => void {
+    this.listeners.add(fn)
+    return () => { this.listeners.delete(fn) }
+  }
+
+  open(): void {
+    if (this.panelOpen) return
+    this.panelOpen = true
+    this.notify()
+  }
+
+  close(): void {
+    if (!this.panelOpen) return
+    this.panelOpen = false
+    this.notify()
+  }
+
+  toggle(): void {
+    if (this.panelOpen) this.close()
+    else this.open()
+  }
+
+  private notify(): void {
+    for (const fn of [...this.listeners]) fn()
+  }
+}

package/src/client/panel/helpers.ts

@@ -0,0 +1,17 @@
+/**
+ * Tiny translation helper for the panel: reads the zh dict with the en dict
+ * as fallback (the family plugins use a full locale registry; the panel keeps
+ * a dependency-free helper so the client bundle stays self-contained).
+ */
+import { zh, en, type NovelKey } from '../locales.ts'
+
+/** Translate one key with optional {placeholder} substitution. */
+export function tt(key: NovelKey, params?: Record<string, string | number>): string {
+  let text: string = zh[key] ?? en[key] ?? key
+  if (params !== undefined) {
+    for (const [name, value] of Object.entries(params)) {
+      text = text.replaceAll(`{${name}}`, String(value))
+    }
+  }
+  return text
+}