@clypra/engine 1.2.1 → 1.3.1

package/dist/index.cjs

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AnimationSchema: () => AnimationSchema,
   COMPOSITION_PRESETS: () => COMPOSITION_PRESETS,
   CUSTOM_ENGINE_IDS: () => CUSTOM_ENGINE_IDS,
   CanvasDevice: () => CanvasDevice,
@@ -32,8 +33,19 @@ __export(index_exports, {
   ENGINE_ID_TO_LEGACY: () => ENGINE_ID_TO_LEGACY,
   ENTRANCE_PRESETS: () => ENTRANCE_PRESETS,
   EXIT_PRESETS: () => EXIT_PRESETS,
+  EffectBevelSchema: () => EffectBevelSchema,
+  EffectFillSchema: () => EffectFillSchema,
+  EffectFullDefinitionSchema: () => EffectFullDefinitionSchema,
+  EffectGlowSchema: () => EffectGlowSchema,
+  EffectIndexItemSchema: () => EffectIndexItemSchema,
+  EffectPanelSchema: () => EffectPanelSchema,
+  EffectShadowSchema: () => EffectShadowSchema,
+  EffectStackSchema: () => EffectStackSchema,
+  EffectStrokeSchema: () => EffectStrokeSchema,
   FONT_WEIGHT_OPTIONS: () => FONT_WEIGHT_OPTIONS,
   FontLoader: () => FontLoader,
+  FontSchema: () => FontSchema,
+  GradientStopSchema: () => GradientStopSchema,
   InkBrushEngine: () => InkBrushEngine,
   LEGACY_RENDERER_MAP: () => LEGACY_RENDERER_MAP,
   LOOP_PRESETS: () => LOOP_PRESETS,
@@ -42,6 +54,8 @@ __export(index_exports, {
   SCENE_VERSION: () => SCENE_VERSION,
   SUPPORTED_FONT_FAMILIES: () => SUPPORTED_FONT_FAMILIES,
   TEMPLATE_CATEGORIES: () => TEMPLATE_CATEGORIES,
+  TextEffectBuilder: () => TextEffectBuilder,
+  TextEffectDefinitionSchema: () => TextEffectDefinitionSchema,
   TextEffectRenderer: () => TextEffectRenderer,
   WEBM_EXPORT_MAX_FRAMES: () => WEBM_EXPORT_MAX_FRAMES,
   WebGLCompositor: () => WebGLCompositor,
@@ -107,6 +121,7 @@ __export(index_exports, {
   evaluateConfig: () => evaluateConfig,
   evaluateScene: () => evaluateScene,
   findTrackIndex: () => findTrackIndex,
+  formatValidationErrors: () => formatValidationErrors,
   getAnimPreset: () => getAnimPreset,
   getAnimatableParamDef: () => getAnimatableParamDef,
   getAnimatableParamsForLayer: () => getAnimatableParamsForLayer,
@@ -178,16 +193,198 @@ __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,
   updateTrackMatte: () => updateTrackMatte,
   upsertKeyframe: () => upsertKeyframe,
+  validateEffectDefinition: () => validateEffectDefinition,
+  validateEffectDefinitionStrict: () => validateEffectDefinitionStrict,
+  validateTextEffectDefinition: () => validateTextEffectDefinition,
+  validateTextEffectDefinitionStrict: () => validateTextEffectDefinitionStrict,
   waitForFontsReady: () => waitForFontsReady,
   wrapTextToWidth: () => wrapTextToWidth
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/validation.ts
+var import_zod = require("zod");
+var GradientStopSchema = import_zod.z.object({
+  color: import_zod.z.string(),
+  offset: import_zod.z.number().min(0).max(100)
+});
+var EffectFillSchema = import_zod.z.object({
+  type: import_zod.z.enum(["solid", "linear", "radial", "pattern", "none"]),
+  color: import_zod.z.string().optional(),
+  gradient: import_zod.z.object({
+    angle: import_zod.z.number(),
+    stops: import_zod.z.array(GradientStopSchema)
+  }).optional(),
+  patternType: import_zod.z.string().optional(),
+  perCharFillEnabled: import_zod.z.boolean().optional(),
+  charFillColors: import_zod.z.array(import_zod.z.string()).optional()
+});
+var EffectStrokeSchema = import_zod.z.object({
+  color: import_zod.z.string(),
+  width: import_zod.z.number().min(0),
+  position: import_zod.z.enum(["outside", "center", "inside"]).optional(),
+  opacity: import_zod.z.number().min(0).max(100).optional(),
+  lineJoin: import_zod.z.enum(["round", "miter", "bevel"]).optional(),
+  blur: import_zod.z.number().min(0).optional(),
+  type: import_zod.z.enum(["solid", "gradient"]).optional(),
+  colorSecondary: import_zod.z.string().optional(),
+  widthSecondary: import_zod.z.number().min(0).optional(),
+  fadeRange: import_zod.z.tuple([import_zod.z.number(), import_zod.z.number()]).optional()
+});
+var EffectShadowSchema = import_zod.z.object({
+  type: import_zod.z.enum(["drop", "inner"]).optional(),
+  color: import_zod.z.string(),
+  blur: import_zod.z.number().min(0),
+  offset: import_zod.z.object({
+    x: import_zod.z.number(),
+    y: import_zod.z.number()
+  }).optional(),
+  offsetX: import_zod.z.number().optional(),
+  // Legacy flat format
+  offsetY: import_zod.z.number().optional(),
+  // Legacy flat format
+  opacity: import_zod.z.number().min(0).max(100).optional()
+}).refine((data) => data.offset !== void 0 || data.offsetX !== void 0 && data.offsetY !== void 0, { message: "Shadow must have either nested 'offset' or flat 'offsetX/offsetY'" });
+var EffectBevelSchema = import_zod.z.object({
+  depth: import_zod.z.number().min(0),
+  highlight: import_zod.z.string().optional(),
+  // Current Studio output
+  highlightColor: import_zod.z.string().optional(),
+  // Legacy format
+  shadow: import_zod.z.string().optional(),
+  // Current Studio output
+  shadowColor: import_zod.z.string().optional(),
+  // Legacy format
+  direction: import_zod.z.enum(["bottom-right", "bottom", "right"]).optional(),
+  coreColor: import_zod.z.string().optional(),
+  edgeColor: import_zod.z.string().optional(),
+  edgeWidth: import_zod.z.number().min(0).optional(),
+  blur: import_zod.z.number().min(0).optional(),
+  blurColor: import_zod.z.string().optional(),
+  perspectiveEnabled: import_zod.z.boolean().optional(),
+  vanishingPointX: import_zod.z.number().optional(),
+  vanishingPointY: import_zod.z.number().optional(),
+  focalLength: import_zod.z.number().optional()
+}).refine((data) => data.highlight !== void 0 || data.highlightColor !== void 0, { message: "Bevel must have either 'highlight' or 'highlightColor'" }).refine((data) => data.shadow !== void 0 || data.shadowColor !== void 0, { message: "Bevel must have either 'shadow' or 'shadowColor'" });
+var EffectGlowSchema = import_zod.z.object({
+  color: import_zod.z.string(),
+  blur: import_zod.z.number().min(0),
+  opacity: import_zod.z.number().min(0).max(100),
+  type: import_zod.z.enum(["outer", "inner"]).optional(),
+  strength: import_zod.z.number().min(0).optional(),
+  spread: import_zod.z.number().min(0).optional()
+});
+var EffectPanelSchema = import_zod.z.object({
+  color: import_zod.z.string(),
+  opacity: import_zod.z.number().min(0).max(100),
+  radius: import_zod.z.number().min(0),
+  padding: import_zod.z.object({
+    x: import_zod.z.number().min(0),
+    y: import_zod.z.number().min(0)
+  }).optional(),
+  paddingX: import_zod.z.number().min(0).optional(),
+  // Legacy flat format
+  paddingY: import_zod.z.number().min(0).optional(),
+  // Legacy flat format
+  stroke: import_zod.z.object({
+    color: import_zod.z.string(),
+    width: import_zod.z.number().min(0)
+  }).nullable().optional()
+}).refine((data) => data.padding !== void 0 || data.paddingX !== void 0 && data.paddingY !== void 0, { message: "Panel must have either nested 'padding' or flat 'paddingX/paddingY'" });
+var EffectStackSchema = import_zod.z.object({
+  count: import_zod.z.number().int().min(1).max(100),
+  offsetX: import_zod.z.number(),
+  offsetY: import_zod.z.number(),
+  opacityDecay: import_zod.z.number().min(0).max(1),
+  color1: import_zod.z.string().optional(),
+  color2: import_zod.z.string().optional(),
+  color3: import_zod.z.string().optional(),
+  color4: import_zod.z.string().optional()
+});
+var FontSchema = import_zod.z.object({
+  family: import_zod.z.string().min(1),
+  weight: import_zod.z.number().int().min(100).max(900),
+  style: import_zod.z.enum(["normal", "italic"]),
+  letterSpacing: import_zod.z.number(),
+  lineHeight: import_zod.z.number().positive()
+});
+var AnimationSchema = import_zod.z.object({
+  type: import_zod.z.enum(["none", "typewriter", "wave", "fade", "glitch"]),
+  speed: import_zod.z.number().positive().optional(),
+  amplitude: import_zod.z.number().optional(),
+  frequency: import_zod.z.number().positive().optional()
+});
+var EffectIndexItemSchema = import_zod.z.object({
+  id: import_zod.z.string().min(1),
+  name: import_zod.z.string().min(1),
+  category: import_zod.z.string().min(1),
+  description: import_zod.z.string().optional(),
+  tags: import_zod.z.array(import_zod.z.string()).optional(),
+  isPremium: import_zod.z.boolean().optional(),
+  previewType: import_zod.z.enum(["static", "video", "lottie"]).optional(),
+  thumbnailUrl: import_zod.z.string().url().optional(),
+  thumbnail: import_zod.z.string().optional(),
+  previewUrl: import_zod.z.string().url().optional(),
+  durationMs: import_zod.z.number().positive().optional()
+});
+var EffectFullDefinitionSchema = EffectIndexItemSchema.extend({
+  version: import_zod.z.string().optional(),
+  description: import_zod.z.string(),
+  tags: import_zod.z.array(import_zod.z.string()),
+  font: FontSchema,
+  fills: import_zod.z.array(EffectFillSchema),
+  strokes: import_zod.z.array(EffectStrokeSchema),
+  shadows: import_zod.z.array(EffectShadowSchema),
+  bevel: EffectBevelSchema.optional(),
+  glow: EffectGlowSchema.optional(),
+  // Legacy single glow
+  glows: import_zod.z.array(EffectGlowSchema).optional(),
+  // Current multi-layer glows
+  panel: EffectPanelSchema.optional(),
+  glitch: import_zod.z.any().optional(),
+  // TODO: Define proper schema when glitch effects are implemented
+  animation: AnimationSchema.optional(),
+  background: import_zod.z.any().optional(),
+  // DEPRECATED: kept for backward compatibility
+  stack: EffectStackSchema.optional()
+});
+var TextEffectDefinitionSchema = EffectFullDefinitionSchema.extend({
+  text: import_zod.z.string().optional()
+});
+function validateEffectDefinition(data) {
+  return EffectFullDefinitionSchema.safeParse(data);
+}
+function validateEffectDefinitionStrict(data) {
+  return EffectFullDefinitionSchema.parse(data);
+}
+function validateTextEffectDefinition(data) {
+  return TextEffectDefinitionSchema.safeParse(data);
+}
+function validateTextEffectDefinitionStrict(data) {
+  return TextEffectDefinitionSchema.parse(data);
+}
+function formatValidationErrors(error) {
+  return error.issues.map((err) => {
+    const path = err.path.join(".");
+    return `${path ? `${path}: ` : ""}${err.message}`;
+  });
+}
+
 // src/engine/schema.ts
 var SCENE_VERSION = 1;
 var DEFAULT_CANVAS_WIDTH = 800;
@@ -3219,16 +3416,20 @@ function _buildConfig(effect, text, fontSize, canvasWidth, canvasHeight, time, c
   if (shadow) {
     if (shadow.color !== void 0) config.shadowColor = shadow.color;
     if (shadow.blur !== void 0) config.shadowBlur = shadow.blur * ratio;
-    if (shadow.offsetX !== void 0) config.shadowOffsetX = shadow.offsetX * ratio;
-    if (shadow.offsetY !== void 0) config.shadowOffsetY = shadow.offsetY * ratio;
+    if (shadow.offset?.x !== void 0) config.shadowOffsetX = shadow.offset.x * ratio;
+    else if (shadow.offsetX !== void 0) config.shadowOffsetX = shadow.offsetX * ratio;
+    if (shadow.offset?.y !== void 0) config.shadowOffsetY = shadow.offset.y * ratio;
+    else if (shadow.offsetY !== void 0) config.shadowOffsetY = shadow.offsetY * ratio;
     if (shadow.opacity !== void 0) config.shadowOpacity = shadow.opacity;
     if (shadow.type !== void 0) config.shadowType = shadow.type;
   }
   config.bevelEnabled = !!bevel;
   if (bevel) {
     if (bevel.depth !== void 0) config.bevelDepth = Math.round(bevel.depth * ratio);
-    if (bevel.highlightColor !== void 0) config.bevelHighlight = bevel.highlightColor;
-    if (bevel.shadowColor !== void 0) config.bevelShadow = bevel.shadowColor;
+    if (bevel.highlight !== void 0) config.bevelHighlight = bevel.highlight;
+    else if (bevel.highlightColor !== void 0) config.bevelHighlight = bevel.highlightColor;
+    if (bevel.shadow !== void 0) config.bevelShadow = bevel.shadow;
+    else if (bevel.shadowColor !== void 0) config.bevelShadow = bevel.shadowColor;
     if (bevel.direction !== void 0) config.bevelDirection = bevel.direction;
     if (bevel.coreColor !== void 0) config.bevelCoreColor = bevel.coreColor;
     if (bevel.edgeColor !== void 0) config.bevelEdgeColor = bevel.edgeColor;
@@ -3256,8 +3457,10 @@ function _buildConfig(effect, text, fontSize, canvasWidth, canvasHeight, time, c
     if (panel.color !== void 0) config.panelColor = panel.color;
     if (panel.opacity !== void 0) config.panelOpacity = panel.opacity;
     if (panel.radius !== void 0) config.panelRadius = panel.radius;
-    if (panel.paddingX !== void 0) config.panelPaddingX = panel.paddingX * ratio;
-    if (panel.paddingY !== void 0) config.panelPaddingY = panel.paddingY * ratio;
+    if (panel.padding?.x !== void 0) config.panelPaddingX = panel.padding.x * ratio;
+    else if (panel.paddingX !== void 0) config.panelPaddingX = panel.paddingX * ratio;
+    if (panel.padding?.y !== void 0) config.panelPaddingY = panel.padding.y * ratio;
+    else if (panel.paddingY !== void 0) config.panelPaddingY = panel.paddingY * ratio;
     if (panel.stroke !== void 0) {
       config.panelStrokeEnabled = !!panel.stroke;
       if (panel.stroke.color !== void 0) config.panelStrokeColor = panel.stroke.color;
@@ -3278,23 +3481,7 @@ function _buildConfig(effect, text, fontSize, canvasWidth, canvasHeight, time, c
       return mappedGlow;
     });
   }
-  const standardKeys = /* @__PURE__ */ new Set([
-    "id",
-    "name",
-    "category",
-    "description",
-    "tags",
-    "font",
-    "fills",
-    "strokes",
-    "shadows",
-    "glows",
-    "bevel",
-    "panel",
-    "text",
-    "animation",
-    "stack"
-  ]);
+  const standardKeys = /* @__PURE__ */ new Set(["id", "name", "category", "description", "tags", "font", "fills", "strokes", "shadows", "glows", "bevel", "panel", "text", "animation", "stack"]);
   for (const key of Object.keys(effect)) {
     if (!standardKeys.has(key)) {
       config[key] = effect[key];
@@ -4347,8 +4534,8 @@ function applyToLayerTransform(layer2, override) {
     ks.s.k = [override.scaleX, override.scaleY, 100];
   }
   if (override.posX !== void 0 && override.posY !== void 0 && ks.p?.a === 0) {
-    const z = Array.isArray(ks.p.k) ? ks.p.k[2] ?? 0 : 0;
-    ks.p.k = [override.posX, override.posY, z];
+    const z2 = Array.isArray(ks.p.k) ? ks.p.k[2] ?? 0 : 0;
+    ks.p.k = [override.posX, override.posY, z2];
   }
 }
 function mutateTextLayer(layer2, override) {
@@ -6632,8 +6819,824 @@ 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 = {
+  AnimationSchema,
   COMPOSITION_PRESETS,
   CUSTOM_ENGINE_IDS,
   CanvasDevice,
@@ -6647,8 +7650,19 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   ENGINE_ID_TO_LEGACY,
   ENTRANCE_PRESETS,
   EXIT_PRESETS,
+  EffectBevelSchema,
+  EffectFillSchema,
+  EffectFullDefinitionSchema,
+  EffectGlowSchema,
+  EffectIndexItemSchema,
+  EffectPanelSchema,
+  EffectShadowSchema,
+  EffectStackSchema,
+  EffectStrokeSchema,
   FONT_WEIGHT_OPTIONS,
   FontLoader,
+  FontSchema,
+  GradientStopSchema,
   InkBrushEngine,
   LEGACY_RENDERER_MAP,
   LOOP_PRESETS,
@@ -6657,6 +7671,8 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   SCENE_VERSION,
   SUPPORTED_FONT_FAMILIES,
   TEMPLATE_CATEGORIES,
+  TextEffectBuilder,
+  TextEffectDefinitionSchema,
   TextEffectRenderer,
   WEBM_EXPORT_MAX_FRAMES,
   WebGLCompositor,
@@ -6722,6 +7738,7 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   evaluateConfig,
   evaluateScene,
   findTrackIndex,
+  formatValidationErrors,
   getAnimPreset,
   getAnimatableParamDef,
   getAnimatableParamsForLayer,
@@ -6793,11 +7810,25 @@ function duplicateTrackAtPlayhead(doc, trackIndex, previewTime) {
   textEffectConfigToScene,
   trackId,
   updateKeyframe,
+  updateSceneBevel,
+  updateSceneCanvas,
+  updateSceneCustomEngine,
+  updateSceneFill,
+  updateSceneGlow,
+  updateScenePanel,
+  updateSceneShadow,
+  updateSceneStack,
+  updateSceneStroke,
+  updateSceneText,
   updateStaticProperty,
   updateTimeline,
   updateTrack,
   updateTrackMatte,
   upsertKeyframe,
+  validateEffectDefinition,
+  validateEffectDefinitionStrict,
+  validateTextEffectDefinition,
+  validateTextEffectDefinitionStrict,
   waitForFontsReady,
   wrapTextToWidth
 });