AI-native design editor. Open-source Figma alternative.
import type { SceneGraph } from '@open-pencil/scene-graph'
import {
createSceneMutationImpact,
recordSceneMutations,
type SceneMutationImpact
} from '@open-pencil/scene-graph/mutation-impact'
import { createLayoutRunner } from '#core/layout/mutations'
interface PendingLayout {
impact: SceneMutationImpact
flushing: boolean
}
const pendingByGraph = new WeakMap<SceneGraph, PendingLayout>()
function clearImpact(impact: SceneMutationImpact): void {
for (const ids of Object.values(impact)) ids.clear()
}
function mergeImpact(into: SceneMutationImpact, from: SceneMutationImpact): void {
for (const key of Object.keys(into) as (keyof SceneMutationImpact)[]) {
for (const id of from[key]) into[key].add(id)
}
}
/**
* Records the graph's edits so that reading geometry lays out what they touched first, as Figma
* does: a script that fills a child and then reads its width sees the filled width. A graph has
* one recorder for its lifetime, kept across APIs: a script that failed before its tool laid
* out its edits leaves them for the next read to lay out.
*/
export function startPendingLayout(graph: SceneGraph): void {
if (pendingByGraph.has(graph)) return
const pending: PendingLayout = { impact: createSceneMutationImpact(), flushing: false }
pendingByGraph.set(graph, pending)
// Layout's own writes are its result, not new edits.
recordSceneMutations(graph, pending.impact, () => !pending.flushing && !graph.isApplyingLayout)
}
/** Lays out the edits recorded since the last geometry read. */
export function flushPendingLayout(graph: SceneGraph): void {
const pending = pendingByGraph.get(graph)
if (!pending || pending.flushing || pending.impact.changedNodeIds.size === 0) return
const impact = structuredClone(pending.impact)
clearImpact(pending.impact)
pending.flushing = true
try {
createLayoutRunner(() => graph).runLayoutForImpact(impact)
} catch (error) {
// The edits are still unlaid out, so the next read tries again.
mergeImpact(pending.impact, impact)
throw error
} finally {
pending.flushing = false
}
}