feat: 完成短剧项目空间与结构化资产创作闭环 (#38)

* feat(canvas): 短剧项目空间 - 建立项目章节与画布关联 MVP

* feat(canvas): 短剧项目空间 - 完善项目资产、镜头与流程闭环

Refs #30

* fix(deploy): 本地部署 - 修复前端构建并忽略本地 PostgreSQL 配置

* feat(*): 短剧项目空间 - 完成项目、章节、资产、角色与画布创作闭环

Refs #30

---------

Co-authored-by: ddCat <ddcat666@88.com>
This commit is contained in:
ddcat666andddCat authored and GitHub committed 2026-07-27 10:45:11 +08:00
1 parent 431b9e3294
commit d2fbc413b3
208 files changed
+22655 -4234

No files matched your search

+196 -44
View File
@@ -1,8 +1,10 @@
import { useCallback, useEffect, useRef, useState, type ChangeEvent, type Dispatch, type DragEvent, type SetStateAction } from "react";
import { useQueryClient } from "@tanstack/react-query";
import { App } from "antd";
import { CANVAS_IMAGE_ASSET_DND_TYPE } from "@/components/canvas/canvas-asset-tray";
import type { InsertAssetPayload } from "@/components/canvas/asset-picker-modal";
import { CANVAS_PROJECT_CHAPTER_DND_TYPE, type CanvasProjectChapterPayload } from "@/components/canvas/canvas-project-sidebar";
import { NODE_DEFAULT_SIZE } from "@/constant/canvas";
import { getDataUrlByteSize, readImageMeta } from "@/lib/image-utils";
import { audioMetadata, imageMetadata, videoMetadata } from "@/lib/canvas/canvas-generation-task-sync";
@@ -11,11 +13,15 @@ import { isAudioFile } from "@/lib/canvas/canvas-project-generation";
import { fitNodeSize } from "@/lib/canvas/canvas-node-size";
import { uploadMediaFile } from "@/services/file-storage";
import { resolveImageUrl, uploadImage } from "@/services/image-storage";
import { getProjectUnit } from "@/services/api/projects";
import { ensureCanvasNodeAsset } from "@/services/project-asset-sync";
import { useAssetStore, type ImageAsset } from "@/stores/use-asset-store";
import { CanvasNodeType, type CanvasNodeData, type ContextMenuState, type Position } from "@/types/canvas";
import type { CanvasUploadStatus } from "./canvas-project-feedback";
type UseCanvasUploadOptions = {
canvasId: string;
domainProjectId?: string;
nodesRef: { current: CanvasNodeData[] };
selectedNodeIdsRef: { current: Set<string> };
getCanvasCenter: () => Position;
@@ -38,6 +44,8 @@ const VIDEO_NODE_MAX_HEIGHT = 420;
const NODE_STATUS_SUCCESS = "success" as const;
export function useCanvasUpload({
canvasId,
domainProjectId,
nodesRef,
selectedNodeIdsRef,
getCanvasCenter,
@@ -49,6 +57,7 @@ export function useCanvasUpload({
setDialogNodeId,
}: UseCanvasUploadOptions) {
const { message } = App.useApp();
const queryClient = useQueryClient();
const imageInputRef = useRef<HTMLInputElement>(null);
const uploadTargetRef = useRef<{ nodeId?: string; position?: Position } | null>(null);
const assetInsertPositionRef = useRef<Position | null>(null);
@@ -92,8 +101,20 @@ export function useCanvasUpload({
if (dialog !== "preserve") setDialogNodeId(dialog === "open" ? nodeId : null);
}, [setDialogNodeId, setSelectedConnectionId, setSelectedNodeIds]);
const persistMediaNode = useCallback(async (node: CanvasNodeData) => {
try {
const result = await ensureCanvasNodeAsset({ canvasId, domainProjectId, node, source: "canvas-upload" });
setNodes((current) => current.map((item) => item.id === node.id ? { ...item, metadata: { ...item.metadata, assetId: result.assetId } } : item));
if (domainProjectId) await queryClient.invalidateQueries({ queryKey: ["project", domainProjectId] });
return true;
} catch (error) {
message.warning(error instanceof Error ? `媒体已添加到画布,但素材同步失败:${error.message}` : "媒体已添加到画布,但素材同步失败");
return false;
}
}, [canvasId, domainProjectId, message, queryClient, setNodes]);
const createImageFileNode = useCallback(async (file: File, position: Position) => {
const progress = startUploadStatus("上传图片", "读取图片文件");
const progress = startUploadStatus("上传图片", "读取图片文件", domainProjectId ? 4 : 3);
try {
progress.update("上传到服务器并同步资源", 2);
const image = await uploadImage(file);
@@ -111,7 +132,9 @@ export function useCanvasUpload({
};
setNodes((current) => [...current, node]);
selectInsertedNode(id, "open");
progress.done("图片已添加到画布");
if (domainProjectId) progress.update("写入项目资产", 4);
const persisted = await persistMediaNode(node);
progress.done(persisted ? "图片已添加到画布" : "图片已添加,项目资产待重试");
return true;
} catch (error) {
const details = error instanceof Error ? error.message : "图片上传失败";
@@ -119,7 +142,7 @@ export function useCanvasUpload({
message.error(details);
return false;
}
}, [message, selectInsertedNode, setNodes, startUploadStatus]);
}, [domainProjectId, message, persistMediaNode, selectInsertedNode, setNodes, startUploadStatus]);
const createImageAssetNode = useCallback(async (asset: ImageAsset, position?: Position) => {
try {
@@ -147,6 +170,7 @@ export function useCanvasUpload({
bytes: asset.data.bytes || getDataUrlByteSize(content.startsWith("data:") ? content : ""),
mimeType: asset.data.mimeType || "image/png",
prompt: typeof asset.metadata?.prompt === "string" ? asset.metadata.prompt : asset.title,
assetId: asset.id,
assetTags: asset.tags || [],
},
};
@@ -158,40 +182,46 @@ export function useCanvasUpload({
}, [getCanvasCenter, message, selectInsertedNode, setNodes]);
const createVideoFileNode = useCallback(async (file: File, position: Position) => {
const progress = startUploadStatus("上传视频", "读取视频文件");
const progress = startUploadStatus("上传视频", "读取视频文件", domainProjectId ? 4 : 3);
try {
progress.update("上传到服务器并同步资源", 2);
const video = await uploadMediaFile(file, "video");
progress.update("更新画布节点", 3);
const size = fitNodeSize(video.width || 1280, video.height || 720, VIDEO_NODE_MAX_WIDTH, VIDEO_NODE_MAX_HEIGHT);
const id = `video-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
setNodes((current) => [...current, { id, type: CanvasNodeType.Video, title: file.name, position: { x: position.x - size.width / 2, y: position.y - size.height / 2 }, width: size.width, height: size.height, metadata: videoMetadata(video) }]);
const node = { id, type: CanvasNodeType.Video, title: file.name, position: { x: position.x - size.width / 2, y: position.y - size.height / 2 }, width: size.width, height: size.height, metadata: videoMetadata(video) } satisfies CanvasNodeData;
setNodes((current) => [...current, node]);
selectInsertedNode(id, "open");
progress.done("视频已添加到画布");
if (domainProjectId) progress.update("写入项目资产", 4);
const persisted = await persistMediaNode(node);
progress.done(persisted ? "视频已添加到画布" : "视频已添加,项目资产待重试");
} catch (error) {
const details = error instanceof Error ? error.message : "视频上传失败";
progress.fail(details);
message.error(details);
}
}, [message, selectInsertedNode, setNodes, startUploadStatus]);
}, [domainProjectId, message, persistMediaNode, selectInsertedNode, setNodes, startUploadStatus]);
const createAudioFileNode = useCallback(async (file: File, position: Position) => {
const progress = startUploadStatus("上传音频", "读取音频文件");
const progress = startUploadStatus("上传音频", "读取音频文件", domainProjectId ? 4 : 3);
try {
progress.update("上传到服务器并同步资源", 2);
const audio = await uploadMediaFile(file, "audio");
progress.update("更新画布节点", 3);
const size = NODE_DEFAULT_SIZE[CanvasNodeType.Audio];
const id = `audio-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
setNodes((current) => [...current, { id, type: CanvasNodeType.Audio, title: file.name, position: { x: position.x - size.width / 2, y: position.y - size.height / 2 }, width: size.width, height: size.height, metadata: audioMetadata(audio) }]);
const node = { id, type: CanvasNodeType.Audio, title: file.name, position: { x: position.x - size.width / 2, y: position.y - size.height / 2 }, width: size.width, height: size.height, metadata: audioMetadata(audio) } satisfies CanvasNodeData;
setNodes((current) => [...current, node]);
selectInsertedNode(id, "preserve");
progress.done("音频已添加到画布");
if (domainProjectId) progress.update("写入项目资产", 4);
const persisted = await persistMediaNode(node);
progress.done(persisted ? "音频已添加到画布" : "音频已添加,项目资产待重试");
} catch (error) {
const details = error instanceof Error ? error.message : "音频上传失败";
progress.fail(details);
message.error(details);
}
}, [message, selectInsertedNode, setNodes, startUploadStatus]);
}, [domainProjectId, message, persistMediaNode, selectInsertedNode, setNodes, startUploadStatus]);
const createTextNodeFromClipboard = useCallback((text: string, position?: Position) => {
const trimmed = text.trim();
@@ -206,6 +236,37 @@ export function useCanvasUpload({
return true;
}, [getCanvasCenter, selectInsertedNode, setContextMenu, setNodes]);
const handleProjectChapterInsert = useCallback(async (chapter: CanvasProjectChapterPayload, position?: Position) => {
let sourceText = chapter.sourceText;
if (sourceText === undefined) {
try {
sourceText = (await getProjectUnit(chapter.projectId, chapter.id)).unit.sourceText;
} catch (error) {
message.error(error instanceof Error ? `章节正文读取失败:${error.message}` : "章节正文读取失败");
return;
}
}
const content = htmlToPlainText(sourceText);
const node = createCanvasNode(CanvasNodeType.Text, position || getCanvasCenter(), {
content,
prompt: content,
status: NODE_STATUS_SUCCESS,
workflowKind: "free",
workflowTitle: "项目章节",
workflowDescription: `第 ${chapter.position + 1} 章`,
chapterId: chapter.id,
chapterTitle: chapter.title,
fontSize: 14,
});
node.title = `章节 · ${chapter.title}`;
node.width = 460;
node.height = 280;
setNodes((current) => [...current, node]);
selectInsertedNode(node.id, "preserve");
setContextMenu(null);
message.success(`已添加“${chapter.title}”`);
}, [getCanvasCenter, message, selectInsertedNode, setContextMenu, setNodes]);
const handleUploadRequest = useCallback((nodeId?: string, position?: Position) => {
uploadTargetRef.current = { nodeId, position };
const target = nodeId ? nodesRef.current.find((node) => node.id === nodeId) : null;
@@ -222,15 +283,19 @@ export function useCanvasUpload({
}, [nodesRef]);
const replaceNodeMedia = useCallback(async (nodeId: string, file: File) => {
const currentNode = nodesRef.current.find((node) => node.id === nodeId);
if (!currentNode) return false;
if (isAudioFile(file)) {
const progress = startUploadStatus("替换音频", "读取音频文件");
try {
progress.update("上传到服务器并同步资源", 2);
const audio = await uploadMediaFile(file, "audio");
progress.update("更新画布节点", 3);
setNodes((current) => current.map((node) => node.id === nodeId ? { ...node, type: CanvasNodeType.Audio, title: file.name, metadata: { ...node.metadata, ...audioMetadata(audio), errorDetails: undefined } } : node));
const node = { ...currentNode, type: CanvasNodeType.Audio, title: file.name, metadata: { ...currentNode.metadata, ...audioMetadata(audio), assetId: undefined, taskId: undefined, errorDetails: undefined } } satisfies CanvasNodeData;
setNodes((current) => current.map((item) => item.id === nodeId ? node : item));
selectInsertedNode(nodeId, "preserve");
progress.done("音频已替换,可撤销恢复");
const persisted = await persistMediaNode(node);
progress.done(persisted ? "音频已替换,可撤销恢复" : "音频已替换,项目资产待重试");
return true;
} catch (error) {
const details = error instanceof Error ? error.message : "音频替换失败";
@@ -245,9 +310,11 @@ export function useCanvasUpload({
progress.update("上传到服务器并同步资源", 2);
const video = await uploadMediaFile(file, "video");
progress.update("更新画布节点", 3);
setNodes((current) => current.map((node) => node.id === nodeId ? { ...node, type: CanvasNodeType.Video, title: file.name, metadata: { ...node.metadata, ...videoMetadata(video), errorDetails: undefined } } : node));
const node = { ...currentNode, type: CanvasNodeType.Video, title: file.name, metadata: { ...currentNode.metadata, ...videoMetadata(video), assetId: undefined, taskId: undefined, errorDetails: undefined } } satisfies CanvasNodeData;
setNodes((current) => current.map((item) => item.id === nodeId ? node : item));
selectInsertedNode(nodeId, "open");
progress.done("视频已替换,可撤销恢复");
const persisted = await persistMediaNode(node);
progress.done(persisted ? "视频已替换,可撤销恢复" : "视频已替换,项目资产待重试");
return true;
} catch (error) {
const details = error instanceof Error ? error.message : "视频替换失败";
@@ -261,13 +328,15 @@ export function useCanvasUpload({
progress.update("上传到服务器并同步资源", 2);
const image = await uploadImage(file);
progress.update("更新画布节点", 3);
setNodes((current) => current.map((node) => node.id === nodeId ? {
...node,
const node = {
...currentNode,
type: CanvasNodeType.Image,
title: file.name,
metadata: {
...node.metadata,
...currentNode.metadata,
...imageMetadata(image),
assetId: undefined,
taskId: undefined,
errorDetails: undefined,
freeResize: false,
isBatchRoot: undefined,
@@ -284,9 +353,11 @@ export function useCanvasUpload({
primaryImageId: undefined,
imageBatchExpanded: undefined,
},
} : node));
} satisfies CanvasNodeData;
setNodes((current) => current.map((item) => item.id === nodeId ? node : item));
selectInsertedNode(nodeId, "open");
progress.done("图片已替换,可撤销恢复");
const persisted = await persistMediaNode(node);
progress.done(persisted ? "图片已替换,可撤销恢复" : "图片已替换,项目资产待重试");
return true;
} catch (error) {
const details = error instanceof Error ? error.message : "图片替换失败";
@@ -294,7 +365,7 @@ export function useCanvasUpload({
message.error(details);
return false;
}
}, [message, selectInsertedNode, setNodes, startUploadStatus]);
}, [message, nodesRef, persistMediaNode, selectInsertedNode, setNodes, startUploadStatus]);
const pasteSystemClipboard = useCallback(async (position?: Position) => {
if (!navigator.clipboard) return;
@@ -351,6 +422,11 @@ export function useCanvasUpload({
event.preventDefault();
fileDragDepthRef.current = 0;
setFileDropActive(false);
const chapterPayload = parseProjectChapterPayload(event.dataTransfer.getData(CANVAS_PROJECT_CHAPTER_DND_TYPE));
if (chapterPayload) {
void handleProjectChapterInsert(chapterPayload, screenToCanvas(event.clientX, event.clientY));
return;
}
const imageAssetId = event.dataTransfer.getData(CANVAS_IMAGE_ASSET_DND_TYPE);
if (imageAssetId) {
const asset = useAssetStore.getState().assets.find((item): item is ImageAsset => item.kind === "image" && item.id === imageAssetId);
@@ -377,7 +453,7 @@ export function useCanvasUpload({
return;
}
void (isAudioFile(file) ? createAudioFileNode(file, position) : file.type.startsWith("video/") ? createVideoFileNode(file, position) : createImageFileNode(file, position));
}, [createAudioFileNode, createImageAssetNode, createImageFileNode, createVideoFileNode, message, nodesRef, replaceNodeMedia, screenToCanvas]);
}, [createAudioFileNode, createImageAssetNode, createImageFileNode, createVideoFileNode, handleProjectChapterInsert, message, nodesRef, replaceNodeMedia, screenToCanvas]);
const handleFileDragEnter = useCallback((event: DragEvent<HTMLDivElement>) => {
if (!hasDraggedFiles(event)) return;
@@ -387,7 +463,7 @@ export function useCanvasUpload({
}, []);
const handleFileDragOver = useCallback((event: DragEvent<HTMLDivElement>) => {
if (!hasDraggedFiles(event)) return;
if (!hasDraggedFiles(event) && !Array.from(event.dataTransfer.types).includes(CANVAS_PROJECT_CHAPTER_DND_TYPE)) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
}, []);
@@ -414,33 +490,90 @@ export function useCanvasUpload({
setAssetPickerOpen(false);
}, []);
const handleAssetInsert = useCallback(async (payload: InsertAssetPayload) => {
const center = assetInsertPositionRef.current || getCanvasCenter();
const createAssetPayloadNode = useCallback(async (payload: InsertAssetPayload, center: Position) => {
if (payload.kind === "character") {
const width = 320;
const height = 260;
return {
id: `character-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
type: CanvasNodeType.Text,
title: payload.title,
position: { x: center.x - width / 2, y: center.y - height / 2 },
width,
height,
metadata: {
workflowKind: "character",
characterAssetId: payload.assetId,
characterVersionId: payload.versionId,
characterVersionPolicy: "current",
characterName: payload.title,
characterPrompt: payload.prompt,
characterAliases: payload.aliases,
characterDefinition: payload.definition,
characterCoverUrl: payload.coverUrl,
characterVisualStatus: payload.visualStatus,
characterVoiceStatus: payload.voiceStatus,
characterVoiceName: payload.voiceName,
characterVoiceProfile: payload.voiceProfile,
characterVoiceInstructions: payload.voiceInstructions,
assetId: payload.assetId,
status: NODE_STATUS_SUCCESS,
fontSize: 14,
},
} satisfies CanvasNodeData;
}
if (payload.kind === "text") {
const node = { ...createCanvasNode(CanvasNodeType.Text, center, { content: payload.content, status: NODE_STATUS_SUCCESS }), title: payload.content.slice(0, 32) || "Assistant Text" };
setNodes((current) => [...current, node]);
selectInsertedNode(node.id, "preserve");
} else if (payload.kind === "video") {
const node = { ...createCanvasNode(CanvasNodeType.Text, center, { content: payload.content, status: NODE_STATUS_SUCCESS, assetId: payload.assetId }), title: payload.content.slice(0, 32) || "Assistant Text" };
return node;
}
if (payload.kind === "audio") {
const spec = NODE_DEFAULT_SIZE[CanvasNodeType.Audio];
const id = `audio-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
return { id, type: CanvasNodeType.Audio, title: payload.title, position: { x: center.x - spec.width / 2, y: center.y - spec.height / 2 }, width: spec.width, height: spec.height, metadata: { content: payload.url, storageKey: payload.storageKey, durationMs: payload.durationMs, bytes: payload.bytes, mimeType: payload.mimeType || "audio/mpeg", assetId: payload.assetId, status: NODE_STATUS_SUCCESS } } satisfies CanvasNodeData;
}
if (payload.kind === "video") {
const spec = NODE_DEFAULT_SIZE[CanvasNodeType.Video];
const size = fitNodeSize(payload.width || spec.width, payload.height || spec.height, VIDEO_NODE_MAX_WIDTH, VIDEO_NODE_MAX_HEIGHT);
const id = `video-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
setNodes((current) => [...current, { id, type: CanvasNodeType.Video, title: payload.title, position: { x: center.x - size.width / 2, y: center.y - size.height / 2 }, width: size.width, height: size.height, metadata: { content: payload.url, storageKey: payload.storageKey, status: NODE_STATUS_SUCCESS, naturalWidth: payload.width, naturalHeight: payload.height } }]);
selectInsertedNode(id, "preserve");
} else {
try {
const storedImage = payload.storageKey ? { url: payload.dataUrl, storageKey: payload.storageKey, width: 1, height: 1, bytes: 0, mimeType: "image/png" } : await uploadImage(payload.dataUrl);
const meta = storedImage.width === 1 && storedImage.height === 1 ? await readImageMeta(storedImage.url) : storedImage;
const size = fitNodeSize(meta.width, meta.height);
const id = `image-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
setNodes((current) => [...current, { id, type: CanvasNodeType.Image, title: payload.title.slice(0, 32) || "Generated Image", position: { x: center.x - size.width / 2, y: center.y - size.height / 2 }, width: size.width, height: size.height, metadata: { ...imageMetadata({ ...storedImage, width: meta.width, height: meta.height }), prompt: payload.title } }]);
selectInsertedNode(id, "open");
} catch (error) {
message.error(error instanceof Error ? error.message : "素材图片插入失败");
return;
}
return { id, type: CanvasNodeType.Video, title: payload.title, position: { x: center.x - size.width / 2, y: center.y - size.height / 2 }, width: size.width, height: size.height, metadata: { content: payload.url, storageKey: payload.storageKey, status: NODE_STATUS_SUCCESS, naturalWidth: payload.width, naturalHeight: payload.height, durationMs: payload.durationMs, bytes: payload.bytes, mimeType: payload.mimeType || "video/mp4", assetId: payload.assetId } } satisfies CanvasNodeData;
}
const storedImage = payload.storageKey ? { url: payload.dataUrl, storageKey: payload.storageKey, width: 1, height: 1, bytes: 0, mimeType: "image/png" } : await uploadImage(payload.dataUrl);
const meta = storedImage.width === 1 && storedImage.height === 1 ? await readImageMeta(storedImage.url) : storedImage;
const size = fitNodeSize(meta.width, meta.height);
const id = `image-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
return { id, type: CanvasNodeType.Image, title: payload.title.slice(0, 32) || "Generated Image", position: { x: center.x - size.width / 2, y: center.y - size.height / 2 }, width: size.width, height: size.height, metadata: { ...imageMetadata({ ...storedImage, width: meta.width, height: meta.height }), prompt: payload.title, assetId: payload.assetId } } satisfies CanvasNodeData;
}, []);
const handleAssetInsert = useCallback(async (payload: InsertAssetPayload) => {
const center = assetInsertPositionRef.current || getCanvasCenter();
try {
const node = await createAssetPayloadNode(payload, center);
setNodes((current) => [...current, node]);
selectInsertedNode(node.id, payload.kind === "image" || payload.kind === "video" ? "open" : "preserve");
} catch (error) {
message.error(error instanceof Error ? error.message : "素材插入失败");
return;
}
closeAssetPicker();
}, [closeAssetPicker, getCanvasCenter, message, selectInsertedNode, setNodes]);
}, [closeAssetPicker, createAssetPayloadNode, getCanvasCenter, message, selectInsertedNode, setNodes]);
const handleProjectAssetsInsert = useCallback(async (payloads: InsertAssetPayload[], position?: Position) => {
const origin = position || getCanvasCenter();
try {
const created = await Promise.all(payloads.map((payload, index) => createAssetPayloadNode(payload, {
x: origin.x + (index % 3) * 380,
y: origin.y + Math.floor(index / 3) * 300,
})));
setNodes((current) => [...current, ...created]);
setSelectedNodeIds(new Set(created.map((node) => node.id)));
setSelectedConnectionId(null);
setDialogNodeId(null);
message.success(`已引入 ${created.length} 项项目资产`);
} catch (error) {
message.error(error instanceof Error ? error.message : "项目资产引入失败");
throw error;
}
}, [createAssetPayloadNode, getCanvasCenter, message, setDialogNodeId, setNodes, setSelectedConnectionId, setSelectedNodeIds]);
return {
assetPickerOpen,
@@ -453,6 +586,8 @@ export function useCanvasUpload({
handleFileDragLeave,
handleFileDragOver,
handleImageInputChange,
handleProjectAssetsInsert,
handleProjectChapterInsert,
handleUploadRequest,
imageInputRef,
openAssetsAtPosition,
@@ -466,3 +601,20 @@ export function useCanvasUpload({
function hasDraggedFiles(event: DragEvent<HTMLElement>) {
return Array.from(event.dataTransfer.types).includes("Files");
}
function parseProjectChapterPayload(value: string): CanvasProjectChapterPayload | null {
if (!value) return null;
try {
const payload = JSON.parse(value) as Partial<CanvasProjectChapterPayload>;
const validSource = payload.sourceText === undefined || typeof payload.sourceText === "string";
return typeof payload.id === "string" && typeof payload.projectId === "string" && typeof payload.title === "string" && validSource && typeof payload.position === "number" ? payload as CanvasProjectChapterPayload : null;
} catch {
return null;
}
}
function htmlToPlainText(value: string) {
if (!value) return "";
const document = new DOMParser().parseFromString(value, "text/html");
return document.body.textContent?.trim() || "";
}