Masked Groups

.changeset/dull-donkeys-share.md

@@ -0,0 +1,5 @@
+---
+"penpot-exporter": minor
+---
+
+Added support for masked groups

plugin-src/transformers/partials/transformChildren.ts

@@ -1,16 +1,22 @@
-import { transformSceneNode } from '@plugin/transformers';
+import { translateMaskChildren, translateNonMaskChildren } from '@plugin/translators';
 
-import { PenpotNode } from '@ui/lib/types/penpotNode';
 import { Children } from '@ui/lib/types/utils/children';
 
+const nodeActsAsMask = (node: SceneNode): boolean => {
+  return 'isMask' in node && node.isMask;
+};
+
 export const transformChildren = async (
   node: ChildrenMixin,
   baseX: number = 0,
   baseY: number = 0
 ): Promise<Children> => {
+  const maskIndex = node.children.findIndex(nodeActsAsMask);
+  const containsMask = maskIndex !== -1;
+
   return {
-    children: (
-      await Promise.all(node.children.map(child => transformSceneNode(child, baseX, baseY)))
-    ).filter((child): child is PenpotNode => !!child)
+    children: containsMask
+      ? await translateMaskChildren(node.children, maskIndex, baseX, baseY)
+      : await translateNonMaskChildren(node.children, baseX, baseY)
   };
 };

plugin-src/translators/index.ts

@@ -1,5 +1,6 @@
 export * from './translateBlendMode';
 export * from './translateBlurEffects';
 export * from './translateBoolType';
+export * from './translateChildren';
 export * from './translateShadowEffects';
 export * from './translateStrokes';

plugin-src/translators/translateChildren.ts

@@ -0,0 +1,45 @@
+import { transformGroupNodeLike, transformSceneNode } from '@plugin/transformers';
+
+import { PenpotNode } from '@ui/lib/types/penpotNode';
+
+/**
+ * Translates the children of a node that acts as a mask.
+ * We need to split the children into two groups: the ones that are masked and the ones that are not.
+ *
+ * The masked children will be grouped together in a mask group.
+ * The unmasked children will be returned as they are.
+ *
+ * @maskedIndex The index of the mask node in the children array
+ */
+export const translateMaskChildren = async (
+  children: readonly SceneNode[],
+  maskedIndex: number,
+  baseX: number,
+  baseY: number
+): Promise<PenpotNode[]> => {
+  const maskChild = children[maskedIndex];
+  const unmaskedChildren = await translateNonMaskChildren(
+    children.slice(0, maskedIndex),
+    baseX,
+    baseY
+  );
+  const maskedChildren = await translateNonMaskChildren(children.slice(maskedIndex), baseX, baseY);
+
+  const maskGroup = {
+    ...transformGroupNodeLike(maskChild, baseX, baseY),
+    children: maskedChildren,
+    maskedGroup: true
+  };
+
+  return [...unmaskedChildren, maskGroup];
+};
+
+export const translateNonMaskChildren = async (
+  children: readonly SceneNode[],
+  baseX: number,
+  baseY: number
+): Promise<PenpotNode[]> => {
+  return (await Promise.all(children.map(child => transformSceneNode(child, baseX, baseY)))).filter(
+    (child): child is PenpotNode => !!child
+  );
+};