@clypra/engine 1.3.0 → 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,
@@ -43,6 +55,7 @@ __export(index_exports, {
   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,
@@ -108,6 +121,7 @@ __export(index_exports, {
   evaluateConfig: () => evaluateConfig,
   evaluateScene: () => evaluateScene,
   findTrackIndex: () => findTrackIndex,
+  formatValidationErrors: () => formatValidationErrors,
   getAnimPreset: () => getAnimPreset,
   getAnimatableParamDef: () => getAnimatableParamDef,
   getAnimatableParamsForLayer: () => getAnimatableParamsForLayer,
@@ -194,11 +208,183 @@ __export(index_exports, {
   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;
@@ -3230,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;
@@ -3267,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;
@@ -3289,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];
@@ -4358,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) {
@@ -7460,6 +7636,7 @@ var TextEffectBuilder = class _TextEffectBuilder {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AnimationSchema,
   COMPOSITION_PRESETS,
   CUSTOM_ENGINE_IDS,
   CanvasDevice,
@@ -7473,8 +7650,19 @@ var TextEffectBuilder = class _TextEffectBuilder {
   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,
@@ -7484,6 +7672,7 @@ var TextEffectBuilder = class _TextEffectBuilder {
   SUPPORTED_FONT_FAMILIES,
   TEMPLATE_CATEGORIES,
   TextEffectBuilder,
+  TextEffectDefinitionSchema,
   TextEffectRenderer,
   WEBM_EXPORT_MAX_FRAMES,
   WebGLCompositor,
@@ -7549,6 +7738,7 @@ var TextEffectBuilder = class _TextEffectBuilder {
   evaluateConfig,
   evaluateScene,
   findTrackIndex,
+  formatValidationErrors,
   getAnimPreset,
   getAnimatableParamDef,
   getAnimatableParamsForLayer,
@@ -7635,6 +7825,10 @@ var TextEffectBuilder = class _TextEffectBuilder {
   updateTrack,
   updateTrackMatte,
   upsertKeyframe,
+  validateEffectDefinition,
+  validateEffectDefinitionStrict,
+  validateTextEffectDefinition,
+  validateTextEffectDefinitionStrict,
   waitForFontsReady,
   wrapTextToWidth
 });