Image Pipeline Playground
feat(frontend/store): track project identity and dirty state
Mohammad Rajaeiaa378cbfa60c
diff --git a/frontend/src/hooks/useWorkflowPersistence.ts b/frontend/src/hooks/useWorkflowPersistence.tsindex c5cb1ed..ea839f2 100644--- a/frontend/src/hooks/useWorkflowPersistence.ts+++ b/frontend/src/hooks/useWorkflowPersistence.ts@@ -18,6 +18,9 @@ export function useWorkflowPersistence() {const edges = useGraphStore((s) => s.edges)const seed = useGraphStore((s) => s.seed)const sampleCount = useGraphStore((s) => s.sampleCount)+ const projectId = useGraphStore((s) => s.projectId)+ const projectName = useGraphStore((s) => s.projectName)+ const projectDescription = useGraphStore((s) => s.projectDescription)const [sessionReady, setSessionReady] = useState(false)const restoredRef = useRef(false)@@ -57,7 +60,17 @@ export function useWorkflowPersistence() {saveWorkflowSession(doc, doc.id ?? null)}, SAVE_DEBOUNCE_MS)return () => window.clearTimeout(timer)- }, [sessionReady, nodes, edges, seed, sampleCount, toWorkflowDocument])+ }, [+ sessionReady,+ nodes,+ edges,+ seed,+ sampleCount,+ projectId,+ projectName,+ projectDescription,+ toWorkflowDocument,+ ])useEffect(() => {if (!sessionReady) returndiff --git a/frontend/src/store/graphStore.ts b/frontend/src/store/graphStore.tsindex 4e7c77f..064ec4b 100644--- a/frontend/src/store/graphStore.ts+++ b/frontend/src/store/graphStore.ts@@ -10,7 +10,11 @@ import {} from '@xyflow/react'import { create } from 'zustand'import type { ExecutionPreview, GraphNodeData, NodeMetadata } from '../types'-import type { WorkflowDocument, WorkflowGraphPayload } from '../workflow/io'+import {+ DEFAULT_PROJECT_NAME,+ type WorkflowDocument,+ type WorkflowGraphPayload,+} from '../workflow/io'import { portTypeColor } from '../lib/portTypes'@@ -54,6 +58,12 @@ interface GraphState {sampleCount: number/** Bumped on loadWorkflow so the canvas can refit the viewport. */graphRevision: number+ projectId: string | null+ projectName: string+ projectDescription: string+ projectCreatedAt: string | null+ projectUpdatedAt: string | null+ projectDirty: booleansetNodeCatalog: (catalog: NodeMetadata[]) => voidonNodesChange: (changes: NodeChange<PipelineNode>[]) => voidonEdgesChange: (changes: EdgeChange[]) => void@@ -80,6 +90,16 @@ interface GraphState {setIsExecuting: (value: boolean) => voidsetSeed: (seed: number) => voidsetSampleCount: (count: number) => void+ setProjectMeta: (meta: { name?: string; description?: string }) => void+ markProjectDirty: () => void+ markProjectClean: (record?: {+ id: string+ name: string+ description?: string+ createdAt?: string+ updatedAt?: string+ }) => void+ newProject: () => voidgetInputImages: (nodeId: string) => string[]getResultImages: (nodeId: string) => string[]toGraphPayload: () => WorkflowGraphPayload@@ -87,6 +107,8 @@ interface GraphState {loadWorkflow: (doc: WorkflowDocument) => { skippedTypes: string[] }}+const STRUCTURAL_NODE_CHANGE_TYPES = new Set(['add', 'remove', 'position', 'replace'])+let nodeCounter = 1function syncNodeCounter(nodeIds: string[]) {@@ -145,6 +167,12 @@ export const useGraphStore = create<GraphState>((set, get) => ({seed: 0,sampleCount: 1,graphRevision: 0,+ projectId: null,+ projectName: DEFAULT_PROJECT_NAME,+ projectDescription: '',+ projectCreatedAt: null,+ projectUpdatedAt: null,+ projectDirty: false,setNodeCatalog: (catalog) => set({ nodeCatalog: catalog }),@@ -152,11 +180,15 @@ export const useGraphStore = create<GraphState>((set, get) => ({const removedIds = changes.filter((change) => change.type === 'remove').map((change) => change.id)+ const structural = changes.some((change) =>+ STRUCTURAL_NODE_CHANGE_TYPES.has(change.type),+ )set((state) => {const nodes = applyNodeChanges(changes, state.nodes)+ const dirtyPatch = structural && !state.projectDirty ? { projectDirty: true } : {}if (removedIds.length === 0) {- return { nodes }+ return { nodes, ...dirtyPatch }}const removed = new Set(removedIds)@@ -178,12 +210,20 @@ export const useGraphStore = create<GraphState>((set, get) => ({: state.selectedNodeId,activeNodeId:state.activeNodeId && removed.has(state.activeNodeId) ? null : state.activeNodeId,+ ...dirtyPatch,}})},- onEdgesChange: (changes) =>- set({ edges: applyEdgeChanges(changes, get().edges) }),+ onEdgesChange: (changes) => {+ const structural = changes.some(+ (change) => change.type === 'remove' || change.type === 'add' || change.type === 'replace',+ )+ set((state) => ({+ edges: applyEdgeChanges(changes, state.edges),+ ...(structural ? { projectDirty: true } : {}),+ }))+ },onConnect: (connection) => {const nodes = get().nodes@@ -208,6 +248,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({},get().edges,),+ projectDirty: true,})},@@ -228,7 +269,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({selectable: true,data: oldEdge.data ?? { waypoints: [] },})- set({ edges: next })+ set({ edges: next, projectDirty: true })},setEdgeWaypoints: (edgeId, waypoints) =>@@ -244,6 +285,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({}: edge,),+ projectDirty: true,}),addNodeFromType: (meta, position) => {@@ -262,7 +304,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({localPreviewUrls: [],},}- set({ nodes: [...get().nodes, node], selectedNodeId: id })+ set({ nodes: [...get().nodes, node], selectedNodeId: id, projectDirty: true })},removeNode: (nodeId) => {@@ -292,6 +334,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({set({nodes: [...get().nodes.map((node) => ({ ...node, selected: false })), copy],selectedNodeId: id,+ projectDirty: true,})},@@ -304,6 +347,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({? { ...node, data: { ...node.data, params: { ...node.data.params, ...params } } }: node,),+ projectDirty: true,}),setLocalPreview: (nodeId, dataUrl) =>@@ -320,6 +364,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({}: node,),+ projectDirty: true,}),setLocalPreviews: (nodeId, dataUrls, uploadedFiles = []) =>@@ -336,6 +381,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({}: node,),+ projectDirty: true,}),removeLocalPreview: (nodeId, index) => {@@ -374,6 +420,7 @@ export const useGraphStore = create<GraphState>((set, get) => ({: item,),sampleCount: Math.max(1, previews.length),+ projectDirty: true,})return { file: removedFile, path: nextPath }},@@ -457,8 +504,59 @@ export const useGraphStore = create<GraphState>((set, get) => ({}),setGeneratedCode: (code) => set({ generatedCode: code }),setIsExecuting: (value) => set({ isExecuting: value }),- setSeed: (seed) => set({ seed }),- setSampleCount: (count) => set({ sampleCount: Math.max(1, count) }),+ setSeed: (seed) => set({ seed, projectDirty: true }),+ setSampleCount: (count) => set({ sampleCount: Math.max(1, count), projectDirty: true }),++ setProjectMeta: (meta) =>+ set((state) => ({+ projectName:+ meta.name !== undefined+ ? meta.name.trim() || DEFAULT_PROJECT_NAME+ : state.projectName,+ projectDescription:+ meta.description !== undefined ? meta.description : state.projectDescription,+ projectDirty: true,+ })),++ markProjectDirty: () => set({ projectDirty: true }),++ markProjectClean: (record) =>+ set((state) => ({+ projectDirty: false,+ projectId: record?.id ?? state.projectId,+ projectName: record?.name ?? state.projectName,+ projectDescription:+ record?.description !== undefined+ ? record.description+ : state.projectDescription,+ projectCreatedAt: record?.createdAt ?? state.projectCreatedAt,+ projectUpdatedAt: record?.updatedAt ?? state.projectUpdatedAt,+ })),++ newProject: () => {+ nodeCounter = 1+ set({+ nodes: [],+ edges: [],+ selectedNodeId: null,+ activeNodeId: null,+ previews: [],+ nodeImages: {},+ logs: [],+ nodeTimings: {},+ isExecuting: false,+ generatedCode: '# Run codegen to export a Python script\n',+ seed: 0,+ sampleCount: 1,+ graphRevision: get().graphRevision + 1,+ projectId: null,+ projectName: DEFAULT_PROJECT_NAME,+ projectDescription: '',+ projectCreatedAt: null,+ projectUpdatedAt: null,+ projectDirty: false,+ })+ },getInputImages: (nodeId) => {const { edges, nodeImages, nodes } = get()@@ -521,10 +619,22 @@ export const useGraphStore = create<GraphState>((set, get) => ({},toWorkflowDocument: () => {- const { seed, sampleCount } = get()+ const {+ seed,+ sampleCount,+ projectId,+ projectName,+ projectDescription,+ projectCreatedAt,+ projectUpdatedAt,+ } = get()return {version: 1 as const,- name: 'Untitled',+ ...(projectId ? { id: projectId } : {}),+ name: projectName || DEFAULT_PROJECT_NAME,+ ...(projectDescription.trim() ? { description: projectDescription.trim() } : {}),+ ...(projectCreatedAt ? { createdAt: projectCreatedAt } : {}),+ ...(projectUpdatedAt ? { updatedAt: projectUpdatedAt } : {}),seed,sampleCount,graph: get().toGraphPayload(),@@ -603,6 +713,12 @@ export const useGraphStore = create<GraphState>((set, get) => ({seed: doc.seed,sampleCount: Math.max(1, doc.sampleCount),graphRevision: get().graphRevision + 1,+ projectId: doc.id ?? null,+ projectName: doc.name || DEFAULT_PROJECT_NAME,+ projectDescription: doc.description ?? '',+ projectCreatedAt: doc.createdAt ?? null,+ projectUpdatedAt: doc.updatedAt ?? null,+ projectDirty: false,})return { skippedTypes: [...skipped].sort() }diff --git a/frontend/src/workflow/projectActions.ts b/frontend/src/workflow/projectActions.tsnew file mode 100644index 0000000..7d10906--- /dev/null+++ b/frontend/src/workflow/projectActions.ts@@ -0,0 +1,127 @@+/** Project library orchestration used by the Projects UI. */++import { useGraphStore } from '../store/graphStore'+import { DEFAULT_PROJECT_NAME, type WorkflowDocument } from './io'+import { saveWorkflowSession } from './persist'+import {+ createProjectId,+ deleteProject as deleteLibraryProject,+ getProject,+ listProjects,+ type ProjectRecord,+ renameProject as renameLibraryProject,+ upsertProject,+} from './projectLibrary'++export function confirmDiscardIfDirty(message?: string): boolean {+ const dirty = useGraphStore.getState().projectDirty+ if (!dirty) return true+ return window.confirm(+ message ?? 'You have unsaved changes. Discard them and continue?',+ )+}++export function flushSession(): void {+ const doc = useGraphStore.getState().toWorkflowDocument()+ saveWorkflowSession(doc, doc.id ?? null)+}++export function openProject(id: string): { skippedTypes: string[] } {+ const record = getProject(id)+ if (!record) {+ throw new Error('Project not found')+ }+ const result = useGraphStore.getState().loadWorkflow(record)+ flushSession()+ return result+}++export function newProject(): void {+ useGraphStore.getState().newProject()+ flushSession()+}++export function saveProject(): ProjectRecord {+ const state = useGraphStore.getState()+ if (!state.projectId) {+ throw new Error('No saved project — use Save As')+ }+ const record = upsertProject(state.toWorkflowDocument())+ state.markProjectClean(record)+ flushSession()+ return record+}++export function saveProjectAs(meta: {+ name: string+ description?: string+}): ProjectRecord {+ const state = useGraphStore.getState()+ const name = meta.name.trim() || DEFAULT_PROJECT_NAME+ const description = meta.description?.trim() || undefined+ const record = upsertProject({+ ...state.toWorkflowDocument(),+ id: createProjectId(),+ name,+ ...(description ? { description } : { description: undefined }),+ createdAt: undefined,+ updatedAt: undefined,+ })+ state.markProjectClean(record)+ flushSession()+ return record+}++export function renameActiveProject(meta: {+ name: string+ description?: string+}): ProjectRecord | null {+ const state = useGraphStore.getState()+ const name = meta.name.trim() || DEFAULT_PROJECT_NAME+ const description = meta.description?.trim() || undefined+ if (!state.projectId) {+ state.setProjectMeta({ name, description: description ?? '' })+ return null+ }+ const record = renameLibraryProject(state.projectId, { name, description })+ if (record) {+ state.markProjectClean(record)+ flushSession()+ } else {+ state.setProjectMeta({ name, description: description ?? '' })+ }+ return record+}++export function deleteProjectById(id: string): void {+ deleteLibraryProject(id)+ const state = useGraphStore.getState()+ if (state.projectId === id) {+ // Detach from library without clearing the canvas.+ useGraphStore.setState({+ projectId: null,+ projectCreatedAt: null,+ projectUpdatedAt: null,+ projectDirty: true,+ })+ flushSession()+ }+}++/** Load a document that is not yet a library entry (file / template). */+export function loadExternalDocument(+ doc: WorkflowDocument,+ overrides?: { name?: string },+): { skippedTypes: string[] } {+ const { id: _id, ...withoutId } = doc+ void _id+ const result = useGraphStore.getState().loadWorkflow({+ ...withoutId,+ name: overrides?.name?.trim() || doc.name || DEFAULT_PROJECT_NAME,+ })+ flushSession()+ return result+}++export { listProjects, getProject }+export type { ProjectRecord }