motionrender 0.2.0 → 0.2.2

package/dist/index.js

@@ -483,7 +483,35 @@ var captionLines = (cues, maxWords) => cues.flatMap((cue) => cue.words && cue.wo
 
 // packages/schema/src/index.ts
 var color = z3.string().regex(colorPattern);
-var fontWeight = z3.union([z3.number().int().min(1).max(1e3), z3.enum(["normal", "bold"])]);
+var fontWeightMap = {
+  thin: 100,
+  hairline: 100,
+  extralight: 200,
+  ultralight: 200,
+  "extra-light": 200,
+  "ultra-light": 200,
+  light: 300,
+  regular: 400,
+  medium: 500,
+  semibold: 600,
+  demibold: 600,
+  "semi-bold": 600,
+  "demi-bold": 600,
+  extrabold: 800,
+  ultrabold: 800,
+  "extra-bold": 800,
+  "ultra-bold": 800,
+  black: 900,
+  heavy: 900
+};
+var fontWeight = z3.preprocess((val) => {
+  if (typeof val === "string") {
+    const s = val.trim().toLowerCase();
+    if (/^\d+$/.test(s)) return parseInt(s, 10);
+    if (s in fontWeightMap) return fontWeightMap[s];
+  }
+  return val;
+}, z3.union([z3.number().int().min(1).max(1e3), z3.enum(["normal", "bold"])]));
 var fontStyle = z3.enum(["normal", "italic"]);
 var easingSchema = z3.union([z3.enum(["linear", "easeIn", "easeOut", "easeInOut", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInBack", "easeOutBack", "spring", "hold", "land", "snap", "glide", "pop", "move", "exit", "drift"]).describe("land, snap, glide and pop for entries, move within the frame, exit for leaving, drift for slow continuous motion; or a standard curve"), z3.tuple([z3.number().min(0).max(1), z3.number(), z3.number().min(0).max(1), z3.number()]).describe("Cubic B\xE9zier control points [x1, y1, x2, y2], as in CSS")]);
 var colorProperties = ["fill", "color", "stroke"];
@@ -1932,6 +1960,16 @@ async function measureLoudness(composition, baseDir) {
 var area = (a) => Math.max(0, a.x1 - a.x0) * Math.max(0, a.y1 - a.y0);
 var overlap = (a, b) => Math.max(0, Math.min(a.x1, b.x1) - Math.max(a.x0, b.x0)) * Math.max(0, Math.min(a.y1, b.y1) - Math.max(a.y0, b.y0));
 var seconds2 = (frame, fps) => `${(frame / fps).toFixed(1)} s`;
+function safeZoneBands(width, height, override) {
+  const screen = width * 16 / 9, letterbox = height >= width ? Math.max(0, (screen - height) / 2) : 0;
+  const inset = { ...height >= width ? { top: Math.max(0, 0.08 * screen - letterbox) / height, bottom: Math.max(0, 0.18 * screen - letterbox) / height, left: 0.02, right: 0.11 } : {}, ...override };
+  const bands = [];
+  if (inset.bottom) bands.push({ name: "bottom UI band", hint: `Reels and TikTok draw their controls over the bottom ${Math.round(inset.bottom * height)} px: keep text above y ${Math.round(height - inset.bottom * height)}`, x0: 0, y0: height - inset.bottom * height, x1: width, y1: height });
+  if (inset.right) bands.push({ name: "right UI band", hint: `the action buttons cover the right ${Math.round(inset.right * width)} px: keep text left of x ${Math.round(width - inset.right * width)}`, x0: width - inset.right * width, y0: 0, x1: width, y1: height });
+  if (inset.top) bands.push({ name: "top UI band", hint: `search and the camera cover the top ${Math.round(inset.top * height)} px: keep text below y ${Math.round(inset.top * height)}`, x0: 0, y0: 0, x1: width, y1: inset.top * height });
+  if (inset.left) bands.push({ name: "left UI band", hint: `keep text right of x ${Math.round(inset.left * width)}`, x0: 0, y0: 0, x1: inset.left * width, y1: height });
+  return bands;
+}
 async function reviewComposition(composition, options = {}) {
   const { fps, width, height, durationFrames } = composition, baseDir = options.baseDir ?? process.cwd();
   const every = Math.max(1, Math.round(options.every ?? fps / 2)), frames = [];
@@ -1980,6 +2018,12 @@ async function reviewComposition(composition, options = {}) {
     const other = report.texts.find((o) => o !== t && o.id !== t.id && visible(o) && overlap(t, o) > 0.15 * Math.min(area(t), area(o)) && (t.kind === "captions" || o.kind === "captions" || t.id < o.id));
     return other ? t.kind === "captions" || other.kind === "captions" ? `"${(t.kind === "captions" ? other : t).text}" sits under the captions: keep content out of the captions band` : `"${t.text}" overlaps "${other.text}"` : void 0;
   }, "error");
+  const bands = safeZoneBands(width, height, options.safeZone);
+  if (bands.length) persistent("safe-zone", hold, (t) => {
+    if (!visible(t)) return;
+    const band = bands.find((b) => overlap(t, b) > 0.25 * area(t));
+    return band ? `"${t.text}" sits in the ${band.name}: ${band.hint}` : void 0;
+  }, "warning");
   const crowded = reports.map((r) => r.texts.filter((t) => visible(t) && t.kind === "text").reduce((n, t) => n + t.words, 0) > 40), busy = crowded.findIndex((_, i) => i + hold <= crowded.length && crowded.slice(i, i + hold).every(Boolean));
   if (busy >= 0) issues.push({ severity: "warning", code: "busy", message: `More than 40 words on screen at ${seconds2(frames[busy], fps)}: split it across beats or cut words`, frame: frames[busy] });
   const texts = reports.flatMap((r) => r.texts).filter((t) => visible(t) && t.kind === "text"), sizes = [...new Set(texts.map((t) => Math.round(t.baseSize)))].sort((a, b) => b - a), colours = [...new Set(texts.map((t) => t.color.toLowerCase()).filter((c) => c !== "gradient"))];
@@ -2272,6 +2316,7 @@ export {
   exportSchema,
   ffmpegPath,
   ffprobePath,
+  fillers,
   formatCaptions,
   formatForOutput,
   frameToSeconds,