Files
Genarrative/src/components/image-editor/useImageCanvasLayerCommands.ts
T
kdletters 6bf8b0051b 完善画板生成器与素材导出体验
图片改造改为独立 quick-edit 生成器占位并补齐提交链路
生成完成应用项目快照后同步刷新素材库
序列帧导出补充 Spine JSON 与独立验证器
序列帧播放预加载帧资源以减少加载闪烁
本地 dev 默认启用 all 进程角色并更新文档
2026-06-25 00:12:21 +08:00

563 lines
16 KiB
TypeScript

import {
useCallback,
useState,
type Dispatch,
type SetStateAction,
} from 'react';
import type {
CanvasClipboard,
CanvasContextMenuState,
CanvasGenerationDialogState,
CanvasLayer,
} from './ImageCanvasEditorTypes';
import {
createCanvasLayerClipboard,
duplicateCanvasLayers,
flipCanvasLayers,
getCanvasLayersByIds,
groupCanvasLayers,
moveCanvasLayers,
removeCanvasLayers,
resolveContextTargetLayerIds,
toggleCanvasLayersLock,
toggleCanvasLayersVisibility,
ungroupCanvasLayers,
updateCanvasLayersByIds,
type CanvasLayerFlipAxis,
type CanvasLayerMoveMode,
} from './ImageCanvasLayerCommandModel';
import {
getCanvasGenerationDialogIdFromSelectionId,
getSelectedLayerIds,
} from './ImageCanvasSelectionModel';
type LayerCommandsOptions = {
layers: CanvasLayer[];
contextMenu: CanvasContextMenuState | null;
selectedLayerId: string | null;
selectedLayerIds: string[];
canvasGenerationDialogs?: CanvasGenerationDialogState[];
setLayers: Dispatch<SetStateAction<CanvasLayer[]>>;
setSelectedLayerId: Dispatch<SetStateAction<string | null>>;
setSelectedLayerIds: Dispatch<SetStateAction<string[]>>;
setHoveredLayerId: Dispatch<SetStateAction<string | null>>;
setMetadataLayer: Dispatch<SetStateAction<CanvasLayer | null>>;
setContextMenu: Dispatch<SetStateAction<CanvasContextMenuState | null>>;
setImageContextMenu: (menu: null) => void;
setActiveTool: (tool: 'select') => void;
captureCanvasHistory: () => void;
selectSingleLayer: (layerId: string | null) => void;
onDeleteLayerSideEffects: (targetLayerId: string) => void;
onDeleteGenerationDialogSideEffects?: (targetDialogId: string) => void;
exportLayerImage: (layer: CanvasLayer | null) => void;
};
function createGroupId() {
return `layer-group-${Date.now()}`;
}
export function useImageCanvasLayerCommands({
layers,
contextMenu,
selectedLayerId,
selectedLayerIds,
canvasGenerationDialogs = [],
setLayers,
setSelectedLayerId,
setSelectedLayerIds,
setHoveredLayerId,
setMetadataLayer,
setContextMenu,
setImageContextMenu,
setActiveTool,
captureCanvasHistory,
selectSingleLayer,
onDeleteLayerSideEffects,
onDeleteGenerationDialogSideEffects,
exportLayerImage,
}: LayerCommandsOptions) {
const [canvasClipboard, setCanvasClipboard] =
useState<CanvasClipboard | null>(null);
const getContextTargetLayerIds = useCallback(
(menu: CanvasContextMenuState | null = contextMenu) =>
resolveContextTargetLayerIds(menu, selectedLayerIds),
[contextMenu, selectedLayerIds],
);
const getSelectedTargetLayerIds = useCallback(() => {
const targetIds = selectedLayerIds.length
? selectedLayerIds
: selectedLayerId
? [selectedLayerId]
: [];
return getSelectedLayerIds(targetIds);
}, [selectedLayerId, selectedLayerIds]);
const duplicateLayersToPoint = useCallback(
(
sourceLayers: CanvasLayer[],
canvasPoint?: { x: number; y: number },
options: { renameCopies?: boolean } = {},
) =>
duplicateCanvasLayers({
sourceLayers,
allLayers: layers,
canvasPoint,
renameCopies: options.renameCopies !== false,
}),
[layers],
);
const pasteCanvasClipboard = useCallback(
(canvasPoint?: { x: number; y: number }) => {
if (!canvasClipboard?.layers.length) {
return;
}
const nextLayers = duplicateLayersToPoint(
canvasClipboard.layers,
canvasPoint,
{
renameCopies: canvasClipboard.mode !== 'cut',
},
);
if (!nextLayers.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) => [...currentLayers, ...nextLayers]);
setSelectedLayerIds(nextLayers.map((layer) => layer.id));
setSelectedLayerId(nextLayers[0]?.id ?? null);
setActiveTool('select');
setContextMenu(null);
},
[
canvasClipboard,
captureCanvasHistory,
duplicateLayersToPoint,
setActiveTool,
setContextMenu,
setLayers,
setSelectedLayerId,
setSelectedLayerIds,
],
);
const copyContextLayers = useCallback(
(options: { cut?: boolean } = {}) => {
const targetIds = getContextTargetLayerIds();
const clipboard = createCanvasLayerClipboard(
layers,
targetIds,
options.cut ? 'cut' : 'copy',
);
if (!clipboard) {
return;
}
setCanvasClipboard(clipboard);
if (options.cut) {
captureCanvasHistory();
setLayers((currentLayers) =>
removeCanvasLayers(currentLayers, targetIds),
);
selectSingleLayer(null);
setMetadataLayer((currentLayer) =>
currentLayer && targetIds.includes(currentLayer.id)
? null
: currentLayer,
);
}
setContextMenu(null);
},
[
captureCanvasHistory,
getContextTargetLayerIds,
layers,
selectSingleLayer,
setContextMenu,
setLayers,
setMetadataLayer,
],
);
const copySelectedLayers = useCallback(
(options: { cut?: boolean } = {}) => {
const targetIds = getSelectedTargetLayerIds();
const clipboard = createCanvasLayerClipboard(
layers,
targetIds,
options.cut ? 'cut' : 'copy',
);
if (!clipboard) {
return;
}
setCanvasClipboard(clipboard);
if (options.cut) {
captureCanvasHistory();
setLayers((currentLayers) =>
removeCanvasLayers(currentLayers, targetIds),
);
selectSingleLayer(null);
setMetadataLayer((currentLayer) =>
currentLayer && targetIds.includes(currentLayer.id)
? null
: currentLayer,
);
targetIds.forEach((targetId) => onDeleteLayerSideEffects(targetId));
}
setContextMenu(null);
setImageContextMenu(null);
},
[
captureCanvasHistory,
getSelectedTargetLayerIds,
layers,
onDeleteLayerSideEffects,
selectSingleLayer,
setContextMenu,
setImageContextMenu,
setLayers,
setMetadataLayer,
],
);
const duplicateContextLayers = useCallback(() => {
const targetIds = getContextTargetLayerIds();
const targetLayers = getCanvasLayersByIds(layers, targetIds);
const nextLayers = duplicateLayersToPoint(targetLayers);
if (!nextLayers.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) => [...currentLayers, ...nextLayers]);
setSelectedLayerIds(nextLayers.map((layer) => layer.id));
setSelectedLayerId(nextLayers[0]?.id ?? null);
setContextMenu(null);
}, [
captureCanvasHistory,
duplicateLayersToPoint,
getContextTargetLayerIds,
layers,
setContextMenu,
setLayers,
setSelectedLayerId,
setSelectedLayerIds,
]);
const duplicateSelectedLayers = useCallback(() => {
const targetIds = getSelectedTargetLayerIds();
const targetLayers = getCanvasLayersByIds(layers, targetIds);
const nextLayers = duplicateLayersToPoint(targetLayers);
if (!nextLayers.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) => [...currentLayers, ...nextLayers]);
setSelectedLayerIds(nextLayers.map((layer) => layer.id));
setSelectedLayerId(nextLayers[0]?.id ?? null);
setContextMenu(null);
setImageContextMenu(null);
}, [
captureCanvasHistory,
duplicateLayersToPoint,
getSelectedTargetLayerIds,
layers,
setContextMenu,
setImageContextMenu,
setLayers,
setSelectedLayerId,
setSelectedLayerIds,
]);
const updateContextLayers = useCallback(
(updater: (layer: CanvasLayer, targetIds: string[]) => CanvasLayer) => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
updateCanvasLayersByIds(currentLayers, targetIds, updater),
);
setContextMenu(null);
},
[captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers],
);
const moveContextLayers = useCallback(
(mode: CanvasLayerMoveMode) => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
moveCanvasLayers(currentLayers, targetIds, mode),
);
setContextMenu(null);
},
[captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers],
);
const moveSelectedLayers = useCallback(
(mode: CanvasLayerMoveMode) => {
const targetIds = getSelectedTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
moveCanvasLayers(currentLayers, targetIds, mode),
);
setContextMenu(null);
setImageContextMenu(null);
},
[
captureCanvasHistory,
getSelectedTargetLayerIds,
setContextMenu,
setImageContextMenu,
setLayers,
],
);
const groupContextLayers = useCallback(() => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
groupCanvasLayers(currentLayers, targetIds, createGroupId()),
);
setContextMenu(null);
}, [captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers]);
const ungroupContextLayers = useCallback(() => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) => ungroupCanvasLayers(currentLayers, targetIds));
setContextMenu(null);
}, [captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers]);
const toggleContextLayerVisibility = useCallback(() => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
toggleCanvasLayersVisibility(currentLayers, targetIds),
);
setContextMenu(null);
}, [captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers]);
const toggleContextLayerLock = useCallback(() => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
toggleCanvasLayersLock(currentLayers, targetIds),
);
setContextMenu(null);
}, [captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers]);
const flipContextLayers = useCallback(
(axis: CanvasLayerFlipAxis) => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
flipCanvasLayers(currentLayers, targetIds, axis),
);
setContextMenu(null);
},
[captureCanvasHistory, getContextTargetLayerIds, setContextMenu, setLayers],
);
const deleteContextLayers = useCallback(() => {
const targetIds = getContextTargetLayerIds();
if (!targetIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) => removeCanvasLayers(currentLayers, targetIds));
selectSingleLayer(null);
setHoveredLayerId(null);
setMetadataLayer((currentLayer) =>
currentLayer && targetIds.includes(currentLayer.id) ? null : currentLayer,
);
setContextMenu(null);
}, [
captureCanvasHistory,
getContextTargetLayerIds,
selectSingleLayer,
setContextMenu,
setHoveredLayerId,
setLayers,
setMetadataLayer,
]);
const exportContextLayer = useCallback(() => {
const targetIds = getContextTargetLayerIds();
const targetLayer = layers.find((layer) => targetIds.includes(layer.id));
exportLayerImage(targetLayer ?? null);
setContextMenu(null);
setImageContextMenu(null);
}, [
exportLayerImage,
getContextTargetLayerIds,
layers,
setContextMenu,
setImageContextMenu,
]);
const deleteLayerById = useCallback(
(targetLayerId: string | null) => {
if (!targetLayerId) {
return;
}
setImageContextMenu(null);
setContextMenu(null);
captureCanvasHistory();
setLayers((currentLayers) => {
const nextLayers = currentLayers.filter(
(layer) => layer.id !== targetLayerId,
);
const nextSelectedLayer = nextLayers
.slice()
.sort((left, right) => right.zIndex - left.zIndex)[0];
selectSingleLayer(nextSelectedLayer?.id ?? null);
return nextLayers;
});
setHoveredLayerId(null);
setMetadataLayer((currentLayer) =>
currentLayer?.id === targetLayerId ? null : currentLayer,
);
onDeleteLayerSideEffects(targetLayerId);
},
[
captureCanvasHistory,
onDeleteLayerSideEffects,
selectSingleLayer,
setContextMenu,
setHoveredLayerId,
setImageContextMenu,
setLayers,
setMetadataLayer,
],
);
const deleteSelectedLayer = useCallback(() => {
const targetIds = selectedLayerIds.length
? selectedLayerIds
: selectedLayerId
? [selectedLayerId]
: [];
const targetLayerIds = getSelectedLayerIds(targetIds);
const targetDialogIds = targetIds
.map(getCanvasGenerationDialogIdFromSelectionId)
.filter((dialogId): dialogId is string => Boolean(dialogId))
.filter((dialogId) =>
canvasGenerationDialogs.some((dialog) => dialog.id === dialogId),
);
if (!targetLayerIds.length && !targetDialogIds.length) {
return;
}
if (targetLayerIds.length === 1 && !targetDialogIds.length) {
deleteLayerById(targetLayerIds[0] ?? null);
return;
}
captureCanvasHistory();
setImageContextMenu(null);
setContextMenu(null);
if (targetLayerIds.length) {
setLayers((currentLayers) => {
const nextLayers = currentLayers.filter(
(layer) => !targetLayerIds.includes(layer.id),
);
if (!targetDialogIds.length) {
const nextSelectedLayer = nextLayers
.slice()
.sort((left, right) => right.zIndex - left.zIndex)[0];
selectSingleLayer(nextSelectedLayer?.id ?? null);
}
return nextLayers;
});
}
if (targetDialogIds.length || !targetLayerIds.length) {
selectSingleLayer(null);
}
setHoveredLayerId(null);
setMetadataLayer((currentLayer) =>
currentLayer && targetLayerIds.includes(currentLayer.id)
? null
: currentLayer,
);
targetLayerIds.forEach((targetId) => onDeleteLayerSideEffects(targetId));
targetDialogIds.forEach((targetId) =>
onDeleteGenerationDialogSideEffects?.(targetId),
);
}, [
captureCanvasHistory,
canvasGenerationDialogs,
deleteLayerById,
onDeleteGenerationDialogSideEffects,
onDeleteLayerSideEffects,
selectSingleLayer,
selectedLayerId,
selectedLayerIds,
setContextMenu,
setHoveredLayerId,
setImageContextMenu,
setLayers,
setMetadataLayer,
]);
const groupSelectedLayers = useCallback(() => {
const targetIds = selectedLayerIds.length
? selectedLayerIds
: selectedLayerId
? [selectedLayerId]
: [];
const targetLayerIds = getSelectedLayerIds(targetIds);
if (!targetLayerIds.length) {
return;
}
captureCanvasHistory();
setLayers((currentLayers) =>
groupCanvasLayers(currentLayers, targetLayerIds, createGroupId()),
);
}, [captureCanvasHistory, selectedLayerId, selectedLayerIds, setLayers]);
return {
canvasClipboard,
getContextTargetLayerIds,
pasteCanvasClipboard,
copyContextLayers,
copySelectedLayers,
duplicateContextLayers,
duplicateSelectedLayers,
updateContextLayers,
moveContextLayers,
moveSelectedLayers,
groupContextLayers,
ungroupContextLayers,
toggleContextLayerVisibility,
toggleContextLayerLock,
flipContextLayers,
deleteContextLayers,
exportContextLayer,
deleteLayerById,
deleteSelectedLayer,
groupSelectedLayers,
};
}