@waterwx/dsh-novel-forge 2.0.1-alpha → 2.1.0-alpha

package/lib/types/src/client/mount.d.ts

@@ -0,0 +1,9 @@
+import type { NovelApi } from './api.ts';
+import type { PanelController } from './panel/controller.ts';
+/** The injected panel container. */
+export declare const PANEL_VIEW_SELECTOR = "[data-dsh-novelforge-view]";
+/**
+ * Mount the panel React tree into the center column and bind visibility to
+ * the controller.
+ */
+export declare function mountPanel(controller: PanelController, api: NovelApi): () => void;

package/lib/types/src/client/panel/AdaptModeView.d.ts

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export declare function AdaptModeView({ api, onOpenBook }: {
+    api: NovelApi;
+    onOpenBook?: (id: string) => void;
+}): any;

package/lib/types/src/client/panel/AssetsTab.d.ts

@@ -0,0 +1,12 @@
+import type { NovelApi } from '../api.ts';
+/** Props. */
+export interface AssetsTabProps {
+    api: NovelApi;
+    /** 初始子页（左侧导航直达对应资产分类）。 */
+    initialTab?: AssetSubTab;
+}
+/** 写作资产子页签。 */
+type AssetSubTab = 'genre' | 'progression' | 'templates' | 'rules' | 'style';
+/** 写作资产页签。 */
+export declare function AssetsTab({ api, initialTab }: AssetsTabProps): any;
+export {};

package/lib/types/src/client/panel/AssistantTab.d.ts

@@ -0,0 +1,7 @@
+import type { NovelApi } from '../api.ts';
+/** Props. */
+export interface AssistantTabProps {
+    api: NovelApi;
+}
+/** The assistant conversation tab. */
+export declare function AssistantTab({ api }: AssistantTabProps): any;

package/lib/types/src/client/panel/AuthorAssetsView.d.ts

@@ -0,0 +1,4 @@
+import type { NovelApi } from '../api.ts';
+export declare function AuthorAssetsView({ api }: {
+    api: NovelApi;
+}): any;

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

@@ -0,0 +1,32 @@
+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, onOpenSettings, onTheme, onBackground, onOpacity, onEndfieldAccent, adaptEnabled, progress, busy, busyLabel, liveBar, onClearProgress }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    onOpenBook: (id: string) => void;
+    onReadBook: (id: string) => void;
+    onAddBook: () => void;
+    onImportBook: () => void;
+    /** 兼容旧入口：首页设置现为独立设置页，此回调保留但不再使用。 */
+    onOpenSettings?: () => void;
+    /** 主题/模式/密度变化回调（供面板根容器实时生效）。 */
+    onTheme?: (theme: 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield', mode: 'system' | 'light' | 'dark', density: 'comfort' | 'compact' | 'spacious') => void;
+    /** 自定义背景变化回调。 */
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    /** 玻璃透明度变化回调。 */
+    onOpacity?: (n: number) => void;
+    /** 终末地强调色变化回调。 */
+    onEndfieldAccent?: (accent: 'valley' | 'wuling') => void;
+    /** 是否启用改编模式（默认 false=隐藏入口）。 */
+    adaptEnabled?: boolean;
+    /** AI 进度实时状态（与书内共享同一份）。 */
+    progress?: ProgressLine[];
+    busy?: boolean;
+    busyLabel?: string;
+    liveBar?: {
+        text: string;
+        ratio?: number;
+    } | null;
+    onClearProgress?: () => void;
+}): any;

package/lib/types/src/client/panel/BookshelfBar.d.ts

@@ -0,0 +1,11 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+/** Props. */
+export interface BookshelfBarProps {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    /** 刷新整个面板（切换书后重新拉状态）。 */
+    onSwitch: () => void;
+}
+/** 书架条。 */
+export declare function BookshelfBar({ api, shelf, onSwitch }: BookshelfBarProps): any;

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

@@ -0,0 +1,9 @@
+import type { NovelApi } from '../api.ts';
+/** 开书向导页。 */
+export declare function CreateBookView({ api, onBack, onCreated, }: {
+    api: NovelApi;
+    /** 返回书架。 */
+    onBack: () => void;
+    /** 开书成功：进入新书工作台。 */
+    onCreated: (id: string) => void;
+}): any;

