@pascal-app/nodes 1.0.0-beta.5 → 1.0.0

package/dist/block/commands.js

@@ -0,0 +1,1144 @@
+import { blockUndirectedEdgeKey, getBlockFaceCentroid, getBlockFaceNormal, inspectBlockTopology, } from '@pascal-app/core';
+function normalize(point) {
+    const length = Math.hypot(point[0], point[1], point[2]);
+    if (length < 1e-8)
+        return null;
+    return [point[0] / length, point[1] / length, point[2] / length];
+}
+export function blockFaceNormal(topology, face) {
+    return getBlockFaceNormal(topology, face);
+}
+export function blockFaceCentroid(topology, face) {
+    return getBlockFaceCentroid(topology, face);
+}
+function nextNumericId(prefix, ids) {
+    const pattern = new RegExp(`^${prefix}(\\d+)$`);
+    let next = ids.reduce((highest, id) => {
+        const match = pattern.exec(id);
+        return match ? Math.max(highest, Number(match[1]) + 1) : highest;
+    }, 0);
+    const occupied = new Set(ids);
+    return () => {
+        let candidate = `${prefix}${next++}`;
+        while (occupied.has(candidate))
+            candidate = `${prefix}${next++}`;
+        occupied.add(candidate);
+        return candidate;
+    };
+}
+function oppositeOrientedEdgeVertices(face, orientedVertices) {
+    if (face.vertexIds.length !== 4)
+        return null;
+    const [from, to] = orientedVertices;
+    const index = face.vertexIds.indexOf(from);
+    if (index < 0)
+        return null;
+    if (face.vertexIds[(index + 1) % 4] === to) {
+        return [face.vertexIds[(index + 3) % 4], face.vertexIds[(index + 2) % 4]];
+    }
+    if (face.vertexIds[(index + 3) % 4] === to) {
+        return [face.vertexIds[(index + 1) % 4], face.vertexIds[(index + 2) % 4]];
+    }
+    return null;
+}
+function resolveLoopCutRing(topology, edgeId) {
+    const startEdge = topology.edges.find((edge) => edge.id === edgeId);
+    if (!startEdge)
+        return null;
+    const edgeByKey = new Map(topology.edges.map((edge) => [blockUndirectedEdgeKey(...edge.vertexIds), edge]));
+    const facesByEdgeId = new Map();
+    for (const face of topology.faces) {
+        for (let index = 0; index < face.vertexIds.length; index += 1) {
+            const edge = edgeByKey.get(blockUndirectedEdgeKey(face.vertexIds[index], face.vertexIds[(index + 1) % face.vertexIds.length]));
+            if (!edge)
+                return null;
+            const faces = facesByEdgeId.get(edge.id) ?? [];
+            faces.push(face);
+            facesByEdgeId.set(edge.id, faces);
+        }
+    }
+    const incidentStartFaces = facesByEdgeId.get(startEdge.id) ?? [];
+    if (incidentStartFaces.length === 0 || incidentStartFaces.length > 2)
+        return null;
+    const startFaces = incidentStartFaces.filter((face) => face.vertexIds.length === 4);
+    if (startFaces.length === 0)
+        return null;
+    const orientedEdgeVertices = new Map([
+        [startEdge.id, startEdge.vertexIds],
+    ]);
+    const queue = startFaces.map((face) => ({
+        edgeId: startEdge.id,
+        faceId: face.id,
+    }));
+    const visitedFaces = new Set();
+    const steps = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visitedFaces.has(current.faceId))
+            continue;
+        const face = topology.faces.find((entry) => entry.id === current.faceId);
+        const orientedVertices = orientedEdgeVertices.get(current.edgeId);
+        if (!(face && orientedVertices) || face.vertexIds.length !== 4)
+            return null;
+        const oppositeVertices = oppositeOrientedEdgeVertices(face, orientedVertices);
+        if (!oppositeVertices)
+            return null;
+        const oppositeEdge = edgeByKey.get(blockUndirectedEdgeKey(...oppositeVertices));
+        if (!oppositeEdge)
+            return null;
+        const existingOrientation = orientedEdgeVertices.get(oppositeEdge.id);
+        if (existingOrientation &&
+            (existingOrientation[0] !== oppositeVertices[0] ||
+                existingOrientation[1] !== oppositeVertices[1])) {
+            return null;
+        }
+        orientedEdgeVertices.set(oppositeEdge.id, oppositeVertices);
+        visitedFaces.add(face.id);
+        steps.push({
+            faceId: face.id,
+            fromEdgeId: current.edgeId,
+            toEdgeId: oppositeEdge.id,
+        });
+        const adjacentFaces = facesByEdgeId.get(oppositeEdge.id) ?? [];
+        if (adjacentFaces.length > 2)
+            return null;
+        for (const adjacentFace of adjacentFaces) {
+            if (adjacentFace.id === face.id || visitedFaces.has(adjacentFace.id))
+                continue;
+            if (adjacentFace.vertexIds.length !== 4)
+                continue;
+            queue.push({ edgeId: oppositeEdge.id, faceId: adjacentFace.id });
+        }
+    }
+    return steps.length > 0 ? { steps, orientedEdgeVertices } : null;
+}
+function interpolatePoint(from, to, factor) {
+    return [
+        from[0] + (to[0] - from[0]) * factor,
+        from[1] + (to[1] - from[1]) * factor,
+        from[2] + (to[2] - from[2]) * factor,
+    ];
+}
+export function blockLoopCutSegments(topology, edgeId, factor, cuts = 1) {
+    const ring = resolveLoopCutRing(topology, edgeId);
+    const fractions = loopCutFractions(factor, cuts);
+    if (!ring || !fractions)
+        return null;
+    const vertexById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex.position]));
+    const pointByEdgeId = new Map();
+    for (const [ringEdgeId, [fromId, toId]] of ring.orientedEdgeVertices) {
+        const from = vertexById.get(fromId);
+        const to = vertexById.get(toId);
+        if (!(from && to))
+            return null;
+        pointByEdgeId.set(ringEdgeId, fractions.map((fraction) => interpolatePoint(from, to, fraction)));
+    }
+    return ring.steps.flatMap((step) => fractions.map((_, index) => [
+        pointByEdgeId.get(step.fromEdgeId)[index],
+        pointByEdgeId.get(step.toEdgeId)[index],
+    ]));
+}
+function loopCutFractions(factor, cuts) {
+    const count = Math.floor(cuts);
+    if (!Number.isFinite(factor) ||
+        factor <= 0 ||
+        factor >= 1 ||
+        !Number.isFinite(cuts) ||
+        count < 1 ||
+        count > 32)
+        return null;
+    if (count === 1)
+        return [factor];
+    const spacing = 1 / (count + 1);
+    return Array.from({ length: count }, (_, index) => (index + 1) * spacing);
+}
+function augmentFaceLoop(face, cutVerticesByEdgeKey) {
+    const augmented = [];
+    for (let index = 0; index < face.vertexIds.length; index += 1) {
+        const current = face.vertexIds[index];
+        const next = face.vertexIds[(index + 1) % face.vertexIds.length];
+        augmented.push(current);
+        const cuts = cutVerticesByEdgeKey.get(blockUndirectedEdgeKey(current, next));
+        if (!cuts)
+            continue;
+        augmented.push(...(cuts.edgeOrder[0] === current ? cuts.ids : [...cuts.ids].reverse()));
+    }
+    return augmented;
+}
+function splitLoopByChord(loop, firstCutId, secondCutId) {
+    const firstIndex = loop.indexOf(firstCutId);
+    const secondIndex = loop.indexOf(secondCutId);
+    if (firstIndex < 0 || secondIndex < 0)
+        return null;
+    const walk = (start, end) => {
+        const result = [];
+        for (let index = start;; index = (index + 1) % loop.length) {
+            result.push(loop[index]);
+            if (index === end)
+                return result;
+        }
+    };
+    const first = walk(firstIndex, secondIndex);
+    const second = walk(secondIndex, firstIndex);
+    return first.length >= 3 && second.length >= 3 ? [first, second] : null;
+}
+function loopCut(topology, command) {
+    const fractions = loopCutFractions(command.factor, command.cuts ?? 1);
+    if (!fractions)
+        return {
+            ok: false,
+            error: 'Loop cut requires 1–32 cuts and a factor between 0 and 1',
+        };
+    const ring = resolveLoopCutRing(topology, command.edgeId);
+    if (!ring)
+        return {
+            ok: false,
+            error: 'Loop cut requires a connected ring of quad faces',
+        };
+    const vertexById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex]));
+    const edgeById = new Map(topology.edges.map((edge) => [edge.id, edge]));
+    const allocateVertexId = nextNumericId('v', topology.vertices.map((vertex) => vertex.id));
+    const allocateEdgeId = nextNumericId('e', topology.edges.map((edge) => edge.id));
+    const allocateFaceId = nextNumericId('f', topology.faces.map((face) => face.id));
+    const cutVerticesByEdgeId = new Map();
+    const cutVerticesByEdgeKey = new Map();
+    const newVertices = [];
+    for (const [ringEdgeId, [fromId, toId]] of ring.orientedEdgeVertices) {
+        const from = vertexById.get(fromId);
+        const to = vertexById.get(toId);
+        const edge = edgeById.get(ringEdgeId);
+        if (!(from && to && edge))
+            return { ok: false, error: 'Loop cut references missing topology' };
+        const ids = fractions.map(() => allocateVertexId());
+        cutVerticesByEdgeId.set(ringEdgeId, ids);
+        const edgeOrderIds = edge.vertexIds[0] === fromId ? ids : [...ids].reverse();
+        cutVerticesByEdgeKey.set(blockUndirectedEdgeKey(...edge.vertexIds), {
+            edgeOrder: edge.vertexIds,
+            ids: edgeOrderIds,
+        });
+        newVertices.push(...ids.map((id, index) => ({
+            id,
+            position: interpolatePoint(from.position, to.position, fractions[index]),
+        })));
+    }
+    const splitBoundaryEdges = topology.edges.flatMap((edge) => {
+        const cutIds = cutVerticesByEdgeKey.get(blockUndirectedEdgeKey(...edge.vertexIds))?.ids;
+        if (!cutIds)
+            return [edge];
+        const chain = [edge.vertexIds[0], ...cutIds, edge.vertexIds[1]];
+        return chain.slice(0, -1).map((vertexId, index) => ({
+            id: index === 0 ? edge.id : allocateEdgeId(),
+            vertexIds: [vertexId, chain[index + 1]],
+        }));
+    });
+    const stepByFaceId = new Map(ring.steps.map((step) => [step.faceId, step]));
+    const cutEdgeIds = [];
+    const cutEdges = [];
+    const faces = [];
+    for (const face of topology.faces) {
+        const step = stepByFaceId.get(face.id);
+        if (!step) {
+            const vertexIds = augmentFaceLoop(face, cutVerticesByEdgeKey);
+            faces.push(vertexIds.length === face.vertexIds.length ? face : { ...face, vertexIds });
+            continue;
+        }
+        const fromCutIds = cutVerticesByEdgeId.get(step.fromEdgeId);
+        const toCutIds = cutVerticesByEdgeId.get(step.toEdgeId);
+        if (!(fromCutIds && toCutIds))
+            return { ok: false, error: 'Loop cut references missing topology' };
+        let remaining = augmentFaceLoop(face, cutVerticesByEdgeKey);
+        const splitLoops = [];
+        for (let index = 0; index < fromCutIds.length; index += 1) {
+            const fromCutId = fromCutIds[index];
+            const toCutId = toCutIds[index];
+            const pair = splitLoopByChord(remaining, fromCutId, toCutId);
+            if (!pair)
+                return { ok: false, error: `Could not split quad face: ${face.id}` };
+            const cutEdgeId = allocateEdgeId();
+            cutEdgeIds.push(cutEdgeId);
+            cutEdges.push({ id: cutEdgeId, vertexIds: [fromCutId, toCutId] });
+            if (index === fromCutIds.length - 1) {
+                splitLoops.push(...pair);
+            }
+            else {
+                const nextFrom = fromCutIds[index + 1];
+                const nextTo = toCutIds[index + 1];
+                const remainingIndex = pair.findIndex((candidate) => candidate.includes(nextFrom) && candidate.includes(nextTo));
+                if (remainingIndex < 0)
+                    return {
+                        ok: false,
+                        error: `Could not order cuts on quad face: ${face.id}`,
+                    };
+                splitLoops.push(pair[1 - remainingIndex]);
+                remaining = pair[remainingIndex];
+            }
+        }
+        faces.push(...splitLoops.map((vertexIds, index) => ({
+            ...face,
+            id: index === 0 ? face.id : allocateFaceId(),
+            vertexIds,
+        })));
+    }
+    const nextTopology = {
+        vertices: [...topology.vertices, ...newVertices],
+        edges: [...splitBoundaryEdges, ...cutEdges],
+        faces,
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'edge', ids: cutEdgeIds },
+    };
+}
+function bevelProfileFactor(value, profile) {
+    const exponent = 2 ** ((0.5 - profile) * 4);
+    const a = value ** exponent;
+    const b = (1 - value) ** exponent;
+    return a / (a + b);
+}
+function roundedBevelPoint(origin, start, end, factor) {
+    const startDirection = normalize([
+        start[0] - origin[0],
+        start[1] - origin[1],
+        start[2] - origin[2],
+    ]);
+    const endDirection = normalize([end[0] - origin[0], end[1] - origin[1], end[2] - origin[2]]);
+    if (!(startDirection && endDirection))
+        return interpolatePoint(start, end, factor);
+    const directionDot = Math.max(-1, Math.min(1, startDirection[0] * endDirection[0] +
+        startDirection[1] * endDirection[1] +
+        startDirection[2] * endDirection[2]));
+    if (directionDot < -0.999999)
+        return interpolatePoint(start, end, factor);
+    const width = Math.hypot(start[0] - origin[0], start[1] - origin[1], start[2] - origin[2]);
+    const centerScale = width / (1 + directionDot);
+    const center = [
+        origin[0] + (startDirection[0] + endDirection[0]) * centerScale,
+        origin[1] + (startDirection[1] + endDirection[1]) * centerScale,
+        origin[2] + (startDirection[2] + endDirection[2]) * centerScale,
+    ];
+    const startRadius = [start[0] - center[0], start[1] - center[1], start[2] - center[2]];
+    const endRadius = [end[0] - center[0], end[1] - center[1], end[2] - center[2]];
+    const radius = Math.hypot(...startRadius);
+    const endRadiusLength = Math.hypot(...endRadius);
+    if (radius < 1e-8 || endRadiusLength < 1e-8)
+        return interpolatePoint(start, end, factor);
+    const radiusDot = Math.max(-1, Math.min(1, (startRadius[0] * endRadius[0] +
+        startRadius[1] * endRadius[1] +
+        startRadius[2] * endRadius[2]) /
+        (radius * endRadiusLength)));
+    const angle = Math.acos(radiusDot);
+    const sine = Math.sin(angle);
+    if (Math.abs(sine) < 1e-8)
+        return interpolatePoint(start, end, factor);
+    const startWeight = Math.sin((1 - factor) * angle) / sine;
+    const endWeight = Math.sin(factor * angle) / sine;
+    return [
+        center[0] + startRadius[0] * startWeight + endRadius[0] * endWeight,
+        center[1] + startRadius[1] * startWeight + endRadius[1] * endWeight,
+        center[2] + startRadius[2] * startWeight + endRadius[2] * endWeight,
+    ];
+}
+function rebuildEdgesFromFaces(topology, faces, allocateEdgeId) {
+    const oldByKey = new Map(topology.edges.map((edge) => [blockUndirectedEdgeKey(...edge.vertexIds), edge]));
+    const seen = new Set();
+    const edges = [];
+    for (const face of faces) {
+        for (let index = 0; index < face.vertexIds.length; index += 1) {
+            const vertexIds = [
+                face.vertexIds[index],
+                face.vertexIds[(index + 1) % face.vertexIds.length],
+            ];
+            const key = blockUndirectedEdgeKey(...vertexIds);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const old = oldByKey.get(key);
+            edges.push(old ?? { id: allocateEdgeId(), vertexIds });
+        }
+    }
+    return edges;
+}
+function bevelOneEdge(topology, edgeId, command) {
+    const edge = topology.edges.find((entry) => entry.id === edgeId);
+    if (!edge)
+        return { ok: false, error: `Edge not found: ${edgeId}` };
+    const segments = Math.floor(command.segments);
+    if (!Number.isFinite(command.width) || command.width <= 0)
+        return { ok: false, error: 'Bevel width must be positive' };
+    if (!Number.isFinite(command.segments) || segments < 1 || segments > 12)
+        return { ok: false, error: 'Bevel segments must be between 1 and 12' };
+    if (!Number.isFinite(command.profile) || command.profile < 0 || command.profile > 1)
+        return { ok: false, error: 'Bevel profile must be between 0 and 1' };
+    const [aId, bId] = edge.vertexIds;
+    const adjacentFaces = topology.faces.filter((face) => faceContainsEdge(face, aId, bId));
+    if (adjacentFaces.length !== 2)
+        return {
+            ok: false,
+            error: 'Bevel requires an edge shared by exactly two faces',
+        };
+    const incidentAt = (id) => topology.faces.filter((face) => face.vertexIds.includes(id));
+    const caps = [aId, bId].map((id) => incidentAt(id).filter((face) => !adjacentFaces.some((adjacent) => adjacent.id === face.id)));
+    if (caps.some((faces) => faces.length !== 1))
+        return {
+            ok: false,
+            error: 'Bevel currently requires three-face corner endpoints',
+        };
+    const vertexById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex]));
+    const vertexA = vertexById.get(aId);
+    const vertexB = vertexById.get(bId);
+    if (!(vertexA && vertexB))
+        return { ok: false, error: 'Bevel edge references missing vertices' };
+    const neighborInFace = (face, id, other) => {
+        const index = face.vertexIds.indexOf(id);
+        const previous = face.vertexIds[(index - 1 + face.vertexIds.length) % face.vertexIds.length];
+        const next = face.vertexIds[(index + 1) % face.vertexIds.length];
+        return previous === other ? next : next === other ? previous : null;
+    };
+    const neighbors = adjacentFaces.map((face) => ({
+        a: neighborInFace(face, aId, bId),
+        b: neighborInFace(face, bId, aId),
+    }));
+    if (neighbors.some((entry) => !(entry.a && entry.b)))
+        return { ok: false, error: 'Could not resolve bevel corner neighbors' };
+    const points = neighbors.flatMap((entry, faceIndex) => [
+        ['a', aId],
+        ['b', bId],
+    ].map(([endpoint, endpointId]) => {
+        const neighborId = entry[endpoint];
+        const origin = vertexById.get(endpointId).position;
+        const neighbor = vertexById.get(neighborId)?.position;
+        return neighbor ? { faceIndex, endpoint, origin, neighbor } : null;
+    }));
+    if (points.some((point) => !point))
+        return { ok: false, error: 'Bevel references missing vertices' };
+    const safeMaximum = Math.min(...points.map((point) => Math.hypot(point.neighbor[0] - point.origin[0], point.neighbor[1] - point.origin[1], point.neighbor[2] - point.origin[2]))) * 0.49;
+    const width = command.clampOverlap ? Math.min(command.width, safeMaximum) : command.width;
+    if (!command.clampOverlap && width >= safeMaximum * 2)
+        return {
+            ok: false,
+            error: 'Bevel width overlaps adjacent edges; enable Clamp',
+        };
+    const offset = (origin, neighbor) => {
+        const direction = normalize([
+            neighbor[0] - origin[0],
+            neighbor[1] - origin[1],
+            neighbor[2] - origin[2],
+        ]);
+        return [
+            origin[0] + direction[0] * width,
+            origin[1] + direction[1] * width,
+            origin[2] + direction[2] * width,
+        ];
+    };
+    const outerA = neighbors.map((entry) => offset(vertexA.position, vertexById.get(entry.a).position));
+    const outerB = neighbors.map((entry) => offset(vertexB.position, vertexById.get(entry.b).position));
+    const allocateVertexId = nextNumericId('v', topology.vertices.map((vertex) => vertex.id));
+    const allocateEdgeId = nextNumericId('e', topology.edges.map((entry) => entry.id));
+    const allocateFaceId = nextNumericId('f', topology.faces.map((face) => face.id));
+    const railsA = [];
+    const railsB = [];
+    const newVertices = [];
+    for (let index = 0; index <= segments; index += 1) {
+        const factor = bevelProfileFactor(index / segments, command.profile);
+        const aVertexId = allocateVertexId();
+        const bVertexId = allocateVertexId();
+        railsA.push(aVertexId);
+        railsB.push(bVertexId);
+        newVertices.push({
+            id: aVertexId,
+            position: roundedBevelPoint(vertexA.position, outerA[0], outerA[1], factor),
+        }, {
+            id: bVertexId,
+            position: roundedBevelPoint(vertexB.position, outerB[0], outerB[1], factor),
+        });
+    }
+    const replaceVertex = (loop, id, replacement) => loop.flatMap((vertexId) => (vertexId === id ? replacement : [vertexId]));
+    const faces = topology.faces
+        .filter((face) => !adjacentFaces.some((adjacent) => adjacent.id === face.id))
+        .map((face) => {
+        if (face.id === caps[0][0].id) {
+            const index = face.vertexIds.indexOf(aId);
+            const previous = face.vertexIds[(index - 1 + face.vertexIds.length) % face.vertexIds.length];
+            const replacement = previous === neighbors[0].a ? railsA : [...railsA].reverse();
+            return {
+                ...face,
+                vertexIds: replaceVertex(face.vertexIds, aId, replacement),
+            };
+        }
+        if (face.id === caps[1][0].id) {
+            const index = face.vertexIds.indexOf(bId);
+            const previous = face.vertexIds[(index - 1 + face.vertexIds.length) % face.vertexIds.length];
+            const replacement = previous === neighbors[0].b ? railsB : [...railsB].reverse();
+            return {
+                ...face,
+                vertexIds: replaceVertex(face.vertexIds, bId, replacement),
+            };
+        }
+        return face;
+    });
+    for (let faceIndex = 0; faceIndex < 2; faceIndex += 1) {
+        const source = adjacentFaces[faceIndex];
+        faces.push({
+            ...source,
+            vertexIds: source.vertexIds.map((id) => id === aId
+                ? railsA[faceIndex === 0 ? 0 : segments]
+                : id === bId
+                    ? railsB[faceIndex === 0 ? 0 : segments]
+                    : id),
+        });
+    }
+    const firstFaceForward = adjacentFaces[0].vertexIds.some((id, index) => id === aId &&
+        adjacentFaces[0].vertexIds[(index + 1) % adjacentFaces[0].vertexIds.length] === bId);
+    for (let index = 0; index < segments; index += 1) {
+        const vertexIds = firstFaceForward
+            ? [railsB[index], railsA[index], railsA[index + 1], railsB[index + 1]]
+            : [railsA[index], railsB[index], railsB[index + 1], railsA[index + 1]];
+        faces.push({
+            id: allocateFaceId(),
+            vertexIds,
+            materialSlot: adjacentFaces[0].materialSlot,
+        });
+    }
+    const nextTopology = {
+        vertices: [
+            ...topology.vertices.filter((vertex) => vertex.id !== aId && vertex.id !== bId),
+            ...newVertices,
+        ],
+        edges: rebuildEdgesFromFaces(topology, faces, allocateEdgeId),
+        faces,
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    const selected = nextTopology.edges.filter((entry) => {
+        const aRail = railsA.includes(entry.vertexIds[0]) && railsB.includes(entry.vertexIds[1]);
+        const bRail = railsB.includes(entry.vertexIds[0]) && railsA.includes(entry.vertexIds[1]);
+        return aRail || bRail;
+    });
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'edge', ids: selected.map((entry) => entry.id) },
+    };
+}
+function bevelEdges(topology, command) {
+    const edgeIds = [...new Set(command.edgeIds)];
+    if (edgeIds.length === 0)
+        return { ok: false, error: 'Select an edge to bevel' };
+    const selectedEdges = edgeIds.map((id) => topology.edges.find((edge) => edge.id === id));
+    const missingIndex = selectedEdges.findIndex((edge) => !edge);
+    if (missingIndex >= 0)
+        return { ok: false, error: `Edge not found: ${edgeIds[missingIndex]}` };
+    const originalVertexById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex.position]));
+    const originalSegments = new Map(selectedEdges.map((edge) => [
+        edge.id,
+        [
+            originalVertexById.get(edge.vertexIds[0]),
+            originalVertexById.get(edge.vertexIds[1]),
+        ],
+    ]));
+    let current = topology;
+    const selectedResultIds = [];
+    for (const edgeId of edgeIds) {
+        const originalSegment = originalSegments.get(edgeId);
+        const vertexById = new Map(current.vertices.map((vertex) => [vertex.id, vertex.position]));
+        const distance = (left, right) => Math.hypot(left[0] - right[0], left[1] - right[1], left[2] - right[2]);
+        const remappedEdge = current.edges.find((edge) => edge.id === edgeId) ??
+            current.edges.reduce((best, edge) => {
+                const start = vertexById.get(edge.vertexIds[0]);
+                const end = vertexById.get(edge.vertexIds[1]);
+                const score = Math.min(distance(start, originalSegment[0]) + distance(end, originalSegment[1]), distance(start, originalSegment[1]) + distance(end, originalSegment[0]));
+                return !best || score < best.score ? { edge, score } : best;
+            }, null)?.edge;
+        if (!remappedEdge)
+            return { ok: false, error: `Could not remap bevel edge: ${edgeId}` };
+        const result = bevelOneEdge(current, remappedEdge.id, command);
+        if (!result.ok)
+            return result;
+        current = result.topology;
+        selectedResultIds.push(...result.selection.ids);
+    }
+    const survivingIds = new Set(current.edges.map((edge) => edge.id));
+    return {
+        ok: true,
+        topology: current,
+        selection: {
+            mode: 'edge',
+            ids: [...new Set(selectedResultIds)].filter((id) => survivingIds.has(id)),
+        },
+    };
+}
+function extrudeFaces(topology, command) {
+    const selectedFaceIds = new Set(command.faceIds);
+    const selectedFaces = topology.faces.filter((face) => selectedFaceIds.has(face.id));
+    if (selectedFaces.length !== selectedFaceIds.size || selectedFaces.length === 0) {
+        const missing = command.faceIds.find((id) => !topology.faces.some((face) => face.id === id));
+        return { ok: false, error: missing ? `Face not found: ${missing}` : 'Select a face to extrude' };
+    }
+    if (!Number.isFinite(command.distance) || Math.abs(command.distance) < 1e-6) {
+        return {
+            ok: false,
+            error: 'Extrude distance must be a non-zero finite number',
+        };
+    }
+    const edgeKeysByFace = new Map(selectedFaces.map((face) => [
+        face.id,
+        face.vertexIds.map((id, index) => blockUndirectedEdgeKey(id, face.vertexIds[(index + 1) % face.vertexIds.length])),
+    ]));
+    const connected = new Set([selectedFaces[0].id]);
+    const queue = [selectedFaces[0].id];
+    while (queue.length > 0) {
+        const faceId = queue.shift();
+        const keys = new Set(edgeKeysByFace.get(faceId));
+        for (const candidate of selectedFaces) {
+            if (connected.has(candidate.id))
+                continue;
+            if (edgeKeysByFace.get(candidate.id).some((key) => keys.has(key))) {
+                connected.add(candidate.id);
+                queue.push(candidate.id);
+            }
+        }
+    }
+    if (connected.size !== selectedFaces.length) {
+        return { ok: false, error: 'Extrude Region requires connected faces' };
+    }
+    const normals = selectedFaces.map((face) => blockFaceNormal(topology, face));
+    if (normals.some((normal) => !normal)) {
+        const invalidFace = selectedFaces[normals.findIndex((normal) => !normal)];
+        return { ok: false, error: `Face has no usable normal: ${invalidFace.id}` };
+    }
+    const normal = command.axis
+        ? [
+            command.axis === 'x' ? 1 : 0,
+            command.axis === 'y' ? 1 : 0,
+            command.axis === 'z' ? 1 : 0,
+        ]
+        : normalize(normals.reduce((sum, value) => [sum[0] + value[0], sum[1] + value[1], sum[2] + value[2]], [0, 0, 0]));
+    if (!normal)
+        return { ok: false, error: 'Selected face normals cancel each other out' };
+    const verticesById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex]));
+    const allocateVertexId = nextNumericId('v', topology.vertices.map((vertex) => vertex.id));
+    const allocateEdgeId = nextNumericId('e', topology.edges.map((edge) => edge.id));
+    const allocateFaceId = nextNumericId('f', topology.faces.map((entry) => entry.id));
+    const duplicateIds = new Map();
+    const newVertices = [];
+    const selectedVertexIds = new Set(selectedFaces.flatMap((face) => face.vertexIds));
+    for (const vertexId of selectedVertexIds) {
+        const vertex = verticesById.get(vertexId);
+        if (!vertex)
+            return {
+                ok: false,
+                error: `Selected face references missing vertex: ${vertexId}`,
+            };
+        const id = allocateVertexId();
+        duplicateIds.set(vertexId, id);
+        newVertices.push({
+            id,
+            position: [
+                vertex.position[0] + normal[0] * command.distance,
+                vertex.position[1] + normal[1] * command.distance,
+                vertex.position[2] + normal[2] * command.distance,
+            ],
+        });
+    }
+    const boundaryByKey = new Map();
+    for (const face of selectedFaces) {
+        for (let index = 0; index < face.vertexIds.length; index += 1) {
+            const a = face.vertexIds[index];
+            const b = face.vertexIds[(index + 1) % face.vertexIds.length];
+            const key = blockUndirectedEdgeKey(a, b);
+            const boundary = boundaryByKey.get(key);
+            if (boundary)
+                boundary.count += 1;
+            else
+                boundaryByKey.set(key, { count: 1, a, b, source: face });
+        }
+    }
+    const sideFaces = [];
+    for (const boundary of boundaryByKey.values()) {
+        if (boundary.count !== 1)
+            continue;
+        const { a, b, source } = boundary;
+        const newA = duplicateIds.get(a);
+        const newB = duplicateIds.get(b);
+        sideFaces.push({
+            id: allocateFaceId(),
+            vertexIds: [a, b, newB, newA],
+            materialSlot: source.materialSlot,
+        });
+    }
+    const faces = [
+        ...topology.faces.map((face) => selectedFaceIds.has(face.id)
+            ? { ...face, vertexIds: face.vertexIds.map((id) => duplicateIds.get(id)) }
+            : face),
+        ...sideFaces,
+    ];
+    const nextTopology = {
+        vertices: [...topology.vertices, ...newVertices],
+        edges: rebuildEdgesFromFaces(topology, faces, allocateEdgeId),
+        faces,
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'face', ids: selectedFaces.map((face) => face.id) },
+    };
+}
+export function blockSelectionVertexIds(topology, selection) {
+    const selectedIds = new Set(selection.ids);
+    switch (selection.mode) {
+        case 'vertex':
+            return new Set(topology.vertices.filter((vertex) => selectedIds.has(vertex.id)).map((v) => v.id));
+        case 'edge': {
+            const vertices = new Set();
+            for (const edge of topology.edges) {
+                if (!selectedIds.has(edge.id))
+                    continue;
+                vertices.add(edge.vertexIds[0]);
+                vertices.add(edge.vertexIds[1]);
+            }
+            return vertices;
+        }
+        case 'face': {
+            const vertices = new Set();
+            for (const face of topology.faces) {
+                if (!selectedIds.has(face.id))
+                    continue;
+                for (const vertexId of face.vertexIds)
+                    vertices.add(vertexId);
+            }
+            return vertices;
+        }
+    }
+}
+function translateComponents(topology, command) {
+    if (command.delta.some((value) => !Number.isFinite(value))) {
+        return {
+            ok: false,
+            error: 'Translation delta must contain finite numbers',
+        };
+    }
+    const vertexIds = blockSelectionVertexIds(topology, command.selection);
+    if (vertexIds.size === 0)
+        return { ok: false, error: 'Select a component to move' };
+    const nextTopology = {
+        ...topology,
+        vertices: topology.vertices.map((vertex) => vertexIds.has(vertex.id)
+            ? {
+                ...vertex,
+                position: [
+                    vertex.position[0] + command.delta[0],
+                    vertex.position[1] + command.delta[1],
+                    vertex.position[2] + command.delta[2],
+                ],
+            }
+            : vertex),
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return { ok: true, topology: nextTopology, selection: command.selection };
+}
+function transformComponents(topology, selection, transform) {
+    const vertexIds = blockSelectionVertexIds(topology, selection);
+    if (vertexIds.size === 0)
+        return { ok: false, error: 'Select a component to transform' };
+    const nextTopology = {
+        ...topology,
+        vertices: topology.vertices.map((vertex) => vertexIds.has(vertex.id) ? { ...vertex, position: transform(vertex.position) } : vertex),
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return { ok: true, topology: nextTopology, selection };
+}
+function rotateComponents(topology, command) {
+    if (!Number.isFinite(command.angle) || command.pivot.some((value) => !Number.isFinite(value))) {
+        return { ok: false, error: 'Rotation requires a finite angle and pivot' };
+    }
+    const axis = normalize(command.axis);
+    if (!axis)
+        return { ok: false, error: 'Rotation axis must be non-zero' };
+    const cosine = Math.cos(command.angle);
+    const sine = Math.sin(command.angle);
+    return transformComponents(topology, command.selection, (position) => {
+        const x = position[0] - command.pivot[0];
+        const y = position[1] - command.pivot[1];
+        const z = position[2] - command.pivot[2];
+        const dot = axis[0] * x + axis[1] * y + axis[2] * z;
+        const cross = [
+            axis[1] * z - axis[2] * y,
+            axis[2] * x - axis[0] * z,
+            axis[0] * y - axis[1] * x,
+        ];
+        return [
+            command.pivot[0] + x * cosine + cross[0] * sine + axis[0] * dot * (1 - cosine),
+            command.pivot[1] + y * cosine + cross[1] * sine + axis[1] * dot * (1 - cosine),
+            command.pivot[2] + z * cosine + cross[2] * sine + axis[2] * dot * (1 - cosine),
+        ];
+    });
+}
+function scaleComponents(topology, command) {
+    if (command.pivot.some((value) => !Number.isFinite(value)) ||
+        command.factors.some((value) => !Number.isFinite(value) || Math.abs(value) < 1e-6)) {
+        return {
+            ok: false,
+            error: 'Scale requires finite, non-zero factors and a finite pivot',
+        };
+    }
+    return transformComponents(topology, command.selection, (position) => [
+        command.pivot[0] + (position[0] - command.pivot[0]) * command.factors[0],
+        command.pivot[1] + (position[1] - command.pivot[1]) * command.factors[1],
+        command.pivot[2] + (position[2] - command.pivot[2]) * command.factors[2],
+    ]);
+}
+function insetOneFace(topology, faceId, amount, depth) {
+    const faceIndex = topology.faces.findIndex((face) => face.id === faceId);
+    const face = topology.faces[faceIndex];
+    if (!face)
+        return { ok: false, error: `Face not found: ${faceId}` };
+    if (!Number.isFinite(amount) || amount <= 0 || amount >= 1) {
+        return {
+            ok: false,
+            error: 'Inset amount must be greater than 0 and less than 1',
+        };
+    }
+    if (!Number.isFinite(depth))
+        return { ok: false, error: 'Inset depth must be finite' };
+    const centroid = blockFaceCentroid(topology, face);
+    const normal = blockFaceNormal(topology, face);
+    if (!(centroid && normal))
+        return { ok: false, error: `Face cannot be inset: ${face.id}` };
+    const verticesById = new Map(topology.vertices.map((vertex) => [vertex.id, vertex]));
+    const allocateVertexId = nextNumericId('v', topology.vertices.map((vertex) => vertex.id));
+    const allocateEdgeId = nextNumericId('e', topology.edges.map((edge) => edge.id));
+    const allocateFaceId = nextNumericId('f', topology.faces.map((entry) => entry.id));
+    const insetIds = [];
+    const newVertices = [];
+    for (const vertexId of face.vertexIds) {
+        const vertex = verticesById.get(vertexId);
+        if (!vertex)
+            return {
+                ok: false,
+                error: `Face references missing vertex: ${vertexId}`,
+            };
+        const id = allocateVertexId();
+        insetIds.push(id);
+        newVertices.push({
+            id,
+            position: [
+                vertex.position[0] + (centroid[0] - vertex.position[0]) * amount + normal[0] * depth,
+                vertex.position[1] + (centroid[1] - vertex.position[1]) * amount + normal[1] * depth,
+                vertex.position[2] + (centroid[2] - vertex.position[2]) * amount + normal[2] * depth,
+            ],
+        });
+    }
+    const newEdges = [];
+    const ringFaces = [];
+    for (let index = 0; index < face.vertexIds.length; index += 1) {
+        const oldA = face.vertexIds[index];
+        const oldB = face.vertexIds[(index + 1) % face.vertexIds.length];
+        const insetA = insetIds[index];
+        const insetB = insetIds[(index + 1) % insetIds.length];
+        newEdges.push({ id: allocateEdgeId(), vertexIds: [insetA, insetB] });
+        newEdges.push({ id: allocateEdgeId(), vertexIds: [oldA, insetA] });
+        ringFaces.push({
+            id: allocateFaceId(),
+            vertexIds: [oldA, oldB, insetB, insetA],
+            materialSlot: face.materialSlot,
+        });
+    }
+    const faces = topology.faces.slice();
+    faces[faceIndex] = { ...face, vertexIds: insetIds };
+    const nextTopology = {
+        vertices: [...topology.vertices, ...newVertices],
+        edges: [...topology.edges, ...newEdges],
+        faces: [...faces, ...ringFaces],
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'face', ids: [face.id] },
+    };
+}
+function insetFaces(topology, command) {
+    const faceIds = [...new Set(command.faceIds)];
+    if (faceIds.length === 0)
+        return { ok: false, error: 'Select a face to inset' };
+    const missing = faceIds.find((id) => !topology.faces.some((face) => face.id === id));
+    if (missing)
+        return { ok: false, error: `Face not found: ${missing}` };
+    let current = topology;
+    for (const faceId of faceIds) {
+        const result = insetOneFace(current, faceId, command.amount, command.depth);
+        if (!result.ok)
+            return result;
+        current = result.topology;
+    }
+    return { ok: true, topology: current, selection: { mode: 'face', ids: faceIds } };
+}
+function deleteComponents(topology, command) {
+    const selected = new Set(command.selection.ids);
+    if (selected.size === 0)
+        return { ok: false, error: 'Select a component to delete' };
+    let vertices = topology.vertices;
+    let edges = topology.edges;
+    let faces = topology.faces;
+    if (command.selection.mode === 'face') {
+        faces = faces.filter((face) => !selected.has(face.id));
+    }
+    else if (command.selection.mode === 'edge') {
+        const removedKeys = new Set(edges
+            .filter((edge) => selected.has(edge.id))
+            .map((edge) => blockUndirectedEdgeKey(...edge.vertexIds)));
+        edges = edges.filter((edge) => !selected.has(edge.id));
+        faces = faces.filter((face) => face.vertexIds.every((vertexId, index) => {
+            const next = face.vertexIds[(index + 1) % face.vertexIds.length];
+            const key = blockUndirectedEdgeKey(vertexId, next);
+            return !removedKeys.has(key);
+        }));
+    }
+    else {
+        vertices = vertices.filter((vertex) => !selected.has(vertex.id));
+        edges = edges.filter((edge) => !selected.has(edge.vertexIds[0]) && !selected.has(edge.vertexIds[1]));
+        faces = faces.filter((face) => face.vertexIds.every((vertexId) => !selected.has(vertexId)));
+    }
+    const nextTopology = { vertices, edges, faces };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: command.selection.mode, ids: [] },
+    };
+}
+function mergeVertices(topology, command) {
+    const selected = new Set(command.vertexIds);
+    const selectedVertices = topology.vertices.filter((vertex) => selected.has(vertex.id));
+    if (selectedVertices.length < 2)
+        return { ok: false, error: 'Select at least two vertices to merge' };
+    const keepId = [...command.vertexIds]
+        .reverse()
+        .find((id) => selectedVertices.some((v) => v.id === id));
+    const center = selectedVertices.reduce((sum, vertex) => [
+        sum[0] + vertex.position[0],
+        sum[1] + vertex.position[1],
+        sum[2] + vertex.position[2],
+    ], [0, 0, 0]);
+    center[0] /= selectedVertices.length;
+    center[1] /= selectedVertices.length;
+    center[2] /= selectedVertices.length;
+    const mapVertexId = (id) => (selected.has(id) ? keepId : id);
+    const edgeKeys = new Set();
+    const edges = topology.edges.flatMap((edge) => {
+        const a = mapVertexId(edge.vertexIds[0]);
+        const b = mapVertexId(edge.vertexIds[1]);
+        if (a === b)
+            return [];
+        const key = blockUndirectedEdgeKey(a, b);
+        if (edgeKeys.has(key))
+            return [];
+        edgeKeys.add(key);
+        return [{ ...edge, vertexIds: [a, b] }];
+    });
+    const faces = [];
+    for (const face of topology.faces) {
+        const mapped = face.vertexIds.map(mapVertexId);
+        const loop = [];
+        for (const id of mapped) {
+            if (loop.at(-1) !== id)
+                loop.push(id);
+        }
+        if (loop.length > 1 && loop[0] === loop.at(-1))
+            loop.pop();
+        if (loop.length < 3 || new Set(loop).size < 3)
+            continue;
+        if (new Set(loop).size !== loop.length) {
+            return {
+                ok: false,
+                error: 'The selected vertices would create a repeated face vertex',
+            };
+        }
+        faces.push({ ...face, vertexIds: loop });
+    }
+    const nextTopology = {
+        vertices: topology.vertices
+            .filter((vertex) => vertex.id === keepId || !selected.has(vertex.id))
+            .map((vertex) => (vertex.id === keepId ? { ...vertex, position: center } : vertex)),
+        edges,
+        faces,
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'vertex', ids: [keepId] },
+    };
+}
+function faceContainsEdge(face, a, b) {
+    return face.vertexIds.some((vertexId, index) => {
+        const next = face.vertexIds[(index + 1) % face.vertexIds.length];
+        return (vertexId === a && next === b) || (vertexId === b && next === a);
+    });
+}
+function longFacePath(face, start, end) {
+    const startIndex = face.vertexIds.indexOf(start);
+    if (startIndex < 0)
+        return null;
+    const forward = [start];
+    for (let offset = 1; offset <= face.vertexIds.length; offset += 1) {
+        const id = face.vertexIds[(startIndex + offset) % face.vertexIds.length];
+        forward.push(id);
+        if (id === end)
+            break;
+    }
+    if (forward.at(-1) !== end)
+        return null;
+    if (forward.length > 2)
+        return forward;
+    const backward = [start];
+    for (let offset = 1; offset <= face.vertexIds.length; offset += 1) {
+        const index = (startIndex - offset + face.vertexIds.length) % face.vertexIds.length;
+        const id = face.vertexIds[index];
+        backward.push(id);
+        if (id === end)
+            break;
+    }
+    return backward.at(-1) === end && backward.length > 2 ? backward : null;
+}
+function dissolveOneEdge(topology, edgeId) {
+    const edge = topology.edges.find((entry) => entry.id === edgeId);
+    if (!edge)
+        return { ok: false, error: `Edge not found: ${edgeId}` };
+    const [a, b] = edge.vertexIds;
+    const adjacentFaces = topology.faces.filter((face) => faceContainsEdge(face, a, b));
+    if (adjacentFaces.length !== 2) {
+        return {
+            ok: false,
+            error: 'Dissolve requires an edge shared by exactly two faces',
+        };
+    }
+    const firstPath = longFacePath(adjacentFaces[0], a, b);
+    const secondPath = longFacePath(adjacentFaces[1], b, a);
+    if (!(firstPath && secondPath))
+        return { ok: false, error: 'Could not resolve adjacent face loops' };
+    const mergedLoop = [...firstPath, ...secondPath.slice(1, -1)];
+    if (new Set(mergedLoop).size !== mergedLoop.length) {
+        return {
+            ok: false,
+            error: 'Dissolving this edge would create a repeated face vertex',
+        };
+    }
+    const removedFaceId = adjacentFaces[1].id;
+    const nextTopology = {
+        vertices: topology.vertices,
+        edges: topology.edges.filter((entry) => entry.id !== edge.id),
+        faces: topology.faces
+            .filter((face) => face.id !== removedFaceId)
+            .map((face) => face.id === adjacentFaces[0].id ? { ...face, vertexIds: mergedLoop } : face),
+    };
+    const issues = inspectBlockTopology(nextTopology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    return {
+        ok: true,
+        topology: nextTopology,
+        selection: { mode: 'face', ids: [adjacentFaces[0].id] },
+    };
+}
+function dissolveEdges(topology, command) {
+    const edgeIds = [...new Set(command.edgeIds)];
+    if (edgeIds.length === 0)
+        return { ok: false, error: 'Select an edge to dissolve' };
+    const missing = edgeIds.find((id) => !topology.edges.some((edge) => edge.id === id));
+    if (missing)
+        return { ok: false, error: `Edge not found: ${missing}` };
+    let current = topology;
+    const resultFaceIds = [];
+    for (const edgeId of edgeIds) {
+        const result = dissolveOneEdge(current, edgeId);
+        if (!result.ok)
+            return result;
+        current = result.topology;
+        resultFaceIds.push(...result.selection.ids);
+    }
+    const survivingFaceIds = new Set(current.faces.map((face) => face.id));
+    return {
+        ok: true,
+        topology: current,
+        selection: {
+            mode: 'face',
+            ids: [...new Set(resultFaceIds)].filter((id) => survivingFaceIds.has(id)),
+        },
+    };
+}
+function dissolveFaces(topology, command) {
+    const faceIds = new Set(command.faceIds);
+    if (faceIds.size < 2)
+        return { ok: false, error: 'Select at least two faces to dissolve' };
+    const missing = [...faceIds].find((id) => !topology.faces.some((face) => face.id === id));
+    if (missing)
+        return { ok: false, error: `Face not found: ${missing}` };
+    const internalEdgeIds = topology.edges
+        .filter((edge) => {
+        const incidentSelectedFaces = topology.faces.filter((face) => faceIds.has(face.id) && faceContainsEdge(face, ...edge.vertexIds));
+        return incidentSelectedFaces.length === 2;
+    })
+        .map((edge) => edge.id);
+    if (internalEdgeIds.length === 0) {
+        return { ok: false, error: 'Selected faces do not share a dissolvable boundary' };
+    }
+    const result = dissolveEdges(topology, { type: 'dissolve-edges', edgeIds: internalEdgeIds });
+    if (!result.ok)
+        return result;
+    const survivingSelectedIds = result.topology.faces
+        .filter((face) => faceIds.has(face.id))
+        .map((face) => face.id);
+    return {
+        ok: true,
+        topology: result.topology,
+        selection: { mode: 'face', ids: survivingSelectedIds },
+    };
+}
+export function applyBlockCommand(topology, command) {
+    const issues = inspectBlockTopology(topology);
+    if (issues.length > 0)
+        return { ok: false, error: issues[0].message };
+    switch (command.type) {
+        case 'extrude-faces':
+            return extrudeFaces(topology, command);
+        case 'translate-components':
+            return translateComponents(topology, command);
+        case 'rotate-components':
+            return rotateComponents(topology, command);
+        case 'scale-components':
+            return scaleComponents(topology, command);
+        case 'inset-faces':
+            return insetFaces(topology, command);
+        case 'delete-components':
+            return deleteComponents(topology, command);
+        case 'merge-vertices':
+            return mergeVertices(topology, command);
+        case 'dissolve-edges':
+            return dissolveEdges(topology, command);
+        case 'dissolve-faces':
+            return dissolveFaces(topology, command);
+        case 'loop-cut':
+            return loopCut(topology, command);
+        case 'bevel-edges':
+            return bevelEdges(topology, command);
+    }
+}