@waterwx/dsh-novel-forge 2.1.4 → 2.1.5

package/lib/types/client/panel/CardHead.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 卡片区块页头：「标题 + 计数 + 一句说明 + 右侧动作」的唯一样式源。
+ *
+ * 为什么需要它：审查发现同一个语义（卡片首行当页头）在面板里被手写了 19 遍，
+ * 内联样式出现 8 种变体（`justifyContent: space-between` / 少 `flexWrap` /
+ * 少 `alignItems` / `gap` 有 6、8、无 三档），导致同一层级的区块标题在垂直节奏上
+ * 肉眼可见地参差不齐。收敛到这一个组件后，标题层级、对齐、换行策略只有一处定义。
+ *
+ * 与 `PageHeader` 的分工：
+ *   - `PageHeader` = 视图级页头（每视图仅一个，大号衬线标题 + eyebrow）
+ *   - `CardHead`   = 区块级页头（视图内多张卡的首行，小号、无 eyebrow）
+ * 两级只此两级，不再有第三种「行内 span 当标题」的写法。
+ */
+import type { ReactNode } from 'react';
+export interface CardHeadProps {
+    /** 区块标题（必填）。用短语而非句子。 */
+    title: ReactNode;
+    /** 计数后缀，例如 `（12）`。已含括号，避免调用方各写各的中英文标点。 */
+    count?: string | number;
+    /** 标题右侧的一句 meta（弱色、12px、可省略）。 */
+    note?: ReactNode;
+    /** 右侧动作区（按钮 / 下拉 / 切换）。 */
+    actions?: ReactNode;
+    /** 大号标题（该卡片是本视图唯一主体时用，避免小标题显得寒酸）。 */
+    large?: boolean;
+    /** 左侧 lucide 图标（16px 单色）。 */
+    icon?: ReactNode;
+}
+export declare function CardHead({ title, count, note, actions, large, icon }: CardHeadProps): JSX.Element;
+/**
+ * 两端对齐行：把 8 种内联变体收成一个类。
+ * 用于「左右两端放东西但左边不是标题」的场景（纯布局，不构成页头层级）。
+ */
+export declare function RowBetween({ wrap, align, gap, children }: {
+    /** 窄容器下是否换行（默认换行：宁可两行也不裁切）。 */
+    wrap?: boolean;
+    /** 垂直对齐方式。 */
+    align?: 'center' | 'baseline' | 'flex-start';
+    /** 间距档（默认 8）。 */
+    gap?: 6 | 8 | 12;
+    children: ReactNode;
+}): JSX.Element;

package/lib/types/client/panel/ConfirmDialog.d.ts

@@ -0,0 +1,36 @@
+export type ConfirmTone = 'danger' | 'warn' | 'info';
+export interface ConfirmSpec {
+    /** 弹窗标题：一句话说清要做什么。 */
+    title: string;
+    /** 后果说明：到底会发生什么、什么会保留。 */
+    body: React.ReactNode;
+    /** 逐条列出的影响面。 */
+    effects?: string[];
+    /** 承诺：如「原稿会先自动备份为 .bak，可再换回来」。 */
+    assurance?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    tone?: ConfirmTone;
+    /** 需要逐字输入的确认词；给出时用户必须输入一致才能确认。 */
+    requirePhrase?: string;
+    /** 真正的动作。抛错时弹窗不关，就地显示错误并可重试。 */
+    onConfirm: () => void | Promise<void>;
+}
+export declare function ConfirmDialog({ spec, onCancel, onDone }: {
+    spec: ConfirmSpec;
+    onCancel: () => void;
+    onDone: () => void;
+}): JSX.Element;
+/**
+ * 用法（替代 window.confirm）：
+ *   const confirm = useConfirm()
+ *   confirm({ title: '…', body: '…', tone: 'danger', onConfirm: async () => { await api.x() } })
+ *   // …并在 JSX 里渲染 {confirm.dialog}
+ *
+ * 动作用回调传入（而不是 resolve(true) 后由调用方自己跑），这样执行失败时
+ * 弹窗能留在原地显示错误并提供重试 —— 不会退化成「关掉弹窗 + 一句红字」。
+ */
+export declare function useConfirm(): {
+    confirm: (spec: ConfirmSpec) => void;
+    dialog: JSX.Element | null;
+};

