Files
ttstd-infinite-canvas/web/src/components/canvas/canvas-video-prompt-tools.tsx
T
爱笑的毛毛虫andsikongyue d22526506d feat(canvas): 设计token系统 - 建立三层架构骨架 (#101)
* feat(canvas): 设计token系统 - 建立三层架构骨架 #94 #96

建立 Primitive→Semantic→Component 三层设计 token 体系,覆盖 9 个维度:
色彩/间距/字号/圆角/阴影/Elevation/动效/描边/不透明度。

- Primitive 层:纯值无语义,含 neutral 色板+节点类型色板+状态色、
  4px 栅格间距、10档字号、10档圆角、阴影+glow、12档 z-index、
  动效(duration+easing+delay+motion-scale)、描边、不透明度
- Semantic 层:引用 Primitive,随主题切换,含通用语义色、
  Canvas 语义(--cn-*)、Aceternity spatial 语义、节点类型语义、状态语义
- Component 层:引用 Semantic,含 Dock/Node/Modal/Panel/Prompt面板/
  进度条/缩放控制专属 token
- @theme inline 映射:节点类型色、状态色、Canvas 语义色、字号映射到 Tailwind utility
- prefers-reduced-motion 三级降级(L0正常/L1简化/L2禁用)
- AGENTS.md 新增 Design Token 使用规范,禁止新增裸 px 值
- 附带修复 canvas-drawing-excalidraw-editor.tsx TS7006 类型注解
- 附带修复 canvas-drawing-editor-modal.tsx TS2339 engine 字段缺失

Wayfinder 决策来源:#95 #96 #97 #98 #99

* fix(canvas): 设计token系统 - 修复CSS变量循环引用和命名兼容性 #94 #96

修复两个问题:

1. CSS变量循环引用:Primitive层 --color-node-*/--color-status-* 与
   @theme inline 中的 --color-node-*/--color-status-* 同名,经 Semantic
   层中转后形成循环(A→B→A)。改用 --palette- 前缀隔离 Primitive 色板,
   打断循环链路。

2. 变量名小数点兼容性:--space-0.5/1.5/2.5/3.5 中的小数点被部分 CSS
   linter 误判为类选择器。改为 --space-half/-1-half/-2-half/-3-half,
   保持语义清晰的同时提升工具链兼容性。

* refactor(canvas): 画布核心组件 - 迁移硬编码值到设计token #94

批次1:5个画布核心组件的裸 text-[Npx]/rounded-[Npx]/z-[N] 替换为
对应设计token,统一视觉语言:

- canvas-node.tsx:text-[10/11/9/17px]→fs-tiny/label/micro/heading-lg,
  rounded-[18px]→node-radius
- canvas-node-hover-toolbar.tsx:text-[11/17/10/9px]→fs-*,
  rounded-[14/9px]→dock-radius/dock-item-radius,z-[70]→z-panel-floating
- canvas-toolbar.tsx:text-[9/10/11px]→fs-*,
  rounded-[17/16/11/10px]→panel-radius/dock-item-radius-*,
  z-[30/40]→z-toolbar/z-toolbar-floating
- canvas-assistant-panel.tsx:text-[8/9/10/11px]→fs-*
- canvas-script-node.tsx:text-[9/10/11px]→fs-*

视觉零回归(token值与原硬编码值一致),代码可维护性提升。

* refactor(canvas): 画布辅助组件 - 迁移硬编码值到设计token #94

批次2:6个画布辅助组件的裸 text-[Npx]/rounded-[Npx]/z-[N] 替换为
对应设计token:

- canvas-style-picker-modal.tsx:text-[10/11px]→fs-tiny/label
- canvas-file-drop-overlay.tsx:z-[110]→z-modal-overlay,
  rounded-[28/20px]→r-5xl/r-3xl
- canvas-character-reference-node.tsx:text-[10px]→fs-tiny
- canvas-drawing-editor-modal.tsx:text-[11px]→fs-label
- canvas-video-prompt-tools.tsx:z-[1500]→z-toast,
  rounded-[12/10px]→r-lg/dock-item-radius
- asset-picker-modal.tsx:text-[10px]→fs-tiny

视觉零回归(token值与原硬编码值一致)。

* refactor(*): 全项目硬编码值 - 批量迁移到设计token #94

批次3:全项目 .tsx 文件中 372 处裸 text-[Npx]/rounded-[Npx] 批量
替换为对应设计token,剩余 25 处无直接 token 对应的低频值保留。

替换覆盖(按频率):
- text-[10px]→fs-tiny (132处)
- text-[11px]→fs-label (100处)
- text-[9px]→fs-micro (45处)
- text-[12px]→fs-caption, text-[13/14px]→fs-body, text-[15px]→fs-body-lg
- text-[18px]→fs-heading-lg, text-[22px]→fs-title, text-[8px]→fs-micro
- rounded-[9/10px]→dock-item-radius, rounded-[12px]→r-lg
- rounded-[14px]→dock-radius, rounded-[16px]→r-2xl
- rounded-[17px]→panel-radius, rounded-[8px]→r-md

涉及 components/ 和 pages/ 下所有 .tsx 文件。
视觉零回归(token值与原硬编码值一致)。

* feat(canvas): 节点视觉层次规范 - 色带+状态徽章+四态递进 #97 #94

基于 Wayfinder 地图 #97 决议执行节点视觉重设计:

1. 节点类型色带(决策1)
   - 新增 nodeTypeColorVar() 函数,10种节点类型对应色带色
   - 节点左侧3px色条,引用 --cn-type-* token
   - 远距离最强信号,用户扫视画布即可识别节点类型

2. 节点状态徽章(决策2)
   - 新增 NodeStatusBadge 组件,loading/success/error 三态
   - 左上角圆角徽章,backdrop-blur 玻璃质感
   - success 态 2s 后自动淡出(canvas-status-success-fade 动画)

3. 四态递进视觉权重(决策3)
   - idle:无额外阴影
   - hover:轻微抬升阴影(16px 48px)
   - selected:2px 边框环(accent.primary 40% 透明度)
   - selected-primary:4px 软色环 + resize handle
   - active:6px 外发光环 + inner glow(最强强调)
   - 120-150ms ease-out 过渡

4. 阴影迁移
   - boxShadow 从硬编码改为分层语义化表达
   - 边框色 hover 态使用 color-mix 动态加深

Closes #97

---------

Co-authored-by: sikongyue <3155157671@qq.com>
2026-08-03 21:38:38 +08:00

222 lines
9.9 KiB
TypeScript

import { type CSSProperties, type ReactNode, useEffect, useLayoutEffect, useRef, useState } from "react";
import { createPortal } from "react-dom";
import { Check, ChevronDown, Image as ImageIcon } from "lucide-react";
import { canvasThemes, type CanvasTheme } from "@/lib/canvas-theme";
import { useThemeStore } from "@/stores/use-theme-store";
import type { CanvasNodeMetadata } from "@/types/canvas";
type VideoFrameOption = {
nodeId: string;
label: string;
title: string;
previewUrl?: string;
};
type CompactMenuItem = {
value: string;
label: string;
previewUrl?: string;
};
type CanvasVideoPromptToolsProps = {
metadata?: CanvasNodeMetadata;
frameOptions: VideoFrameOption[];
onMetadataChange: (patch: Partial<CanvasNodeMetadata>) => void;
};
const EMPTY_FRAME_VALUE = "__none__";
const MENU_GAP = 6;
const MENU_MARGIN = 8;
const MENU_ITEM_HEIGHT = 28;
const CONTROL_TEXT_STYLE: CSSProperties = { fontFamily: "inherit", fontSize: 11, fontWeight: 400, letterSpacing: 0, lineHeight: 1 };
export function CanvasVideoPromptTools({ metadata, frameOptions, onMetadataChange }: CanvasVideoPromptToolsProps) {
const theme = canvasThemes[useThemeStore((state) => state.theme)];
const startFrame = metadata?.videoStartFrameNodeId || EMPTY_FRAME_VALUE;
const endFrame = metadata?.videoEndFrameNodeId || EMPTY_FRAME_VALUE;
const setFrame = (key: "videoStartFrameNodeId" | "videoEndFrameNodeId", value: string) => {
const next = value === EMPTY_FRAME_VALUE ? undefined : value;
onMetadataChange(key === "videoStartFrameNodeId" ? { videoStartFrameNodeId: next } : { videoEndFrameNodeId: next });
};
if (!frameOptions.length) return null;
return (
<div
className="grid min-w-0 grid-cols-2 items-center gap-1"
data-canvas-no-zoom
onMouseDown={(event) => event.stopPropagation()}
onPointerDown={(event) => event.stopPropagation()}
>
<FrameMenu label="首帧" value={startFrame} options={frameOptions} theme={theme} onChange={(value) => setFrame("videoStartFrameNodeId", value)} />
<FrameMenu label="尾帧" value={endFrame} options={frameOptions} theme={theme} onChange={(value) => setFrame("videoEndFrameNodeId", value)} />
</div>
);
}
function FrameMenu({ label, value, options, theme, onChange }: { label: string; value: string; options: VideoFrameOption[]; theme: CanvasTheme; onChange: (value: string) => void }) {
const selected = options.find((item) => item.nodeId === value);
const items = [{ value: EMPTY_FRAME_VALUE, label: "不指定" }, ...options.map((option) => ({ value: option.nodeId, label: `${option.label} · ${option.title}`, previewUrl: option.previewUrl }))];
return (
<CompactMenuButton
theme={theme}
title={label}
label={selected?.label || label}
icon={<ImageIcon className="size-3.5 shrink-0 opacity-90" />}
value={value}
items={items}
menuWidth={220}
maxMenuHeight={208}
onSelect={onChange}
/>
);
}
function CompactMenuButton({
theme,
title,
label,
icon,
value,
items,
menuWidth,
maxMenuHeight,
onSelect,
}: {
theme: CanvasTheme;
title: string;
label: string;
icon: ReactNode;
value?: string;
items: CompactMenuItem[];
menuWidth: number;
maxMenuHeight: number;
onSelect: (value: string) => void;
}) {
const triggerRef = useRef<HTMLButtonElement>(null);
const menuRef = useRef<HTMLDivElement>(null);
const [open, setOpen] = useState(false);
const [position, setPosition] = useState<{ left: number; top: number; width: number; maxHeight: number } | null>(null);
const updatePosition = () => {
const rect = triggerRef.current?.getBoundingClientRect();
if (!rect) return;
const menuHeight = Math.min(maxMenuHeight, items.length * MENU_ITEM_HEIGHT + 8);
const effectiveMenuWidth = Math.max(menuWidth, Math.round(rect.width));
const openAbove = rect.bottom + MENU_GAP + menuHeight > window.innerHeight && rect.top > menuHeight + MENU_GAP;
const maxLeft = Math.max(MENU_MARGIN, window.innerWidth - effectiveMenuWidth - MENU_MARGIN);
const maxTop = Math.max(MENU_MARGIN, window.innerHeight - menuHeight - MENU_MARGIN);
const left = Math.min(Math.max(MENU_MARGIN, rect.left), maxLeft);
const top = openAbove ? Math.max(MENU_MARGIN, rect.top - menuHeight - MENU_GAP) : Math.min(Math.max(MENU_MARGIN, rect.bottom + MENU_GAP), maxTop);
setPosition({ left, top, maxHeight: menuHeight, width: effectiveMenuWidth });
};
useLayoutEffect(() => {
if (open) updatePosition();
}, [open, items.length, maxMenuHeight, menuWidth]);
useEffect(() => {
if (!open) return;
const close = (event: PointerEvent) => {
const target = event.target instanceof Node ? event.target : null;
if (target && (triggerRef.current?.contains(target) || menuRef.current?.contains(target))) return;
setOpen(false);
};
const closeOnEscape = (event: KeyboardEvent) => {
if (event.key === "Escape") setOpen(false);
};
const reposition = () => updatePosition();
document.addEventListener("pointerdown", close, true);
document.addEventListener("keydown", closeOnEscape, true);
window.addEventListener("resize", reposition);
window.addEventListener("scroll", reposition, true);
return () => {
document.removeEventListener("pointerdown", close, true);
document.removeEventListener("keydown", closeOnEscape, true);
window.removeEventListener("resize", reposition);
window.removeEventListener("scroll", reposition, true);
};
}, [open, items.length, maxMenuHeight, menuWidth]);
const buttonStyle: CSSProperties = { ...CONTROL_TEXT_STYLE, color: theme.node.text };
const menuStyle: CSSProperties | undefined = position
? {
left: position.left,
top: position.top,
width: position.width,
maxHeight: position.maxHeight,
background: theme.toolbar.panel,
borderColor: theme.toolbar.border,
color: theme.node.text,
boxShadow: "0 10px 26px rgba(15,23,42,.14)",
}
: undefined;
const listStyle: CSSProperties | undefined = position ? { maxHeight: Math.max(0, position.maxHeight - 8) } : undefined;
const menu =
open && position && typeof document !== "undefined"
? createPortal(
<div
ref={menuRef}
data-canvas-no-zoom
className="fixed z-[var(--z-toast)] overflow-hidden rounded-[var(--r-lg)] border p-1 backdrop-blur-xl"
style={menuStyle}
onMouseDown={(event) => event.stopPropagation()}
onPointerDown={(event) => event.stopPropagation()}
onWheel={(event) => event.stopPropagation()}
>
<div className="thin-scrollbar overflow-y-auto" style={listStyle}>
{items.map((item) => {
const selected = value === item.value;
return (
<button
key={item.value}
type="button"
className="flex h-7 w-full min-w-0 items-center gap-1.5 rounded-lg px-2 text-left transition"
style={{ ...CONTROL_TEXT_STYLE, background: selected ? theme.toolbar.itemHover : "transparent", color: selected ? theme.toolbar.activeText : theme.node.text }}
onMouseEnter={(event) => {
event.currentTarget.style.background = theme.toolbar.itemHover;
}}
onMouseLeave={(event) => {
event.currentTarget.style.background = selected ? theme.toolbar.itemHover : "transparent";
}}
onClick={() => {
onSelect(item.value);
setOpen(false);
}}
>
{item.previewUrl ? <img src={item.previewUrl} alt="" className="size-4 shrink-0 rounded object-cover" /> : null}
<span className="min-w-0 flex-1 truncate">{item.label}</span>
{selected ? <Check className="size-3.5 shrink-0" /> : null}
</button>
);
})}
</div>
</div>,
document.body,
)
: null;
return (
<>
<button
ref={triggerRef}
type="button"
className="inline-flex h-6 w-full min-w-0 items-center gap-1 rounded-[var(--dock-item-radius)] border-0 bg-transparent px-1.5 shadow-none transition hover:opacity-80 focus-visible:outline-none focus-visible:ring-1"
style={buttonStyle}
title={title}
onClick={() => setOpen((value) => !value)}
onMouseDown={(event) => event.stopPropagation()}
onPointerDown={(event) => event.stopPropagation()}
>
{icon}
<span className="min-w-0 flex-1 truncate text-left">{label}</span>
<ChevronDown className="size-3 shrink-0 opacity-55" />
</button>
{menu}
</>
);
}