package/lib/types/src/client/panel/FlowGuide.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 漫剧工作台·全流程步骤条（唯一导航，方案X）：
+ * ①创建方案 → ②一键生成 → ③分镜 → ④角色定妆 → ⑤场景底图 → ⑥导出使用。
+ * 每个步骤对应一个独立页面主体；完成度自动判定（读 project 现有字段）。
+ */
+import type { ProjectState } from '../../protocol.ts';
+/** 步骤 → 页面主体的一一对应目标。 */
+export type FlowTarget = 'plan' | 'rules' | 'skeleton' | 'table' | 'import' | 'makeup' | 'prompts' | 'scenes' | 'props' | 'export';
+export interface FlowStep {
+    no: number;
+    label: string;
+    hint: string;
+    done: boolean;
+    target: FlowTarget;
+}
+/** 依据 project 数据计算 6 步完成度（与存储顺序无关，按生产顺序排列）。 */
+export declare function computeFlowSteps(project: ProjectState | null, exported?: boolean): FlowStep[];
+export declare function FlowGuide({ project, onNavigate, exported, }: {
+    project: ProjectState | null;
+    onNavigate: (target: FlowTarget) => void;
+    exported?: boolean;
+}): any;

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

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

package/lib/types/src/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>;
+}): any;

package/lib/types/src/client/panel/MangaRoleLibrary.d.ts

@@ -0,0 +1,20 @@
+import type { NovelApi } from '../api.ts';
+import type { ImageModelConfig, ProjectState } from '../../protocol.ts';
+export declare function MangaRoleLibrary({ api, project, refresh, styleId, filterId, focus, showCards, chapterNo: externalChapter, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    styleId?: string;
+    filterId?: string;
+    /** 是否启用生图（豆包等出定妆图）。 */
+    imageApiEnabled?: boolean;
+    /** 生图模型库（出定妆图时可选择用哪条）。 */
+    imageModels?: ImageModelConfig[];
+    /** 步骤页聚焦：import=展开并滚动到导入区；cards=滚动到已建漫剧卡列表。 */
+    focus?: 'import' | 'cards';
+    /** 是否显示「已建漫剧卡」列表（第⑤步导入页可隐藏，只留导入区）。 */
+    showCards?: boolean;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

package/lib/types/src/client/panel/MangaWorkspace.d.ts

@@ -0,0 +1,12 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function MangaWorkspace({ api, project, chapters, onProjectChanged, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 方案/资产变更已持久化后触发（刷新项目）。 */
+    onProjectChanged?: () => void | Promise<void>;
+    /** 是否启用生图（漫剧卡出定妆图）。 */
+    /** 上报到「AI进度」控制台（漫剧工作台内所有 LLM/方案操作）。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

package/lib/types/src/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/src/client/panel/NovelPanel.d.ts

@@ -0,0 +1,13 @@
+import type { NovelApi } from '../api.ts';
+import type { PanelController } from './controller.ts';
+/** The panel's tab identifiers. */
+export type NovelTab = 'workflow' | 'overview' | 'blurb' | 'plan' | 'bible' | 'world' | 'foreshadow' | 'assistant' | 'settings' | 'characters' | 'roles' | 'facts' | 'plotlines' | 'reviews' | 'progress' | 'breakdown' | 'assetsGenre' | 'assetsProgression' | 'assetsTemplates' | 'assetsRules' | 'assetsStyle' | 'run' | 'manhua' | 'book' | 'assets';
+/** Panel shell props. */
+export interface NovelPanelProps {
+    /** The panel state owner (open/close/toggle). */
+    controller: PanelController;
+    /** The API client every tab operates through. */
+    api: NovelApi;
+}
+/** The novel-forge panel. */
+export declare function NovelPanel({ controller, api }: NovelPanelProps): any;

package/lib/types/src/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;
+}): any;

package/lib/types/src/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;
+}): any;

package/lib/types/src/client/panel/PropLibrary.d.ts

