@waterwx/dsh-novel-forge 1.2.0 → 1.2.1-alpha

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

@@ -0,0 +1,34 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+import { type ProgressLine } from './ProgressConsole.tsx';
+export declare function AuthorHome({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onBackground, progress, busy, busyLabel, liveBar, onClearProgress, onUseIdea, themeMode, themeDensity, onToggleMode, onChangeThemeMode, onChangeThemeDensity }: {
+    /** 当前显示模式（顶栏「墨纸 / 纸白」切换用）。 */
+    themeMode?: 'system' | 'light' | 'dark';
+    /** 当前界面密度。 */
+    themeDensity?: 'comfort' | 'compact' | 'spacious';
+    /** 切换墨纸 / 纸白（由 NovelPanel 落 localStorage）。 */
+    onToggleMode?: () => void;
+    /** 改变全局显示模式（联动整个面板）。 */
+    onChangeThemeMode: (m: 'system' | 'light' | 'dark') => void;
+    /** 改变全局界面密度（联动整个面板）。 */
+    onChangeThemeDensity: (d: 'comfort' | 'compact' | 'spacious') => void;
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+    onReadBook: (id: string) => void;
+    onAddBook: () => void;
+    onImportBook: () => void;
+    /** 创意灵感 → 采纳某个灵感带入开书向导。 */
+    onUseIdea?: (idea: import('../../protocol.ts').IdeaInspirationResult['ideas'][number]) => void;
+    /** 自定义背景变化回调。 */
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** AI 进度实时状态（与书内共享同一份）。 */
+    progress?: ProgressLine[];
+    busy?: boolean;
+    busyLabel?: string;
+    liveBar?: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClearProgress?: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export default function BookAnalysisView({ api }: {
+    api: NovelApi;
+}): JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { ReactElement } from 'react';
+export interface CmdAction {
+    icon: string;
+    label: string;
+    hint?: string;
+    run: () => void;
+}
+export declare function CmdPalette({ open, onClose, actions }: {
+    open: boolean;
+    onClose: () => void;
+    actions: CmdAction[];
+}): ReactElement | null;

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

@@ -1,9 +1,13 @@
 import type { NovelApi } from '../api.ts';
 /** 开书向导页。 */
-export declare function CreateBookView({ api, onBack, onCreated, }: {
+export declare function CreateBookView({ api, onBack, onCreated, initialIdea, initialName, }: {
     api: NovelApi;
     /** 返回书架。 */
     onBack: () => void;
     /** 开书成功：进入新书工作台。 */
     onCreated: (id: string) => void;
+    /** 从「创意灵感」带过来的起步想法（预填到「一句话想法」输入框）。 */
+    initialIdea?: string;
+    /** 从「创意灵感」带过来的初始书名。 */
+    initialName?: string;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+import type { DirectorTodo } from '../../protocol.ts';
+export default function DirectorView({ api, todos, onTodosChange }: {
+    api: NovelApi;
+    todos: DirectorTodo[];
+    onTodosChange?: (todos: DirectorTodo[]) => void;
+}): JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function GlobalAssetLibraryView({ api }: {
+    api: NovelApi;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,6 @@
+import type { NovelApi } from '../api.ts';
+import type { IdeaInspirationResult } from '../../protocol.ts';
+export default function IdeaInspirationView({ api, onUseIdea }: {
+    api: NovelApi;
+    onUseIdea?: (idea: IdeaInspirationResult['ideas'][number]) => void;
+}): JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+export declare function ImportModal({ api, onClose, onImported, }: {
+    api: NovelApi;
+    onClose: () => void;
+    /** 导入成功并已激活该书后回调（刷新书架）。 */
+    onImported: () => void | Promise<void>;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export default function KnowledgeBaseView({ api }: {
+    api: NovelApi;
+}): JSX.Element;

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

@@ -0,0 +1,8 @@
+/**
+ * 「实时调用 / LIVE」—— 内嵌到 AI 进度窗的下半区（详情层），不再独立浮窗。
+ * 连接 /llm-live/stream，按 LLM 调用分组展示模型实时输出。
+ *
+ * 状态色全部走 panel.module.css 的 .lfPill / .lfDot（主题令牌 + --nf-streaming），
+ * 不再内联硬编码色；布局性 inline style 保留（均为令牌引用或动态值）。
+ */
+export default function LiveFeedLog(): JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export default function MarketRadarView({ api, bookId }: {
+    api: NovelApi;
+    bookId?: string;
+}): JSX.Element;

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

@@ -0,0 +1,14 @@
+import type { NovelApi } from '../api.ts';
+import type { SavedModel } from '../../protocol.ts';
+/** 目录不可用时回退的内置预设（历史行为）。 */
+export declare const FALLBACK_MODEL_PRESETS: readonly ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat", "deepseek-reasoner"];
+export interface ModelManagerProps {
+    api: NovelApi;
+    provider: string;
+    model: string;
+    savedModels: SavedModel[];
+    onProvider: (provider: string) => void;
+    onModel: (model: string) => void;
+    onSavedModels: (models: SavedModel[]) => void;
+}
+export declare function ModelManager({ api, provider, model, onProvider, onModel }: ModelManagerProps): JSX.Element;

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

@@ -1,7 +1,12 @@
 import type { NovelApi } from '../api.ts';
 import type { PanelController } from './controller.ts';
+/**
+ * 面板宽度低于此值时自动折叠左侧导航。
+ * 依据：.panelNav 占 216px，内容区留到 ~680px 才不至于把正文挤成竖排。
+ * 宿主中列宽度 ≠ 视口宽度（用户可拖拽侧边栏），所以必须用实测宽度而非媒体查询。
+ */
 /** The panel's tab identifiers. */
-export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'storyboard' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'book' | 'assets';
+export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'director' | 'knowledge' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'book' | 'assets';
 /** Panel shell props. */
 export interface NovelPanelProps {
     /** The panel state owner (open/close/toggle). */

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

@@ -0,0 +1,18 @@
+/** 墨案统一页头：eyebrow(11 大写窄) + 衬线大标题 + 一句说明 + 主/次动作。
+ *  每个视图只用一个 PageHeader，消灭"各自为政"的页面标题。
+ *  图标用 lucide 16 (单色)，标题旁禁止 emoji；标题用衬线 Display（书卷感）。 */
+import type { ReactNode } from 'react';
+export declare function PageHeader({ eyebrow, title, icon, sub, actions, right }: {
+    /** 页眉小标（大写窄，可选，如 "BOOKSHELF"）。 */
+    eyebrow?: string;
+    /** 页面大标题（衬线 Display）。 */
+    title: string;
+    /** lucide 图标（单色，16px），可选。 */
+    icon?: ReactNode;
+    /** 一句话辅助说明（meta）。 */
+    sub?: string;
+    /** 右侧主/次按钮组。 */
+    actions?: ReactNode;
+    /** 标题右上（如 AI 微签）。 */
+    right?: ReactNode;
+}): JSX.Element;

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

@@ -0,0 +1,17 @@
+export interface ProgressLine {
+    id: number;
+    text: string;
+    kind: 'info' | 'done' | 'error';
+    live?: boolean;
+    ratio?: number;
+}
+export declare function ProgressConsole({ progress, busy, busyLabel, liveBar, onClear }: {
+    progress: ProgressLine[];
+    busy: boolean;
+    busyLabel: string;
+    liveBar: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClear: () => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { BookshelfSnapshot } from '../../protocol.ts';
+export declare function ProgressHomeView({ shelf, onOpenBook }: {
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { NovelConfig } from '../../protocol.ts';
+export interface ReasoningSectionProps {
+    reasoningEffort: NovelConfig['reasoningEffort'];
+    analysisReasoning: NovelConfig['analysisReasoning'];
+    onChange: (patch: {
+        reasoningEffort?: NovelConfig['reasoningEffort'];
+        analysisReasoning?: NovelConfig['analysisReasoning'];
+    }) => void;
+}
+export declare function ReasoningSection({ reasoningEffort, analysisReasoning, onChange }: ReasoningSectionProps): JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { NovelApi } from '../api.ts';
+type SettingsTab = 'model' | 'files' | 'appearance';
+export declare function SettingsView({ api, variant, onSettingsTab, onEditorFontSize, onBackground, themeMode, themeDensity, onChangeThemeMode, onChangeThemeDensity }: {
+    api: NovelApi;
+    /** page = 全屏 SubPage（保留给旧入口）；drawer = 右滑抽屉内容（无壳）。 */
+    variant?: 'page' | 'drawer';
+    onSettingsTab?: (tab: SettingsTab) => void;
+    onEditorFontSize?: (n: number) => void;
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 全局显示模式（联动整个面板，NovelPanel 落 localStorage）。 */
+    themeMode: 'system' | 'light' | 'dark';
+    /** 全局界面密度。 */
+    themeDensity: 'comfort' | 'compact' | 'spacious';
+    /** 改变全局显示模式。 */
+    onChangeThemeMode: (m: 'system' | 'light' | 'dark') => void;
+    /** 改变全局界面密度。 */
+    onChangeThemeDensity: (d: 'comfort' | 'compact' | 'spacious') => void;
+}): import("react").JSX.Element;
+export {};

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

@@ -1,13 +1,24 @@
+/**
+ * 书架首页视图：书卡网格（封面/书名/简介/进度）+ 搜索筛选 + 开书入口。
+ * 进入小说工坊默认展示；点击书卡进入该书工作台，＋ 进入开书向导页。
+ */
+import { type ReactNode } from 'react';
 import type { NovelApi } from '../api.ts';
 import type { BookshelfSnapshot } from '../../protocol.ts';
 /** 书架首页。 */
-export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, }: {
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, onOpenAdapt, toolbarExtra, }: {
     api: NovelApi;
     shelf: BookshelfSnapshot;
+    /** 书架工具行右端插槽：组入口按钮由 AuthorHome 下放（创作 / 灵感策划 / 资产）。 */
+    toolbarExtra?: ReactNode;
     /** 点击书卡：激活该书并进入工作台。 */
     onOpenBook: (id: string) => void;
     /** 点击「阅读」：激活该书并进入沉浸式阅读页。 */
     onReadBook: (id: string) => void;
     /** 点击＋：进入开书向导页。 */
     onAddBook: () => void;
+    /** 点击「导入」：打开导入弹窗（已有项目目录 / txt/md 全本）。 */
+    onImportBook: () => void;
+    /** 点击「改编模式」：进入改编六步向导（入口收在书架页头，与导入并排）。 */
+    onOpenAdapt?: () => void;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+/**
+ * 统一子页骨架（1:1 对齐 demo-subpages.html 的 .subpage / .subpage-head / .subpage-body）。
+ *
+ * 所有作者级与书内子页都应套这层壳：
+ *   - head：返回钮（可选）+ 大标题 + meta + 右侧操作区
+ *   - body：页面内容（内部按 demo 用 .card / .box / .grid / .row 等块）
+ * 业务逻辑继续留在各自的 View 组件里，这里只负责「壳」。
+ */
+import type { ReactNode } from 'react';
+export declare function SubPage(props: {
+    /** 页面大标题（衬线 display 档）。 */
+    title: string;
+    /** 标题右侧的说明行（如「4 本书 · 当前书《X》」）。 */
+    meta?: ReactNode;
+    /** 返回钮：作者级返回书架，书内返回总编台。 */
+    back?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** 页头右侧操作区（主 CTA 放最右）。 */
+    actions?: ReactNode;
+    /** 主题系统局部模式（透传到根 div 的 data-nf-mode，供设置页等预览明暗）。 */
+    dataNfMode?: 'light' | 'dark';
+    /** 主题系统局部密度（透传到根 div 的 data-nf-density）。 */
+    dataNfDensity?: 'comfort' | 'compact' | 'spacious';
+    children: ReactNode;
+}): JSX.Element;

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

@@ -0,0 +1,2 @@
+/** 弹一条 toast。kind: 'done'（翡翠勾）/ 'error'（红叉）/ 'info'（中性）。 */
+export declare function showToast(text: string, kind?: 'done' | 'error' | 'info'): void;

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

@@ -1,9 +1,15 @@
-/**
- * 纯展示组件（views）：所有状态与事件处理器都留在 NovelPanel，
- * 这里只接收 props 渲染。便于单独维护与复用。
- */
 import type { ReactElement } from 'react';
 import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
+/** 滑轨胶囊导航（B5-5）：active 高亮为滑动指示块，随选中项平移。 */
+export declare function SlideNav<T extends string>(props: {
+    ariaLabel: string;
+    items: ReadonlyArray<{
+        id: T;
+        label: ReactElement | string;
+    }>;
+    active: T;
+    onSelect: (id: T) => void;
+}): JSX.Element;
 /** 统计格：状态摘要条 / 资产健康通用。 */
 export declare function StatCell(props: {
     label: string;
@@ -54,24 +60,36 @@ export declare function RoleCard(props: {
     onEdit: () => void;
     onRemove: () => void;
 }): ReactElement;
-/** 🩺 剧情健康检查报告面板。 */
+/**  剧情健康检查报告面板。 */
 export declare function PlotlineHealthPanel(props: {
     report: PlotlineHealthReport;
     disabled: boolean;
     onPlan: () => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 剧情方案面板。 */
+/**  剧情方案面板。 */
 export declare function PlotlinePlanPanel(props: {
     plan: PlotlinePlan;
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
-/** ✨ AI 建议剧情线面板。 */
+/**  建议剧情线面板。 */
 export declare function PlotlineSuggestionPanel(props: {
     suggestions: Plotline[];
     disabled: boolean;
     onAdopt: (suggestion: Plotline) => void;
     onClose: () => void;
 }): ReactElement;
+/** 空状态基元：图标 + 标题 + 可选提示。compact 变体用于列表/卡片内嵌场景。 */
+export declare function EmptyState(props: {
+    icon?: string;
+    title: string;
+    hint?: string;
+    compact?: boolean;
+}): ReactElement;
+/** 骨架屏基元：rows 条微光占位行；widths 指定各行宽度档位，循环取用。 */
+export declare function SkeletonLines(props: {
+    rows?: number;
+    widths?: Array<'full' | 'wide' | 'half'>;
+}): ReactElement;

package/lib/types/client/run-status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 运行状态芯片：固定在页面顶部的「小说工坊生成状态」小徽标。
+ * 轮询 /run/status，实时显示 生成中/暂停/完成/停止/出错 + 当前章号；
+ * 点击可打开/关闭小说工坊面板。独立 DOM 注入，不触碰主面板逻辑，挂载失败静默降级。
+ *
+ * P0 重写说明（原实现的三个问题）：
+ *   1. 整块背景染状态色 + 固定白字 → 浅色主题下「白字配亮底」对比度崩坏。
+ *      现在改为「玻璃底 + 主题前景色文字 + 左侧状态色点」，状态只由色点承载，
+ *      文字永远跟随主题，任何深浅色下都可读。
+ *   2. 样式写死在 JS 的 inline style 里，切主题纹丝不动。
+ *      现在改用 CSS Module class，配色走 --nf-chip-* 令牌，
+ *      由 body[data-ds-dark-theme] 跟随宿主深浅色。
+ *   3. role="button" 却没有 tabindex、没有键盘处理，键盘用户完全用不了。
+ *      现在补 tabindex + Enter/Space 激活 + aria-label/live。
+ */
+import type { NovelApi } from './api.ts';
+import type { PanelController } from './panel/controller.ts';
+/** 生成一个固定顶部的状态芯片并开始轮询。返回 dispose。 */
+export declare function mountRunStatus(controller: PanelController, api: NovelApi): () => void;

package/lib/types/client/text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 客户端文件文本智能解码：兼容 UTF-8 BOM / UTF-16 / UTF-8 / GB18030(GBK)。
+ * 浏览器 File.text() 固定按 UTF-8 解码，GBK 中文网文 txt 会乱码，这里兜底。
+ */
+/**
+ * 读取一个 File 的文本，按编码探测兜底解码。
+ * @returns 解码后的文本。
+ */
+export declare function readFileTextSmart(file: File): Promise<string>;

package/lib/types/docx-core.d.ts

@@ -0,0 +1,16 @@
+/**
+ * docx 文本提取共享核心：服务端（src/docx.ts）与浏览器端（src/client/docx.ts）
+ * 共用 XML → 纯文本的解析逻辑，避免两份实现漂移。
+ * zip 解压入口因运行时不同（fflate vs fflate/browser，浏览器端必须走 browser
+ * 入口以避开 node:module 的 require 探测）留在两端各自处理。
+ */
+/** 解码 docx 正文实际会用到的少量 XML 实体。 */
+export declare function decodeEntities(text: string): string;
+/**
+ * 从 word/document.xml 的 XML 字符串提取纯文本：每个 <w:p> 段落一行，
+ * <w:tab>/<w:br> 保留为空白符；表格与嵌套结构按文档顺序拍平
+ * （它们的段落同样是 <w:p>）。
+ * @param xml - document.xml 解码后的字符串。
+ * @returns 正文文本（空文本时抛错）。
+ */
+export declare function extractDocxTextFromXml(xml: string): string;

package/lib/types/docx.d.ts

@@ -2,11 +2,10 @@
  * docx outline extraction: a .docx is a zip whose word/document.xml holds the
  * body text in <w:t> runs inside <w:p> paragraphs. We unzip with fflate and
  * walk the XML with a tiny tokenizer — no heavyweight XML/DOM dependency.
+ * XML 解析共享核心在 ./docx-core.ts（与浏览器端同源）。
  */
 /**
- * Extract plain text from a docx buffer: one line per <w:p> paragraph, with
- * <w:tab>/<w:br> preserved as whitespace. Tables and nested structures are
- * flattened in document order (their paragraphs are just <w:p> too).
+ * Extract plain text from a docx buffer: one line per <w:p> paragraph.
  * @param buffer - the raw .docx bytes.
  * @returns the body text.
  */