package/lib/types/client/panel/NoticeBar.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 通知条（notice / error 统一出口）——取代此前 4 个视图各写一处的内联 notice/error。
+ *
+ * 为什么要这个组件（不是又一层抽象）：
+ *   1. 此前 TensionView / StyleView / TimelineView / PromptSlotsView 各写一套，
+ *      且 success 与 error 共用同一个未定义的 var(--nf-text-12) → 字号静默失效，
+ *      两者视觉权重完全一样，「成功」和「失败」在屏幕上长得一样。
+ *   2. 错误态只有一行红字。作者最痛的时刻不是失败，是「失败了不知道还能怎么办」，
+ *      所以这里强制 error 形态带上「发生了什么 + 怎么办」，并把重试摆在同一行。
+ *   3. 颜色走 --nf-*-ink 文字版令牌（见 panel.module.css 注释）：图形版语义色
+ *      （--nf-success #34c759 等）在浅色四档纸面上只有 1.98~3.20:1，不能当文字用。
+ */
+import type { ReactNode } from 'react';
+export type NoticeKind = 'ok' | 'error' | 'warn' | 'info';
+export declare function NoticeBar({ kind, children, onRetry, retryLabel, detail, actions }: {
+    kind: NoticeKind;
+    /** 主文案：一句话说清发生了什么。 */
+    children: ReactNode;
+    /** 次要说明：补充上下文（错误码、影响范围、下一步提示）。 */
+    detail?: ReactNode;
+    /** 重试回调。给了就在同一行显示重试按钮 —— 不给才是真的没救。 */
+    onRetry?: () => void;
+    retryLabel?: string;
+    /** 其他补救动作（如「换个模型再试」）。 */
+    actions?: ReactNode;
+}): JSX.Element;

package/lib/types/client/panel/Sparkline.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 指标条内嵌迷你走势图（sparkline）：把「一堆数字」变成「一条形状」。
+ *
+ * 为什么需要它：总编台四个常驻指标原本全是纯数字。作者看到「全书字数 87,431」
+ * 无法判断形状 —— 33 章是均匀分布的，还是前 5 章写了六成、中间塌了十章？
+ * sparkline 让「节奏」变成一眼可见的形态，而不需要点进任何视图。
+ *
+ * 设计约束（避免图表挤进 12px 高的指标格后反而变噪）：
+ *   - 不画坐标轴、不画网格、不画标签：只有形状；每根柱自带悬停提示给出该章字数，
+ *     峰值等形态解读由 describeShape() 以文字提供。
+ *   - 柱高按 max 归一化，0 字章节画成基线上的 1px 短横（"这一章还没写"）。
+ *   - 已过审 / 未过审用两套填充区分，替代图例文字。
+ *   - 纯装饰性趋势：aria-hidden，真正的数据在相邻的 <b> 数字里，已由读屏播报。
+ */
+export interface SparkPoint {
+    /** 章节号（仅用于 title 提示）。 */
+    no: number;
+    /** 该章字数。 */
+    chars: number;
+    /** 是否已过审 —— 决定用「过审色」还是「待定色」填充。 */
+    approved: boolean;
+}
+export interface SparklineProps {
+    points: SparkPoint[];
+    /** 无数据时的替代文本（例如「尚未开写」）。 */
+    emptyHint?: string;
+}
+/** 迷你柱状走势。宽固定 132、高 26，用 viewBox 缩放以适配窄容器。 */
+export declare function Sparkline({ points, emptyHint }: SparklineProps): JSX.Element;
+/**
+ * 形态解读：把序列讲成一句人话，给 sparkline 当无障碍替代与悬停提示。
+ * 不新增数据，只描述现有分布 —— 目的是让作者知道「该看哪里」而不是给结论。
+ */
+export declare function describeShape(points: SparkPoint[]): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@waterwx/dsh-novel-forge",
   "description": "AI 编译纯文本小说工作台 for the dsh web GUI: import a novel outline (docx/text), plan volumes & chapters with LLM, generate chapter by chapter (3000-4000 chars each), auto AI review & book audit, and export the full book as Markdown/TXT into your chosen output folder.",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "type": "module",
   "author": "waterwx",
   "repository": {
@@ -111,6 +111,9 @@
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit",
     "check:styles": "node scripts/check-theme-sizes.mjs",
+    "check:vars": "node scripts/check-css-vars.mjs",
+    "check:dead-classes": "node scripts/check-dead-classes.mjs",
+    "check:fallback": "node scripts/check-fallback-tiers.mjs",
     "check:third-party": "node scripts/check-third-party.mjs",
     "check:contrast": "node scripts/audit-contrast.mjs",
     "check:third-party:list": "node scripts/check-third-party.mjs --list",