@clypra/engine 1.2.1 → 1.3.0

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   SCENE_VERSION: () => SCENE_VERSION,
   SUPPORTED_FONT_FAMILIES: () => SUPPORTED_FONT_FAMILIES,
   TEMPLATE_CATEGORIES: () => TEMPLATE_CATEGORIES,
+  TextEffectBuilder: () => TextEffectBuilder,
   TextEffectRenderer: () => TextEffectRenderer,
   WEBM_EXPORT_MAX_FRAMES: () => WEBM_EXPORT_MAX_FRAMES,
   WebGLCompositor: () => WebGLCompositor,
@@ -178,6 +179,16 @@ __export(index_exports, {
   textEffectConfigToScene: () => textEffectConfigToScene,
   trackId: () => trackId,
   updateKeyframe: () => updateKeyframe,
+  updateSceneBevel: () => updateSceneBevel,
+  updateSceneCanvas: () => updateSceneCanvas,
+  updateSceneCustomEngine: () => updateSceneCustomEngine,
+  updateSceneFill: () => updateSceneFill,
+  updateSceneGlow: () => updateSceneGlow,
+  updateScenePanel: () => updateScenePanel,
+  updateSceneShadow: () => updateSceneShadow,
+  updateSceneStack: () => updateSceneStack,
+  updateSceneStroke: () => updateSceneStroke,
+  updateSceneText: () => updateSceneText,
   updateStaticProperty: () => updateStaticProperty,
   updateTimeline: () => updateTimeline,
   updateTrack: () => updateTrack,
@@ -6632,6 +6643,821 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   const value = layer2 ? readLayerScalar(layer2, track.paramPath) : 0;
   return addKeyframeAtTime(doc, trackIndex, previewTime, value);
 }
+
+// src/engine/api.ts
+function updateSceneText(doc, patch) {
+  const nextText = { ...doc.text };
+  if (patch.content !== void 0) nextText.content = patch.content;
+  if (patch.fontFamily !== void 0) nextText.fontFamily = patch.fontFamily;
+  if (patch.fontWeight !== void 0) nextText.fontWeight = patch.fontWeight;
+  if (patch.fontStyle !== void 0) nextText.fontStyle = patch.fontStyle;
+  if (patch.fontSize !== void 0) nextText.fontSize = patch.fontSize;
+  if (patch.letterSpacing !== void 0) nextText.letterSpacing = patch.letterSpacing;
+  if (patch.lineHeight !== void 0) nextText.lineHeight = patch.lineHeight;
+  if (patch.textPosX !== void 0) nextText.textPosX = patch.textPosX;
+  if (patch.textPosY !== void 0) nextText.textPosY = patch.textPosY;
+  if (patch.wrapText !== void 0) nextText.wrapText = patch.wrapText;
+  if (patch.autoFitText !== void 0) nextText.autoFitText = patch.autoFitText;
+  if (patch.perCharFillEnabled !== void 0) nextText.perCharFillEnabled = patch.perCharFillEnabled;
+  if (patch.charFillColors !== void 0) nextText.charFillColors = patch.charFillColors;
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.content !== void 0) nextLegacyConfig.text = patch.content;
+    if (patch.fontFamily !== void 0) nextLegacyConfig.fontFamily = patch.fontFamily;
+    if (patch.fontWeight !== void 0) nextLegacyConfig.fontWeight = patch.fontWeight;
+    if (patch.fontStyle !== void 0) nextLegacyConfig.fontStyle = patch.fontStyle;
+    if (patch.fontSize !== void 0) nextLegacyConfig.fontSize = patch.fontSize;
+    if (patch.letterSpacing !== void 0) nextLegacyConfig.letterSpacing = patch.letterSpacing;
+    if (patch.lineHeight !== void 0) nextLegacyConfig.lineHeight = patch.lineHeight;
+    if (patch.textPosX !== void 0) nextLegacyConfig.textPosX = patch.textPosX;
+    if (patch.textPosY !== void 0) nextLegacyConfig.textPosY = patch.textPosY;
+    if (patch.wrapText !== void 0) nextLegacyConfig.wrapText = patch.wrapText;
+    if (patch.autoFitText !== void 0) nextLegacyConfig.autoFitText = patch.autoFitText;
+    if (patch.perCharFillEnabled !== void 0) nextLegacyConfig.perCharFillEnabled = patch.perCharFillEnabled;
+    if (patch.charFillColors !== void 0) nextLegacyConfig.charFillColors = patch.charFillColors;
+  }
+  return {
+    ...doc,
+    text: nextText,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateScenePanel(doc, patch) {
+  let panelFound = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "panel") {
+      panelFound = true;
+      const nextParams = { ...layer2.params };
+      if (patch.color !== void 0) nextParams.panelColor = patch.color;
+      if (patch.opacity !== void 0) nextParams.panelOpacity = patch.opacity;
+      if (patch.radius !== void 0) nextParams.panelRadius = patch.radius;
+      if (patch.paddingX !== void 0) nextParams.panelPaddingX = patch.paddingX;
+      if (patch.paddingY !== void 0) nextParams.panelPaddingY = patch.paddingY;
+      if (patch.strokeEnabled !== void 0) nextParams.panelStrokeEnabled = patch.strokeEnabled;
+      if (patch.strokeColor !== void 0) nextParams.panelStrokeColor = patch.strokeColor;
+      if (patch.strokeWidth !== void 0) nextParams.panelStrokeWidth = patch.strokeWidth;
+      const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+      if (patch.enabled !== void 0) {
+        nextParams.panelEnabled = patch.enabled;
+      }
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!panelFound) {
+    const defaultParams = {
+      panelEnabled: patch.enabled ?? true,
+      panelColor: patch.color ?? "#1E1E26",
+      panelOpacity: patch.opacity ?? 80,
+      panelRadius: patch.radius ?? 12,
+      panelPaddingX: patch.paddingX ?? 40,
+      panelPaddingY: patch.paddingY ?? 20,
+      panelStrokeEnabled: patch.strokeEnabled ?? false,
+      panelStrokeColor: patch.strokeColor ?? "#2A2A38",
+      panelStrokeWidth: patch.strokeWidth ?? 2
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "panel",
+      name: "Background Panel",
+      enabled: patch.enabled ?? true,
+      opacity: 1,
+      blendMode: "source-over",
+      target: "scene",
+      params: defaultParams
+    };
+    layers.unshift(newL);
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.enabled !== void 0) nextLegacyConfig.panelEnabled = patch.enabled;
+    if (patch.color !== void 0) nextLegacyConfig.panelColor = patch.color;
+    if (patch.opacity !== void 0) nextLegacyConfig.panelOpacity = patch.opacity;
+    if (patch.radius !== void 0) nextLegacyConfig.panelRadius = patch.radius;
+    if (patch.paddingX !== void 0) nextLegacyConfig.panelPaddingX = patch.paddingX;
+    if (patch.paddingY !== void 0) nextLegacyConfig.panelPaddingY = patch.paddingY;
+    if (patch.strokeEnabled !== void 0) nextLegacyConfig.panelStrokeEnabled = patch.strokeEnabled;
+    if (patch.strokeColor !== void 0) nextLegacyConfig.panelStrokeColor = patch.strokeColor;
+    if (patch.strokeWidth !== void 0) nextLegacyConfig.panelStrokeWidth = patch.strokeWidth;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneStroke(doc, patch) {
+  let found = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "stroke") {
+      found = true;
+      const nextParams = { ...layer2.params };
+      if (patch.strokeColor !== void 0) nextParams.strokeColor = patch.strokeColor;
+      if (patch.strokeWidth !== void 0) nextParams.strokeWidth = patch.strokeWidth;
+      if (patch.strokePosition !== void 0) nextParams.strokePosition = patch.strokePosition;
+      if (patch.strokeOpacity !== void 0) nextParams.strokeOpacity = patch.strokeOpacity;
+      if (patch.strokeLineJoin !== void 0) nextParams.strokeLineJoin = patch.strokeLineJoin;
+      if (patch.strokeBlur !== void 0) nextParams.strokeBlur = patch.strokeBlur;
+      if (patch.strokeType !== void 0) nextParams.strokeType = patch.strokeType;
+      if (patch.strokeColorSecondary !== void 0) nextParams.strokeColorSecondary = patch.strokeColorSecondary;
+      if (patch.strokeWidthSecondary !== void 0) nextParams.strokeWidthSecondary = patch.strokeWidthSecondary;
+      if (patch.strokeFadeRange !== void 0) nextParams.strokeFadeRange = patch.strokeFadeRange;
+      const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+      if (patch.enabled !== void 0) {
+        nextParams.strokeEnabled = patch.enabled;
+      }
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!found) {
+    const defaultParams = {
+      strokeEnabled: patch.enabled ?? true,
+      strokeColor: patch.strokeColor ?? "#7C6FFF",
+      strokeWidth: patch.strokeWidth ?? 4,
+      strokePosition: patch.strokePosition ?? "outside",
+      strokeOpacity: patch.strokeOpacity ?? 100,
+      strokeLineJoin: patch.strokeLineJoin ?? "round",
+      strokeBlur: patch.strokeBlur ?? 0,
+      strokeType: patch.strokeType ?? "single",
+      strokeColorSecondary: patch.strokeColorSecondary ?? "#FFFFFF",
+      strokeWidthSecondary: patch.strokeWidthSecondary ?? 4,
+      strokeFadeRange: patch.strokeFadeRange ?? 0
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "stroke",
+      name: "Stroke",
+      enabled: patch.enabled ?? true,
+      opacity: 1,
+      blendMode: "source-over",
+      target: "text",
+      params: defaultParams
+    };
+    const fillIdx = layers.findIndex((l) => l.type === "fill");
+    if (fillIdx >= 0) {
+      layers.splice(fillIdx, 0, newL);
+    } else {
+      const maskIdx = layers.findIndex((l) => l.type === "mask" || l.type === "filter");
+      if (maskIdx >= 0) {
+        layers.splice(maskIdx, 0, newL);
+      } else {
+        layers.push(newL);
+      }
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.enabled !== void 0) nextLegacyConfig.strokeEnabled = patch.enabled;
+    if (patch.strokeColor !== void 0) nextLegacyConfig.strokeColor = patch.strokeColor;
+    if (patch.strokeWidth !== void 0) nextLegacyConfig.strokeWidth = patch.strokeWidth;
+    if (patch.strokePosition !== void 0) nextLegacyConfig.strokePosition = patch.strokePosition;
+    if (patch.strokeOpacity !== void 0) nextLegacyConfig.strokeOpacity = patch.strokeOpacity;
+    if (patch.strokeLineJoin !== void 0) nextLegacyConfig.strokeLineJoin = patch.strokeLineJoin;
+    if (patch.strokeBlur !== void 0) nextLegacyConfig.strokeBlur = patch.strokeBlur;
+    if (patch.strokeType !== void 0) nextLegacyConfig.strokeType = patch.strokeType;
+    if (patch.strokeColorSecondary !== void 0) nextLegacyConfig.strokeColorSecondary = patch.strokeColorSecondary;
+    if (patch.strokeWidthSecondary !== void 0) nextLegacyConfig.strokeWidthSecondary = patch.strokeWidthSecondary;
+    if (patch.strokeFadeRange !== void 0) nextLegacyConfig.strokeFadeRange = patch.strokeFadeRange;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneShadow(doc, patch) {
+  let found = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "shadow") {
+      found = true;
+      const nextParams = { ...layer2.params };
+      if (patch.shadowColor !== void 0) nextParams.shadowColor = patch.shadowColor;
+      if (patch.shadowBlur !== void 0) nextParams.shadowBlur = patch.shadowBlur;
+      if (patch.shadowOffsetX !== void 0) nextParams.shadowOffsetX = patch.shadowOffsetX;
+      if (patch.shadowOffsetY !== void 0) nextParams.shadowOffsetY = patch.shadowOffsetY;
+      if (patch.shadowOpacity !== void 0) nextParams.shadowOpacity = patch.shadowOpacity;
+      if (patch.shadowType !== void 0) nextParams.shadowType = patch.shadowType;
+      const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+      if (patch.enabled !== void 0) {
+        nextParams.shadowEnabled = patch.enabled;
+      }
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!found) {
+    const defaultParams = {
+      shadowEnabled: patch.enabled ?? true,
+      shadowColor: patch.shadowColor ?? "#000000",
+      shadowBlur: patch.shadowBlur ?? 10,
+      shadowOffsetX: patch.shadowOffsetX ?? 5,
+      shadowOffsetY: patch.shadowOffsetY ?? 5,
+      shadowOpacity: patch.shadowOpacity ?? 80,
+      shadowType: patch.shadowType ?? "drop"
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "shadow",
+      name: "Shadow",
+      enabled: patch.enabled ?? true,
+      opacity: 1,
+      blendMode: "source-over",
+      target: "text",
+      params: defaultParams
+    };
+    const panelIdx = layers.findIndex((l) => l.type === "panel");
+    if (panelIdx >= 0) {
+      layers.splice(panelIdx + 1, 0, newL);
+    } else {
+      layers.unshift(newL);
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.enabled !== void 0) nextLegacyConfig.shadowEnabled = patch.enabled;
+    if (patch.shadowColor !== void 0) nextLegacyConfig.shadowColor = patch.shadowColor;
+    if (patch.shadowBlur !== void 0) nextLegacyConfig.shadowBlur = patch.shadowBlur;
+    if (patch.shadowOffsetX !== void 0) nextLegacyConfig.shadowOffsetX = patch.shadowOffsetX;
+    if (patch.shadowOffsetY !== void 0) nextLegacyConfig.shadowOffsetY = patch.shadowOffsetY;
+    if (patch.shadowOpacity !== void 0) nextLegacyConfig.shadowOpacity = patch.shadowOpacity;
+    if (patch.shadowType !== void 0) nextLegacyConfig.shadowType = patch.shadowType;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneBevel(doc, patch) {
+  let found = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "extrusion") {
+      found = true;
+      const nextParams = { ...layer2.params };
+      if (patch.bevelDepth !== void 0) nextParams.bevelDepth = patch.bevelDepth;
+      if (patch.bevelHighlight !== void 0) nextParams.bevelHighlight = patch.bevelHighlight;
+      if (patch.bevelShadow !== void 0) nextParams.bevelShadow = patch.bevelShadow;
+      if (patch.bevelDirection !== void 0) nextParams.bevelDirection = patch.bevelDirection;
+      if (patch.bevelCoreColor !== void 0) nextParams.bevelCoreColor = patch.bevelCoreColor;
+      if (patch.bevelEdgeColor !== void 0) nextParams.bevelEdgeColor = patch.bevelEdgeColor;
+      if (patch.bevelEdgeWidth !== void 0) nextParams.bevelEdgeWidth = patch.bevelEdgeWidth;
+      if (patch.bevelBlur !== void 0) nextParams.bevelBlur = patch.bevelBlur;
+      if (patch.bevelBlurColor !== void 0) nextParams.bevelBlurColor = patch.bevelBlurColor;
+      if (patch.bevelPerspectiveEnabled !== void 0) nextParams.bevelPerspectiveEnabled = patch.bevelPerspectiveEnabled;
+      if (patch.bevelVanishingPointX !== void 0) nextParams.bevelVanishingPointX = patch.bevelVanishingPointX;
+      if (patch.bevelVanishingPointY !== void 0) nextParams.bevelVanishingPointY = patch.bevelVanishingPointY;
+      if (patch.bevelFocalLength !== void 0) nextParams.bevelFocalLength = patch.bevelFocalLength;
+      const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+      if (patch.enabled !== void 0) {
+        nextParams.bevelEnabled = patch.enabled;
+      }
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!found) {
+    const defaultParams = {
+      bevelEnabled: patch.enabled ?? true,
+      bevelDepth: patch.bevelDepth ?? 5,
+      bevelHighlight: patch.bevelHighlight ?? "#FFFFFF",
+      bevelShadow: patch.bevelShadow ?? "#000000",
+      bevelDirection: patch.bevelDirection ?? "bottom-right",
+      bevelCoreColor: patch.bevelCoreColor ?? "#000000",
+      bevelEdgeColor: patch.bevelEdgeColor ?? "#2A2A38",
+      bevelEdgeWidth: patch.bevelEdgeWidth ?? 0,
+      bevelBlur: patch.bevelBlur ?? 0,
+      bevelBlurColor: patch.bevelBlurColor ?? "#000000",
+      bevelPerspectiveEnabled: patch.bevelPerspectiveEnabled ?? false,
+      bevelVanishingPointX: patch.bevelVanishingPointX ?? 40,
+      bevelVanishingPointY: patch.bevelVanishingPointY ?? 80,
+      bevelFocalLength: patch.bevelFocalLength ?? 400
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "extrusion",
+      name: "Bevel / Extrusion",
+      enabled: patch.enabled ?? true,
+      opacity: 1,
+      blendMode: "source-over",
+      target: "text",
+      params: defaultParams
+    };
+    const stackIdx = layers.findIndex((l) => l.type === "duplicateStack");
+    if (stackIdx >= 0) {
+      layers.splice(stackIdx, 0, newL);
+    } else {
+      const strokeIdx = layers.findIndex((l) => l.type === "stroke");
+      if (strokeIdx >= 0) {
+        layers.splice(strokeIdx, 0, newL);
+      } else {
+        const maskIdx = layers.findIndex((l) => l.type === "mask" || l.type === "filter");
+        if (maskIdx >= 0) {
+          layers.splice(maskIdx, 0, newL);
+        } else {
+          layers.push(newL);
+        }
+      }
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.enabled !== void 0) nextLegacyConfig.bevelEnabled = patch.enabled;
+    if (patch.bevelDepth !== void 0) nextLegacyConfig.bevelDepth = patch.bevelDepth;
+    if (patch.bevelHighlight !== void 0) nextLegacyConfig.bevelHighlight = patch.bevelHighlight;
+    if (patch.bevelShadow !== void 0) nextLegacyConfig.bevelShadow = patch.bevelShadow;
+    if (patch.bevelDirection !== void 0) nextLegacyConfig.bevelDirection = patch.bevelDirection;
+    if (patch.bevelCoreColor !== void 0) nextLegacyConfig.bevelCoreColor = patch.bevelCoreColor;
+    if (patch.bevelEdgeColor !== void 0) nextLegacyConfig.bevelEdgeColor = patch.bevelEdgeColor;
+    if (patch.bevelEdgeWidth !== void 0) nextLegacyConfig.bevelEdgeWidth = patch.bevelEdgeWidth;
+    if (patch.bevelBlur !== void 0) nextLegacyConfig.bevelBlur = patch.bevelBlur;
+    if (patch.bevelBlurColor !== void 0) nextLegacyConfig.bevelBlurColor = patch.bevelBlurColor;
+    if (patch.bevelPerspectiveEnabled !== void 0) nextLegacyConfig.bevelPerspectiveEnabled = patch.bevelPerspectiveEnabled;
+    if (patch.bevelVanishingPointX !== void 0) nextLegacyConfig.bevelVanishingPointX = patch.bevelVanishingPointX;
+    if (patch.bevelVanishingPointY !== void 0) nextLegacyConfig.bevelVanishingPointY = patch.bevelVanishingPointY;
+    if (patch.bevelFocalLength !== void 0) nextLegacyConfig.bevelFocalLength = patch.bevelFocalLength;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneStack(doc, patch) {
+  let found = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "duplicateStack") {
+      found = true;
+      const nextParams = { ...layer2.params };
+      if (patch.stackCount !== void 0) nextParams.stackCount = patch.stackCount;
+      if (patch.stackOffsetX !== void 0) nextParams.stackOffsetX = patch.stackOffsetX;
+      if (patch.stackOffsetY !== void 0) nextParams.stackOffsetY = patch.stackOffsetY;
+      if (patch.stackOpacityDecay !== void 0) nextParams.stackOpacityDecay = patch.stackOpacityDecay;
+      if (patch.stackColor1 !== void 0) nextParams.stackColor1 = patch.stackColor1;
+      if (patch.stackColor2 !== void 0) nextParams.stackColor2 = patch.stackColor2;
+      if (patch.stackColor3 !== void 0) nextParams.stackColor3 = patch.stackColor3;
+      if (patch.stackColor4 !== void 0) nextParams.stackColor4 = patch.stackColor4;
+      const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+      if (patch.enabled !== void 0) {
+        nextParams.stackEnabled = patch.enabled;
+      }
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!found) {
+    const defaultParams = {
+      stackEnabled: patch.enabled ?? true,
+      stackCount: patch.stackCount ?? 3,
+      stackOffsetX: patch.stackOffsetX ?? 10,
+      stackOffsetY: patch.stackOffsetY ?? -10,
+      stackOpacityDecay: patch.stackOpacityDecay ?? 20,
+      stackColor1: patch.stackColor1 ?? "#FF7C00",
+      stackColor2: patch.stackColor2 ?? "#00FFDD",
+      stackColor3: patch.stackColor3 ?? "#FF00AA",
+      stackColor4: patch.stackColor4 ?? "#AA00FF"
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "duplicateStack",
+      name: "Stack Extrusion",
+      enabled: patch.enabled ?? true,
+      opacity: 1,
+      blendMode: "source-over",
+      target: "text",
+      params: defaultParams
+    };
+    const strokeIdx = layers.findIndex((l) => l.type === "stroke");
+    if (strokeIdx >= 0) {
+      layers.splice(strokeIdx, 0, newL);
+    } else {
+      const maskIdx = layers.findIndex((l) => l.type === "mask" || l.type === "filter");
+      if (maskIdx >= 0) {
+        layers.splice(maskIdx, 0, newL);
+      } else {
+        layers.push(newL);
+      }
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.enabled !== void 0) nextLegacyConfig.stackEnabled = patch.enabled;
+    if (patch.stackCount !== void 0) nextLegacyConfig.stackCount = patch.stackCount;
+    if (patch.stackOffsetX !== void 0) nextLegacyConfig.stackOffsetX = patch.stackOffsetX;
+    if (patch.stackOffsetY !== void 0) nextLegacyConfig.stackOffsetY = patch.stackOffsetY;
+    if (patch.stackOpacityDecay !== void 0) nextLegacyConfig.stackOpacityDecay = patch.stackOpacityDecay;
+    if (patch.stackColor1 !== void 0) nextLegacyConfig.stackColor1 = patch.stackColor1;
+    if (patch.stackColor2 !== void 0) nextLegacyConfig.stackColor2 = patch.stackColor2;
+    if (patch.stackColor3 !== void 0) nextLegacyConfig.stackColor3 = patch.stackColor3;
+    if (patch.stackColor4 !== void 0) nextLegacyConfig.stackColor4 = patch.stackColor4;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneFill(doc, patch) {
+  let found = false;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "fill") {
+      found = true;
+      const nextParams = { ...layer2.params };
+      if (patch.fillType !== void 0) nextParams.fillType = patch.fillType;
+      if (patch.fillColor !== void 0) nextParams.fillColor = patch.fillColor;
+      if (patch.fillGradientAngle !== void 0) nextParams.fillGradientAngle = patch.fillGradientAngle;
+      if (patch.fillGradientStops !== void 0) nextParams.fillGradientStops = patch.fillGradientStops;
+      if (patch.patternType !== void 0) nextParams.patternType = patch.patternType;
+      if (patch.perCharFillEnabled !== void 0) nextParams.perCharFillEnabled = patch.perCharFillEnabled;
+      if (patch.charFillColors !== void 0) nextParams.charFillColors = patch.charFillColors;
+      const enabled = patch.fillType !== void 0 ? patch.fillType !== "none" : layer2.enabled;
+      return {
+        ...layer2,
+        enabled,
+        params: nextParams
+      };
+    }
+    return layer2;
+  });
+  const layers = [...nextLayers];
+  if (!found) {
+    const defaultParams = {
+      fillType: patch.fillType ?? "solid",
+      fillColor: patch.fillColor ?? "#FFFFFF",
+      fillGradientAngle: patch.fillGradientAngle ?? 90,
+      fillGradientStops: patch.fillGradientStops ?? [
+        { color: "#FFFFFF", offset: 0 },
+        { color: "#E0E0E0", offset: 100 }
+      ],
+      patternType: patch.patternType ?? "chalk",
+      perCharFillEnabled: patch.perCharFillEnabled ?? false,
+      charFillColors: patch.charFillColors ?? []
+    };
+    const newL = {
+      id: newLayerId(),
+      type: "fill",
+      name: "Fill",
+      enabled: patch.fillType !== "none",
+      opacity: 1,
+      blendMode: "source-over",
+      target: "text",
+      params: defaultParams
+    };
+    const maskIdx = layers.findIndex((l) => l.type === "mask" || l.type === "filter");
+    if (maskIdx >= 0) {
+      layers.splice(maskIdx, 0, newL);
+    } else {
+      layers.push(newL);
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.fillType !== void 0) nextLegacyConfig.fillType = patch.fillType;
+    if (patch.fillColor !== void 0) nextLegacyConfig.fillColor = patch.fillColor;
+    if (patch.fillGradientAngle !== void 0) nextLegacyConfig.fillGradientAngle = patch.fillGradientAngle;
+    if (patch.fillGradientStops !== void 0) nextLegacyConfig.fillGradientStops = patch.fillGradientStops;
+    if (patch.patternType !== void 0) nextLegacyConfig.patternType = patch.patternType;
+    if (patch.perCharFillEnabled !== void 0) nextLegacyConfig.perCharFillEnabled = patch.perCharFillEnabled;
+    if (patch.charFillColors !== void 0) nextLegacyConfig.charFillColors = patch.charFillColors;
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneGlow(doc, index, patch) {
+  const currentGlowLayers = doc.effectLayers.filter((l) => l.type === "glow");
+  const layers = [...doc.effectLayers];
+  if (index >= currentGlowLayers.length) {
+    const needed = index - currentGlowLayers.length + 1;
+    for (let i = 0; i < needed; i++) {
+      const isTarget = i === needed - 1;
+      const defaultGlow = {
+        enabled: isTarget ? patch.enabled ?? false : false,
+        color: isTarget ? patch.color ?? "#7C6FFF" : "#7C6FFF",
+        blur: isTarget ? patch.blur ?? 20 : 20,
+        opacity: isTarget ? patch.opacity ?? 80 : 80,
+        type: isTarget ? patch.type ?? "outer" : "outer",
+        strength: isTarget ? patch.strength : void 0,
+        spread: isTarget ? patch.spread : void 0
+      };
+      const newL = {
+        id: newLayerId(),
+        type: "glow",
+        name: `Glow ${currentGlowLayers.length + i + 1}`,
+        enabled: defaultGlow.enabled,
+        opacity: defaultGlow.opacity / 100,
+        blendMode: "source-over",
+        target: "text",
+        params: defaultGlow
+      };
+      const lastGlowIdx = layers.map((l) => l.type).lastIndexOf("glow");
+      if (lastGlowIdx >= 0) {
+        layers.splice(lastGlowIdx + 1 + i, 0, newL);
+      } else {
+        const insertIdx = layers.findIndex((l) => l.type === "mask" || l.type === "filter");
+        if (insertIdx >= 0) {
+          layers.splice(insertIdx + i, 0, newL);
+        } else {
+          layers.push(newL);
+        }
+      }
+    }
+  } else {
+    let glowCount = 0;
+    for (let i = 0; i < layers.length; i++) {
+      if (layers[i].type === "glow") {
+        if (glowCount === index) {
+          const layer2 = layers[i];
+          const nextParams = { ...layer2.params, ...patch };
+          const enabled = patch.enabled !== void 0 ? patch.enabled : layer2.enabled;
+          const opacity = patch.opacity !== void 0 ? patch.opacity / 100 : layer2.opacity;
+          layers[i] = {
+            ...layer2,
+            enabled,
+            opacity,
+            params: nextParams
+          };
+          break;
+        }
+        glowCount++;
+      }
+    }
+  }
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (!nextLegacyConfig.glowLayers) nextLegacyConfig.glowLayers = [];
+    while (nextLegacyConfig.glowLayers.length <= index) {
+      nextLegacyConfig.glowLayers.push({
+        enabled: false,
+        color: "#7C6FFF",
+        blur: 20,
+        opacity: 80,
+        type: "outer"
+      });
+    }
+    nextLegacyConfig.glowLayers[index] = { ...nextLegacyConfig.glowLayers[index], ...patch };
+  }
+  return {
+    ...doc,
+    effectLayers: layers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneCanvas(doc, patch) {
+  const nextCanvas = { ...doc.canvas };
+  if (patch.width !== void 0) nextCanvas.width = patch.width;
+  if (patch.height !== void 0) nextCanvas.height = patch.height;
+  if (patch.background !== void 0) nextCanvas.background = patch.background;
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.width !== void 0) nextLegacyConfig.canvasWidth = patch.width;
+    if (patch.height !== void 0) nextLegacyConfig.canvasHeight = patch.height;
+  }
+  return {
+    ...doc,
+    canvas: nextCanvas,
+    legacyConfig: nextLegacyConfig
+  };
+}
+function updateSceneCustomEngine(doc, patch) {
+  let nextEngineId = doc.customEngineId;
+  if (patch.customRenderer !== void 0) {
+    nextEngineId = patch.customRenderer ? LEGACY_RENDERER_MAP[patch.customRenderer] ?? null : null;
+  }
+  const nextParams = { ...doc.engineParams, ...patch };
+  delete nextParams.customRenderer;
+  const nextLayers = doc.effectLayers.map((layer2) => {
+    if (layer2.type === "customEngine") {
+      if (layer2.name === "Custom Engine") {
+        return {
+          ...layer2,
+          params: { ...layer2.params, engineId: nextEngineId }
+        };
+      } else if (layer2.name === "Engine Params") {
+        return {
+          ...layer2,
+          params: { ...layer2.params, ...nextParams }
+        };
+      }
+    }
+    return layer2;
+  });
+  const nextLegacyConfig = doc.legacyConfig ? { ...doc.legacyConfig } : void 0;
+  if (nextLegacyConfig) {
+    if (patch.customRenderer !== void 0) nextLegacyConfig.customRenderer = patch.customRenderer;
+    if (patch.inkColor !== void 0) nextLegacyConfig.inkColor = patch.inkColor;
+    if (patch.bristleDensity !== void 0) nextLegacyConfig.bristleDensity = patch.bristleDensity;
+    if (patch.bristleSkipRate !== void 0) nextLegacyConfig.bristleSkipRate = patch.bristleSkipRate;
+    if (patch.dripRate !== void 0) nextLegacyConfig.dripRate = patch.dripRate;
+    if (patch.dripMaxLength !== void 0) nextLegacyConfig.dripMaxLength = patch.dripMaxLength;
+    if (patch.grainDensity !== void 0) nextLegacyConfig.grainDensity = patch.grainDensity;
+    if (patch.skewX !== void 0) nextLegacyConfig.skewX = patch.skewX;
+  }
+  return {
+    ...doc,
+    customEngineId: nextEngineId,
+    engineParams: nextParams,
+    effectLayers: nextLayers,
+    legacyConfig: nextLegacyConfig
+  };
+}
+var TextEffectBuilder = class _TextEffectBuilder {
+  config;
+  constructor(initialConfig) {
+    this.config = { ...defaultConfig, ...initialConfig };
+  }
+  /** Load builder from an existing TextEffectConfig object */
+  static fromConfig(config) {
+    return new _TextEffectBuilder(config);
+  }
+  /** Load builder from an existing SceneDocument */
+  static fromScene(scene) {
+    return new _TextEffectBuilder(sceneToConfig(scene));
+  }
+  /**
+   * Load builder from a downloaded TextEffectDefinition.
+   * Resolves the styling definition structure to a flat engine config.
+   */
+  static fromDefinition(effect, text = "CLYPRA", fontSize = 80, canvasWidth = 800, canvasHeight = 200) {
+    const config = _buildConfig(effect, text, fontSize, canvasWidth, canvasHeight);
+    return new _TextEffectBuilder(config);
+  }
+  /** Set text string content */
+  setText(text) {
+    this.config.text = text;
+    return this;
+  }
+  /** Configure Font and alignment settings */
+  setFont(font) {
+    if (font.family !== void 0) this.config.fontFamily = font.family;
+    if (font.weight !== void 0) this.config.fontWeight = font.weight;
+    if (font.style !== void 0) this.config.fontStyle = font.style;
+    if (font.size !== void 0) this.config.fontSize = font.size;
+    if (font.letterSpacing !== void 0) this.config.letterSpacing = font.letterSpacing;
+    if (font.lineHeight !== void 0) this.config.lineHeight = font.lineHeight;
+    return this;
+  }
+  /** Configure Background Panel (bounding plate) */
+  setPanel(panel) {
+    if (panel.enabled !== void 0) this.config.panelEnabled = panel.enabled;
+    if (panel.color !== void 0) this.config.panelColor = panel.color;
+    if (panel.opacity !== void 0) this.config.panelOpacity = panel.opacity;
+    if (panel.radius !== void 0) this.config.panelRadius = panel.radius;
+    if (panel.paddingX !== void 0) this.config.panelPaddingX = panel.paddingX;
+    if (panel.paddingY !== void 0) this.config.panelPaddingY = panel.paddingY;
+    if (panel.strokeEnabled !== void 0) this.config.panelStrokeEnabled = panel.strokeEnabled;
+    if (panel.strokeColor !== void 0) this.config.panelStrokeColor = panel.strokeColor;
+    if (panel.strokeWidth !== void 0) this.config.panelStrokeWidth = panel.strokeWidth;
+    return this;
+  }
+  /** Configure outline / stroke styling */
+  setStroke(stroke) {
+    if (stroke.enabled !== void 0) this.config.strokeEnabled = stroke.enabled;
+    if (stroke.color !== void 0) this.config.strokeColor = stroke.color;
+    if (stroke.width !== void 0) this.config.strokeWidth = stroke.width;
+    if (stroke.position !== void 0) this.config.strokePosition = stroke.position;
+    if (stroke.opacity !== void 0) this.config.strokeOpacity = stroke.opacity;
+    if (stroke.lineJoin !== void 0) this.config.strokeLineJoin = stroke.lineJoin;
+    if (stroke.blur !== void 0) this.config.strokeBlur = stroke.blur;
+    if (stroke.type !== void 0) this.config.strokeType = stroke.type;
+    if (stroke.colorSecondary !== void 0) this.config.strokeColorSecondary = stroke.colorSecondary;
+    if (stroke.widthSecondary !== void 0) this.config.strokeWidthSecondary = stroke.widthSecondary;
+    if (stroke.fadeRange !== void 0) this.config.strokeFadeRange = stroke.fadeRange;
+    return this;
+  }
+  /** Configure drop shadow / inner shadow styling */
+  setShadow(shadow) {
+    if (shadow.enabled !== void 0) this.config.shadowEnabled = shadow.enabled;
+    if (shadow.color !== void 0) this.config.shadowColor = shadow.color;
+    if (shadow.blur !== void 0) this.config.shadowBlur = shadow.blur;
+    if (shadow.offsetX !== void 0) this.config.shadowOffsetX = shadow.offsetX;
+    if (shadow.offsetY !== void 0) this.config.shadowOffsetY = shadow.offsetY;
+    if (shadow.opacity !== void 0) this.config.shadowOpacity = shadow.opacity;
+    if (shadow.type !== void 0) this.config.shadowType = shadow.type;
+    return this;
+  }
+  /** Configure a specific glow layer by index */
+  setGlow(index, glow) {
+    if (!this.config.glowLayers) this.config.glowLayers = [];
+    while (this.config.glowLayers.length <= index) {
+      this.config.glowLayers.push({ enabled: false, color: "#7C6FFF", blur: 20, opacity: 80, type: "outer" });
+    }
+    this.config.glowLayers[index] = { ...this.config.glowLayers[index], ...glow };
+    return this;
+  }
+  /** Configure solid color fill */
+  setFillColor(color) {
+    this.config.fillType = "solid";
+    this.config.fillColor = color;
+    return this;
+  }
+  /** Configure linear gradient fill */
+  setFillGradient(angle, stops) {
+    this.config.fillType = "linear";
+    this.config.fillGradientAngle = angle;
+    this.config.fillGradientStops = stops;
+    return this;
+  }
+  /** Configure texture pattern fill */
+  setFillPattern(patternType) {
+    this.config.fillType = "pattern";
+    this.config.patternType = patternType;
+    return this;
+  }
+  /** Configure per-character solid color fill overrides */
+  setPerCharFill(enabled, colors) {
+    this.config.perCharFillEnabled = enabled;
+    this.config.charFillColors = colors;
+    return this;
+  }
+  /** Configure 3D extrusion/bevel settings */
+  setBevel(bevel) {
+    if (bevel.enabled !== void 0) this.config.bevelEnabled = bevel.enabled;
+    if (bevel.depth !== void 0) this.config.bevelDepth = bevel.depth;
+    if (bevel.highlight !== void 0) this.config.bevelHighlight = bevel.highlight;
+    if (bevel.bevelShadow !== void 0) this.config.bevelShadow = bevel.bevelShadow;
+    if (bevel.direction !== void 0) this.config.bevelDirection = bevel.direction;
+    if (bevel.coreColor !== void 0) this.config.bevelCoreColor = bevel.coreColor;
+    if (bevel.edgeColor !== void 0) this.config.bevelEdgeColor = bevel.edgeColor;
+    if (bevel.edgeWidth !== void 0) this.config.bevelEdgeWidth = bevel.edgeWidth;
+    if (bevel.blur !== void 0) this.config.bevelBlur = bevel.blur;
+    if (bevel.blurColor !== void 0) this.config.bevelBlurColor = bevel.blurColor;
+    if (bevel.perspectiveEnabled !== void 0) this.config.bevelPerspectiveEnabled = bevel.perspectiveEnabled;
+    if (bevel.vanishingPointX !== void 0) this.config.bevelVanishingPointX = bevel.vanishingPointX;
+    if (bevel.vanishingPointY !== void 0) this.config.bevelVanishingPointY = bevel.vanishingPointY;
+    if (bevel.focalLength !== void 0) this.config.bevelFocalLength = bevel.focalLength;
+    return this;
+  }
+  /** Configure multi-stack duplicate extrusion */
+  setStack(stack) {
+    if (stack.enabled !== void 0) this.config.stackEnabled = stack.enabled;
+    if (stack.count !== void 0) this.config.stackCount = stack.count;
+    if (stack.offsetX !== void 0) this.config.stackOffsetX = stack.offsetX;
+    if (stack.offsetY !== void 0) this.config.stackOffsetY = stack.offsetY;
+    if (stack.opacityDecay !== void 0) this.config.stackOpacityDecay = stack.opacityDecay;
+    if (stack.color1 !== void 0) this.config.stackColor1 = stack.color1;
+    if (stack.color2 !== void 0) this.config.stackColor2 = stack.color2;
+    if (stack.color3 !== void 0) this.config.stackColor3 = stack.color3;
+    if (stack.color4 !== void 0) this.config.stackColor4 = stack.color4;
+    return this;
+  }
+  /** Configure canvas viewport size, alignment positioning, and wrapping behavior */
+  setCanvas(canvas) {
+    if (canvas.width !== void 0) this.config.canvasWidth = canvas.width;
+    if (canvas.height !== void 0) this.config.canvasHeight = canvas.height;
+    if (canvas.posX !== void 0) this.config.textPosX = canvas.posX;
+    if (canvas.posY !== void 0) this.config.textPosY = canvas.posY;
+    if (canvas.wrapText !== void 0) this.config.wrapText = canvas.wrapText;
+    if (canvas.autoFitText !== void 0) this.config.autoFitText = canvas.autoFitText;
+    return this;
+  }
+  /** Configure procedural InkBrushEngine variables (when customRenderer = InkBrushEngine) */
+  setInkBrush(ink) {
+    if (ink.inkColor !== void 0) this.config.inkColor = ink.inkColor;
+    if (ink.bristleDensity !== void 0) this.config.bristleDensity = ink.bristleDensity;
+    if (ink.bristleSkipRate !== void 0) this.config.bristleSkipRate = ink.bristleSkipRate;
+    if (ink.dripRate !== void 0) this.config.dripRate = ink.dripRate;
+    if (ink.dripMaxLength !== void 0) this.config.dripMaxLength = ink.dripMaxLength;
+    if (ink.grainDensity !== void 0) this.config.grainDensity = ink.grainDensity;
+    if (ink.skewX !== void 0) this.config.skewX = ink.skewX;
+    return this;
+  }
+  /** Build and return a copy of the updated TextEffectConfig */
+  buildConfig() {
+    return { ...this.config };
+  }
+  /** Build and return a SceneDocument prepared for rendering with evaluateScene */
+  buildScene() {
+    return textEffectConfigToScene(this.config);
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMPOSITION_PRESETS,
@@ -6657,6 +7483,7 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   SCENE_VERSION,
   SUPPORTED_FONT_FAMILIES,
   TEMPLATE_CATEGORIES,
+  TextEffectBuilder,
   TextEffectRenderer,
   WEBM_EXPORT_MAX_FRAMES,
   WebGLCompositor,
@@ -6793,6 +7620,16 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   textEffectConfigToScene,
   trackId,
   updateKeyframe,
+  updateSceneBevel,
+  updateSceneCanvas,
+  updateSceneCustomEngine,
+  updateSceneFill,
+  updateSceneGlow,
+  updateScenePanel,
+  updateSceneShadow,
+  updateSceneStack,
+  updateSceneStroke,
+  updateSceneText,
   updateStaticProperty,
   updateTimeline,
   updateTrack,