@@ -0,0 +1,8 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function PropLibrary({ api, project, refresh, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    refresh: () => void | Promise<void>;
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

package/lib/types/src/client/panel/ReaderView.d.ts

@@ -0,0 +1,8 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function ReaderView({ api, project, onBack, onOpenWorkspace, }: {
+    api: NovelApi;
+    project: ProjectState;
+    onBack: () => void;
+    onOpenWorkspace: () => void;
+}): any;

package/lib/types/src/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/src/client/panel/RunPanel.d.ts

@@ -0,0 +1,5 @@
+import type { NovelApi } from '../api.ts';
+export declare function RunPanel({ api, totalChapters }: {
+    api: NovelApi;
+    totalChapters: number;
+}): any;

package/lib/types/src/client/panel/SceneLibrary.d.ts

@@ -0,0 +1,16 @@
+import type { NovelApi } from '../api.ts';
+import type { ProjectState } from '../../protocol.ts';
+export declare function SceneLibrary({ api, project, refresh, styleId, filterId, chapterNo: externalChapter, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    /** 场景库变更已持久化后触发（刷新项目）。 */
+    refresh: () => void | Promise<void>;
+    /** 提炼场景时的漫剧基底风格 id（提示词按方案风格措辞）。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+    /** 全局当前章节（从工作台顶部导航条传入）。 */
+    chapterNo?: number | null;
+    /** 上报到「AI进度」控制台。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

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

@@ -0,0 +1,16 @@
+import type { NovelApi } from '../api.ts';
+type SettingsTab = 'model' | 'writing' | 'image' | 'files' | 'appearance';
+type ThemeMode = 'system' | 'light' | 'dark';
+type ThemeName = 'liquid' | 'neumorph' | 'macos' | 'clay' | 'endfield';
+type EndfieldAccent = 'valley' | 'wuling';
+type ThemeDensity = 'comfort' | 'compact' | 'spacious';
+export declare function SettingsView({ api, onTheme, onSettingsTab, onEditorFontSize, onBackground, onOpacity, onEndfieldAccent }: {
+    api: NovelApi;
+    onTheme?: (theme: ThemeName, mode: ThemeMode, density: ThemeDensity) => void;
+    onSettingsTab?: (tab: SettingsTab) => void;
+    onEditorFontSize?: (n: number) => void;
+    onBackground?: (bg: string | undefined, blur: number) => void;
+    onOpacity?: (n: number) => void;
+    onEndfieldAccent?: (accent: EndfieldAccent) => void;
+}): any;
+export {};

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

@@ -0,0 +1,15 @@
+import type { NovelApi } from '../api.ts';
+import type { BookshelfSnapshot } from '../../protocol.ts';
+/** 书架首页。 */
+export declare function ShelfView({ api, shelf, onOpenBook, onReadBook, onAddBook, onImportBook, }: {
+    api: NovelApi;
+    shelf: BookshelfSnapshot;
+    /** 点击书卡：激活该书并进入工作台。 */
+    onOpenBook: (id: string) => void;
+    /** 点击「阅读」：激活该书并进入沉浸式阅读页。 */
+    onReadBook: (id: string) => void;
+    /** 点击＋：进入开书向导页。 */
+    onAddBook: () => void;
+    /** 点击「导入」：打开导入弹窗（已有项目目录 / txt/md 全本）。 */
+    onImportBook: () => void;
+}): any;

package/lib/types/src/client/panel/StoryboardTab.d.ts

@@ -0,0 +1,19 @@
+import type { NovelApi } from '../api.ts';
+import type { ChapterPlan, ProjectState } from '../../protocol.ts';
+export declare function StoryboardTab({ api, project, chapters, onProjectChanged, styleId, filterId, mode, onGoStep, onProgress, }: {
+    api: NovelApi;
+    project: ProjectState | null;
+    chapters: ChapterPlan[];
+    /** 生成成功且已持久化后触发（刷新项目，切章/重进可恢复）。 */
+    onProjectChanged?: () => void | Promise<void>;
+    /** 漫剧基底风格 id（画面措辞随风格）。 */
+    styleId?: string;
+    /** 可选滤镜风格 id。 */
+    filterId?: string;
+    /** 页面模式：auto=按本章实际进度显示；skeleton/table/prompts=固定显示该步骤（前置不足显示提示，不降级）。 */
+    mode?: 'auto' | 'skeleton' | 'table' | 'prompts';
+    /** 「下一步」按钮回调（1=骨架→2=分镜表→3=提示词），供外层切步骤页。 */
+    onGoStep?: (n: 1 | 2 | 3) => void;
+    /** 上报到「AI进度」控制台（分镜三步生成）。 */
+    onProgress?: (text: string, kind?: 'info' | 'done' | 'error') => void;
+}): any;

package/lib/types/src/client/panel/StyleCard.d.ts

@@ -0,0 +1,8 @@
+import type { ArtStyle } from '../../style-library.ts';
+export declare function StyleCard({ style, selected, onClick, }: {
+    style: ArtStyle;
+    /** 选中态（高亮边框）。 */
+    selected?: boolean;
+    /** 点击卡片（选风格）。 */
+    onClick?: () => void;
+}): any;

package/lib/types/src/client/panel/StyleGallery.d.ts

@@ -0,0 +1 @@
+export declare function StyleGallery(): any;

package/lib/types/src/client/panel/WorldTab.d.ts

@@ -0,0 +1,10 @@
+import type { NovelApi } from '../api.ts';
+import type { WorldState } from '../../protocol.ts';
+/** 大世界页签。 */
+export declare function WorldTab({ api, world, onChanged, }: {
+    api: NovelApi;
+    /** 当前项目的大世界数据（可能为空）。 */
+    world: WorldState | undefined;
+    /** 保存/提炼成功后由父组件刷新项目状态。 */
+    onChanged: (world: WorldState) => void;
+}): any;

package/lib/types/src/client/panel/controller.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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 declare class PanelController {
+    private panelOpen;
+    private listeners;
+    getSnapshot(): PanelControllerSnapshot;
+    subscribe(fn: () => void): () => void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    private notify;
+}

package/lib/types/src/client/panel/helpers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 { type NovelKey } from '../locales.ts';
+/** Translate one key with optional {placeholder} substitution. */
+export declare function tt(key: NovelKey, params?: Record<string, string | number>): string;
+/** 角色定位中文名（角色库/提炼候选共用，收敛自多份复制）。 */
+export declare const ROLE_LABELS: Record<string, string>;
+/** 角色定位徽章颜色。 */
+export declare function roleColor(label: string): string;
+/** 剧情线类型中文名（与 locale 对齐）。 */
+export declare function kindLabel(kind: string): string;
+/** 剧情线状态中文名。 */
+export declare function plotlineStatusLabel(status: string): string;
+/** 剧情线状态颜色。 */
+export declare function plotlineStatusColor(status: string): string;

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

@@ -0,0 +1,77 @@
+/**
+ * 纯展示组件（views）：所有状态与事件处理器都留在 NovelPanel，
+ * 这里只接收 props 渲染。便于单独维护与复用。
+ */
+import type { ReactElement } from 'react';
+import type { AuditIssue, Plotline, PlotlineHealthReport, PlotlinePlan, RoleRecord, RoleStatusCard } from '../../protocol.ts';
+/** 统计格：状态摘要条 / 资产健康通用。 */
+export declare function StatCell(props: {
+    label: string;
+    value: string;
+    detail: string;
+    /** 值颜色（可选）。 */
+    valueColor?: string;
+    /** 值字号覆盖（如长文本用 13）。 */
+    valueFontSize?: number;
+    /** detail 悬浮提示（可选）。 */
+    detailTitle?: string;
+}): ReactElement;
+/** 待办队列行。 */
+export declare function TodoRow(props: {
+    tone: 'danger' | 'warning' | 'info' | 'success';
+    title: string;
+    description: string;
+    actionLabel: string;
+    disabled: boolean;
+    onAction: () => void;
+}): ReactElement;
+/** 全书质检问题行。 */
+export declare function AuditIssueRow(props: {
+    issue: AuditIssue;
+    disabled: boolean;
+    onFix: () => void;
+}): ReactElement;
+/** 剧情线卡片（列表主体）。 */
+export declare function PlotlineCard(props: {
+    line: Plotline;
+    disabled: boolean;
+    onRefresh: () => void;
+    onEdit: () => void;
+    onRemove: () => void;
+}): ReactElement;
+/** AI 候选角色行（提炼结果，可采纳/修改后采纳）。 */
+export declare function RoleCandidateRow(props: {
+    candidate: RoleRecord;
+    disabled: boolean;
+    onAdopt: () => void;
+    onEdit: () => void;
+}): ReactElement;
+/** 已收录角色卡（含从编年录刷新的当前状态行）。 */
+export declare function RoleCard(props: {
+    role: RoleRecord;
+    status?: RoleStatusCard;
+    disabled: boolean;
+    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;

package/lib/types/src/client/sidebar-entry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Sidebar entry injection — mirrors the family plugins' DOM-level pattern:
+ * the shell exposes no external slot, so the entry row is injected after the
+ * sibling plugin entries and self-heals via MutationObserver.
+ */
+import type { PanelController } from './panel/controller.ts';
+/** Stable data attribute identifying the injected entry row. */
+export declare const ENTRY_SELECTOR = "[data-dsh-novelforge-entry]";
+/**
+ * Mount the sidebar entry, waiting for the shell and self-healing on
+ * re-renders.
+ */
+export declare function mountSidebarEntry(controller: PanelController): () => void;

package/lib/types/src/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/src/comic-presets.d.ts

@@ -0,0 +1,12 @@
+/** 漫画风格预设：每个预设对应一组出图提示词与排版偏好。 */
+export interface ComicStylePreset {
+    id: string;
+    label: string;
+    /** 注入 imagePrompt 的风格描述词。 */
+    prompt: string;
+    /** 可选：排版偏好说明。 */
+    layoutHint?: string;
+}
+export declare const COMIC_STYLE_PRESETS: ComicStylePreset[];
+export declare function getComicStylePrompt(styleId?: string): string;
+export declare function getComicStyleLabel(styleId?: string): string;

package/lib/types/src/docx.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ */
+/**
+ * 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).
+ * @param buffer - the raw .docx bytes.
+ * @returns the body text.
+ */
+export declare function extractDocxText(buffer: Uint8Array): string;
+/**
+ * Read and extract a docx outline from disk.
+ * @param path - absolute path to the .docx file.
+ * @returns the extracted outline text.
+ */
+export declare function readOutlineFromDocx(path: string): string;